ImageOptionsBase

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

All Implemented Interfaces: com.aspose.imaging.IMetadataContainer

public abstract class ImageOptionsBase extends DisposableObject implements IMetadataContainer

Le opzioni base dell’immagine.

Metodi

Metodo	Descrizione
isKeepMetadata()	Ottiene un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.
setKeepMetadata(boolean value)	Un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.
getXmpData()	Ottiene il contenitore dei metadati XMP.
setXmpData(XmpPacketWrapper value)	Imposta il contenitore dei metadati XMP.
getExifData()	Restituisce i dati Exif.
setExifData(ExifData value)	Imposta i dati Exif.
getSource()	Ottiene la sorgente in cui creare l’immagine.
setSource(Source value)	Ottiene o imposta la sorgente in cui creare l’immagine.
getPalette()	Restituisce la tavolozza dei colori.
setPalette(IColorPalette value)	Imposta la tavolozza dei colori.
getResolutionSettings()	Ottiene le impostazioni di risoluzione.
setResolutionSettings(ResolutionSetting value)	Imposta le impostazioni di risoluzione.
getVectorRasterizationOptions()	Ottiene le opzioni di rasterizzazione vettoriale.
setVectorRasterizationOptions(VectorRasterizationOptions value)	Imposta le opzioni di rasterizzazione vettoriale.
getBufferSizeHint()	Restituisce il suggerimento della dimensione del buffer, che è definito come la dimensione massima consentita per tutti i buffer interni.
setBufferSizeHint(int value)	Imposta il suggerimento della dimensione del buffer, che è definito come la dimensione massima consentita per tutti i buffer interni.
getMultiPageOptions()	Le opzioni multipagina
setMultiPageOptions(MultiPageOptions value)	Le opzioni multipagina
getFullFrame()	Ottiene un valore che indica se [full frame].
setFullFrame(boolean value)	Imposta un valore che indica se [full frame].
getProgressEventHandler()	Ottiene il gestore dell’evento di avanzamento.
setProgressEventHandler(ProgressEventHandler value)	Imposta il gestore dell’evento di avanzamento.
deepClone()	Clona questa istanza.
trySetMetadata(IImageMetadataFormat metadata)	Cerca di impostare un’istanza metadata, se questa istanza Image supporta e implementa l’istanza IImageMetadataFormat.

isKeepMetadata()

public final boolean isKeepMetadata()

Ottiene un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.

Returns: boolean - un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.

setKeepMetadata(boolean value)

public final void setKeepMetadata(boolean value)

Un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.

Parameters:

Parametro	Tipo	Descrizione
valore	boolean	un valore che indica se mantenere i metadati originali dell’immagine durante l’esportazione.

getXmpData()

public XmpPacketWrapper getXmpData()

Ottiene il contenitore dei metadati XMP.

Valore: Il contenitore dei dati XMP.

Returns: XmpPacketWrapper - the XMP metadata container.

setXmpData(XmpPacketWrapper value)

public void setXmpData(XmpPacketWrapper value)

Imposta il contenitore dei metadati XMP.

Valore: Il contenitore dei dati XMP.

Parameters:

Parametro	Tipo	Descrizione
value	XmpPacketWrapper	il contenitore dei metadati XMP.

getExifData()

public ExifData getExifData()

Restituisce i dati Exif.

Returns: ExifData - the Exif data.

setExifData(ExifData value)

public void setExifData(ExifData value)

Imposta i dati Exif.

Parameters:

Parametro	Tipo	Descrizione
value	ExifData	i dati Exif.

getSource()

public Source getSource()

Ottiene la sorgente in cui creare l’immagine.

Returns: Source - The source to create image in.

setSource(Source value)

public void setSource(Source value)

Ottiene o imposta la sorgente in cui creare l’immagine.

Parameters:

Parametro	Tipo	Descrizione
value	Source	La sorgente in cui creare l’immagine.

getPalette()

public IColorPalette getPalette()

Restituisce la tavolozza dei colori.

Returns: IColorPalette - The color palette.

setPalette(IColorPalette value)

public void setPalette(IColorPalette value)

Imposta la tavolozza dei colori.

Parameters:

Parametro	Tipo	Descrizione
value	IColorPalette	La tavolozza dei colori.

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

// Crea un'immagine BMP 100 x 100 px.
com.aspose.imaging.fileformats.bmp.BmpImage bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // Il gradiente lineare dall'angolo in alto a sinistra a quello in basso a destra dell'immagine.
    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());

    // Riempie l'intera immagine con il pennello a gradiente lineare.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(bmpImage);
    gr.fillRectangle(brush, bmpImage.getBounds());

    // Ottieni la palette di colori a 8 bit più vicina che copra il maggior numero possibile di pixel, in modo che un'immagine paletteizzata
    // sia quasi indistinguibile visivamente da una non paletteizzata.
    com.aspose.imaging.IColorPalette palette = com.aspose.imaging.ColorPaletteHelper.getCloseImagePalette(bmpImage, 256);

    // La palette a 8 bit contiene al massimo 256 colori.
    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();
}

// L'output appare così:
// La dimensione dell'immagine a palette è 11078 byte.
// La dimensione dell'immagine non a palette è 40054 byte.

getResolutionSettings()

public ResolutionSetting getResolutionSettings()

Ottiene le impostazioni di risoluzione.

Returns: ResolutionSetting

setResolutionSettings(ResolutionSetting value)

public void setResolutionSettings(ResolutionSetting value)

Imposta le impostazioni di risoluzione.

Parameters:

Parametro	Tipo	Descrizione
value	ResolutionSetting

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

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

