Класс 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 — не-null массив Strings, содержащий имена форматов. Необходимо указать как минимум одну запись.

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()

Возвращает:

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

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()