java.awt.image
클래스 ColorConvertOp

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

모든 구현된 인터페이스:

BufferedImageOp, RasterOp

public class ColorConvertOp
extends Object 
implements BufferedImageOp,
 RasterOp 

이 클래스는 소스 이미지의 데이터의 색변환을 픽셀 단위로 실행합니다. 결과의 컬러치는 목적지 이미지의 정밀도에 맞추어 슬캘링 됩니다. 색변환은 ColorSpace 객체의 배열 또는 ICC_Profile 객체의 배열을 개입시켜 지정할 수 있습니다.

미리 알파가 곱셈되고 있는 BufferedImage가 소스인 경우, 색성분은 색변환전에 알파 성분으로 제산됩니다. 목적지가 미리 알파가 곱셈된 BufferedImage인 경우, 색성분은 변환의 후에 알파 성분에 의해 곱셈됩니다. Raster는 알파 채널을 가지지 않는 것으로서 처리됩니다. 즉, 모든 밴드가 컬러 밴드입니다.

RenderingHints 객체가 생성자 으로 가리키는 경우는 컬러 렌더링 힌트 및 디저링 힌트를 사용해 색변환을 제어할 수 있습니다.

소스와 목적지에는 같은 객체를 지정할 수 있습니다.

관련 항목:

RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

생성자 개요

ColorConvertOp (ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)
2개의 ColorSpace 객체로부터 새로운 ColorConvertOp를 구축합니다.

ColorConvertOp (ColorSpace cspace, RenderingHints hints)
ColorSpace 객체로부터 새로운 ColorConvertOp를 구축합니다.

ColorConvertOp (ICC_Profile [] profiles, RenderingHints hints)
ICC_Profile 배열로부터 새로운 ColorConvertOp를 구축합니다.

ColorConvertOp (RenderingHints hints)
소스 컬러 영역에서 목적지 컬러 영역로 변환하는 새로운 ColorConvertOp를 구축합니다.

메서드 개요

BufferedImage	createCompatibleDestImage (BufferedImage src, ColorModel destCM) 이 소스를 지정해, 적절한 사이즈 및 밴드수로 제로화 된 목적지 이미지를 작성합니다.
WritableRaster	createCompatibleDestRaster (Raster src) 지정된 소스로 올바른 사이즈 및 밴드수를 가지는 제로화 된 목적지 Raster를 작성합니다.
BufferedImage	filter (BufferedImage src, BufferedImage dest) 소스 BufferedImage 로 ColorConvert를 실행합니다.
WritableRaster	filter (Raster src, WritableRaster dest) 소스 Raster 이미지 데이터로 ColorConvert를 실행합니다.
Rectangle2D	getBounds2D (BufferedImage src) 이 소스를 지정해, 목적지의 바운딩박스를 리턴합니다.
Rectangle2D	getBounds2D (Raster src) 이 소스를 지정해, 목적지의 바운딩박스를 리턴합니다.
ICC_Profile []	getICC_Profiles () 이 ColorConvertOp를 구축하기 위해서 사용되는 ICC_Profile 배열을 리턴합니다.
Point2D	getPoint2D (Point2D srcPt, Point2D dstPt) 소스의 포인트를 지정해, 목적지의 포인트의 위치를 리턴합니다.
RenderingHints	getRenderingHints () 이 조작으로 사용되는 렌더링 힌트를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

ColorConvertOp

public ColorConvertOp(RenderingHints  hints)

소스 컬러 영역에서 목적지 컬러 영역로 변환하는 새로운 ColorConvertOp를 구축합니다. RenderingHints 인수에는 null도 지정할 수 있습니다. 이 조작은 BufferedImage와 만 사용할 수가 있어 소스 이미지의 ColorSpace 로부터 목적지의 ColorSpace에 직접 변환합니다. 필터 메서드의 목적지 인수에는 null을 지정할 수 없습니다.

파라미터:

hints - 색변환의 제어에 사용하는 RenderingHints 객체, 또는 null

ColorConvertOp

public ColorConvertOp(ColorSpace  cspace,
                      RenderingHints  hints)

ColorSpace 객체로부터 새로운 ColorConvertOp를 구축합니다. RenderingHints 인수에는 null도 지정할 수 있습니다. 이 조작은 BufferedImage와 만 사용할 수 있어 주로 목적지 인수가 null 로 filter 메서드가 불려 갔을 때에 유효합니다. 그 경우, ColorSpace는 필터 메서드에 의해 작성되는 목적지의 목적지 컬러 영역를 정의합니다. 그렇지 않은 경우, ColorSpace는 목적지 영역에 변환되기 전에 소스가 변환되는 중간 영역을 정의합니다.

