在 Python 中创建和应用 WordArt 效果

关于 WordArt?

WordArt（或 Word Art）是一项功能，允许您对文本应用效果，使其突出。使用 WordArt，例如，您可以对文本进行描边或填充颜色（或渐变），添加 3D 效果等。您还可以对文本的形状进行倾斜、弯曲和拉伸。

WordArt 允许您像对待图形对象一样处理文本。WordArt 包含对文本进行的效果或特殊修改，使其更具吸引力或更显眼。

WordArt 在 Microsoft PowerPoint 中

要在 Microsoft PowerPoint 中使用 WordArt，必须选择预定义的 WordArt 模板之一。WordArt 模板是一组将应用于文本或其形状的效果。

WordArt 在 Aspose.Slides 中

在 Aspose.Slides for Python via .NET 20.10 中，我们实现了对 WordArt 的支持，并在后续的 Aspose.Slides for Python via .NET 版本中对该功能进行了改进。

使用 Aspose.Slides for Python via .NET，您可以在 Python 中轻松创建自己的 WordArt 模板（单个效果或组合效果），并将其应用于文本。

创建简单的 WordArt 模板并将其应用于文本

使用 Aspose.Slides

首先，我们使用以下 Python 代码创建一个简单的文本：

import aspose.slides as slides

with slides.Presentation() as pres:
    slide = pres.slides[0]
    autoShape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
    textFrame = autoShape.text_frame

    portion = textFrame.paragraphs[0].portions[0]
    portion.text = "Aspose.Slides"

    pres.save("wordart-1.pptx", slides.export.SaveFormat.PPTX)

现在，我们通过以下代码将文本的字体高度设置为更大的值，以使效果更明显：

    fontData = slides.FontData("Arial Black")
    portion.portion_format.latin_font = fontData
    portion.portion_format.font_height = 36

使用 Microsoft PowerPoint

在 Microsoft PowerPoint 中打开 WordArt 效果菜单：

todo:image_alt_text

在右侧菜单中，您可以选择预定义的 WordArt 效果；在左侧菜单中，您可以为新 WordArt 指定设置。

以下是部分可用的参数或选项：

todo:image_alt_text

使用 Aspose.Slides

这里，我们使用以下代码将 SmallGrid 图案颜色应用于文本，并添加宽度为 1 的黑色文本边框：

    portion.portion_format.fill_format.fill_type = slides.FillType.PATTERN
    portion.portion_format.fill_format.pattern_format.fore_color.color = draw.Color.dark_orange
    portion.portion_format.fill_format.pattern_format.back_color.color = draw.Color.white
    portion.portion_format.fill_format.pattern_format.pattern_style = slides.PatternStyle.SMALL_GRID
                
    portion.portion_format.line_format.fill_format.fill_type = slides.FillType.SOLID
    portion.portion_format.line_format.fill_format.solid_fill_color.color = draw.Color.black

生成的文本：

todo:image_alt_text

应用其他 WordArt 效果

使用 Microsoft PowerPoint

在程序界面中，您可以将这些效果应用于文本、文本块、形状或类似元素：

todo:image_alt_text

例如，可以对文本应用阴影、反射和发光效果；对文本块应用 3D 格式和 3D 旋转效果；对形状对象应用柔边属性（即使未设置 3D 格式属性，它仍然有效）。

应用阴影效果

这里，我们仅针对文本设置相关属性。我们使用以下 Python 代码对文本应用阴影效果：

    portion.portion_format.effect_format.enable_outer_shadow_effect()
    portion.portion_format.effect_format.outer_shadow_effect.shadow_color.color = draw.Color.black
    portion.portion_format.effect_format.outer_shadow_effect.scale_horizontal = 100
    portion.portion_format.effect_format.outer_shadow_effect.scale_vertical = 65
    portion.portion_format.effect_format.outer_shadow_effect.blur_radius = 4.73
    portion.portion_format.effect_format.outer_shadow_effect.direction = 230
    portion.portion_format.effect_format.outer_shadow_effect.distance = 2
    portion.portion_format.effect_format.outer_shadow_effect.skew_horizontal = 30
    portion.portion_format.effect_format.outer_shadow_effect.skew_vertical = 0
    portion.portion_format.effect_format.outer_shadow_effect.shadow_color.color_transform.add(slides.ColorTransformOperation.SET_ALPHA, 0.32)

Aspose.Slides API 支持三种阴影类型：OuterShadow、InnerShadow 和 PresetShadow。

使用 PresetShadow，您可以为文本应用预设值的阴影。

使用 Microsoft PowerPoint

在 PowerPoint 中，您只能使用一种阴影类型。示例：

todo:image_alt_text

使用 Aspose.Slides

Aspose.Slides 实际上允许一次同时应用两种阴影：InnerShadow 和 PresetShadow。

注意：

当同时使用 OuterShadow 和 PresetShadow 时，仅会应用 OuterShadow 效果。
如果同时使用 OuterShadow 和 InnerShadow，最终或实际应用的效果取决于 PowerPoint 版本。例如，在 PowerPoint 2013 中，效果会叠加两次；而在 PowerPoint 2007 中，仅会应用 OuterShadow 效果。

