ImageReader (Платформа Java SE 8 b92)

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

```
public abstract class ImageReader
extends Object
```
Абстрактный суперкласс для парсинга и декодирования изображений. Этот class должен быть разделен на подклассы классами, которые читают в изображениях в контексте платформы ввода-вывода Изображения Java.
ImageReader объекты обычно инстанцирует интерфейс поставщика услуг (SPI) class для определенного формата. Классы поставщика услуг (например, экземпляры ImageReaderSpi) регистрируются в IIORegistry, который использует их для распознавания формата и представления читателей доступного формата и писателей.
Когда входной источник устанавливается (использование setInput метод), это может быть отмечено, поскольку "ищут вперед только". Эта установка означает, что изображения, содержавшие в пределах входного источника, будут только считаны в порядке, возможно разрешая читателю избежать кэшировать части ввода, содержащего данные, связанные с изображениями, которые были считаны ранее.

См. Также:

ImageWriter, IIORegistry, ImageReaderSpi

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

Поля
Модификатор и Тип	Поле и Описание
`protected Locale[]`	`availableLocales` Массив `Locale`s, который может использоваться, чтобы локализовать предупреждающие сообщения, или `null` если локализация не поддерживается.
`protected boolean`	`ignoreMetadata` `true` если текущий входной источник был отмечен как разрешение метаданных быть проигнорированным `setInput`.
`protected Object`	`ввод` `ImageInputStream` или другой `Object` `setInput` и полученный `getInput`.
`protected Locale`	`локаль` Ток `Locale` использоваться для локализации, или `null` если ни один не был установлен.
`protected int`	`minIndex` Самые маленькие допустимые индексируют для того, чтобы читать, первоначально 0.
`protected ImageReaderSpi`	`originatingProvider` `ImageReaderSpi` это инстанцировало этого объекта, или `null` если его идентификационные данные не известны, или ни один не существует.
`protected List<IIOReadProgressListener>`	`progressListeners` A `List` из в настоящий момент зарегистрированного `IIOReadProgressListener`s, инициализированный по умолчанию к `null`, который синонимичен с пустым `List`.
`protected boolean`	`seekForwardOnly` `true` если текущий входной источник был отмечен, поскольку разрешение только передает поиск `setInput`.
`protected List<IIOReadUpdateListener>`	`updateListeners` A `List` из в настоящий момент зарегистрированного `IIOReadUpdateListener`s, инициализированный по умолчанию к `null`, который синонимичен с пустым `List`.
`protected List<IIOReadWarningListener>`	`warningListeners` A `List` из в настоящий момент зарегистрированного `IIOReadWarningListener`s, инициализированный по умолчанию к `null`, который синонимичен с пустым `List`.
`protected List<Locale>`	`warningLocales` A `List` из `Locale`s связанный с каждым в настоящий момент зарегистрированным `IIOReadWarningListener`, инициализированный по умолчанию к `null`, который синонимичен с пустым `List`.

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`ImageReader(ImageReaderSpi originatingProvider)` Конструкции `ImageReader` и наборы `originatingProvider` поле к предоставленному значению.

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

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`abort()` Запросы, что любая текущая операция чтения быть прерванным.
`protected boolean`	`abortRequested()` Возвраты `true` если с просьбой, чтобы прервать текущую операцию чтения обратились, так как читатель инстанцировали или `clearAbortRequest` был вызван.
`void`	`addIIOReadProgressListener(IIOReadProgressListener listener)` Добавляет `IIOReadProgressListener` к списку зарегистрированных слушателей продвижения.
`void`	`addIIOReadUpdateListener(IIOReadUpdateListener listener)` Добавляет `IIOReadUpdateListener` к списку зарегистрированных слушателей обновления.
`void`	`addIIOReadWarningListener(IIOReadWarningListener listener)` Добавляет `IIOReadWarningListener` к списку зарегистрированных слушателей предупреждения.
`boolean`	`canReadRaster()` Возвраты `true` если этот плагин поддерживает чтение только a `Raster` из пиксельных данных.
`protected static void`	`checkReadParamBandSettings(ImageReadParam param, int numSrcBands, int numDstBands)` Служебный метод, который может использоваться читателями, чтобы протестировать законность источника и целевые настройки полосы `ImageReadParam`.
`protected void`	`clearAbortRequest()` Очищает любой предыдущий запрос аварийного прекращения работы.
`protected static void`	`computeRegions(ImageReadParam param, int srcWidth, int srcHeight, BufferedImage image, Rectangle srcRegion, Rectangle destRegion)` Вычисляет исходную область интереса и целевую область интереса, беря width и height исходного изображения, дополнительного целевого изображения, и дополнительного `ImageReadParam` во внимание.
`void`	`dispose()` Позволяет любые ресурсы, которые, как сохранил этот объект, были выпущены.
`float`	`getAspectRatio(int imageIndex)` Возвращает формат изображения данного изображения (то есть, его width, разделенный на его height) как a `float`.
`Локаль[]`	`getAvailableLocales()` Возвращает массив `Locale`s, который может использоваться, чтобы локализовать предупреждение настройки сжатия и слушатели.
`ImageReadParam`	`getDefaultReadParam()` Возвращает значение по умолчанию `ImageReadParam` возразите соответствующий для этого формата.
`protected static BufferedImage`	`getDestination(ImageReadParam param, Iterator<ImageTypeSpecifier> imageTypes, int width, int height)` Возвраты `BufferedImage` которому декодируемые пиксельные данные должны быть записаны.
`Строка`	`getFormatName()` Возвраты a `String` идентификация формата входного источника.
`abstract int`	`getHeight(int imageIndex)` Возвращает height в пикселях данного изображения в пределах входного источника.
`abstract IIOMetadata`	`getImageMetadata(int imageIndex)` Возвраты `IIOMetadata` объект, содержащий метаданные, связанные с данным изображением, или `null` если читатель не поддерживает метаданные чтения, устанавливается проигнорировать метаданные, или если никакие метаданные не доступны.
`IIOMetadata`	`getImageMetadata(int imageIndex, String formatName, Set<String> nodeNames)` Возвраты `IIOMetadata` объект, представляющий метаданные, связанные с данным изображением, или `null` если читатель не поддерживает метаданные чтения, или ни один не доступен.
`abstract Iterator<ImageTypeSpecifier>`	`getImageTypes(int imageIndex)` Возвраты `Iterator` содержа возможное изображение вводит, к которому данное изображение может декодироваться в форме `ImageTypeSpecifiers`s.
`Объект`	`getInput()` Возвраты `ImageInputStream` или другой `Object` ранее набор как входной источник.
`Локаль`	`getLocale()` Возвращается в настоящий момент набор `Locale`, или `null` если ни один не был установлен.
`int`	`getMinIndex()` Возвращается самые низкие допустимые индексируют для того, чтобы считать изображение, миниатюру, или отображают метаданные.
`abstract int`	`getNumImages(boolean allowSearch)` Возвращает число изображений, не включая миниатюры, доступные из текущего входного источника.
`int`	`getNumThumbnails(int imageIndex)` Возвращает число изображений предварительного просмотра миниатюры, связанных с данным изображением.
`ImageReaderSpi`	`getOriginatingProvider()` Возвраты `ImageReaderSpi` в этом передали на конструкторе.
`ImageTypeSpecifier`	`getRawImageType(int imageIndex)` Возвраты `ImageTypeSpecifier` указание `SampleModel` и `ColorModel` который наиболее близко представляет "необработанный" внутренний формат изображения.
`protected static Rectangle`	`getSourceRegion(ImageReadParam param, int srcWidth, int srcHeight)` Служебный метод, который может использоваться читателями, чтобы вычислить область исходного изображения, которое должно быть считано, принимая во внимание любую исходную область и настройки смещения подвыборки в предоставленном `ImageReadParam`.
`abstract IIOMetadata`	`getStreamMetadata()` Возвраты `IIOMetadata` объект, представляющий метаданные, связанные с входным источником в целом (то есть, не связанный с любым определенным изображением), или `null` если читатель не поддерживает метаданные чтения, устанавливается проигнорировать метаданные, или если никакие метаданные не доступны.
`IIOMetadata`	`getStreamMetadata(String formatName, Set<String> nodeNames)` Возвраты `IIOMetadata` объект, представляющий метаданные, связанные с входным источником в целом (то есть, не связанный с любым определенным изображением).
`int`	`getThumbnailHeight(int imageIndex, int thumbnailIndex)` Возвращает height изображения предварительного просмотра миниатюры, индексированного `thumbnailIndex`, связанный с изображением, индексированным `ImageIndex`.
`int`	`getThumbnailWidth(int imageIndex, int thumbnailIndex)` Возвращает width изображения предварительного просмотра миниатюры, индексированного `thumbnailIndex`, связанный с изображением, индексированным `ImageIndex`.
`int`	`getTileGridXOffset(int imageIndex)` Возвращает X координат верхнего левого угла мозаики (0, 0) в данном изображении.
`int`	`getTileGridYOffset(int imageIndex)` Возвращает координату Y верхнего левого угла мозаики (0, 0) в данном изображении.
`int`	`getTileHeight(int imageIndex)` Возвращает height мозаики в данном изображении.
`int`	`getTileWidth(int imageIndex)` Возвращает width мозаики в данном изображении.
`abstract int`	`getWidth(int imageIndex)` Возвращает width в пикселях данного изображения в пределах входного источника.
`boolean`	`hasThumbnails(int imageIndex)` Возвраты `true` если данному изображению связали изображения предварительного просмотра миниатюры с этим.
`boolean`	`isIgnoringMetadata()` Возвраты `true` если текущий входной источник был отмечен как разрешение метаданных быть проигнорированным, передавая `true` как `ignoreMetadata` параметр `setInput` метод.
`boolean`	`isImageTiled(int imageIndex)` Возвраты `true` если изображение организуется в мозаики, то есть, прямоугольники неналожения равного размера.
`boolean`	`isRandomAccessEasy(int imageIndex)` Возвраты `true` если формат хранения данного изображения не помещает свойственного препятствия в произвольный доступ к пикселям.
`boolean`	`isSeekForwardOnly()` Возвраты `true` если текущий входной источник был отмечен, как ищут вперед только, передавая `true` как `seekForwardOnly` параметр `setInput` метод.
`protected void`	`processImageComplete()` Широковещательно передает завершение чтения изображения ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `imageComplete` метод.
`protected void`	`processImageProgress(float percentageDone)` Широковещательно передает текущий процент завершения изображения ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `imageProgress` метод.
`protected void`	`processImageStarted(int imageIndex)` Широковещательно передает запуск чтения изображения ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `imageStarted` метод.
`protected void`	`processImageUpdate(BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` Широковещательно передает обновление ряда выборок ко всем зарегистрированным `IIOReadUpdateListener`s, вызывая их `imageUpdate` метод.
`protected void`	`processPassComplete(BufferedImage theImage)` Широковещательно передает конец прогрессивной передачи во все зарегистрированные `IIOReadUpdateListener`s, вызывая их `passComplete` метод.
`protected void`	`processPassStarted(BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` Широковещательно передает начало прогрессивной передачи во все зарегистрированные `IIOReadUpdateListener`s, вызывая их `passStarted` метод.
`protected void`	`processReadAborted()` Широковещательные сообщения, что чтение было прервано ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `readAborted` метод.
`protected void`	`processSequenceComplete()` Широковещательно передает завершение последовательности чтений изображения ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `sequenceComplete` метод.
`protected void`	`processSequenceStarted(int minIndex)` Широковещательно передает запуск последовательности чтений изображения ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `sequenceStarted` метод.
`protected void`	`processThumbnailComplete()` Широковещательно передает завершение чтения миниатюры ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `thumbnailComplete` метод.
`protected void`	`processThumbnailPassComplete(BufferedImage theThumbnail)` Широковещательно передает конец миниатюры прогрессивная передача во все зарегистрированные `IIOReadUpdateListener`s, вызывая их `thumbnailPassComplete` метод.
`protected void`	`processThumbnailPassStarted(BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` Широковещательно передает начало миниатюры прогрессивная передача во все зарегистрированные `IIOReadUpdateListener`s, вызывая их `thumbnailPassStarted` метод.
`protected void`	`processThumbnailProgress(float percentageDone)` Широковещательно передает текущий процент завершения миниатюры ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `thumbnailProgress` метод.
`protected void`	`processThumbnailStarted(int imageIndex, int thumbnailIndex)` Широковещательно передает запуск чтения миниатюры ко всем зарегистрированным `IIOReadProgressListener`s, вызывая их `thumbnailStarted` метод.
`protected void`	`processThumbnailUpdate(BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` Широковещательно передает обновление ряда выборок в изображении миниатюры ко всем зарегистрированным `IIOReadUpdateListener`s, вызывая их `thumbnailUpdate` метод.
`protected void`	`processWarningOccurred(String warning)` Широковещательно передает предупреждающее сообщение ко всем зарегистрированным `IIOReadWarningListener`s, вызывая их `warningOccurred` метод.
`protected void`	`processWarningOccurred(String baseName, String keyword)` Широковещательно передает локализованное предупреждающее сообщение ко всем зарегистрированным `IIOReadWarningListener`s, вызывая их `warningOccurred` метод со строкой, взятой от a `ResourceBundle`.
`BufferedImage`	`read(int imageIndex)` Читает изображение, индексированное `imageIndex` и возвраты это как полное `BufferedImage`, использование значения по умолчанию `ImageReadParam`.
`abstract BufferedImage`	`read(int imageIndex, ImageReadParam param)` Читает изображение, индексированное `imageIndex` и возвраты это как полное `BufferedImage`, использование предоставленного `ImageReadParam`.
`IIOImage`	`readAll(int imageIndex, ImageReadParam param)` Читает изображение, индексированное `imageIndex` и возвраты `IIOImage` содержа изображение, миниатюры, и связанные метаданные изображения, используя предоставленный `ImageReadParam`.
`Iterator<IIOImage>`	`readAll(Iterator<? extends ImageReadParam> params)` Возвраты `Iterator` содержа все изображения, миниатюры, и метаданные, запускаясь при индексировании данного `getMinIndex`, из входного источника в форме `IIOImage` объекты.
`RenderedImage`	`readAsRenderedImage(int imageIndex, ImageReadParam param)` Возвраты a `RenderedImage` объект, который содержит содержание изображения, индексированного `imageIndex`.
`boolean`	`readerSupportsThumbnails()` Возвраты `true` если формат изображения, понятый под этим читателем, поддерживает изображения предварительного просмотра миниатюры, связанные с этим.
`Растр`	`readRaster(int imageIndex, ImageReadParam param)` Возвращает новое `Raster` объект, содержащий необработанные пиксельные данные от потока изображения, без любого цветного преобразования, применялся.
`BufferedImage`	`readThumbnail(int imageIndex, int thumbnailIndex)` Возвращает изображение предварительного просмотра миниатюры, индексированное `thumbnailIndex`, связанный с изображением, индексированным `ImageIndex` как a `BufferedImage`.
`BufferedImage`	`readTile(int imageIndex, int tileX, int tileY)` Читает мозаику, обозначенную `tileX` и `tileY` параметры, возвращая это как a `BufferedImage`.
`Растр`	`readTileRaster(int imageIndex, int tileX, int tileY)` Возвращает новое `Raster` объект, содержащий необработанные пиксельные данные от мозаики, без любого цветного преобразования, применялся.
`void`	`removeAllIIOReadProgressListeners()` Удаляет все в настоящий момент зарегистрировались `IIOReadProgressListener` объекты.
`void`	`removeAllIIOReadUpdateListeners()` Удаляет все в настоящий момент зарегистрировались `IIOReadUpdateListener` объекты.
`void`	`removeAllIIOReadWarningListeners()` Удаляет все в настоящий момент зарегистрировались `IIOReadWarningListener` объекты.
`void`	`removeIIOReadProgressListener(IIOReadProgressListener listener)` Удаляет `IIOReadProgressListener` от списка зарегистрированных слушателей продвижения.
`void`	`removeIIOReadUpdateListener(IIOReadUpdateListener listener)` Удаляет `IIOReadUpdateListener` от списка зарегистрированных слушателей обновления.
`void`	`removeIIOReadWarningListener(IIOReadWarningListener listener)` Удаляет `IIOReadWarningListener` от списка зарегистрированных ошибочных слушателей.
`void`	`reset()` Восстановления `ImageReader` к его начальному состоянию.
`void`	`setInput(Object input)` Устанавливает входной источник, чтобы использовать для данного `ImageInputStream` или другой `Object`.
`void`	`setInput(Object input, boolean seekForwardOnly)` Устанавливает входной источник, чтобы использовать для данного `ImageInputStream` или другой `Object`.
`void`	`setInput(Object input, boolean seekForwardOnly, boolean ignoreMetadata)` Устанавливает входной источник, чтобы использовать для данного `ImageInputStream` или другой `Object`.
`void`	`setLocale(Locale locale)` Устанавливает ток `Locale` из этого `ImageReader` к данному значению.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - originatingProvider
```
protected ImageReaderSpi originatingProvider
```
    ImageReaderSpi это инстанцировало этого объекта, или null если его идентификационные данные не известны, или ни один не существует. По умолчанию это инициализируется к null.
  - ввод
