在 Python via Java 中创建和应用 WordArt 效果

本页内容简介

在 Aspose.Slides for Python via Java 中创建和自定义 WordArt 效果。此分步指南帮助开发人员使用 Python via Java 为演示文稿添加专业文本。

概览

WordArt 效果允许您在 PowerPoint 演示文稿中添加视觉上吸引人、风格化的文本。使用 Aspose.Slides，开发人员可以以编程方式创建、定制和管理 WordArt，就像在 Microsoft PowerPoint 中一样——无需安装 Office。本文概述了使用 WordArt 的方法，包括如何应用文本变换、填充样式、轮廓、阴影和其他格式选项，以使演示内容更具表现力和吸引力。WordArt 允许您将文本视为图形对象。它由对文本应用的效果或特殊修改组成，以使其更具吸引力或更显眼。

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

使用 Aspose.Slides

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()

    portion = text_frame.getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.setText("Aspose.Slides")
finally:
    presentation.dispose()

接下来，增大字体大小以使效果更明显：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FontData, Presentation, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    portion = text_frame.getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.setText("Aspose.Slides")

    font_data = FontData("Arial Black")
    portion_format = portion.getPortionFormat()
    portion_format.setLatinFont(font_data)
    portion_format.setFontHeight(36)
finally:
    presentation.dispose()

使用 Microsoft PowerPoint

转到 Microsoft PowerPoint 中的 WordArt 效果菜单：

PowerPoint 中的 WordArt 效果菜单

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

以下是一些可用的参数或选项：

WordArt 格式化选项

使用 Aspose.Slides

在此，我们使用以下代码将 PatternStyle.SmallGrid 图案填充应用于文本，并使用黑色文本边框：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpage.startJVM()

from asposeslides.api import FillType, PatternStyle, Presentation, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    portion = text_frame.getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.setText("Aspose.Slides")

    portion_format = portion.getPortionFormat()
    portion_format.getFillFormat().setFillType(FillType.Pattern)
    pattern_format = portion_format.getFillFormat().getPatternFormat()
    pattern_format.getForeColor().setColor(Color.ORANGE)
    pattern_format.getBackColor().setColor(Color.WHITE)
    pattern_format.setPatternStyle(PatternStyle.SmallGrid)

    line_format = portion_format.getLineFormat()
    line_format.getFillFormat().setFillType(FillType.Solid)
    line_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
finally:
    presentation.dispose()

生成的文本：

带图案填充和黑色轮廓的文本

应用其他 WordArt 效果

使用 Microsoft PowerPoint

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

PowerPoint 中的文本和形状效果

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

应用阴影效果

以下 Python 代码仅对文本应用阴影效果：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ColorTransformOperation, Presentation, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    portion = text_frame.getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.setText("Aspose.Slides")

    portion_format = portion.getPortionFormat()
    portion_format.getEffectFormat().enableOuterShadowEffect()
    outer_shadow = portion_format.getEffectFormat().getOuterShadowEffect()
    outer_shadow.getShadowColor().setColor(Color.BLACK)
    outer_shadow.setScaleHorizontal(100)
    outer_shadow.setScaleVertical(65)
    outer_shadow.setBlurRadius(4.73)
    outer_shadow.setDirection(230)
    outer_shadow.setDistance(2)
    outer_shadow.setSkewHorizontal(30)
    outer_shadow.setSkewVertical(0)
    outer_shadow.getShadowColor().getColorTransform().add(ColorTransformOperation.SetAlpha, 0.32)
finally:
    presentation.dispose()

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

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

使用 Microsoft PowerPoint

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

PowerPoint 中的阴影设置

使用 Aspose.Slides

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

注意：

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

将反射应用于文本

我们通过以下 Python（通过 Java）代码为文本添加反射：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, RectangleAlignment, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    portion = text_frame.getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.setText("Aspose.Slides")

    portion_format = portion.getPortionFormat()
    portion_format.getEffectFormat().enableReflectionEffect()
    reflection = portion_format.getEffectFormat().getReflectionEffect()
    reflection.setBlurRadius(0.5)
    reflection.setDistance(4.72)
    reflection.setStartPosAlpha(0)
    reflection.setEndPosAlpha(60)
    reflection.setDirection(90)
    reflection.setScaleHorizontal(100)
    reflection.setScaleVertical(-100)
    reflection.setStartReflectionOpacity(60)
    reflection.setEndReflectionOpacity(0.9)
    reflection.setRectangleAlign(RectangleAlignment.BottomLeft)
finally:
    presentation.dispose()

将发光效果应用于文本

