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

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

Прямые Известные Подклассы:

BMPImageWriteParam, JPEGImageWriteParam
```
public class ImageWriteParam
extends IIOParam
```
Класс, описывающий, как должен быть закодирован поток. Экземпляры этого класса или его подклассов используются, чтобы предоставить предписывающую информацию "с практическими рекомендациями" к экземплярам ImageWriter.
Плагин для определенного формата изображения может определить подкласс этого класса, и возвратить объекты того класса от getDefaultWriteParam метод ImageWriter реализация. Например, встроенный плагин писателя JPEG возвратит экземпляры javax.imageio.plugins.jpeg.JPEGImageWriteParam.
Область изображения, которое будет записано, определяется первым пересечением фактических границ изображения с прямоугольником, определенным IIOParam.setSourceRegion, если любой. Если у получающегося прямоугольника будут ширина или высота нуля, то писатель бросит IIOException. Если пересечение будет непусто, то запись будет начинаться с первым подвыбранным пикселем и включать дополнительные пиксели в пределах пересеченных границ согласно горизонтали и вертикальным факторам подвыборки, определенным IIOParam.setSourceSubsampling.
Отдельные функции, такие как мозаичное размещение, прогрессивное кодирование, и сжатие могут быть установлены в одном из четырех режимов. MODE_DISABLED отключает опции; MODE_DEFAULT активирует опцию с управляемыми писателем значениями параметра; MODE_EXPLICIT активирует опцию и позволяет использование a set метод, чтобы обеспечить дополнительные параметры; и MODE_COPY_FROM_METADATA копирует соответствующие значения параметра с потока и объектов метаданных изображения, которые передают писателю. Значение по умолчанию для всех функций MODE_COPY_FROM_METADATA. Нестандартные функции, предоставленные в подклассах, поощряются, но не требуются использовать подобную схему.
Сменные писатели могут расширить функциональность ImageWriteParam обеспечивая подкласс, который реализует дополнительные, сменные определенные интерфейсы. Это до плагина к документу, какие интерфейсы доступны и как они должны использоваться. Писатели тихо проигнорируют любые расширенные функции ImageWriteParam подкласс которого они не знают. Кроме того, они могут проигнорировать любые дополнительные функции, которые они обычно отключают, создавая их собственное ImageWriteParam экземпляры через getDefaultWriteParam.
Отметьте, что, если метод запроса не существует для возможности, он должен поддерживаться всеми ImageWriter реализации (например, прогрессивное кодирование является дополнительным, но подвыборка должна поддерживаться).

См. Также:
ImageReadParam

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

Поля
Модификатор и Тип	Поле и Описание
`protected boolean`	`canOffsetTiles` A `boolean` это `true` если это `ImageWriteParam` позволяет размещать параметры смещения сетки рядом, которые будут установлены.
`protected boolean`	`canWriteCompressed` A `boolean` это `true` если этот писатель может записать изображения, используя сжатие.
`protected boolean`	`canWriteProgressive` A `boolean` это `true` если это `ImageWriteParam` позволяет изображениям быть записанными как прогрессивная последовательность увеличивающихся качественных передач.
`protected boolean`	`canWriteTiles` A `boolean` это `true` если это `ImageWriteParam` позволяет ширине мозаики и параметрам высоты мозаики быть установленной.
`protected int`	`compressionMode` Режим, управляющий настройками сжатия, которые должны быть установлены в один из четырех `MODE_*` значения.
`protected float`	`compressionQuality` A `float` содержа текущую качественную установку сжатия.
`protected String`	`compressionType` A `String` содержа имя текущего типа сжатия, или `null` если ни один не устанавливается.
`protected String[]`	`compressionTypes` Массив `String`s содержащий имена доступных типов сжатия.
`protected Locale`	`локаль` A `Locale` использоваться, чтобы локализовать имена типов сжатия и качественные описания, или `null` использовать значение по умолчанию `Locale`.
`static int`	`MODE_COPY_FROM_METADATA` Постоянная величина, которую можно передать в методы такой как `setTilingMode`, `setProgressiveMode`, или `setCompressionMode` активировать ту опцию для будущих записей.
`static int`	`MODE_DEFAULT` Постоянная величина, которую можно передать в методы такой как `setTilingMode`, `setProgressiveMode`, и `setCompressionMode` активировать ту опцию для будущих записей.
`static int`	`MODE_DISABLED` Постоянная величина, которую можно передать в методы такой как `setTilingMode`, `setProgressiveMode`, и `setCompressionMode` отключать опцию для будущих записей.
`static int`	`MODE_EXPLICIT` Постоянная величина, которую можно передать в методы такой как `setTilingMode` или `setCompressionMode` активировать опцию для будущих записей.
`protected Dimension[]`	`preferredTileSizes` Массив привилегированных пар диапазона размера мозаики.
`protected int`	`progressiveMode` Режим, управляющий прогрессивным кодированием, которое должно быть установлено в один из четырех `MODE_*` значения, кроме `MODE_EXPLICIT`.
`protected int`	`tileGridXOffset` Количество, которым начало координат сетки мозаики должно быть смещено горизонтально от источника изображения, если мозаичное размещение было установлено, или 0 иначе.
`protected int`	`tileGridYOffset` Количество, которым начало координат сетки мозаики должно быть смещено вертикально от источника изображения, если мозаичное размещение было установлено, или 0 иначе.
`protected int`	`tileHeight` Высота каждой мозаики, если мозаичное размещение было установлено, или 0 иначе.
`protected int`	`tileWidth` Ширина каждой мозаики, если мозаичное размещение было установлено, или 0 иначе.
`protected int`	`tilingMode` Настройки мозаичного размещения управления режима, которые Должны быть установлены в один из четырех `MODE_*` значения.
`protected boolean`	`tilingSet` A `boolean` это `true` если размещающие рядом параметры были определены.