// Carica un'immagine BMP da un file.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.bmp");
try {
    // Esegui qualche elaborazione dell'immagine.

    // Utilizza opzioni aggiuntive per specificare i parametri desiderati dell'immagine.
    com.aspose.imaging.imageoptions.JpegOptions saveOptions = new com.aspose.imaging.imageoptions.JpegOptions();

    // Il numero di bit per canale è 8.
    // Quando viene utilizzata una palette, l'indice di colore è memorizzato nei dati dell'immagine invece del colore stesso.
    saveOptions.setBitsPerChannel((byte) 8);

    // Imposta il tipo di compressione progressiva.
    saveOptions.setCompressionType(com.aspose.imaging.fileformats.jpeg.JpegCompressionMode.Progressive);

    // Imposta la qualità dell'immagine. È un valore compreso tra 1 e 100.
    saveOptions.setQuality(100);

    // Imposta la risoluzione orizzontale/verticale a 96 punti per pollice.
    saveOptions.setResolutionSettings(new com.aspose.imaging.ResolutionSetting(96.0, 96.0));
    saveOptions.setResolutionUnit(com.aspose.imaging.ResolutionUnit.Inch);

    // Se l'immagine di origine è a colori, verrà convertita in scala di grigi.
    saveOptions.setColorType(com.aspose.imaging.fileformats.jpeg.JpegCompressionColorMode.Grayscale);

    // Utilizza una palette per ridurre la dimensione dell'output.
    saveOptions.setPalette(com.aspose.imaging.ColorPaletteHelper.create8BitGrayscale(false));

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

getVectorRasterizationOptions()

public VectorRasterizationOptions getVectorRasterizationOptions()

Ottiene le opzioni di rasterizzazione vettoriale.

Returns: VectorRasterizationOptions - The vector rasterization options.

setVectorRasterizationOptions(VectorRasterizationOptions value)

public void setVectorRasterizationOptions(VectorRasterizationOptions value)

Imposta le opzioni di rasterizzazione vettoriale.

Parameters:

Parametro	Tipo	Descrizione
value	VectorRasterizationOptions	Le opzioni di rasterizzazione vettoriale.

getBufferSizeHint()

public final int getBufferSizeHint()

Restituisce il suggerimento della dimensione del buffer, che è definito come la dimensione massima consentita per tutti i buffer interni.

Valore: L’indicazione della dimensione del buffer, in megabyte. Un valore non positivo indica nessuna limitazione di memoria per i buffer interni

Returns: int - l’indicazione della dimensione del buffer che definisce la dimensione massima consentita per tutti i buffer interni.

setBufferSizeHint(int value)

public final void setBufferSizeHint(int value)

Imposta il suggerimento della dimensione del buffer, che è definito come la dimensione massima consentita per tutti i buffer interni.

Valore: L’indicazione della dimensione del buffer, in megabyte. Un valore non positivo indica nessuna limitazione di memoria per i buffer interni

Parameters:

Parametro	Tipo	Descrizione
valore	int	l’indicazione della dimensione del buffer che definisce la dimensione massima consentita per tutti i buffer interni.

getMultiPageOptions()

public MultiPageOptions getMultiPageOptions()

Le opzioni multipagina

Returns: MultiPageOptions

setMultiPageOptions(MultiPageOptions value)

public void setMultiPageOptions(MultiPageOptions value)

Le opzioni multipagina

Parameters:

Parametro	Tipo	Descrizione
value	MultiPageOptions

getFullFrame()

public final boolean getFullFrame()

Ottiene un valore che indica se [full frame].

Valore: true se [full frame]; altrimenti, false.

Returns: boolean - un valore che indica se [full frame].

setFullFrame(boolean value)

public final void setFullFrame(boolean value)

Imposta un valore che indica se [full frame].

Valore: true se [full frame]; altrimenti, false.

Parameters:

Parametro	Tipo	Descrizione
valore	boolean	un valore che indica se [full frame].

getProgressEventHandler()

public ProgressEventHandler getProgressEventHandler()

Ottiene il gestore dell’evento di avanzamento.

Valore: Il gestore dell’evento di avanzamento.

Returns: ProgressEventHandler - the progress event handler.

setProgressEventHandler(ProgressEventHandler value)

public void setProgressEventHandler(ProgressEventHandler value)

Imposta il gestore dell’evento di avanzamento.

Valore: Il gestore dell’evento di avanzamento.

Parameters:

Parametro	Tipo	Descrizione
value	ProgressEventHandler	il gestore dell’evento di avanzamento.

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";

// Esempio di utilizzo di gestori di eventi di avanzamento dell'operazione separati per le operazioni di caricamento/esportazione
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();
}

// Il registro STDOUT può apparire così:
//        Evento di caricamento Inizializzazione : 1/4
//        Evento di caricamento Preelaborazione : 2/4
//        Evento di caricamento Elaborazione : 3/4
//        Evento di caricamento Finalizzazione : 4/4
//        Evento di esportazione Inizializzazione : 1/4
//        Evento di esportazione Preelaborazione : 2/4
//        Evento di esportazione Elaborazione : 3/4
//        Evento di esportazione ProgressoRelativo : 1/1
//        Evento di caricamento ProgressoRelativo : 1/1
//        Evento di esportazione Finalizzazione : 4/4

deepClone()

public ImageOptionsBase deepClone()

Clona questa istanza.

Returns: ImageOptionsBase - Returns shallow copy of this instance

trySetMetadata(IImageMetadataFormat metadata)

public final boolean trySetMetadata(IImageMetadataFormat metadata)

Cerca di impostare un’istanza metadata, se questa istanza Image supporta e implementa l’istanza IImageMetadataFormat.

Parameters:

Parametro	Tipo	Descrizione
metadata	IImageMetadataFormat	I metadati.

Returns: boolean - True, se l’istanza IMetadataContainer supporta e/o implementa l’istanza IImageMetadataFormat; altrimenti, false.