在 PHP 中自訂簡報圖形

本頁內容簡介

使用 Aspose.Slides for PHP（透過 Java）在 PowerPoint 簡報中建立與自訂圖形：幾何路徑、圓角、合成圖形。

概覽

本文說明如何透過編輯點與幾何路徑，透過編輯形狀的幾何來自訂 Aspose.Slides 簡報中的圖形外觀。它展示了如何使用 GeometryPath 來修改現有圖形、執行基本路徑編輯操作、加入或移除點，並將更新後的幾何套用回圖形。

同時也示範了如何建立自訂與合成圖形、打造帶有圓角的圖形、判斷圖形幾何是否閉合、檢視圖形元素，以及將 Java AWT 文字輪廓轉換為幾何路徑。

使用編輯點變更圖形

在 PowerPoint 中，您可以使用 編輯點 來修改正方形：

向內或向外移動角落。
調整點的曲率。
新增點。

編輯點讓您能修改圖形的輪廓，或以現有圖形作為新圖形的基礎。

圖形編輯技巧

overview_image

編輯 PowerPoint 圖形時，請記住以下概念：

圖形（或其路徑）可以是閉合或開放的。
圖形的路徑由錨點與連接的線段組成。
線段可以是直線或曲線。錨點與控制手柄決定其形狀。
錨點有三種形式：角點、直線點或平滑點：
- 在角點，鄰接的線段可以形成角度。
- 在平滑點，兩個控制手柄對齊且與錨點的距離相等。
- 在直線點，兩個控制手柄對齊但與錨點的距離可以不同。
移動錨點或調整其手柄會改變圖形的輪廓。

要透過編輯點編輯 PowerPoint 圖形，Aspose.Slides 提供了 GeometryPath 類別。

GeometryPath 實例代表 GeometryShape 物件的幾何路徑。
若要從 GeometryShape 取得 GeometryPath，可使用 GeometryShape::getGeometryPaths 方法。
若要為圖形設定 GeometryPath，可使用以下方法：單一路徑圖形使用 GeometryShape::setGeometryPath；多路徑圖形使用 GeometryShape::setGeometryPaths。
若要新增線段，可使用 GeometryPath 下的各種方法。
使用 GeometryPath::setStroke 與 GeometryPath::setFillMode 方法，可設定幾何路徑的外觀。
使用 GeometryPath::getPathData 方法，可將 GeometryShape 的幾何路徑作為路徑線段陣列取得。
若要存取其他圖形幾何自訂選項，可透過 java.awt.Shape 的 PathIterator 讀取，並在 GeometryPath 上重放這些線段。

簡單編輯操作

使用下列方法編輯幾何路徑。接受索引的重載會在路徑線段陣列的零基位置插入線段。

操作	方法
追加或插入直線。	GeometryPath::lineTo
追加或插入具有兩個控制點與終點的三次貝茲曲線。	GeometryPath::cubicBezierTo
追加或插入具有一個控制點與終點的二次貝茲曲線。	GeometryPath::quadraticBezierTo
以指定的尺寸與角度（度）追加橢圓弧。	GeometryPath::arcTo
透過將端點連回起始點來關閉目前的圖形。	GeometryPath::closeFigure
設定圖形的起始點。	GeometryPath::moveTo
移除零基索引位置的線段。	GeometryPath::removeAt

為圖形加入自訂點

此範例使用 GeometryPath::lineTo 在矩形圖形中插入兩個點，並以 GeometryShape::setGeometryPath 套用編輯後的路徑。座標為相對於圖形的本地座標：兩個新點位於圖形中心，距左側 100 點、距上側 50 點。線段索引 1 與 4 分別將它們放在上緣與下緣，將這兩條邊向內拉。

use aspose\slides\Presentation;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);

    $geometryPath = $shape->getGeometryPaths()[0];
    $geometryPath->lineTo(100, 50, 1);
    $geometryPath->lineTo(100, 50, 4);

    $shape->setGeometryPath($geometryPath);
} finally {
    $presentation->dispose();
}

example1_image

從圖形移除點

此範例透過 GeometryPath::removeAt 移除零基索引 2 處的線段，以變更心形輪廓。再以 GeometryShape::setGeometryPath 套用修改後的路徑，即可更新圖形的輪廓。

use aspose\slides\Presentation;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shape = $slide->getShapes()->addAutoShape(ShapeType::Heart, 100, 100, 300, 300);

    $path = $shape->getGeometryPaths()[0];
    $path->removeAt(2);

    $shape->setGeometryPath($path);
} finally {
    $presentation->dispose();
}

example2_image

建立自訂圖形

