ColorConvertOp (Java Platform SE 8 )

java.lang.Object
- java.awt.image.ColorConvertOp

All Implemented Interfaces:

BufferedImageOp， RasterOp
```
public class ColorConvertOp
extends Object
implements BufferedImageOp, RasterOp
```
这个类执行一个像素的像素颜色转换的源图像中的数据。将所得到的颜色值缩放到目标图像的精度。色彩转换可以通过指定的颜色空间的icc_profile对象或对象数组的数组。
如果源是一个预乘alpha BufferedImage，颜色分量除以alpha分量在颜色转换。如果目标是一个预乘alpha BufferedImage，颜色分量乘以alpha分量转换后。光栅作为没有Alpha通道，即所有带颜色带。

如果一个renderinghints对象在构造函数中指定的颜色，渲染提示和抖动暗示可以用来控制颜色转换。

请注意，源和目标可能是同一个对象。

另请参见：

RenderingHints.KEY_COLOR_RENDERING， RenderingHints.KEY_DITHERING

构造方法摘要

构造方法
Constructor and Description
`ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)` 从两个空间对象构造一个新的colorconvertop。
`ColorConvertOp(ColorSpace cspace, RenderingHints hints)` 构建了从一个色彩空间对象的新colorconvertop。
`ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)` 结构的数组的一个新的colorconvertop icc_profiles。
`ColorConvertOp(RenderingHints hints)` 构建了一个新的ColorConvertOp将从源色彩空间转换到目标颜色空间。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)` 创建一个锁定目的地形象与正确的尺寸和数量的乐队，这个源。
`WritableRaster`	`createCompatibleDestRaster(Raster src)` 创建一个锁定目标栅格与正确的尺寸和数量的乐队，这个源。
`BufferedImage`	`filter(BufferedImage src, BufferedImage dest)` colorconverts源BufferedImage。
`WritableRaster`	`filter(Raster src, WritableRaster dest)` colorconverts在源栅格图像数据。
`Rectangle2D`	`getBounds2D(BufferedImage src)` 返回目标的包围盒，给定此源。
`Rectangle2D`	`getBounds2D(Raster src)` 返回目标的包围盒，给定此源。
`ICC_Profile[]`	`getICC_Profiles()` 返回用于构建ColorConvertOp icc_profiles阵列。
`Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)` 返回源中给定一个点的目标点的位置。
`RenderingHints`	`getRenderingHints()` 返回本作品用于渲染的提示

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ColorConvertOp
```
public ColorConvertOp(RenderingHints hints)
```
    构建了一个新的ColorConvertOp将从源色彩空间转换到目标颜色空间。的renderinghints参数可以为null。这种运算只能用于bufferedimages，并将直接从源图像的颜色空间到目的地。过滤器方法的目的参数不能被指定为空。
    
    参数
    
    hints -用来控制颜色的转换 RenderingHints对象，或 null
  - ColorConvertOp
```
public ColorConvertOp(ColorSpace cspace,
                      RenderingHints hints)
```
    构建了从一个色彩空间对象的新colorconvertop。的renderinghints参数可以为null。这种运算只能用于bufferedimages，主要是有用的当 filter方法与零目标参数调用。在这种情况下，色彩空间定义的过滤方法创建的目标目标色彩空间。否则，色彩空间定义一个中间空间的来源是之前被转换为目标空间转换。
    
    参数
    
    cspace -定义目标 ColorSpace或中间 ColorSpace
    
    hints -用来控制颜色的转换 RenderingHints对象，或 null
    
    异常
    
    如果 NullPointerException Cspace是空的
  - ColorConvertOp
```
public ColorConvertOp(ColorSpace srcCspace,
                      ColorSpace dstCspace,
                      RenderingHints hints)
```
    从两个空间对象构造一个新的colorconvertop。的renderinghints参数可以为null。这种运算要求的光栅滤波器的方法是有用的，在这种情况下，两个颜色空间的定义是对光栅进行操作。在这种情况下，在源光栅带的数量必须匹配元件srccspace数，和在目的地的光栅带的数量必须匹配元件dstcspace数。对于BufferedImages，这两个颜色定义的中间空间通过这个源是之前被转换为目标空间转换。
    
    参数
    
    srcCspace -源 ColorSpace
    
    dstCspace -目的地 ColorSpace
    
    hints -用来控制颜色的转换 RenderingHints对象，或 null
    
    异常
    
    NullPointerException -如果srccspace或dstcspace是空的
  - ColorConvertOp
```
public ColorConvertOp(ICC_Profile[] profiles,
                      RenderingHints hints)
