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 객체가 생성자 으로 지정되고 있는 경우는, 칼라 draw 힌트 및 디저링 힌트를 사용해 색변환을 제어할 수 있습니다.

전송원과 전송 먼저는, 같은 객체를 지정할 수 있습니다.

관련 항목:

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 () 이 조작으로 사용되는 draw 힌트를 돌려줍니다.

클래스 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 에서도 상관하지 않습니다. 일련의 프로파일에는, 칼라 스페이스를 나타내는 프로파일, 효과를 나타내는 프로파일등도 포함할 수가 있습니다. 이 일련의 프로파일 전체가 색변환을 적절히 정의하지 않는 경우는, 예외가 throw 됩니다. 　

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

Raster 의 경우, 전송원 Raster 의 밴드수는 배열의 최초의 프로파일의 요건과 일치할 필요가 있어, 전송처 Raster 의 밴드수는 배열의 마지막 프로파일의 요건과 일치할 필요가 있습니다. 배열은, 2 개(살) 이상의 요소를 가질 필요가 있어, 그렇지 않은 경우, Raster 에 대해서 필터 메소드를 호출하면(자) IllegalArgumentException 가 throw 됩니다.

파라미터:

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 의 색, 또는 dest 가 null 의 경우는 변환된, 새로운 BufferedImage

예외:

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

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dest)

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

정의:

인터페이스 RasterOp 내의 filter

파라미터:

src - 변환되는 전송원 Raster

dest - 전송처의 WritableRaster, 또는 null

반환값:

src 로부터 변환된 dest 의 색, 또는 dest 가 null 의 경우는 변환된, 새로운 WritableRaster

예외:

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()

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

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

이 ColorConvertOp 의 RenderingHints 객체