Formatuj kształty PowerPoint w PHP

Wprowadzenie

W programie PowerPoint można dodawać kształty do slajdów. Ponieważ kształty składają się z linii, można je formatować, modyfikując lub stosując efekty do ich konturów. Dodatkowo można formatować kształty, określając ustawienia kontrolujące sposób wypełnienia ich wnętrz.

format-shape-powerpoint

Aspose.Slides for PHP via Java zapewnia klasy i metody, które umożliwiają formatowanie kształtów przy użyciu tych samych opcji dostępnych w programie PowerPoint.

Formatowanie linii

Korzystając z Aspose.Slides, możesz określić własny styl linii dla kształtu. Poniżej opisano poszczególne kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw line style kształtu.
  5. Ustaw szerokość linii.
  6. Ustaw dash style linii.
  7. Ustaw kolor linii dla kształtu.
  8. Zapisz zmodyfikowaną prezentację jako plik PPTX.

Poniższy kod PHP demonstruje, jak sformatować prostokąt AutoShape:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj auto‑kształt typu Rectangle.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 150, 150, 75);

    // Ustaw kolor wypełnienia dla prostokątnego kształtu.
    $shape->getFillFormat()->setFillType(FillType::NoFill);

    // Zastosuj formatowanie do linii prostokąta.
    $shape->getLineFormat()->setStyle(LineStyle::ThickThin);
    $shape->getLineFormat()->setWidth(7);
    $shape->getLineFormat()->setDashStyle(LineDashStyle::Dash);

    // Ustaw kolor linii prostokąta.
    $shape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);

    // Zapisz plik PPTX na dysku.
    $presentation->save("formatted_lines.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Sformatowane linie w prezentacji

Zastosowanie efektów szkicu do linii kształtu

Efekt szkicu sprawia, że linia kształtu wygląda na odręczną. Użyj Shape.getLineFormat do uzyskania dostępu do ustawień linii, LineFormat.getSketchFormat do uzyskania dostępu do ustawień szkicu oraz SketchFormat.setSketchType aby wybrać wartość z wyliczenia LineSketchType.

Poniższy kod PHP pokazuje, jak zastosować efekt LineSketchType.Curved, odczytać przypisaną wartość i usunąć efekt przy pomocy LineSketchType.None:

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 200, 100);

    // Dostęp do formatu linii kształtu i jego formatu szkicu.
    $sketchFormat = $shape->getLineFormat()->getSketchFormat();

    // Zastosuj efekt szkicu.
    $sketchFormat->setSketchType(LineSketchType::Curved);

    // Odczytaj efekt szkicu przypisany bezpośrednio do kształtu.
    $explicitSketchType = $sketchFormat->getSketchType();
    echo "Explicit sketch type: " . $explicitSketchType . PHP_EOL;

    // Usuń efekt szkicu.
    $sketchFormat->setSketchType(LineSketchType::None);
} finally {
    $presentation->dispose();
}

Wartość zwracana przez SketchFormat.getSketchType reprezentuje ustawienie przypisane bezpośrednio do kształtu. Jeśli formatowanie linii może być dziedziczone z motywu, slajdu nadrzędnego lub slajdu układu, użyj LineFormat.getEffective, uzyskaj metodę getSketchFormat zwróconego obiektu i odczytaj jego wartość getSketchType. Wartość efektywna odzwierciedla formatowanie faktycznie zastosowane po rozwiązaniu dziedziczenia:

$presentation = new Presentation("presentation.pptx");
try {
    $shape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    $lineFormat = $shape->getLineFormat();

    $explicitSketchType = $lineFormat->getSketchFormat()->getSketchType();
    $effectiveLineFormat = $lineFormat->getEffective();
    $effectiveSketchType = $effectiveLineFormat->getSketchFormat()->getSketchType();

    echo "Explicit sketch type: " . $explicitSketchType . PHP_EOL;
    echo "Effective sketch type: " . $effectiveSketchType . PHP_EOL;
} finally {
    $presentation->dispose();
}

Formatowanie stylów łączenia

