Класс MemoryImageSource

java.lang.Object

java.awt.image.MemoryImageSource

Все реализуемые интерфейсы:: ImageProducer

public class MemoryImageSource extends Object implements ImageProducer

Этот класс реализует интерфейс ImageProducer, который использует массив для создания значений пикселей изображения. Ниже приведён пример, вычисляющий изображение размером 100x100, в котором вдоль оси X происходит переход от чёрного к синему, а вдоль оси Y — от чёрного к красному:


     int w = 100;
     int h = 100;
     int pix[] = new int[w * h];
     int index = 0;
     for (int y = 0; y < h; y++) {
         int red = (y * 255) / (h - 1);
         for (int x = 0; x < w; x++) {
             int blue = (x * 255) / (w - 1);
             pix[index++] = (255 << 24) | (red << 16) | blue;
         }
     }
     Image img = createImage(new MemoryImageSource(w, h, pix, 0, w));

MemoryImageSource также может управлять изображением в памяти, которое меняется со временем, обеспечивая анимацию или пользовательскую отрисовку. Ниже приведён пример настройки источника анимации и сигнализации об изменениях данных (адаптирован из MemoryAnimationSourceDemo Гарса Дики):


     int pixels[];
     MemoryImageSource source;

     public void init() {
         int width = 50;
         int height = 50;
         int size = width * height;
         pixels = new int[size];

         int value = getBackground().getRGB();
         for (int i = 0; i < size; i++) {
             pixels[i] = value;
         }

         source = new MemoryImageSource(width, height, pixels, 0, width);
         source.setAnimated(true);
         image = createImage(source);
     }

     public void run() {
         Thread me = Thread.currentThread( );
         me.setPriority(Thread.MIN_PRIORITY);

         while (true) {
             try {
                 Thread.sleep(10);
             } catch( InterruptedException e ) {
                 return;
             }

             // Modify the values in the pixels array at (x, y, w, h)

             // Send the new data to the interested ImageConsumers
             source.newPixels(x, y, w, h);
         }
     }

См. также:

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

