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 객체가 생성자 으로 지정되는 경우, 보간 힌트 및 렌더링 품질 힌트가 이 오퍼레이션의 보간형을 설정하기 위해서 사용됩니다. 컬러 렌더링 힌트 및 디저링 힌트는 색변환이 필요한 경우에 사용됩니다.

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

• 소스와 목적지는 같게는 하지 않는다
• Raster 객체의 경우, 소스의 밴드수는 목적지의 밴드수와 같게 한다

관련 항목:

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 () 이 변환 오퍼레이션에 사용되는 렌더링 힌트를 리턴합니다.
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 객체에 의해 정해집니다. 보간 힌트가 정의되고 있는 경우는 그것을 사용합니다. 보간 힌트가 정의되어 있지 않은 경우, 렌더링 품질 힌트가 정의되고 있으면, 보간형은 그 값으로부터 정해집니다. 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 좌표는 반드시 일치한다고는 할 수 없습니다. 구형의 좌상구석의 좌표가 부의 경우, 구형의 이 부분은 렌더링 되지 않습니다. 구형의 좌상구석의 좌표가 정의 경우, 필터를 통한 이미지는 목적지 BufferedImage 그 위치에 렌더링 됩니다.

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

정의:

인터페이스 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

정의:

인터페이스 RasterOp 내의 getPoint2D

파라미터:

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

dstPt - 결과가 포함되는 Point2D

반환값:

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

getTransform

public final AffineTransform  getTransform()

이 변환 오퍼레이션에 사용되는 아핀 변환을 리턴합니다.

반환값:

이 오퍼레이션에 관련한 AffineTransform

getRenderingHints

public final RenderingHints  getRenderingHints()

이 변환 오퍼레이션에 사용되는 렌더링 힌트를 리턴합니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

이 오퍼레이션에 관련한 RenderingHints 객체