```
protected Object input
```
    ImageInputStream или другой Object setInput и полученный getInput. По умолчанию это инициализируется к null.
  - seekForwardOnly
```
protected boolean seekForwardOnly
```
    true если текущий входной источник был отмечен, поскольку разрешение только передает поиск setInput. По умолчанию значение false.
    
    См. Также:
    
    minIndex, setInput(java.lang.Object, boolean, boolean)
  - ignoreMetadata
```
protected boolean ignoreMetadata
```
    true если текущий входной источник был отмечен как разрешение метаданных быть проигнорированным setInput. По умолчанию значение false.
    
    См. Также:
    
    setInput(java.lang.Object, boolean, boolean)
  - minIndex
```
protected int minIndex
```
    Самые маленькие допустимые индексируют для того, чтобы читать, первоначально 0. Когда seekForwardOnly true, различные методы могут бросить IndexOutOfBoundsException на попытке получить доступ к партнеру данных с изображением, имеющим более низкое, индексируют.
    
    См. Также:
    
    seekForwardOnly, setInput(java.lang.Object, boolean, boolean)
  - availableLocales
```
protected Locale[] availableLocales
```
    Массив Locales, который может использоваться, чтобы локализовать предупреждающие сообщения, или null если локализация не поддерживается.
  - локаль
```
protected Locale locale
```
    Ток Locale использоваться для локализации, или null если ни один не был установлен.
  - warningListeners
```
protected List<IIOReadWarningListener> warningListeners
```
    A List из в настоящий момент зарегистрированного IIOReadWarningListeners, инициализированный по умолчанию к null, который синонимичен с пустым List.
  - warningLocales
```
protected List<Locale> warningLocales
```
    A List из Locales связанный с каждым в настоящий момент зарегистрированным IIOReadWarningListener, инициализированный по умолчанию к null, который синонимичен с пустым List.
  - progressListeners
```
protected List<IIOReadProgressListener> progressListeners
```
    A List из в настоящий момент зарегистрированного IIOReadProgressListeners, инициализированный по умолчанию к null, который синонимичен с пустым List.
  - updateListeners
```
protected List<IIOReadUpdateListener> updateListeners
```
    A List из в настоящий момент зарегистрированного IIOReadUpdateListeners, инициализированный по умолчанию к null, который синонимичен с пустым List.
- Деталь конструктора
  - ImageReader
```
protected ImageReader(ImageReaderSpi originatingProvider)
```
    Конструкции ImageReader и наборы originatingProvider поле к предоставленному значению.
    Подклассы, которые используют расширения, должны предоставить конструктору подпись (ImageReaderSpi, Object) чтобы получить объект расширения. Если объект расширения является неподходящим, IllegalArgumentException должен быть брошен.
    
    Параметры:
    
    originatingProvider - ImageReaderSpi это вызывает этого конструктора, или null.
- Деталь метода
  - getFormatName
```
public String getFormatName()
                     throws IOException
```
    Возвраты a String идентификация формата входного источника.
    Возвраты реализации по умолчанию originatingProvider.getFormatNames()[0]. Реализации, у которых, возможно, нет инициирующего поставщика услуг, или которые требуют различной политики именования, должны переопределить этот метод.
    
    Возвраты:
    
    имя формата, как a String.
    
    Броски:
    
    IOException - если ошибка происходит, читая информацию из входного источника.
  - getOriginatingProvider
```
public ImageReaderSpi getOriginatingProvider()
```
    Возвраты ImageReaderSpi в этом передали на конструкторе. Отметьте, что это значение может быть null.
    
    Возвраты:
    
    ImageReaderSpi, или null.
    
    См. Также:
    
    ImageReaderSpi
  - setInput
