Zarządzanie obiektami atramentu w prezentacji w PHP

Wprowadzenie

PowerPoint udostępnia funkcję atramentu, która umożliwia rysowanie dowolnych pociągnięć. Atrament można używać do podświetlania innych obiektów, pokazywania połączeń i procesów oraz przyciągania uwagi do konkretnych elementów na slajdzie.

Aspose.Slides dostarcza typy potrzebne do pracy z obiektami atramentu. Na przykład klasa Ink reprezentuje obiekt atramentu na slajdzie.

Różnice między zwykłymi obiektami a obiektami atramentu

Obiekty na slajdzie PowerPointa są zazwyczaj reprezentowane przez obiekty Shape. W najprostszej formie kształt jest kontenerem definiującym obszar samego obiektu (jego ramkę) wraz z właściwościami takimi jak rozmiar kontenera, kształt i tło. Po więcej informacji zobacz Shape Layout Format.

Jednakże, gdy PowerPoint obsługuje obiekt atramentu, ignoruje wszystkie właściwości ramki obiektu (kontenera) poza jego rozmiarem. Rozmiar obszaru kontenera jest określany przez standardowe metody Shape.getWidth i Shape.getHeight:

ink_powerpoint1

Ślady atramentu

Ślad atramentu jest podstawowym elementem służącym do rejestrowania trajektorii pióra, gdy użytkownik pisze cyfrowym atramentem. Ślad przechowuje sekwencję połączonych punktów.

Najprostsza forma kodowania określa współrzędne X i Y każdego punktu próbki. Gdy wszystkie połączone punkty zostaną wyrenderowane, powstaje obraz podobny do tego:

ink_powerpoint2

Właściwości pędzla do rysowania

Pędzel jest używany do rysowania linii łączących punkty śladu atramentu. Pędzel ma własny kolor i rozmiar, reprezentowane przez metody InkBrush.getColor oraz InkBrush.getSize.

Ustaw kolor pędzla atramentu

Ten kod PHP pokazuje, jak ustawić kolor pędzla atramentu:

$presentation = new Presentation("pres.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $ink = $slide->getShapes()->get_Item(0);
    $brush = $ink->getTraces()[0]->getBrush();
    $brush->setColor(java("java.awt.Color")->RED);
} finally {
    $presentation->dispose();
}

Ustaw rozmiar pędzla atramentu

Ten kod PHP pokazuje, jak ustawić rozmiar pędzla atramentu:

$presentation = new Presentation("pres.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $ink = $slide->getShapes()->get_Item(0);
    $brush = $ink->getTraces()[0]->getBrush();
    $brushSize = new Java("java.awt.Dimension", 5, 10);
    $brush->setSize($brushSize);
} finally {
    $presentation->dispose();
}

Zazwyczaj szerokość i wysokość pędzla nie są takie same, więc PowerPoint nie wyświetla rozmiaru pędzla (odpowiednia sekcja danych jest wyszarzona). Gdy szerokość i wysokość pędzla są równe, PowerPoint wyświetla jego rozmiar w następujący sposób:

ink_powerpoint3

Dla przejrzystości zwiększmy wysokość obiektu atramentu i przeanalizujmy istotne wymiary:

ink_powerpoint4

Kontener (ramka) nie uwzględnia rozmiaru pędzli — zawsze zakłada, że grubość linii wynosi zero (zobacz poprzedni obraz).

Dlatego, aby określić widoczny obszar całego obiektu atramentu, należy uwzględnić rozmiar pędzla jego śladów. Tutaj docelowy obiekt (ślad ręcznie pisanego tekstu) został skalowany do rozmiaru kontenera (ramki). Gdy rozmiar kontenera się zmienia, rozmiar pędzla pozostaje stały i odwrotnie.

ink_powerpoint5

PowerPoint stosuje podobne zachowanie dla obiektów tekstowych:

ink_powerpoint6

Kontrolowanie wyglądu atramentu podczas eksportu i renderowania

Aspose.Slides udostępnia klasę InkOptions, która pozwala kontrolować, jak obiekty atramentu pojawiają się w wyjściu eksportowanym lub renderowanym. Można używać jej właściwości, aby całkowicie ukryć atrament lub zmienić sposób interpretacji operacji maski pędzla atramentu.

Ink options są dostępne poprzez opcje eksportu lub renderowania dla kilku typów wyjścia:

Wyjście Właściwość opcji atramentu
PDF PdfOptions.getInkOptions
HTML HtmlOptions.getInkOptions
SVG SVGOptions.getInkOptions
TIFF TiffOptions.getInkOptions
Slide image RenderingOptions.getInkOptions

Poniższe metody klasy InkOptions udostępniają te same dwa ustawienia:

Ukryj obiekty atramentu w wyjściu PDF

Domyślnie obiekty atramentu pozostają widoczne podczas eksportu. Aby uzyskać czyste wyjście bez odręcznych adnotacji lub innej treści atramentu, wywołaj InkOptions.setHideInk z true.

Ten przykład PHP eksportuje prezentację do PDF, ukrywając wszystkie obiekty atramentu:

$presentation = new Presentation("presentation.pptx");
try {
    $pdfOptions = new PdfOptions();
    $pdfOptions->getInkOptions()->setHideInk(true);

    $presentation->save("presentation_without_ink.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

Ukryj obiekty atramentu podczas renderowania slajdu jako obrazu

Aby ukryć obiekty atramentu podczas renderowania slajdów jako obrazy bitmapowe, skonfiguruj RenderingOptions.getInkOptions i przekaż opcje renderowania do Slide.getImage.

Ten przykład PHP renderuje pierwszy slajd jako obraz PNG bez obiektów atramentu:

$presentation = new Presentation("presentation.pptx");
try {
    $renderingOptions = new RenderingOptions();
    $renderingOptions->getInkOptions()->setHideInk(true);

    $slide = $presentation->getSlides()->get_Item(0);
    $image = $slide->getImage($renderingOptions);
    try {
        $image->save("slide_without_ink.png", ImageFormat::Png);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}

Kontroluj renderowanie maski atramentu

Ustawienie InkOptions.getInterpretMaskOpAsOpacity kontroluje, jak operacje maski są interpretowane podczas renderowania pędzli atramentu. Domyślna wartość to true, co oznacza użycie przezroczystości. Aby zamiast tego użyć operacji ROP, wywołaj InkOptions.setInterpretMaskOpAsOpacity z false.

Ten przykład PHP eksportuje slajd do SVG i używa renderowania opartego na ROP dla operacji maski atramentu:

$presentation = new Presentation("presentation.pptx");
try {
    $svgOptions = new SVGOptions();
    $svgOptions->getInkOptions()->setInterpretMaskOpAsOpacity(false);

    $outputStream = new Java("java.io.FileOutputStream", "slide.svg");
    try {
        $slide = $presentation->getSlides()->get_Item(0);
        $slide->writeAsSvg($outputStream, $svgOptions);
    } finally {
        $outputStream->close();
    }
} finally {
    $presentation->dispose();
}

To samo ustawienie można zastosować za pomocą TiffOptions.getInkOptions przy eksporcie prezentacji lub renderowaniu slajdu do TIFF.

Wybierz, czy ukrywać czy zachować atrament

Gdy potrzebujesz czystej wersji oznaczonej prezentacji do dystrybucji bez znaczników recenzji, wywołaj InkOptions.setHideInk z true podczas eksportu.

Pozostaw InkOptions.getHideInk przy domyślnej wartości false, gdy adnotacje atramentowe są częścią zamierzonej treści, np. komentarze recenzji, odręczne notatki, podświetlenia lub rysunki, które powinny pozostać widoczne w wyeksportowanym wyniku. Umożliwia to aplikacjom generowanie osobnych wyjść recenzji i finalnych z tej samej prezentacji bez modyfikacji źródłowych obiektów atramentu.

FAQ

Czy mogę zmienić kolor lub rozmiar istniejącego pociągnięcia atramentu?

Tak. Pobierz ślad za pomocą Ink.getTraces, a następnie zmień jego InkTrace.getBrush. Wywołaj InkBrush.setColor lub InkBrush.setSize, aby zmienić pędzel.

Czy ukrywanie atramentu zmienia prezentację źródłową?

Nie. Wywołanie InkOptions.setHideInk wpływa tylko na wyrenderowany lub wyeksportowany wynik; nie usuwa ani nie modyfikuje obiektów atramentu w prezentacji źródłowej.

Które formaty eksportu obsługują opcje atramentu?

Możesz konfigurować opcje atramentu dla PDF, HTML, SVG, TIFF oraz obrazów slajdów w formacie bitmapowym za pomocą odpowiednich opcji eksportu lub renderowania przedstawionych powyżej.

Dalsza lektura

Zarządzaj kształtami PowerPoint w PHP Tworzenie i dostosowywanie SmartArt w PowerPoint w PHP