Oto trzy dostępne opcje typu łączenia:

  • Round
  • Miter
  • Bevel

Domyślnie, gdy PowerPoint łączy dwie linie pod kątem (np. w narożniku kształtu), używa ustawienia Round. Jednak przy rysowaniu kształtu o ostrych kątach możesz preferować opcję Miter.

Styl łączenia w prezentacji

Poniższy kod PHP demonstruje, jak trzy prostokąty (jak na powyższym obrazie) zostały utworzone przy użyciu ustawień Miter, Bevel i Round:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj trzy auto‑kształty typu Rectangle.
    $shape1 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 150, 75);
    $shape2 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 210, 20, 150, 75);
    $shape3 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 135, 150, 75);

    // Ustaw kolor wypełnienia dla każdego prostokątnego kształtu.
    $shape1->getFillFormat()->setFillType(FillType::Solid);
    $shape1->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $shape2->getFillFormat()->setFillType(FillType::Solid);
    $shape2->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $shape3->getFillFormat()->setFillType(FillType::Solid);
    $shape3->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);

    // Ustaw szerokość linii.
    $shape1->getLineFormat()->setWidth(15);
    $shape2->getLineFormat()->setWidth(15);
    $shape3->getLineFormat()->setWidth(15);

    // Ustaw kolor linii każdego prostokąta.
    $shape1->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shape1->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
    $shape2->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shape2->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
    $shape3->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shape3->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);

    // Ustaw styl łączenia.
    $shape1->getLineFormat()->setJoinStyle(LineJoinStyle::Miter);
    $shape2->getLineFormat()->setJoinStyle(LineJoinStyle::Bevel);
    $shape3->getLineFormat()->setJoinStyle(LineJoinStyle::Round);

    // Dodaj tekst do każdego prostokąta.
    $shape1->getTextFrame()->setText("Miter Join Style");
    $shape2->getTextFrame()->setText("Bevel Join Style");
    $shape3->getTextFrame()->setText("Round Join Style");

    // Zapisz plik PPTX na dysku.
    $presentation->save("join_styles.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wypełnienie gradientowe

W programie PowerPoint wypełnienie gradientowe jest opcją formatowania, która pozwala na zastosowanie płynnego przejścia kolorów w kształcie. Na przykład możesz używać dwóch lub więcej kolorów, które stopniowo przechodzą jeden w drugi.

Oto, jak zastosować wypełnienie gradientowe do kształtu przy użyciu Aspose.Slides:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw właściwość FillType kształtu na Gradient.
  5. Dodaj dwie wybrane kolory z określonymi pozycjami, używając metod add kolekcji przystanków gradientu udostępnianej przez klasę GradientFormat.
  6. Zapisz zmodyfikowaną prezentację jako plik PPTX.

Poniższy kod PHP demonstruje, jak zastosować efekt wypełnienia gradientowego do elipsy:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj auto‑kształt typu Ellipse.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Ellipse, 50, 50, 150, 75);

    // Zastosuj formatowanie gradientowe do elipsy.
    $shape->getFillFormat()->setFillType(FillType::Gradient);
    $shape->getFillFormat()->getGradientFormat()->setGradientShape(GradientShape::Linear);

    // Ustaw kierunek gradientu.
    $shape->getFillFormat()->getGradientFormat()->setGradientDirection(GradientDirection::FromCorner2);

    // Dodaj dwa przystanki gradientu.
    $shape->getFillFormat()->getGradientFormat()->getGradientStops()->addPresetColor(1.0, PresetColor::Purple);
    $shape->getFillFormat()->getGradientFormat()->getGradientStops()->addPresetColor(0, PresetColor::Red);

    // Zapisz plik PPTX na dysku.
    $presentation->save("gradient_fill.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Elipsa z wypełnieniem gradientowym

Wypełnienie wzorem

W programie PowerPoint wypełnienie wzorem jest opcją formatowania, która umożliwia zastosowanie dwukolorowego wzoru — takiego jak kropki, paski, krzyżowa kratka lub szachownica — do kształtu. Możesz wybrać własne kolory tła i pierwszego planu wzoru.

Aspose.Slides udostępnia ponad 45 wstępnie zdefiniowanych stylów wzorów, które możesz zastosować do kształtów, aby zwiększyć walory wizualne prezentacji. Nawet po wybraniu wstępnego wzoru możesz określić dokładne kolory, które mają być użyte.

Oto, jak zastosować wypełnienie wzorem do kształtu przy użyciu Aspose.Slides:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw właściwość FillType kształtu na Pattern.
  5. Wybierz styl wzoru spośród dostępnych opcji.
  6. Ustaw Background Color wzoru.
  7. Ustaw Foreground Color wzoru.
  8. Zapisz zmodyfikowaną prezentację jako plik PPTX.

Poniższy kod PHP demonstruje, jak zastosować wypełnienie wzorem do prostokąta:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj auto‑kształt typu Rectangle.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 150, 75);

    // Ustaw typ wypełnienia na Pattern.
    $shape->getFillFormat()->setFillType(FillType::Pattern);

    // Ustaw styl wzoru.
    $shape->getFillFormat()->getPatternFormat()->setPatternStyle(PatternStyle::Trellis);

    // Ustaw tło i kolor pierwszego planu wzoru.
    $shape->getFillFormat()->getPatternFormat()->getBackColor()->setColor(java("java.awt.Color")->LIGHT_GRAY);
    $shape->getFillFormat()->getPatternFormat()->getForeColor()->setColor(java("java.awt.Color")->YELLOW);

    // Zapisz plik PPTX na dysku.
    $presentation->save("pattern_fill.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Prostokąt z wypełnieniem wzorem

Wypełnienie obrazem

W programie PowerPoint wypełnienie obrazem to opcja formatowania, która pozwala wstawić obraz wewnątrz kształtu — efektywnie używając obrazu jako tła kształtu.

Oto, jak używać Aspose.Slides do zastosowania wypełnienia obrazem w kształcie:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw właściwość FillType kształtu na Picture.
  5. Ustaw tryb wypełnienia obrazem na Tile (lub inny preferowany tryb).
  6. Utwórz obiekt PPImage z obrazu, którego chcesz użyć.
  7. Przekaż obraz do metody SlidesPicture.setImage.
  8. Zapisz zmodyfikowaną prezentację jako plik PPTX.

Załóżmy, że mamy plik „lotus.png” z następującym obrazem:

Obraz lotosu

Poniższy kod PHP demonstruje, jak wypełnić kształt obrazem:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj auto‑kształt typu Rectangle.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 255, 130);

    // Ustaw typ wypełnienia na Picture.
    $shape->getFillFormat()->setFillType(FillType::Picture);

    // Ustaw tryb wypełnienia obrazem.
    $shape->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode::Tile);

    // Załaduj obraz i dodaj go do zasobów prezentacji.
    $image = Images::fromFile("lotus.png");
    $picture = $presentation->getImages()->addImage($image);
    $image->dispose();

    // Ustaw obraz.
    $shape->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($picture);

    // Zapisz plik PPTX na dysku.
    $presentation->save("picture_fill.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Kształt z wypełnieniem obrazem

Kafelkowanie obrazu jako tekstura

Jeśli chcesz ustawić obraz jako teksturę w trybie kafelkowania i dostosować zachowanie kafelkowania, możesz użyć następujących metod klasy PictureFillFormat:

  • setPictureFillMode: Ustawia tryb wypełnienia obrazu — Tile lub Stretch.
  • setTileAlignment: Określa wyrównanie kafelków wewnątrz kształtu.
  • setTileFlip: Kontroluje, czy kafelek jest odbijany poziomo, pionowo lub w obu kierunkach.
  • setTileOffsetX: Ustawia poziomy offset kafelka (w punktach) względem początku kształtu.
  • setTileOffsetY: Ustawia pionowy offset kafelka (w punktach) względem początku kształtu.
  • setTileScaleX: Definiuje poziomą skalę kafelka jako procent.
  • setTileScaleY: Definiuje pionową skalę kafelka jako procent.

Poniższy przykład kodu pokazuje, jak dodać prostokąt z kafelkowanym wypełnieniem obrazem i skonfigurować opcje kafelkowania:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $firstSlide = $presentation->getSlides()->get_Item(0);

    // Dodaj prostokątny auto‑kształt.
    $shape = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 190, 95);

    // Ustaw typ wypełnienia kształtu na Picture.
    $shape->getFillFormat()->setFillType(FillType::Picture);

    // Załaduj obraz i dodaj go do zasobów prezentacji.
    $sourceImage = Images::fromFile("lotus.png");
    $presentationImage = $presentation->getImages()->addImage($sourceImage);
    $sourceImage->dispose();

    // Przypisz obraz do kształtu.
    $pictureFillFormat = $shape->getFillFormat()->getPictureFillFormat();
    $pictureFillFormat->getPicture()->setImage($presentationImage);

    // Skonfiguruj tryb wypełnienia obrazem i własności kafelkowania.
    $pictureFillFormat->setPictureFillMode(PictureFillMode::Tile);
    $pictureFillFormat->setTileOffsetX(-32);
    $pictureFillFormat->setTileOffsetY(-32);
    $pictureFillFormat->setTileScaleX(50);
    $pictureFillFormat->setTileScaleY(50);
    $pictureFillFormat->setTileAlignment(RectangleAlignment::BottomRight);
    $pictureFillFormat->setTileFlip(TileFlip::FlipBoth);

    // Zapisz plik PPTX na dysku.
    $presentation->save("tile.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Opcje kafelkowania

Wypełnienie jednolitym kolorem

W programie PowerPoint wypełnienie jednolitym kolorem to opcja formatowania, która wypełnia kształt jednym, jednolitym kolorem. Ten prosty kolor tła jest stosowany bez gradientów, tekstur ani wzorów.

Aby zastosować wypełnienie jednolitym kolorem do kształtu przy użyciu Aspose.Slides, wykonaj następujące kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw właściwość FillType kształtu na Solid.
  5. Przypisz preferowany kolor wypełnienia do kształtu.
  6. Zapisz zmodyfikowaną prezentację jako plik PPTX.

Poniższy kod PHP demonstruje, jak zastosować wypełnienie jednolitym kolorem do prostokąta w slajdzie PowerPoint:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj auto‑kształt typu Rectangle.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 150, 75);

    // Ustaw typ wypełnienia na Solid.
    $shape->getFillFormat()->setFillType(FillType::Solid);

    // Ustaw kolor wypełnienia.
    $shape->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->YELLOW);

    // Zapisz plik PPTX na dysku.
    $presentation->save("solid_color_fill.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Kształt z wypełnieniem jednolitym kolorem

Ustaw przezroczystość

W programie PowerPoint, gdy zastosujesz wypełnienie jednolitym kolorem, gradientowe, obrazem lub teksturą do kształtów, możesz także ustawić poziom przezroczystości, aby kontrolować krycie wypełnienia. Wyższa wartość przezroczystości sprawia, że kształt jest bardziej przezroczysty, umożliwiając częściowe widzenie tła lub obiektów pod nim.

Aspose.Slides pozwala ustawić poziom przezroczystości, dostosowując wartość alfa w kolorze używanym do wypełnienia. Oto jak to zrobić:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw właściwość FillType na Solid.
  5. Użyj klasy Color, aby zdefiniować kolor z przezroczystością (składnik alpha kontroluje przezroczystość).
  6. Zapisz prezentację.

Poniższy kod PHP demonstruje, jak zastosować przezroczysty kolor wypełnienia do prostokąta:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj prostokątny auto‑kształt wypełniony jednolitym kolorem.
    $solidShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 150, 75);

    // Dodaj przezroczysty prostokątny auto‑kształt nad jednolitym kształtem.
    $transparentShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 80, 80, 150, 75);
    $transparentShape->getFillFormat()->setFillType(FillType::Solid);
    $transparentShape->getFillFormat()->getSolidFillColor()->setColor(new java("java.awt.Color", 255, 255, 0, 204));

    // Zapisz plik PPTX na dysku.
    $presentation->save("shape_transparency.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Przezroczysty kształt

Obracanie kształtów

Aspose.Slides umożliwia obracanie kształtów w prezentacjach PowerPoint. Może to być przydatne przy pozycjonowaniu elementów wizualnych wymagających określonego wyrównania lub projektu.

Aby obrócić kształt na slajdzie, wykonaj następujące kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Ustaw właściwość rotacji kształtu na żądany kąt.
  5. Zapisz prezentację.

Poniższy kod PHP demonstruje, jak obrócić kształt o 5 stopni:

// Utwórz instancję klasy Presentation, która reprezentuje plik prezentacji.
$presentation = new Presentation();
try {
    // Pobierz pierwszy slajd.
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj auto‑kształt typu Rectangle.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 150, 75);

    // Obróć kształt o 5 stopni.
    $shape->setRotation(5);

    // Zapisz plik PPTX na dysku.
    $presentation->save("shape_rotation.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Obrót kształtu

Dodawanie efektów 3D Bevel

Aspose.Slides pozwala na zastosowanie efektów 3D bevel do kształtów poprzez konfigurację ich własności ThreeDFormat.

Aby dodać efekty 3D bevel do kształtu, wykonaj następujące kroki:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Skonfiguruj własność ThreeDFormat kształtu, aby zdefiniować ustawienia bevel.
  5. Zapisz prezentację.

Poniższy kod PHP pokazuje, jak zastosować efekty 3D bevel do kształtu:

// Utwórz instancję klasy Presentation.
$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    // Dodaj kształt do slajdu.
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Ellipse, 50, 50, 100, 100);
    $shape->getFillFormat()->setFillType(FillType::Solid);
    $shape->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GREEN);
    $shape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->ORANGE);
    $shape->getLineFormat()->setWidth(2.0);

    // Ustaw właściwości ThreeDFormat kształtu.
    $shape->getThreeDFormat()->setDepth(4);
    $shape->getThreeDFormat()->getBevelTop()->setBevelType(BevelPresetType::Circle);
    $shape->getThreeDFormat()->getBevelTop()->setHeight(6);
    $shape->getThreeDFormat()->getBevelTop()->setWidth(6);
    $shape->getThreeDFormat()->getCamera()->setCameraType(CameraPresetType::OrthographicFront);
    $shape->getThreeDFormat()->getLightRig()->setLightType(LightRigPresetType::ThreePt);
    $shape->getThreeDFormat()->getLightRig()->setDirection(LightingDirection::Top);

    // Zapisz prezentację jako plik PPTX.
    $presentation->save("3D_bevel_effect.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Efekt 3D bevel

Dodawanie efektów obrotu 3D

Aspose.Slides pozwala na zastosowanie efektów obrotu 3D do kształtów poprzez konfigurację ich własności ThreeDFormat.

Aby zastosować obrót 3D do kształtu:

  1. Utwórz instancję klasy Presentation.
  2. Uzyskaj odwołanie do slajdu za jego indeksem.
  3. Dodaj AutoShape do slajdu.
  4. Użyj metod setCameraType i setLightType, aby określić obrót 3D.
  5. Zapisz prezentację.

Poniższy kod PHP demonstruje, jak zastosować efekty obrotu 3D do kształtu:

// Utwórz instancję klasy Presentation.
$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 150, 75);
    $autoShape->getTextFrame()->setText("Hello, Aspose!");

    $autoShape->getThreeDFormat()->setDepth(6);
    $autoShape->getThreeDFormat()->getCamera()->setRotation(40, 35, 20);
    $autoShape->getThreeDFormat()->getCamera()->setCameraType(CameraPresetType::IsometricLeftUp);
    $autoShape->getThreeDFormat()->getLightRig()->setLightType(LightRigPresetType::Balanced);

    // Zapisz prezentację jako plik PPTX.
    $presentation->save("3D_rotation_effect.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Wynik:

Efekt obrotu 3D

Kontrola renderowania czarno-białego dla kształtów

Metoda Shape::setBlackWhiteMode określa, jak pojedynczy kształt jest renderowany, gdy prezentacja jest wyświetlana lub przetwarzana w trybie czarno-białym. Nie włącza ona samego wyświetlania w czerni i bieli i nie zmienia wypełnienia, linii ani innych formatowań w normalnym trybie kolorowym.

Użyj wartości z klasy BlackWhiteMode, aby wybrać pożądane zachowanie. Na przykład Automatic pozwala aplikacji renderującej wybrać konwersję, Gray i LightGray używają odcieni szarości, BlackWhite używa tylko czerni i bieli, Black i White wymuszają pojedynczy kolor, Color zachowuje normalne kolory, a Hidden pomija kształt w trybie czarno-białym. NotDefined oznacza, że nie przypisano trybu na poziomie kształtu.

Poniższy kod PHP tworzy kolorowy kształt i sprawia, że w trybie wyświetlania czarno-białego pojawia się on w odcieniach szarości:

use aspose\slides\BlackWhiteMode;
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;

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

    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 200, 100);
    $shape->getFillFormat()->setFillType(FillType::Solid);
    $orange = new Java("java.awt.Color", 255, 165, 0);
    $shape->getFillFormat()->getSolidFillColor()->setColor($orange);

    // Zachowaj pomarańczowe wypełnienie w trybie kolorowym, ale renderuj kształt w odcieniach szarości w trybie czarno-białym.
    $shape->setBlackWhiteMode(BlackWhiteMode::Gray);

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

