Класс BufferedImage

java.lang.Object

java.awt.Image

java.awt.image.BufferedImage

Все реализованные интерфейсы:: RenderedImage, WritableRenderedImage, Transparency

public class BufferedImage extends Image implements WritableRenderedImage, Transparency

Подкласс BufferedImage описывает Image с доступным буфером данных изображения. BufferedImage состоит из ColorModel и Raster данных изображения. Количество и типы полос в SampleModel объекта Raster должны совпадать с количеством и типами, требуемыми ColorModel для представления его цветовых и альфа-компонентов. Все объекты BufferedImage имеют координату верхнего левого угла (0, 0). Любой Raster, используемый для создания BufferedImage, следовательно, должен иметь minX=0 и minY=0.

Этот класс использует методы получения и установки данных Raster, а также методы цветовой характеристики ColorModel.

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`TYPE_3BYTE_BGR`	Представляет изображение с 8-битными цветовыми компонентами RGB, соответствующими цветовой модели BGR в стиле Windows, где синий, зеленый и красный цвета хранятся в 3 байтах.
`static final int`	`TYPE_4BYTE_ABGR`	Представляет изображение с 8-битными цветовыми компонентами RGBA, где синий, зеленый и красный цвета хранятся в 3 байтах, а альфа-канал — в 1 байте.
`static final int`	`TYPE_4BYTE_ABGR_PRE`	Представляет изображение с 8-битными цветовыми компонентами RGBA, где синий, зеленый и красный цвета хранятся в 3 байтах, а альфа-канал — в 1 байте.
`static final int`	`TYPE_BYTE_BINARY`	Представляет непрозрачное 1-, 2- или 4-битное изображение, упакованное в байты.
`static final int`	`TYPE_BYTE_GRAY`	Представляет неиндексированное изображение в градациях серого с беззнаковым байтом.
`static final int`	`TYPE_BYTE_INDEXED`	Представляет индексированное байтовое изображение.
`static final int`	`TYPE_CUSTOM`	Тип изображения не распознан, поэтому оно должно быть пользовательским изображением.
`static final int`	`TYPE_INT_ARGB`	Представляет изображение с 8-битными цветовыми компонентами RGBA, упакованными в целочисленные пиксели.
`static final int`	`TYPE_INT_ARGB_PRE`	Представляет изображение с 8-битными цветовыми компонентами RGBA, упакованными в целочисленные пиксели.
`static final int`	`TYPE_INT_BGR`	Представляет изображение с 8-битными цветовыми компонентами RGB, соответствующими цветовой модели BGR в стиле Windows или Solaris, где синий, зеленый и красный цвета упакованы в целочисленные пиксели.
`static final int`	`TYPE_INT_RGB`	Представляет изображение с 8-битными цветовыми компонентами RGB, упакованными в целочисленные пиксели.
`static final int`	`TYPE_USHORT_555_RGB`	Представляет изображение с цветовыми компонентами RGB 5-5-5 (5 бит красного, 5 бит зеленого, 5 бит синего) без альфа-канала.
`static final int`	`TYPE_USHORT_565_RGB`	Представляет изображение с цветовыми компонентами RGB 5-6-5 (5 бит красного, 6 бит зеленого, 5 бит синего) без альфа-канала.
`static final int`	`TYPE_USHORT_GRAY`	Представляет неиндексированное изображение в градациях серого с беззнаковым short.

Поля, объявленные в классе Image

accelerationPriority, SCALE_AREA_AVERAGING, SCALE_DEFAULT, SCALE_FAST, SCALE_REPLICATE, SCALE_SMOOTH, UndefinedProperty

Модификатор и тип	Поле	Описание
`protected float`	`accelerationPriority`	Приоритет ускорения этого изображения.
`static final int`	`SCALE_AREA_AVERAGING`	Использовать алгоритм масштабирования изображения методом усреднения по областям (Area Averaging).
`static final int`	`SCALE_DEFAULT`	Использовать алгоритм масштабирования изображения по умолчанию.
`static final int`	`SCALE_FAST`	Выбрать алгоритм масштабирования изображения, который отдает более высокий приоритет скорости масштабирования, чем плавности масштабированного изображения.
`static final int`	`SCALE_REPLICATE`	Использовать алгоритм масштабирования изображений, воплощенный в классе `ReplicateScaleFilter`.
`static final int`	`SCALE_SMOOTH`	Выбрать алгоритм масштабирования изображений, который отдает более высокий приоритет плавности изображения, чем скорости масштабирования.
`static final Object`	`UndefinedProperty`	Объект `UndefinedProperty` должен возвращаться всякий раз, когда запрашивается свойство, не определенное для конкретного изображения.

Поля, объявленные в интерфейсе Transparency

BITMASK, OPAQUE, TRANSLUCENT