Поля javax.imageio унаследованный от класса. IIOParam
controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`ImageWriteParam()` Создает пустое `ImageWriteParam`.
	`ImageWriteParam(Locale locale)` Конструкции `ImageWriteParam` набор, чтобы использовать данный `Locale`.

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

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`canOffsetTiles()` Возвраты `true` если писатель может выполнить мозаичное размещение с ненулевыми смещениями сетки при записи.
`boolean`	`canWriteCompressed()` Возвраты `true` если этот писатель поддерживает сжатие.
`boolean`	`canWriteProgressive()` Возвраты `true` если писатель может выписать изображения как серию передач прогрессивно увеличивающегося качества.
`boolean`	`canWriteTiles()` Возвраты `true` если писатель может выполнить мозаичное размещение при записи.
`float`	`getBitRate(float quality)` Возвраты a `float` указание на оценку числа битов выходных данных для каждого бита ввода отображает данные на данном уровне качества.
`int`	`getCompressionMode()` Возвращает текущий режим сжатия, если сжатие поддерживается.
`float`	`getCompressionQuality()` Возвращает текущую качественную установку сжатия.
`Строка[]`	`getCompressionQualityDescriptions()` Возвращает массив `String`s, который может использоваться наряду с `getCompressionQualityValues` как часть пользовательского интерфейса для установки или отображения уровня качества сжатия.
`float[]`	`getCompressionQualityValues()` Возвращает массив `float`s, который может использоваться наряду с `getCompressionQualityDescriptions` как часть пользовательского интерфейса для установки или отображения уровня качества сжатия.
`Строка`	`getCompressionType()` Возвращается в настоящий момент тип сжатия набора, или `null` если ни один не был установлен.
`Строка[]`	`getCompressionTypes()` Возвращает список доступных типов сжатия, как массив или `String`s, или `null` если тип сжатия не может быть выбран, используя эти интерфейсы.
`Локаль`	`getLocale()` Возвращается в настоящий момент набор `Locale`, или `null` если только значение по умолчанию `Locale` поддерживается.
`Строка`	`getLocalizedCompressionTypeName()` Возвращает локализованную версию имени текущего типа сжатия, используя `Locale` возвращенный `getLocale`.
`Размерность[]`	`getPreferredTileSizes()` Возвращает массив `Dimension`s указание на юридический размер располагается для мозаик, поскольку они будут закодированы в выходном файле или потоке.
`int`	`getProgressiveMode()` Возвращает текущий режим для того, чтобы записать поток прогрессивным способом.
`int`	`getTileGridXOffset()` Возвращает горизонтальное смещение сетки мозаики изображения, как оно будет записано потоку вывода.
`int`	`getTileGridYOffset()` Возвращает вертикальное смещение сетки мозаики изображения, как оно будет записано потоку вывода.
`int`	`getTileHeight()` Возвращает высоту каждой мозаики в изображении, как это будет записано потоку вывода.
`int`	`getTileWidth()` Возвращает ширину каждой мозаики в изображении, как это будет записано потоку вывода.
`int`	`getTilingMode()` Возвращает текущий режим мозаичного размещения, если мозаичное размещение поддерживается.
`boolean`	`isCompressionLossless()` Возвраты `true` если текущий тип сжатия обеспечивает сжатие без потерь.
`void`	`setCompressionMode(int mode)` Определяет, должно ли сжатие быть выполнено, и раз так как должны быть определены параметры сжатия.
`void`	`setCompressionQuality(float quality)` Устанавливает качество сжатия в значение между `0` и `1`.
`void`	`setCompressionType(String compressionType)` Устанавливает тип сжатия в одно из значений, обозначенных `getCompressionTypes`.
`void`	`setProgressiveMode(int mode)` Определяет, что писатель должен выписать изображение в прогрессивном режиме так, что, поток будет содержать серию сканирований увеличивающегося качества.
`void`	`setTiling(int tileWidth, int tileHeight, int tileGridXOffset, int tileGridYOffset)` Определяет, что изображение должно быть размещено рядом в потоке вывода.
`void`	`setTilingMode(int mode)` Определяет, будет ли изображение размещено рядом в потоке вывода и, если это будет, как параметры мозаичного размещения будут определены.
`void`	`unsetCompression()` Удаляет любой предыдущий тип сжатия и качественные настройки.
`void`	`unsetTiling()` Удаляет любые предыдущие параметры сетки мозаики, определенные звонками `setTiling`.

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

