在 .NET 中创建 3D 演示文稿

概述

您通常如何创建 3D PowerPoint 演示文稿？
Microsoft PowerPoint 使您能够创建 3D 演示文稿，例如可以在其中添加 3D 模型、对形状应用 3D 效果、创建 3D 文本、将 3D 图形上传到演示文稿以及创建 PowerPoint 3D 动画。

创建 3D 效果可以显著提升演示文稿的视觉冲击力，并且可能是实现 3D 演示的最简便方式。
自 Aspose.Slides 20.9 版起，新增了 跨平台 3D 引擎。该引擎支持导出并栅格化带有 3D 效果的形状和文本。在早期版本中，带有 3D 效果的 Slides 形状会被平面渲染，而现在可以 完整渲染 3D。
此外，现已可以通过 Slides 公共 API 创建带有 3D 效果的形状。

在 Aspose.Slides API 中，要将形状转换为 PowerPoint 3D 形状，请使用 IShape.ThreeDFormat 属性，该属性继承自 IThreeDFormat 接口：

BevelBottom 和 BevelTop：为形状设置倒角，定义倒角类型（例如 Angle、Circle、SoftRound），以及倒角的高度和宽度。
Camera：用于模拟围绕对象的摄像机运动。换句话说，通过设置旋转、缩放等属性，您可以像操作 PowerPoint 中的 3D 模型一样操作形状。
ContourColor 和 ContourWidth：设置轮廓属性，使形状看起来像 3D PowerPoint 形状。
Depth、ExtrusionColor 和 ExtrusionHeight：用于让形状具备三维效果，即通过设置深度或拉伸将 2D 形状转换为 3D 形状。
LightRig：可以在 3D 形状上创建光照效果。该属性的逻辑类似于 Camera，您可以设置光源相对于 3D 形状的旋转角度并选择光源类型。
Material：设置 3D 形状的材质类型，可为其带来更真实的效果。该属性提供了一组预定义材质，例如 Metal、Plastic、Powder、Matte 等。

所有 3D 功能均可应用于形状和文本。下面我们逐步了解如何访问上述属性并详细查看其用法：

const float imageScale = 2;

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
    shape.TextFrame.Text = "3D";
    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 64;

    shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
    shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
    shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Flat;
    shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    shape.ThreeDFormat.Material = MaterialPresetType.Flat;
    shape.ThreeDFormat.ExtrusionHeight = 100;
    shape.ThreeDFormat.ExtrusionColor.Color = Color.Blue;

    using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
    {
        thumbnail.Save("sample_3d.png");
    }

    presentation.Save("sandbox_3d.pptx", SaveFormat.Pptx);
}

渲染后的缩略图如下所示：

todo:image_alt_text

3D 旋转

可以在 3D 平面上旋转 PowerPoint 3D 形状，从而实现更高的交互性。要在 PowerPoint 中旋转 3D 形状，通常使用以下菜单：

todo:image_alt_text

在 Aspose.Slides API 中，3D 形状的旋转可通过 IThreeDFormat.Camera 属性进行管理：

IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
// ... 设置其他 3D 场景参数

using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
{
    thumbnail.Save("sample_3d.png");
}

3D 深度和拉伸

要为形状添加第三维度并将其转换为 3D 形状，请使用 IThreeDFormat.ExtrusionHeight 和 IThreeDFormat.ExtrusionColor.Color 属性：

IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
shape.ThreeDFormat.ExtrusionHeight = 100;
shape.ThreeDFormat.ExtrusionColor.Color = Color.Purple;
// ... 设置其他 3D 场景参数

using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
{
    thumbnail.Save("sample_3d.png");
}

通常，您会在 PowerPoint 中使用 Depth 菜单来设置 3D 形状的深度：

todo:image_alt_text

3D 渐变

渐变可用于填充 PowerPoint 3D 形状的颜色。下面创建一个带有渐变填充颜色的形状并对其应用 3D 效果：