Модификатор и тип	Поле	Описание
`static final int`	`BITMASK`	Представляет данные изображения, которые гарантированно являются либо полностью непрозрачными со значением альфа 1.0, либо полностью прозрачными со значением альфа 0.0.
`static final int`	`OPAQUE`	Представляет данные изображения, которые гарантированно являются полностью непрозрачными, что означает, что все пиксели имеют значение альфа 1.0.
`static final int`	`TRANSLUCENT`	Представляет данные изображения, которые содержат или могут содержать произвольные значения альфа в диапазоне от 0.0 до 1.0 включительно.

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

Конструктор	Описание
`BufferedImage(int width, int height, int imageType)`	Создает `BufferedImage` одного из предопределенных типов изображений.
`BufferedImage(int width, int height, int imageType, IndexColorModel cm)`	Создает `BufferedImage` одного из предопределенных типов изображений: TYPE_BYTE_BINARY или TYPE_BYTE_INDEXED.
`BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)`	Создает новый `BufferedImage` с указанными `ColorModel` и `Raster`.

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

Модификатор и тип	Метод	Описание
`void`	`addTileObserver(TileObserver to)`	Добавляет наблюдателя тайлов.
`void`	`coerceData(boolean isAlphaPremultiplied)`	Принудительно приводит данные в соответствие с состоянием, указанным в переменной `isAlphaPremultiplied`.
`WritableRaster`	`copyData(WritableRaster outRaster)`	Вычисляет произвольную прямоугольную область `BufferedImage` и копирует ее в указанный `WritableRaster`.
`Graphics2D`	`createGraphics()`	Создает `Graphics2D`, который можно использовать для рисования в этом `BufferedImage`.
`WritableRaster`	`getAlphaRaster()`	Возвращает `WritableRaster`, представляющий альфа-канал для объектов `BufferedImage` с объектами `ColorModel`, поддерживающими отдельный пространственный альфа-канал, такими как `ComponentColorModel` и `DirectColorModel`.
`ColorModel`	`getColorModel()`	Возвращает `ColorModel`.
`Raster`	`getData()`	Возвращает изображение в виде одного большого тайла.
`Raster`	`getData(Rectangle rect)`	Вычисляет и возвращает произвольную область `BufferedImage`.
`Graphics`	`getGraphics()`	Этот метод возвращает `Graphics2D`, но оставлен для обратной совместимости.
`int`	`getHeight()`	Возвращает высоту `BufferedImage`.
`int`	`getHeight(ImageObserver observer)`	Возвращает высоту `BufferedImage`.
`int`	`getMinTileX()`	Возвращает минимальный индекс тайла по оси x.
`int`	`getMinTileY()`	Возвращает минимальный индекс тайла по оси y.
`int`	`getMinX()`	Возвращает минимальную координату x этого `BufferedImage`.
`int`	`getMinY()`	Возвращает минимальную координату y этого `BufferedImage`.
`int`	`getNumXTiles()`	Возвращает количество тайлов по оси x.
`int`	`getNumYTiles()`	Возвращает количество тайлов по оси y.
`Object`	`getProperty(String name)`	Возвращает свойство изображения по имени.
`Object`	`getProperty(String name, ImageObserver observer)`	Возвращает свойство изображения по имени.
`String[]`	`getPropertyNames()`	Возвращает массив имен, распознаваемых методом `getProperty(String)`, или `null`, если имена свойств не распознаны.
`WritableRaster`	`getRaster()`	Возвращает `WritableRaster`.
`int`	`getRGB(int x, int y)`	Возвращает целочисленный пиксель в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию.
`int[]`	`getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)`	Возвращает массив целочисленных пикселей в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию из части данных изображения.
`SampleModel`	`getSampleModel()`	Возвращает `SampleModel`, связанный с этим `BufferedImage`.
`ImageProducer`	`getSource()`	Возвращает объект, формирующий пиксели для изображения.
`Vector<RenderedImage>`	`getSources()`	Возвращает объект `Vector`, содержащий объекты `RenderedImage`, которые являются непосредственными источниками (но не источниками этих непосредственных источников) данных изображения для этого `BufferedImage`.
`BufferedImage`	`getSubimage(int x, int y, int w, int h)`	Возвращает подизображение, определенное указанной прямоугольной областью.
`Raster`	`getTile(int tileX, int tileY)`	Возвращает тайл (`tileX`, `tileY`).
`int`	`getTileGridXOffset()`	Возвращает смещение сетки тайлов по оси x относительно начала координат, например, координату x положения тайла (0, 0).
`int`	`getTileGridYOffset()`	Возвращает смещение сетки тайлов по оси y относительно начала координат, например, координату y положения тайла (0, 0).
`int`	`getTileHeight()`	Возвращает высоту тайла в пикселях.
`int`	`getTileWidth()`	Возвращает ширину тайла в пикселях.
`int`	`getTransparency()`	Возвращает прозрачность.
`int`	`getType()`	Возвращает тип изображения.
`int`	`getWidth()`	Возвращает ширину `BufferedImage`.
`int`	`getWidth(ImageObserver observer)`	Возвращает ширину `BufferedImage`.
`WritableRaster`	`getWritableTile(int tileX, int tileY)`	Блокирует тайл для записи.
`Point[]`	`getWritableTileIndices()`	Возвращает массив объектов `Point`, указывающих, какие тайлы заблокированы для записи.
`boolean`	`hasTileWriters()`	Возвращает значение, указывающее, заблокирован ли какой-либо тайл для записи.
`boolean`	`isAlphaPremultiplied()`	Возвращает значение, указывающее, было ли предварительно умножено значение альфа.
`boolean`	`isTileWritable(int tileX, int tileY)`	Возвращает значение, указывающее, заблокирован ли тайл в данный момент для записи.
`void`	`releaseWritableTile(int tileX, int tileY)`	Отказывается от разрешения на запись в тайл.
`void`	`removeTileObserver(TileObserver to)`	Удаляет наблюдателя тайлов.
`void`	`setData(Raster r)`	Заменяет прямоугольную область изображения содержимым указанного `Raster r`, который, как предполагается, находится в том же пространстве координат, что и `BufferedImage`.
`void`	`setRGB(int x, int y, int rgb)`	Устанавливает для пикселя в этом `BufferedImage` указанное значение RGB.
`void`	`setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)`	Устанавливает массив целочисленных пикселей в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию в часть данных изображения.
`String`	`toString()`	Возвращает строковое представление этого объекта `String` и его значений в виде `BufferedImage`.

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