- Полевая Деталь
  - MODE_DISABLED
```
public static final int MODE_DISABLED
```
    Постоянная величина, которую можно передать в методы такой как setTilingMode, setProgressiveMode, и setCompressionMode отключать опцию для будущих записей. Таким образом, когда этот режим будет установлен, поток не будет размещен рядом, не прогрессивный, или сжат, и соответствующие методы средства доступа бросят IllegalStateException.
    
    См. Также:
    MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), Постоянные Значения полей
  - MODE_DEFAULT
```
public static final int MODE_DEFAULT
```
    Постоянная величина, которую можно передать в методы такой как setTilingMode, setProgressiveMode, и setCompressionMode активировать ту опцию для будущих записей. Таким образом, когда этому режиму включат, поток будет размещен рядом, прогрессивный, или сжат согласно заметному значению по умолчанию, выбранному внутренне писателем сменным зависимым способом, и соответствующие методы средства доступа бросят IllegalStateException.
    
    См. Также:
    MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), Постоянные Значения полей
  - MODE_EXPLICIT
```
public static final int MODE_EXPLICIT
```
    Постоянная величина, которую можно передать в методы такой как setTilingMode или setCompressionMode активировать опцию для будущих записей. Таким образом, когда этот режим будет установлен, поток будет размещен рядом или сжат согласно дополнительной информации, предоставленной соответствию set методы в этом классе и восстановимый от соответствия get методы. Отметьте, что этот режим не поддерживается для прогрессивного вывода.
    
    См. Также:
    MODE_DISABLED, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), Постоянные Значения полей
  - MODE_COPY_FROM_METADATA
```
public static final int MODE_COPY_FROM_METADATA
```
    Постоянная величина, которую можно передать в методы такой как setTilingMode, setProgressiveMode, или setCompressionMode активировать ту опцию для будущих записей. Таким образом, когда этому режиму включат, поток будет размещен рядом, прогрессивный, или сжат основанный на содержании потока и/или метаданных изображения, которые передают в операцию записи, и любые соответствующие методы средства доступа бросят IllegalStateException.
    Это - режим по умолчанию для всех функций, так, чтобы чтение включая метаданные, сопровождаемые записью включая метаданные, сохранило такую большую информацию насколько возможно.
    
    См. Также:
    MODE_DISABLED, MODE_EXPLICIT, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), Постоянные Значения полей
  - canWriteTiles
```
protected boolean canWriteTiles
```
    A boolean это true если это ImageWriteParam позволяет ширине мозаики и параметрам высоты мозаики быть установленной. По умолчанию значение false. Подклассы должны установить значение вручную.
    Подклассы, которые не поддерживают мозаики записи, должны гарантировать, что это значение устанавливается в false.
  - tilingMode
```
protected int tilingMode
```
    Настройки мозаичного размещения управления режима, которые Должны быть установлены в один из четырех MODE_* значения. Значение по умолчанию MODE_COPY_FROM_METADATA.
    Подклассы, которые не делают мозаик записи, могут проигнорировать это значение.
    
    См. Также:
    MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setTilingMode(int), getTilingMode()
  - preferredTileSizes
```
protected Dimension[] preferredTileSizes
```
    Массив привилегированных пар диапазона размера мозаики. Значение по умолчанию null, который указывает, что нет никаких привилегированных размеров. Если значение не -null, это должно иметь даже длина по крайней мере двух.
    Подклассы, которые не поддерживают мозаики записи, могут проигнорировать это значение.
    
    См. Также:
    getPreferredTileSizes()
  - tilingSet
```
protected boolean tilingSet
```
    A boolean это true если размещающие рядом параметры были определены.
    Подклассы, которые не поддерживают мозаики записи, могут проигнорировать это значение.
  - tileWidth
```
protected int tileWidth
```
    Ширина каждой мозаики, если мозаичное размещение было установлено, или 0 иначе.
    Подклассы, которые не поддерживают мозаичное размещение, могут проигнорировать это значение.
  - tileHeight
```
protected int tileHeight
```
    Высота каждой мозаики, если мозаичное размещение было установлено, или 0 иначе. Начальное значение 0.
    Подклассы, которые не поддерживают мозаичное размещение, могут проигнорировать это значение.
  - canOffsetTiles
