javax.imageio.plugins.jpeg

Класс JPEGImageWriteParam

java.lang. Объект

javax.imageio. IIOParam

javax.imageio. ImageWriteParam

javax.imageio.plugins.jpeg.JPEGImageWriteParam

public class JPEGImageWriteParam
extends ImageWriteParam

Этот class добавляет возможность установить квантование JPEG и таблицы Хафмана при использовании встроенного плагина писателя JPEG, и запросить, чтобы оптимизировал таблицы Хафмана быть вычисленным для изображения. Экземпляр этого class будет возвращен из getDefaultImageWriteParam методы встроенного JPEG ImageWriter.

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

В любом случае, качество, начинающееся ImageWriteParam имеет то же самое значение что касается базовой библиотеки: 1.00 означает, что таблица квантования всех 1's, 0.75 означает "стандарт", визуально таблицу квантования без потерь, и 0.00 средства aquantization таблица всех 255's.

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

Обычно, таблицы определяются в IIOMetadata объекты, которые передают в писателю, и любым таблицам, включенным в эти объекты, пишутся потоку. Если никакие таблицы не определяются в метаданных, то сокращенный поток пишется. Если никакие таблицы не включаются в метаданные, и никакие таблицы не определяются в a JPEGImageWriteParam, тогда сокращенный поток кодируется, используя "стандарт" визуально таблицы без потерь. Этот class необходим для того, чтобы определить таблицы, когда сокращенный поток должен быть записан, не пишущий таблиц в поток сначала. Чтобы использовать этот class, объект метаданных, который передают в писателя, не должен содержать таблицы, и никакие потоковые метаданные не должны быть обеспечены. См. JPEGQTable и JPEGHuffmanTable для получения дополнительной информации о таблицах значения по умолчанию.

Значение по умолчанию JPEGImageWriteParam возвращенный getDefaultWriteParam метод писателя не содержит таблиц. Таблицы значения по умолчанию включаются в значение по умолчанию IIOMetadata объекты возвратились писателем.

Если метаданные действительно содержат таблицы, таблицы, данные в a JPEGImageWriteParam игнорируются. Кроме того, как только ряд таблиц был записан, только таблицы в метаданных могут переопределить их для последующих записей, ли к тому же самому потоку или различному. Чтобы определить новые таблицы, используя этот class, reset метод писателя нужно вызвать.

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

Полевая Сводка

Поля, наследованные от class javax.imageio. ImageWriteParam

canOffsetTiles, canWriteCompressed, canWriteProgressive, canWriteTiles, compressionMode, compressionQuality, compressionType, compressionTypes, locale, MODE_COPY_FROM_METADATA, MODE_DEFAULT, MODE_DISABLED, MODE_EXPLICIT, preferredTileSizes, progressiveMode, tileGridXOffset, tileGridYOffset, tileHeight, tileWidth, tilingMode, tilingSet

Поля, наследованные от class javax.imageio. IIOParam

controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

Сводка конструктора

Конструкторы

Конструктор и Описание
JPEGImageWriteParam(Locale locale) Конструкции a JPEGImageWriteParam.

Сводка метода

Модификатор и Тип	Метод и Описание
boolean	areTablesSet() Возвраты true если на столы в настоящий момент накрывают.
JPEGHuffmanTable[]	getACHuffmanTables() Возвращает копию массива табличного набора Хаффмана AC на новом звонке setEncodeTables, или null если на столы в настоящий момент не накрывают.
Строка[]	getCompressionQualityDescriptions() Возвращает массив Strings, который может использоваться наряду с getCompressionQualityValues как часть пользовательского интерфейса для установки или отображения уровня качества сжатия.
float[]	getCompressionQualityValues() Возвращает массив floats, который может использоваться наряду с getCompressionQualityDescriptions как часть пользовательского интерфейса для установки или отображения уровня качества сжатия.
JPEGHuffmanTable[]	getDCHuffmanTables() Возвращает копию массива табличного набора Хаффмана DC на новом звонке setEncodeTables, или null если на столы в настоящий момент не накрывают.
boolean	getOptimizeHuffmanTables() Возвращает значение, которое передают в новый звонок setOptimizeHuffmanTables, или false если setOptimizeHuffmanTables никогда не вызывался.
JPEGQTable[]	getQTables() Возвращает копию массива табличного набора квантования на новом звонке setEncodeTables, или null если на столы в настоящий момент не накрывают.
boolean	isCompressionLossless() Возвраты false так как плагин JPEG только поддерживает сжатие с потерями.
void	setEncodeTables(JPEGQTable[] qTables, JPEGHuffmanTable[] DCHuffmanTables, JPEGHuffmanTable[] ACHuffmanTables) Устанавливает квантование и таблицы Хафмана, чтобы использовать в кодировании сокращенных потоков.
void	setOptimizeHuffmanTables(boolean optimize) Говорит писателю генерировать оптимизированные таблицы Хафмана для изображения как часть записи.
void	unsetCompression() Удаляет любую предыдущую качественную установку сжатия.
void	unsetEncodeTables() Удаляет любое квантование и столы Хафмана, на которые в настоящий момент накрывают.