```
public void setInput(Object input,
                     boolean seekForwardOnly,
                     boolean ignoreMetadata)
```
    Устанавливает входной источник, чтобы использовать для данного ImageInputStream или другой Object. Входной источник должен быть установлен перед любым запросом или читать, методы используются. Если input null, любой в настоящий момент входной источник набора будет удален. В любом случае, значение minIndex будет инициализирован к 0.
    seekForwardOnly параметр управляет ли значение, возвращенное getMinIndex будет увеличен, поскольку каждое изображение (или миниатюра, или метаданные изображения) читается. Если seekForwardOnly истина, затем звонок read(index) бросит IndexOutOfBoundsException если index < this.minIndex; иначе, значение minIndex будет установлен в index. Если seekForwardOnly false, значение minIndex останется 0 независимо от любых операций чтения.
    ignoreMetadata параметр, если установлено в true, позволяет читателю игнорировать любые метаданные, с которыми встречаются во время чтения. Последующие звонки getStreamMetadata и getImageMetadata методы могут возвратиться null, и IIOImage возвращенный из readAll может возвратиться null от их getMetadata метод. Устанавливание этих параметров может позволить читателю работать более эффективно. Читатель может хотеть игнорировать эти метаданные установки и возврата обычно.
    Подклассы должны заботиться, чтобы удалить любую кэшируемую информацию, основанную на предыдущем потоке, таком как информация о заголовке или частично декодируемые данные изображения.
    Использование генерала Object кроме ImageInputStream предназначается для читателей, которые взаимодействуют непосредственно с устройством получения или протоколом обработки изображений. Набор юридических классов рекламируется поставщиком услуг читателя getInputTypes метод; большинство читателей возвратит одноэлементный массив, содержащий только ImageInputStream.class указать, что они принимают только ImageInputStream.
    Реализация по умолчанию проверяет input параметр против списка, возвращенного originatingProvider.getInputTypes() и сбои, если параметром не является экземпляр одного из классов в списке. Если инициирующий провайдер устанавливается в null, ввод принимается, только если это ImageInputStream.
    
    Параметры:
    
    input - ImageInputStream или другой Object использовать для будущего декодирования.
    
    seekForwardOnly - если true, изображения и метаданные могут только быть считаны в порядке возрастания из этого входного источника.
    
    ignoreMetadata - если true, метаданные могут быть проигнорированы во время чтений.
    
    Броски:
    
    IllegalArgumentException - если input не экземпляр одного из классов, возвращенных инициирующим поставщиком услуг getInputTypes метод, или не ImageInputStream.
    
    См. Также:
    
    ImageInputStream, getInput(), ImageReaderSpi.getInputTypes()
  - setInput
```
public void setInput(Object input,
                     boolean seekForwardOnly)
```
    Устанавливает входной источник, чтобы использовать для данного ImageInputStream или другой Object. Входной источник должен быть установлен перед любым запросом или читать, методы используются. Если input null, любой в настоящий момент входной источник набора будет удален. В любом случае, значение minIndex будет инициализирован к 0.
    seekForwardOnly параметр управляет ли значение, возвращенное getMinIndex будет увеличен, поскольку каждое изображение (или миниатюра, или метаданные изображения) читается. Если seekForwardOnly истина, затем звонок read(index) бросит IndexOutOfBoundsException если index < this.minIndex; иначе, значение minIndex будет установлен в index. Если seekForwardOnly false, значение minIndex останется 0 независимо от любых операций чтения.
    Этот метод эквивалентен setInput(input, seekForwardOnly, false).
    
    Параметры:
    
    input - ImageInputStream или другой Object использовать для будущего декодирования.
    
    seekForwardOnly - если true, изображения и метаданные могут только быть считаны в порядке возрастания из этого входного источника.
    
    Броски:
    
    IllegalArgumentException - если input не экземпляр одного из классов, возвращенных инициирующим поставщиком услуг getInputTypes метод, или не ImageInputStream.
    
    См. Также:
    
    getInput()
  - setInput
```
public void setInput(Object input)
```
    Устанавливает входной источник, чтобы использовать для данного ImageInputStream или другой Object. Входной источник должен быть установлен перед любым запросом или читать, методы используются. Если input null, любой в настоящий момент входной источник набора будет удален. В любом случае, значение minIndex будет инициализирован к 0.
    Этот метод эквивалентен setInput(input, false, false).
    
    Параметры:
    
    input - ImageInputStream или другой Object использовать для будущего декодирования.
    
    Броски:
    
    IllegalArgumentException - если input не экземпляр одного из классов, возвращенных инициирующим поставщиком услуг getInputTypes метод, или не ImageInputStream.
    
    См. Также:
    
    getInput()
  - getInput
```
public Object getInput()
```
    Возвраты ImageInputStream или другой Object ранее набор как входной источник. Если входной источник не был установлен, null возвращается.
    
    Возвраты:
    
    Object это будет использоваться для будущего декодирования, или null.
    
    См. Также:
    
    ImageInputStream, setInput(java.lang.Object, boolean, boolean)
  - isSeekForwardOnly
```
public boolean isSeekForwardOnly()
```
    Возвраты true если текущий входной источник был отмечен, как ищут вперед только, передавая true как seekForwardOnly параметр setInput метод.
    
    Возвраты:
    
    true если входной источник, ищут вперед только.
    
    См. Также:
    
    setInput(java.lang.Object, boolean, boolean)
  - isIgnoringMetadata
```
public boolean isIgnoringMetadata()
```
    Возвраты true если текущий входной источник был отмечен как разрешение метаданных быть проигнорированным, передавая true как ignoreMetadata параметр setInput метод.
    
    Возвраты:
    
    true если метаданные могут быть проигнорированы.
    
    См. Также:
    
    setInput(java.lang.Object, boolean, boolean)
  - getMinIndex
```
public int getMinIndex()
```
    Возвращается самые низкие допустимые индексируют для того, чтобы считать изображение, миниатюру, или отображают метаданные. Если seekForwardOnly() false, это значение будет обычно оставаться 0, указывая, что произвольный доступ возможен. Иначе, это будет содержать значение последний раз полученный доступ, индексируют, и увеличение монотонного вида.
    
    Возвраты:
    
    законный минимум индексирует для того, чтобы читать.
  - getAvailableLocales
```
public Locale[] getAvailableLocales()
```
    Возвращает массив Locales, который может использоваться, чтобы локализовать предупреждение настройки сжатия и слушатели. Возвращаемое значение null указывает, что локализация не поддерживается.
    Реализация по умолчанию возвращает клона availableLocales переменная экземпляра, если это не -null, или иначе возвраты null.
    
    Возвраты:
    
    массив Locales, который может использоваться в качестве параметров setLocale, или null.
  - setLocale
```
public void setLocale(Locale locale)
```
    Устанавливает ток Locale из этого ImageReader к данному значению. Значение null удаляет любую предыдущую установку, и указывает, что читатель должен локализовать, как она считает целесообразным.
    
    Параметры:
    
    locale - требуемый Locale, или null.
    
    Броски:
    
    IllegalArgumentException - если locale не -null но не одно из значений, возвращенных getAvailableLocales.
    
    См. Также:
    
    getLocale()
  - getLocale
```
public Locale getLocale()
```
    Возвращается в настоящий момент набор Locale, или null если ни один не был установлен.
    
    Возвраты:
    
    ток Locale, или null.
    
    См. Также:
    
    setLocale(java.util.Locale)
  - getNumImages
```
public abstract int getNumImages(boolean allowSearch)
                          throws IOException
```
    Возвращает число изображений, не включая миниатюры, доступные из текущего входного источника.
    Отметьте, что некоторые форматы изображения (такие как анимированный ДЖИФ) не определяют, сколько изображений присутствует в потоке. Таким образом определение числа изображений потребует, чтобы весь поток был отсканирован, и может потребовать памяти для того, чтобы буферизовать. Если изображения должны быть обработаны в порядке, может быть более эффективно просто вызвать read с увеличивающимися индексами до IndexOutOfBoundsException бросается, чтобы указать, что больше изображений не доступно. allowSearch параметры могут быть установлены к false указать, что исчерпывающий поиск не требуется; возвращаемое значение будет -1 указать, что поиск необходим. Если ввод был определен с seekForwardOnly набор к true, этот метод бросает IllegalStateException если allowSearch устанавливается в true.
    
    Параметры:
    
    allowSearch - если true, истинное число изображений будет возвращено, даже если поиск будет требоваться. Если false, читатель может возвратиться -1 не выполняя поиск.
    
    Возвраты:
    
    число изображений, как int, или -1 если allowSearch false и поиск требовался бы.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен, или если ввод был определен с seekForwardOnly набор к true.
    
    IOException - если ошибка происходит, читая информацию из входного источника.
    
    См. Также:
    
    setInput(java.lang.Object, boolean, boolean)
  - getWidth
```
public abstract int getWidth(int imageIndex)
                      throws IOException
```
    Возвращает width в пикселях данного изображения в пределах входного источника.
    Если изображение может быть представлено к определенному пользователем размеру, то этот метод возвращает значение по умолчанию width.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    width изображения, как int.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит, читая информацию о width из входного источника.
  - getHeight
```
public abstract int getHeight(int imageIndex)
                       throws IOException
```
    Возвращает height в пикселях данного изображения в пределах входного источника.
    Если изображение может быть представлено к определенному пользователем размеру, то этот метод возвращает значение по умолчанию height.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    height изображения, как int.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит, читая информацию о height из входного источника.
  - isRandomAccessEasy
```
public boolean isRandomAccessEasy(int imageIndex)
                           throws IOException
```
    Возвраты true если формат хранения данного изображения не помещает свойственного препятствия в произвольный доступ к пикселям. Для наиболее сжатых форматов, таких как JPEG, должен возвратиться этот метод false, поскольку большой раздел изображения в дополнение к области интереса, возможно, должен декодироваться.
    Это - просто подсказка для программ, которые хотят быть эффективными; все читатели должны быть в состоянии считать произвольные области как определено в ImageReadParam.
    Отметьте, что форматирует тот возврат false от этого метода может, тем не менее, позволить размещать рядом (например, Маркеры Перезапуска в JPEG), и произвольный доступ, вероятно, будет разумно эффективен на мозаиках. См. isImageTiled.
    Читатель, для которого все изображения, как гарантируют, будут поддерживать легкий произвольный доступ, или, как гарантируют, не будут поддерживать легкий произвольный доступ, может возвратиться true или false соответственно не получая доступ ни к каким данным изображения. В таких случаях не необходимо выдать исключение, даже если никакой входной источник не был установлен, или изображение индексируют, за пределы.
    Возвраты реализации по умолчанию false.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    true если чтение области интереса данного изображения, вероятно, будет эффективно.
    
    Броски:
    
    IllegalStateException - если входной источник обязан определять возвращаемое значение, но ни один не был установлен.
    
    IndexOutOfBoundsException - если к изображению нужно получить доступ, чтобы определить возвращаемое значение, но предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getAspectRatio