此範例使用 GeometryPath 建立一個五角星。外徑與內徑分別為 100 與 50 點，交替形成星尖與凹陷；每隔 72 度放置一個星尖，使五個星尖均勻分布。最後以 GeometryPath::closeFigure 關閉路徑，並使用 GeometryShape::setGeometryPath 套用到矩形圖形，取代其原有輪廓。

use aspose\slides\GeometryPath;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;

$points = [];
$outerRadius = 100;
$innerRadius = 50;
$angleStep = 72;
for ($angle = -90; $angle < 270; $angle += $angleStep) {
    $radians = deg2rad($angle);
    $points[] = [$outerRadius * cos($radians) + $outerRadius, $outerRadius * sin($radians) + $outerRadius];
    $radians = deg2rad($angle + $angleStep / 2);
    $points[] = [$innerRadius * cos($radians) + $outerRadius, $innerRadius * sin($radians) + $outerRadius];
}

$starPath = new GeometryPath();
$starPath->moveTo($points[0][0], $points[0][1]);
for ($i = 1; $i < count($points); $i++) {
    $starPath->lineTo($points[$i][0], $points[$i][1]);
}
$starPath->closeFigure();

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, $outerRadius * 2, $outerRadius * 2);
    $shape->setGeometryPath($starPath);
} finally {
    $presentation->dispose();
}

example3_image

建立合成自訂圖形

此範例為圖形的上、下三分之一分別定義兩個閉合的 GeometryPath 物件。透過 GeometryShape::setGeometryPaths 同時套用兩條路徑，即可產生一個在中間三分之一留下間隙的單一合成圖形。

use aspose\slides\GeometryPath;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);

    $topPath = new GeometryPath();
    $topPath->moveTo(0, 0);
    $topPath->lineTo(java_values($shape->getWidth()), 0);
    $topPath->lineTo(java_values($shape->getWidth()), java_values($shape->getHeight()) / 3);
    $topPath->lineTo(0, java_values($shape->getHeight()) / 3);
    $topPath->closeFigure();

    $bottomPath = new GeometryPath();
    $bottomPath->moveTo(0, java_values($shape->getHeight()) / 3 * 2);
    $bottomPath->lineTo(java_values($shape->getWidth()), java_values($shape->getHeight()) / 3 * 2);
    $bottomPath->lineTo(java_values($shape->getWidth()), java_values($shape->getHeight()));
    $bottomPath->lineTo(0, java_values($shape->getHeight()));
    $bottomPath->closeFigure();

    $shape->setGeometryPaths([$topPath, $bottomPath]);
} finally {
    $presentation->dispose();
}

example4_image

建立帶有圓角的自訂圖形

此範例將直線段與 GeometryPath::arcTo 結合，打造一個內側弧形角落的圖形。每個角落大小決定弧形的寬高（以點為單位），-90 度的掃描角繪製逆時針四分之一橢圓。完成的路徑以 GeometryShape::setGeometryPath 套用，最後將簡報儲存為 PPTX 格式。

use aspose\slides\GeometryPath;
use aspose\slides\Point2DFloat;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

$shapeX = 20;
$shapeY = 20;
$shapeWidth = 300;
$shapeHeight = 200;

$leftTopSize = 50;
$rightTopSize = 20;
$rightBottomSize = 40;
$leftBottomSize = 10;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shape = $slide->getShapes()->addAutoShape(ShapeType::Custom, $shapeX, $shapeY, $shapeWidth, $shapeHeight);

    $topLeft = new Point2DFloat($leftTopSize, 0);
    $topRight = new Point2DFloat($shapeWidth - $rightTopSize, 0);
    $rightBottom = new Point2DFloat($shapeWidth, $shapeHeight - $rightBottomSize);
    $bottomLeft = new Point2DFloat($leftBottomSize, $shapeHeight);
    $leftTop = new Point2DFloat(0, $leftTopSize);

    $geometryPath = new GeometryPath();
    $geometryPath->moveTo($topLeft);
    $geometryPath->lineTo($topRight);
    $geometryPath->arcTo($rightTopSize, $rightTopSize, 180, -90);
    $geometryPath->lineTo($rightBottom);
    $geometryPath->arcTo($rightBottomSize, $rightBottomSize, -90, -90);
    $geometryPath->lineTo($bottomLeft);
    $geometryPath->arcTo($leftBottomSize, $leftBottomSize, 0, -90);
    $geometryPath->lineTo($leftTop);
    $geometryPath->arcTo($leftTopSize, $leftTopSize, 90, -90);
    $geometryPath->closeFigure();

    $shape->setGeometryPath($geometryPath);

    $presentation->save("output.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

判斷圖形幾何是否閉合

以下輔助方法會檢查每個非空的幾何路徑是否以關閉段結尾。它會讀取 GeometryPath::getPathData，並將最後一段的 PathSegment::getPathCommand 與 PathCommandType::Close 比較。若沒有非空路徑則回傳 false。此檢查僅檢視每條路徑的最終指令，並不會檢查路徑內的每個子圖形。範例會對矩形輸出 true。

use aspose\slides\PathCommandType;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;

function isGeometryClosed($geometryShape)
{
    $hasNonemptyPath = false;
    foreach ($geometryShape->getGeometryPaths() as $geometryPath) {
        $segments = java_values($geometryPath->getPathData());
        if (count($segments) === 0) {
            continue;
        }
        $hasNonemptyPath = true;
        $lastSegment = $segments[count($segments) - 1];
        if (java_values($lastSegment->getPathCommand()) !== PathCommandType::Close) {
            return false;
        }
    }
    return $hasNonemptyPath;
}

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $closed = isGeometryClosed($shape);
    echo ($closed ? "true" : "false") . PHP_EOL;
} finally {
    $presentation->dispose();
}

