JavaTM Platform
Standard Ed. 6

java.awt.image
클래스 AffineTransformOp

java.lang.Object 
  상위를 확장 java.awt.image.AffineTransformOp
모든 구현된 인터페이스:
BufferedImageOp , RasterOp


public class AffineTransformOp
extends Object
implements BufferedImageOp , RasterOp

이 클래스는, 아핀 변환을 사용해, 전송원의 이미지 또는 Raster 의 2 차원 좌표로부터 전송처의 이미지 또는 Raster 의 2 차원 좌표에의 선형 매핑을 실행합니다. 사용되는 보간의 형태는, 생성자 을 개입시켜,RenderingHints 객체 또는 이 클래스에서 정의되고 있는 정수형 보간형 가운데 1 개에 의해 지정됩니다.  

RenderingHints 객체가 생성자 으로 지정되는 경우, 보간 힌트 및 draw 품질 힌트가 이 오퍼레이션의 보간형을 설정하기 위해서 사용됩니다. 칼라 draw 힌트 및 디저링 힌트는, 색변환이 필요한 경우에 사용됩니다.  

다음의 제약에 따를 필요가 있습니다.

관련 항목:
AffineTransform , BufferedImageFilter , RenderingHints.KEY_INTERPOLATION , RenderingHints.KEY_RENDERING , RenderingHints.KEY_COLOR_RENDERING , RenderingHints.KEY_DITHERING

필드의 개요
static int TYPE_BICUBIC
          바이큐빅크 보간형입니다.
static int TYPE_BILINEAR
          쌍일차 보간형입니다.
static int TYPE_NEAREST_NEIGHBOR
          최근옆보간 (Nearest Neighbor Interpolation) 형입니다.
 
생성자 의 개요
AffineTransformOp (AffineTransform  xform, int interpolationType)
          아핀 변환 및 보간형을 지정해 AffineTransformOp 를 구축합니다.
AffineTransformOp (AffineTransform  xform, RenderingHints  hints)
          아핀 변환을 지정해 AffineTransformOp 를 구축합니다.
 
메소드의 개요
 BufferedImage createCompatibleDestImage (BufferedImage  src, ColorModel  destCM)
          적절한 사이즈 및 밴드수로, 제로화 된 전송처 이미지를 생성합니다.
 WritableRaster createCompatibleDestRaster (Raster  src)
          올바른 사이즈 및 밴드수로, 제로화 된 전송처 Raster 를 작성합니다.
 BufferedImage filter (BufferedImage  src, BufferedImage  dst)
          전송원의 BufferedImage 를 변환해, 그 결과를 전송처의 BufferedImage 에 포함합니다.
 WritableRaster filter (Raster  src, WritableRaster  dst)
          전송원의 Raster 를 변환해, 그 결과를 전송처의 Raster 에 포함합니다.
 Rectangle2D getBounds2D (BufferedImage  src)
          변환된 전송처의 바운딩 박스를 돌려줍니다.
 Rectangle2D getBounds2D (Raster  src)
          변환된 전송처의 바운딩 박스를 돌려줍니다.
 int getInterpolationType ()
          이 오퍼레이션에 사용되는 보간형을 돌려줍니다.
 Point2D getPoint2D (Point2D  srcPt, Point2D  dstPt)
          지정된 전송원의 포인트에 대응하는 전송처의 포인트의 위치를 돌려줍니다.
 RenderingHints getRenderingHints ()
          이 변환 오퍼레이션에 사용되는 draw 힌트를 돌려줍니다.
 AffineTransform getTransform ()
          이 변환 오퍼레이션에 사용되는 아핀 변환을 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

필드의 상세

TYPE_NEAREST_NEIGHBOR

public static final int TYPE_NEAREST_NEIGHBOR
최근옆보간 (Nearest Neighbor Interpolation) 형입니다.

관련 항목:
정수 필드치

TYPE_BILINEAR

public static final int TYPE_BILINEAR
쌍일차 보간형입니다.

관련 항목:
정수 필드치

TYPE_BICUBIC

public static final int TYPE_BICUBIC
바이큐빅크 보간형입니다.

관련 항목:
정수 필드치
생성자 의 상세

AffineTransformOp

public AffineTransformOp(AffineTransform  xform,
                         RenderingHints  hints)