```
public float getAspectRatio(int imageIndex)
                     throws IOException
```
    Возвращает формат изображения данного изображения (то есть, его width, разделенный на его height) как a float. Для изображений, которые по сути изменяемого размера, этот метод обеспечивает способ определить соответствующий width, данный deired height, или наоборот. Для изображений неизменяемого размера используются истинный width и height.
    Реализация по умолчанию просто возвращается (float)getWidth(imageIndex)/getHeight(imageIndex).
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    a float указание на формат изображения данного изображения.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getRawImageType
```
public ImageTypeSpecifier getRawImageType(int imageIndex)
                                   throws IOException
```
    Возвраты ImageTypeSpecifier указание SampleModel и ColorModel который наиболее близко представляет "необработанный" внутренний формат изображения. Например, для изображения JPEG у необработанного типа могло бы быть цветовое пространство YCbCr даже при том, что изображение будет традиционно преобразовано в цветовое пространство RGB до дисплея. Возвращенное значение должно также быть включено в список значений, возвращенных getImageTypes.
    Реализация по умолчанию просто возвращает первую запись из списка, обеспеченного getImageType.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    ImageTypeSpecifier.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит, читая информацию о формате из входного источника.
  - getImageTypes
```
public abstract Iterator<ImageTypeSpecifier> getImageTypes(int imageIndex)
                                                    throws IOException
```
    Возвраты Iterator содержа возможное изображение вводит, к которому данное изображение может декодироваться в форме ImageTypeSpecifierss. По крайней мере один юридический тип изображения будет возвращен.
    Первый элемент iterator должен быть самым "естественным" типом для того, чтобы декодировать изображение с так небольшой потерей насколько возможно. Например, для изображения JPEG первая запись должна быть изображением RGB, даже при том, что данные изображения хранятся внутренне в цветовом пространстве YCbCr.
    
    Параметры:
    
    imageIndex - индексирование изображения, чтобы быть retrieved.
    
    Возвраты:
    
    Iterator содержа по крайней мере один ImageTypeSpecifier представление предложенного изображения вводит для того, чтобы декодировать ток, данный изображение.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит, читая информацию о формате из входного источника.
    
    См. Также:
    
    ImageReadParam.setDestination(BufferedImage), ImageReadParam.setDestinationType(ImageTypeSpecifier)
  - getDefaultReadParam