```
protected boolean canOffsetTiles
```
    A boolean это true если это ImageWriteParam позволяет размещать параметры смещения сетки рядом, которые будут установлены. По умолчанию значение false. Подклассы должны установить значение вручную.
    Подклассы, которые не поддерживают мозаики записи, или что запись supprt, но не смещение мозаик должна гарантировать, что это значение устанавливается в false.
  - tileGridXOffset
```
protected int tileGridXOffset
```
    Количество, которым начало координат сетки мозаики должно быть смещено горизонтально от источника изображения, если мозаичное размещение было установлено, или 0 иначе. Начальное значение 0.
    Подклассы, которые не поддерживают мозаики смещения, могут проигнорировать это значение.
  - tileGridYOffset
```
protected int tileGridYOffset
```
    Количество, которым начало координат сетки мозаики должно быть смещено вертикально от источника изображения, если мозаичное размещение было установлено, или 0 иначе. Начальное значение 0.
    Подклассы, которые не поддерживают мозаики смещения, могут проигнорировать это значение.
  - canWriteProgressive
```
protected boolean canWriteProgressive
```
    A boolean это true если это ImageWriteParam позволяет изображениям быть записанными как прогрессивная последовательность увеличивающихся качественных передач. По умолчанию значение false. Подклассы должны установить значение вручную.
    Подклассы, которые не поддерживают прогрессивное кодирование, должны гарантировать, что это значение устанавливается в false.
  - progressiveMode
```
protected int progressiveMode
```
    Режим, управляющий прогрессивным кодированием, которое должно быть установлено в один из четырех MODE_* значения, кроме MODE_EXPLICIT. Значение по умолчанию MODE_COPY_FROM_METADATA.
    Подклассы, которые не поддерживают прогрессивное кодирование, могут проигнорировать это значение.
    
    См. Также:
    MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode()
  - canWriteCompressed
```
protected boolean canWriteCompressed
```
    A boolean это true если этот писатель может записать изображения, используя сжатие. По умолчанию значение false. Подклассы должны установить значение вручную.
    Подклассы, которые не поддерживают сжатие, должны гарантировать, что это значение устанавливается в false.
  - compressionMode
```
protected int compressionMode
```
    Режим, управляющий настройками сжатия, которые должны быть установлены в один из четырех MODE_* значения. Значение по умолчанию MODE_COPY_FROM_METADATA.
    Подклассы, которые не поддерживают сжатие, могут проигнорировать это значение.
    
    См. Также:
    MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setCompressionMode(int), getCompressionMode()
  - compressionTypes
```
protected String[] compressionTypes
```
    Массив Strings содержащий имена доступных типов сжатия. Подклассы должны установить значение вручную.
    Подклассы, которые не поддерживают сжатие, могут проигнорировать это значение.
  - compressionType
```
protected String compressionType
```
    A String содержа имя текущего типа сжатия, или null если ни один не устанавливается.
    Подклассы, которые не поддерживают сжатие, могут проигнорировать это значение.
  - compressionQuality
```
protected float compressionQuality
```
    A float содержа текущую качественную установку сжатия. Начальное значение 1.0F.
    Подклассы, которые не поддерживают сжатие, могут проигнорировать это значение.
  - локаль
```
protected Locale locale
```
    A Locale использоваться, чтобы локализовать имена типов сжатия и качественные описания, или null использовать значение по умолчанию Locale. Подклассы должны установить значение вручную.
- Деталь конструктора
  - ImageWriteParam
```
protected ImageWriteParam()
```
    Создает пустое ImageWriteParam. Это до подкласса, чтобы установить переменные экземпляра должным образом.
  - ImageWriteParam
```
public ImageWriteParam(Locale locale)
```
    Конструкции ImageWriteParam набор, чтобы использовать данный Locale.
    
    Параметры:
    locale - a Locale использоваться, чтобы локализовать имена типов сжатия и качественные описания, или null.
- Деталь метода
  - getLocale
```
public Locale getLocale()
```
    Возвращается в настоящий момент набор Locale, или null если только значение по умолчанию Locale поддерживается.
    
    Возвраты:
    ток Locale, или null.
  - canWriteTiles
```
public boolean canWriteTiles()
```
    Возвраты true если писатель может выполнить мозаичное размещение при записи. Если этот метод возвращается false, тогда setTiling бросит UnsupportedOperationException.
    
    Возвраты:
    true если писатель поддерживает мозаичное размещение.
    См. Также:
    canOffsetTiles(), setTiling(int, int, int, int)
  - canOffsetTiles
```
public boolean canOffsetTiles()
```
    Возвраты true если писатель может выполнить мозаичное размещение с ненулевыми смещениями сетки при записи. Если этот метод возвращается false, тогда setTiling бросит UnsupportedOperationException если параметрами смещения сетки не является оба нуль. Если canWriteTiles возвраты false, этот метод возвратится false также.
    
    Возвраты:
    true если писатель поддерживает ненулевые смещения мозаики.
    См. Также:
    canWriteTiles(), setTiling(int, int, int, int)
  - setTilingMode