Методы, наследованные от class javax.imageio. ImageWriteParam

canOffsetTiles, canWriteCompressed, canWriteProgressive, canWriteTiles, getBitRate, getCompressionMode, getCompressionQuality, getCompressionType, getCompressionTypes, getLocale, getLocalizedCompressionTypeName, getPreferredTileSizes, getProgressiveMode, getTileGridXOffset, getTileGridYOffset, getTileHeight, getTileWidth, getTilingMode, setCompressionMode, setCompressionQuality, setCompressionType, setProgressiveMode, setTiling, setTilingMode, unsetTiling

Методы, наследованные от class javax.imageio. IIOParam

activateController, getController, getDefaultController, getDestinationOffset, getDestinationType, getSourceBands, getSourceRegion, getSourceXSubsampling, getSourceYSubsampling, getSubsamplingXOffset, getSubsamplingYOffset, hasController, setController, setDestinationOffset, setDestinationType, setSourceBands, setSourceRegion, setSourceSubsampling

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

JPEGImageWriteParam

public JPEGImageWriteParam(Locale locale)

Конструкции a JPEGImageWriteParam. Мозаичное размещение не поддерживается. Прогрессивное кодирование поддерживается. Значение по умолчанию прогрессивный режим является MODE_DISABLED. Поддерживается единственная форма сжатия, названного "JPEG". Качество сжатия значения по умолчанию 0.75.

Параметры:

locale - a Locale использоваться суперклассом, чтобы локализовать имена типов сжатия и качественные описания, или null.

Деталь метода

unsetCompression

public void unsetCompression()

Удаляет любую предыдущую качественную установку сжатия.

Реализация по умолчанию сбрасывает качество сжатия к 0.75F.

Переопределения:

unsetCompression в class ImageWriteParam

Броски:

IllegalStateException - если режим сжатия не MODE_EXPLICIT.

См. Также:

ImageWriteParam.setCompressionType(java.lang.String), ImageWriteParam.setCompressionQuality(float)

isCompressionLossless

public boolean isCompressionLossless()

Возвраты false так как плагин JPEG только поддерживает сжатие с потерями.

Переопределения:

isCompressionLossless в class ImageWriteParam

Возвраты:

false.

Броски:

IllegalStateException - если режим сжатия не MODE_EXPLICIT.

getCompressionQualityDescriptions

public String[] getCompressionQualityDescriptions()

Описание скопировало с class: ImageWriteParam

Возвращает массив Strings, который может использоваться наряду с getCompressionQualityValues как часть пользовательского интерфейса для установки или отображения уровня качества сжатия. String с индексируют i обеспечивает описание диапазона уровней качества между getCompressionQualityValues[i] и getCompressionQualityValues[i + 1]. Отметьте что длина массива, возвращенного из getCompressionQualityValues всегда будет одно большее чем это, возвратился из getCompressionQualityDescriptions.

Как пример, "Хорошие" строки, "Лучше", и "Лучше всего" мог быть связан с диапазонами [0, .33), [.33, .66), и [.66, 1.0]. В этом случае, getCompressionQualityDescriptions возвратился бы { "Good", "Better", "Best" } и getCompressionQualityValues возвратился бы { 0.0F, .33F, .66F, 1.0F }.

Если никакие описания не доступны, null возвращается. Если null возвращается из getCompressionQualityValues, этот метод должен также возвратиться null.

Описания должны быть локализованы для Locale возвращенный getLocale, если это не -null.

Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.

Реализация по умолчанию проверяет, что сжатие поддерживается и что режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null, это возвращается null.