flush, getAccelerationPriority, getCapabilities, getScaledInstance, setAccelerationPriority

Модификатор и тип	Метод	Описание
`void`	`flush()`	Сбрасывает все восстанавливаемые ресурсы, используемые этим объектом Image.
`float`	`getAccelerationPriority()`	Возвращает текущее значение подсказки приоритета ускорения.
`ImageCapabilities`	`getCapabilities(GraphicsConfiguration gc)`	Возвращает объект ImageCapabilities, который можно запросить относительно возможностей этого Image на указанной GraphicsConfiguration.
`Image`	`getScaledInstance(int width, int height, int hints)`	Создает масштабированную версию этого изображения.
`void`	`setAccelerationPriority(float priority)`	Устанавливает подсказку для этого изображения о том, насколько важно ускорение.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, "равен" ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, для удаления: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в будущей версии.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в режим ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения (notified) или прерывания (interrupted).
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в режим ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения (notified) или прерывания (interrupted), либо до истечения определенного времени реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в режим ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения (notified) или прерывания (interrupted), либо до истечения определенного времени реального времени.

Подробное описание полей

TYPE_CUSTOM

public static final int TYPE_CUSTOM

Тип изображения не распознан, поэтому оно должно быть пользовательским изображением. Этот тип используется только в качестве возвращаемого значения для метода getType().

См. также:

TYPE_INT_RGB

public static final int TYPE_INT_RGB

Представляет изображение с 8-битными цветовыми компонентами RGB, упакованными в целочисленные пиксели. Изображение имеет DirectColorModel без альфа-канала. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_INT_ARGB

public static final int TYPE_INT_ARGB

Представляет изображение с 8-битными цветовыми компонентами RGBA, упакованными в целочисленные пиксели. Изображение имеет DirectColorModel с альфа-каналом. Считается, что цветовые данные в этом изображении не предварительно умножены на альфа-канал.

См. также:

TYPE_INT_ARGB_PRE

public static final int TYPE_INT_ARGB_PRE

Представляет изображение с 8-битными цветовыми компонентами RGBA, упакованными в целочисленные пиксели. Изображение имеет DirectColorModel с альфа-каналом. Считается, что цветовые данные в этом изображении предварительно умножены на альфа-канал.

См. также:

TYPE_INT_BGR

public static final int TYPE_INT_BGR

Представляет изображение с 8-битными цветовыми компонентами RGB, соответствующими цветовой модели BGR в стиле Windows или Solaris, где цвета Blue, Green и Red упакованы в целочисленные пиксели. Альфа-канал отсутствует. Изображение имеет DirectColorModel. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_3BYTE_BGR

public static final int TYPE_3BYTE_BGR

Представляет изображение с 8-битными цветовыми компонентами RGB, соответствующими цветовой модели BGR в стиле Windows, где цвета Blue, Green и Red хранятся в 3 байтах. Альфа-канал отсутствует. Изображение имеет ComponentColorModel. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_4BYTE_ABGR

public static final int TYPE_4BYTE_ABGR

Представляет изображение с 8-битными цветовыми компонентами RGBA, где цвета Blue, Green и Red хранятся в 3 байтах, а альфа-канал — в 1 байте. Изображение имеет ComponentColorModel с альфа-каналом. Считается, что цветовые данные в этом изображении не предварительно умножены на альфа-канал. Байтовые данные чередуются в едином массиве байтов в порядке A, B, G, R от младших к старшим адресам байтов внутри каждого пикселя.

См. также:

TYPE_4BYTE_ABGR_PRE

