java.awt.image

Class RescaleOp

java.lang.Object

java.awt.image.RescaleOp

All Implemented Interfaces:

BufferedImageOp， RasterOp

public class RescaleOp
extends Object
implements BufferedImageOp, RasterOp

这类的样本值乘以每个像素由一个比例因子，然后加上一个偏移量执行由源图像中的像素的像素数据转换。规模的样本值夹到最小/最大可在目的地形象。

的缩放操作的伪代码如下：

对于从源对象{的每个像素对于每一个波段/像素的像素dstelement =（srcelement×比例因子）+偏移}}

Rasters，缩放操作带。缩放常数的集合的数目可以是一个，在这种情况下，相同的常数被施加到所有的频带，或它必须等于源光栅带的数目。

对于bufferedimages，缩放操作的颜色和alpha分量。缩放常数的集合的数量可能是一个，在这种情况下，相同的常量适用于所有颜色（但不是α）组件。否则，对比例常数集数可能等于源颜色组件的数量，在这种情况下，无标度的alpha分量（如果存在的话）进行。如果这些情况不适用，对比例常数集数必须等于光源的颜色成分加α组件的数量，在这种情况下，所有的颜色和alpha分量法。

与数据源进行αBufferedImage都以同样的方式处理非规则用于缩放图像。那就是，重新调整了每个乐队在不考虑数据源的BufferedImage进行原始数据。如果颜色转换需要的目标，进行状态的源和目的将这一步考虑。

一个indexcolormodel图像不能被调整。

如果一个renderinghints对象在构造函数中指定的颜色，渲染提示和抖动提示时可使用颜色转换是必需的。

请注意，在地方操作是允许的（即源和目的地可以是同一个对象）。

另请参见：

RenderingHints.KEY_COLOR_RENDERING， RenderingHints.KEY_DITHERING

构造方法摘要

构造方法

Constructor and Description
RescaleOp(float[] scaleFactors, float[] offsets, RenderingHints hints) 构建所需的尺度因子和偏移量的一个新的rescaleop。
RescaleOp(float scaleFactor, float offset, RenderingHints hints) 构建与希望的比例因子的一个新的rescaleop和偏移。

方法摘要

Modifier and Type	Method and Description
BufferedImage	createCompatibleDestImage(BufferedImage src, ColorModel destCM) 创建一个锁定目的地形象与正确的大小和数量的频带。
WritableRaster	createCompatibleDestRaster(Raster src) 创建一个锁定目标 Raster与正确的尺寸和数量的乐队，这个源。
BufferedImage	filter(BufferedImage src, BufferedImage dst) 重新调整源BufferedImage。
WritableRaster	filter(Raster src, WritableRaster dst) 重新调整的源栅格像素数据。
Rectangle2D	getBounds2D(BufferedImage src) 返回重新调整目标图像的边界框。
Rectangle2D	getBounds2D(Raster src) 返回重新调整的目的光栅包围盒。
int	getNumFactors() 返回数的缩放因子和偏移量进行rescaleop。
float[]	getOffsets(float[] offsets) 返回给定数组中的偏移量。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) 返回源中给定一个点的目标点的位置。
RenderingHints	getRenderingHints() 返回渲染暗示这个作品。
float[]	getScaleFactors(float[] scaleFactors) 返回给定数组中的比例因子。

Methods inherited from class java.lang.Object

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

Constructor Detail

RescaleOp

public RescaleOp(float[] scaleFactors,
                 float[] offsets,
                 RenderingHints hints)

构建所需的尺度因子和偏移量的一个新的rescaleop。的比例因子和偏移数组的长度必须满足以上规定的限制类的评论。的renderinghints参数可以为null。

参数

scaleFactors -指定比例因子

offsets -指定的偏移量

hints -指定 RenderingHints，或 null

RescaleOp

public RescaleOp(float scaleFactor,
                 float offset,
                 RenderingHints hints)

