PHP'de Sunum Şekillerini Özelleştir

Bu sayfa ne hakkında

Java aracılığıyla PHP için Aspose.Slides kullanarak PowerPoint sunumlarında şekiller oluşturun ve özelleştirin: geometri yolları, kıvrımlı köşeler, birleşik şekiller.

Genel Bakış

Bu makale, Aspose.Slides’ta sunum şekillerini düzenleme noktaları ve geometri yolları aracılığıyla şekil geometrisini düzenleyerek özelleştirmeyi açıklar. Mevcut şekilleri değiştirmek, temel yol düzenleme işlemleri gerçekleştirmek, nokta eklemek veya kaldırmak ve güncellenmiş geometrinin bir şekle uygulanmasını göstermek için GeometryPath ile nasıl çalışılacağını gösterir.

Ayrıca, özel ve bileşik şekiller oluşturmayı, köşeleri kıvrımlı olan şekiller inşa etmeyi, bir şekil geometrisinin kapalı olup olmadığını belirlemeyi, şekil öğelerini incelemeyi ve Java AWT metin konturlarını geometri yollarına dönüştürmeyi gösterir.

Bir Şekli Düzenleme Noktalarıyla Değiştirme

PowerPoint’te Edit Points özelliğini kullanarak bir kareyi değiştirebilirsiniz:

Bir köşeyi içe ya da dışa taşıyın.
Bir noktada eğriliği ayarlayın.
Yeni noktalar ekleyin.

Nokta düzenleme, bir şeklin dış hatlarını değiştirmenize veya mevcut bir şekli yeni bir şeklin temeli olarak kullanmanıza olanak tanır.

Şekil Düzenleme İpuçları

overview_image

PowerPoint şekillerini düzenlerken şu kavramları aklınızda bulundurun:

Bir şekil (veya yolu) kapalı ya da açık olabilir.
Bir şeklin yolu, segmentlerle bağlanan çapa noktalarından oluşur.
Bir segment düz veya eğri olabilir. Çapa noktaları ve kontrol kolları şeklinin biçimini belirler.
Çapa noktaları köşe noktaları, düz noktalar veya pürüzsüz noktalar olarak bulunur:
- Bir köşe noktasında, bitişik segmentler bir açıyla buluşabilir.
- Bir pürüzsüz noktada, iki kontrol kolu hizalanmış ve çapa noktasına eşit uzaklıktadır.
- Bir düz noktada, iki kontrol kolu hizalanmıştır ancak çapa noktasına farklı mesafelerde olabilir.
Çapa noktalarını taşıyarak veya kollarını ayarlayarak şeklin dış hattı değişir.

PowerPoint şekillerini düzenleme noktalarıyla düzenlemek için Aspose.Slides, GeometryPath sınıfını sunar.

Bir GeometryPath örneği, GeometryShape nesnesinin bir geometri yolunu temsil eder.
GeometryShape örneğinden GeometryPath elde etmek için GeometryShape::getGeometryPaths yöntemini kullanabilirsiniz.
Bir şekil için GeometryPath ayarlamak üzere bu yöntemleri kullanabilirsiniz: tek yollu şekiller için GeometryShape::setGeometryPath ve birden çok yol içeren şekiller için GeometryShape::setGeometryPaths.
Segment eklemek için GeometryPath altındaki yöntemleri kullanabilirsiniz.
GeometryPath::setStroke ve GeometryPath::setFillMode yöntemlerini kullanarak bir geometri yolunun görünümünü ayarlayabilirsiniz.
GeometryPath::getPathData yöntemini kullanarak bir GeometryShape geometrisinin yol verisini yol segmentleri dizisi olarak alabilirsiniz.
Ek şekil geometri özelleştirme seçeneklerine erişmek için bir java.awt.Shape nesnesini PathIterator aracılığıyla okuyabilir ve segmentleri bir GeometryPath üzerine yeniden oynatabilirsiniz.

Basit Düzenleme İşlemleri

Bir geometri yolunu düzenlemek için aşağıdaki yöntemleri kullanın. Bir dizin kabul eden aşırı yüklemeler, segmenti yolun segment dizisinde sıfır tabanlı konuma ekler.

İşlem	Yöntem
Düz bir çizgi ekleyin veya ekleyin.	GeometryPath::lineTo
İki kontrol noktası ve bir bitiş noktası ile kübik Bézier eğrisi ekleyin veya yerleştirin.	GeometryPath::cubicBezierTo
Bir kontrol noktası ve bir bitiş noktası ile ikinci dereceden Bézier eğrisi ekleyin veya yerleştirin.	GeometryPath::quadraticBezierTo
Belirtilen boyut ve derece cinsinden açıyla eliptik bir yay ekleyin.	GeometryPath::arcTo
Bitiş noktasını başlangıç noktasına bağlayarak geçerli şekli kapatın.	GeometryPath::closeFigure
Bir şeklin başlangıç noktasını ayarlayın.	GeometryPath::moveTo
Sıfır tabanlı bir dizindeki segmenti kaldırın.	GeometryPath::removeAt

