java.awt.image

Class BandCombineOp

java.lang.Object

java.awt.image.BandCombineOp

All Implemented Interfaces:

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 ] 

请注意，源和目的地可以是同一个对象。

构造方法摘要

构造方法

Constructor and Description
BandCombineOp(float[][] matrix, RenderingHints hints) 用指定的矩阵构造一个 BandCombineOp 。

方法摘要

Modifier and Type	Method and Description
WritableRaster	createCompatibleDestRaster(Raster src) 创建带有正确大小和频带数的零目的地 Raster 。
WritableRaster	filter(Raster src, WritableRaster dst) 变换 Raster使用在构造函数中指定的矩阵。
Rectangle2D	getBounds2D(Raster src) 返回已转换目的地的边界框。
float[][]	getMatrix() 返回线性组合矩阵的副本。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) 返回源 Raster给定点的对应目标点的位置。
RenderingHints	getRenderingHints() 返回此操作的呈现提示。

Methods inherited from class java.lang.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 。 有关详细信息，请参阅课堂评论。

如果目的地为空，则将创建具有等于矩阵中行数的频带数。 如果操作导致数据溢出，则不会抛出异常。

Specified by:

filter在接口 RasterOp

参数

src - 要过滤的 Raster 。

dst -该 Raster在其中存储所述滤波操作的结果。

结果

过滤后的 Raster 。

异常

IllegalArgumentException - 如果源或目的地的频带数与矩阵不兼容。

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

返回已转换目的地的边界框。 由于这不是几何操作，所以边界框对于源和目的地是相同的。 一个IllegalArgumentException如果在源频带的数目是与基质不相容时可能抛出。 有关详细信息，请参阅课堂评论。

Specified by:

getBounds2D在界面 RasterOp

参数

src - 要过滤的 Raster 。

结果

Rectangle2D代表目的地图像的边界框。

异常

IllegalArgumentException - 如果源中的频带数与矩阵不兼容。

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

创建带有正确大小和频带数的零目的地Raster 。 一个IllegalArgumentException如果在源频带的数目是与基质不相容时可能抛出。 有关详细信息，请参阅课堂评论。

Specified by:

createCompatibleDestRaster在接口 RasterOp

参数

src - 要过滤的 Raster 。

结果

零目的地 Raster 。

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

返回源Raster给定点的相应目标点的位置。 如果dstPt dstPt，则用于保存返回值。 由于这不是几何操作，返回的点与指定的srcPt srcPt 。

Specified by:

getPoint2D在界面 RasterOp

参数

srcPt - Point2D代表源中的点 Raster

dstPt - 存储结果的 Point2D 。

结果

所述 Point2D对应于源图像中指定的点的目标图像。

getRenderingHints

public final RenderingHints getRenderingHints()

返回此操作的呈现提示。

Specified by:

getRenderingHints在界面 RasterOp

结果

The RenderingHints object associated with this operation. Returns null if no hints have been set.