아핀 변환을 지정해 AffineTransformOp 를 구축합니다. 보간형은,RenderingHints 객체에 의해 정해집니다. 보간 힌트가 정의되고 있는 경우는, 그것을 사용합니다. 보간 힌트가 정의되어 있지 않은 경우, draw 품질 힌트가 정의되고 있으면, 보간형은 그 값으로부터 정해집니다. hints 가 지정되어 있지 않은 경우 (hints 가 null 의 경우), 보간형은 TYPE_NEAREST_NEIGHBOR 입니다.

파라미터:
xform - 오퍼레이션에 사용한다 AffineTransform
hints - 오퍼레이션의 보간형을 지정하기 위해서 사용된다 RenderingHints 객체
예외:
ImagingOpException - 변환을 역변환할 수 없는 경우
관련 항목:
RenderingHints.KEY_INTERPOLATION , RenderingHints.KEY_RENDERING

AffineTransformOp

public AffineTransformOp(AffineTransform  xform,
                         int interpolationType)
아핀 변환 및 보간형을 지정해 AffineTransformOp 를 구축합니다.

파라미터:
xform - 오퍼레이션에 사용하는 AffineTransform
interpolationType - 이 클래스에서 정의되고 있는 정수치 보간형 정수의 1 개. TYPE_NEAREST_NEIGHBOR , TYPE_BILINEAR , 또는 TYPE_BICUBIC
예외:
ImagingOpException - 변환을 역변환할 수 없는 경우
메소드의 상세

getInterpolationType

public final int getInterpolationType()
이 오퍼레이션에 사용되는 보간형을 돌려줍니다.

반환값:
보간형
관련 항목:
TYPE_NEAREST_NEIGHBOR , TYPE_BILINEAR , TYPE_BICUBIC

filter

public final BufferedImage  filter(BufferedImage  src,
                                  BufferedImage  dst)
전송원의 BufferedImage 를 변환해, 그 결과를 전송처의 BufferedImage 에 포함합니다. 2 개의 이미지의 칼라 모델이 일치하지 않는 경우는, 전송처의 칼라 모델에의 변환이 실행됩니다. 전송처의 이미지가 null 의 경우, 전송원의 ColorModel 에 의해 BufferedImage 가 작성됩니다.  

getBounds2D(BufferedImage) 가 돌려주는 구형의 좌표와 이 메소드가 돌려주는 BufferedImage 의 좌표는 반드시 일치한다고는 할 수 없습니다. 구형의 좌상구석의 좌표가 부의 경우, 구형의 이 부분은 draw 되지 않습니다. 구형의 좌상구석의 좌표가 정의 경우, 필터를 통한 이미지는 전송처 BufferedImage 의 그 위치에 draw 됩니다.

전송원이 전송처와 같은 경우는,IllegalArgumentException 를 throw 합니다.

정의:
인터페이스 BufferedImageOp 내의 filter
파라미터:
src - 변환 대상의 BufferedImage
dst - 변환의 결과를 포함한다 BufferedImage
반환값:
필터 된 BufferedImage
예외:
IllegalArgumentException - srcdst 가 동일한 경우
ImagingOpException - 무효인 이미지 형식, 타일 형식, 또는 이미지 처리 조작에 의해 일어나는 데이터 처리 에러, 혹은 그 외의 지원되어 있지 않은 조작을 위해서(때문에) 이미지를 변환할 수 없다 경우

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dst)
전송원의 Raster 를 변환해, 그 결과를 전송처의 Raster 에 포함합니다. 이 오퍼레이션은, 밴드마다의 변환을 실행합니다.  

전송처의 Raster 가 null 의 경우는, 새로운 Raster 가 작성됩니다. 전송원이 전송처와 동일한 경우, 또는 전송원의 밴드수와 전송처의 밴드수가 동일하지 않은 경우에는,IllegalArgumentException 가 throw 됩니다.  

getBounds2D(Raster) 가 돌려주는 구형의 좌표와 이 메소드가 돌려주는 WritableRaster 의 좌표는 반드시 일치한다고는 할 수 없습니다. 구형의 좌상구석의 좌표가 부의 경우, 구형의 이 부분은 draw 되지 않습니다. 구형의 좌표가 정의 경우, 필터를 통한 이미지는 전송처 Raster 의 그 위치에 draw 됩니다.  

