ImageOptionsBase

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject

All Implemented Interfaces: com.aspose.imaging.IMetadataContainer

public abstract class ImageOptionsBase extends DisposableObject implements IMetadataContainer

Die Basisoptionen für Bilder.

Methoden

Methode	Beschreibung
isKeepMetadata()	Gibt einen Wert zurück, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden sollen.
setKeepMetadata(boolean value)	Ein Wert, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden sollen.
getXmpData()	Ruft den XMP-Metadatencontainer ab.
setXmpData(XmpPacketWrapper value)	Setzt den XMP-Metadatencontainer.
getExifData()	Liefert die Exif-Daten.
setExifData(ExifData value)	Setzt die Exif-Daten.
getSource()	Ruft die Quelle ab, in der das Bild erstellt wird.
setSource(Source value)	Ruft die Quelle ab oder setzt sie, in der das Bild erstellt wird.
getPalette()	Liefert die Farbpalette.
setPalette(IColorPalette value)	Setzt die Farbpalette.
getResolutionSettings()	Ruft die Auflösungseinstellungen ab.
setResolutionSettings(ResolutionSetting value)	Setzt die Auflösungseinstellungen.
getVectorRasterizationOptions()	Ruft die Vektor-Rasterisierungsoptionen ab.
setVectorRasterizationOptions(VectorRasterizationOptions value)	Setzt die Vektor-Rasterisierungsoptionen.
getBufferSizeHint()	Liefert den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
setBufferSizeHint(int value)	Setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
getMultiPageOptions()	Die Mehrseitigen Optionen.
setMultiPageOptions(MultiPageOptions value)	Die Mehrseitigen Optionen.
getFullFrame()	Ruft einen Wert ab, der angibt, ob [full frame].
setFullFrame(boolean value)	Setzt einen Wert, der angibt, ob [full frame].
getProgressEventHandler()	Ruft den Fortschritts-Event-Handler ab.
setProgressEventHandler(ProgressEventHandler value)	Setzt den Fortschritts-Event-Handler.
deepClone()	Klonen Sie diese Instanz.
trySetMetadata(IImageMetadataFormat metadata)	Versucht, eine `metadata`-Instanz zu setzen, falls diese Image-Instanz unterstützt und eine IImageMetadataFormat-Instanz implementiert.

isKeepMetadata()

public final boolean isKeepMetadata()

Gibt einen Wert zurück, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden sollen.

Returns: boolean - ein Wert, der angibt, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden.

setKeepMetadata(boolean value)

public final void setKeepMetadata(boolean value)

Ein Wert, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden sollen.

Parameters:

Parameter	Typ	Beschreibung
Wert	boolean	ein Wert, der angibt, ob die ursprünglichen Bildmetadaten beim Export beibehalten werden.

getXmpData()

public XmpPacketWrapper getXmpData()

Ruft den XMP-Metadatencontainer ab.

Wert: Der XMP-Datencontainer.

Returns: XmpPacketWrapper - the XMP metadata container.

setXmpData(XmpPacketWrapper value)

public void setXmpData(XmpPacketWrapper value)

Setzt den XMP-Metadatencontainer.

Wert: Der XMP-Datencontainer.

Parameters:

Parameter	Typ	Beschreibung
value	XmpPacketWrapper	der XMP-Metadatencontainer.

getExifData()

public ExifData getExifData()

Liefert die Exif-Daten.

Returns: ExifData - the Exif data.

setExifData(ExifData value)

public void setExifData(ExifData value)

Setzt die Exif-Daten.

Parameters:

Parameter	Typ	Beschreibung
value	ExifData	die Exif‑Daten.

getSource()

public Source getSource()

Ruft die Quelle ab, in der das Bild erstellt wird.

Returns: Source - The source to create image in.

setSource(Source value)

public void setSource(Source value)

Ruft die Quelle ab oder setzt sie, in der das Bild erstellt wird.

Parameters:

Parameter	Typ	Beschreibung
value	Source	Die Quelle, in der das Bild erstellt wird.

getPalette()

public IColorPalette getPalette()

Liefert die Farbpalette.

Returns: IColorPalette - The color palette.

setPalette(IColorPalette value)

public void setPalette(IColorPalette value)

Setzt die Farbpalette.

Parameters:

Parameter	Typ	Beschreibung
value	IColorPalette	Die Farbpalette.

Example: The following example shows how to palletize a BMP image to reduce its output size.


