在 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 and setMaterial	表面材質，例如平面、霧面、塑膠或金屬。	讓相同的幾何形狀呈現更平坦、柔和、光亮或金屬的效果。
getExtrusionHeight and setExtrusionHeight	圖形從前表面向後延伸的距離。	將平面圖形轉換為可見的厚實 3D 物件。
getExtrusionColor	擠壓側面的顏色。	使深度可見，或將側面顏色與前景填色協調。
getDepth and setDepth	PowerPoint 3D 格式化使用的額外 3D 深度。	微調圖形或文字的深度，特別是與倒角與材質設定結合時。
getBevelTop and getBevelBottom	前後表面的凸起或圓角邊緣。	加入柔化或成型的邊緣，取代銳利的平面。
getContourColor, getContourWidth, and setContourWidth	3D 物件的輪廓線。	在渲染結果中強調物件邊界。

建立 3D 圖形

圖形在看起來真的具有 3D 效果之前，通常需要四種設定：

• 相機設定，因為預設的正面視角可能會遮蔽擠壓效果。
• 光源設定，因為光照讓各面與側面可辨識。
• 材質設定，因為表面會影響光線的呈現方式。
• 擠壓或深度設定，因為平面圖形需要厚度。

以下範例建立一個矩形、在其前表面加入文字、套用 3D 格式化，將簡報儲存為 PPTX，並將投影片渲染為 PNG 圖片。

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 Rotation」面板設定。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 在儲存為 PowerPoint 格式（如 PPTX）時會保留 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 效果套用於圖形與文字嗎？

可以。對圖形本體使用 IShape.getThreeDFormat，對文字使用 ITextFrameFormat.getThreeDFormat。

匯出為圖像、PDF、HTML 或影片框格時會顯示 3D 效果嗎？

會。Aspose.Slides 在產生投影片影像、PDF、HTML 以及用於影片轉換的框格時，都會渲染 3D 效果。匯出的結果僅包含已渲染好的外觀，而非可編輯的 3D 物件。

我能在繼承與佈景主題設定套用後讀取最終的 3D 值嗎？

可以。請使用在 有效圖形屬性 中描述的有效格式化 API，讀取最終的相機、光源、倒角與相關 3D 值。