构建与希望的比例因子的一个新的rescaleop和偏移。比例因子和偏移将适用于在源栅格所有乐队和所有的颜色（但不是α）在BufferedImage组件。的renderinghints参数可以为null。

参数

scaleFactor -指定比例因子

offset -指定的偏移量

hints -指定 RenderingHints，或 null

方法详细信息

getScaleFactors

public final float[] getScaleFactors(float[] scaleFactors)

返回给定数组中的比例因子。该数组还返回方便。如果尺度是空的，一个新的数组将被分配。

参数

scaleFactors -数组包含这 RescaleOp规模因素

结果

这 RescaleOp规模因素。

getOffsets

public final float[] getOffsets(float[] offsets)

返回给定数组中的偏移量。该数组还返回方便。如果偏移量为空，将分配一个新的数组。

参数

offsets -数组包含这 RescaleOp偏移

结果

这 RescaleOp偏移。

getNumFactors

public final int getNumFactors()

返回数的缩放因子和偏移量进行rescaleop。

结果

的缩放因子和偏移，这 RescaleOp数。

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

重新调整源BufferedImage。如果源图像中的颜色模型与目标图像中的颜色不相同，则将在目标中转换像素。如果目标图像是空，一BufferedImage将要创建的源。IllegalArgumentException可能如果大量结垢因素/抵消这个对象不符合上述规定的限制类言论抛出，或如果源图像有一个indexcolormodel。

Specified by:

filter 接口 BufferedImageOp

参数

src - BufferedImage被过滤

dst -过滤操作或 null目的地

结果

过滤后的 BufferedImage。

异常

IllegalArgumentException -如果 src的 ColorModel是 IndexColorModel，或者缩放因子和偏移量在这 RescaleOp数量不符合在类注释的规定。

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

重新调整的源栅格像素数据。如果目标光栅为空，将创建一个新的光栅。源和目的地必须具有相同的带数。否则，IllegalArgumentException是抛出。请注意，在这个对象中的缩放因子/偏移量的数量必须满足上述类评论中所述的限制。否则，IllegalArgumentException是抛出。

Specified by:

filter 接口 RasterOp

参数

src - Raster被过滤

dst -过滤操作或 null目的地

结果

过滤后的 WritableRaster。

异常

IllegalArgumentException -如果 src和 dst没有带数相同，或者如果缩放因子和偏移量在这 RescaleOp数量不符合在类注释的规定。

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

返回重新调整目标图像的边界框。由于这不是一个几何操作，包围盒不改变。

Specified by:

getBounds2D 接口 BufferedImageOp

参数

src - BufferedImage被过滤

结果

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

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

返回重新调整的目的光栅包围盒。由于这不是一个几何操作，包围盒不改变。

Specified by:

getBounds2D 接口 RasterOp

参数

src -重新调整的目的 Raster

结果

指定的 Raster界限。

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

创建一个锁定目的地形象与正确的大小和数量的频带。

Specified by:

createCompatibleDestImage 接口 BufferedImageOp

参数

src -过滤操作的源图像。

destCM -目的地ColorModel。如果为空，源的要会用。

结果

就目的地形象。

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

创建一个锁定目标 Raster与正确的尺寸和数量的乐队，这个源。

Specified by:

createCompatibleDestRaster 接口 RasterOp

参数

src -源 Raster

结果

就目的地 Raster。

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

返回源中给定一个点的目标点的位置。如果dstpt是非空的，它会被用来保存返回值。因为这不是一个几何操作的srcpt将等于dstpt。

Specified by:

getPoint2D 接口 BufferedImageOp

Specified by:

getPoint2D 接口 RasterOp

参数

srcPt -源图像中的一个点

dstPt -目的地或 null

结果

目标点的位置。

getRenderingHints

public final RenderingHints getRenderingHints()

返回渲染暗示这个作品。

Specified by:

getRenderingHints 接口 BufferedImageOp

Specified by:

getRenderingHints 接口 RasterOp

结果

这 RescaleOp渲染的提示。