const float imageScale = 2;

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
    shape.TextFrame.Text = "3D Gradient";
    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 64;

    shape.FillFormat.FillType = FillType.Gradient;
    shape.FillFormat.GradientFormat.GradientStops.Add(0, Color.Blue);
    shape.FillFormat.GradientFormat.GradientStops.Add(100, Color.Orange);
    
    shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
    shape.ThreeDFormat.Camera.SetRotation(10, 20, 30);
    shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Flat;
    shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    shape.ThreeDFormat.ExtrusionHeight = 150;
    shape.ThreeDFormat.ExtrusionColor.Color = Color.DarkOrange;

    using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
    {
        thumbnail.Save("sample_3d.png");
    }
}

结果如下：

todo:image_alt_text

除了渐变填充颜色，还可以使用图像为形状填充：

byte[] imageData = File.ReadAllBytes("image.jpg");
IPPImage image = presentation.Images.AddImage(imageData);

shape.FillFormat.FillType = FillType.Picture;
shape.FillFormat.PictureFillFormat.Picture.Image = image;
shape.FillFormat.PictureFillFormat.PictureFillMode = PictureFillMode.Stretch;
// ... 设置 3D: shape.ThreeDFormat.Camera, shape.ThreeDFormat.LightRig, shape.ThreeDFormat.Extrusion* 属性

using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
{
    thumbnail.Save("sample_3d.png");
}

效果如下所示：

todo:image_alt_text

3D 文本（WordArt）

Aspose.Slides 也支持对文本应用 3D 效果。要创建 3D 文本，可以使用 WordArt 变形效果：

const float imageScale = 2;

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
    shape.FillFormat.FillType = FillType.NoFill;
    shape.LineFormat.FillFormat.FillType = FillType.NoFill;
    shape.TextFrame.Text = "3D Text";

    Portion portion = (Portion)shape.TextFrame.Paragraphs[0].Portions[0];
    portion.PortionFormat.FillFormat.FillType = FillType.Pattern;
    portion.PortionFormat.FillFormat.PatternFormat.ForeColor.Color = Color.DarkOrange;
    portion.PortionFormat.FillFormat.PatternFormat.BackColor.Color = Color.White;
    portion.PortionFormat.FillFormat.PatternFormat.PatternStyle = PatternStyle.LargeGrid;

    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 128;

    ITextFrameFormat textFrameFormat = shape.TextFrame.TextFrameFormat;
    // 设置 "Arch Up" WordArt 变换效果
    textFrameFormat.Transform = TextShapeType.ArchUp;

    textFrameFormat.ThreeDFormat.ExtrusionHeight = 3.5f;
    textFrameFormat.ThreeDFormat.Depth = 3;
    textFrameFormat.ThreeDFormat.Material = MaterialPresetType.Plastic;
    textFrameFormat.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    textFrameFormat.ThreeDFormat.LightRig.LightType = LightRigPresetType.Balanced;
    textFrameFormat.ThreeDFormat.LightRig.SetRotation(0, 0, 40);

    textFrameFormat.ThreeDFormat.Camera.CameraType = CameraPresetType.PerspectiveContrastingRightFacing;

    using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
    {
        thumbnail.Save("text3d.png");
    }

    presentation.Save("text3d.pptx", SaveFormat.Pptx);
}

结果如下：

todo:image_alt_text

常见问题

导出演示文稿为图像/PDF/HTML 时是否会保留 3D 效果？

是的。Slides 3D 引擎在导出为支持的格式（图像、PDF、HTML 等）时会渲染 3D 效果。

是否可以获取考虑主题、继承等因素后的“有效” (最终) 3D 参数值？

是的。Slides 提供了读取 有效值 的 API（包括 3D 的光照、倒角等），以便查看最终应用的设置：[/slides/net/shape-effective-properties/]。

在将演示文稿转换为视频时，3D 效果是否会生效？

会的。在 [/slides/net/convert-powerpoint-to-video/] 生成视频帧时，3D 效果会像导出图像时一样被渲染。

在 .NET 中使用动画增强 PowerPoint 演示文稿 .NET 6 支持