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

概述

Aspose.Slides for PHP via Java 可以创建、编辑、保留并渲染类似 PowerPoint 的形状和文本的 3D 格式化。本篇文章涵盖旋转、挤压、斜角、光照、材质、渐变或图片填充以及 3D 文本等 3D 效果。

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

3D 格式化概念

使用 Shape 类及其 Shape::getThreeDFormat 方法对形状应用 3D 格式化。该方法返回 ThreeDFormat，用于控制该形状的 3D 场景。

对于文本，使用 TextFrameFormat 类及其 TextFrameFormat::getThreeDFormat 方法。这会将 3D 格式化应用于文本框，而非形状本体。

最重要的设置包括：

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

创建 3D 形状

形状通常需要四种设置才能看起来具有可信的 3D 效果：

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

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

$imageScale = 2;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $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(new Java("java.awt.Color", 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(java("java.awt.Color")->BLUE);

    $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 中，通过 ThreeDFormat::getCamera 方法设置相机类型和旋转：

$shape->getThreeDFormat()->getCamera()->setCameraType(CameraPresetType::OrthographicFront);
$shape->getThreeDFormat()->getCamera()->setRotation(20, 30, 40);

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

添加挤压和深度

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

使用 ThreeDFormat::setExtrusionHeight 设置厚度，使用 ThreeDFormat::getExtrusionColor 设置侧面颜色：

$shape->getThreeDFormat()->getCamera()->setRotation(20, 30, 40);
$shape->getThreeDFormat()->setExtrusionHeight(100);
$shape->getThreeDFormat()->getExtrusionColor()->setColor(new Java("java.awt.Color", 128, 0, 128));

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

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

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

以下示例对形状使用渐变填充，并对侧面使用更深的挤压颜色：

$imageScale = 2;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $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, java("java.awt.Color")->BLUE);
    $shape->getFillFormat()->getGradientFormat()->getGradientStops()->add(100, java("java.awt.Color")->ORANGE);

    $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(new Java("java.awt.Color", 255, 140, 0));

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

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

如果要使用图片填充，请将图像添加到演示文稿并分配给形状填充：

$image = Images::fromFile("image.jpg");
try {
    $picture = $presentation->getImages()->addImage($image);
} finally {
    $image->dispose();
}

$shape->getFillFormat()->setFillType(FillType::Picture);
$shape->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($picture);
$shape->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode::Stretch);

$shape->getThreeDFormat()->getCamera()->setRotation(10, 20, 30);
$shape->getThreeDFormat()->setExtrusionHeight(150);
$shape->getThreeDFormat()->getExtrusionColor()->setColor(new Java("java.awt.Color", 255, 140, 0));

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

对文本应用 3D 格式化

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

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

$imageScale = 2;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $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");

    $portion = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0);
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Pattern);
    $portion->getPortionFormat()->getFillFormat()->getPatternFormat()->getForeColor()->setColor(new Java("java.awt.Color", 255, 140, 0));
    $portion->getPortionFormat()->getFillFormat()->getPatternFormat()->getBackColor()->setColor(java("java.awt.Color")->WHITE);
    $portion->getPortionFormat()->getFillFormat()->getPatternFormat()->setPatternStyle(PatternStyle::LargeGrid);

    $shape->getTextFrame()->getParagraphs()->get_Item(0)->getParagraphFormat()->getDefaultPortionFormat()->setFontHeight(128);

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

    $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 不是交互式的。导出后，观看者无法旋转对象。
• 最终外观取决于相机、光照、材质、挤压、填充和幻灯片缩放的组合。
• 如果需要检查继承或基于主题的格式化值，请读取 有效形状属性。
• 某些输出格式无法存储可编辑的 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 效果同时应用于形状和文本吗？

可以。对形状本体使用 Shape::getThreeDFormat，对文本使用 TextFrameFormat::getThreeDFormat。

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

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

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

可以。使用在 形状有效属性 中描述的有效格式化 API，读取最终的相机、光照、斜角及相关 3D 值。