정의:
인터페이스 RasterOp 내의 filter
파라미터:
src - 변환 대상의 Raster
dst - 변환의 결과를 포함한다 Raster
반환값:
변환된 Raster
예외:
ImagingOpException - 무효인 이미지 형식, 타일 형식, 또는 이미지 처리 조작에 의해 일어나는 데이터 처리 에러, 혹은 그 외의 지원되어 있지 않은 조작을 위해서(때문에) 라스터를 변환할 수 없다 경우

getBounds2D

public final Rectangle2D  getBounds2D(BufferedImage  src)
변환된 전송처의 바운딩 박스를 돌려줍니다. 반환되는 구형은, 변환된 포인트의 실제의 바운딩 박스입니다. 반환되는 구형의 좌상구석의 좌표는 (0,  0) 나오지 않을 가능성이 있습니다.

정의:
인터페이스 BufferedImageOp 내의 getBounds2D
파라미터:
src - 변환 대상의 BufferedImage
반환값:
전송처의 바운딩 박스를 나타낸다 Rectangle2D

getBounds2D

public final Rectangle2D  getBounds2D(Raster  src)
변환된 전송처의 바운딩 박스를 돌려줍니다. 반환되는 구형은, 변환된 포인트의 실제의 바운딩 박스입니다. 반환되는 구형의 좌상구석의 좌표는 (0,  0) 나오지 않을 가능성이 있습니다.

정의:
인터페이스 RasterOp 내의 getBounds2D
파라미터:
src - 변환 대상의 Raster
반환값:
전송처의 바운딩 박스를 나타낸다 Rectangle2D

createCompatibleDestImage

public BufferedImage  createCompatibleDestImage(BufferedImage  src,
                                               ColorModel  destCM)
적절한 사이즈 및 밴드수로, 제로화 된 전송처 이미지를 생성합니다. 변환된 폭 또는 높이가 0 에 동일한 경우는,RasterFormatException 가 throw 됩니다.  

destCM 가 null 의 경우는, 적절한 ColorModel 가 사용됩니다. 사용되는 ColorModel 은, 전송원의 ColorModel 가 불투명한 경우에도, 알파 채널을 가지는 경우가 있습니다.

정의:
인터페이스 BufferedImageOp 내의 createCompatibleDestImage
파라미터:
src - 변환 대상의 BufferedImage
destCM - 전송처의 ColorModel. null 의 경우, 적절한 ColorModel 가 사용된다
반환값:
제로화 된 전송처의 이미지

createCompatibleDestRaster

public WritableRaster  createCompatibleDestRaster(Raster  src)
올바른 사이즈 및 밴드수로, 제로화 된 전송처 Raster 를 작성합니다. 변환된 폭 또는 높이가 0 에 동일한 경우는,RasterFormatException 가 throw 됩니다.

정의:
인터페이스 RasterOp 내의 createCompatibleDestRaster
파라미터:
src - 변환 대상의 Raster
반환값:
제로화 된 전송처의 Raster

getPoint2D

public final Point2D  getPoint2D(Point2D  srcPt,
                                Point2D  dstPt)
지정된 전송원의 포인트에 대응하는 전송처의 포인트의 위치를 돌려줍니다. dstPt 가 지정되고 있는 경우, 그 dstPt 가 반환값을 보관 유지합니다.

정의:
인터페이스 BufferedImageOp 내의 getPoint2D
정의:
인터페이스 RasterOp 내의 getPoint2D
파라미터:
srcPt - 전송원의 포인트를 나타낸다 Point2D
dstPt - 결과가 포함되는 Point2D
반환값:
지정된 전송원의 포인트에 대응한다 전송처의 Point2D

getTransform

public final AffineTransform  getTransform()
이 변환 오퍼레이션에 사용되는 아핀 변환을 돌려줍니다.

반환값:
이 오퍼레이션에 관련한 AffineTransform

getRenderingHints

public final RenderingHints  getRenderingHints()
이 변환 오퍼레이션에 사용되는 draw 힌트를 돌려줍니다.

정의:
인터페이스 BufferedImageOp 내의 getRenderingHints
정의:
인터페이스 RasterOp 내의 getRenderingHints
반환값:
이 오퍼레이션에 관련한 RenderingHints 객체

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 도 참조해 주세요.