应用显示效果到文本

我们使用以下 Python 示例为文本添加显示效果：

    portion.portion_format.effect_format.enable_reflection_effect()
    portion.portion_format.effect_format.reflection_effect.blur_radius = 0.5 
    portion.portion_format.effect_format.reflection_effect.distance = 4.72 
    portion.portion_format.effect_format.reflection_effect.start_pos_alpha = 0 
    portion.portion_format.effect_format.reflection_effect.end_pos_alpha = 60
    portion.portion_format.effect_format.reflection_effect.direction = 90 
    portion.portion_format.effect_format.reflection_effect.scale_horizontal = 100 
    portion.portion_format.effect_format.reflection_effect.scale_vertical = -100
    portion.portion_format.effect_format.reflection_effect.start_reflection_opacity = 60
    portion.portion_format.effect_format.reflection_effect.end_reflection_opacity = 0.9
    portion.portion_format.effect_format.reflection_effect.rectangle_align = slides.RectangleAlignment.BOTTOM_LEFT

应用发光效果到文本

我们使用以下代码为文本应用发光效果，使其更亮或更突出：

    portion.portion_format.effect_format.enable_glow_effect()
    portion.portion_format.effect_format.glow_effect.color.r = 255
    portion.portion_format.effect_format.glow_effect.color.color_transform.add(slides.ColorTransformOperation.SET_ALPHA, 0.54)
    portion.portion_format.effect_format.glow_effect.radius = 7

操作结果：

todo:image_alt_text

您可以更改阴影、显示和发光的参数。效果属性会单独设置到文本的每个部分。

在 WordArt 中使用变形

我们通过以下代码使用 Transform 属性（适用于整个文本块）：

textFrame.text_frame_format.transform = slides.TextShapeType.ARCH_UP_POUR

结果：

todo:image_alt_text

Microsoft PowerPoint 和 Aspose.Slides for Python via .NET 都提供一定数量的预定义变形类型。

使用 PowerPoint

要访问预定义的变形类型，请依次点击：Format -> TextEffect -> Transform

使用 Aspose.Slides

要选择变形类型，请使用 TextShapeType 枚举。

为文本和形状应用 3D 效果

我们使用以下示例代码为文本形状设置 3D 效果：

    autoShape.three_d_format.bevel_bottom.bevel_type = slides.BevelPresetType.CIRCLE
    autoShape.three_d_format.bevel_bottom.height = 10.5
    autoShape.three_d_format.bevel_bottom.width = 10.5

    autoShape.three_d_format.bevel_top.bevel_type = slides.BevelPresetType.CIRCLE
    autoShape.three_d_format.bevel_top.height = 12.5
    autoShape.three_d_format.bevel_top.width = 11

    autoShape.three_d_format.extrusion_color.color = draw.Color.orange
    autoShape.three_d_format.extrusion_height = 6

    autoShape.three_d_format.contour_color.color = draw.Color.dark_red
    autoShape.three_d_format.contour_width = 1.5

    autoShape.three_d_format.depth = 3

    autoShape.three_d_format.material = slides.MaterialPresetType.PLASTIC

    autoShape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    autoShape.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED
    autoShape.three_d_format.light_rig.set_rotation(0, 0, 40)

    autoShape.three_d_format.camera.camera_type = slides.CameraPresetType.PERSPECTIVE_CONTRASTING_RIGHT_FACING

生成的文本及其形状：

todo:image_alt_text

我们使用以下 Python 代码为文本应用 3D 效果：

    textFrame.text_frame_format.three_d_format.bevel_bottom.bevel_type = slides.BevelPresetType.CIRCLE
    textFrame.text_frame_format.three_d_format.bevel_bottom.height = 3.5
    textFrame.text_frame_format.three_d_format.bevel_bottom.width = 3.5

    textFrame.text_frame_format.three_d_format.bevel_top.bevel_type = slides.BevelPresetType.CIRCLE
    textFrame.text_frame_format.three_d_format.bevel_top.height = 4
    textFrame.text_frame_format.three_d_format.bevel_top.width = 4

    textFrame.text_frame_format.three_d_format.extrusion_color.color = draw.Color.orange
    textFrame.text_frame_format.three_d_format.extrusion_height= 6

    textFrame.text_frame_format.three_d_format.contour_color.color = draw.Color.dark_red
    textFrame.text_frame_format.three_d_format.contour_width = 1.5

    textFrame.text_frame_format.three_d_format.depth= 3

    textFrame.text_frame_format.three_d_format.material = slides.MaterialPresetType.PLASTIC

    textFrame.text_frame_format.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    textFrame.text_frame_format.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED
    textFrame.text_frame_format.three_d_format.light_rig.set_rotation(0, 0, 40)

    textFrame.text_frame_format.three_d_format.camera.camera_type = slides.CameraPresetType.PERSPECTIVE_CONTRASTING_RIGHT_FACING

操作结果：

todo:image_alt_text

将 3D 效果应用于文本或其形状以及效果之间的交互遵循特定规则。

考虑文本及其所在形状的场景。3D 效果包含 3D 对象的表示以及对象所放置的场景。

