Verbessern Sie die Bildverarbeitung mit dem Modernen API

Einleitung

Historisch hat Aspose Slides eine Abhängigkeit von java.awt und verfügt in der öffentlichen API über die folgenden Klassen daraus:

Ab Version 24.4 wird diese öffentliche API als veraltet deklariert.

Um die Abhängigkeiten von diesen Klassen zu entfernen, haben wir das sogenannte „Modernes API“ hinzugefügt – also das API, das anstelle des veralteten verwendet werden sollte und dessen Signaturen keine Abhängigkeiten von BufferedImage mehr enthalten. Graphics2D ist als veraltet markiert und seine Unterstützung wurde aus der öffentlichen Slides‑API entfernt.

Die Entfernung der veralteten öffentlichen API mit Abhängigkeiten zu System.Drawing erfolgt in Release 24.8.

Modernes API

Folgende Klassen und Aufzählungen wurden zur öffentlichen API hinzugefügt:

IImage – stellt das Raster‑ oder Vektor‑Bild dar.
ImageFormat – stellt das Dateiformat des Bildes dar.
Images – Methoden zum Instanziieren und Arbeiten mit der IImage‑Klasse.

Beachten Sie, dass IImage disposable ist (es sollte nach der Verwendung freigegeben werden).

Ein typisches Szenario für die Verwendung des neuen API könnte wie folgt aussehen:

use aspose\slides\Presentation;
use aspose\slides\ShapeType;
use aspose\slides\ImageFormat;
use aspose\slides\Images;


$pres = new Presentation();

# Instanziieren einer disposable IImage‑Instanz von der Datei auf dem Datenträger.
$image = Images::fromFile("image.png");

# Erstellen eines PowerPoint‑Bildes, indem eine IImage‑Instanz zu den Bildern der Präsentation hinzugefügt wird.
$ppImage = $pres->getImages()->addImage($image);
$image->dispose();

# Bild‑Shape auf Folie #1 hinzufügen
$pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 10, 10, 100, 100, $ppImage);

$dimension = new Java("java.awt.Dimension", 1920, 1080);
# Erhalte eine IImage‑Instanz, die Folie #1 darstellt.
$slideImage = $pres->getSlides()->get_Item(0)->getImage($dimension);

# Bild auf dem Datenträger speichern.
$slideImage->save("slide1.jpeg", ImageFormat::Jpeg);
$slideImage->dispose();

$pres->dispose();

Ersetzen von altem Code durch das Moderne API

Im Allgemeinen müssen Sie den Aufruf der alten Methode, die ImageIO verwendet, durch die neue ersetzen.

Old:

$dimension = new Java("java.awt.Dimension", 1920, 1080);
$slideImage = $pres->getSlides()->get_Item(0)->getThumbnail($dimension);
$imageio = new Java("javax.imageio.ImageIO");
$javafile = new Java("java.io.File", "image.png");
$imageio->write($slideImage, "PNG", $javafile);

New:

$dimension = new Java("java.awt.Dimension", 1920, 1080);
$slideImage = $pres->getSlides()->get_Item(0)->getImage($dimension);
$slideImage->save("image.png", ImageFormat::Png);
$slideImage->dispose();

Abrufen eines Folien‑Thumbnails

Code, der ein veraltetes API verwendet:

use aspose\slides\Presentation;


$pres = new Presentation("pres.pptx");

$slideImage = $pres->getSlides()->get_Item(0)->getThumbnail();

$imageio = new Java("javax.imageio.ImageIO");
$javafile = new Java("java.io.File", "slide1.png");
$imageio->write($slideImage, "PNG", $javafile);

$pres->dispose();

Modernes API:

use aspose\slides\Presentation;
use aspose\slides\ImageFormat;


$pres = new Presentation("pres.pptx");

$slideImage = $pres->getSlides()->get_Item(0)->getImage();
$slideImage->save("slide1.png", ImageFormat::Png);
$slideImage->dispose();

$pres->dispose();

Abrufen eines Shape‑Thumbnails

Code, der ein veraltetes API verwendet:

use aspose\slides\Presentation;


$pres = new Presentation("pres.pptx");

$shapeImage = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getThumbnail();

$imageio = new Java("javax.imageio.ImageIO");
$javafile = new Java("java.io.File", "shape.png");
$imageio->write($shapeImage, "PNG", $javafile);

$pres->dispose();

Modernes API:

use aspose\slides\Presentation;
use aspose\slides\ImageFormat;


$pres = new Presentation("pres.pptx");

$shapeImage = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getImage();
$shapeImage->save("shape.png");
$shapeImage->dispose();

$pres->dispose();

Abrufen eines Präsentations‑Thumbnails

Code, der ein veraltetes API verwendet:

use aspose\slides\Presentation;
use aspose\slides\RenderingOptions;


$pres = new Presentation("pres.pptx");

$renderingOptions = new RenderingOptions();
$dimension = new Java("java.awt.Dimension", 1920, 1080);

$bitmaps = $pres->getThumbnails($renderingOptions, $dimension);
for ($i = 0; $i < count(java_values($bitmaps)); $i++)
{
    $thumbnail = $bitmaps[$i];
    $imageio = new Java("javax.imageio.ImageIO");
    $javafile = new Java("java.io.File", "slide" . $i . ".png");
    $imageio->write($thumbnail, "PNG", $javafile);
}

$pres->dispose();

Modernes API:

use aspose\slides\Presentation;
use aspose\slides\ImageFormat;
use aspose\slides\RenderingOptions;


$pres = new Presentation("pres.pptx");

$renderingOptions = new RenderingOptions();
$dimension = new Java("java.awt.Dimension", 1920, 1080);

