在 Python 中为演示文稿创建 3D 效果

概述

Aspose.Slides for Python via .NET 能够创建、编辑、保存并渲染 PowerPoint 样式的形状和文字的 3D 格式化。本篇文章涵盖旋转、拉伸、斜角、灯光、材质、渐变或图片填充以及 3D 文字等 3D 效果。

本文讨论的是 PowerPoint 形状和文字的 3D 格式化效果，并不涉及插入或编辑独立的 3D 模型文件。当您将幻灯片导出为图像、PDF 或 HTML 时，Aspose.Slides 会将这些 3D 效果渲染到导出的 2D 输出中。

3D 格式化概念

使用 Shape.three_d_format 属性为形状应用 3D 格式化。该属性公开 ThreeDFormat，用于控制该形状的 3D 场景。

对于文字，使用 TextFrameFormat.three_d_format 属性。这会对文本框而不是形状本体应用 3D 格式化。

最重要的属性包括：

属性	控制内容	使用场景
camera	视点、预设相机类型、旋转、缩放和透视。	在 3D 空间中旋转对象或匹配 PowerPoint 的 3D 旋转预设。
light_rig	灯光预设、方向和灯光旋转。	改变 3D 表面上的高光和阴影表现。
material	表面材质，如平面、哑光、塑料或金属。	使相同几何体呈现更平坦、柔和、光亮或金属质感。
extrusion_height	形状从正面向后延伸的距离。	将平面形状转换为可视的厚度 3D 对象。
extrusion_color	拉伸侧面的颜色。	显示深度或让侧面颜色与正面填充相匹配。
depth	PowerPoint 3D 格式化使用的附加深度。	在形状或文字上微调深度，尤其与斜角和材质设置配合使用时。
bevel_top 和 bevel_bottom	正面和背面的凸起或圆角边缘。	为平面添加柔化或成型的边缘，而不是锐利的平面。
contour_color 和 contour_width	围绕 3D 对象的轮廓线。	在渲染输出中强调对象边界。

创建 3D 形状

一个形状在看起来逼真 3D 之前通常需要四类设置：

相机设置，因为默认的正面视图可能看不见拉伸效果。
灯光设置，因为光照决定了各面是否可辨。
材质设置，因为表面材质影响光线的渲染方式。
拉伸或深度设置，因为平面形状需要厚度。

下面的示例创建一个矩形，在正面添加文字，应用 3D 格式化，将演示文稿保存为 PPTX，并将幻灯片渲染为 PNG 图像。

import aspose.pydrawing as drawing
import aspose.slides as slides

image_scale = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
    shape.text_frame.text = "3D"
    shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 64

    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = drawing.Color.cornflower_blue

    shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
    shape.three_d_format.camera.set_rotation(20, 30, 40)
    shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
    shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    shape.three_d_format.material = slides.MaterialPresetType.FLAT
    shape.three_d_format.extrusion_height = 100
    shape.three_d_format.extrusion_color.color = drawing.Color.blue

    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("shape_3d.png")

    presentation.save("shape_3d.pptx", slides.export.SaveFormat.PPTX)

渲染后的幻灯片图像显示矩形为一个厚实的 3D 块：

渲染的蓝色 3D 矩形，正面有白色 3D 文字

使用相机旋转形状

在 PowerPoint 中，3D 旋转通过“3‑D 旋转”窗格配置。X、Y、Z 旋转值对应通过相机 API 设置的旋转。

PowerPoint 3‑D 旋转窗格，突出显示 X、Y、Z 旋转值

在 Aspose.Slides 中，通过 ThreeDFormat.camera 设置相机类型和旋转：

shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(20, 30, 40)

当需要改变观看者看到对象的角度时使用相机。它不会改变幻灯片上 2D 形状的几何形状，只会改变 PowerPoint 和 Aspose.Slides 渲染时使用的 3D 视点。

添加拉伸和深度

拉伸通过在正面后方延伸形状来实现厚度效果。在 PowerPoint 中，深度控制可见厚度，颜色控制侧面颜色。

PowerPoint 深度控制映射到 extrusion_color 和 extrusion_height 属性

使用 ThreeDFormat.extrusion_height 设置厚度，使用 ThreeDFormat.extrusion_color 设置侧面颜色：

shape.three_d_format.camera.set_rotation(20, 30, 40)
shape.three_d_format.extrusion_height = 100
shape.three_d_format.extrusion_color.color = drawing.Color.purple

当需要直接使用 PowerPoint 的深度值或将深度与斜角、材质、文字效果组合时，使用 ThreeDFormat.depth。在大多数形状场景下，使用 ThreeDFormat.extrusion_height 更直观，因为它直接表示可见的拉伸高度。

在 3D 效果中使用渐变或图片填充

3D 格式化与形状填充相互独立。您可以对正面使用纯色、渐变、图案或图片填充，同时保持相同的相机、灯光、材质和拉伸设置。

下面的示例对形状使用渐变填充，并为侧面指定更暗的拉伸颜色：

import aspose.pydrawing as drawing
import aspose.slides as slides

image_scale = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
    shape.text_frame.text = "3D Gradient"
    shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 64

    shape.fill_format.fill_type = slides.FillType.GRADIENT
    shape.fill_format.gradient_format.gradient_stops.add(0, drawing.Color.blue)
    shape.fill_format.gradient_format.gradient_stops.add(100, drawing.Color.orange)

    shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
    shape.three_d_format.camera.set_rotation(10, 20, 30)
    shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
    shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    shape.three_d_format.material = slides.MaterialPresetType.FLAT
    shape.three_d_format.extrusion_height = 150
    shape.three_d_format.extrusion_color.color = drawing.Color.dark_orange

    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("gradient_3d.png")