```
public ImageReadParam getDefaultReadParam()
```
    Возвращает значение по умолчанию ImageReadParam возразите соответствующий для этого формата. Все подклассы должны определить ряд значений по умолчанию для всех параметров и возвратить их с этим вызовом. Этот метод можно вызвать прежде, чем входной источник устанавливается.
    Реализация по умолчанию создает и возвращает новое ImageReadParam объект, который не позволяет исходное масштабирование (то есть, это возвращается new ImageReadParam().
    
    Возвраты:
    
    ImageReadParam объект, который может использоваться, чтобы управлять процессом декодирования, используя ряд настроек по умолчанию.
  - getStreamMetadata
```
public abstract IIOMetadata getStreamMetadata()
                                       throws IOException
```
    Возвраты IIOMetadata объект, представляющий метаданные, связанные с входным источником в целом (то есть, не связанный с любым определенным изображением), или null если читатель не поддерживает метаданные чтения, устанавливается проигнорировать метаданные, или если никакие метаданные не доступны.
    
    Возвраты:
    
    IIOMetadata объект, или null.
    
    Броски:
    
    IOException - если ошибка происходит во время чтения.
  - getStreamMetadata
```
public IIOMetadata getStreamMetadata(String formatName,
                                     Set<String> nodeNames)
                              throws IOException
```
    Возвраты IIOMetadata объект, представляющий метаданные, связанные с входным источником в целом (то есть, не связанный с любым определенным изображением). Если никакие такие данные не существуют, null возвращается.
    resuting объект метаданных только ответственен за возврат документов в формате, названном formatName. В пределах любых документов, которые возвращаются, только узлы, имена которых являются элементами nodeNames обязаны быть возвращенными. Таким образом количество обработки метаданных, сделанной читателем, может быть сведено к минимуму, основанному на том, какая информация фактически необходима.
    Если formatName не имя поддерживаемого формата метаданных, null возвращается.
    Во всех случаях законно возвратить более способный объект метаданных чем строго необходимый. Имя формата и имена узла являются просто подсказками, которые могут использоваться, чтобы уменьшить рабочую нагрузку читателя.
    Реализация по умолчанию просто возвращает результат вызова getStreamMetadata(), после проверки, что имя формата поддерживается. Если это не, null возвращается.
    
    Параметры:
    
    formatName - метаданные форматируют имя, которое может использоваться, чтобы получить документ от возвращенного IIOMetadata объект.
    
    nodeNames - a Set содержа имена узлов, которые могут содержаться в полученном документе.
    
    Возвраты:
    
    IIOMetadata объект, или null.
    
    Броски:
    
    IllegalArgumentException - если formatName null.
    
    IllegalArgumentException - если nodeNames null.
    
    IOException - если ошибка происходит во время чтения.
  - getImageMetadata
```
public abstract IIOMetadata getImageMetadata(int imageIndex)
                                      throws IOException
```
    Возвраты IIOMetadata объект, содержащий метаданные, связанные с данным изображением, или null если читатель не поддерживает метаданные чтения, устанавливается проигнорировать метаданные, или если никакие метаданные не доступны.
    
    Параметры:
    
    imageIndex - индексирование изображения, метаданные которого должны быть получены.
    
    Возвраты:
    
    IIOMetadata объект, или null.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getImageMetadata
```
public IIOMetadata getImageMetadata(int imageIndex,
                                    String formatName,
                                    Set<String> nodeNames)
                             throws IOException
```
    Возвраты IIOMetadata объект, представляющий метаданные, связанные с данным изображением, или null если читатель не поддерживает метаданные чтения, или ни один не доступен.
    resuting объект метаданных только ответственен за возврат документов в формате, названном formatName. В пределах любых документов, которые возвращаются, только узлы, имена которых являются элементами nodeNames обязаны быть возвращенными. Таким образом количество обработки метаданных, сделанной читателем, может быть сведено к минимуму, основанному на том, какая информация фактически необходима.
    Если formatName не имя поддерживаемого формата метаданных, null может быть возвращен.
    Во всех случаях законно возвратить более способный объект метаданных чем строго необходимый. Имя формата и имена узла являются просто подсказками, которые могут использоваться, чтобы уменьшить рабочую нагрузку читателя.
    Реализация по умолчанию просто возвращает результат вызова getImageMetadata(imageIndex), после проверки, что имя формата поддерживается. Если это не, null возвращается.
    
    Параметры:
    
    imageIndex - индексирование изображения, метаданные которого должны быть получены.
    
    formatName - метаданные форматируют имя, которое может использоваться, чтобы получить документ от возвращенного IIOMetadata объект.
    
    nodeNames - a Set содержа имена узлов, которые могут содержаться в полученном документе.
    
    Возвраты:
    
    IIOMetadata объект, или null.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IllegalArgumentException - если formatName null.
    
    IllegalArgumentException - если nodeNames null.
    
    IOException - если ошибка происходит во время чтения.
  - читать
```
public BufferedImage read(int imageIndex)
                   throws IOException
```
    Читает изображение, индексированное imageIndex и возвраты это как полное BufferedImage, использование значения по умолчанию ImageReadParam. Это - метод удобства, который вызывает read(imageIndex, null).
    Возвращенное изображение будет отформатировано согласно первому ImageTypeSpecifier возвращенный из getImageTypes.
    Любой зарегистрировался IIOReadProgressListener объекты будут уведомлены, вызывая их imageStarted метод, сопровождаемый звонками в их imageProgress метод как чтение прогрессирует. Наконец их imageComplete метод вызовут. IIOReadUpdateListener объекты могут быть обновлены в других случаях во время чтения, поскольку пиксели декодируются. Наконец, IIOReadWarningListener объекты получат уведомление о любых нефатальных предупреждениях, которые происходят во время декодирования.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    Возвраты:
    
    требуемая часть изображения как a BufferedImage.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - читать
```
public abstract BufferedImage read(int imageIndex,
                                   ImageReadParam param)
                            throws IOException
```
    Читает изображение, индексированное imageIndex и возвраты это как полное BufferedImage, использование предоставленного ImageReadParam.
    Фактическое BufferedImage возвращенный будет выбран, используя алгоритм, определенный getDestination метод.
    Любой зарегистрировался IIOReadProgressListener объекты будут уведомлены, вызывая их imageStarted метод, сопровождаемый звонками в их imageProgress метод как чтение прогрессирует. Наконец их imageComplete метод вызовут. IIOReadUpdateListener объекты могут быть обновлены в других случаях во время чтения, поскольку пиксели декодируются. Наконец, IIOReadWarningListener объекты получат уведомление о любых нефатальных предупреждениях, которые происходят во время декодирования.
    Набор исходных полос, которые будут считаны и целевые полосы, которые будут записаны, определяется, вызывая getSourceBands и getDestinationBands на предоставленном ImageReadParam. Если длины массивов, возвращенных этими методами, отличаются, набор исходных полос содержит индексирование больше, который индексирует самый большой доступный источник, или набор целевых полос содержит индексирование больше, чем крупнейшее юридическое место назначения индексирует, IllegalArgumentException бросается.
    Если предоставленный ImageReadParam содержит дополнительные значения установки, не поддерживаемые этим читателем (например, источник представляет размер или любые специфичные для формата настройки), они будут проигнорированы.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    param - ImageReadParam используемый, чтобы управлять процессом считывания, или null.
    
    Возвраты:
    
    требуемая часть изображения как a BufferedImage.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IllegalArgumentException - если набор источника и целевых полос, определенных param.getSourceBands и param.getDestinationBands отличайтесь по длине или включайте индексы, которые являются за пределы.
    
    IllegalArgumentException - если у получающегося изображения были бы width или height меньше чем 1.
    
    IOException - если ошибка происходит во время чтения.
  - readAll
```
public IIOImage readAll(int imageIndex,
                        ImageReadParam param)
                 throws IOException
```
    Читает изображение, индексированное imageIndex и возвраты IIOImage содержа изображение, миниатюры, и связанные метаданные изображения, используя предоставленный ImageReadParam.
    Фактическое BufferedImage ссылаемый возвращенным IIOImage будет выбран, используя алгоритм, определенный getDestination метод.
    Любой зарегистрировался IIOReadProgressListener объекты будут уведомлены, вызывая их imageStarted метод, сопровождаемый звонками в их imageProgress метод как чтение прогрессирует. Наконец их imageComplete метод вызовут. IIOReadUpdateListener объекты могут быть обновлены в других случаях во время чтения, поскольку пиксели декодируются. Наконец, IIOReadWarningListener объекты получат уведомление о любых нефатальных предупреждениях, которые происходят во время декодирования.
    Набор исходных полос, которые будут считаны и целевые полосы, которые будут записаны, определяется, вызывая getSourceBands и getDestinationBands на предоставленном ImageReadParam. Если длины массивов, возвращенных этими методами, отличаются, набор исходных полос содержит индексирование больше, который индексирует самый большой доступный источник, или набор целевых полос содержит индексирование больше, чем крупнейшее юридическое место назначения индексирует, IllegalArgumentException бросается.
    Миниатюры будут возвращены в их полноте независимо от настроек области.
    Если предоставленный ImageReadParam содержит дополнительные значения установки, не поддерживаемые этим читателем (например, источник представляет размер или любые специфичные для формата настройки), те значения будут проигнорированы.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    param - ImageReadParam используемый, чтобы управлять процессом считывания, или null.
    
    Возвраты:
    
    IIOImage содержа требуемую часть изображения, ряд миниатюр, и связанных метаданных изображения.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IllegalArgumentException - если набор источника и целевых полос, определенных param.getSourceBands и param.getDestinationBands отличайтесь по длине или включайте индексы, которые являются за пределы.
    
    IllegalArgumentException - если у получающегося изображения были бы width или height меньше чем 1.
    
    IOException - если ошибка происходит во время чтения.
  - readAll
```
public Iterator<IIOImage> readAll(Iterator<? extends ImageReadParam> params)
                           throws IOException
```
    Возвраты Iterator содержа все изображения, миниатюры, и метаданные, запускаясь при индексировании данного getMinIndex, из входного источника в форме IIOImage объекты. Iterator содержа ImageReadParam объекты предоставляются; один элемент используется для каждого изображения, считанного из входного источника, пока больше изображений не доступно. Если чтение param Iterator исчерпывает элементы, но есть все еще больше изображений, доступных из входного источника, чтение значения по умолчанию params используются для остающихся изображений.
    Если params null, чтение значения по умолчанию param будет использоваться для всех изображений.
    Фактическое BufferedImage ссылаемый возвращенным IIOImage будет выбран, используя алгоритм, определенный getDestination метод.
    Любой зарегистрировался IIOReadProgressListener объекты будут уведомлены, вызывая их sequenceStarted метод однажды. Затем, для каждого декодируемого изображения, будет звонок imageStarted, сопровождаемый звонками imageProgress поскольку чтение прогрессирует, и наконец к imageComplete. sequenceComplete метод вызовут после того, как последнее изображение декодировалось. IIOReadUpdateListener объекты могут быть обновлены в других случаях во время чтения, поскольку пиксели декодируются. Наконец, IIOReadWarningListener объекты получат уведомление о любых нефатальных предупреждениях, которые происходят во время декодирования.
    Набор исходных полос, которые будут считаны и целевые полосы, которые будут записаны, определяется, вызывая getSourceBands и getDestinationBands на предоставленном ImageReadParam. Если длины массивов, возвращенных этими методами, отличаются, набор исходных полос содержит индексирование больше, который индексирует самый большой доступный источник, или набор целевых полос содержит индексирование больше, чем крупнейшее юридическое место назначения индексирует, IllegalArgumentException бросается.
    Миниатюры будут возвращены в их полноте независимо от настроек области.
    Если любой из предоставленных ImageReadParams содержат дополнительные значения установки, не поддерживаемые этим читателем (например, источник представляет размер или любые специфичные для формата настройки), они будут проигнорированы.
    
    Параметры:
    
    params - Iterator содержа ImageReadParam объекты.
    
    Возвраты:
    
    Iterator представление содержания входного источника как IIOImages.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IllegalArgumentException - если любой не -null элемент params не ImageReadParam.
    
    IllegalArgumentException - если набор источника и целевых полос, определенных param.getSourceBands и param.getDestinationBands отличайтесь по длине или включайте индексы, которые являются за пределы.
    
    IllegalArgumentException - если у получающегося изображения были бы width или height меньше чем 1.
    
    IOException - если ошибка происходит во время чтения.
    
    См. Также:
    
    ImageReadParam, IIOImage
  - canReadRaster
```
public boolean canReadRaster()
```
    Возвраты true если этот плагин поддерживает чтение только a Raster из пиксельных данных. Если этот метод возвращается false, звонки readRaster или readTileRaster бросит UnsupportedOperationException.
    Возвраты реализации по умолчанию false.
    
    Возвраты:
    
    true если этот плагин поддерживает сырые данные чтения Rasters.
    
    См. Также:
    
    readRaster(int, javax.imageio.ImageReadParam), readTileRaster(int, int, int)
  - readRaster
```
public Raster readRaster(int imageIndex,
                         ImageReadParam param)
                  throws IOException
```
    Возвращает новое Raster объект, содержащий необработанные пиксельные данные от потока изображения, без любого цветного преобразования, применялся. Приложение должно определить, как интерпретировать пиксельные данные другими средствами. Любое место назначения или параметры типа изображения в предоставленном ImageReadParam объект игнорируется, но все другие параметры используются точно в качестве в read метод, за исключением того, что любое место назначения смещало, используется в качестве логического, а не физического смещения. Размер возвращенного Raster всегда будет та из исходной области, отсеченной к фактическому изображению. Игнорируются логические смещения в самом потоке.
    Этот метод позволяет форматы, которые обычно применяют цветное преобразование, такое как JPEG, и форматы, у которых обычно нет связанного colorspace, такого как дистанционное зондирование или медицинские данные обработки изображений, чтобы обеспечить доступ к необработанным пиксельным данным.
    Любой зарегистрировался readUpdateListeners игнорируются, поскольку есть нет BufferedImage, но всех других слушателей вызывают точно, как они для read метод.
    Если canReadRaster() возвраты false, этот метод бросает UnsupportedOperationException.
    Если предоставленный ImageReadParam содержит дополнительные значения установки, не поддерживаемые этим читателем (например, источник представляет размер или любые специфичные для формата настройки), они будут проигнорированы.
    Реализация по умолчанию бросает UnsupportedOperationException.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет считано.
    
    param - ImageReadParam используемый, чтобы управлять процессом считывания, или null.
    
    Возвраты:
    
    требуемая часть изображения как a Raster.
    
    Броски:
    
    UnsupportedOperationException - если этот плагин не поддерживает сырых данных чтения Rasters.
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
    
    См. Также:
    
    canReadRaster(), read(int), Raster
  - isImageTiled
```
public boolean isImageTiled(int imageIndex)
                     throws IOException
```
    Возвраты true если изображение организуется в мозаики, то есть, прямоугольники неналожения равного размера.
    Плагин читателя может выбрать, представить ли мозаичное размещение, которое присутствует в изображении, поскольку это сохранено. Это может даже хотеть рекламировать мозаичное размещение, когда ни один явно не присутствует. Вообще, мозаичное размещение должно только рекламироваться, если есть некоторое преимущество (в скорости или пространстве) к доступу к отдельным мозаикам. Независимо от того, рекламирует ли читатель мозаичное размещение, это должно быть способно к чтению произвольной прямоугольной области, определенной в ImageReadParam.
    Читатель, для которого все изображения, как гарантируют, будут размещены рядом, или, как гарантируют, не будут размещены рядом, может возвратиться true или false соответственно не получая доступ ни к каким данным изображения. В таких случаях не необходимо выдать исключение, даже если никакой входной источник не был установлен, или изображение индексируют, за пределы.
    Реализация по умолчанию только возвращается false.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    true если изображение размещается рядом.
    
    Броски:
    
    IllegalStateException - если входной источник обязан определять возвращаемое значение, но ни один не был установлен.
    
    IndexOutOfBoundsException - если к изображению нужно получить доступ, чтобы определить возвращаемое значение, но предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getTileWidth
```
public int getTileWidth(int imageIndex)
                 throws IOException
```
    Возвращает width мозаики в данном изображении.
    Реализация по умолчанию просто возвращается getWidth(imageIndex), который корректен для неразмещенных рядом изображений. Читатели, которые поддерживают мозаичное размещение, должны переопределить этот метод.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    width мозаики.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getTileHeight
```
public int getTileHeight(int imageIndex)
                  throws IOException
```
    Возвращает height мозаики в данном изображении.
    Реализация по умолчанию просто возвращается getHeight(imageIndex), который корректен для неразмещенных рядом изображений. Читатели, которые поддерживают мозаичное размещение, должны переопределить этот метод.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    height мозаики.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getTileGridXOffset
```
public int getTileGridXOffset(int imageIndex)
                       throws IOException
```
    Возвращает X координат верхнего левого угла мозаики (0, 0) в данном изображении.
    Читатель, для которого сетка мозаики у X смещений всегда есть то же самое значение (обычно 0), может возвратить значение, не получая доступ ни к каким данным изображения. В таких случаях не необходимо выдать исключение, даже если никакой входной источник не был установлен, или изображение индексируют, за пределы.
    Реализация по умолчанию просто возвращается 0, который корректен для неразмещенных рядом изображений и размещенных рядом изображений в большинстве форматов. Читатели, которые поддерживают мозаичное размещение с не - (0, 0) смещения, должны переопределить этот метод.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    X смещений сетки мозаики.
    
    Броски:
    
    IllegalStateException - если входной источник обязан определять возвращаемое значение, но ни один не был установлен.
    
    IndexOutOfBoundsException - если к изображению нужно получить доступ, чтобы определить возвращаемое значение, но предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getTileGridYOffset
```
public int getTileGridYOffset(int imageIndex)
                       throws IOException
```
    Возвращает координату Y верхнего левого угла мозаики (0, 0) в данном изображении.
    Читатель, для которого у сетки мозаики Y смещение всегда есть то же самое значение (обычно 0), может возвратить значение, не получая доступ ни к каким данным изображения. В таких случаях не необходимо выдать исключение, даже если никакой входной источник не был установлен, или изображение индексируют, за пределы.
    Реализация по умолчанию просто возвращается 0, который корректен для неразмещенных рядом изображений и размещенных рядом изображений в большинстве форматов. Читатели, которые поддерживают мозаичное размещение с не - (0, 0) смещения, должны переопределить этот метод.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет запрошено.
    
    Возвраты:
    
    смещение Y сетки мозаики.
    
    Броски:
    
    IllegalStateException - если входной источник обязан определять возвращаемое значение, но ни один не был установлен.
    
    IndexOutOfBoundsException - если к изображению нужно получить доступ, чтобы определить возвращаемое значение, но предоставленные индексируют, за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - readTile
```
public BufferedImage readTile(int imageIndex,
                              int tileX,
                              int tileY)
                       throws IOException
```
    Читает мозаику, обозначенную tileX и tileY параметры, возвращая это как a BufferedImage. Если параметры испытывают недостаток диапазона, IllegalArgumentException бросается. Если изображение не будет размещено рядом, то значения 0, 0 возвратят все изображение; любые другие значения вызовут IllegalArgumentException быть брошенным.
    Этот метод является просто удобством, эквивалентным вызову read(int, ImageReadParam) с чтением param specifiying исходная область, имеющая смещения tileX*getTileWidth(imageIndex), tileY*getTileHeight(imageIndex) и width и height getTileWidth(imageIndex), getTileHeight(imageIndex); и факторы подвыборки 1 и смещения 0. Чтобы подвыбрать мозаику, вызвать read с чтением param определение этой области и различных параметров подвыборки.
    Реализация по умолчанию возвращает все изображение если tileX и tileY 0, или бросает IllegalArgumentException иначе.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    tileX - столбец индексирует (запускающийся с 0) мозаики, которая будет получена.
    
    tileY - строка индексирует (запускающийся с 0) мозаики, которая будет получена.
    
    Возвраты:
    
    мозаика как a BufferedImage.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если imageIndex за пределы.
    
    IllegalArgumentException - если индексы мозаики за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - readTileRaster
```
public Raster readTileRaster(int imageIndex,
                             int tileX,
                             int tileY)
                      throws IOException
```
    Возвращает новое Raster объект, содержащий необработанные пиксельные данные от мозаики, без любого цветного преобразования, применялся. Приложение должно определить, как интерпретировать пиксельные данные другими средствами.
    Если canReadRaster() возвраты false, этот метод бросает UnsupportedOperationException.
    Реализация по умолчанию проверяет, читая Rasters поддерживается, и раз так вызывает readRaster(imageIndex, null) если tileX и tileY 0, или бросает IllegalArgumentException иначе.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    tileX - столбец индексирует (запускающийся с 0) мозаики, которая будет получена.
    
    tileY - строка индексирует (запускающийся с 0) мозаики, которая будет получена.
    
    Возвраты:
    
    мозаика как a Raster.
    
    Броски:
    
    UnsupportedOperationException - если этот плагин не поддерживает сырых данных чтения Rasters.
    
    IllegalArgumentException - если индексы мозаики за пределы.
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если imageIndex за пределы.
    
    IOException - если ошибка происходит во время чтения.
    
    См. Также:
    
    readTile(int, int, int), readRaster(int, javax.imageio.ImageReadParam), Raster
  - readAsRenderedImage
```
public RenderedImage readAsRenderedImage(int imageIndex,
                                         ImageReadParam param)
                                  throws IOException
```
    Возвраты a RenderedImage объект, который содержит содержание изображения, индексированного imageIndex. По умолчанию возвращенное изображение просто BufferedImage возвращенный read(imageIndex, param).
    Семантика этого метода может отличаться от таковых из другого read методы несколькими способами. Во-первых, любое целевое изображение и/или изображение вводят, устанавливает ImageReadParam может быть проигнорирован. Во-вторых, обычные вызовы слушателя, как гарантируют, не будут выполнены, или будут значимы, если они будут. Это - то, потому что возвращенное изображение не может быть полностью заполнено с пиксельными данными в то время, когда оно возвращается, или действительно в любое время.
    Если предоставленный ImageReadParam содержит дополнительные значения установки, не поддерживаемые этим читателем (например, источник представляет размер или любые специфичные для формата настройки), они будут проигнорированы.
    Реализация по умолчанию только вызывает read(imageIndex, param).
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    param - ImageReadParam используемый, чтобы управлять процессом считывания, или null.
    
    Возвраты:
    
    a RenderedImage объект, обеспечивающий представление изображения.
    
    Броски:
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если предоставленные индексируют, за пределы.
    
    IllegalArgumentException - если набор источника и целевых полос, определенных param.getSourceBands и param.getDestinationBands отличайтесь по длине или включайте индексы, которые являются за пределы.
    
    IllegalArgumentException - если у получающегося изображения были бы width или height меньше чем 1.
    
    IOException - если ошибка происходит во время чтения.
  - readerSupportsThumbnails
```
public boolean readerSupportsThumbnails()
```
    Возвраты true если формат изображения, понятый под этим читателем, поддерживает изображения предварительного просмотра миниатюры, связанные с этим. Возвраты реализации по умолчанию false.
    Если этот метод возвращается false, hasThumbnails и getNumThumbnails возвратится false и 0, соответственно, и readThumbnail бросит UnsupportedOperationException, независимо от их параметров.
    Читатель, который не поддерживает миниатюры, не должен реализовать ни один из связанных с миниатюрой методов.
    
    Возвраты:
    
    true если миниатюры поддерживаются.
  - hasThumbnails
```
public boolean hasThumbnails(int imageIndex)
                      throws IOException
```
    Возвраты true если данному изображению связали изображения предварительного просмотра миниатюры с этим. Если формат не поддерживает миниатюры (readerSupportsThumbnails возвраты false), false будет возвращен независимо от того, был ли входной источник установлен или ли imageIndex находится в границах.
    Возвраты реализации по умолчанию true если getNumThumbnails возвращает значение, больше чем 0.
    
    Параметры:
    
    imageIndex - индексирование запрашиваемого изображения.
    
    Возвраты:
    
    true если у данного изображения есть миниатюры.
    
    Броски:
    
    IllegalStateException - если читатель поддерживает миниатюры, но входной источник не был установлен.
    
    IndexOutOfBoundsException - если читатель поддерживает миниатюры, но imageIndex за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getNumThumbnails
```
public int getNumThumbnails(int imageIndex)
                     throws IOException
```
    Возвращает число изображений предварительного просмотра миниатюры, связанных с данным изображением. Если формат не поддерживает миниатюры, (readerSupportsThumbnails возвраты false), 0 будет возвращен независимо от того, был ли входной источник установлен или ли imageIndex находится в границах.
    Реализация по умолчанию возвращается 0, не проверяя ее параметр.
    
    Параметры:
    
    imageIndex - индексирование запрашиваемого изображения.
    
    Возвраты:
    
    число миниатюр связалось с данным изображением.
    
    Броски:
    
    IllegalStateException - если читатель поддерживает миниатюры, но входной источник не был установлен.
    
    IndexOutOfBoundsException - если читатель поддерживает миниатюры, но imageIndex за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getThumbnailWidth
```
public int getThumbnailWidth(int imageIndex,
                             int thumbnailIndex)
                      throws IOException
```
    Возвращает width изображения предварительного просмотра миниатюры, индексированного thumbnailIndex, связанный с изображением, индексированным ImageIndex.
    Если читатель не поддерживает миниатюры, (readerSupportsThumbnails возвраты false), UnsupportedOperationException будет брошен.
    Реализация по умолчанию просто возвращается readThumbnail(imageindex, thumbnailIndex).getWidth(). Подклассы должны поэтому переопределить этот метод, если возможный, чтобы избежать вынуждать миниатюру быть считанной.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    thumbnailIndex - индексирование миниатюры, которая будет получена.
    
    Возвраты:
    
    width требуемой миниатюры как int.
    
    Броски:
    
    UnsupportedOperationException - если миниатюры не поддерживаются.
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если любой из предоставленных индексов за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - getThumbnailHeight
```
public int getThumbnailHeight(int imageIndex,
                              int thumbnailIndex)
                       throws IOException
```
    Возвращает height изображения предварительного просмотра миниатюры, индексированного thumbnailIndex, связанный с изображением, индексированным ImageIndex.
    Если читатель не поддерживает миниатюры, (readerSupportsThumbnails возвраты false), UnsupportedOperationException будет брошен.
    Реализация по умолчанию просто возвращается readThumbnail(imageindex, thumbnailIndex).getHeight(). Подклассы должны поэтому переопределить этот метод, если возможный, чтобы избежать вынуждать миниатюру быть считанной.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    thumbnailIndex - индексирование миниатюры, которая будет получена.
    
    Возвраты:
    
    height требуемой миниатюры как int.
    
    Броски:
    
    UnsupportedOperationException - если миниатюры не поддерживаются.
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если любой из предоставленных индексов за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - readThumbnail
```
public BufferedImage readThumbnail(int imageIndex,
                                   int thumbnailIndex)
                            throws IOException
```
    Возвращает изображение предварительного просмотра миниатюры, индексированное thumbnailIndex, связанный с изображением, индексированным ImageIndex как a BufferedImage.
    Любой зарегистрировался IIOReadProgressListener объекты будут уведомлены, вызывая их thumbnailStarted, thumbnailProgress, и thumbnailComplete методы.
    Если читатель не поддерживает миниатюры, (readerSupportsThumbnails возвраты false), UnsupportedOperationException будет брошен независимо от того, был ли входной источник установлен или являются ли индексы в границах.
    Реализация по умолчанию бросает UnsupportedOperationException.
    
    Параметры:
    
    imageIndex - индексирование изображения, которое будет получено.
    
    thumbnailIndex - индексирование миниатюры, которая будет получена.
    
    Возвраты:
    
    требуемая миниатюра как a BufferedImage.
    
    Броски:
    
    UnsupportedOperationException - если миниатюры не поддерживаются.
    
    IllegalStateException - если входной источник не был установлен.
    
    IndexOutOfBoundsException - если любой из предоставленных индексов за пределы.
    
    IOException - если ошибка происходит во время чтения.
  - аварийное прекращение работы
```
public void abort()
```
    Запросы, что любая текущая операция чтения быть прерванным. Содержание изображения после аварийного прекращения работы будет неопределено.
    Читатели должны вызвать clearAbortRequest в начале каждой операции чтения, и опроса значение abortRequested регулярно во время чтения.
  - abortRequested
```
protected boolean abortRequested()
```
    Возвраты true если с просьбой, чтобы прервать текущую операцию чтения обратились, так как читатель инстанцировали или clearAbortRequest был вызван.
    
    Возвраты:
    
    true если текущая операция чтения должна быть прервана.
    
    См. Также:
    
    abort(), clearAbortRequest()
  - clearAbortRequest
```
protected void clearAbortRequest()
```
    Очищает любой предыдущий запрос аварийного прекращения работы. После того, как этот метод вызвали, abortRequested возвратится false.
    
    См. Также:
    
    abort(), abortRequested()
  - addIIOReadWarningListener
```
public void addIIOReadWarningListener(IIOReadWarningListener listener)
```
    Добавляет IIOReadWarningListener к списку зарегистрированных слушателей предупреждения. Если listener null, никакое исключение не будет выдано, и никакие меры не будут предприняты. Сообщения, отправленные данному слушателю, будут локализованы, если возможный, чтобы соответствовать ток Locale. Если нет Locale был установлен, предупреждающие сообщения могут быть локализованы, поскольку читатель считает целесообразным.
    
    Параметры:
    
    listener - IIOReadWarningListener быть зарегистрированным.
    
    См. Также:
    
    removeIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)
  - removeIIOReadWarningListener