```
public void setTilingMode(int mode)
```
    Определяет, будет ли изображение размещено рядом в потоке вывода и, если это будет, как параметры мозаичного размещения будут определены. Режимы интерпретируются следующим образом:
    - MODE_DISABLED - Изображение не будет размещено рядом. setTiling бросит IllegalStateException.
    - MODE_DEFAULT - Изображение будет размещено рядом, используя параметры по умолчанию. setTiling бросит IllegalStateException.
    - MODE_EXPLICIT - Изображение будет размещено рядом согласно параметрам, поданным setTiling метод. Любой ранее установленные параметры мозаичного размещения отбрасывается.
    - MODE_COPY_FROM_METADATA - Изображение будет соответствовать объекту метаданных, который передают в к записи. setTiling бросит IllegalStateException.
    Параметры:
    mode - Режим, чтобы использовать для того, чтобы разместить рядом.
    
    Броски:
    
    UnsupportedOperationException - если canWriteTiles возвраты false.
    
    IllegalArgumentException - если mode не один из упомянутых выше режимов.
    См. Также:
    setTiling(int, int, int, int), getTilingMode()
  - getTilingMode
```
public int getTilingMode()
```
    Возвращает текущий режим мозаичного размещения, если мозаичное размещение поддерживается. Иначе броски UnsupportedOperationException.
    
    Возвраты:
    текущий режим мозаичного размещения.
    
    Броски:
    
    UnsupportedOperationException - если canWriteTiles возвраты false.
    См. Также:
    setTilingMode(int)
  - getPreferredTileSizes
```
public Dimension[] getPreferredTileSizes()
```
    Возвращает массив Dimensions указание на юридический размер располагается для мозаик, поскольку они будут закодированы в выходном файле или потоке. Возвращенный массив является копией.
    Информация возвращается как ряд пар; первый элемент пары содержит (содержащую) минимальную ширину и высоту, и второй элемент содержит (содержащую) максимальную ширину и высоту. Вместе, каждая пара определяет допустимый диапазон размеров. Чтобы определить фиксированный размер, используйте ту же самую ширину и высоту для обоих элементов. Определить произвольный диапазон, значение null используется вместо фактического массива Dimensions.
    Если никакой массив не определяется на конструкторе, но мозаичное размещение позволяется, то этот метод возвращается null.
    
    Возвраты:
    массив Dimensions с даже длиной по крайней мере двух, или null.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
  - setTiling
```
public void setTiling(int tileWidth,
             int tileHeight,
             int tileGridXOffset,
             int tileGridYOffset)
```
    Определяет, что изображение должно быть размещено рядом в потоке вывода. tileWidth и tileHeight параметры определяют ширину и высоту мозаик в файле. Если ширина мозаики или высота больше чем ширина или высота изображения, изображение не размещается рядом в той размерности.
    Если canOffsetTiles возвраты false, тогда tileGridXOffset и tileGridYOffset параметры должны быть нулем.
    
    Параметры:
    tileWidth - ширина каждой мозаики.
    tileHeight - высота каждой мозаики.
    tileGridXOffset - горизонтальное смещение сетки мозаики.
    tileGridYOffset - вертикальное смещение сетки мозаики.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
    
    IllegalStateException - если режим мозаичного размещения не MODE_EXPLICIT.
    
    UnsupportedOperationException - если плагин не поддерживает смещения сетки, и смещения сетки не являются оба нулем.
    
    IllegalArgumentException - если размер мозаики не в пределах одного из допустимых диапазонов, возвращенных getPreferredTileSizes.
    
    IllegalArgumentException - если tileWidth или tileHeight меньше чем или равно 0.
    См. Также:
    canWriteTiles, canOffsetTiles, getTileWidth(), getTileHeight(), getTileGridXOffset(), getTileGridYOffset()
  - unsetTiling
```
public void unsetTiling()
```
    Удаляет любые предыдущие параметры сетки мозаики, определенные звонками setTiling.
    Реализация по умолчанию устанавливает переменные экземпляра tileWidth, tileHeight, tileGridXOffset, и tileGridYOffset к 0.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
    
    IllegalStateException - если режим мозаичного размещения не MODE_EXPLICIT.
    См. Также:
    setTiling(int, int, int, int)
  - getTileWidth
```
public int getTileWidth()
```
    Возвращает ширину каждой мозаики в изображении, как это будет записано потоку вывода. Если размещающие рядом параметры не были установлены, IllegalStateException бросается.
    
    Возвраты:
    ширина мозаики, которая будет использоваться для того, чтобы закодировать.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
    
    IllegalStateException - если режим мозаичного размещения не MODE_EXPLICIT.
    
    IllegalStateException - если параметры мозаичного размещения не были установлены.
    См. Также:
    setTiling(int, int, int, int), getTileHeight()
  - getTileHeight
