在 Android 上创建演示文稿的 3D 效果

概述

Aspose.Slides for Android via Java 可以创建、编辑、保留并渲染 PowerPoint 样式的形状和文本的 3D 格式化。本篇文章介绍了 3D 效果，例如旋转、挤压、倒角、光照、材质、渐变或图片填充以及 3D 文本。

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

3D 格式化概念

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

对于文本，使用ITextFrameFormat.getThreeDFormat方法。这会对文本框而不是形状本体应用 3D 格式化。

最重要的 API 成员如下：

API 成员	控制内容	使用时机
getCamera	视点、预设相机类型、旋转、缩放和透视。	在 3D 空间中旋转对象或匹配 PowerPoint 的 3D 旋转预设。
getLightRig	光照预设、方向和光照旋转。	改变 3D 表面上高光和阴影的显示方式。
getMaterial和setMaterial	表面材质，如平面、哑光、塑料或金属。	使相同的几何形状看起来更平坦、更柔软、更光亮或金属化。
getExtrusionHeight和setExtrusionHeight	形状从正面向后延伸的距离。	将平面形状转换为明显厚实的 3D 对象。
getExtrusionColor	挤压侧面的颜色。	使深度可见或将侧面颜色与正面填充相协调。
getDepth和setDepth	PowerPoint 3D 格式化使用的额外 3D 深度。	微调形状或文本的深度，尤其是与倒角和材质设置一起使用时。
getBevelTop和getBevelBottom	正面和背面上的凸起或圆角边缘。	添加柔和或成型的边缘，而不是尖锐的平面。
getContourColor, getContourWidth, 和setContourWidth	3D 对象的轮廓线。	在渲染输出中突出对象边界。

创建 3D 形状

• 相机设置，因为默认的正视图可能会隐藏挤压效果。
• 光照设置，因为光照使面和侧面更易辨识。
• 材质设置，因为表面影响光线的渲染方式。
• 挤压或深度设置，因为平面形状需要厚度。

final float imageScale = 2;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
    shape.getTextFrame().setText("3D");
    shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(64);

    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.rgb(100, 149, 237));

    shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
    shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);
    shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
    shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
    shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
    shape.getThreeDFormat().setExtrusionHeight(100);
    shape.getThreeDFormat().getExtrusionColor().setColor(Color.BLUE);

    IImage thumbnail = slide.getImage(imageScale, imageScale);
    try {
        thumbnail.save("shape_3d.png", ImageFormat.Png);
    } finally {
        thumbnail.dispose();
    }

    presentation.save("shape_3d.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

使用相机旋转形状

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

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

shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);

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

添加挤压和深度

挤压通过将形状向正面后方延伸，使其看起来更厚。PowerPoint 中的深度控制设置可见的厚度，颜色控制设置侧面的颜色。

设置IThreeDFormat.setExtrusionHeight以确定厚度，使用IThreeDFormat.getExtrusionColor设置侧面颜色：

shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);
shape.getThreeDFormat().setExtrusionHeight(100);
shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(128, 0, 128));

当需要直接使用 PowerPoint 的深度值或将深度与倒角、材质和文本效果结合时，使用IThreeDFormat.setDepth。在多数形状场景中，setExtrusionHeight 更直观，因为它直接表示可见的挤压高度。

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

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

此示例对形状应用渐变填充，并对侧面使用更暗的挤压颜色：

final float imageScale = 2;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
    shape.getTextFrame().setText("3D Gradient");
    shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(64);

    shape.getFillFormat().setFillType(FillType.Gradient);
    shape.getFillFormat().getGradientFormat().getGradientStops().add(0, Color.BLUE);
    shape.getFillFormat().getGradientFormat().getGradientStops().add(100, Color.rgb(255, 165, 0));

    shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
    shape.getThreeDFormat().getCamera().setRotation(10, 20, 30);
    shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
    shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
    shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
    shape.getThreeDFormat().setExtrusionHeight(150);
    shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(255, 140, 0));

    IImage thumbnail = slide.getImage(imageScale, imageScale);
    try {
        thumbnail.save("gradient_3d.png", ImageFormat.Png);
    } finally {
        thumbnail.dispose();
    }
} finally {
    presentation.dispose();
}

渲染结果保留正面的渐变，并单独渲染挤压侧面：

若使用图片填充，需将图像添加到演示文稿并分配给形状填充：

IPPImage image;
try (FileInputStream imageStream = new FileInputStream("image.png")) {
    image = presentation.getImages().addImage(imageStream);
}

shape.getFillFormat().setFillType(FillType.Picture);
shape.getFillFormat().getPictureFillFormat().getPicture().setImage(image);
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);

shape.getThreeDFormat().getCamera().setRotation(10, 20, 30);
shape.getThreeDFormat().setExtrusionHeight(150);
shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(255, 140, 0));

图片渲染在正面，而挤压渲染为 3D 侧面：

将 3D 格式化应用于文本

形状的 3D 格式化影响形状本体。文本的 3D 格式化影响文本框。这对于需要对字母本身进行挤压、材质、光照和相机设置的 WordArt 类效果非常有用。

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

final float imageScale = 2;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
    shape.getTextFrame().setText("3D Text");

    IPortion portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Pattern);
    portion.getPortionFormat().getFillFormat().getPatternFormat().getForeColor().setColor(Color.rgb(255, 140, 0));
    portion.getPortionFormat().getFillFormat().getPatternFormat().getBackColor().setColor(Color.WHITE);
    portion.getPortionFormat().getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.LargeGrid);

    shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(128);

    ITextFrameFormat textFrameFormat = shape.getTextFrame().getTextFrameFormat();
    textFrameFormat.setTransform(TextShapeType.ArchUp);

    textFrameFormat.getThreeDFormat().setExtrusionHeight(3.5);
    textFrameFormat.getThreeDFormat().setDepth(3);
    textFrameFormat.getThreeDFormat().setMaterial(MaterialPresetType.Plastic);
    textFrameFormat.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
    textFrameFormat.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced);
    textFrameFormat.getThreeDFormat().getLightRig().setRotation(0, 0, 40);
    textFrameFormat.getThreeDFormat().getCamera().setCameraType(CameraPresetType.PerspectiveContrastingRightFacing);

    IImage thumbnail = slide.getImage(imageScale, imageScale);
    try {
        thumbnail.save("text_3d.png", ImageFormat.Png);
    } finally {
        thumbnail.dispose();
    }

    presentation.save("text_3d.pptx", SaveFormat.Pptx);
} finally {
    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 格式化仍保持可编辑。

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

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

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

至少需要设置相机旋转并使用挤压或深度。实际使用时，还应设置光照和材质，以便渲染出的面具有清晰的高光和阴影。

我可以将 3D 效果同时应用于形状和文本吗？

可以。对形状本体使用IShape.getThreeDFormat，对文本使用ITextFrameFormat.getThreeDFormat。

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

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

在继承和主题设置应用后，我可以读取最终的 3D 值吗？

可以。使用Shape Effective Properties中描述的有效格式化 API，读取最终的相机、光照、倒角等 3D 值。