$images = $pres->getImages($renderingOptions, $dimension);
for ($i = 0; $i < count(java_values($images)); $i++)
{
    $thumbnail = $images[$i];
    $thumbnail->save("slide" . $i . ".png", ImageFormat::Png);
}

$pres->dispose();

Hinzufügen eines Bildes zu einer Präsentation

Code, der ein veraltetes API verwendet:

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


$pres = new Presentation();

$imageio = new Java("javax.imageio.ImageIO");
$javafile = new Java("java.io.File", "image.png");

$bufferedImages = $imageio->read($javafile);
$ppImage = $pres->getImages()->addImage($bufferedImages);

$pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 10, 10, 100, 100, $ppImage);

$pres->dispose();

Modernes API:

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


$pres = new Presentation();

$image = Images::fromFile("image.png");
$ppImage = $pres->getImages()->addImage($image);
$image->dispose();

$pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 10, 10, 100, 100, $ppImage);

$pres->dispose();

Methoden, die entfernt werden, und deren Ersatz im Modernen API

Presentation

Methodensignatur	Ersatz‑Methodensignatur
public final BufferedImage[] getThumbnails(IRenderingOptions options)	public final IImage[] getImages(IRenderingOptions options)
public final BufferedImage[] getThumbnails(IRenderingOptions options, float scaleX, float scaleY)	public final IImage[] getImages(IRenderingOptions options, float scaleX, float scaleY)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides)	public final IImage[] getImages(IRenderingOptions options, int[] slides)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY)	public final IImage[] getImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides, Dimension imageSize)	public final IImage[] getImages(IRenderingOptions options, int[] slides, Dimension imageSize)
public final BufferedImage[] getThumbnails(IRenderingOptions options, Dimension imageSize)	public final IImage[] getImages(IRenderingOptions options, Dimension imageSize)

Shape

Methodensignatur	Ersatz‑Methodensignatur
public final BufferedImage getThumbnail()	public final IImage getImage()
public final BufferedImage getThumbnail(int bounds, float scaleX, float scaleY)	public final IImage getImage(int bounds, float scaleX, float scaleY)

Slide

Methodensignatur	Ersatz‑Methodensignatur
public final BufferedImage getThumbnail()	public final IImage getImage()
public final BufferedImage getThumbnail(float scaleX, float scaleY)	public final IImage getImage(float scaleX, float scaleY)
public final BufferedImage getThumbnail(IRenderingOptions options)	public final IImage getImage(IRenderingOptions options)
public final BufferedImage getThumbnail(IRenderingOptions options, float scaleX, float scaleY)	public final IImage getImage(IRenderingOptions options)
public final BufferedImage getThumbnail(IRenderingOptions options, Dimension imageSize)	public final IImage getImage(IRenderingOptions options, Dimension imageSize)
public final BufferedImage getThumbnail(ITiffOptions options)	public final IImage getImage(ITiffOptions options)
public final BufferedImage getThumbnail(Dimension imageSize)	public final IImage getImage(Dimension imageSize)
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics)	Will be deleted completely
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics, float scaleX, float scaleY)	Will be deleted completely
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics, Dimension renderingSize)	Will be deleted completely

Output

Methodensignatur	Ersatz‑Methodensignatur
public final IOutputFile add(String path, BufferedImage image)	public final IOutputFile add(String path, IImage image)

ImageCollection

Methodensignatur	Ersatz‑Methodensignatur
public final IPPImage addImage(BufferedImage image)	public final IPPImage addImage(IImage image)

PPImage

Methodensignatur	Ersatz‑Methodensignatur
public final BufferedImage getSystemImage()	public final IImage getImage()

PatternFormat

Methodensignatur	Ersatz‑Methodensignatur
public final BufferedImage getTileImage(Color styleColor)	public final IImage getTile(Color styleColor)
public final BufferedImage getTileImage(Color background, Color foreground)	public final IImage getTile(Color background, Color foreground)

PatternFormatEffectiveData

Methodensignatur	Ersatz‑Methodensignatur
public final java.awt.image.BufferedImage getTileImage(Color background, Color foreground)	public final IImage getTileIImage(Color background, Color foreground)

API‑Unterstützung für Graphics2D wird eingestellt

Methoden mit Graphics2D werden als veraltet deklariert und ihre Unterstützung wird aus der öffentlichen API entfernt.

Der Teil der API, der es verwendet, wird entfernt:

Slide

FAQ

Warum wurde java.awt.Graphics2D entfernt?

Die Unterstützung für Graphics2D wird aus der öffentlichen API entfernt, um die Arbeit mit Rendering und Bildern zu vereinheitlichen, plattformspezifische Abhängigkeiten zu eliminieren und zu einem plattformübergreifenden Ansatz mit IImage zu wechseln. Alle Rendering‑Methoden zu Graphics2D werden entfernt.

Welchen praktischen Nutzen bietet IImage im Vergleich zu BufferedImage?

IImage vereinheitlicht die Arbeit mit Raster‑ und Vektorbildern und vereinfacht das Speichern in verschiedene Formate über ImageFormat.

Wird das Moderne API die Performance bei der Erstellung von Thumbnails beeinflussen?

Der Wechsel von getThumbnail zu getImage verschlechtert die Szenarien nicht: Die neuen Methoden bieten dieselben Möglichkeiten zur Erzeugung von Bildern mit Optionen und Größen, während sie die Unterstützung für Rendering‑Optionen beibehalten. Der konkrete Gewinn oder Verlust hängt vom jeweiligen Szenario ab, funktional sind die Ersatzmethoden jedoch äquivalent.

Erstellen von 3D-Präsentationen in PHP VBA-Projekte in Präsentationen mit PHP verwalten