```
public int getTileHeight()
```
    Возвращает высоту каждой мозаики в изображении, как это будет записано потоку вывода. Если размещающие рядом параметры не были установлены, IllegalStateException бросается.
    
    Возвраты:
    высота мозаики, которая будет использоваться для того, чтобы закодировать.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
    
    IllegalStateException - если режим мозаичного размещения не MODE_EXPLICIT.
    
    IllegalStateException - если параметры мозаичного размещения не были установлены.
    См. Также:
    setTiling(int, int, int, int), getTileWidth()
  - getTileGridXOffset
```
public int getTileGridXOffset()
```
    Возвращает горизонтальное смещение сетки мозаики изображения, как оно будет записано потоку вывода. Если размещающие рядом параметры не были установлены, IllegalStateException бросается.
    
    Возвраты:
    сетка мозаики X смещений, которые будут использоваться для того, чтобы закодировать.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
    
    IllegalStateException - если режим мозаичного размещения не MODE_EXPLICIT.
    
    IllegalStateException - если параметры мозаичного размещения не были установлены.
    См. Также:
    setTiling(int, int, int, int), getTileGridYOffset()
  - getTileGridYOffset
```
public int getTileGridYOffset()
```
    Возвращает вертикальное смещение сетки мозаики изображения, как оно будет записано потоку вывода. Если размещающие рядом параметры не были установлены, IllegalStateException бросается.
    
    Возвраты:
    сетка мозаики Y смещение, которое будет использоваться для того, чтобы закодировать.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает мозаичное размещение.
    
    IllegalStateException - если режим мозаичного размещения не MODE_EXPLICIT.
    
    IllegalStateException - если параметры мозаичного размещения не были установлены.
    См. Также:
    setTiling(int, int, int, int), getTileGridXOffset()
  - canWriteProgressive
```
public boolean canWriteProgressive()
```
    Возвраты true если писатель может выписать изображения как серию передач прогрессивно увеличивающегося качества.
    
    Возвраты:
    true если писатель поддерживает прогрессивное кодирование.
    См. Также:
    setProgressiveMode(int), getProgressiveMode()
  - setProgressiveMode
```
public void setProgressiveMode(int mode)
```
    Определяет, что писатель должен выписать изображение в прогрессивном режиме так, что, поток будет содержать серию сканирований увеличивающегося качества. Если прогрессивное кодирование не поддерживается, UnsupportedOperationException будет брошен.
    Параметр режима определяет, как параметры прогрессии выбираются, и должны быть также MODE_DISABLED, MODE_COPY_FROM_METADATA, или MODE_DEFAULT. Иначе IllegalArgumentException бросается.
    Режимы интерпретируются следующим образом:
    - MODE_DISABLED - Никакая прогрессия. Используйте это, чтобы выключить progession.
    - MODE_COPY_FROM_METADATA - Выходное изображение будет использовать любые параметры прогрессии, находятся в объектах метаданных, которые передают в писателя.
    - MODE_DEFAULT - Изображение будет записано прогрессивно с параметрами, выбранными писателем.
    Значение по умолчанию MODE_COPY_FROM_METADATA.
    Параметры:
    mode - Режим для того, чтобы установить прогрессию в потоке вывода.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает прогрессивное кодирование.
    
    IllegalArgumentException - если mode не один из упомянутых выше режимов.
    См. Также:
    getProgressiveMode()
  - getProgressiveMode
```
public int getProgressiveMode()
```
    Возвращает текущий режим для того, чтобы записать поток прогрессивным способом.
    
    Возвраты:
    текущий режим для прогрессивного кодирования.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает прогрессивное кодирование.
    См. Также:
    setProgressiveMode(int)
  - canWriteCompressed
```
public boolean canWriteCompressed()
```
    Возвраты true если этот писатель поддерживает сжатие.
    
    Возвраты:
    true если писатель поддерживает сжатие.
  - setCompressionMode
```
public void setCompressionMode(int mode)
```
    Определяет, должно ли сжатие быть выполнено, и раз так как должны быть определены параметры сжатия. mode параметром должен быть один из этих четырех режимов, интерпретируемых следующим образом:
    - MODE_DISABLED - Если режим устанавливается в MODE_DISABLED, методы, которые запрашивают или изменяют тип сжатия или параметры, бросят IllegalStateException (если сжатие обычно поддерживается плагином). Некоторые писатели, такие как JPEG, обычно не предлагают несжатый, выводят. В этом случае, пытаясь установить режим в MODE_DISABLED бросит UnsupportedOperationException и режим не будет изменен.
    - MODE_EXPLICIT - Сжатие используя тип сжатия и качественные настройки определяется в этом ImageWriteParam. Отбрасываются любые ранее установленные параметры сжатия.
    - MODE_COPY_FROM_METADATA - Использование любые параметры сжатия определяется в объектах метаданных, которые передают в писателю.
    - MODE_DEFAULT - Используйте параметры сжатия по умолчанию.
    Значение по умолчанию MODE_COPY_FROM_METADATA.
    Параметры:
    mode - Режим для того, чтобы установить сжатие в потоке вывода.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие, или не поддерживает требуемый режим.
    
    IllegalArgumentException - если mode не один из упомянутых выше режимов.
    См. Также:
    getCompressionMode()
  - getCompressionMode