Bir Şekle Özel Noktalar Ekleme

Bu örnek, bir dikdörtgen şekline iki nokta eklemek için GeometryPath::lineTo kullanır ve düzenlenmiş yolu GeometryShape::setGeometryPath ile uygular. Koordinatlar şekle göre lokalidir: her iki yeni nokta da merkezinde, soldan 100 puan ve üstten 50 puan uzaktadır. Segment indeksleri 1 ve 4, bu noktaları üst ve alt kenarlara yerleştirerek bu kenarları içe doğru çeker.

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

Şekilden Noktaları Kaldırma

Bu örnek, bir kalp şeklinin dış hatlarını GeometryPath::removeAt ile sıfır tabanlı indeks 2’deki segmenti kaldırarak değiştirir. Değiştirilmiş yolu GeometryShape::setGeometryPath ile uygulamak şeklin konturunu günceller.

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

Özel Bir Şekil Oluşturma

Bu örnek, GeometryPath kullanarak beş köşeli bir yıldız inşa eder. 100 ve 50 puanlık dış ve iç yarıçapların dönüşümlü olarak kullanılması uçları ve girintileri tanımlar; 72 derecelik adım beş ucu eşit aralıklarla dağıtır. Yol, GeometryPath::closeFigure ile kapatılır ve GeometryShape::setGeometryPath kullanılarak dikdörtgen bir şekle uygulanır; böylece mevcut dış hat yer değiştirir.

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

Bileşik Özel Şekil Oluşturma

Bu örnek, bir şeklin üst ve alt üçte birini temsil eden iki kapalı GeometryPath tanımlar. Her iki yolu da GeometryShape::setGeometryPaths ile uygulamak, ortasında bir boşluk bırakan tek bir bileşik şekil oluşturur.

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

Kıvrımlı Köşeli Özel Şekil Oluşturma

Bu örnek, düz segmentleri GeometryPath::arcTo ile birleştirerek içe kıvrılan köşelere sahip bir şekil oluşturur. Her köşe boyutu, yayı puan cinsinden genişlik ve yükseklik olarak ayarlar ve -90 derecelik süpürme saat yönünün tersine bir çeyrek elips çizer. Tamamlanan yol, GeometryShape::setGeometryPath ile uygulanır ve sunum PPTX formatında kaydedilir.

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();
}

Bir Şekil Geometrisinin Kapalı Olup Olmadığını Öğrenin

Aşağıdaki yardımcı, her dolu olmayan geometri yolunun kapanış segmentiyle bitip bitmediğini kontrol eder. GeometryPath::getPathData okur ve son segmentin PathSegment::getPathCommand değerini PathCommandType::Close ile karşılaştırır. Boş olmayan yol olmadığında false döner. Bu, her yolun son komutunu kontrol eder; bir yol içindeki her alt şekli incelemez. Örnek bir dikdörtgen için true yazar.

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();
}

Şekil Öğelerini Çıkarma ve İnceleme

Mevcut bir şekli, yol noktaları ve nokta türlerini içeren öğeler olarak incelemek için GeometryShape::createShapeElements kullanın. Dönen her ShapeElement üzerinden getPathPoints ve getPathTypes metodlarıyla nokta ve tip dizileri alınır. Bu temsil, kontur analizi veya geometriyi özel çizim araçlarına aktarmak için kullanışlıdır.

Örnek, input.pptx dosyasını açar, ilk slaytta doğrudan ilk geometri şeklini bulur ve yol segmentlerini yazdırır. Hem düz hem de eğri segmentler içeren bir şekil içeren bir sunum kullanın; çıktı iki türde de gösterilir. Gruplar içinde arama yapılmaz.

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; // Bayrakları hariç tutarak segment tipini koru.
                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; // Consume both control points and the endpoint.
                        break;
                }
                if (($types[$i] & 0x80) !== 0) {
                    echo "Close subpath back to its starting point." . PHP_EOL;
                }
            }
        }
    }
} finally {
    $presentation->dispose();
}

Diziler indeksle eşleşir: $points[$i] bir noktadır ve $types[$i] onun rolünü tanımlar. Tip 0 bir şekli başlatır, tip 1 önceki noktadan şu anki noktaya bir çizgi çizer. Kübik Bézier segmenti önceki bitiş noktasından başlar ve üç ardışık tip-3 girdisi kullanır: iki kontrol noktası ardından yeni bitiş noktası. Döngü bu üç girdiği birlikte tüketir ve kapanış için bitiş noktasını denetler.

