Класс BandCombineOp

java.lang.Object

java.awt.image.BandCombineOp

Все реализованные интерфейсы:: RasterOp

public class BandCombineOp extends Object implements RasterOp

Этот класс выполняет произвольную линейную комбинацию полос в Raster с помощью заданной матрицы.

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

Например, к 3-полосному Raster можно применить следующее преобразование каждого пикселя, чтобы инвертировать вторую полосу Raster.

  [ 1.0   0.0   0.0    0.0  ]     [ b1 ]
  [ 0.0  -1.0   0.0  255.0  ]  x  [ b2 ]
  [ 0.0   0.0   1.0    0.0  ]     [ b3 ]
                                  [ 1 ]

Обратите внимание, что исходный и целевой объекты могут совпадать.

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

Конструктор	Описание
`BandCombineOp(float[][] matrix, RenderingHints hints)`	Создает `BandCombineOp` с заданной матрицей.

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

Модификатор и тип	Метод	Описание
`WritableRaster`	`createCompatibleDestRaster(Raster src)`	Создает обнуленный целевой `Raster` с правильными размером и числом полос.
`WritableRaster`	`filter(Raster src, WritableRaster dst)`	Преобразует `Raster` с помощью матрицы, заданной в конструкторе.
`final Rectangle2D`	`getBounds2D(Raster src)`	Возвращает ограничивающую рамку преобразованного целевого изображения.
`final float[][]`	`getMatrix()`	Возвращает копию матрицы линейной комбинации.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает положение соответствующей точки целевого изображения для точки в исходном `Raster`.
`final RenderingHints`	`getRenderingHints()`	Возвращает подсказки рендеринга для этой операции.

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

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

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

BandCombineOp

public BandCombineOp(float[][] matrix, RenderingHints hints)

Создает BandCombineOp с заданной матрицей. Ширина матрицы должна быть равна числу полос в исходном Raster, возможно, увеличенному на единицу. Если столбцов матрицы на один больше, чем полос, в конце вектора значений полос, представляющего пиксель, подразумевается значение 1. Высота матрицы должна быть равна числу полос в целевом изображении.

Первый индекс указывает номер строки, а второй — номер столбца. Эта операция не использует ни одну из текущих подсказок рендеринга; аргумент RenderingHints может быть равен null.

Параметры:: matrix — Матрица, используемая для объединения полос.; hints — Объект RenderingHints для этой операции. В настоящее время не используется, поэтому может быть равен null.

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

getMatrix

public final float[][] getMatrix()

Возвращает копию матрицы линейной комбинации.

Возвращает:: Матрицу, связанную с этой операцией объединения полос.

filter

public WritableRaster filter(Raster src, WritableRaster dst)

Преобразует Raster с помощью матрицы, заданной в конструкторе. Может быть выброшено исключение IllegalArgumentException, если число полос в исходном или целевом изображении несовместимо с матрицей. Подробнее см. комментарии к классу.

Если целевое изображение равно null, оно будет создано с числом полос, равным числу строк матрицы. Исключение не выбрасывается, если в результате операции происходит переполнение данных.

Определено в:: filter в интерфейсе RasterOp
Параметры:: src — Фильтруемый Raster.; dst — Raster, в котором сохраняются результаты фильтрации.
Возвращает:: Отфильтрованный Raster.
Выбрасывает:: IllegalArgumentException — Если число полос в исходном или целевом изображении несовместимо с матрицей.

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

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

Определено в:: getBounds2D в интерфейсе RasterOp
Параметры:: src — Фильтруемый Raster.
Возвращает:: Rectangle2D, представляющий ограничивающую рамку целевого изображения.
Выбрасывает:: IllegalArgumentException — Если число полос в исходном изображении несовместимо с матрицей.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

Создает обнуленный целевой Raster с правильными размером и числом полос. Может быть выброшено исключение IllegalArgumentException, если число полос в исходном изображении несовместимо с матрицей. Подробнее см. комментарии к классу.

Определено в:: createCompatibleDestRaster в интерфейсе RasterOp
Параметры:: src — Фильтруемый Raster.
Возвращает:: Обнуленный целевой Raster.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)

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

Определено в:: getPoint2D в интерфейсе RasterOp
Параметры:: srcPt — Point2D, представляющая точку в исходном Raster; dstPt — Point2D, в котором сохраняется результат.
Возвращает:: Point2D в целевом изображении, соответствующую заданной точке в исходном изображении.

getRenderingHints

public final RenderingHints getRenderingHints()

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

Определено в:: getRenderingHints в интерфейсе RasterOp
Возвращает:: Объект RenderingHints, связанный с этой операцией. Возвращает null, если подсказки не заданы.

© 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/BandCombineOp.html