public static final int TYPE_4BYTE_ABGR_PRE

Представляет изображение с 8-битными цветовыми компонентами RGBA, где цвета Blue, Green и Red хранятся в 3 байтах, а альфа-канал — в 1 байте. Изображение имеет ComponentColorModel с альфа-каналом. Считается, что цветовые данные в этом изображении предварительно умножены на альфа-канал. Байтовые данные чередуются в едином массиве байтов в порядке A, B, G, R от младших к старшим адресам байтов внутри каждого пикселя.

См. также:

TYPE_USHORT_565_RGB

public static final int TYPE_USHORT_565_RGB

Представляет изображение с 5-6-5 цветовыми компонентами RGB (5 бит — красный, 6 бит — зеленый, 5 бит — синий) без альфа-канала. Это изображение имеет DirectColorModel. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_USHORT_555_RGB

public static final int TYPE_USHORT_555_RGB

Представляет изображение с 5-5-5 цветовыми компонентами RGB (5 бит — красный, 5 бит — зеленый, 5 бит — синий) без альфа-канала. Это изображение имеет DirectColorModel. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_BYTE_GRAY

public static final int TYPE_BYTE_GRAY

Представляет изображение в градациях серого на основе беззнаковых байтов, неиндексированное. Это изображение имеет ComponentColorModel с CS_GRAY ColorSpace. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_USHORT_GRAY

public static final int TYPE_USHORT_GRAY

Представляет изображение в градациях серого на основе беззнаковых коротких целых (short), неиндексированное. Это изображение имеет ComponentColorModel с CS_GRAY ColorSpace. Когда данные с непрозрачным альфа-каналом сохраняются в изображении этого типа, данные о цвете должны быть приведены к форме без предварительного умножения, а альфа-канал отброшен, как описано в документации AlphaComposite.

См. также:

TYPE_BYTE_BINARY

public static final int TYPE_BYTE_BINARY

Представляет непрозрачное 1-, 2- или 4-битное изображение, упакованное в байты. Изображение имеет IndexColorModel без альфа-канала. Когда этот тип используется в качестве аргумента imageType конструктора BufferedImage, принимающего аргумент imageType, но не принимающего аргумент ColorModel, создается 1-битное изображение с IndexColorModel с двумя цветами в стандартном sRGB ColorSpace: {0, 0, 0} и {255, 255, 255}.

Изображения с 2 или 4 битами на пиксель могут быть созданы с помощью конструктора BufferedImage, принимающего аргумент ColorModel, путем передачи ColorModel с соответствующим размером палитры.

Для изображений с 8 битами на пиксель следует использовать типы изображений TYPE_BYTE_INDEXED или TYPE_BYTE_GRAY в зависимости от их ColorModel.

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

См. также:

TYPE_BYTE_INDEXED

public static final int TYPE_BYTE_INDEXED

Представляет индексированное байтовое изображение. Когда этот тип используется в качестве аргумента imageType конструктора BufferedImage, принимающего аргумент imageType, но не принимающего аргумент ColorModel, создается IndexColorModel с 256-цветной палитрой цветового куба 6/6/6, а остальные цвета от 216 до 255 заполняются значениями градаций серого в стандартном sRGB ColorSpace.

См. также:

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

BufferedImage

public BufferedImage(int width, int height, int imageType)

Создает BufferedImage одного из предопределенных типов изображений. ColorSpace для изображения является стандартным пространством sRGB.

Параметры:

width - ширина создаваемого изображения

height - высота создаваемого изображения

imageType - тип создаваемого изображения

См. также:

BufferedImage

public BufferedImage(int width, int height, int imageType, IndexColorModel cm)

Создает BufferedImage одного из предопределенных типов изображений: TYPE_BYTE_BINARY или TYPE_BYTE_INDEXED.

Если тип изображения равен TYPE_BYTE_BINARY, количество записей в цветовой модели используется для определения того, должно ли изображение иметь 1, 2 или 4 бита на пиксель. Если цветовая модель содержит 1 или 2 записи, изображение будет иметь 1 бит на пиксель. Если она содержит 3 или 4 записи, изображение будет иметь 2 бита на пиксель. Если она содержит от 5 до 16 записей, изображение будет иметь 4 бита на пиксель. В противном случае будет выброшено исключение IllegalArgumentException.

Параметры:

width - ширина создаваемого изображения

height - высота создаваемого изображения

imageType - тип создаваемого изображения

cm - IndexColorModel создаваемого изображения

Исключения:

IllegalArgumentException - если imageType не является TYPE_BYTE_BINARY или TYPE_BYTE_INDEXED, либо если imageType равен TYPE_BYTE_BINARY и палитра цветов содержит более 16 записей.

См. также:

BufferedImage

public BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)

