Интерфейс 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 в этот момент, если он не заинтересован в последующих кадрах.