# 使用 C++ 在演示文稿中创建 3D 效果

> 使用 Aspose.Slides 在 C++ 中为 PowerPoint 形状和文本应用并渲染 3D 效果。配置摄像机、照明、材质、拉伸、填充和 3D 文本。

Source: https://docs.aspose.com/slides/zh/cpp/3d-presentation/
Updated: 2026-05-29

## **概述**

Aspose.Slides for C++ 可以创建、编辑、保留并渲染类似 PowerPoint 的 3D 格式，用于形状和文本。本文覆盖的 3D 效果包括旋转、拉伸、倒角、照明、材质、渐变或图片填充以及 3D 文本。

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

## **3D 格式化概念**

使用 [IShape](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ishape/) 接口的 [get_ThreeDFormat](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ishape/get_threedformat/) 方法对形状应用 3D 格式化。该方法返回 [IThreeDFormat](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/)，用于控制该形状的 3D 场景。

对文本，使用 [ITextFrameFormat](https://reference.aspose.com/slides/zh/cpp/aspose.slides/itextframeformat/) 接口的 [get_ThreeDFormat](https://reference.aspose.com/slides/zh/cpp/aspose.slides/itextframeformat/get_threedformat/) 方法。这会对文本框而不是形状本体应用 3D 格式化。

最重要的方法如下：

| 方法 | 控制内容 | 何时使用 |
|---|---|---|
| [get_Camera](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_camera/) | 视点、预设摄像机类型、旋转、缩放和透视。 | 在 3D 空间中旋转对象或匹配 PowerPoint 的 3D 旋转预设。 |
| [get_LightRig](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_lightrig/) | 光照预设、方向和光源旋转。 | 更改 3D 表面上高光和阴影的显示方式。 |
| [set_Material](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/set_material/) | 表面材质，如平面、哑光、塑料或金属。 | 使相同的几何体看起来更平坦、柔和、光亮或金属质感。 |
| [set_ExtrusionHeight](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/set_extrusionheight/) | 形状从前表面向后延伸的距离。 | 将平面形状转换为可视的厚实 3D 对象。 |
| [get_ExtrusionColor](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_extrusioncolor/) | 拉伸侧面的颜色。 | 显示深度或将侧面颜色与前部填充保持一致。 |
| [set_Depth](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/set_depth/) | PowerPoint 3D 格式化使用的附加深度。 | 对形状或文本进行细微的深度调节，通常与倒角和材质设置配合使用。 |
| [get_BevelTop](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_beveltop/) 和 [get_BevelBottom](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_bevelbottom/) | 前后表面的凸起或圆滑边缘。 | 为平面表面添加柔和或模具效果的边缘。 |
| [get_ContourColor](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_contourcolor/) 和 [set_ContourWidth](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/set_contourwidth/) | 3D 对象的轮廓线。 | 在渲染输出中强调对象边界。 |

## **创建 3D 形状**

形状在呈现出可信的 3D 效果前通常需要四类设置：

- 摄像机设置，因为默认的正视图可能隐藏拉伸效果。  
- 灯光设置，因为光照使各面和侧面可读。  
- 材质设置，因为表面会影响光线的渲染方式。  
- 拉伸或深度设置，因为平面形状需要厚度。

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

```cpp
const float imageScale = 2.0f;

auto presentation = System::MakeObject<Presentation>();

auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 200.0f, 200.0f);
shape->get_TextFrame()->set_Text(u"3D");
shape->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(64.0f);

auto frontColor = System::Drawing::Color::get_CornflowerBlue();
shape->get_FillFormat()->set_FillType(FillType::Solid);
shape->get_FillFormat()->get_SolidFillColor()->set_Color(frontColor);

auto extrusionColor = System::Drawing::Color::get_Blue();
shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront);
shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f);
shape->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Flat);
shape->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top);
shape->get_ThreeDFormat()->set_Material(MaterialPresetType::Flat);
shape->get_ThreeDFormat()->set_ExtrusionHeight(100.0);
shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor);

auto thumbnail = slide->GetImage(imageScale, imageScale);
thumbnail->Save(u"shape_3d.png");
thumbnail->Dispose();

presentation->Save(u"shape_3d.pptx", SaveFormat::Pptx);
presentation->Dispose();
```

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

![渲染的蓝色 3D 矩形，前表面带白色 3D 文本](img_01_01.png)

## **使用摄像机旋转形状**

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

![PowerPoint 3-D 旋转窗格，突出显示 X、Y、Z 旋转值](img_02_01.png)

在 Aspose.Slides 中，通过 [IThreeDFormat](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/) 设置摄像机类型和旋转：

```cpp
shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront);
shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f);
```

当需要更改观察者看到对象的方式时使用摄像机。它不会改变幻灯片上 2D 形状的几何结构，只会改变 PowerPoint 和 Aspose.Slides 渲染时使用的 3D 视点。

## **添加拉伸和深度**

拉伸通过在前表面后方延伸形状，使其看起来更厚。在 PowerPoint 中，深度控制决定可见的厚度，颜色控制决定侧面颜色。

![PowerPoint 深度控件映射到拉伸颜色和拉伸高度属性](img_02_02.png)

使用 [set_ExtrusionHeight](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/set_extrusionheight/) 设置厚度，使用 [get_ExtrusionColor](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/get_extrusioncolor/) 设置侧面颜色：

```cpp
shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f);
shape->get_ThreeDFormat()->set_ExtrusionHeight(100.0);

auto extrusionColor = System::Drawing::Color::get_Purple();
shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor);
```

当需要直接使用 PowerPoint 的深度值或将深度与倒角、材质和文字效果结合时，使用 [set_Depth](https://reference.aspose.com/slides/zh/cpp/aspose.slides/ithreedformat/set_depth/)。在多数形状场景下，`set_ExtrusionHeight` 更直观，因为它直接表达可见的拉伸高度。

## **使用渐变或图片填充的 3D 效果**

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

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

```cpp
const float imageScale = 2.0f;

auto presentation = System::MakeObject<Presentation>();

auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 250.0f, 250.0f);
shape->get_TextFrame()->set_Text(u"3D Gradient");
shape->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(64.0f);

auto firstGradientColor = System::Drawing::Color::get_Blue();
auto secondGradientColor = System::Drawing::Color::get_Orange();
shape->get_FillFormat()->set_FillType(FillType::Gradient);
shape->get_FillFormat()->get_GradientFormat()->get_GradientStops()->Add(0.0f, firstGradientColor);
shape->get_FillFormat()->get_GradientFormat()->get_GradientStops()->Add(100.0f, secondGradientColor);

auto extrusionColor = System::Drawing::Color::get_DarkOrange();
shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront);
shape->get_ThreeDFormat()->get_Camera()->SetRotation(10.0f, 20.0f, 30.0f);
shape->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Flat);
shape->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top);
shape->get_ThreeDFormat()->set_Material(MaterialPresetType::Flat);
shape->get_ThreeDFormat()->set_ExtrusionHeight(150.0);
shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor);

auto thumbnail = slide->GetImage(imageScale, imageScale);
thumbnail->Save(u"gradient_3d.png");
thumbnail->Dispose();

presentation->Dispose();
```

渲染输出保留前表面的渐变，并单独渲染拉伸：

![渲染的 3D 矩形，前表面为蓝到橙的渐变填充，侧面为橙色拉伸](img_02_03.png)

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

```cpp
auto imageData = System::IO::File::ReadAllBytes(u"image.jpg");
auto image = presentation->get_Images()->AddImage(imageData);

shape->get_FillFormat()->set_FillType(FillType::Picture);
shape->get_FillFormat()->get_PictureFillFormat()->get_Picture()->set_Image(image);
shape->get_FillFormat()->get_PictureFillFormat()->set_PictureFillMode(PictureFillMode::Stretch);

auto extrusionColor = System::Drawing::Color::get_DarkOrange();
shape->get_ThreeDFormat()->get_Camera()->SetRotation(10.0f, 20.0f, 30.0f);
shape->get_ThreeDFormat()->set_ExtrusionHeight(150.0);
shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(extrusionColor);
```

图片在前表面渲染，而拉伸作为 3D 侧面表面渲染：

![渲染的 3D 矩形，前表面为照片填充，侧面为橙色拉伸](img_02_04.png)

## **对文本应用 3D 格式化**

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

下面的示例创建使用图案填充的文字，应用 WordArt 变换，并在 [ITextFrameFormat](https://reference.aspose.com/slides/zh/cpp/aspose.slides/itextframeformat/) 上配置 3D 设置：

```cpp
const float imageScale = 2.0f;

auto presentation = System::MakeObject<Presentation>();

auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 250.0f, 250.0f);
shape->get_FillFormat()->set_FillType(FillType::NoFill);
shape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::NoFill);
shape->get_TextFrame()->set_Text(u"3D Text");

auto portion = shape->get_TextFrame()->get_Paragraph(0)->get_Portion(0);
portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Pattern);

auto foregroundColor = System::Drawing::Color::get_DarkOrange();
auto backgroundColor = System::Drawing::Color::get_White();
portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->get_ForeColor()->set_Color(foregroundColor);
portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->get_BackColor()->set_Color(backgroundColor);
portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->set_PatternStyle(PatternStyle::LargeGrid);

shape->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(128.0f);

auto textFrameFormat = shape->get_TextFrame()->get_TextFrameFormat();
textFrameFormat->set_Transform(TextShapeType::ArchUp);
textFrameFormat->get_ThreeDFormat()->set_ExtrusionHeight(3.5);
textFrameFormat->get_ThreeDFormat()->set_Depth(3.0);
textFrameFormat->get_ThreeDFormat()->set_Material(MaterialPresetType::Plastic);
textFrameFormat->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top);
textFrameFormat->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Balanced);
textFrameFormat->get_ThreeDFormat()->get_LightRig()->SetRotation(0.0f, 0.0f, 40.0f);
textFrameFormat->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::PerspectiveContrastingRightFacing);

auto thumbnail = slide->GetImage(imageScale, imageScale);
thumbnail->Save(u"text_3d.png");
thumbnail->Dispose();

presentation->Save(u"text_3d.pptx", SaveFormat::Pptx);
presentation->Dispose();
```

文本被渲染为弧形、拉伸的 3D 字体：

![渲染的 3D 文本，具有拱形 WordArt 变换、橙色图案填充和深色拉伸](img_02_05.png)

## **导出和渲染行为**

Aspose.Slides 在保存为 PPTX 等 PowerPoint 格式时会保留 3D 格式化。渲染或导出为固定布局格式时，3D 场景会光栅化或绘制为 2D 结果。这适用于将幻灯片渲染为 [PNG](/slides/zh/cpp/convert-powerpoint-to-png/)、导出为 [PDF](/slides/zh/cpp/convert-powerpoint-to-pdf/)、导出为 [HTML](/slides/zh/cpp/convert-powerpoint-to-html/)，或为 [video conversion](/slides/zh/cpp/convert-powerpoint-to-video/) 生成帧。

请记住以下要点：

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

## **常见问题**

**Aspose.Slides 能创建交互式 3D 演示文稿吗？**  
Aspose.Slides 创建并渲染 PowerPoint 形状和文本的 3D 效果。它不会使导出的图像、PDF 或 HTML 页面成为可由观众旋转的交互式 3D 场景。在 PPTX 中，若格式支持，3D 格式化仍可在 PowerPoint 中编辑。

**3D 模型和 3D 效果有什么区别？**  
3D 模型是插入到演示文稿中的独立 3D 对象。3D 效果是对普通 PowerPoint 形状或文本应用的格式化，如旋转、拉伸、倒角、照明和材质。本文讨论的正是 3D 效果。

**可视的 3D 形状需要哪些设置？**  
至少需要设置摄像机旋转以及拉伸或深度。实际使用中，还应设置灯光装置和材质，以便渲染出的面拥有明确的高光和阴影。

**可以同时对形状和文本应用 3D 效果吗？**  
可以。对形状本体使用 [IShape]，对文本使用 [ITextFrameFormat]。

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

**可以在继承和主题设置后读取最终的 3D 值吗？**  
可以。使用文中提到的有效格式化 API（[Shape Effective Properties]）读取最终的摄像机、灯光装置、倒角和相关 3D 值。