Nokta tipleri ayrıca bayraklar içerir. Segment tipini belirlemek için 0x07 ile maskeleyin ve kapalı bir alt yol tespiti için 0x80 i ayrı‑ ayrı test edin. Örneğin 129 (0x81) bir satır bitiş noktası olup bir alt yolu kapatır, 131 (0x83) ise bir Bézier bitiş noktası olup bir alt yolu kapatır. PHP/Java Bridge byte dizisini ikili bir dize olarak döndürür; “C*” ile ayrıştırmak işaretsiz byte değerleri üretir. Maskeleme, amaçlanan bit değerlerini korur. Sadece 1 veya 3 ile karşılaştırmak bu durumları atlayacaktır. Çizgi (0x10) ve işaretçi (0x20) gibi diğer bayraklar temel segment tipini değiştirmez.

Koordinatlar ve dönüşümler. Noktalar puan (1/72 inç) biriminde ölçülür; X sağa, Y aşağı doğru artar. Gruplamış bir şekil için, çıkarılan koordinatlar zaten getX ve getY tarafından döndürülen konumu içerir ve mevcut genişlik ve yüksekliği yansıtır. Örneğin, (100, 200) konumunda, 120 × 80 boyutunda bir döndürülmemiş dikdörtgenin kontur sınırları (100, 200)–(220, 280) şeklindedir. Şeklin konumunu tekrar eklemeyin. X ve Y değerlerini çıkararak, dönüşülmemiş çerçeveye göre koordinatları elde edin.

Çıkarılan noktalar, getRotation tarafından döndürülen şeklin rotasyonunu veya yatay‑dikey çevirileri uygulamaz. Görüntülenen konturu yeniden üretmek için bu dönüşümleri şeklin merkezinde uygulayın. Gruplar içinde ise grup koordinat haritalamasını ve dönüşümleri de hesaba katın; çıkarılan noktaların sunumun nihai slayt koordinatları olduğunu varsaymayın ve çeviri ya da ölçekleme iki kez uygulanmasın.

İnceleme vs. düzenleme. Çıkarılan diziler konturu tanımlar; bunları değiştirmek orijinal şekli güncellemez. Analiz ya da çizim kodunuz nokta/tip dizilerine ihtiyaç duyduğunda bu yöntemi seçin. Şeklin yerel koordinat sistemindeki geometri komutlarına ihtiyaç duyuyorsanız ya da geometrisini düzenlemek istiyorsanız getGeometryPaths kullanın. Düzenlenmiş yolları setGeometryPath veya setGeometryPaths ile uygulayın.

Java AWT Şekilini GeometryPath’e Dönüştürme

Bu örnek, bir dikdörtgen konturunu metne dönüştürülmüş geometrisiyle birleştirir. Konturun setFillMode yöntemi doldurulmasını devre dışı bırakır. Bir GlyphVector, bir java.awt.Shape içinde metin konturunu oluşturur. Bunun PathIterator hareket, çizgi, ikinci dereceden, kübik ve kapanış segmentlerini sağlar; örnek bunları bir GeometryPath üzerinde yeniden oynatır.

Örnek, PHP/Java Bridge’in iteratör tarafından yazılan koordinatları koruması için bir Java float dizisi kullanır. Metin 40 puanlık Arial yazı tipinde. Kontur yatayda 20 puan kaydırılır ve görsel üstü şeklin üst kenarının 10 puan altında konumlandırılır. Metin yolu doldurulurken, orijinal dikdörtgen bir kontur olarak kalır. Her iki yolu da GeometryShape::setGeometryPaths ile uygulamak, dikdörtgen ve metni içeren tek bir şekil üretir.

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

SSS

Geometri değiştirildikten sonra dolgu ve kontur ne olur?

Stil şekil ile birlikte kalır; yalnızca kontur değişir. Dolgu ve kontur yeni geometriye otomatik olarak uygulanır.

Özel bir şekli geometrisiyle birlikte doğru şekilde nasıl döndürürüm?

Şeklin setRotation yöntemini kullanın; geometri, şeklin kendi koordinat sistemine bağlı olduğu için şekille birlikte döner.

Sonucu “kilitlemek” için özel bir şekli görüntüye dönüştürebilir miyim?

Evet. Gerekli slide alanını ya da shape kendisini raster bir formata dışa aktarın; bu, karmaşık geometrilerle sonraki çalışmayı basitleştirir.

PHP Kullanarak Sunumlarda Bağlayıcıları Yönet PHP'de Sunumlara Elips Ekleyin