```
public int getCompressionMode()
```
    Возвращает текущий режим сжатия, если сжатие поддерживается.
    
    Возвраты:
    текущий режим сжатия.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    См. Также:
    setCompressionMode(int)
  - getCompressionTypes
```
public String[] getCompressionTypes()
```
    Возвращает список доступных типов сжатия, как массив или Strings, или null если тип сжатия не может быть выбран, используя эти интерфейсы. Массив возвратился, копия.
    Если писатель только предлагает единственную, обязательную форму сжатия, не необходимо обеспечить любые именованные типы сжатия. Названный типами сжатия должен только использоваться, где пользователь в состоянии сделать значимый выбор между различными схемами.
    Проверки реализации по умолчанию, если сжатие поддерживается и бросает UnsupportedOperationException если нет. Иначе, это возвращает клона compressionTypes переменная экземпляра, если это не -null, или иначе возвраты null.
    
    Возвраты:
    массив Strings содержащий (нелокализованные) имена доступных типов сжатия, или null.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
  - setCompressionType
```
public void setCompressionType(String compressionType)
```
    Устанавливает тип сжатия в одно из значений, обозначенных getCompressionTypes. Если значение null в передают, любая предыдущая установка удаляется.
    Реализация по умолчанию проверяет, поддерживается ли сжатие, и режим сжатия MODE_EXPLICIT. Если так, это вызывает getCompressionTypes и проверки, если compressionType одно из юридических значений. Если это, compressionType переменная экземпляра устанавливается. Если compressionType null, переменная экземпляра устанавливается, не выполняя проверки.
    
    Параметры:
    compressionType - один из Strings возвращенный getCompressionTypes, или null удалить любую предыдущую установку.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    UnsupportedOperationException - если нет никаких устанавливаемых типов сжатия.
    
    IllegalArgumentException - если compressionType не -null но не одно из значений, возвращенных getCompressionTypes.
    См. Также:
    getCompressionTypes(), getCompressionType(), unsetCompression()
  - getCompressionType
```
public String getCompressionType()
```
    Возвращается в настоящий момент тип сжатия набора, или null если ни один не был установлен. Тип возвращается как a String из числа возвращенных getCompressionTypes. Если никакой тип сжатия не был установлен, null возвращается.
    Реализация по умолчанию проверяет, поддерживается ли сжатие, и режим сжатия MODE_EXPLICIT. Если так, это возвращает значение compressionType переменная экземпляра.
    
    Возвраты:
    текущее сжатие вводит как a String, или null если никакой тип не устанавливается.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    См. Также:
    setCompressionType(java.lang.String)
  - unsetCompression
```
public void unsetCompression()
```
    Удаляет любой предыдущий тип сжатия и качественные настройки.
    Реализация по умолчанию устанавливает переменную экземпляра compressionType к null, и переменная экземпляра compressionQuality к 1.0F.
    
    Броски:
    
    UnsupportedOperationException - если плагин не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    См. Также:
    setCompressionType(java.lang.String), setCompressionQuality(float)
  - getLocalizedCompressionTypeName
```
public String getLocalizedCompressionTypeName()
```
    Возвращает локализованную версию имени текущего типа сжатия, используя Locale возвращенный getLocale.
    Реализация по умолчанию проверяет, поддерживается ли сжатие, и режим сжатия MODE_EXPLICIT. Если так, если compressionType non-null значение getCompressionType возвращается как удобство.
    
    Возвраты:
    a String содержа локализованную версию имени текущего типа сжатия.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если никакой тип сжатия не устанавливается.
  - isCompressionLossless
```
public boolean isCompressionLossless()
```
    Возвраты true если текущий тип сжатия обеспечивает сжатие без потерь. Если плагин обеспечивает только один обязательный тип сжатия, то этот метод можно вызвать без вызова setCompressionType сначала.
    Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.
    Реализация по умолчанию проверяет, поддерживается ли сжатие, и режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null true возвращается как удобство.
    
    Возвраты:
    true если текущий тип сжатия без потерь.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если набор юридических типов сжатия не -null и текущий тип сжатия null.
  - setCompressionQuality
