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 차원 좌표에의 선형 매핑을 실행합니다. 사용되는 보간의 타입은 constructor를 개입시켜,RenderingHints 오브젝트 또는 이 클래스에서 정의되고 있는 정수형 보간 타입 가운데 1 개에 의해 지정됩니다.

RenderingHints 오브젝트가 constructor 으로 지정되는 경우, 보간 힌트 및 표현 품질 힌트가 이 오퍼레이션의 보간 타입을 설정하기 위해서 사용됩니다. 칼라 표현 힌트 및 디저링 힌트는 색변환이 필요한 경우에 사용됩니다.

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

• 소스와 목적지는 같게는 하지 않는다
• Raster 오브젝트의 경우, 소스의 밴드수는 목적지의 밴드수와 같게 한다

관련 항목:

AffineTransform , BufferedImageFilter , RenderingHints.KEY_INTERPOLATION , RenderingHints.KEY_RENDERING , RenderingHints.KEY_COLOR_RENDERING , RenderingHints.KEY_DITHERING

필드의 개요

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 () 이 변환 오퍼레이션에 사용되는 표현 힌트를 돌려줍니다.
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

쌍일차 보간 타입입니다.

관련 항목:

정수 필드치

생성자의 상세

AffineTransformOp

public AffineTransformOp(AffineTransform  xform,
                         RenderingHints  hints)

아핀 변환을 지정해 AffineTransformOp 를 구축합니다. 보간 타입은 RenderingHints 오브젝트에 의해 정해집니다. 보간 힌트가 정의되고 있는 경우는 그것을 사용합니다. 보간 힌트가 정의되어 있지 않은 경우, 표현 품질 힌트가 정의되고 있으면, 보간 타입은 그 값으로부터 정해집니다. 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 를 참조

예외:

ImagingOpException - 변환을 역변환할 수 없는 경우

메소드의 상세

getInterpolationType

public final int getInterpolationType()

이 오퍼레이션에 사용되는 보간 타입을 돌려줍니다.

반환값:

보간 타입

관련 항목:

TYPE_NEAREST_NEIGHBOR , TYPE_BILINEAR

filter

public final BufferedImage  filter(BufferedImage  src,
                                  BufferedImage  dst)

소스의 BufferedImage 를 변환해, 그 결과를 목적지의 BufferedImage 에 저장합니다. 2 개의 이미지의 칼라 모델이 일치하지 않는 경우는 목적지의 칼라 모델에의 변환이 실행됩니다. 목적지의 이미지가 null 의 경우, 소스의 ColorModel 에 의해 BufferedImage 가 작성됩니다.

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

소스가 목적지와 같은 경우는 IllegalArgumentException 를 슬로우 합니다.

정의:

인터페이스 BufferedImageOp 내의 filter

파라미터:

src - 변환 대상의 BufferedImage

dst - 변환의 결과를 저장하는 BufferedImage

반환값:

필터 된 BufferedImage

예외:

IllegalArgumentException - src 와 dst 가 같은 경우

ImagingOpException - 무효인 이미지 형식, 타일 형식, 이미지 처리 조작에 의해 일어나는 데이터 처리 에러, 또는 그 외의 서포트되어 있지 않은 조작을 위해서(때문에) 이미지를 변환할 수 없는 경우

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dst)

소스의 Raster 를 변환해, 그 결과를 목적지의 Raster 에 저장합니다. 이 오퍼레이션은 밴드마다의 변환을 실행합니다.

목적지의 Raster 가 null 의 경우는 새로운 Raster 가 작성됩니다. 소스가 목적지와 동일한 경우, 또는 소스의 밴드수와 목적지의 밴드수가 동일하지 않은 경우에는 IllegalArgumentException 가 슬로우 됩니다.

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

정의:

인터페이스 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 가 슬로우 됩니다.

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

정의:

인터페이스 BufferedImageOp 내의 createCompatibleDestImage

파라미터:

src - 변환 대상의 BufferedImage

destCM - 목적지의 ColorModel. null 의 경우는 적절한 ColorModel 가 사용된다

반환값:

제로화 된 목적지의 이미지

createCompatibleDestRaster

public WritableRaster  createCompatibleDestRaster(Raster  src)

올바른 사이즈 및 밴드수로, 제로화 된 목적지 Raster 를 작성합니다. 변환된 폭 또는 높이가 0 에 동일한 경우는 RasterFormatException 가 슬로우 됩니다.

정의:

인터페이스 RasterOp 내의 createCompatibleDestRaster

파라미터:

src - 변환 대상의 Raster

반환값:

제로화 된 목적지의 Raster

getPoint2D

public final Point2D  getPoint2D(Point2D  srcPt,
                                Point2D  dstPt)

지정된 소스의 포인트에 대응하는 목적지의 포인트의 위치를 돌려줍니다. dstPt 가 지정되고 있는 경우, 그 dstPt 가 반환값을 보관 유지합니다.

정의:

인터페이스 BufferedImageOp 내의 getPoint2D

파라미터:

srcPt - 소스의 포인트를 나타내는 Point2D

dstPt - 결과가 저장되는 Point2D

반환값:

지정된 소스의 포인트에 대응하는 목적지의 Point2D

getTransform

public final AffineTransform  getTransform()

이 변환 오퍼레이션에 사용되는 아핀 변환을 돌려줍니다.

반환값:

이 오퍼레이션에 관련한 AffineTransform

getRenderingHints

public final RenderingHints  getRenderingHints()

이 변환 오퍼레이션에 사용되는 표현 힌트를 돌려줍니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

반환값:

이 오퍼레이션에 관련한 RenderingHints 오브젝트