Класс BandCombineOp

java.lang.Object

java.awt.image.BandCombineOp

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

public class BandCombineOp extends Object implements RasterOp

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

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

Например, к трёхполосному 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

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

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

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.