ColorConvertOp (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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` 객체`

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.