Класс BufferedImage

public static final int TYPE_CUSTOM

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

public static final int TYPE_INT_RGB

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

public static final int TYPE_INT_ARGB

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

public static final int TYPE_INT_ARGB_PRE

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

public static final int TYPE_INT_BGR

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

public static final int TYPE_3BYTE_BGR

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

public static final int TYPE_4BYTE_ABGR

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

public static final int TYPE_4BYTE_ABGR_PRE

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

public static final int TYPE_USHORT_565_RGB

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

public static final int TYPE_USHORT_555_RGB

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

public static final int TYPE_BYTE_GRAY

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

public static final int TYPE_USHORT_GRAY

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

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 палитре.

public static final int TYPE_BYTE_INDEXED

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

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

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

Конструирует BufferedImage одного из предопределённых типов изображений. Цветовое пространство изображения — стандартное sRGB.

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.

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

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

public int getType()

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

public ColorModel getColorModel()

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

public WritableRaster getRaster()

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

public WritableRaster getAlphaRaster()

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

public int getRGB(int x, int y)

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

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

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)]; 

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

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

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

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

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)];
 

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

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

public int getWidth()

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

public int getHeight()

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

public int getWidth(ImageObserver observer)

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

public int getHeight(ImageObserver observer)

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

public ImageProducer getSource()

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

public Object getProperty(String name, ImageObserver observer)

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

public Object getProperty(String name)

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

public Graphics getGraphics()

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

public Graphics2D createGraphics()

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

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

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

public boolean isAlphaPremultiplied()

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

public void coerceData(boolean isAlphaPremultiplied)

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

public String toString()

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

public Vector<RenderedImage> getSources()

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

public String[] getPropertyNames()

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

public int getMinX()

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

public int getMinY()

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

public SampleModel getSampleModel()

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

public int getNumXTiles()

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

public int getNumYTiles()

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

public int getMinTileX()

Возвращает минимальный индекс тайла в направлении x. Всегда возвращает ноль.

public int getMinTileY()

Возвращает минимальный индекс тайла в направлении y. Всегда возвращает ноль.

public int getTileWidth()

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

public int getTileHeight()

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

public int getTileGridXOffset()

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

public int getTileGridYOffset()

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

public Raster getTile(int tileX, int tileY)

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

public Raster getData()

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

public Raster getData(Rectangle rect)

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

public WritableRaster copyData(WritableRaster outRaster)

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

public void setData(Raster r)

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

public void addTileObserver(TileObserver to)

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

public void removeTileObserver(TileObserver to)

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

public boolean isTileWritable(int tileX, int tileY)

Возвращает значение, указывающее, взята ли плитка для записи.

public Point[] getWritableTileIndices()

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

public boolean hasTileWriters()

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

 (getWritableTileIndices() != null).
 

public WritableRaster getWritableTile(int tileX, int tileY)

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

public void releaseWritableTile(int tileX, int tileY)

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

public int getTransparency()

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