Класс 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

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

public static final int TYPE_USHORT_GRAY

Представляет изображение в градациях серого с неподписанным типом короткое целое, не индексированное). Это изображение имеет 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 кроме 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 - это индексы в массиве тайлов, а не координаты пикселей. Возвращаемый тайл является динамичным, т.е. он обновляется при изменении изображения.

public Raster getData()

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

public Raster getData(Rectangle rect)

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

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)

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

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

public void removeTileObserver(TileObserver to)

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

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

public boolean isTileWritable(int tileX, int tileY)

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

public Point[] getWritableTileIndices()

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

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

public boolean hasTileWriters()

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

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