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 오브젝트가 constructor 으로 지정되고 있는 경우는 칼라 표현 힌트 및 디저링 힌트를 사용해 색변환을 제어할 수 있습니다.

소스와 목적지에는 같은 오브젝트를 지정할 수 있습니다.

관련 항목:

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 는 목적지 area에 변환되기 전에 소스가 변환되는 중간 area를 정의합니다.

파라미터:

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 는 목적지 area에 변환되기 전에 소스가 변환되는 중간 area를 정의합니다.

파라미터:

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 kr 이상의 요소를 가질 필요가 있어, 그렇지 않은 경우, 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 인수만을 취하는 constructor를 사용해 구축되었을 경우 (조작의 정의가 부적절하기 때문에)

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dest)

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

정의:

인터페이스 RasterOp 내의 filter

파라미터:

src - 변환되는 소스 Raster

dest - 목적지 WritableRaster, 또는 null

반환값:

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

예외:

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

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

파라미터:

srcPt - 지정된 소스의 Point2D

dstPt - 목적지의 Point2D

반환값:

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

getRenderingHints

public final RenderingHints  getRenderingHints()

이 조작으로 사용되는 표현 힌트를 돌려줍니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

반환값:

이 ColorConvertOp 의 RenderingHints 오브젝트