在 PHP 中向演示文稿添加水印

关于水印

水印是在幻灯片或整个演示文稿中使用的文字或图片标记。通常，水印用于指示演示文稿是草稿（例如 “Draft” 水印）、包含机密信息（例如 “Confidential” 水印）、所属公司（例如 “Company Name” 水印）、标识作者等。水印通过表明演示文稿不应被复制来帮助防止版权侵权。水印既适用于 PowerPoint 也适用于 OpenOffice 演示文稿格式。在 Aspose.Slides 中，你可以向 PowerPoint PPT、PPTX 和 OpenOffice ODP 文件格式添加水印。

在 Aspose.Slides，创建 PowerPoint 或 OpenOffice 文档的水印并修改其设计和行为有多种方式。通用的做法是：添加文字水印时使用 TextFrame 类，添加图片水印时使用 PictureFrame 类或将图片填充到水印形状中。PictureFrame 实现了 Shape 类，因而可以使用形状对象的所有灵活设置。由于 ITextFrame 不是形状且设置受限，它被包装为一个 Shape 对象。

水印的应用方式有两种：对单个幻灯片或对所有幻灯片。使用幻灯片母版（Slide Master）可以对所有幻灯片应用水印——水印添加到幻灯片母版，在母版上完成全部设计并自动应用到所有幻灯片，同时不影响对单个幻灯片上水印的修改权限。

水印通常被视为不允许其他用户编辑。为防止水印（或更准确地说其父形状）被编辑，Aspose.Slides 提供了形状锁定功能。可以在普通幻灯片或幻灯片母版上锁定特定形状。当水印形状在幻灯片母版上被锁定时，它将在所有幻灯片上保持锁定。

你可以为水印设置名称，这样将来需要删除时可以通过名称在幻灯片的形状集合中找到它。

水印的设计方式多种多样，但通常具有居中对齐、旋转、前置等共性特征。以下示例将展示如何实现这些效果。

文字水印

向幻灯片添加文字水印

要在 PPT、PPTX 或 ODP 中添加文字水印，首先向幻灯片添加一个形状，然后在该形状中添加文字框。文字框由 TextFrame 类表示。该类型未继承自 Shape，后者拥有丰富的属性用于灵活定位水印。因此，TextFrame 对象被包装在一个 AutoShape 对象中。使用以下方式的 addTextFrame 方法即可向形状添加水印文字。

$watermarkText = "CONFIDENTIAL";

$presentation = new Presentation();
$slide = $presentation->getSlides()->get_Item(0);

$watermarkShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 400, 40);
$watermarkFrame = $watermarkShape->addTextFrame($watermarkText);

$presentation->dispose();

另请参阅

如何使用 TextFrame 类

向整个演示文稿添加文字水印

如果想一次性为整个演示文稿（即所有幻灯片）添加文字水印，请将其添加到 MasterSlide。其余逻辑与向单个幻灯片添加水印相同——创建一个 AutoShape 对象，然后使用 addTextFrame 方法将水印添加进去。

$watermarkText = "CONFIDENTIAL";

$presentation = new Presentation();
$masterSlide = $presentation->getMasters()->get_Item(0);

$watermarkShape = $masterSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 400, 40);
$watermarkFrame = $watermarkShape->addTextFrame($watermarkText);

$presentation->dispose();

另请参阅

如何使用幻灯片母版

设置水印形状的透明度

默认情况下，矩形形状带有填充和线条颜色。以下代码行将形状设为透明。

$watermarkShape->getFillFormat()->setFillType(FillType::NoFill);
$watermarkShape->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);

为文字水印设置字体

可以按以下方式更改文字水印的字体。

$textFormat = $watermarkFrame->getParagraphs()->get_Item(0)->getParagraphFormat()->getDefaultPortionFormat();
$textFormat->setLatinFont(new FontData("Arial"));
$textFormat->setFontHeight(50);

设置水印文字颜色

要设置水印文字的颜色，使用如下代码：

$alpha = 150;
$red = 200;
$green = 200;
$blue = 200;
$textColor = new Java("java.awt.Color", $red, $green, $blue, $alpha);

$fillFormat = $watermarkFrame->getParagraphs()->get_Item(0)->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat();
$fillFormat->setFillType(FillType::Solid);
$fillFormat->getSolidFillColor()->setColor($textColor);

