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

概述

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

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

3D 格式化概念

使用 IShape 接口的 get_ThreeDFormat 方法对形状应用 3D 格式化。该方法返回 IThreeDFormat，用于控制该形状的 3D 场景。

对文本，使用 ITextFrameFormat 接口的 get_ThreeDFormat 方法。这会对文本框而不是形状本体应用 3D 格式化。

最重要的方法如下：

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

创建 3D 形状

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

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

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

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 块：

使用摄像机旋转形状

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

在 Aspose.Slides 中，通过 IThreeDFormat 设置摄像机类型和旋转：

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 中，深度控制决定可见的厚度，颜色控制决定侧面颜色。

使用 set_ExtrusionHeight 设置厚度，使用 get_ExtrusionColor 设置侧面颜色：

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。在多数形状场景下，set_ExtrusionHeight 更直观，因为它直接表达可见的拉伸高度。

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

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

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

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();

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

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

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 格式化

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

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

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 字体：

导出和渲染行为

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

请记住以下要点：

• 导出的图像和 PDF 不是交互式的。导出后对象无法被观众旋转。
• 最终外观取决于摄像机、灯光装置、材质、拉伸、填充和幻灯片缩放的组合。
• 如需检查继承或基于主题的格式化值，请读取 effective shape 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 值。