Интерфейс ImageConsumer

static final int RANDOMPIXELORDER

Пиксели будут переданы в случайном порядке. Это сообщает ImageConsumer, что не следует использовать оптимизации, зависящие от порядка передачи пикселей, который должен быть по умолчанию, если не было вызова метода setHints.

static final int TOPDOWNLEFTRIGHT

Пиксели будут переданы сверху вниз, слева направо.

static final int COMPLETESCANLINES

Пиксели будут переданы (в кратных) полных строках сканирования за раз.

static final int SINGLEPASS

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

static final int SINGLEFRAME

Изображение содержит одно статическое изображение. Пиксели будут определены в вызовах методов setPixels, а затем метод imageComplete будет вызван со флагом STATICIMAGEDONE после чего больше данных изображения не будет передано. Примером типа изображения, который не соответствовал бы этим критериям, является выход видеопотока или представление 3D-рендера, манипулируемого пользователем. Конец каждого кадра в этих типах изображений будет указан вызовом imageComplete со флагом SINGLEFRAMEDONE.

static final int IMAGEERROR

При создании изображения возникла ошибка.

static final int SINGLEFRAMEDONE

Один кадр изображения завершён, но должны быть переданы другие кадры.

static final int STATICIMAGEDONE

Изображение завершено, и больше пикселей или кадров передаваться не будут.

static final int IMAGEABORTED

Процесс создания изображения был намеренно прерван.

void setDimensions(int width, int height)

Размеры исходного изображения сообщаются с помощью вызова метода setDimensions.

void setProperties(Hashtable<?,?> props)

Устанавливает расширяемый список свойств, связанных с этим изображением.

void setColorModel(ColorModel model)

Устанавливает объект ColorModel, используемый для большинства пикселей, отчёт о которых производится с помощью вызовов метода setPixels. Обратите внимание, что каждый набор пикселей, передаваемый с помощью setPixels, содержит свой собственный объект ColorModel, поэтому не следует предполагать, что этот модель будет единственной, используемой для передачи значений пикселей. Примечательный случай, где могут использоваться несколько объектов ColorModel, — это отфильтрованное изображение, когда для каждого набора пикселей, который он фильтрует, фильтр определяет, можно ли передать пиксели без изменений, используя исходный ColorModel, или пиксели должны быть изменены (отфильтрованы) и переданы с помощью ColorModel, более удобного для процесса фильтрации.

void setHints(int hintflags)

Устанавливает подсказки, которые ImageConsumer использует для обработки пикселей, передаваемых ImageProducer. ImageProducer может передавать пиксели в любом порядке, но ImageConsumer может иметь возможность масштабировать или преобразовывать пиксели в целевой ColorModel более эффективно или с более высоким качеством, если он знает некоторую информацию о том, как пиксели будут переданы заранее. Метод setHints должен вызываться до вызовов любых методов setPixels с битовой маской подсказок о том, каким образом пиксели будут переданы. Если ImageProducer не соответствует указаниям для указанной подсказки, результаты не определены.

void setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)

Передает пиксели изображения с помощью одного или нескольких вызовов этого метода. Каждый вызов определяет местоположение и размер прямоугольника исходных пикселей, которые содержатся в массиве пикселей. Указанный объект ColorModel должен использоваться для преобразования пикселей в соответствующие цветовые и альфа-компоненты. Пиксель (m,n) хранится в массиве pixels в индексе (n * scansize + m + off). Передаваемые с помощью этого метода пиксели хранятся в виде байтов.

void setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)

Пиксели изображения передаются с помощью одного или нескольких вызовов метода setPixels. Каждый вызов определяет местоположение и размер прямоугольника исходных пикселей, которые содержатся в массиве пикселей. Указанный объект ColorModel должен использоваться для преобразования пикселей в соответствующие цветовые и альфа-компоненты. Пиксель (m,n) хранится в массиве pixels в индексе (n * scansize + m + off). Пиксели, передаваемые с помощью этого метода, хранятся в виде целых чисел. этот метод хранятся в виде целых чисел.

void imageComplete(int status)

Метод imageComplete вызывается, когда ImageProducer завершил передачу всех пикселей исходного изображения, или когда завершен один кадр многокадровой анимации, или когда произошла ошибка загрузки или создания изображения. ImageConsumer должен удалить себя из списка потребителей, зарегистрированных с ImageProducer в этот момент, если только он не заинтересован в последующих кадрах.