居中文本水印

可以将水印居中显示，示例代码如下：

$slideSize = $presentation->getSlideSize()->getSize();
$slideWidth = java_values($slideSize->getWidth());
$slideHeight = java_values($slideSize->getHeight());

$watermarkWidth = 400;
$watermarkHeight = 40;
$watermarkX = ($slideWidth - $watermarkWidth) / 2;
$watermarkY = ($slideHeight - $watermarkHeight) / 2;

$watermarkShape = $slide->getShapes()->addAutoShape(
        ShapeType::Rectangle, $watermarkX, $watermarkY, $watermarkWidth, $watermarkHeight);

$watermarkFrame = $watermarkShape->addTextFrame($watermarkText);

下图展示了最终效果。

The text watermark

图片水印

向演示文稿添加图片水印

向演示文稿幻灯片添加图片水印，可按如下步骤操作：

$image = Images::fromFile("watermark.png");
$picture = $presentation->getImages()->addImage($image);
$image->dispose();

$watermarkShape->getFillFormat()->setFillType(FillType::Picture);
$watermarkShape->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($picture);
$watermarkShape->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode::Stretch);

锁定水印防止编辑

如果需要防止水印被编辑，可对形状使用 AutoShape.getAutoShapeLock 方法。通过该属性可以阻止形状被选中、调整大小、重新定位、与其他元素组合、锁定其文字编辑等操作：

// 锁定水印形状以防止修改
$watermarkShape->getAutoShapeLock()->setSelectLocked(true);
$watermarkShape->getAutoShapeLock()->setSizeLocked(true);
$watermarkShape->getAutoShapeLock()->setTextLocked(true);
$watermarkShape->getAutoShapeLock()->setPositionLocked(true);
$watermarkShape->getAutoShapeLock()->setGroupingLocked(true);

将水印置于最前层

在 Aspose.Slides 中，可以通过 ShapeCollection.reorder 方法设置形状的 Z 顺序。需要在演示文稿的幻灯片列表上调用该方法，并将形状引用及其顺序号传入，从而实现将形状置于前层或后层。该功能在需要将水印放在演示文稿前面时特别有用：

$shapeCount = java_values($slide->getShapes()->size());
$slide->getShapes()->reorder($shapeCount - 1, $watermarkShape);

设置水印旋转角度

以下代码示例演示如何调整水印的旋转，使其以对角线方式跨越幻灯片：

$diagonalAngle = atan($slideWidth / $slideHeight) * 180 / M_PI;

$watermarkShape->setRotation($diagonalAngle);

为水印设置名称

Aspose.Slides 允许为形状设置名称。使用形状名称可以在将来访问、修改或删除该形状。为水印形状设置名称，可调用 AutoShape.setName 方法：

$watermarkShape->setName("watermark");

删除水印

要删除水印形状，先使用 AutoShape.getName 方法在幻灯片形状集合中找到它，然后将该形状传入 ShapeCollection.remove 方法：

$slideShapes = $slide->getShapes()->toArray();
foreach ($slideShapes as $shape) {
    if ($shape->getName() === "watermark") {
        $slide->getShapes()->remove($shape);
    }
}

常见问题

什么是水印，为什么要使用它？

水印是在幻灯片上覆盖的文字或图片，用于保护知识产权、提升品牌识别度或防止演示文稿被未经授权使用。

我可以为演示文稿的所有幻灯片添加水印吗？

可以，Aspose.Slides 允许通过编程方式为演示文稿的每一张幻灯片添加水印。你可以遍历所有幻灯片并分别应用水印设置。

如何调整水印的透明度？

可以通过修改形状的填充设置（getFillFormat）来调整水印的透明度，从而使水印保持柔和，不干扰幻灯片内容。

支持哪些图片格式作为水印？

Aspose.Slides 支持多种图片格式，包括 PNG、JPEG、GIF、BMP、SVG 等。

我可以自定义文字水印的字体和样式吗？

可以，你可以选择任意字体、字号和样式，以匹配演示文稿的设计并保持品牌一致性。

如何更改水印的位置或方向？

可以通过编程方式修改形状的坐标、尺寸和旋转属性来调整水印的位置和方向。

使用 PHP 将演示文稿保存为只读模式