我们使用以下代码将发光效果应用于文本，使其发光或突出显示：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ColorTransformOperation, Presentation, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    portion = text_frame.getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.setText("Aspose.Slides")

    portion_format = portion.getPortionFormat()
    portion_format.getEffectFormat().enableGlowEffect()
    glow = portion_format.getEffectFormat().getGlowEffect()
    glow.getColor().setR(jpype.JByte(-1))
    glow.getColor().getColorTransform().add(ColorTransformOperation.SetAlpha, 0.54)
    glow.setRadius(7)
finally:
    presentation.dispose()

操作结果：

带发光效果的文本

注意

您可以更改阴影、反射和发光的参数。效果属性会分别针对文本的每个部分进行设置。

在 WordArt 中使用变换

使用 TextFrameFormat.setTransform 对整个文本块进行变换：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, TextShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    text_frame.setText("Aspose.Slides")

    text_frame.getTextFrameFormat().setTransform(TextShapeType.ArchUpPour)
finally:
    presentation.dispose()

结果：

带拱形变换的文本

注意

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

使用 PowerPoint

要访问预定义的变换类型，请转到：格式 -> 文字效果 -> 变换

使用 Aspose.Slides

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

将 3D 效果应用于文本和形状

我们使用以下示例代码将 3D 效果应用于文本形状：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BevelPresetType, CameraPresetType, LightRigPresetType, LightingDirection, MaterialPresetType, Presentation, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    auto_shape.getTextFrame().setText("Aspose.Slides")

    three_d_format = auto_shape.getThreeDFormat()
    three_d_format.getBevelBottom().setBevelType(BevelPresetType.Circle)
    three_d_format.getBevelBottom().setHeight(10.5)
    three_d_format.getBevelBottom().setWidth(10.5)

    three_d_format.getBevelTop().setBevelType(BevelPresetType.Circle)
    three_d_format.getBevelTop().setHeight(12.5)
    three_d_format.getBevelTop().setWidth(11)

    three_d_format.getExtrusionColor().setColor(Color.ORANGE)
    three_d_format.setExtrusionHeight(6)

    three_d_format.getContourColor().setColor(Color.RED)
    three_d_format.setContourWidth(1.5)

    three_d_format.setDepth(3)

    three_d_format.setMaterial(MaterialPresetType.Plastic)

    three_d_format.getLightRig().setDirection(LightingDirection.Top)
    three_d_format.getLightRig().setLightType(LightRigPresetType.Balanced)
    three_d_format.getLightRig().setRotation(0, 0, 40)

    three_d_format.getCamera().setCameraType(CameraPresetType.PerspectiveContrastingRightFacing)
finally:
    presentation.dispose()

生成的文本及其形状：

带 3D 效果的文本形状

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BevelPresetType, CameraPresetType, LightRigPresetType, LightingDirection, MaterialPresetType, Presentation, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200)
    text_frame = auto_shape.getTextFrame()
    text_frame.setText("Aspose.Slides")

    three_d_format = text_frame.getTextFrameFormat().getThreeDFormat()
    three_d_format.getBevelBottom().setBevelType(BevelPresetType.Circle)
    three_d_format.getBevelBottom().setHeight(3.5)
    three_d_format.getBevelBottom().setWidth(3.5)

    three_d_format.getBevelTop().setBevelType(BevelPresetType.Circle)
    three_d_format.getBevelTop().setHeight(4)
    three_d_format.getBevelTop().setWidth(4)

    three_d_format.getExtrusionColor().setColor(Color.ORANGE)
    three_d_format.setExtrusionHeight(6)

    three_d_format.getContourColor().setColor(Color.RED)
    three_d_format.setContourWidth(1.5)

    three_d_format.setDepth(3)

    three_d_format.setMaterial(MaterialPresetType.Plastic)

    three_d_format.getLightRig().setDirection(LightingDirection.Top)
    three_d_format.getLightRig().setLightType(LightRigPresetType.Balanced)
    three_d_format.getLightRig().setRotation(0, 0, 40)

    three_d_format.getCamera().setCameraType(CameraPresetType.PerspectiveContrastingRightFacing)
finally:
    presentation.dispose()

操作结果：

带 3D 效果的文本

注意

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

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

当形状和文本都设置了场景时，形状场景优先——文本场景被忽略。
当形状没有自己的场景但具有 3D 表示时，使用文本场景。
否则——当形状本身没有 3D 效果时，形状为平面，3D 效果仅应用于文本。

这些规则涉及 ThreeDFormat.getLightRig 和 ThreeDFormat.getCamera 方法。

将外部阴影效果应用于文本