渲染结果保持正面的渐变，并单独渲染拉伸：

渲染的 3D 矩形，正面为蓝‑橙渐变填充，侧面为橙色拉伸

若想使用图片填充，请先将图像添加到演示文稿，然后将其分配给形状填充：

with open("image.jpg", "rb") as image_file:
    image_data = image_file.read()

image = presentation.images.add_image(image_data)

shape.fill_format.fill_type = slides.FillType.PICTURE
shape.fill_format.picture_fill_format.picture.image = image
shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH

shape.three_d_format.camera.set_rotation(10, 20, 30)
shape.three_d_format.extrusion_height = 150
shape.three_d_format.extrusion_color.color = drawing.Color.dark_orange

图片渲染在正面，拉伸则渲染为 3D 侧表面：

渲染的 3D 矩形，正面为照片填充，侧面为橙色拉伸

对文字应用 3D 格式化

形状的 3D 格式化影响形状本体，文字的 3D 格式化影响文本框。这对类似 WordArt 的效果很有用，字母本身需要拉伸、材质、光照和相机设置。

下面的示例创建使用图案填充的文字，应用 WordArt 变换，并在 TextFrameFormat 上配置 3D 设置：

import aspose.pydrawing as drawing
import aspose.slides as slides

image_scale = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
    shape.text_frame.text = "3D Text"

    portion = shape.text_frame.paragraphs[0].portions[0]
    portion.portion_format.fill_format.fill_type = slides.FillType.PATTERN
    portion.portion_format.fill_format.pattern_format.fore_color.color = drawing.Color.dark_orange
    portion.portion_format.fill_format.pattern_format.back_color.color = drawing.Color.white
    portion.portion_format.fill_format.pattern_format.pattern_style = slides.PatternStyle.LARGE_GRID

    shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 128

    text_frame_format = shape.text_frame.text_frame_format
    text_frame_format.transform = slides.TextShapeType.ARCH_UP
    text_frame_format.three_d_format.extrusion_height = 3.5
    text_frame_format.three_d_format.depth = 3
    text_frame_format.three_d_format.material = slides.MaterialPresetType.PLASTIC
    text_frame_format.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    text_frame_format.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED
    text_frame_format.three_d_format.light_rig.set_rotation(0, 0, 40)
    text_frame_format.three_d_format.camera.camera_type = slides.CameraPresetType.PERSPECTIVE_CONTRASTING_RIGHT_FACING

    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("text_3d.png")

    presentation.save("text_3d.pptx", slides.export.SaveFormat.PPTX)

文字呈现为弧形、拉伸的 3D 字母：

渲染的 3D 文字，带拱形 WordArt 变换、橙色图案填充和深色拉伸

导出和渲染行为

Aspose.Slides 在保存为 PPTX 等 PowerPoint 格式时会保留 3D 格式化。渲染或导出为固定布局格式时，3D 场景会被光栅化或绘制为 2D 结果。此行为同样适用于将幻灯片渲染为 PNG、导出为 PDF、导出为 HTML，或为视频转换生成帧。

请注意以下要点：

导出的图像和 PDF 并非交互式，导出后观众无法旋转对象。
最终外观取决于相机、灯光组、材质、拉伸、填充和幻灯片缩放的组合。
如需检查继承或主题基的格式化值，请读取 effective shape properties。
某些输出格式无法存储可编辑的 PowerPoint 3D 格式化。在这些格式中，视觉结果是渲染后的图像，而非可编辑的 3D 设置。

常见问题

Aspose.Slides 能创建交互式 3D 演示文稿吗？

Aspose.Slides 可以创建并渲染 PowerPoint 形状和文字的 3D 效果，但不会将导出的图像、PDF 或 HTML 页面制作成交互式 3D 场景供观众旋转。在 PPTX 中，只要格式支持，3D 格式化仍保持可编辑。

3D 模型和 3D 效果有什么区别？

3D 模型是插入到演示文稿中的独立 3D 对象。3D 效果是对普通 PowerPoint 形状或文字应用的格式化，如旋转、拉伸、斜角、灯光和材质。本文讨论的正是 3D 效果。

可见的 3D 形状需要哪些设置？

最低要求是设置相机旋转并使用拉伸或深度。实际使用中，通常还会设置灯光组和材质，以确保渲染出的面具有明确的高光和阴影。

可以对形状和文字同时应用 3D 效果吗？

可以。对形状本体使用 Shape.three_d_format，对文字使用 TextFrameFormat.three_d_format。

导出为图像、PDF、HTML 或视频帧时会出现 3D 效果吗？

会。Aspose.Slides 在生成幻灯片图像、PDF、HTML 和用于视频转换的帧时，会渲染 3D 效果。导出的文件包含渲染后的外观，而不是可编辑的 3D 对象。

能够读取继承和主题设置后最终的 3D 值吗？

可以。使用文中提到的有效格式化 API（见 Shape Effective Properties）即可读取最终的相机、灯光组、斜角等 3D 值。

使用 Python 为 PowerPoint 演示文稿添加动画使用 Python 管理演示文稿中的 VBA 项目