JPEGImageWriteParam (Платформа Java SE 7)

java.lang. Объект
- javax.imageio. IIOParam
- - javax.imageio. ImageWriteParam
  - - javax.imageio.plugins.jpeg.JPEGImageWriteParam

```
public class JPEGImageWriteParam
extends ImageWriteParam
```
Этот класс добавляет возможность установить квантование JPEG и таблицы Хафмана при использовании встроенного плагина писателя JPEG, и запросить, чтобы оптимизировал таблицы Хафмана быть вычисленным для изображения. Экземпляр этого класса будет возвращен из getDefaultImageWriteParam методы встроенного JPEG ImageWriter.
Основная цель этих дополнений состоит в том, чтобы позволить спецификации таблиц использовать в кодировании сокращенных потоков. Встроенный писатель JPEG также примет дежурное блюдо ImageWriteParam, когда писатель создаст необходимые таблицы внутренне.
В любом случае, качество, начинающееся ImageWriteParam имеет то же самое значение что касается базовой библиотеки: 1.00 означает, что таблица квантования всех 1's, 0.75 означает "стандарт", визуально таблицу квантования без потерь, и 0.00 средства aquantization таблица всех 255's.
В то время как таблицы для сокращенных потоков часто определяются первой записью сокращенного потока, содержащего только таблицы в некоторых приложениях, таблицы фиксируются загодя. Этот класс позволяет таблицам быть определенными непосредственно от клиентского кода.
Обычно, таблицы определяются в IIOMetadata объекты, которые передают в писателю, и любым таблицам, включенным в эти объекты, пишутся потоку. Если никакие таблицы не определяются в метаданных, то сокращенный поток пишется. Если никакие таблицы не включаются в метаданные, и никакие таблицы не определяются в a JPEGImageWriteParam, тогда сокращенный поток кодируется, используя "стандарт" визуально таблицы без потерь. Этот класс необходим для того, чтобы определить таблицы, когда сокращенный поток должен быть записан, не пишущий таблиц в поток сначала. Чтобы использовать этот класс, объект метаданных, который передают в писателя, не должен содержать таблицы, и никакие потоковые метаданные не должны быть обеспечены. См. JPEGQTable и JPEGHuffmanTable для получения дополнительной информации о таблицах по умолчанию.
Значение по умолчанию JPEGImageWriteParam возвращенный getDefaultWriteParam метод писателя не содержит таблиц. Таблицы по умолчанию включаются в значение по умолчанию IIOMetadata объекты возвратились писателем.
Если метаданные действительно содержат таблицы, таблицы, данные в a JPEGImageWriteParam игнорируются. Кроме того, как только ряд таблиц был записан, только таблицы в метаданных могут переопределить их для последующих записей, ли к тому же самому потоку или различному. Чтобы определить новые таблицы, используя этот класс, reset метод писателя нужно вызвать.
Для получения дополнительной информации о работе встроенных плагинов JPEG, см. спецификацию формата метаданных JPEG и примечания использования.

Полевая Сводка
- Поля 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
- Поля javax.imageio унаследованный от класса. IIOParam
  controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

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

Конструкторы
Конструктор и Описание

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`areTablesSet()` Возвраты `true` если на столы в настоящий момент накрывают.
`JPEGHuffmanTable[]`	`getACHuffmanTables()` Возвращает копию массива табличного набора Хаффмана AC на новом звонке `setEncodeTables`, или `null` если на столы в настоящий момент не накрывают.
`Строка[]`	`getCompressionQualityDescriptions()` Возвращает массив `String`s, который может использоваться наряду с `getCompressionQualityValues` как часть пользовательского интерфейса для установки или отображения уровня качества сжатия.
`float[]`	`getCompressionQualityValues()` Возвращает массив `float`s, который может использоваться наряду с `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()` Удаляет любое квантование и столы Хафмана, на которые в настоящий момент накрывают.

Методы 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

Методы javax.imageio унаследованный от класса. IIOParam
activateController, getController, getDefaultController, getDestinationOffset, getDestinationType, getSourceBands, getSourceRegion, getSourceXSubsampling, getSourceYSubsampling, getSubsamplingXOffset, getSubsamplingYOffset, hasController, setController, setDestinationOffset, setDestinationType, setSourceBands, setSourceRegion, setSourceSubsampling

Методы 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 в классе ImageWriteParam
    
    Броски:
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    См. Также:
    ImageWriteParam.setCompressionType(java.lang.String), ImageWriteParam.setCompressionQuality(float)
  - isCompressionLossless
```
public boolean isCompressionLossless()
```
    Возвраты false так как плагин JPEG только поддерживает сжатие с потерями.
    
    Переопределения:
    
    isCompressionLossless в классе ImageWriteParam
    
    Возвраты:
    false.
    
    Броски:
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
  - getCompressionQualityDescriptions
```
public String[] getCompressionQualityDescriptions()
```
    Описание скопировало с класса: 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 в классе ImageWriteParam
    
    Возвраты:
    массив Strings содержащий локализованные описания уровней качества сжатия.
    См. Также:
    ImageWriteParam.getCompressionQualityValues()
  - getCompressionQualityValues
```
public float[] getCompressionQualityValues()
```
    Описание скопировало с класса: ImageWriteParam
    
    Возвращает массив floats, который может использоваться наряду с getCompressionQualityDescriptions как часть пользовательского интерфейса для установки или отображения уровня качества сжатия. См. getCompressionQualityDescriptions для получения дополнительной информации.
    Если никакие описания не доступны, null возвращается. Если null возвращается из getCompressionQualityDescriptions, этот метод должен также возвратиться null.
    Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.
    Реализация по умолчанию проверяет, что сжатие поддерживается и что режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null, это возвращается null.
    
    Переопределения:
    
    getCompressionQualityValues в классе 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)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс JPEGImageWriteParam

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

Поля javax.imageio унаследованный от класса. ImageWriteParam

Поля javax.imageio унаследованный от класса. IIOParam

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

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

Методы javax.imageio унаследованный от класса. ImageWriteParam

Методы javax.imageio унаследованный от класса. IIOParam

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

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

JPEGImageWriteParam

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

unsetCompression

isCompressionLossless

getCompressionQualityDescriptions

getCompressionQualityValues

areTablesSet

setEncodeTables

unsetEncodeTables

getQTables

getDCHuffmanTables

getACHuffmanTables

setOptimizeHuffmanTables

getOptimizeHuffmanTables