Класс ImageWriterSpi

@Deprecated public static final Class<?>[] STANDARD_OUTPUT_TYPE

protected Class<?>[] outputTypes

protected String[] readerSpiNames

protected ImageWriterSpi()

public ImageWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String writerClassName, Class<?>[] outputTypes, String[] readerSpiNames, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames)

Параметры:

vendorName — имя поставщика в виде строки, не равной null String.

version — идентификатор версии в виде строки, не равной null String.

names — массив Strings, не равный null, указывающий имена форматов. Должна присутствовать как минимум одна запись.

suffixes — массив Strings, указывающий распространенные расширения файлов. Если расширения не определены, следует указать null. Массив нулевой длины будет нормализован до null.

MIMETypes — массив Strings, указывающий типы MIME формата. Если расширения не определены, следует указать null. Массив нулевой длины будет нормализован до null.

writerClassName — полное имя связанного класса ImageWriterSpi в виде строки, не равной null String.

outputTypes — массив объектов Class длиной не менее 1, указывающий допустимые типы вывода.

readerSpiNames — массив Strings длиной не менее 1, содержащий имена классов всех связанных ImageReaders, или null. Массив нулевой длины нормализуется до null.

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

nativeStreamMetadataFormatName — String или null, возвращаемое из getNativeStreamMetadataFormatName.

nativeStreamMetadataFormatClassName — String или null, используемое для создания объекта формата метаданных, возвращаемого из getNativeStreamMetadataFormat.

extraStreamMetadataFormatNames — массив Strings или null, возвращаемый из getExtraStreamMetadataFormatNames. Массив нулевой длины нормализуется до null.

extraStreamMetadataFormatClassNames — массив Strings или null, используемый для создания объекта формата метаданных, возвращаемого из getStreamMetadataFormat. Массив нулевой длины нормализуется до null.

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

nativeImageMetadataFormatName — String или null, возвращаемое из getNativeImageMetadataFormatName.

nativeImageMetadataFormatClassName — String или null, используемое для создания объекта формата метаданных, возвращаемого из getNativeImageMetadataFormat.

extraImageMetadataFormatNames — массив Strings, возвращаемый из getExtraImageMetadataFormatNames. Массив нулевой длины нормализуется до null.

extraImageMetadataFormatClassNames — массив Strings или null, используемый для создания объекта формата метаданных, возвращаемого из getImageMetadataFormat. Массив нулевой длины нормализуется до null.

Вызывает исключение:

IllegalArgumentException — если vendorName равно null.

IllegalArgumentException — если version равно null.

IllegalArgumentException — если names равно null или имеет нулевую длину.

IllegalArgumentException — если writerClassName равно null.

IllegalArgumentException — если outputTypes равно null или имеет нулевую длину.

public boolean isFormatLossless()

Возвращает:

true, если формат сохраняет полную точность пикселей.

public Class<?>[] getOutputTypes()

Возвращает:

массив объектов Class длиной не менее 1, не равный null.

public abstract boolean canEncodeImage(ImageTypeSpecifier type)

Параметры:

type — ImageTypeSpecifier, задающий структуру записываемого изображения.

Возвращает:

true, если данный модуль записи, вероятно, сможет кодировать изображения с заданной структурой.

Вызывает исключение:

IllegalArgumentException — если type равно null.

public boolean canEncodeImage(RenderedImage im)

Параметры:

im — экземпляр RenderedImage для кодирования.

Возвращает:

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

Вызывает исключение:

IllegalArgumentException — если im равно null.

public ImageWriter createWriterInstance() throws IOException

Возвращает:

экземпляр ImageWriter.

Вызывает исключение:

IOException — если при загрузке или инициализации класса модуля записи либо при создании или инициализации объекта модуля записи произошла ошибка.

public abstract ImageWriter createWriterInstance(Object extension) throws IOException

Параметры:

extension — объект расширения, специфичный для плагина; может иметь значение null.

Возвращает:

экземпляр ImageWriter.

Вызывает исключение:

IOException — если попытка создать экземпляр модуля записи не удалась.

IllegalArgumentException — если конструктор ImageWriter выбрасывает IllegalArgumentException, указывая на непригодность объекта расширения.

public boolean isOwnWriter(ImageWriter writer)

Параметры:

writer — экземпляр ImageWriter.

Возвращает:

true, если writer распознан

Вызывает исключение:

IllegalArgumentException — если writer равно null.

public String[] getImageReaderSpiNames()

Возвращает:

массив Strings длиной не менее 1, содержащий имена ImageReaderSpis, или null.

См. также:

• ImageIO.getImageReader(ImageWriter)
• ImageReaderSpi.getImageWriterSpiNames()