Конструктор	Описание
`MemoryImageSource(int w, int h, int[] pix, int off, int scan)`	Создаёт объект ImageProducer, который использует массив целых чисел в стандартной цветовой модели RGB для создания данных объекта Image.
`MemoryImageSource(int w, int h, int[] pix, int off, int scan, Hashtable<?,?> props)`	Создаёт объект ImageProducer, который использует массив целых чисел в стандартной цветовой модели RGB для создания данных объекта Image.
`MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan)`	Создаёт объект ImageProducer, который использует массив байтов для создания данных объекта Image.
`MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan, Hashtable<?,?> props)`	Создаёт объект ImageProducer, который использует массив байтов для создания данных объекта Image.
`MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan)`	Создаёт объект ImageProducer, который использует массив целых чисел для создания данных объекта Image.
`MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan, Hashtable<?,?> props)`	Создаёт объект ImageProducer, который использует массив целых чисел для создания данных объекта Image.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addConsumer(ImageConsumer ic)`	Добавляет ImageConsumer в список потребителей, заинтересованных в данных этого изображения.
`boolean`	`isConsumer(ImageConsumer ic)`	Определяет, входит ли ImageConsumer в список потребителей, в данный момент заинтересованных в данных этого изображения.
`void`	`newPixels()`	Передаёт новый буфер пикселей всем ImageConsumer, в данный момент заинтересованным в данных этого изображения, и уведомляет их о завершении кадра анимации.
`void`	`newPixels(byte[] newpix, ColorModel newmodel, int offset, int scansize)`	Заменяет массив байтов, хранящий пиксели этого изображения, новым массивом.
`void`	`newPixels(int[] newpix, ColorModel newmodel, int offset, int scansize)`	Заменяет массив целых чисел, хранящий пиксели этого изображения, новым массивом.
`void`	`newPixels(int x, int y, int w, int h)`	Передаёт прямоугольную область буфера пикселей всем ImageConsumer, в данный момент заинтересованным в данных этого изображения, и уведомляет их о завершении кадра анимации.
`void`	`newPixels(int x, int y, int w, int h, boolean framenotify)`	Передаёт прямоугольную область буфера пикселей всем ImageConsumer, в данный момент заинтересованным в данных этого изображения.
`void`	`removeConsumer(ImageConsumer ic)`	Удаляет ImageConsumer из списка потребителей, заинтересованных в данных этого изображения.
`void`	`requestTopDownLeftRightResend(ImageConsumer ic)`	Запрашивает повторную передачу данных изображения заданному ImageConsumer в порядке сверху вниз и слева направо.
`void`	`setAnimated(boolean animated)`	В зависимости от параметра animated преобразует это изображение в памяти в много кадровую анимацию или статическое изображение из одного кадра.
`void`	`setFullBufferUpdates(boolean fullbuffers)`	Указывает, следует ли всегда обновлять это анимированное изображение в памяти, передавая полный буфер пикселей при каждом изменении.
`void`	`startProduction(ImageConsumer ic)`	Добавляет ImageConsumer в список потребителей, заинтересованных в данных этого изображения, и немедленно начинает передачу данных изображения через интерфейс ImageConsumer.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

MemoryImageSource

public MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan)

Создаёт объект ImageProducer, который использует массив байтов для создания данных объекта Image.

Параметры:

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

cm — указанная ColorModel

pix — массив пикселей

off — смещение в массиве, с которого следует записать первый пиксель

scan — расстояние между строками пикселей в массиве

См. также:

MemoryImageSource

public MemoryImageSource(int w, int h, ColorModel cm, byte[] pix, int off, int scan, Hashtable<?,?> props)

Создаёт объект ImageProducer, который использует массив байтов для создания данных объекта Image.

Параметры:

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

cm — указанная ColorModel

pix — массив пикселей

off — смещение в массиве, с которого следует записать первый пиксель

scan — расстояние между строками пикселей в массиве

props — список свойств, которые ImageProducer использует для обработки изображения

См. также:

MemoryImageSource

public MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan)

Создаёт объект ImageProducer, который использует массив целых чисел для создания данных объекта Image.

Параметры:

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

cm — указанная ColorModel

pix — массив пикселей

off — смещение в массиве, с которого следует записать первый пиксель

scan — расстояние между строками пикселей в массиве

См. также:

MemoryImageSource

public MemoryImageSource(int w, int h, ColorModel cm, int[] pix, int off, int scan, Hashtable<?,?> props)

Создаёт объект ImageProducer, который использует массив целых чисел для создания данных объекта Image.

Параметры:

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

cm — указанная ColorModel

pix — массив пикселей

off — смещение в массиве, с которого следует записать первый пиксель

scan — расстояние между строками пикселей в массиве

props — список свойств, которые ImageProducer использует для обработки изображения

См. также:

MemoryImageSource

public MemoryImageSource(int w, int h, int[] pix, int off, int scan)

Создаёт объект ImageProducer, который использует массив целых чисел в стандартной цветовой модели RGB для создания данных объекта Image.

Параметры:

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

pix — массив пикселей

off — смещение в массиве, с которого следует записать первый пиксель

scan — расстояние между строками пикселей в массиве

См. также:

MemoryImageSource

public MemoryImageSource(int w, int h, int[] pix, int off, int scan, Hashtable<?,?> props)

Параметры:

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

pix — массив пикселей

off — смещение в массиве, с которого следует записать первый пиксель

scan — расстояние между строками пикселей в массиве

props — список свойств, которые ImageProducer использует для обработки изображения

См. также:

Подробное описание методов

addConsumer

public void addConsumer(ImageConsumer ic)

Добавляет ImageConsumer в список потребителей, заинтересованных в данных этого изображения.

Определено в:

addConsumer в интерфейсе ImageProducer

Параметры:

ic — указанный ImageConsumer

Вызывает исключение:

NullPointerException — если указанный ImageConsumer равен null

См. также:

isConsumer

public boolean isConsumer(ImageConsumer ic)

Определяет, входит ли ImageConsumer в список потребителей, в данный момент заинтересованных в данных этого изображения.

Определено в:

isConsumer в интерфейсе ImageProducer

Параметры:

ic — указанный ImageConsumer

Возвращает:

true, если ImageConsumer входит в список; в противном случае — false.

См. также:

removeConsumer

public void removeConsumer(ImageConsumer ic)

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

Определено в:

removeConsumer в интерфейсе ImageProducer

Параметры:

ic — указанный ImageConsumer

См. также:

startProduction

public void startProduction(ImageConsumer ic)

Добавляет ImageConsumer в список потребителей, заинтересованных в данных этого изображения, и немедленно начинает передачу данных изображения через интерфейс ImageConsumer.

Определено в:

startProduction в интерфейсе ImageProducer

Параметры:

ic — указанный ImageConsumer для передачи данных изображения через интерфейс ImageConsumer.

См. также:

requestTopDownLeftRightResend

public void requestTopDownLeftRightResend(ImageConsumer ic)

Запрашивает повторную передачу данных изображения заданному ImageConsumer в порядке сверху вниз и слева направо.

Определено в:

requestTopDownLeftRightResend в интерфейсе ImageProducer

Параметры:

ic — указанный ImageConsumer

См. также:

setAnimated

public void setAnimated(boolean animated)

В зависимости от параметра animated преобразует это изображение в памяти в много кадровую анимацию или статическое изображение из одного кадра.

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

Параметры:: animated — true, если изображение представляет собой много кадровую анимацию

setFullBufferUpdates

public void setFullBufferUpdates(boolean fullbuffers)

Указывает, следует ли всегда обновлять это анимированное изображение в памяти, передавая полный буфер пикселей при каждом изменении. Этот флаг игнорируется, если анимация не включена с помощью метода setAnimated().

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

Параметры:

fullbuffers — true, если следует всегда передавать полный буфер пикселей

См. также:

newPixels

public void newPixels()

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

См. также:

newPixels

public void newPixels(int x, int y, int w, int h)

Передаёт прямоугольную область буфера пикселей всем ImageConsumer, в данный момент заинтересованным в данных этого изображения, и уведомляет их о завершении кадра анимации. Этот метод действует только в том случае, если флаг анимации включён с помощью метода setAnimated(). Если флаг обновления полного буфера включён с помощью метода setFullBufferUpdates(), параметры прямоугольной области игнорируются и всегда передаётся весь буфер.

Параметры:

x — координата x верхнего левого угла прямоугольной области пикселей для передачи

y — координата y верхнего левого угла прямоугольной области пикселей для передачи

w — ширина прямоугольной области пикселей для передачи

h — высота прямоугольной области пикселей для передачи

См. также:

newPixels

public void newPixels(int x, int y, int w, int h, boolean framenotify)

Передаёт прямоугольную область буфера пикселей всем ImageConsumer, в данный момент заинтересованным в данных этого изображения. Если параметр framenotify равен true, потребители также уведомляются о завершении кадра анимации. Этот метод действует только в том случае, если флаг анимации включён с помощью метода setAnimated(). Если флаг обновления полного буфера включён с помощью метода setFullBufferUpdates(), параметры прямоугольной области игнорируются и всегда передаётся весь буфер.

Параметры:

x — координата x верхнего левого угла прямоугольной области пикселей для передачи

y — координата y верхнего левого угла прямоугольной области пикселей для передачи

w — ширина прямоугольной области пикселей для передачи

h — высота прямоугольной области пикселей для передачи

framenotify — true, если потребителям следует отправить уведомление SINGLEFRAMEDONE

См. также:

newPixels

public void newPixels(byte[] newpix, ColorModel newmodel, int offset, int scansize)

Заменяет массив байтов, хранящий пиксели этого изображения, новым массивом. Если флаг анимации включён с помощью метода setAnimated(), новые пиксели немедленно передаются всем ImageConsumer, в данный момент заинтересованным в данных этого изображения.

Параметры:

newpix — новый массив пикселей

newmodel — указанная ColorModel

offset — смещение в массиве

scansize — расстояние между строками пикселей в массиве

См. также:

newPixels

public void newPixels(int[] newpix, ColorModel newmodel, int offset, int scansize)

Заменяет массив целых чисел, хранящий пиксели этого изображения, новым массивом. Если флаг анимации включён с помощью метода setAnimated(), новые пиксели немедленно передаются всем ImageConsumer, в данный момент заинтересованным в данных этого изображения.

Параметры:

newpix — новый массив пикселей

newmodel — указанная ColorModel

offset — смещение в массиве

scansize — расстояние между строками пикселей в массиве

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/MemoryImageSource.html