在 JavaScript 中格式化 PowerPoint 圖形

介紹

在 PowerPoint 中透過調整輪廓、填色與效果來格式化圖形。Aspose.Slides for Node.js via Java 讓您能以程式方式控制這些設定,包括透明度、旋轉與 3D 格式化。

Shape formatting options in PowerPoint

Aspose.Slides for Node.js via Java 提供類別與方法,讓您使用 PowerPoint 中相同的選項來格式化圖形。

格式化線條

使用 Shape.getLineFormat 來控制圖形的輪廓。此範例建立一個未填滿的矩形,具有藍色、虛線的輪廓。LineFormat.setStyle 會選取粗細組合線,而 LineFormat.setWidth 將寬度設定為 7 點,並且 LineFormat.setDashStyle 會選擇虛線樣式。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
    shape.getLineFormat().setStyle(java.newByte(aspose.slides.LineStyle.ThickThin));
    shape.getLineFormat().setWidth(7);
    shape.getLineFormat().setDashStyle(java.newByte(aspose.slides.LineDashStyle.Dash));
    shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));

    presentation.save("formatted_lines.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The formatted lines in the presentation

設定自訂線條虛線圖案

當預先定義的線條樣式無法提供您需要的虛線長度與間隔時,請使用 LineFormat.setCustomDashPattern,例如在品牌輪廓或技術圖表中。指派圖案會自動將線條虛線樣式變更為 LineDashStyle.Custom。

陣列項目在虛線與間隔長度之間交替,從虛線開始。每個值都是線寬的倍數:寬度為 3 點時 [4, 2] 會產生 12 點的虛線接著 6 點的間隔。使用成對的有限非負值來定義完整的虛線與間隔段落。此範例使用正值以確保每段虛線與間隔皆可見。

此範例建立五條藍色線條,長度相同且端點為平直。前三條在寬度 3 點時比較圖案。第四條以兩倍寬度重複第一個圖案,將虛線與間隔長度皆加倍。第五條則從自訂圖案切換為實線。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(600, 300, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    let patterns = [
        [4, 2],
        [1, 2],
        [6, 2, 1, 2],
        [4, 2],
        [4, 2]
    ];

    for (let i = 0; i < patterns.length; i++) {
        let line = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Line, 50, 50 + i * 50, 500, 0);
        line.getLineFormat().setWidth(i == 3 ? 6 : 3);
        line.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 0, 139));
        line.getLineFormat().setCapStyle(java.newByte(aspose.slides.LineCapStyle.Flat));
        line.getLineFormat().setBeginArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
        line.getLineFormat().setEndArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
        let pattern = java.newArray("float", patterns[i]);
        line.getLineFormat().setCustomDashPattern(pattern);
    }

    // 將最後一條線回復為實線樣式。
    slide.getShapes().get_Item(4).getLineFormat().setDashStyle(java.newByte(aspose.slides.LineDashStyle.Solid));

    presentation.save("custom_dash_patterns.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

若要改回預先定義的虛線樣式,請將 LineDashStyle.Dash 傳遞給 LineFormat.setDashStyle。所選樣式會控制線條的外觀。

PowerPoint 中由上至下的結果:{4, 2}, 3 pt;{1, 2}, 3 pt;{6, 2, 1, 2}, 3 pt;{4, 2}, 6 pt;以及 Solid, 3 pt。

Three custom dash patterns, a wider line using the first pattern, and a solid line in PowerPoint

設定線條端點樣式

使用 LineFormat.setCapStyle 來設定開放線條的兩端。LineCapStyle 類別提供三種明確的端點樣式:

  • Flat:筆畫在端點處停止。
  • Round:半圓形端點延伸超過端點半個線寬。
  • Square:方形端點延伸超過端點半個線寬。

該類別亦包含 NotDefined,表示未明確指派端點樣式。

端點樣式不同於箭頭,後者會在線條兩端加入符號,也不同於交接點,交接點控制線段之間的拐角。本範例透過 LineFormat.setBeginArrowheadStyle 與 LineFormat.setEndArrowheadStyle 停用箭頭,以便僅比較端點形狀。

以下範例建立三條除端點外完全相同的水平線,寬度為 20 點。自上而下分別使用平直、圓形與方形端點。它們的端點具有相同的水平座標;圓形與方形端點各在每個端點外延伸 10 點。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(500, 240, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    let capStyles = [aspose.slides.LineCapStyle.Flat, aspose.slides.LineCapStyle.Round, aspose.slides.LineCapStyle.Square];

    for (let i = 0; i < capStyles.length; i++) {
        let line = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Line, 100, 50 + i * 70, 300, 0);
        line.getLineFormat().setWidth(20);
        line.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 0, 139));
        line.getLineFormat().setDashStyle(java.newByte(aspose.slides.LineDashStyle.Solid));
        line.getLineFormat().setCapStyle(java.newByte(capStyles[i]));
        line.getLineFormat().setBeginArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
        line.getLineFormat().setEndArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
    }

    presentation.save("line_caps.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

PowerPoint 中由上至下的結果:Flat、Round 與 Square。

Flat, round, and square caps on identical thick lines in PowerPoint

將草圖效果套用於圖形線條

草圖效果會讓圖形線條看起來像手繪。使用 Shape.getLineFormat 取得線條設定,使用 LineFormat.getSketchFormat 取得草圖設定,並透過 SketchFormat.setSketchType 從 LineSketchType 類別中選取值。

以下 JavaScript 程式碼示範如何套用 LineSketchType.Curved 效果、讀取明確指派的值,並使用 LineSketchType.None 移除效果:

const aspose = { slides: require("aspose.slides.via.java") };

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 200, 100);

    let sketchFormat = shape.getLineFormat().getSketchFormat();
    sketchFormat.setSketchType(aspose.slides.LineSketchType.Curved);
    let explicitSketchType = sketchFormat.getSketchType();
    console.log("Explicit sketch type: " + explicitSketchType);
    sketchFormat.setSketchType(aspose.slides.LineSketchType.None);
} finally {
    presentation.dispose();
}