Создает новый BufferedImage с заданными ColorModel и Raster. Если количество и типы каналов (bands) в SampleModel объекта Raster не соответствуют количеству и типам, требуемым ColorModel для представления его компонентов цвета и альфа-канала, выбрасывается RasterFormatException. Этот метод может умножать или делить цветовые данные Raster на альфа-канал для приведения в соответствие с состоянием alphaPremultiplied в ColorModel. Свойства для этого BufferedImage можно установить, передав Hashtable пар String/Object.

Параметры:

cm - ColorModel для нового изображения

raster - Raster для данных изображения

isRasterPremultiplied - если true, данные в растре предварительно умножены на альфа-канал.

properties - Hashtable пар String/Object.

Исключения:

RasterFormatException - если количество и типы каналов в SampleModel объекта Raster не соответствуют количеству и типам, требуемым ColorModel для представления его компонентов цвета и альфа-канала.

IllegalArgumentException - если raster несовместим с cm

См. также:

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

getType

public int getType()

Возвращает тип изображения. Если он не относится к известным типам, возвращается TYPE_CUSTOM.

Возвращает:

тип изображения этого BufferedImage.

См. также:

getColorModel

public ColorModel getColorModel()

Возвращает ColorModel.

Определено в:: getColorModel в интерфейсе RenderedImage
Возвращает:: ColorModel данного BufferedImage.

getRaster

public WritableRaster getRaster()

Возвращает WritableRaster.

Возвращает:: WritableRaster данного BufferedImage.

getAlphaRaster

public WritableRaster getAlphaRaster()

Возвращает WritableRaster, представляющий альфа-канал для объектов BufferedImage с объектами ColorModel, поддерживающими отдельный пространственный альфа-канал, такими как ComponentColorModel и DirectColorModel. Возвращает null, если с ColorModel в этом изображении не связан альфа-канал. Этот метод предполагает, что для всех объектов ColorModel, отличных от IndexColorModel, если ColorModel поддерживает альфа-канал, существует отдельный альфа-канал, который хранится как последняя полоса (band) данных изображения. Если изображение использует IndexColorModel, содержащую альфа-канал в таблице преобразования, этот метод возвращает null, так как пространственно дискретный альфа-канал отсутствует. Этот метод создает новый WritableRaster, но разделяет базовый массив данных.

Возвращает:: WritableRaster или null, если этот BufferedImage не имеет альфа-канала, связанного с его ColorModel.

getRGB

public int getRGB(int x, int y)

Возвращает целочисленный пиксель в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию. Преобразование цвета происходит, если эта модель по умолчанию не совпадает с ColorModel изображения. При использовании этого метода в возвращаемых данных обеспечивается только 8-битная точность для каждого цветового компонента.

Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты выходят за пределы допустимого диапазона. Однако явная проверка границ не гарантируется.

Параметры:

x - координата X пикселя, из которого требуется получить пиксель в стандартной цветовой модели RGB и цветовом пространстве sRGB

y - координата Y пикселя, из которого требуется получить пиксель в стандартной цветовой модели RGB и цветовом пространстве sRGB

Возвращает:

целочисленный пиксель в стандартной цветовой модели RGB и стандартном цветовом пространстве sRGB.

См. также:

getRGB

public int[] getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)

Возвращает массив целочисленных пикселей в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию из части данных изображения. Преобразование цвета происходит, если модель по умолчанию не совпадает с ColorModel изображения. При использовании этого метода в возвращаемых данных обеспечивается только 8-битная точность для каждого цветового компонента. Для заданной координаты (x, y) в изображении доступ к пикселю ARGB может быть получен следующим образом:

   pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)];

Может быть выброшено исключение ArrayIndexOutOfBoundsException, если область выходит за пределы диапазона. Однако явная проверка границ не гарантируется.

Параметры:

startX - начальная координата X

startY - начальная координата Y

w - ширина области

h - высота области

rgbArray - если не null, то rgb-пиксели записываются сюда

offset - смещение в rgbArray

scansize - шаг строки (scanline stride) для rgbArray

Возвращает:

массив RGB-пикселей.

См. также:

setRGB

public void setRGB(int x, int y, int rgb)

Устанавливает пиксель в этом объекте BufferedImage в указанное значение RGB. Предполагается, что пиксель задан в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию. Для изображений с IndexColorModel выбирается индекс с наиболее близким цветом.

Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты выходят за пределы диапазона. Однако явная проверка границ не гарантируется.

Параметры:

x - координата X устанавливаемого пикселя

y - координата Y устанавливаемого пикселя

rgb - значение RGB

См. также:

setRGB

public void setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)

Устанавливает массив целочисленных пикселей в цветовой модели RGB по умолчанию (TYPE_INT_ARGB) и цветовом пространстве sRGB по умолчанию в часть данных изображения. Преобразование цвета происходит, если модель по умолчанию не совпадает с ColorModel изображения. При использовании этого метода в возвращаемых данных обеспечивается только 8-битная точность для каждого цветового компонента. Для заданной координаты (x, y) в этом изображении доступ к пикселю ARGB может быть осуществлен следующим образом:

   pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)];

ПРЕДУПРЕЖДЕНИЕ: Дизеринг не выполняется.

