ImageOptionsBase

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

All Implemented Interfaces: com.aspose.imaging.IMetadataContainer

public abstract class ImageOptionsBase extends DisposableObject implements IMetadataContainer

Базовые параметры изображения.

Методы

Метод	Описание
isKeepMetadata()	Возвращает значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.
setKeepMetadata(boolean value)	Значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.
getXmpData()	Получает контейнер метаданных XMP.
setXmpData(XmpPacketWrapper value)	Устанавливает контейнер метаданных XMP.
getExifData()	Получает данные Exif.
setExifData(ExifData value)	Устанавливает данные Exif.
getSource()	Получает источник, в котором создаётся изображение.
setSource(Source value)	Получает или устанавливает источник, в котором создаётся изображение.
getPalette()	Получает цветовую палитру.
setPalette(IColorPalette value)	Устанавливает цветовую палитру.
getResolutionSettings()	Получает настройки разрешения.
setResolutionSettings(ResolutionSetting value)	Устанавливает настройки разрешения.
getVectorRasterizationOptions()	Получает параметры векторной растеризации.
setVectorRasterizationOptions(VectorRasterizationOptions value)	Устанавливает параметры векторной растеризации.
getBufferSizeHint()	Получает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
setBufferSizeHint(int value)	Устанавливает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
getMultiPageOptions()	Параметры многостраничного режима.
setMultiPageOptions(MultiPageOptions value)	Параметры многостраничного режима.
getFullFrame()	Получает значение, указывающее, является ли [full frame].
setFullFrame(boolean value)	Устанавливает значение, указывающее, является ли [full frame].
getProgressEventHandler()	Получает обработчик события прогресса.
setProgressEventHandler(ProgressEventHandler value)	Устанавливает обработчик события прогресса.
deepClone()	Клонирует этот экземпляр.
trySetMetadata(IImageMetadataFormat metadata)	Пытается установить экземпляр `metadata`, если данный экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.

isKeepMetadata()

public final boolean isKeepMetadata()

Возвращает значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.

Returns: boolean — значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.

setKeepMetadata(boolean value)

public final void setKeepMetadata(boolean value)

Значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.

Parameters:

Параметр	Тип	Описание
value	boolean	значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.

getXmpData()

public XmpPacketWrapper getXmpData()

Получает контейнер метаданных XMP.

Значение: контейнер данных XMP.

Returns: XmpPacketWrapper - the XMP metadata container.

setXmpData(XmpPacketWrapper value)

public void setXmpData(XmpPacketWrapper value)

Устанавливает контейнер метаданных XMP.

Значение: контейнер данных XMP.

Parameters:

Параметр	Тип	Описание
value	XmpPacketWrapper	контейнер метаданных XMP.

getExifData()

public ExifData getExifData()

Получает данные Exif.

Returns: ExifData - the Exif data.

setExifData(ExifData value)

public void setExifData(ExifData value)

Устанавливает данные Exif.

Parameters:

Параметр	Тип	Описание
value	ExifData	данные Exif.

getSource()

public Source getSource()

Получает источник, в котором создаётся изображение.

Returns: Source - The source to create image in.

setSource(Source value)

public void setSource(Source value)

Получает или устанавливает источник, в котором создаётся изображение.

Parameters:

Параметр	Тип	Описание
value	Source	Источник, в котором создаётся изображение.

getPalette()

public IColorPalette getPalette()

Получает цветовую палитру.

Returns: IColorPalette - The color palette.

setPalette(IColorPalette value)

public void setPalette(IColorPalette value)

Устанавливает цветовую палитру.

Parameters:

Параметр	Тип	Описание
value	IColorPalette	Цветовая палитра.

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


// Создать BMP‑изображение размером 100 × 100 пикселей.
com.aspose.imaging.fileformats.bmp.BmpImage bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // Линейный градиент от левого верхнего до правого нижнего угла изображения.
    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());

    // Заполнить всё изображение кистью линейного градиента.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(bmpImage);
    gr.fillRectangle(brush, bmpImage.getBounds());

    // Получить ближайшую 8‑битную палитру цветов, покрывающую как можно больше пикселей, так чтобы палитровое изображение
    // было почти визуально неотличимо от непалитрового.
    com.aspose.imaging.IColorPalette palette = com.aspose.imaging.ColorPaletteHelper.getCloseImagePalette(bmpImage, 256);

    // 8‑битная палитра содержит не более 256 цветов.
    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();
}

// Вывод выглядит так:
// Размер палетизированного изображения составляет 11078 байт.
// Размер непалетизированного изображения составляет 40054 байт.

getResolutionSettings()

public ResolutionSetting getResolutionSettings()

Получает настройки разрешения.

Returns: ResolutionSetting

setResolutionSettings(ResolutionSetting value)

public void setResolutionSettings(ResolutionSetting value)

Устанавливает настройки разрешения.

Parameters:

Параметр	Тип	Описание
value	ResolutionSetting

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

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