擷取與檢查圖形元素

使用 GeometryShape::createShapeElements 可將既有圖形以包含路徑點與點類型的元素形式檢查。對每個返回的 ShapeElement，可透過 getPathPoints 與 getPathTypes 取得點陣列與類型陣列。此表示方式適合輪廓分析或將幾何傳遞給自訂繪圖工具。

範例會開啟 input.pptx，直接在第一張投影片上取得第一個幾何圖形，並印出其路徑線段。請使用包含直線與曲線段的圖形的簡報，以觀察兩種輸出。此方法不會搜尋群組內的圖形。

use aspose\slides\Presentation;

$presentation = new Presentation("input.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shape = null;
    $shapes = $slide->getShapes();
    for ($shapeIndex = 0; $shapeIndex < java_values($shapes->size()); $shapeIndex++) {
        $candidate = $shapes->get_Item($shapeIndex);
        if (java_instanceof($candidate, java("com.aspose.slides.GeometryShape"))) {
            $shape = $candidate;
            break;
        }
    }

    if ($shape === null) {
        echo "No geometry shape found on the first slide." . PHP_EOL;
    } else {
        foreach ($shape->createShapeElements() as $element) {
            $points = java_values($element->getPathPoints());
            $types = array_values(unpack("C*", java_values($element->getPathTypes())));
            echo "Shape element:" . PHP_EOL;
            for ($i = 0; $i < count($points); $i++) {
                $pointType = $types[$i] & 0x07; // 保留線段類型，排除旗標。
                switch ($pointType) {
                    case 0:
                        echo "Start figure at " . $points[$i] . PHP_EOL;
                        break;
                    case 1:
                        echo "Line to " . $points[$i] . PHP_EOL;
                        break;
                    case 3:
                        echo "Cubic Bezier: controls " . $points[$i] . ", " . $points[$i + 1] . "; end " . $points[$i + 2] . PHP_EOL;
                        $i += 2; // 同時消耗兩個控制點與端點。
                        break;
                }
                if (($types[$i] & 0x80) !== 0) {
                    echo "Close subpath back to its starting point." . PHP_EOL;
                }
            }
        }
    }
} finally {
    $presentation->dispose();
}

陣列的索引對應關係為：$points[$i] 為一個點，$types[$i] 描述其角色。類型 0 表示開始一個圖形，類型 1 表示從前一點畫線到目前點。三次貝茲線段以先前的端點開始，使用連續三個類型為 3 的條目：兩個控制點加上新端點。迴圈會一次消耗這三個條目，並檢查端點是否閉合。

點類型也可能包含旗標。使用 0x07 取得線段類型，另以 0x80 判斷是否為閉合子路徑。例如 129 (0x81) 代表閉合的線段端點，131 (0x83) 代表閉合的貝茲端點。PHP/Java Bridge 會將位元組陣列以二進位字串回傳；使用 "C*" 解包後會得到無號位元組值。遮罩保留了預期的位元值。僅以 1 或 3 比對原始值會遺漏這些情況。其他旗標，例如虛線 (0x10) 與標記 (0x20) 不會更改基礎線段類型。

座標與變換。 點的單位為點 (1/72 吋)，X 向右增大，Y 向下增大。對於未群組化的圖形，擷取的座標已經包含由 getX 與 getY 取得的位置，並反映其當前寬度與高度。例如，未旋轉的矩形位於 (100, 200)、尺寸為 120 × 80，其輪廓界限為 (100, 200)–(220, 280)。請勿再次加上圖形的位置。若要取得相對於未旋轉框架的座標，需減去其 X 與 Y。