```
    结构的数组的一个新的colorconvertop icc_profiles。的renderinghints参数可以为null。配置文件的序列可能包括代表颜色空间的配置文件，表示效果的配置文件等。如果整个序列不代表一个定义良好的颜色转换，则抛出一个异常。
    BufferedImages，如果源BufferedImage ColorSpace不匹配的数组中的第一个文件的要求，首先是一个合适的色彩空间转换。如果数组中的最后一个文件不符合要求的用目的BufferedImage色彩转换，最后到目的地的色彩。
    
    Rasters，在源光栅带的数量必须与数组中的第一个文件的要求，并在目的光栅带的数量必须与数组中的最后一个文件的要求。数组必须至少有两个元素或呼吁Rasters滤波方法将抛出一个时。
    
    参数
    
    profiles - ICC_Profile对象数组
    
    hints -用来控制颜色的转换 RenderingHints对象，或 null
    
    异常
    
    IllegalArgumentException当剖面层序不指定明确的色彩转换
    
    如果配置文件是空的 NullPointerException
- 方法详细信息
  - getICC_Profiles
```
public final ICC_Profile[] getICC_Profiles()
```
    返回用于构建ColorConvertOp icc_profiles阵列。如果ColorConvertOp不是由这样的一个数组返回null。
    
    结果
    
    对这 ColorConvertOp ICC_Profile对象数组，或 null如果这 ColorConvertOp并不与 ICC_Profile对象数组构造。
  - filter
```
public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dest)
```
    colorconverts源BufferedImage。如果目标图像是空，一BufferedImage将用适当的色彩模型创建。
    
    Specified by:
    
    filter 接口 BufferedImageOp
    
    参数
    
    src -源 BufferedImage要转换
    
    dest -目的地 BufferedImage，或 null
    
    结果
    
    dest颜色转换 src还是一个新的转换 BufferedImage如果 dest是 null
    
    异常
    
    IllegalArgumentException -如果dest是无效的，这同是使用只需要renderinghints实参的构造函数构造，由于其操作定义。
  - filter
```
public final WritableRaster filter(Raster src,
                                   WritableRaster dest)
```
    colorconverts在源栅格图像数据。如果目标光栅为空，将创建一个新的光栅。在源和目的地Rasters带的数量必须满足上面的说明。构造函数用于创建此colorconvertop必须提供足够的信息来定义源和目标色彩空间。上面看到的。否则，抛出一个异常。
    
    Specified by:
    
    filter 接口 RasterOp
    
    参数
    
    src -源 Raster要转换
    
    dest -目的地 WritableRaster，或 null
    
    结果
    
    dest颜色转换 src还是一个新的转换 WritableRaster如果 dest是 null
    
    异常
    
    IllegalArgumentException如果源或目的条带的数量是不正确的，源或目标颜色空间是不确定的，或这OP的一个构造函数只适用于操作bufferedimages构造。
  - getBounds2D
```
public final Rectangle2D getBounds2D(BufferedImage src)
```
    返回目标的包围盒，给定此源。请注意，这将是相同的源的包围盒。
    
    Specified by:
    
    getBounds2D 接口 BufferedImageOp
    
    参数
    
    src -源 BufferedImage
    
    结果
    
    一个 Rectangle2D是目的地的包围盒，给指定的 src
  - getBounds2D
```
public final Rectangle2D getBounds2D(Raster src)
```
    返回目标的包围盒，给定此源。请注意，这将是相同的源的包围盒。
    
    Specified by:
    
    getBounds2D 接口 RasterOp
    
    参数
    
    src -源 Raster
    
    结果
    
    一个 Rectangle2D是目的地的包围盒，给指定的 src
  - createCompatibleDestImage
```
public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)
```
    创建一个锁定目的地形象与正确的尺寸和数量的乐队，这个源。
    
    Specified by:
    
    createCompatibleDestImage 接口 BufferedImageOp
    
    参数
    
    src -过滤操作的源图像。
    
    destCM -目的地ColorModel。如果为空，将使用一个适当的要。
    
    结果
    
    一个从指定的 src正确的尺寸和数量的带 BufferedImage。
    
    异常
    
    IllegalArgumentException -如果 destCM是 null这 ColorConvertOp创建没有任何 ICC_Profile或 ColorSpace为目标定义
  - createCompatibleDestRaster
```
public WritableRaster createCompatibleDestRaster(Raster src)
```
    创建一个锁定目标栅格与正确的尺寸和数量的乐队，这个源。
    
    Specified by:
    
    createCompatibleDestRaster 接口 RasterOp
    
    参数
    
    src -指定 Raster
    
    结果
    
    一个从指定的 src正确的尺寸和数量的带 WritableRaster
    
    异常
    
    IllegalArgumentException -如果这 ColorConvertOp创建没有足够的信息来确定 dst和 src颜色空间
  - getPoint2D
```
public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)
```
    返回源中给定一个点的目标点的位置。如果 dstPt是非空的，它会被用来保存返回值。请注意，对于这个类，目标点将与源点相同。
    
    Specified by:
    
    getPoint2D 接口 BufferedImageOp
    
    Specified by:
    
    getPoint2D 接口 RasterOp
    
    参数
    
    srcPt -指定的源 Point2D
    
    dstPt -目的地 Point2D
    
    结果
    
    在设置它的位置是相同的 dstPt srcPt
  - getRenderingHints
```
public final RenderingHints getRenderingHints()
```
    返回本作品用于渲染的提示
    
    Specified by:
    
    getRenderingHints 接口 BufferedImageOp
    
    Specified by:
    
    getRenderingHints 接口 RasterOp
    
    结果
    
    这 ColorConvertOp的 RenderingHints对象

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ColorConvertOp

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

ColorConvertOp

ColorConvertOp

ColorConvertOp

ColorConvertOp

方法详细信息

getICC_Profiles

filter

filter

getBounds2D

getBounds2D

createCompatibleDestImage

createCompatibleDestRaster

getPoint2D

getRenderingHints