// Загрузите BMP‑изображение из файла.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.bmp");
try {
    // Выполните некоторую обработку изображения.

    // Используйте дополнительные параметры, чтобы указать требуемые параметры изображения.
    com.aspose.imaging.imageoptions.JpegOptions saveOptions = new com.aspose.imaging.imageoptions.JpegOptions();

    // Количество бит на канал равно 8.
    // Когда используется палитра, индекс цвета сохраняется в данных изображения вместо самого цвета.
    saveOptions.setBitsPerChannel((byte) 8);

    // Установите прогрессивный тип сжатия.
    saveOptions.setCompressionType(com.aspose.imaging.fileformats.jpeg.JpegCompressionMode.Progressive);

    // Установите качество изображения. Это значение от 1 до 100.
    saveOptions.setQuality(100);

    // Установите горизонтальное/вертикальное разрешение в 96 точек на дюйм.
    saveOptions.setResolutionSettings(new com.aspose.imaging.ResolutionSetting(96.0, 96.0));
    saveOptions.setResolutionUnit(com.aspose.imaging.ResolutionUnit.Inch);

    // Если исходное изображение цветное, оно будет преобразовано в градации серого.
    saveOptions.setColorType(com.aspose.imaging.fileformats.jpeg.JpegCompressionColorMode.Grayscale);

    // Используйте палитру, чтобы уменьшить размер вывода.
    saveOptions.setPalette(com.aspose.imaging.ColorPaletteHelper.create8BitGrayscale(false));

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

getVectorRasterizationOptions()

public VectorRasterizationOptions getVectorRasterizationOptions()

Получает параметры векторной растеризации.

Returns: VectorRasterizationOptions - The vector rasterization options.

setVectorRasterizationOptions(VectorRasterizationOptions value)

public void setVectorRasterizationOptions(VectorRasterizationOptions value)

Устанавливает параметры векторной растеризации.

Parameters:

Параметр	Тип	Описание
value	VectorRasterizationOptions	Параметры векторной растеризации.

getBufferSizeHint()

public final int getBufferSizeHint()

Получает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.

Значение: Подсказка размера буфера в мегабайтах. Неположительное значение означает отсутствие ограничения памяти для внутренних буферов

Returns: int — подсказка размера буфера, определяющая максимальный допустимый размер для всех внутренних буферов.

setBufferSizeHint(int value)

public final void setBufferSizeHint(int value)

Устанавливает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.

Parameters:

Параметр	Тип	Описание
value	int	подсказка размера буфера, определяющая максимальный допустимый размер для всех внутренних буферов.

getMultiPageOptions()

public MultiPageOptions getMultiPageOptions()

Параметры многостраничного режима.

Returns: MultiPageOptions

setMultiPageOptions(MultiPageOptions value)

public void setMultiPageOptions(MultiPageOptions value)

Параметры многостраничного режима.

Parameters:

Параметр	Тип	Описание
value	MultiPageOptions

getFullFrame()

public final boolean getFullFrame()

Получает значение, указывающее, является ли [full frame].

Значение: true, если [full frame]; иначе false.

Returns: boolean - значение, указывающее, является ли [full frame].

setFullFrame(boolean value)

public final void setFullFrame(boolean value)

Устанавливает значение, указывающее, является ли [full frame].

Значение: true, если [full frame]; иначе false.

Parameters:

Параметр	Тип	Описание
value	boolean	значение, указывающее, является ли [full frame].

getProgressEventHandler()

public ProgressEventHandler getProgressEventHandler()

Получает обработчик события прогресса.

Значение: обработчик события прогресса.

Returns: ProgressEventHandler - the progress event handler.

setProgressEventHandler(ProgressEventHandler value)

public void setProgressEventHandler(ProgressEventHandler value)

Устанавливает обработчик события прогресса.

Значение: обработчик события прогресса.

Parameters:

Параметр	Тип	Описание
value	ProgressEventHandler	обработчик события прогресса.

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

// Пример использования отдельных обработчиков событий прогресса операции для загрузки/экспорта.
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();
}

// Журнал STDOUT может выглядеть так:
//        Событие загрузки Инициализация : 1/4
//        Событие загрузки Предобработка : 2/4
//        Событие загрузки Обработка : 3/4
//        Событие загрузки Завершение : 4/4
//        Событие экспорта Инициализация : 1/4
//        Событие экспорта Предобработка : 2/4
//        Событие экспорта Обработка : 3/4
//        Событие экспорта RelativeProgress : 1/1
//        Событие загрузки RelativeProgress : 1/1
//        Событие экспорта Завершение : 4/4

deepClone()

public ImageOptionsBase deepClone()

Клонирует этот экземпляр.

Returns: ImageOptionsBase - Returns shallow copy of this instance

trySetMetadata(IImageMetadataFormat metadata)

public final boolean trySetMetadata(IImageMetadataFormat metadata)

Пытается установить экземпляр metadata, если данный экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.

Parameters:

Параметр	Тип	Описание
metadata	IImageMetadataFormat	Метаданные.

Returns: boolean - True, если экземпляр IMetadataContainer поддерживает и/или реализует экземпляр IImageMetadataFormat; иначе false.

ImageLoadersRegistry ImageResizeSettings