Может быть выброшено исключение ArrayIndexOutOfBoundsException, если область выходит за границы. Однако явная проверка границ не гарантируется.

Параметры:

startX - начальная координата X

startY - начальная координата Y

w - ширина области

h - высота области

rgbArray - пиксели rgb

offset - смещение в rgbArray

scansize - шаг строки (scanline stride) для rgbArray

См. также:

getWidth

public int getWidth()

Возвращает ширину BufferedImage.

Определено в:: getWidth в интерфейсе RenderedImage
Возвращает:: ширину данного BufferedImage

getHeight

public int getHeight()

Возвращает высоту BufferedImage.

Определено в:: getHeight в интерфейсе RenderedImage
Возвращает:: высоту данного BufferedImage

getWidth

public int getWidth(ImageObserver observer)

Возвращает ширину BufferedImage.

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

getWidth в классе Image

Параметры:

observer - игнорируется

Возвращает:

ширину данного BufferedImage

См. также:

getHeight

public int getHeight(ImageObserver observer)

Возвращает высоту BufferedImage.

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

getHeight в классе Image

Параметры:

observer - игнорируется

Возвращает:

высоту данного BufferedImage

См. также:

getSource

public ImageProducer getSource()

Возвращает объект, формирующий пиксели для изображения.

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

getSource в классе Image

Возвращает:

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

См. также:

getProperty

public Object getProperty(String name, ImageObserver observer)

Возвращает свойство изображения по имени. Имена отдельных свойств определяются различными форматами изображений. Если свойство не определено для конкретного изображения, этот метод возвращает поле UndefinedProperty. Если свойства для этого изображения еще не известны, то этот метод возвращает null, а объект ImageObserver будет уведомлен позже. Имя свойства "comment" должно использоваться для хранения необязательного комментария, который может быть представлен пользователю в качестве описания изображения, его источника или автора.

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

getProperty в классе Image

Параметры:

name - имя свойства

observer - ImageObserver, получающий уведомления о сведениях об изображении

Возвращает:

Object, представляющий свойство, на которое указывает заданное name, или null, если свойства этого изображения еще неизвестны.

Исключения:

NullPointerException - если имя свойства равно null.

См. также:

getProperty

public Object getProperty(String name)

Возвращает свойство изображения по имени.

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

getProperty в интерфейсе RenderedImage

Параметры:

name - имя свойства

Возвращает:

объект Object, являющийся свойством, на которое указывает заданное name.

Исключения:

NullPointerException - если имя свойства равно null.

См. также:

getGraphics

public Graphics getGraphics()

Этот метод возвращает Graphics2D, но оставлен для обратной совместимости. Метод createGraphics более удобен, так как он объявлен с возвращаемым типом Graphics2D.

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

getGraphics в классе Image

Возвращает:

Graphics2D, который можно использовать для рисования в этом изображении.

См. также:

createGraphics

public Graphics2D createGraphics()

Создает объект Graphics2D, который можно использовать для рисования в этом BufferedImage.

Возвращает:: Graphics2D, используемый для рисования в этом изображении.

getSubimage

public BufferedImage getSubimage(int x, int y, int w, int h)

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

Параметры:: x - координата X верхнего левого угла заданной прямоугольной области; y - координата Y верхнего левого угла заданной прямоугольной области; w - ширина заданной прямоугольной области; h - высота заданной прямоугольной области
Возвращает:: BufferedImage, являющийся подизображением данного BufferedImage.
Исключения:: RasterFormatException - если заданная область не содержится внутри данного BufferedImage.

isAlphaPremultiplied

public boolean isAlphaPremultiplied()

Возвращает значение, указывающее, было ли предварительно умножено значение альфа. Возвращает false, если альфа-канал отсутствует.

Возвращает:: true, если альфа было предварительно умножено; иначе false.

coerceData

public void coerceData(boolean isAlphaPremultiplied)

Принудительно приводит данные к состоянию, указанному в переменной isAlphaPremultiplied. Метод может умножать или делить растровые данные цвета на альфа-канал, либо ничего не делать, если данные находятся в требуемом состоянии.

Параметры:: isAlphaPremultiplied - true, если альфа предварительно умножено; иначе false.

toString

public String toString()

Возвращает строковое представление String данного объекта BufferedImage и его значений.

Переопределяет:: toString в классе Object
Возвращает:: String, представляющую данный BufferedImage.

getSources

public Vector<RenderedImage> getSources()

Возвращает коллекцию Vector объектов RenderedImage, которые являются непосредственными источниками данных изображения для этого BufferedImage (но не источниками этих непосредственных источников). Этот метод возвращает null, если BufferedImage не содержит сведений о своих непосредственных источниках. Он возвращает пустой Vector, если у BufferedImage нет непосредственных источников.

Определено в:: getSources в интерфейсе RenderedImage
Возвращает:: Vector, содержащий непосредственные источники данных изображения этого объекта BufferedImage, или null, если этот BufferedImage не содержит сведений о своих непосредственных источниках, или пустой Vector, если этот BufferedImage не имеет непосредственных источников.