파라미터:

cspace - 목적지의 ColorSpace 또는 중간 ColorSpace를 정의합니다.

hints - 색변환의 제어에 사용하는 RenderingHints 객체, 또는 null

예외:

NullPointerException - cspace가 null인 경우

ColorConvertOp

public ColorConvertOp(ColorSpace  srcCspace,
                      ColorSpace  dstCspace,
                      RenderingHints  hints)

2개의 ColorSpace 객체로부터 새로운 ColorConvertOp를 구축합니다. RenderingHints 인수에는 null도 지정할 수 있습니다. 이 조작은 주로 Raster 로 필터 메서드를 호출할 때 유효합니다. 그 경우, 2개의 ColorSpace가 Raster 로 실행되는 조작을 정의합니다. 그 경우, 소스 Raster 밴드수는 srcCspace 성분수로 일치할 필요가 있어, 목적지 Raster 밴드수는 dstCspace 성분수로 일치할 필요가 있습니다. BufferedImage인 경우, 2개의 ColorSpace는 목적지 영역에 변환되기 전에 소스가 변환되는 중간 영역을 정의합니다.

파라미터:

srcCspace - 소스의 ColorSpace

dstCspace - 목적지의 ColorSpace

hints - 색변환의 제어에 사용하는 RenderingHints 객체, 또는 null

예외:

NullPointerException - srcCspace 또는 dstCspace가 null인 경우

ColorConvertOp

public ColorConvertOp(ICC_Profile [] profiles,
                      RenderingHints  hints)

ICC_Profile 배열로부터 새로운 ColorConvertOp를 구축합니다. RenderingHints 인수에는 null도 지정할 수 있습니다. 일련의 프로파일에는 컬러 영역를 나타내는 프로파일, 효과를 나타내는 프로파일등도 포함할 수 있습니다 . 이 일련의 프로파일 전체가 색변환을 적절히 정의하지 않는 경우는 예외가 발생 됩니다.

BufferedImage인 경우, 소스 BufferedImage ColorSpace가 배열의 최초의 프로파일의 요건과 일치하지 않는 경우에는 최초의 변환은 적절한 ColorSpace에 대해서 행해집니다. 배열의 마지막 프로파일의 요건이 목적지 BufferedImage ColorSpace와 일치하지 않는 경우, 마지막 변환은 목적지의 ColorSpace에 대해서 행해집니다.

Raster인 경우, 소스 Raster 밴드수는 배열의 최초의 프로파일의 요건과 일치할 필요가 있어, 목적지 Raster 밴드수는 배열의 마지막 프로파일의 요건과 일치할 필요가 있습니다. 배열은 2개 이상의 요소를 가질 필요가 있어, 그렇지 않은 경우, Raster에 대해서 필터 메서드를 호출하면 IllegalArgumentException가 발생 됩니다.

파라미터:

profiles - ICC_Profile 객체의 배열

hints - 색변환의 제어에 사용하는 RenderingHints 객체, 또는 null

예외:

IllegalArgumentException - 일련의 프로파일에 의해 명확한 색변환이 지정되어 있지 않은 경우

NullPointerException - 프로파일이 null인 경우

메서드의 상세

getICC_Profiles

public final ICC_Profile [] getICC_Profiles()

이 ColorConvertOp를 구축하기 위해서 사용되는 ICC_Profile 배열을 리턴합니다. ColorConvertOp가 그러한 배열로 구축되지 않았던 경우는 null을 리턴합니다.

반환값:

이 ColorConvertOp ICC_Profile 배열. 이 ColorConvertOp가 ICC_Profile 객체의 배열로 구축되지 않았던 경우는 null

filter

public final BufferedImage  filter(BufferedImage  src,
                                  BufferedImage  dest)

소스 BufferedImage 로 ColorConvert를 실행합니다. 목적지 이미지가 null인 경우, BufferedImage는 적절한 ColorModel 로 작성됩니다.

정의:

인터페이스 BufferedImageOp 내의 filter

파라미터:

src - 변환되는 소스 BufferedImage

dest - 목적지 BufferedImage, 또는 null

반환값:

src로 부터 변환된 dest 색, 또는 새롭게 변환된 BufferedImage (dest이 null인 경우)

예외:

IllegalArgumentException - dest가 null 이며, 이 조작이 RenderingHints 인수만을 취하는 생성자를 사용해 구축되었을 경우 (조작의 정의가 부적절하기 때문에)

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dest)