```
public void removeIIOReadWarningListener(IIOReadWarningListener listener)
```
    Удаляет IIOReadWarningListener от списка зарегистрированных ошибочных слушателей. Если слушатель не был ранее зарегистрирован, или если listener null, никакое исключение не будет выдано, и никакие меры не будут предприняты.
    
    Параметры:
    
    listener - IIOReadWarningListener, чтобы быть незарегистрированным.
    
    См. Также:
    
    addIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)
  - removeAllIIOReadWarningListeners
```
public void removeAllIIOReadWarningListeners()
```
    Удаляет все в настоящий момент зарегистрировались IIOReadWarningListener объекты.
    Реализация по умолчанию устанавливает warningListeners и warningLocales переменные экземпляра к null.
  - addIIOReadProgressListener
```
public void addIIOReadProgressListener(IIOReadProgressListener listener)
```
    Добавляет IIOReadProgressListener к списку зарегистрированных слушателей продвижения. Если listener null, никакое исключение не будет выдано, и никакие меры не будут предприняты.
    
    Параметры:
    
    listener - IIOReadProgressListener, который будет зарегистрирован.
    
    См. Также:
    
    removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
  - removeIIOReadProgressListener
```
public void removeIIOReadProgressListener(IIOReadProgressListener listener)
```
    Удаляет IIOReadProgressListener от списка зарегистрированных слушателей продвижения. Если слушатель не был ранее зарегистрирован, или если listener null, никакое исключение не будет выдано, и никакие меры не будут предприняты.
    
    Параметры:
    
    listener - IIOReadProgressListener, чтобы быть незарегистрированным.
    
    См. Также:
    
    addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
  - removeAllIIOReadProgressListeners