getPropertyNames

public String[] getPropertyNames()

Возвращает массив имен, распознаваемых методом getProperty(String), или null, если имена свойств не распознаются.

Определено в:: getPropertyNames в интерфейсе RenderedImage
Возвращает:: массив String, содержащий все имена свойств, которые распознает getProperty(String); или null, если никакие имена свойств не распознаются.

getMinX

public int getMinX()

Возвращает минимальную координату X этого BufferedImage. Это значение всегда равно нулю.

Определено в:: getMinX в интерфейсе RenderedImage
Возвращает:: минимальную координату X этого BufferedImage.

getMinY

public int getMinY()

Возвращает минимальную координату Y этого BufferedImage. Это значение всегда равно нулю.

Определено в:: getMinY в интерфейсе RenderedImage
Возвращает:: минимальную координату Y этого BufferedImage.

getSampleModel

public SampleModel getSampleModel()

Возвращает SampleModel, связанный с этим BufferedImage.

Определено в:: getSampleModel в интерфейсе RenderedImage
Возвращает:: SampleModel этого BufferedImage.

getNumXTiles

public int getNumXTiles()

Возвращает количество тайлов в направлении X. Это значение всегда равно единице.

Определено в:: getNumXTiles в интерфейсе RenderedImage
Возвращает:: количество тайлов в направлении X.

getNumYTiles

public int getNumYTiles()

Возвращает количество тайлов в направлении Y. Это значение всегда равно единице.

Определено в:: getNumYTiles в интерфейсе RenderedImage
Возвращает:: количество тайлов в направлении Y.

getMinTileX

public int getMinTileX()

Возвращает минимальный индекс тайла в направлении X. Это значение всегда равно нулю.

Определено в:: getMinTileX в интерфейсе RenderedImage
Возвращает:: минимальный индекс тайла в направлении X.

getMinTileY

public int getMinTileY()

Возвращает минимальный индекс тайла в направлении Y. Это значение всегда равно нулю.

Определено в:: getMinTileY в интерфейсе RenderedImage
Возвращает:: минимальный индекс тайла в направлении Y.

getTileWidth

public int getTileWidth()

Возвращает ширину тайла в пикселях.

Определено в:: getTileWidth в интерфейсе RenderedImage
Возвращает:: ширину тайла в пикселях.

getTileHeight

public int getTileHeight()

Возвращает высоту тайла в пикселях.

Определено в:: getTileHeight в интерфейсе RenderedImage
Возвращает:: высоту тайла в пикселях.

getTileGridXOffset

public int getTileGridXOffset()

Возвращает смещение сетки тайлов по оси X относительно начала координат, например, координату X расположения тайла (0, 0). Это значение всегда равно нулю.

Определено в:: getTileGridXOffset в интерфейсе RenderedImage
Возвращает:: смещение сетки тайлов по оси X.

getTileGridYOffset

public int getTileGridYOffset()

Возвращает смещение сетки тайлов по оси Y относительно начала координат, например, координату Y расположения тайла (0, 0). Это значение всегда равно нулю.

Определено в:: getTileGridYOffset в интерфейсе RenderedImage
Возвращает:: смещение сетки тайлов по оси Y.

getTile

public Raster getTile(int tileX, int tileY)

Возвращает тайл (tileX, tileY). Обратите внимание, что tileX и tileY являются индексами в массиве тайлов, а не координатами пикселей. Возвращаемый объект Raster является активным («живым»), что означает, что он обновляется при изменении изображения.

Определено в:: getTile в интерфейсе RenderedImage
Параметры:: tileX - индекс запрашиваемого тайла по оси X в массиве тайлов; tileY - индекс запрашиваемого тайла по оси Y в массиве тайлов
Возвращает:: Raster, представляющий тайл, заданный аргументами tileX и tileY.
Исключения:: ArrayIndexOutOfBoundsException - если и tileX, и tileY не равны 0

getData

public Raster getData()

Возвращает изображение в виде одного большого тайла. Возвращаемый объект Raster является копией данных изображения и не обновляется при изменении изображения.

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

getData в интерфейсе RenderedImage

Возвращает:

Raster, являющийся копией данных изображения.

См. также:

getData

public Raster getData(Rectangle rect)

Вычисляет и возвращает произвольную область BufferedImage. Возвращаемый объект Raster является копией данных изображения и не обновляется при изменении изображения.

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

getData в интерфейсе RenderedImage

Параметры:

rect - возвращаемая область BufferedImage.

Возвращает:

Raster, являющийся копией данных изображения указанной области BufferedImage

См. также:

copyData

public WritableRaster copyData(WritableRaster outRaster)

Вычисляет произвольную прямоугольную область BufferedImage и копирует ее в указанный WritableRaster. Вычисляемая область определяется границами указанного WritableRaster. Указанный WritableRaster должен иметь SampleModel, совместимый с этим изображением. Если outRaster равен null, создается соответствующий WritableRaster.