Переопределения:

getCompressionQualityDescriptions в class ImageWriteParam

Возвраты:

массив Strings содержащий локализованные описания уровней качества сжатия.

См. Также:

ImageWriteParam.getCompressionQualityValues()

getCompressionQualityValues

public float[] getCompressionQualityValues()

Описание скопировало с class: ImageWriteParam

Возвращает массив floats, который может использоваться наряду с getCompressionQualityDescriptions как часть пользовательского интерфейса для установки или отображения уровня качества сжатия. См. getCompressionQualityDescriptions для получения дополнительной информации.

Если никакие описания не доступны, null возвращается. Если null возвращается из getCompressionQualityDescriptions, этот метод должен также возвратиться null.

Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.

Реализация по умолчанию проверяет, что сжатие поддерживается и что режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null, это возвращается null.

Переопределения:

getCompressionQualityValues в class ImageWriteParam

Возвраты:

массив floats указание на границы между уровнями качества сжатия как описано Strings от getCompressionQualityDescriptions.

См. Также:

ImageWriteParam.getCompressionQualityDescriptions()

areTablesSet

public boolean areTablesSet()

Возвраты true если на столы в настоящий момент накрывают.

Возвраты:

true если таблицы присутствуют.

setEncodeTables

public void setEncodeTables(JPEGQTable[] qTables,
                            JPEGHuffmanTable[] DCHuffmanTables,
                            JPEGHuffmanTable[] ACHuffmanTables)

Устанавливает квантование и таблицы Хафмана, чтобы использовать в кодировании сокращенных потоков. Может быть максимум 4 таблиц каждого типа. Эти таблицы игнорируются, если таблицы определяются в метаданных. Все параметры должны быть не -null. У двух массивов таблиц Хафмана должно быть то же самое число элементов. Табличные спецификаторы во фрейме и заголовки сканирования в метаданных, как предполагается, эквивалентны индексам в эти массивы. Массивы параметра копируются этим методом.

Параметры:

qTables - Массив табличных объектов квантования.

DCHuffmanTables - Массив табличных объектов Хафмана.

ACHuffmanTables - Массив табличных объектов Хафмана.

Броски:

IllegalArgumentException - если какой-либо из параметров null или имеет больше чем 4 элемента, или если числа DC и таблиц AC отличаются.

См. Также:

unsetEncodeTables()

unsetEncodeTables

public void unsetEncodeTables()

Удаляет любое квантование и столы Хафмана, на которые в настоящий момент накрывают.

См. Также:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getQTables

public JPEGQTable[] getQTables()

Возвращает копию массива табличного набора квантования на новом звонке setEncodeTables, или null если на столы в настоящий момент не накрывают.

Возвраты:

массив JPEGQTable объекты, или null.

См. Также:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getDCHuffmanTables

public JPEGHuffmanTable[] getDCHuffmanTables()

Возвращает копию массива табличного набора Хаффмана DC на новом звонке setEncodeTables, или null если на столы в настоящий момент не накрывают.

Возвраты:

массив JPEGHuffmanTable объекты, или null.

См. Также:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getACHuffmanTables

public JPEGHuffmanTable[] getACHuffmanTables()

Возвращает копию массива табличного набора Хаффмана AC на новом звонке setEncodeTables, или null если на столы в настоящий момент не накрывают.

Возвраты:

массив JPEGHuffmanTable объекты, или null.

См. Также:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

setOptimizeHuffmanTables

public void setOptimizeHuffmanTables(boolean optimize)

Говорит писателю генерировать оптимизированные таблицы Хафмана для изображения как часть записи. Значение по умолчанию false. Если этот флаг устанавливается в true, это переопределяет любые таблицы, определенные в метаданных. Отметьте, что это означает что любое изображение, записанное с этим набором флага true будет всегда содержать таблицы Хафмана.

Параметры:

optimize - Булево указание, генерировать ли оптимизированные таблицы Хафмана при записи.

См. Также:

getOptimizeHuffmanTables()

getOptimizeHuffmanTables

public boolean getOptimizeHuffmanTables()

Возвращает значение, которое передают в новый звонок setOptimizeHuffmanTables, или false если setOptimizeHuffmanTables никогда не вызывался.

Возвраты:

true если писатель генерирует, оптимизировал таблицы Хафмана.

См. Также:

setOptimizeHuffmanTables(boolean)