```
public void removeAllIIOReadProgressListeners()
```
    Удаляет все в настоящий момент зарегистрировались IIOReadProgressListener объекты.
    Реализация по умолчанию устанавливает progressListeners переменная экземпляра к null.
  - addIIOReadUpdateListener
```
public void addIIOReadUpdateListener(IIOReadUpdateListener listener)
```
    Добавляет IIOReadUpdateListener к списку зарегистрированных слушателей обновления. Если listener null, никакое исключение не будет выдано, и никакие меры не будут предприняты. Слушатель получит уведомление о пиксельных обновлениях как изображения, и миниатюры декодируются, включая запуски и концы прогрессивных передач.
    Если никакие слушатели обновления не присутствуют, читатель может хотеть выполнять меньше обновлений к пикселям целевых изображений и/или миниатюр, которые могут привести к более эффективному декодированию.
    Например, в прогрессивном JPEG, декодирующем каждую передачу, содержит обновления к ряду коэффициентов, которые должны были бы быть преобразованы в пиксельные значения и преобразованы в цветовое пространство RGB для каждой передачи, если слушатели присутствуют. Если никакие слушатели не присутствуют, коэффициенты могут просто быть накоплены и преобразованные окончательные результаты и цвет, преобразованный только один раз.
    Окончательными результатами декодирования будет то же самое, выполняются ли промежуточные обновления. Таким образом, если только заключительное изображение требуется, чтобы это мог быть perferable, чтобы не зарегистрировать любого IIOReadUpdateListeners. Вообще, прогрессивное обновление является самым эффективным, выбирая изображения по сетевому соединению, которое является очень медленным по сравнению с локальной обработкой ЦП; по быстрому соединению прогрессивные обновления могут фактически замедлить представление изображения.
    
    Параметры:
    
    listener - IIOReadUpdateListener, который будет зарегистрирован.
    
    См. Также:
    
    removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)
  - removeIIOReadUpdateListener
```
public void removeIIOReadUpdateListener(IIOReadUpdateListener listener)
```
    Удаляет IIOReadUpdateListener от списка зарегистрированных слушателей обновления. Если слушатель не был ранее зарегистрирован, или если listener null, никакое исключение не будет выдано, и никакие меры не будут предприняты.
    
    Параметры:
    
    listener - IIOReadUpdateListener, чтобы быть незарегистрированным.
    
    См. Также:
    
    addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)
  - removeAllIIOReadUpdateListeners
```
public void removeAllIIOReadUpdateListeners()
```
    Удаляет все в настоящий момент зарегистрировались IIOReadUpdateListener объекты.
    Реализация по умолчанию устанавливает updateListeners переменная экземпляра к null.
  - processSequenceStarted
```
protected void processSequenceStarted(int minIndex)
```
    Широковещательно передает запуск последовательности чтений изображения ко всем зарегистрированным IIOReadProgressListeners, вызывая их sequenceStarted метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    minIndex - самые низкие индексируют быть считанным.
  - processSequenceComplete
```
protected void processSequenceComplete()
```
    Широковещательно передает завершение последовательности чтений изображения ко всем зарегистрированным IIOReadProgressListeners, вызывая их sequenceComplete метод. Подклассы могут использовать этот метод в качестве удобства.
  - processImageStarted
```
protected void processImageStarted(int imageIndex)
```
    Широковещательно передает запуск чтения изображения ко всем зарегистрированным IIOReadProgressListeners, вызывая их imageStarted метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    imageIndex - индексирование изображения, собирающегося быть считанным.
  - processImageProgress
```
protected void processImageProgress(float percentageDone)
```
    Широковещательно передает текущий процент завершения изображения ко всем зарегистрированным IIOReadProgressListeners, вызывая их imageProgress метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    percentageDone - текущий процент завершения, как a float.
  - processImageComplete
```
protected void processImageComplete()
```
    Широковещательно передает завершение чтения изображения ко всем зарегистрированным IIOReadProgressListeners, вызывая их imageComplete метод. Подклассы могут использовать этот метод в качестве удобства.
  - processThumbnailStarted
```
protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)
```
    Широковещательно передает запуск чтения миниатюры ко всем зарегистрированным IIOReadProgressListeners, вызывая их thumbnailStarted метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    imageIndex - индексирование изображения связалось с миниатюрой.
    
    thumbnailIndex - индексирование миниатюры.
  - processThumbnailProgress
```
protected void processThumbnailProgress(float percentageDone)
```
    Широковещательно передает текущий процент завершения миниатюры ко всем зарегистрированным IIOReadProgressListeners, вызывая их thumbnailProgress метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    percentageDone - текущий процент завершения, как a float.
  - processThumbnailComplete
```
protected void processThumbnailComplete()
```
    Широковещательно передает завершение чтения миниатюры ко всем зарегистрированным IIOReadProgressListeners, вызывая их thumbnailComplete метод. Подклассы могут использовать этот метод в качестве удобства.
  - processReadAborted
```
protected void processReadAborted()
```
    Широковещательные сообщения, что чтение было прервано ко всем зарегистрированным IIOReadProgressListeners, вызывая их readAborted метод. Подклассы могут использовать этот метод в качестве удобства.
  - processPassStarted
```
protected void processPassStarted(BufferedImage theImage,
                                  int pass,
                                  int minPass,
                                  int maxPass,
                                  int minX,
                                  int minY,
                                  int periodX,
                                  int periodY,
                                  int[] bands)
```
    Широковещательно передает начало прогрессивной передачи во все зарегистрированные IIOReadUpdateListeners, вызывая их passStarted метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    theImage - BufferedImage быть обновленным.
    
    pass - индексирование текущей передачи, запускающейся с 0.
    
    minPass - индексирование первой передачи, которая будет декодироваться.
    
    maxPass - индексирование последней передачи, которая будет декодироваться.
    
    minX - X координат верхнего левого пикселя включаются в передачу.
    
    minY - X координат верхнего левого пикселя включаются в передачу.
    
    periodX - горизонтальное разделение между пикселями.
    
    periodY - вертикальное разделение между пикселями.
    
    bands - массив ints указание на набор полос, на которые влияют, места назначения.
  - processImageUpdate
```
protected void processImageUpdate(BufferedImage theImage,
                                  int minX,
                                  int minY,
                                  int width,
                                  int height,
                                  int periodX,
                                  int periodY,
                                  int[] bands)
```
    Широковещательно передает обновление ряда выборок ко всем зарегистрированным IIOReadUpdateListeners, вызывая их imageUpdate метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    theImage - BufferedImage быть обновленным.
    
    minX - X координат верхнего левого пикселя включаются в передачу.
    
    minY - X координат верхнего левого пикселя включаются в передачу.
    
    width - полный width обновляемой области, включая пиксели, пропускаемые, если periodX > 1.
    
    height - полный height обновляемой области, включая пиксели, пропускаемые, если periodY > 1.
    
    periodX - горизонтальное разделение между пикселями.
    
    periodY - вертикальное разделение между пикселями.
    
    bands - массив ints указание на набор полос, на которые влияют, места назначения.
  - processPassComplete
```
protected void processPassComplete(BufferedImage theImage)
```
    Широковещательно передает конец прогрессивной передачи во все зарегистрированные IIOReadUpdateListeners, вызывая их passComplete метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    theImage - BufferedImage быть обновленным.
  - processThumbnailPassStarted
```
protected void processThumbnailPassStarted(BufferedImage theThumbnail,
                                           int pass,
                                           int minPass,
                                           int maxPass,
                                           int minX,
                                           int minY,
                                           int periodX,
                                           int periodY,
                                           int[] bands)
```
    Широковещательно передает начало миниатюры прогрессивная передача во все зарегистрированные IIOReadUpdateListeners, вызывая их thumbnailPassStarted метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    theThumbnail - BufferedImage обновляемая миниатюра.
    
    pass - индексирование текущей передачи, запускающейся с 0.
    
    minPass - индексирование первой передачи, которая будет декодироваться.
    
    maxPass - индексирование последней передачи, которая будет декодироваться.
    
    minX - X координат верхнего левого пикселя включаются в передачу.
    
    minY - X координат верхнего левого пикселя включаются в передачу.
    
    periodX - горизонтальное разделение между пикселями.
    
    periodY - вертикальное разделение между пикселями.
    
    bands - массив ints указание на набор полос, на которые влияют, места назначения.
  - processThumbnailUpdate