```
public void setCompressionQuality(float quality)
```
    Устанавливает качество сжатия в значение между 0 и 1. Только единственная качественная установка сжатия поддерживается по умолчанию; писатели могут обеспечить расширенные версии ImageWriteParam то предложение больше управления. Для схем сжатия с потерями качество сжатия должно управлять компромиссом между размером файла и качеством изображения (например, выбирая таблицы квантования при записи изображений JPEG). Для схем без потерь качество сжатия может использоваться, чтобы управлять компромиссом между размером файла и время, потраченное, чтобы выполнить сжатие (например, оптимизируя горизонтальные фильтры и устанавливая уровень сжатия ZLIB при записи изображений PNG).
    Качественная установка сжатия 0.0 наиболее в общем интерпретируется, поскольку "высокое сжатие важно,", в то время как установка 1.0 наиболее в общем интерпретируется, поскольку "высокое качество изображения важно."
    Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.
    Реализация по умолчанию проверяет, что сжатие поддерживается, и что режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() возвраты null или compressionType не -null это устанавливает compressionQuality переменная экземпляра.
    
    Параметры:
    quality - a float между 0и 1 указание на требуемый уровень качества.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если набор юридических типов сжатия не -null и текущий тип сжатия null.
    
    IllegalArgumentException - если quality не между 0и 1, включительно.
    См. Также:
    getCompressionQuality()
  - getCompressionQuality
```
public float getCompressionQuality()
```
    Возвращает текущую качественную установку сжатия.
    Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.
    Реализация по умолчанию проверяет, что сжатие поддерживается и что режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null, это возвращает значение compressionQuality переменная экземпляра.
    
    Возвраты:
    текущая качественная установка сжатия.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если набор юридических типов сжатия не -null и текущий тип сжатия null.
    См. Также:
    setCompressionQuality(float)
  - getBitRate
```
public float getBitRate(float quality)
```
    Возвраты a float указание на оценку числа битов выходных данных для каждого бита ввода отображает данные на данном уровне качества. Значение будет обычно находиться между 0 и 1, с меньшими значениями, указывающими на больше сжатия. Специальное значение -1.0F используется, чтобы указать, что никакая оценка не доступна.
    Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.
    Реализация по умолчанию проверяет, что сжатие поддерживается, и режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null, и quality в пределах границ, это возвращается -1.0.
    
    Параметры:
    quality - качественная установка, битрейт которой должен быть запрошен.
    
    Возвраты:
    оценка сжатого битрейта, или -1.0F если никакая оценка не доступна.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если набор юридических типов сжатия не -null и текущий тип сжатия null.
    
    IllegalArgumentException - если quality не между 0и 1, включительно.
  - getCompressionQualityDescriptions
```
public String[] getCompressionQualityDescriptions()
```
    Возвращает массив 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.
    
    Возвраты:
    массив Strings содержащий локализованные описания уровней качества сжатия.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если набор юридических типов сжатия не -null и текущий тип сжатия null.
    См. Также:
    getCompressionQualityValues()
  - getCompressionQualityValues
```
public float[] getCompressionQualityValues()
```
    Возвращает массив floats, который может использоваться наряду с getCompressionQualityDescriptions как часть пользовательского интерфейса для установки или отображения уровня качества сжатия. См. getCompressionQualityDescriptions для получения дополнительной информации.
    Если никакие описания не доступны, null возвращается. Если null возвращается из getCompressionQualityDescriptions, этот метод должен также возвратиться null.
    Если есть многократные типы сжатия, но ни один не был установлен, IllegalStateException бросается.
    Реализация по умолчанию проверяет, что сжатие поддерживается и что режим сжатия MODE_EXPLICIT. Если так, если getCompressionTypes() null или getCompressionType() не -null, это возвращается null.
    
    Возвраты:
    массив floats указание на границы между уровнями качества сжатия как описано Strings от getCompressionQualityDescriptions.
    
    Броски:
    
    UnsupportedOperationException - если писатель не поддерживает сжатие.
    
    IllegalStateException - если режим сжатия не MODE_EXPLICIT.
    
    IllegalStateException - если набор юридических типов сжатия не -null и текущий тип сжатия null.
    См. Также:
    getCompressionQualityDescriptions()

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

Класс ImageWriteParam

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

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

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

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

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

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

Полевая Деталь

MODE_DISABLED

MODE_DEFAULT

MODE_EXPLICIT

MODE_COPY_FROM_METADATA

canWriteTiles

tilingMode

preferredTileSizes

tilingSet

tileWidth

tileHeight

canOffsetTiles

tileGridXOffset

tileGridYOffset

canWriteProgressive

progressiveMode

canWriteCompressed

compressionMode

compressionTypes

compressionType

compressionQuality

локаль

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

ImageWriteParam

ImageWriteParam

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

getLocale

canWriteTiles

canOffsetTiles

setTilingMode

getTilingMode

getPreferredTileSizes

setTiling

unsetTiling

getTileWidth

getTileHeight

getTileGridXOffset

getTileGridYOffset

canWriteProgressive

setProgressiveMode

getProgressiveMode

canWriteCompressed

setCompressionMode

getCompressionMode

getCompressionTypes

setCompressionType

getCompressionType

unsetCompression

getLocalizedCompressionTypeName

isCompressionLossless

setCompressionQuality

getCompressionQuality

getBitRate

getCompressionQualityDescriptions

getCompressionQualityValues