소스 Raster 이미지 데이터로 ColorConvert를 실행합니다. 목적지 Raster가 null인 경우는 새로운 Raster가 작성됩니다. 소스와 목적지의 Raster 밴드수는 위에서 설명한 바와 같이 요건과 일치할 필요가 있습니다. 이 ColorConvertOp를 작성하기 위해서 사용되는 생성자는 소스와 목적지의 컬러 영역를 정의하는데 충분한 정보를 제공할 필요가 있습니다. 상술을 참조하십시오. 그렇지 않은 경우는 예외가 발생 됩니다.

정의:

인터페이스 RasterOp 내의 filter

파라미터:

src - 변환되는 소스 Raster

dest - 목적지 WritableRaster, 또는 null

반환값:

src로 부터 변환된 dest 색, 또는 새롭게 변환된 WritableRaster (dest이 null인 경우)

예외:

IllegalArgumentException - 소스 또는 목적지의 밴드수가 올바르지 않은 경우, 소스 또는 목적지의 컬러 영역가 미정도리의 경우, 또는 이 조작이 BufferedImage 에서의 조작에만 적용되는 생성자 어떤 것인가로 구축되었을 경우

getBounds2D

public final Rectangle2D  getBounds2D(BufferedImage  src)

이 소스를 지정해, 목적지의 바운딩박스를 리턴합니다. 이것은 소스의 바운딩박스와 같게 됩니다.

정의:

인터페이스 BufferedImageOp 내의 getBounds2D

파라미터:

src - 소스의 BufferedImage

반환값:

지정된 src를 가져, 목적지의 바운딩박스를 나타내는 Rectangle2D

getBounds2D

public final Rectangle2D  getBounds2D(Raster  src)

이 소스를 지정해, 목적지의 바운딩박스를 리턴합니다. 이것은 소스의 바운딩박스와 같게 됩니다.

정의:

인터페이스 RasterOp 내의 getBounds2D

파라미터:

src - 전송원의 Raster

반환값:

지정된 src를 가져, 목적지의 바운딩박스를 나타내는 Rectangle2D

createCompatibleDestImage

public BufferedImage  createCompatibleDestImage(BufferedImage  src,
                                               ColorModel  destCM)

이 소스를 지정해, 적절한 사이즈 및 밴드수로 제로화 된 목적지 이미지를 작성합니다.

정의:

인터페이스 BufferedImageOp 내의 createCompatibleDestImage

파라미터:

src - 필터 오퍼레이션의 소스 이미지

destCM - 목적지의 ColorModel. null인 경우는 적절한 ColorModel를 사용

반환값:

지정된 src 올바른 사이즈와 밴드수를 가진 BufferedImage

예외:

IllegalArgumentException - destCM가 null로 한편, 이 ColorConvertOp가 목적지에 정의된 임의의 ICC_Profile 또는 ColorSpace를 사용하지 않고 작성되었을 경우

createCompatibleDestRaster

public WritableRaster  createCompatibleDestRaster(Raster  src)

지정된 소스로 올바른 사이즈 및 밴드수를 가지는 제로화 된 목적지 Raster를 작성합니다.

정의:

인터페이스 RasterOp 내의 createCompatibleDestRaster

파라미터:

src - 지정한 Raster

반환값:

지정된 src 올바른 사이즈와 밴드수를 가진 WritableRaster

예외:

IllegalArgumentException - 이 ColorConvertOp가 dst 및 src 컬러 영역를 정의하기에 충분한 정보없이 작성되었을 경우

getPoint2D

public final Point2D  getPoint2D(Point2D  srcPt,
                                Point2D  dstPt)

소스의 포인트를 지정해, 목적지의 포인트의 위치를 리턴합니다. dstPt이 null이 아닌 경우, 반환값을 포함하기 위해서 사용됩니다. 이 클래스에서는 목적지의 포인트는 소스의 포인트와 같게 됩니다.

정의:

인터페이스 BufferedImageOp 내의 getPoint2D

정의:

인터페이스 RasterOp 내의 getPoint2D

파라미터:

srcPt - 지정된 소스의 Point2D

dstPt - 전송처의 Point2D

반환값:

srcPt와 같은 장소로 설정한 뒤의 dstPt

getRenderingHints

public final RenderingHints  getRenderingHints()

이 조작으로 사용되는 렌더링 힌트를 리턴합니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

이 ColorConvertOp RenderingHints 객체