由 SketchFormat.getSketchType 回傳的值代表直接指派給圖形的設定。如果線條格式可以從佈景主題、母片或版面投影片繼承,請使用 LineFormat.getEffective,在回傳的物件上呼叫 getSketchFormat,再呼叫其 getSketchType 方法。有效值會反映繼承解析後實際套用的格式。本範例需要一個已存在的投影片,且第一張投影片上至少有一個圖形,並同時列印兩個值:

const aspose = { slides: require("aspose.slides.via.java") };

let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    let shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    let lineFormat = shape.getLineFormat();
    let explicitSketchType = lineFormat.getSketchFormat().getSketchType();
    let effectiveLineFormat = lineFormat.getEffective();
    let effectiveSketchType = effectiveLineFormat.getSketchFormat().getSketchType();

    console.log("Explicit sketch type: " + explicitSketchType);
    console.log("Effective sketch type: " + effectiveSketchType);
} finally {
    presentation.dispose();
}

格式化交接樣式

以下是三種交接類型選項:

  • Round
  • Miter
  • Bevel

交接樣式控制兩條輪廓線段在拐角處的相接方式。使用 Round 取得圓角,使用 Miter 取得尖銳角,或使用 Bevel 取得平滑角。

The join style in the presentation

此範例建立三個黑色矩形,藍色輪廓寬度為 15 點。它分別使用 LineFormat.setJoinStyle 將 LineJoinStyle 的 miter、bevel 與 round 值套用,以比較角落的繪製效果。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let miterShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 20, 150, 75);
    let bevelShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 210, 20, 150, 75);
    let roundShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 135, 150, 75);

    miterShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    miterShape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    bevelShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    bevelShape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    roundShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    roundShape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));

    miterShape.getLineFormat().setWidth(15);
    bevelShape.getLineFormat().setWidth(15);
    roundShape.getLineFormat().setWidth(15);

    miterShape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    miterShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    bevelShape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    bevelShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    roundShape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    roundShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));

    miterShape.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Miter));
    bevelShape.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Bevel));
    roundShape.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Round));

    miterShape.getTextFrame().setText("Miter Join Style");
    bevelShape.getTextFrame().setText("Bevel Join Style");
    roundShape.getTextFrame().setText("Round Join Style");

    presentation.save("join_styles.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在尖銳角落限制斜接長度

使用 LineFormat.setMiterLimit 搭配將 LineFormat.setJoinStyle 設為 LineJoinStyle.Miter 來限制尖銳角落可以延伸的程度。

限制是內外角之間距離與線寬的比率。例如,值 8 允許斜接長度最高為線寬的八倍;它不是以點數衡量的尺寸。如果角落超過此限制,PowerPoint 會在該角落使用平斜接。較大的限制會產生更銳利的點。此設定僅影響斜接,且當角落仍在兩個限制之內時,變更設定不會有可見效果。

此範例建立兩個相同的未填滿三角形,輪廓寬度為 20 點。左側三角形使用限制 2,右側使用 8。每個三角形寬 80 點、高 160 點,使其頂端角的斜接長度與線寬比約為 4.12。因此,PowerPoint 會在左側尖端使用平斜接,右側則保留尖銳角。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(500, 320, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    let miterLimits = [2, 8];

    for (let i = 0; i < miterLimits.length; i++) {
        let triangle = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Triangle, 90 + i * 240, 110, 80, 160);
        triangle.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
        triangle.getLineFormat().setWidth(20);
        triangle.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
        triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 0, 139));
        triangle.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Miter));
        triangle.getLineFormat().setMiterLimit(java.newFloat(miterLimits[i]));
    }

    presentation.save("miter_limits.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

PowerPoint 中的結果:左側為 Miter limit 2,右側為 miter limit 8。

A beveled apex with miter limit 2 and a pointed apex with miter limit 8 in PowerPoint

漸層填色

漸層填色會在圖形內混合顏色。此範例使用 FillFormat.getGradientFormat 將橢圓形填入線性漸層,角度 45 度,從紅色過渡到紫色。透過 GradientStopCollection.addPresetColor 方法將顏色停止點置於 0 與 1,分別代表漸層的起始與結束。先清除現有的停止點,以確保僅使用這兩種顏色。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Ellipse, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
    shape.getFillFormat().getGradientFormat().setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
    shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45);
    shape.getFillFormat().getGradientFormat().getGradientStops().clear();
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0, aspose.slides.PresetColor.Purple);
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0, aspose.slides.PresetColor.Red);

    presentation.save("gradient_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The ellipse with gradient fill

如果在匯出圖像時漸層的外觀與 PowerPoint 中不同,請參閱 Choose a Gradient Rendering Style。您可以在不變更投影片中儲存的漸層填色的情況下選取渲染樣式。

設定線性漸層角度

使用 GradientFormat.setLinearGradientAngle 來控制 GradientShape.Linear 填色的方向。角度以度為單位,順時針遞增:0 從左至右,90 從上至下,180 從右至左,270 從下至上。支援小數角度。超出 [0, 360) 的有限角度會正規化為一圈,例如 -45 變為 315,360 變為 0。

此範例建立六個矩形,於位置 0、0.5、1 處分別設定相同的紅、綠、藍停止點。停用縮放,使角度的比較不受矩形比例影響。從左至右的角度分別為第一排的 0、45、90,第二排的 135、180、270。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(720, 400, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    let angles = [0, 45, 90, 135, 180, 270];

    for (let i = 0; i < angles.length; i++) {
        let x = 30 + (i % 3) * 230;
        let y = 30 + Math.floor(i / 3) * 190;

        let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, x, y, 200, 150);
        shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
        shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));

        let gradient = shape.getFillFormat().getGradientFormat();
        gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
        gradient.getGradientStops().clear();
        gradient.getGradientStops().add(0, java.getStaticFieldValue("java.awt.Color", "RED"));
        gradient.getGradientStops().add(java.newFloat(0.5), java.getStaticFieldValue("java.awt.Color", "GREEN"));
        gradient.getGradientStops().add(1, java.getStaticFieldValue("java.awt.Color", "BLUE"));
        gradient.setLinearGradientScaled(java.newByte(aspose.slides.NullableBool.False));
        gradient.setLinearGradientAngle(angles[i]);
    }

    presentation.save("linear_gradient_angles.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

PowerPoint 中的結果:

Linear gradients at 0, 45, and 90 degrees in the top row, and 135, 180, and 270 degrees in the bottom row

使用圖形縮放線性漸層

GradientFormat.setLinearGradientScaled 會接受一個 NullableBool 值。明確設為 False 可以在圖形比例改變時保留幾何漸層角度,設為 True 則會讓漸層隨圖形寬高縮放。啟用縮放時,非正方形圖形的可見角度可能與指派角度不同。

以下範例使用 45 度角度與與角度比較相同的顏色停止點。左欄使用 False,右欄使用 True。每欄包含一個寬矩形上方與一個高矩形。兩者起始尺寸相同;變更第二個矩形的寬高以示範在不變更漸層設定的情況下,填色如何因重新調整大小而回應。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(720, 460, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    let scalingOptions = [aspose.slides.NullableBool.False, aspose.slides.NullableBool.True];

    for (let column = 0; column < scalingOptions.length; column++) {
        for (let row = 0; row < 2; row++) {
            let x = 30 + column * 360;
            let y = row == 0 ? 30 : 150;

            let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, x, y, 300, 90);
            shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
            shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));

            let gradient = shape.getFillFormat().getGradientFormat();
            gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
            gradient.getGradientStops().clear();
            gradient.getGradientStops().add(0, java.getStaticFieldValue("java.awt.Color", "RED"));
            gradient.getGradientStops().add(java.newFloat(0.5), java.getStaticFieldValue("java.awt.Color", "GREEN"));
            gradient.getGradientStops().add(1, java.getStaticFieldValue("java.awt.Color", "BLUE"));
            gradient.setLinearGradientAngle(45);
            gradient.setLinearGradientScaled(java.newByte(scalingOptions[column]));

            if (row == 1) {
                shape.setWidth(90);
                shape.setHeight(280);
            }
        }
    }

    presentation.save("linear_gradient_scaling.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

PowerPoint 中的結果,左側縮放停用,右側啟用:

Wide and tall rectangles with a 45-degree gradient, comparing LinearGradientScaled False on the left with True on the right

當縮放停用時,對角線色帶在兩個矩形中保持相同方向。啟用縮放時,色帶會隨圖形比例伸展。這有助於在將圖形調整為不同尺寸時,重新製作範本的漸層。在正方形圖形上,啟用縮放不會改變此 45 度漸層的外觀。

角度與縮放設定皆套用於線性漸層。它們不會控制 GradientShape.Radial 或 GradientShape.Rectangle 填色。

將角度與漸層方向結合

GradientFormat.setGradientDirection 從 GradientDirection 類別中選取漸層樣式;它不是數值角度的替代品。對於線性漸層,角度可在不更改透過 setLinearGradientAngle 指派的角度的情況下,改變顏色分布的區域。比較角度或縮放時,請保持方向不變。

以下範例以相反的順序套用相同設定。兩個矩形外觀相同:先設定方向再設定角度或相反順序皆不會改變結果。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    for (let i = 0; i < 2; i++) {
        let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 30 + i * 140, 320, 100);
        shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
        shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));

        let gradient = shape.getFillFormat().getGradientFormat();
        gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
        gradient.getGradientStops().clear();
        gradient.getGradientStops().add(0, java.getStaticFieldValue("java.awt.Color", "RED"));
        gradient.getGradientStops().add(java.newFloat(0.5), java.getStaticFieldValue("java.awt.Color", "GREEN"));
        gradient.getGradientStops().add(1, java.getStaticFieldValue("java.awt.Color", "BLUE"));
        gradient.setLinearGradientScaled(java.newByte(aspose.slides.NullableBool.True));

        if (i == 0) {
            gradient.setGradientDirection(aspose.slides.GradientDirection.FromCorner1);
            gradient.setLinearGradientAngle(30);
        } else {
            gradient.setLinearGradientAngle(30);
            gradient.setGradientDirection(aspose.slides.GradientDirection.FromCorner1);
        }
    }

    presentation.save("linear_gradient_direction.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

圖案填色

圖案填色會套用兩色設計,例如點、條紋或格子。此範例使用 PatternFormat.setPatternStyle 選取格柵圖案。 PatternFormat.getBackColor 提供淡灰背景,而 PatternFormat.getForeColor 提供黃色圖案色。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Pattern));
    shape.getFillFormat().getPatternFormat().setPatternStyle(java.newByte(aspose.slides.PatternStyle.Trellis));
    shape.getFillFormat().getPatternFormat().getBackColor().setColor(java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY"));
    shape.getFillFormat().getPatternFormat().getForeColor().setColor(java.getStaticFieldValue("java.awt.Color", "YELLOW"));

    presentation.save("pattern_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The rectangle with pattern fill

圖片填色

圖片填色會在圖形內使用圖像。此範例需要本機圖像,並使用 Images.fromFile 將其載入投影片的圖像集合。將 PictureFillFormat.setPictureFillMode 設為平鋪模式,可在矩形內重複圖像。以下顯示此處使用的來源圖像:

The lotus picture

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 255, 130);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));
    shape.getFillFormat().getPictureFillFormat().setPictureFillMode(aspose.slides.PictureFillMode.Tile);

    let image = aspose.slides.Images.fromFile("lotus.png");
    let picture;
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        image.dispose();
    }
    shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);

    presentation.save("picture_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The shape with picture fill

將圖片平鋪為紋理

若要將平鋪圖片設定為紋理並自訂平鋪行為,您可以使用 PictureFillFormat 類別的下列方法:

  • setPictureFillMode:設定圖片填充模式——Tile 或 Stretch。
  • setTileAlignment:指定平鋪在圖形內的對齊方式。
  • setTileFlip:控制平鋪是否水平、垂直或同時翻轉。
  • setTileOffsetX:設定平鋪相對於圖形原點的水平位移(以點為單位)。
  • setTileOffsetY:設定平鋪相對於圖形原點的垂直位移(以點為單位)。
  • setTileScaleX:以百分比定義平鋪的水平縮放。
  • setTileScaleY:以百分比定義平鋪的垂直縮放。

此範例需要本機圖像,並設定 PictureFillFormat 以 50% 原始大小平鋪。將 X、Y 偏移設定為 -32 點,使平鋪在水平與垂直方向上偏移;底部右側對齊並在兩個方向翻轉,決定重複紋理的排列方式。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let firstSlide = presentation.getSlides().get_Item(0);

    let shape = firstSlide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 190, 95);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));

    let sourceImage = aspose.slides.Images.fromFile("lotus.png");
    let presentationImage;
    try {
        presentationImage = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    let pictureFillFormat = shape.getFillFormat().getPictureFillFormat();
    pictureFillFormat.getPicture().setImage(presentationImage);
    pictureFillFormat.setPictureFillMode(aspose.slides.PictureFillMode.Tile);
    pictureFillFormat.setTileOffsetX(-32);
    pictureFillFormat.setTileOffsetY(-32);
    pictureFillFormat.setTileScaleX(50);
    pictureFillFormat.setTileScaleY(50);
    pictureFillFormat.setTileAlignment(java.newByte(aspose.slides.RectangleAlignment.BottomRight));
    pictureFillFormat.setTileFlip(aspose.slides.TileFlip.FlipBoth);

    presentation.save("tile.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The tile options

純色填色

純色填色會為圖形提供單一均勻的顏色。此範例使用 FillFormat.setFillType 選取純色填充模式,並透過 FillFormat.getSolidFillColor 指派黃色,最後將矩形儲存至投影片。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "YELLOW"));

    presentation.save("solid_color_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The shape with solid color fill

複製顏色同時保留佈景主題參照

使用 ColorFormat.copyFrom 複製顏色定義,包括其顏色類型、佈景主題參照與轉換。這在將填色在應持續遵循投影片主題的圖形之間傳遞時很有用。此方法僅複製顏色,並不複製填充類型、輪廓或其他圖形格式。請以 FillFormat.setFillType 明確設定目標的填充類型。

此範例建立三個矩形,從左至右分別為來源、具佈景主題感知的副本以及固定 RGB 的副本。來源使用 ColorFormat.setSchemeColor 參照第一個重點色,並透過 ColorOperationCollection.add 加上色調。RGB 副本使用來源的有效填色,因此三者最初看起來相同。呼叫 ColorFormat.setColor 會設定固定的 RGB 值,並清除任何既有的顏色轉換。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(660, 220, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(java.newInstanceSync("java.awt.Color", 65, 105, 225));

    let source = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 40, 180, 140);
    let themeCopy = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 240, 40, 180, 140);
    let rgbCopy = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 450, 40, 180, 140);

    for (let shape of [source, themeCopy, rgbCopy]) {
        shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
        shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
    }

    let sourceColor = source.getFillFormat().getSolidFillColor();
    sourceColor.setSchemeColor(aspose.slides.SchemeColor.Accent1);
    sourceColor.getColorTransform().add(aspose.slides.ColorTransformOperation.Tint, java.newFloat(0.75));

    themeCopy.getFillFormat().getSolidFillColor().copyFrom(sourceColor);
    rgbCopy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor());

    let before = slide.getImage(1, 1);
    try {
        before.save("color-copy-before.png", aspose.slides.ImageFormat.Png);
    } finally {
        before.dispose();
    }

    // 主題參照會跟隨新的重點色;固定的 RGB 值不會跟隨。
    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(java.newInstanceSync("java.awt.Color", 255, 69, 0));

    let after = slide.getImage(1, 1);
    try {
        after.save("color-copy-after.png", aspose.slides.ImageFormat.Png);
    } finally {
        after.dispose();
    }
    presentation.save("copied_colors.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在佈景主題變更前,所有三個填色皆相同:

Source, copyFrom destination, and fixed RGB destination with identical blue fills

佈景主題變更後,來源與具佈景主題感知的副本會跟隨新的重點色並保留其色調。固定的 RGB 副本仍保持藍色:

Source and copyFrom destination with orange fills, while the fixed RGB destination remains blue

複製的定義與來源獨立。之後變更來源的佈景主題參照、指派其他顏色,或新增或移除其轉換,都不會影響目的地。佈景主題變更仍會影響兩個圖形,因為它們各自獨立參照相同的佈景主題顏色。

儲存並重新開啟 PPTX 會保留 ColorFormat.getColorType 回傳的顏色類型、佈景主題參照與 ColorFormat.getColorTransform 回傳的轉換集合;不會將定義展平為 RGB。

在不同佈景主題上下文之間複製時,例如在具有不同重點調色盤的投影片中,複製的參照會根據目的地的佈景主題解析。因此,同一參照與轉換在不同主題下可能產生不同的可見顏色。請參閱 Presentation Theme 以了解更多佈景主題顏色設定。

將投影片背景作為圖形填色

當圖形應與投影片背景相同時(例如在投影片範本中),請使用 AutoShape.setUseBackgroundFill。先以 FillFormat.setFillType 設為 FillType.NotDefined 以移除任何明確的填色。結合此設定後,圖形會使用投影片背景而非其樣式填色。僅啟用此旗標不會移除已存在的明確填色。

這與 FillType.NoFill 不同:背景填色會以投影片背景的相應區域覆蓋圖形後方的物件,而無填色則會讓這些物件仍可見。漸層仍會與投影片對齊,而不是在每個圖形內重新開始。

以下範例建立一個由投影片繼承的母片背景,並在三個矩形後方放置一條洋紅色條帶。左側矩形使用背景填色,中間矩形無填色,右側矩形則由背景填色切換為明確的橙色填色。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    presentation.getSlideSize().setSize(720, 400, aspose.slides.SlideSizeScaleType.DoNotScale);
    let slide = presentation.getSlides().get_Item(0);

    // 從母片繼承漸層。
    slide.getBackground().setType(java.newByte(aspose.slides.BackgroundType.NotDefined));
    slide.getLayoutSlide().getBackground().setType(java.newByte(aspose.slides.BackgroundType.NotDefined));
    let background = slide.getLayoutSlide().getMasterSlide().getBackground();
    background.setType(java.newByte(aspose.slides.BackgroundType.OwnBackground));
    background.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
    let gradient = background.getFillFormat().getGradientFormat();
    gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
    gradient.setLinearGradientAngle(0);
    gradient.getGradientStops().clear();
    gradient.getGradientStops().add(0, java.newInstanceSync("java.awt.Color", 0, 0, 139));
    gradient.getGradientStops().add(1, java.newInstanceSync("java.awt.Color", 135, 206, 250));

    // 先加入此物件,使其位於矩形之後方。
    let band = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 25, 150, 670, 100);
    band.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    band.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "MAGENTA"));
    band.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));

    let backgroundShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 100, 160, 200);
    backgroundShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NotDefined));
    backgroundShape.setUseBackgroundFill(true);

    let noFillShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 280, 100, 160, 200);
    noFillShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));

    let explicitShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 510, 100, 160, 200);
    explicitShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NotDefined));
    explicitShape.setUseBackgroundFill(true);

    // 在套用明確填色前先停用背景填色。
    explicitShape.setUseBackgroundFill(false);
    explicitShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    explicitShape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 165, 0));

    presentation.save("background_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果,從左至右:background fill、no fill 與 explicit fill。洋紅色條帶被左、右矩形遮蔽,但仍在中間矩形下可見。

Background fill, no fill, and explicit orange fill over a magenta band

相同的行為會套用於直接在投影片上定義或從版面繼承的背景。圖形使用投影片解析後的背景;此範例保留投影片與版面背景未定義,讓母片提供背景。

設定透明度

對於純色填色,顏色的 alpha 組件控制不透明度:0 表示全透明,255 表示全不透明。此範例使用 128 的 alpha 值為黃色矩形,約 50% 透明,使底下的矩形仍可見。顏色透過 FillFormat.getSolidFillColor 指派。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let solidShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);

    let transparentShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 80, 80, 150, 75);
    transparentShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    transparentShape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 255, 0, 128));

    presentation.save("shape_transparency.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The transparent shape

旋轉圖形

使用 Shape.setRotation 在投影片平面上旋轉圖形。角度以度為單位;本範例將矩形順時針旋轉 5 度,並儲存投影片。

const aspose = { slides: require("aspose.slides.via.java") };

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
    shape.setRotation(5);

    presentation.save("shape_rotation.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The shape rotation

加入 3D 檐口效果

使用 Shape.getThreeDFormat 為圖形添加深度與檐口邊緣。此範例建立綠色橢圓,橙色輪廓,使用 ThreeDFormat.setDepth 設定深度為 4 點,並透過 ThreeDFormat.getBevelTop 使用寬度與高度皆為 6 點的圓形上檐口。前視正交相機與三點光源使檐口可見。

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Ellipse, 50, 50, 100, 100);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 128, 0));
    shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 165, 0));
    shape.getLineFormat().setWidth(2.0);
    shape.getThreeDFormat().setDepth(4);
    shape.getThreeDFormat().getBevelTop().setBevelType(aspose.slides.BevelPresetType.Circle);
    shape.getThreeDFormat().getBevelTop().setHeight(6);
    shape.getThreeDFormat().getBevelTop().setWidth(6);
    shape.getThreeDFormat().getCamera().setCameraType(aspose.slides.CameraPresetType.OrthographicFront);
    shape.getThreeDFormat().getLightRig().setLightType(aspose.slides.LightRigPresetType.ThreePt);
    shape.getThreeDFormat().getLightRig().setDirection(aspose.slides.LightingDirection.Top);

    presentation.save("3D_bevel_effect.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The 3D bevel effect

加入 3D 旋轉效果

圖形的 3D 觀點受相機設定控制。此範例使用 Camera.setRotation 設定緯度、經度與旋轉角度分別為 40、35、20 度。透過 Camera.setCameraType 選取等角相機,並使用 LightRig.setLightType 設定平衡光源,最後儲存已格式化的矩形。

const aspose = { slides: require("aspose.slides.via.java") };

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let autoShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
    autoShape.getTextFrame().setText("Hello, Aspose!");
    autoShape.getThreeDFormat().getCamera().setCameraType(aspose.slides.CameraPresetType.IsometricLeftUp);
    autoShape.getThreeDFormat().getCamera().setRotation(40, 35, 20);
    autoShape.getThreeDFormat().getLightRig().setLightType(aspose.slides.LightRigPresetType.Balanced);

    presentation.save("3D_rotation_effect.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

結果:

The 3D rotation effect

控制圖形的黑白渲染

Shape.setBlackWhiteMode 方法指定當投影片以黑白模式檢視或處理時,單一圖形的渲染方式。此方法本身不會啟用黑白顯示,也不會在正常彩色模式下變更圖形的填色、線條或其他格式。

使用來自 BlackWhiteMode 類別的值以選取所需行為。例如,Automatic 讓渲染應用程式自行選擇轉換,Gray 與 LightGray 使用灰階顏色,BlackWhite 僅使用黑白,Black 與 White 強制單一顏色,Color 保留正常上色,Hidden 在黑白模式中省略圖形。NotDefined 表示未指派圖形層級模式。

此範例建立一個橙色矩形,並使用 Shape.setBlackWhiteMode 選取灰階上色。儲存的圖形在正常彩色顯示時保留橙色填色,並在遵循黑白顯示設定的應用程式中請求灰階上色:

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

let presentation = new aspose.slides.Presentation();
try {
    let slide = presentation.getSlides().get_Item(0);

    let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 200, 100);
    shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 165, 0));
    shape.setBlackWhiteMode(java.newByte(aspose.slides.BlackWhiteMode.Gray));

    presentation.save("shape_black_white_mode.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在正常彩色模式下,矩形保留橙色填色。在黑白顯示工作流程中,因模式設為 Gray,故使用灰階上色。這讓您在保留全彩投影片的同時,為列印、預覽或其他遵循投影片黑白顯示設定的工作流程定義不同的外觀。

重設格式

使用 Slide.reset 以從相對應的版面占位元復原投影片占位元的位置、大小與格式。此範例需要一個已存在且占位元連結至版面的投影片,並在儲存前重設每張投影片。未與版面占位元對應的圖形不會被重設。

const aspose = { slides: require("aspose.slides.via.java") };

let presentation = new aspose.slides.Presentation("sample.pptx");
try {
    for (let i = 0; i < presentation.getSlides().size(); i++) {
        let slide = presentation.getSlides().get_Item(i);
        slide.reset();
    }

    presentation.save("reset_formatting.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

常見問題

圖形格式化會影響最終投影片檔案大小嗎?

顏色、線條樣式與效果設定相較於嵌入的圖像與媒體一般只會增加少量資料。圖片填色可能會因圖像儲存在投影片中而增加檔案大小。

如何偵測投影片上具有相同格式的圖形,以便將它們分組?

比較每個圖形的關鍵格式屬性——填色、線條與效果設定。如果所有對應的值都相符,則將它們的樣式視為相同,並在邏輯上將這些圖形分組,這可簡化後續的樣式管理。

我可以將一組自訂圖形樣式儲存為單獨的檔案,以供其他投影片使用嗎?

是的。將帶有所需樣式的範本圖形儲存在範本投影片或 .POTX 範本檔案中。建立新投影片時,開啟範本,複製所需的樣式圖形,並在需要的地方重新套用其格式。