W normalnym trybie kolorowym prostokąt zachowuje pomarańczowe wypełnienie. W przepływie pracy wyświetlania czarno-białego używa szarości, ponieważ jego tryb jest ustawiony na Gray. Dzięki temu możesz zachować slajd w pełnym kolorze, definiując jednocześnie odrębny wygląd dla drukowania, podglądu lub innych przepływów honorujących ustawienia czarno-białego wyświetlania prezentacji.

Resetowanie formatowania

Poniższy kod Java pokazuje, jak zresetować formatowanie slajdu i przywrócić pozycję, rozmiar oraz formatowanie wszystkich kształtów z symbolami w LayoutSlide do ustawień domyślnych:

$presentation = new Presentation("sample.pptx");
try {
    for ($i = 0; $i < java_values($presentation->getSlides()->size()); $i++) {
        $slide = $presentation->getSlides()->get_Item($i);
        // Zresetuj każdy kształt na slajdzie, który ma placeholder w układzie.
        $slide->reset();
    }
    $presentation->save("reset_formatting.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

FAQ

Czy formatowanie kształtów wpływa na ostateczny rozmiar pliku prezentacji?

Tylko minimalnie. Osadzone obrazy i multimedia zajmują większość miejsca, podczas gdy parametry kształtów, takie jak kolory, efekty i gradienty, są przechowywane jako metadane i praktycznie nie zwiększają rozmiaru.

Jak mogę wykryć kształty na slajdzie, które mają identyczne formatowanie, aby je pogrupować?

Porównaj kluczowe właściwości formatowania każdego kształtu — wypełnienie, linię i ustawienia efektów. Jeśli wszystkie odpowiadające sobie wartości są zgodne, traktuj ich style jako identyczne i logicznie grupuj te kształty, co upraszcza późniejsze zarządzanie stylami.

Czy mogę zapisać zestaw własnych stylów kształtów do osobnego pliku i ponownie używać ich w innych prezentacjach?

Tak. Przechowuj przykładowe kształty z pożądanymi stylami w szablonie slajdów lub pliku szablonu .POTX. Tworząc nową prezentację, otwórz szablon, sklonuj potrzebne stylowe kształty i zastosuj ich formatowanie w odpowiednich miejscach.

Typy kształtów w Aspose.Slides dla PHP via Java Zastosuj efekty kształtów w prezentacjach przy użyciu PHP