Определено в:: copyData в интерфейсе RenderedImage
Параметры:: outRaster - объект WritableRaster для хранения возвращаемой части изображения или null
Возвращает:: ссылку на переданный или созданный объект WritableRaster.

setData

public void setData(Raster r)

Заменяет прямоугольную область изображения содержимым указанного Raster r, который предполагается находящимся в том же координатном пространстве, что и BufferedImage. Операция обрезается по границам BufferedImage.

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

setData в интерфейсе WritableRenderedImage

Параметры:

r - указанный Raster

См. также:

addTileObserver

public void addTileObserver(TileObserver to)

Добавляет наблюдателя тайлов. Если наблюдатель уже присутствует, он будет получать повторяющиеся уведомления.

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

Определено в:: addTileObserver в интерфейсе WritableRenderedImage
Параметры:: to - указанный TileObserver

removeTileObserver

public void removeTileObserver(TileObserver to)

Удаляет наблюдателя тайлов. Если наблюдатель не был зарегистрирован, ничего не происходит. Если наблюдатель был зарегистрирован для нескольких уведомлений, количество его регистраций уменьшается на единицу.

Этот метод игнорирует указанного наблюдателя, так как метод addTileObserver(TileObserver) никого не добавляет.

Определено в:: removeTileObserver в интерфейсе WritableRenderedImage
Параметры:: to - указанный TileObserver.

isTileWritable

public boolean isTileWritable(int tileX, int tileY)

Возвращает значение, указывающее, взят ли тайл в настоящее время для записи. Единственный тайл в BufferedImage находится в позиции (0,0) и всегда доступен для записи, поэтому вызов этого метода с аргументами (0,0) всегда возвращает true, а любые другие координаты приведут к генерации исключения.

Определено в:: isTileWritable в интерфейсе WritableRenderedImage
Параметры:: tileX - индекс тайла по оси X.; tileY - индекс тайла по оси Y.
Возвращает:: true, если тайл с указанными индексами взят для записи; иначе false.
Исключения:: IllegalArgumentException - если либо tileX, либо tileY не равны 0

getWritableTileIndices

public Point[] getWritableTileIndices()

Возвращает массив объектов Point, указывающих, какие тайлы взяты для записи. Возвращает null, если ни один тайл не взят.

Поскольку BufferedImage состоит из одного тайла, и этот тайл всегда открыт для записи, этот метод возвращает массив из одной точки. Кроме того, смещение должно соответствовать getMinTileX() и getMinTileY(), которые в BufferedImage всегда равны (0,0). Это всегда будут координаты единственной возвращенной точки Point.

Определено в:: getWritableTileIndices в интерфейсе WritableRenderedImage
Возвращает:: массив Point, указывающий на тайлы, взятые для записи, или null, если ни один тайл не взят для записи.

hasTileWriters

public boolean hasTileWriters()

Возвращает значение, указывающее, взят ли какой-либо тайл для записи. Семантически эквивалентно

(getWritableTileIndices() != null).

Определено в:: hasTileWriters в интерфейсе WritableRenderedImage
Возвращает:: true, если какой-либо тайл взят для записи; иначе false.

getWritableTile

public WritableRaster getWritableTile(int tileX, int tileY)

Берет тайл для записи. Все зарегистрированные слушатели TileObservers уведомляются, когда тайл переходит из состояния отсутствия пишущих в состояние наличия одного пишущего.

Этот метод безусловно возвращает единственный тайл без проверки переданных значений. Никакие слушатели не уведомляются, так как возвращаемый тайл всегда взят для записи.

Определено в:: getWritableTile в интерфейсе WritableRenderedImage
Параметры:: tileX - индекс тайла по оси X; tileY - индекс тайла по оси Y
Возвращает:: WritableRaster, являющийся тайлом, обозначенным указанными индексами, который берется для записи.

releaseWritableTile

public void releaseWritableTile(int tileX, int tileY)

Отказывается от разрешения на запись в тайл. Если вызывающий продолжит запись в тайл, результат будет неопределенным. Вызовы этого метода должны идти строго в паре с вызовами метода getWritableTile(int, int). Любое другое использование приводит к неопределенным результатам. Все зарегистрированные слушатели TileObservers уведомляются, когда у тайла больше не остается пишущих объектов.

Этот метод немедленно завершает работу без проверки переданных значений. Никакие слушатели не уведомляются, так как единственный тайл всегда открыт для записи.

Определено в:: releaseWritableTile в интерфейсе WritableRenderedImage
Параметры:: tileX - индекс тайла по оси X; tileY - индекс тайла по оси Y

getTransparency

public int getTransparency()

Возвращает прозрачность. Возвращает OPAQUE, BITMASK или TRANSLUCENT.

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

getTransparency в интерфейсе Transparency

Возвращает:

прозрачность этого BufferedImage.

С какого года/версии:

1.5

См. также:

© 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.