// Erstelle ein BMP-Bild mit 100 x 100 px.
com.aspose.imaging.fileformats.bmp.BmpImage bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // Der lineare Farbverlauf von der linken oberen zur rechten unteren Ecke des Bildes.
    com.aspose.imaging.brushes.LinearGradientBrush brush =
            new com.aspose.imaging.brushes.LinearGradientBrush(
                    new com.aspose.imaging.Point(0, 0),
                    new com.aspose.imaging.Point(bmpImage.getWidth(), bmpImage.getHeight()),
                    com.aspose.imaging.Color.getRed(),
                    com.aspose.imaging.Color.getGreen());

    // Fülle das gesamte Bild mit dem linearen Farbverlaufs-Pinsel.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(bmpImage);
    gr.fillRectangle(brush, bmpImage.getBounds());

    // Erhalte die nächstgelegene 8-Bit-Farbpalette, die so viele Pixel wie möglich abdeckt, sodass ein palettisiertes Bild
    // fast visuell nicht von einem nicht palettierten Bild zu unterscheiden ist.
    com.aspose.imaging.IColorPalette palette = com.aspose.imaging.ColorPaletteHelper.getCloseImagePalette(bmpImage, 256);

    // Eine 8-Bit-Palette enthält höchstens 256 Farben.
    com.aspose.imaging.imageoptions.BmpOptions saveOptions = new com.aspose.imaging.imageoptions.BmpOptions();
    saveOptions.setPalette(palette);
    saveOptions.setBitsPerPixel(8);

    java.io.ByteArrayOutputStream stream = new java.io.ByteArrayOutputStream();
    try {
        bmpImage.save(stream, saveOptions);
        System.out.println("The palettized image size is " + stream.size() + " bytes.");
    } finally {
        stream.close();
    }

    stream = new java.io.ByteArrayOutputStream();
    try {
        bmpImage.save(stream);
        System.out.println("The non-palettized image size is " + stream.size() + " bytes.");
    } finally {
        stream.close();
    }
} finally {
    bmpImage.dispose();
}

// Die Ausgabe sieht folgendermaßen aus:
// Die palettierte Bildgröße beträgt 11078 Bytes.
// Die nicht-palettierte Bildgröße beträgt 40054 Bytes.

getResolutionSettings()

public ResolutionSetting getResolutionSettings()

Ruft die Auflösungseinstellungen ab.

Returns: ResolutionSetting

setResolutionSettings(ResolutionSetting value)

public void setResolutionSettings(ResolutionSetting value)

Setzt die Auflösungseinstellungen.

Parameters:

Parameter	Typ	Beschreibung
value	ResolutionSetting

Example: The following example loads a BMP image and saves it to JPEG using various save options.

String dir = "c:\\temp\\";

// Laden Sie ein BMP-Bild aus einer Datei.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.bmp");
try {
    // Führe einige Bildverarbeitungen durch.

    // Verwenden Sie zusätzliche Optionen, um die gewünschten Bildparameter anzugeben.
    com.aspose.imaging.imageoptions.JpegOptions saveOptions = new com.aspose.imaging.imageoptions.JpegOptions();

    // Die Anzahl der Bits pro Kanal beträgt 8.
    // Wenn eine Palette verwendet wird, wird der Farbindex in den Bilddaten gespeichert anstelle der Farbe selbst.
    saveOptions.setBitsPerChannel((byte) 8);

    // Legen Sie den progressiven Kompressionstyp fest.
    saveOptions.setCompressionType(com.aspose.imaging.fileformats.jpeg.JpegCompressionMode.Progressive);

    // Legen Sie die Bildqualität fest. Sie ist ein Wert zwischen 1 und 100.
    saveOptions.setQuality(100);

    // Stellen Sie die horizontale/vertikale Auflösung auf 96 DPI ein.
    saveOptions.setResolutionSettings(new com.aspose.imaging.ResolutionSetting(96.0, 96.0));
    saveOptions.setResolutionUnit(com.aspose.imaging.ResolutionUnit.Inch);

    // Wenn das Quellbild farbig ist, wird es in Graustufen konvertiert.
    saveOptions.setColorType(com.aspose.imaging.fileformats.jpeg.JpegCompressionColorMode.Grayscale);

    // Verwenden Sie eine Palette, um die Ausgabengröße zu reduzieren.
    saveOptions.setPalette(com.aspose.imaging.ColorPaletteHelper.create8BitGrayscale(false));

    image.save(dir + "sample.palettized.jpg", saveOptions);
} finally {
    image.dispose();
}

getVectorRasterizationOptions()

public VectorRasterizationOptions getVectorRasterizationOptions()

Ruft die Vektor-Rasterisierungsoptionen ab.

Returns: VectorRasterizationOptions - The vector rasterization options.

setVectorRasterizationOptions(VectorRasterizationOptions value)

public void setVectorRasterizationOptions(VectorRasterizationOptions value)

Setzt die Vektor-Rasterisierungsoptionen.

Parameters:

Parameter	Typ	Beschreibung
value	VectorRasterizationOptions	Die Vektor-Rasterisierungsoptionen.

getBufferSizeHint()

public final int getBufferSizeHint()

Liefert den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.

Wert: Der Hinweis zur Puffergröße in Megabyte. Ein nicht‑positiver Wert bedeutet keine Speicherbeschränkung für interne Puffer.