擷取的點不會套用圖形由 getRotation 取得的旋轉，或水平與垂直翻轉。若要重現顯示的輪廓，須以圖形中心為基點套用這些變換。對於群組圖形，還需考慮群組座標映射與變換；不要假設擷取的點已是最終投影片座標，亦不要在已反映於子圖形框架的情況下再次平移或縮放。

檢查 vs. 編輯。 擷取的陣列僅描述輪廓；更改它們不會更新原始圖形。當您的分析或繪圖程式需要點/類型陣列時，請使用此方式。若需要在圖形本地座標系中取得幾何指令或編輯其幾何，請使用 getGeometryPaths。編輯後的路徑可透過 setGeometryPath 或 setGeometryPaths 套用。

將 Java AWT Shape 轉換為 GeometryPath

此範例將矩形輪廓與轉換成幾何的文字結合。輪廓的 setFillMode 方法會關閉填色。透過 GlyphVector 產生文字輪廓，建立於 java.awt.Shape 中。其 PathIterator 會提供移動、線段、二次、三次與關閉段，範例將這些指令重新播放於 GeometryPath 上。

範例使用 Java 浮點數陣列，以確保 PHP/Java Bridge 能保留迭代器寫入的座標。文字採用 40 點 Arial 字型。輪廓在水平方向偏移 20 點，且其視覺上方位於圖形上緣下方 10 點。文字路徑填色，而原始矩形僅保留輪廓。最後以 GeometryShape::setGeometryPaths 同時套用兩條路徑，產生包含矩形與文字的單一圖形。

use aspose\slides\GeometryPath;
use aspose\slides\PathFillModeType;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 100);
    
    $originalPath = $shape->getGeometryPaths()[0];
    $originalPath->setFillMode(PathFillModeType::None);

    $fontClass = java("java.awt.Font");
    $imageClass = java("java.awt.image.BufferedImage");
    $font = new Java("java.awt.Font", "Arial", $fontClass->PLAIN, 40);
    $image = new Java("java.awt.image.BufferedImage", 100, 100, $imageClass->TYPE_INT_ARGB);
    $graphics = $image->createGraphics();
    try {
        $fontContext = $graphics->getFontRenderContext();
        $glyphVector = $font->createGlyphVector($fontContext, "Text in shape");
        $textBounds = $glyphVector->getVisualBounds();
        $baseline = -java_values($textBounds->getY()) + 10;
        $graphicsPath = $glyphVector->getOutline(20.0, $baseline);
    } finally {
        $graphics->dispose();
    }

    $textPath = new GeometryPath();
    $pathIterator = $graphicsPath->getPathIterator(null);
    $iteratorClass = java("java.awt.geom.PathIterator");
    $arrayClass = java("java.lang.reflect.Array");
    $floatClass = java("java.lang.Float");
    $coordinates = $arrayClass->newInstance($floatClass->TYPE, 6);

    while (!java_values($pathIterator->isDone())) {
        $segmentType = java_values($pathIterator->currentSegment($coordinates));
        $points = java_values($coordinates);
        switch ($segmentType) {
            case java_values($iteratorClass->SEG_MOVETO):
                $textPath->moveTo($points[0], $points[1]);
                break;
            case java_values($iteratorClass->SEG_LINETO):
                $textPath->lineTo($points[0], $points[1]);
                break;
            case java_values($iteratorClass->SEG_QUADTO):
                $textPath->quadraticBezierTo($points[0], $points[1], $points[2], $points[3]);
                break;
            case java_values($iteratorClass->SEG_CUBICTO):
                $textPath->cubicBezierTo($points[0], $points[1], $points[2], $points[3], $points[4], $points[5]);
                break;
            case java_values($iteratorClass->SEG_CLOSE):
                $textPath->closeFigure();
                break;
        }
        $pathIterator->next();
    }
    $textPath->setFillMode(PathFillModeType::Normal);
    $shape->setGeometryPaths([$originalPath, $textPath]);
} finally {
    $presentation->dispose();
}

example5_image

常見問題

取代幾何後，填色與輪廓會發生什麼變化？

樣式仍保留在圖形上，只有輪廓會改變。填色與輪廓會自動套用到新幾何。

如何正確地在旋轉自訂圖形時，同步旋轉其幾何？

使用圖形的 setRotation 方法；因為幾何綁定於圖形自身的座標系，旋轉會一起套用。

我可以將自訂圖形轉換為影像，以「鎖定」結果嗎？

可以。將所需的 slide 區域或 shape 本身匯出為點陣圖格式，這樣可簡化後續對複雜幾何的處理。

使用 PHP 在簡報中管理連接線在 PHP 中向簡報新增橢圓形