```
protected void processThumbnailUpdate(BufferedImage theThumbnail,
                                      int minX,
                                      int minY,
                                      int width,
                                      int height,
                                      int periodX,
                                      int periodY,
                                      int[] bands)
```
    Широковещательно передает обновление ряда выборок в изображении миниатюры ко всем зарегистрированным IIOReadUpdateListeners, вызывая их thumbnailUpdate метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    theThumbnail - BufferedImage обновляемая миниатюра.
    
    minX - X координат верхнего левого пикселя включаются в передачу.
    
    minY - X координат верхнего левого пикселя включаются в передачу.
    
    width - полный width обновляемой области, включая пиксели, пропускаемые, если periodX > 1.
    
    height - полный height обновляемой области, включая пиксели, пропускаемые, если periodY > 1.
    
    periodX - горизонтальное разделение между пикселями.
    
    periodY - вертикальное разделение между пикселями.
    
    bands - массив ints указание на набор полос, на которые влияют, места назначения.
  - processThumbnailPassComplete
```
protected void processThumbnailPassComplete(BufferedImage theThumbnail)
```
    Широковещательно передает конец миниатюры прогрессивная передача во все зарегистрированные IIOReadUpdateListeners, вызывая их thumbnailPassComplete метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    theThumbnail - BufferedImage обновляемая миниатюра.
  - processWarningOccurred
```
protected void processWarningOccurred(String warning)
```
    Широковещательно передает предупреждающее сообщение ко всем зарегистрированным IIOReadWarningListeners, вызывая их warningOccurred метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    warning - предупреждающее сообщение, чтобы передаться.
    
    Броски:
    
    IllegalArgumentException - если warning null.
  - processWarningOccurred
```
protected void processWarningOccurred(String baseName,
                                      String keyword)
```
    Широковещательно передает локализованное предупреждающее сообщение ко всем зарегистрированным IIOReadWarningListeners, вызывая их warningOccurred метод со строкой, взятой от a ResourceBundle. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    
    baseName - базовое имя ряда ResourceBundles содержащий локализованные предупреждающие сообщения.
    
    keyword - ключевое слово, используемое, чтобы индексировать предупреждающее сообщение в пределах набора ResourceBundles.
    
    Броски:
    
    IllegalArgumentException - если baseName null.
    
    IllegalArgumentException - если keyword null.
    
    IllegalArgumentException - если не приспосабливают ResourceBundle может быть расположен.
    
    IllegalArgumentException - если именованный ресурс не находится в расположенном ResourceBundle.
    
    IllegalArgumentException - если объект, полученный от ResourceBundle не a String.
  - сброс
```
public void reset()
```
    Восстановления ImageReader к его начальному состоянию.
    Вызовы реализации по умолчанию setInput(null, false), setLocale(null), removeAllIIOReadUpdateListeners(), removeAllIIOReadWarningListeners(), removeAllIIOReadProgressListeners(), и clearAbortRequest.
  - расположить
```
public void dispose()
```
    Позволяет любые ресурсы, которые, как сохранил этот объект, были выпущены. Результат вызова любого другого метода (кроме finalize) последующий за звонком в этот метод неопределено.
    Для приложений важно вызвать этот метод, когда они будут знать, что больше не будут использовать это ImageReader. Иначе, читатель может продолжать держаться за ресурсы неопределенно.
    Реализация по умолчанию этого метода в суперклассе ничего не делает. Реализации подкласса должны гарантировать, что все средства, особенно собственные ресурсы, высвобождаются.
  - getSourceRegion
```
protected static Rectangle getSourceRegion(ImageReadParam param,
                                           int srcWidth,
                                           int srcHeight)
```
    Служебный метод, который может использоваться читателями, чтобы вычислить область исходного изображения, которое должно быть считано, принимая во внимание любую исходную область и настройки смещения подвыборки в предоставленном ImageReadParam. Фактические факторы подвыборки, целевой размер, и место назначения смещают, не учитываются, таким образом дальнейшее отсечение должно иметь место. computeRegions метод выполняет все необходимое отсечение.
    
    Параметры:
    
    param - ImageReadParam быть используемым, или null.
    
    srcWidth - width исходного изображения.
    
    srcHeight - height исходного изображения.
    
    Возвраты:
    
    исходная область как a Rectangle.
  - computeRegions
```
protected static void computeRegions(ImageReadParam param,
                                     int srcWidth,
                                     int srcHeight,
                                     BufferedImage image,
                                     Rectangle srcRegion,
                                     Rectangle destRegion)
```
    Вычисляет исходную область интереса и целевую область интереса, беря width и height исходного изображения, дополнительного целевого изображения, и дополнительного ImageReadParam во внимание. Исходная область начинается со всего исходного изображения. Затем это отсекается к исходной области, определенной в ImageReadParam, если Вы определяетесь.
    Если любое из целевых смещений отрицательно, исходная область отсекается так, чтобы ее верхнее левое совпало с верхним левым из целевого изображения, принимая подвыборку во внимание. Затем результат отсекается к целевому изображению справа и нижней части, если Вы определяетесь, принимая во внимание целевые смещения и подвыборка.
    Точно так же целевая область начинается с исходного изображения, преобразовывается в целевое смещение, поданное ImageReadParam если есть один, и наконец отсекается к целевому изображению, если есть тот.
    Если или источник или целевые области заканчивают тем, что имели width или height 0, IllegalArgumentException бросается.
    getSourceRegion метод может использоваться, если только исходное отсечение требуется.
    
    Параметры:
    
    param - ImageReadParam, или null.
    
    srcWidth - width исходного изображения.
    
    srcHeight - height исходного изображения.
    
    image - a BufferedImage это будет целевым изображением, или null.
    
    srcRegion - a Rectangle это будет заполнено исходной областью интереса.
    
    destRegion - a Rectangle это будет заполнено целевой областью интереса.
    
    Броски:
    
    IllegalArgumentException - если srcRegion null.
    
    IllegalArgumentException - если dstRegion null.
    
    IllegalArgumentException - если получающаяся исходная или целевая область пуста.
  - checkReadParamBandSettings
```
protected static void checkReadParamBandSettings(ImageReadParam param,
                                                 int numSrcBands,
                                                 int numDstBands)
```
    Служебный метод, который может использоваться читателями, чтобы протестировать законность источника и целевые настройки полосы ImageReadParam. Этот метод можно вызвать, как только читатель знает обоих число полос исходного изображения, поскольку это существует во входном потоке, и числе полос целевого изображения это записанное.
    Метод получает источник и целевые массивы установки полосы от param использование getSourceBands и getDestinationBandsметоды (или полагает, что они null если param null). Если исходный массив установки полосы null, это, как полагают, равно массиву { 0, 1, ..., numSrcBands - 1 }, и так же для целевого массива установки полосы.
    Метод тогда тестирует это, оба массива равны в длине, и что никакой массив не содержит значение, больше, чем самая большая доступная полоса индексирует.
    Любой отказ приводит к IllegalArgumentException быть брошенным; успех приводит к методу, возвращающемуся тихо.
    
    Параметры:
    
    param - ImageReadParam будучи имевшимся обыкновение читать изображение.
    
    numSrcBands - число полос изображения, поскольку это существует интервал входной источник.
    
    numDstBands - число полос в целевом записанном изображении.
    
    Броски:
    
    IllegalArgumentException - если param содержит недопустимую спецификацию источника и/или целевого подмножества полосы.
  - getDestination
```
protected static BufferedImage getDestination(ImageReadParam param,
                                              Iterator<ImageTypeSpecifier> imageTypes,
                                              int width,
                                              int height)
                                       throws IIOException
```
    Возвраты BufferedImage которому декодируемые пиксельные данные должны быть записаны. Изображение определяется, осматривая предоставленный ImageReadParam если это не -null; если getDestination метод возвращается не -null значение, то изображение просто возвращается. Иначе, param.getDestinationType метод вызывают, чтобы определить, был ли определенный тип изображения определен. Если так, возвращенный ImageTypeSpecifier используется после проверки, что это равно одному из включенных в imageTypes.
    Если param null или вышеупомянутые шаги не привели к изображению или ImageTypeSpecifier, первое значение, полученное из imageTypes параметр используется. Как правило, вызывающая сторона установит imageTypes к значению getImageTypes(imageIndex).
    Затем, размерности изображения определяются звонком computeRegions. В фактическом width и height декодируемого изображения передают как width и height параметры.
    
    Параметры:
    
    param - ImageReadParam использоваться, чтобы получить целевое изображение или тип изображения, или null.
    
    imageTypes - Iterator из ImageTypeSpecifiers указание на юридические типы изображения, со значением по умолчанию сначала.
    
    width - истинный width изображения или мозаики начинается декодируемый.
    
    height - истинный width изображения или декодируемой мозаики.
    
    Возвраты:
    
    BufferedImage которому декодируемые пиксельные данные должны быть записаны.
    
    Броски:
    
    IIOException - если ImageTypeSpecifier определенный param не соответствует ни одного из юридических от imageTypes.
    
    IllegalArgumentException - если imageTypes null или пустой, или если объект не типа ImageTypeSpecifier получается от этого.
    
    IllegalArgumentException - если у получающегося изображения были бы width или height меньше чем 1.
    
    IllegalArgumentException - если продукт width и height больше чем Integer.MAX_VALUE.

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

Класс ImageReader

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

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

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

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

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

originatingProvider

ввод

seekForwardOnly

ignoreMetadata

minIndex

availableLocales

локаль

warningListeners

warningLocales

progressListeners

updateListeners

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

ImageReader

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

getFormatName

getOriginatingProvider

setInput

setInput

setInput

getInput

isSeekForwardOnly

isIgnoringMetadata

getMinIndex

getAvailableLocales

setLocale

getLocale

getNumImages

getWidth

getHeight

isRandomAccessEasy

getAspectRatio

getRawImageType

getImageTypes

getDefaultReadParam

getStreamMetadata

getStreamMetadata

getImageMetadata

getImageMetadata

читать

читать

readAll

readAll

canReadRaster

readRaster

isImageTiled

getTileWidth

getTileHeight

getTileGridXOffset

getTileGridYOffset

readTile

readTileRaster

readAsRenderedImage

readerSupportsThumbnails

hasThumbnails

getNumThumbnails

getThumbnailWidth

getThumbnailHeight

readThumbnail

аварийное прекращение работы

abortRequested

clearAbortRequest

addIIOReadWarningListener

removeIIOReadWarningListener

removeAllIIOReadWarningListeners

addIIOReadProgressListener

removeIIOReadProgressListener

removeAllIIOReadProgressListeners

addIIOReadUpdateListener

removeIIOReadUpdateListener

removeAllIIOReadUpdateListeners

processSequenceStarted

processSequenceComplete

processImageStarted

processImageProgress