Hantera presentationsbläckobjekt i PHP

Introduktion

PowerPoint erbjuder en bläckfunktion som låter dig rita fria penseldrag. Bläck kan användas för att markera andra objekt, visa samband och processer samt rikta uppmärksamheten mot specifika element på en bild.

Aspose.Slides tillhandahåller de typer som behövs för att arbeta med bläckobjekt. Till exempel representerar klassen Ink ett bläckobjekt på en bild.

Skillnader mellan vanliga objekt och bläckobjekt

Objekt på en PowerPoint-bild representeras vanligtvis av Shape objekt. I sin enklaste form är en shape en behållare som definierar objektets område (dess ram) tillsammans med egenskaper som behållarens storlek, form och bakgrund. För mer information, se Shape Layout Format.

Men när PowerPoint hanterar ett bläckobjekt ignorerar det alla egenskaper för objektets ram (behållare) förutom dess storlek. Storleken på behållarområdet bestäms av de standard Shape.getWidth och Shape.getHeight metoderna:

ink_powerpoint1

Bläckspår

Ett bläckspår är ett grundelement som används för att registrera en pennas bana när en användare skriver digitalt bläck. Ett spår lagrar en sekvens av sammanhängande punkter.

Den enklaste formen av kodning specificerar X- och Y-koordinaterna för varje samplingspunkt. När alla sammankopplade punkter renderas får man en bild som denna:

ink_powerpoint2

Penselinställningar för ritning

En pensel används för att rita linjer som förbinder punkterna i ett bläckspår. Penseln har sin egen färg och storlek, representerade av metoderna InkBrush.getColor och InkBrush.getSize.

Ange bläckpenselns färg

Denna PHP‑kod visar hur man sätter färgen på en bläckpensel:

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

Ange bläckpenselns storlek

Denna PHP‑kod visar hur man sätter storleken på en bläckpensel:

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

Generellt sett matchar inte penselns bredd och höjd, så PowerPoint visar inte penselns storlek (den motsvarande datasektionen är gråmarkerad). När penselns bredd och höjd matchar visar PowerPoint dess storlek på följande sätt:

ink_powerpoint3

För tydlighetens skull ökar vi höjden på bläckobjektet och granskar de viktiga dimensionerna:

ink_powerpoint4

Behållaren (ramen) tar inte hänsyn till penselns storlek – den antar alltid att linjetjockleken är noll (se föregående bild).

Därför måste penselns storlek på dess spår beaktas för att bestämma det synliga området för hela bläckobjektet. Här har målobjektet (det handskrivna textspåret) skalats till storleken på behållaren (ramen). När behållarens storlek ändras förblir penselns storlek konstant, och vice versa.

ink_powerpoint5

PowerPoint använder liknande beteende för textobjekt:

ink_powerpoint6

Styr bläckens utseende vid export och rendering

Aspose.Slides tillhandahåller klassen InkOptions för att styra hur bläckobjekt visas i exporterad eller renderad output. Du kan använda dess egenskaper för att dölja bläck helt eller ändra hur maskoperationer för bläckpenslar tolkas.

Bläckalternativ är tillgängliga via export- eller renderingsalternativen för flera output‑typer:

Utdata Ink‑alternativ egenskap
PDF PdfOptions.getInkOptions
HTML HtmlOptions.getInkOptions
SVG SVGOptions.getInkOptions
TIFF TiffOptions.getInkOptions
Slide image RenderingOptions.getInkOptions

Följande InkOptions metoder exponerar samma två inställningar:

Dölj bläckobjekt i PDF‑output

Som standard förblir bläckobjekt synliga vid export. För att skapa en ren output utan handskrivna kommentarer eller annat bläckinnehåll, anropa InkOptions.setHideInk med true.

Följande PHP‑exempel exporterar en presentation till PDF samtidigt som alla bläckobjekt döljs:

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

Dölj bläckobjekt när en bildruta renderas som bild

För att dölja bläckobjekt när bildspel renderas som bitmap‑bilder, konfigurera RenderingOptions.getInkOptions och skicka renderingsalternativen till Slide.getImage.

Följande PHP‑exempel renderar den första bilden som en PNG‑bild utan bläckobjekt:

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

Styr rendering av bläckmask

InkOptions.getInterpretMaskOpAsOpacity‑inställningen styr hur maskoperationer tolkas när bläckpenslar renderas. Standardvärdet är true, vilket använder opacitet. För att använda ROP‑operationen istället, anropa InkOptions.setInterpretMaskOpAsOpacity med false.

Följande PHP‑exempel exporterar en bild till SVG och använder ROP‑baserad rendering för bläckmask‑operationer:

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

Samma inställning kan tillämpas via TiffOptions.getInkOptions när en presentation exporteras eller en bild renderas till TIFF.

Välj om du vill dölja eller bevara bläck

När du behöver en ren version av en annoterad presentation för distribution utan granskningsmarkeringar, anropa InkOptions.setHideInk med true vid export.

Lämna InkOptions.getHideInk på standardvärdet false när bläckanteckningar är en del av det avsedda innehållet, såsom granskningskommentarer, handskrivna noteringar, markeringar eller teckningar som ska förbli synliga i den exporterade resultatet. Detta möjliggör att applikationer kan generera separata gransknings‑ och slutresultat från samma presentation utan att ändra bläckobjekten i källfilen.

Vanliga frågor

Kan jag ändra färg eller storlek på ett befintligt bläckstreck?

Ja. Hämta spåret från Ink.getTraces och ändra sedan dess InkTrace.getBrush. Anropa InkBrush.setColor eller InkBrush.setSize för att ändra penseln.

Är det så att dölja bläck ändrar källpresentationen?

Nej. Att anropa InkOptions.setHideInk påverkar endast det renderade eller exporterade resultatet; det tar inte bort eller modifierar bläckobjekt i källpresentationen.

Vilka exportformat stödjer bläckalternativ?

Du kan konfigurera bläckalternativ för PDF, HTML, SVG, TIFF och bitmap‑bilder av bildspel via motsvarande export‑ eller renderingsalternativ som visas ovan.

Vidare läsning

Hantera PowerPoint-figurer i PHP Skapa och anpassa PowerPoint SmartArt i PHP