当图形和文本均设置了场景时，图形场景具有更高优先级，文本场景将被忽略。
当图形没有自己的场景但具有 3D 表示时，使用文本场景。
否则——即当形状本身没有 3D 效果时，形状保持平面，仅对文本应用 3D 效果。

这些描述与 ThreeDFormat.LightRig 和 ThreeDFormat.Camera 属性相关。

对文本应用外阴影效果

Aspose.Slides for Python via .NET 提供 IOuterShadow 和 IInnerShadow 类，允许您对 TextFrame 中的文本应用阴影效果。请按以下步骤操作：

创建一个 Presentation 类的实例。
使用索引获取幻灯片的引用。
向幻灯片添加 Rectangle 类型的 AutoShape。
访问与 AutoShape 关联的 TextFrame。
将 AutoShape 的 FillType 设置为 NoFill。
实例化 OuterShadow 类
设置阴影的 BlurRadius。
设置阴影的 Direction
设置阴影的 Distance。
将 RectanglelAlign 设置为 TopLeft。
将阴影的 PresetColor 设置为 Black。
将演示文稿保存为 PPTX 文件。

下面的 Python 示例代码实现了上述步骤，展示了如何对文本应用外阴影效果：

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as pres:

    # 获取幻灯片的引用
    sld = pres.slides[0]

    # 添加矩形类型的 AutoShape
    ashp = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 75, 150, 50)

    # 为矩形添加 TextFrame
    ashp.add_text_frame("Aspose TextBox")

    # 禁用形状填充，以便获取文本的阴影
    ashp.fill_format.fill_type = slides.FillType.NO_FILL

    # 添加外部阴影并设置所有必要参数
    ashp.effect_format.enable_outer_shadow_effect()
    shadow = ashp.effect_format.outer_shadow_effect
    shadow.blur_radius = 4.0
    shadow.direction = 45
    shadow.distance = 3
    shadow.rectangle_align = slides.RectangleAlignment.TOP_LEFT
    shadow.shadow_color.preset_color = slides.PresetColor.BLACK

    #写入演示文稿到磁盘
    pres.save("pres_out.pptx", slides.export.SaveFormat.PPTX)

对形状应用内阴影效果

请按以下步骤操作：

创建一个 Presentation 类的实例。
获取幻灯片的引用。
添加 Rectangle 类型的 AutoShape。
启用 InnerShadowEffect。
设置所有必要的参数。
将 ColorType 设置为 Scheme。
设置 Scheme Color。
将演示文稿保存为 PPTX 文件。

以下示例代码（基于上述步骤）展示了如何在 Python 中为两个形状添加连接线：

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    # 获取幻灯片的引用
    slide = presentation.slides[0]

    # 添加矩形类型的 AutoShape
    ashp = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 75, 400, 300)
    ashp.fill_format.fill_type = slides.FillType.NO_FILL

    # 为矩形添加 TextFrame
    ashp.add_text_frame("Aspose TextBox")
    port = ashp.text_frame.paragraphs[0].portions[0]
    pf = port.portion_format
    pf.font_height = 50

    # 启用 inner_shadow_effect    
    ef = pf.effect_format
    ef.enable_inner_shadow_effect()

    # 设置所有必要的参数
    ef.inner_shadow_effect.blur_radius = 8.0
    ef.inner_shadow_effect.direction = 90.0
    ef.inner_shadow_effect.distance = 6.0
    ef.inner_shadow_effect.shadow_color.b = 189

    # 将 ColorType 设置为 Scheme
    ef.inner_shadow_effect.shadow_color.color_type = slides.ColorType.SCHEME

    # 设置方案颜色
    ef.inner_shadow_effect.shadow_color.scheme_color = slides.SchemeColor.ACCENT1

    # 保存演示文稿
    presentation.save("WordArt_out.pptx", slides.export.SaveFormat.PPTX)

常见问题

我可以在不同字体或文字系统（例如阿拉伯语、中文）中使用 WordArt 效果吗？
是的，Aspose.Slides 支持 Unicode，兼容所有主流字体和文字系统。无论语言如何，都可以对文字应用 WordArt 效果，例如阴影、填充和描边，不过字体的可用性和渲染效果可能取决于系统已安装的字体。

我可以将 WordArt 效果应用于母版幻灯片元素吗？
是的，您可以将 WordArt 效果应用于母版幻灯片上的形状，包括标题占位符、页脚或背景文字。对母版布局所做的更改会同步到所有使用该母版的幻灯片。

WordArt 效果会影响演示文稿的文件大小吗？
会有一点影响。阴影、发光和渐变填充等 WordArt 效果会因额外的格式化元数据略微增大文件体积，但差异通常可以忽略不计。

我可以在不保存演示文稿的情况下预览 WordArt 效果的结果吗？
是的，您可以使用 Shape 或 Slide 类的 get_image 方法，将包含 WordArt 的幻灯片渲染为图像（例如 PNG、JPEG）。这样即可在内存中或屏幕上预览效果，而无需保存或导出完整的演示文稿。

使用 Python 自动化演示文稿本地化