Aspose.Slides for Python via Java 提供了 OuterShadow 和 InnerShadow 类，允许您在 TextFrame 中对文本应用阴影效果。请按以下步骤操作：

创建一个 Presentation 类的实例。
使用索引获取幻灯片的引用。
向幻灯片添加矩形形状。
访问与形状关联的文本框。
禁用形状填充。
启用外部阴影效果。
设置阴影的模糊半径。
设置阴影的方向。
设置阴影的距离。
将阴影对齐到左上角。
将阴影颜色设置为黑色。
将演示文稿保存为 PPTX 文件。

下面的 Python（通过 Java）示例代码实现了上述步骤，演示如何将外部阴影效果应用于文本：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, PresetColor, RectangleAlignment, SaveFormat, ShapeType

presentation = Presentation()
try:
    # 获取幻灯片的引用
    slide = presentation.getSlides().get_Item(0)

    # 添加矩形类型的 AutoShape
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 150, 50)

    # 向矩形添加 TextFrame
    auto_shape.addTextFrame("Aspose TextBox")

    # 禁用形状填充，以便获取文本的阴影
    auto_shape.getFillFormat().setFillType(FillType.NoFill)

    # 添加外部阴影并设置所有必要参数
    auto_shape.getEffectFormat().enableOuterShadowEffect()
    shadow = auto_shape.getEffectFormat().getOuterShadowEffect()
    shadow.setBlurRadius(4.0)
    shadow.setDirection(45)
    shadow.setDistance(3)
    shadow.setRectangleAlign(RectangleAlignment.TopLeft)
    shadow.getShadowColor().setPresetColor(PresetColor.Black)

    # 将演示文稿写入磁盘
    presentation.save("pres_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

将内部阴影效果应用于形状

请按以下步骤操作：

创建一个 Presentation 类的实例。
获取幻灯片的引用。
添加矩形形状。
启用内部阴影效果。
设置所有必要的参数。
将阴影颜色类型设置为使用主题颜色。
设置主题颜色。
将演示文稿保存为 PPTX 文件。

下面的示例代码（基于上述步骤）展示了如何在 Python via Java 中将内部阴影效果应用于形状中的文本：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ColorType, FillType, Presentation, SaveFormat, SchemeColor, ShapeType

presentation = Presentation()
try:
    # 获取幻灯片的引用
    slide = presentation.getSlides().get_Item(0)

    # 添加矩形类型的 AutoShape
    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 400, 300)
    auto_shape.getFillFormat().setFillType(FillType.NoFill)

    # 向矩形添加 TextFrame
    auto_shape.addTextFrame("Aspose TextBox")
    portion = auto_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion_format = portion.getPortionFormat()
    portion_format.setFontHeight(50)

    # 启用内部阴影效果
    effect_format = portion_format.getEffectFormat()
    effect_format.enableInnerShadowEffect()

    # 设置所有必要参数
    inner_shadow = effect_format.getInnerShadowEffect()
    inner_shadow.setBlurRadius(8.0)
    inner_shadow.setDirection(90.0)
    inner_shadow.setDistance(6.0)
    inner_shadow.getShadowColor().setB(jpype.JByte(-67))

    # 将 ColorType 设置为 Scheme
    inner_shadow.getShadowColor().setColorType(ColorType.Scheme)

    # 设置方案颜色
    inner_shadow.getShadowColor().setSchemeColor(SchemeColor.Accent1)

    # 保存演示文稿
    presentation.save("WordArt_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

常见问题

我可以将 WordArt 效果与不同的字体或文字脚本（例如阿拉伯语、中文）一起使用吗？

可以，Aspose.Slides 支持 Unicode 并兼容所有主流字体和文字脚本。无论语言如何，都可以应用阴影、填充和轮廓等 WordArt 效果，虽然字体的可用性和渲染可能取决于系统字体。

我可以将 WordArt 效果应用于幻灯片母版元素吗？

可以，您可以对母版幻灯片上的形状（包括标题占位符、页脚或背景文本）应用 WordArt 效果。对母版布局的更改会反映到所有相关幻灯片中。

WordArt 效果会影响演示文稿文件大小吗？

会略有影响。阴影、发光和渐变填充等 WordArt 效果可能会因增加的格式元数据而稍微增大文件大小，但差异通常可以忽略不计。

我可以在不保存演示文稿的情况下预览 WordArt 效果的结果吗？

可以，您可以使用 Shape.getImage 或 Slide.getImage 将包含 WordArt 的幻灯片渲染为图像（如 PNG、JPEG），从而在内存或屏幕上预览效果，而无需保存或导出完整演示文稿。

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