Returns: int - der Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.

setBufferSizeHint(int value)

public final void setBufferSizeHint(int value)

Setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.

Wert: Der Hinweis zur Puffergröße in Megabyte. Ein nicht‑positiver Wert bedeutet keine Speicherbeschränkung für interne Puffer.

Parameters:

Parameter	Typ	Beschreibung
Wert	int	Der Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.

getMultiPageOptions()

public MultiPageOptions getMultiPageOptions()

Die Mehrseitigen Optionen.

Returns: MultiPageOptions

setMultiPageOptions(MultiPageOptions value)

public void setMultiPageOptions(MultiPageOptions value)

Die Mehrseitigen Optionen.

Parameters:

Parameter	Typ	Beschreibung
value	MultiPageOptions

getFullFrame()

public final boolean getFullFrame()

Ruft einen Wert ab, der angibt, ob [full frame].

Wert: true, wenn [full frame]; andernfalls false.

Returns: boolean – ein Wert, der angibt, ob [full frame].

setFullFrame(boolean value)

public final void setFullFrame(boolean value)

Setzt einen Wert, der angibt, ob [full frame].

Wert: true, wenn [full frame]; andernfalls false.

Parameters:

Parameter	Typ	Beschreibung
Wert	boolean	ein Wert, der angibt, ob [full frame].

getProgressEventHandler()

public ProgressEventHandler getProgressEventHandler()

Ruft den Fortschritts-Event-Handler ab.

Wert: Der Fortschritts-Ereignishandler.

Returns: ProgressEventHandler - the progress event handler.

setProgressEventHandler(ProgressEventHandler value)

public void setProgressEventHandler(ProgressEventHandler value)

Setzt den Fortschritts-Event-Handler.

Wert: Der Fortschritts-Ereignishandler.

Parameters:

Parameter	Typ	Beschreibung
value	ProgressEventHandler	der Fortschritts-Ereignishandler.

Example: The following example shows how to print information about progress events for load/export operations.

String dir = "c:\\aspose.imaging\\java\\issues\\1440\\";
String fileName = dir + "big.png";

// Beispiel für die Verwendung separater Fortschrittsereignis-Handler für Lade-/Exportvorgänge
final com.aspose.imaging.ProgressEventHandler loadHandler = new com.aspose.imaging.ProgressEventHandler() {
    @Override
    public void invoke(com.aspose.imaging.progressmanagement.ProgressEventHandlerInfo info) {
        System.out.format("Load event %s : %d/%d\n", com.aspose.imaging.progressmanagement.EventType.toString(com.aspose.imaging.progressmanagement.EventType.class, info.getEventType()), info.getValue(), info.getMaxValue());
    }
};

final com.aspose.imaging.ProgressEventHandler exportHandler = new com.aspose.imaging.ProgressEventHandler() {
    @Override
    public void invoke(com.aspose.imaging.progressmanagement.ProgressEventHandlerInfo info) {
        System.out.format("Export event %s : %d/%d\n", com.aspose.imaging.progressmanagement.EventType.toString(com.aspose.imaging.progressmanagement.EventType.class, info.getEventType()), info.getValue(), info.getMaxValue());
    }
};

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(fileName, new com.aspose.imaging.LoadOptions() {{ setProgressEventHandler(loadHandler); }} );
try {
    image.save(fileName + ".psd",
            new com.aspose.imaging.imageoptions.PsdOptions() {{ setProgressEventHandler( exportHandler); }});
}
finally {
    image.close();
}

// Das STDOUT-Protokoll kann folgendermaßen aussehen:
//        Ladeereignis Initialisierung : 1/4
//        Ladeereignis Vorverarbeitung : 2/4
//        Ladeereignis Verarbeitung : 3/4
//        Ladeereignis Finalisierung : 4/4
//        Exportereignis Initialisierung : 1/4
//        Exportereignis Vorverarbeitung : 2/4
//        Exportereignis Verarbeitung : 3/4
//        Exportereignis Relativer Fortschritt : 1/1
//        Ladeereignis Relativer Fortschritt : 1/1
//        Exportereignis Finalisierung : 4/4

deepClone()

public ImageOptionsBase deepClone()

Klonen Sie diese Instanz.

Returns: ImageOptionsBase - Returns shallow copy of this instance

trySetMetadata(IImageMetadataFormat metadata)

public final boolean trySetMetadata(IImageMetadataFormat metadata)

Versucht, eine metadata-Instanz zu setzen, falls diese Image-Instanz unterstützt und eine IImageMetadataFormat-Instanz implementiert.

Parameters:

Parameter	Typ	Beschreibung
metadata	IImageMetadataFormat	Die Metadaten.

Returns: boolean – True, wenn die IMetadataContainer-Instanz unterstützt und/oder die IImageMetadataFormat-Instanz implementiert; andernfalls false.

ImageLoadersRegistry ImageResizeSettings