java.awt.image
클래스 ConvolveOp

java.lang.Object 
  |
  +--java.awt.image.ConvolveOp

모든 구현 인터페이스:

BufferedImageOp , RasterOp

public class ConvolveOp

extends Object

implements BufferedImageOp , RasterOp

이 클래스는 소스로부터 목적지에의 간직해 연산을 구현합니다. 간직해 연산 커넬을 사용하는 간직해 연산은 공간 오퍼레이션이며, 입력 픽셀로부터 출력 픽셀을 요구하려면 , 간직해 연산 커넬에 입력 픽셀의 주위의 값을 곱셈합니다. 이것에 의해, 출력 픽셀이 인접하는 픽셀로부터 받는 영향은 간직해 연산 커넬에 의해 수학적으로 지정할 수 있습니다.

이 클래스는 색성분의 알파 성분을 미리 곱셈하는 BufferedImage 데이터를 사용해 연산을 실시합니다. 소스가 되는 BufferedImage 에 알파 성분이 있어, 색성분에 그 알파 성분이 미리 곱셈되어 있지 않은 경우, 데이터는 간직해 연산전에 미리 곱셈됩니다. 아직 곱셈되어 있지 않은 색성분이 Destination 에 있는 경우, 알파는 Destination 에 저장되기 전에 제산됩니다. 알파가 0 의 경우, 색성분은 0 으로 설정됩니다. Destination 에 알파 성분이 없는 경우, 그 결과적으로 생기는 알파는 색성분으로 1 회 제산된 후에 파기됩니다.

Raster 는 알파 채널을 가지지 않는 것으로서 다루어집니다. BufferedImages 에서의 알파 채널의 상술과 같은 취급이 바람직하지 않은 경우, 그것을 피하려면 , 소스인 BufferedImage 의 Raster 를 취득해, Raster 를 취급하는 이 클래스의 filter 메소드를 사용합니다.

constructor 으로 RenderingHints 오브젝트가 지정되었을 경우, 색변환이 필요한 때에, 칼라 표현 힌트 및 디저링 힌트가 사용되는 일도 있습니다.

소스와 목적지를 같은 오브젝트에는 하지 말아 주세요.

관련 항목:

Kernel , RenderingHints.KEY_COLOR_RENDERING , RenderingHints.KEY_DITHERING

필드의 개요

static int	EDGE_NO_OP 소스 이미지의 인연에 있는 픽셀은 목적지의 대응하는 픽셀에 그대로 카피됩니다.
static int	EDGE_ZERO_FILL 목적지 이미지의 인연에 있는 픽셀은 0 으로 설정됩니다.

생성자의 개요

ConvolveOp (Kernel kernel)
지정된 Kernel 로 ConvolveOp 를 구축합니다.

ConvolveOp (Kernel kernel, int edgeCondition, RenderingHints hints)
지정된 Kernel, 인연의 조건, 및 RenderingHints 오브젝트 (이것은 null 에서도 가능)로 ConvolveOp 를 구축합니다.

메소드의 개요

BufferedImage	createCompatibleDestImage (BufferedImage src, ColorModel destCM) 적절한 사이즈와 수의 밴드를 가지는 제로화 된 목적지 이미지를 작성합니다.
WritableRaster	createCompatibleDestRaster (Raster src) 지정된 소스로, 올바른 사이즈 및 밴드수를 가지는 제로화 된 목적지 Raster 를 작성합니다.
BufferedImage	filter (BufferedImage src, BufferedImage dst) BufferedImages 로 간직해 연산을 실행합니다.
WritableRaster	filter (Raster src, WritableRaster dst) Raster 의 간직해 연산을 실행합니다.
Rectangle2D	getBounds2D (BufferedImage src) 필터 처리된 목적지 이미지의 바운딘그복스를 돌려줍니다.
Rectangle2D	getBounds2D (Raster src) 필터 처리된 목적지의 Raster 의 바운딘그복스를 돌려줍니다.
int	getEdgeCondition () 인연의 조건을 돌려줍니다.
Kernel	getKernel () Kernel 를 돌려줍니다.
Point2D	getPoint2D (Point2D srcPt, Point2D dstPt) 지정된 소스내의 포인트에 대응하는 목적지의 포인트의 위치를 돌려줍니다.
RenderingHints	getRenderingHints () 이 오퍼레이션의 표현 힌트를 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

필드의 상세

EDGE_ZERO_FILL

public static final int EDGE_ZERO_FILL

목적지 이미지의 인연에 있는 픽셀은 0 으로 설정됩니다. 이것이 디폴트입니다.

관련 항목:

정수 필드치

EDGE_NO_OP

public static final int EDGE_NO_OP

소스 이미지의 인연에 있는 픽셀은 목적지의 대응하는 픽셀에 그대로 카피됩니다.

관련 항목:

정수 필드치

생성자의 상세

ConvolveOp

public ConvolveOp(Kernel  kernel,
                  int edgeCondition,
                  RenderingHints  hints)

지정된 Kernel, 인연의 조건, 및 RenderingHints 오브젝트 (이것은 null 에서도 가능)로 ConvolveOp 를 구축합니다.

파라미터:

kernel - 지정된 Kernel

edgeCondition - 지정된 인연의 조건

hints - 지정된 RenderingHints 오브젝트

관련 항목:

Kernel , EDGE_NO_OP , EDGE_ZERO_FILL , RenderingHints

ConvolveOp

public ConvolveOp(Kernel  kernel)

지정된 Kernel 로 ConvolveOp 를 구축합니다. 인연의 조건은 EDGE_ZERO_FILL 가 됩니다.

파라미터:

kernel - 지정된 Kernel

관련 항목:

Kernel , EDGE_ZERO_FILL

메소드의 상세

getEdgeCondition

public int getEdgeCondition()

인연의 조건을 돌려줍니다.

반환값:

이 ConvolveOp 의 인연의 조건

관련 항목:

EDGE_NO_OP , EDGE_ZERO_FILL

getKernel

public final Kernel  getKernel()

Kernel 를 돌려줍니다.

반환값:

이 ConvolveOp 의 Kernel

filter

public final BufferedImage  filter(BufferedImage  src,
                                  BufferedImage  dst)

BufferedImages 로 간직해 연산을 실행합니다. 소스 이미지의 각 성분은 간직해 연산되어 알파 성분도 있는 경우는 그것도 포함해 간직해 연산됩니다. 소스 이미지의 칼라 모델과 목적지 이미지의 칼라 모델이 다른 경우, 각 픽셀은 목적지에서 변환됩니다. 목적지 이미지가 null 인 경우는 소스의 ColorModel 을 사용해 BufferedImage 가 작성됩니다. 소스와 목적지가 같은 경우는 IllegalArgumentException 가 슬로우 됩니다.

정의:

인터페이스 BufferedImageOp 내의 filter

파라미터:

src - 필터를 걸치는 소스의 BufferedImage

dst - 필터를 걸칠 수 있었던 src 의 목적지 BufferedImage

반환값:

필터를 걸칠 수 있었던 BufferedImage

예외:

NullPointerException - src 가 null 의 경우

IllegalArgumentException - src 가 dst 와 동일한 경우

ImagingOpException - src 를 필터에 걸칠 수 없는 경우

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dst)

Raster 의 간직해 연산을 실행합니다. 소스가 되는 Raster 의 각 밴드가 간직해 연산됩니다. 소스와 목적지의 밴드수는 동일할 필요가 있습니다. 목적지의 Raster 가 null 의 경우는 새로운 Raster 가 작성됩니다. 소스와 목적지가 같은 경우는 IllegalArgumentException 가 슬로우 됩니다.

정의:

인터페이스 RasterOp 내의 filter

파라미터:

src - 필터를 걸치는 소스의 Raster

dst - 필터를 걸칠 수 있었던 src 의 목적지 WritableRaster

반환값:

필터를 걸칠 수 있었던 WritableRaster

예외:

NullPointerException - src 가 null 의 경우

ImagingOpException - src 와 dst 가 같은 밴드수를 가지고 있지 않은 경우

ImagingOpException - src 를 필터에 걸칠 수 없는 경우

IllegalArgumentException - src 가 dst 와 동일한 경우

createCompatibleDestImage

public BufferedImage  createCompatibleDestImage(BufferedImage  src,
                                               ColorModel  destCM)

적절한 사이즈와 수의 밴드를 가지는 제로화 된 목적지 이미지를 작성합니다. destCM 가 null 의 경우는 적절한 ColorModel 가 사용됩니다.

정의:

인터페이스 BufferedImageOp 내의 createCompatibleDestImage

파라미터:

src - 필터 오퍼레이션의 소스 이미지

destCM - 목적지의 ColorModel. null 도 가능

반환값:

적절한 사이즈 및 밴드수를 가지는 목적지 BufferedImage

createCompatibleDestRaster

public WritableRaster  createCompatibleDestRaster(Raster  src)

지정된 소스로, 올바른 사이즈 및 밴드수를 가지는 제로화 된 목적지 Raster 를 작성합니다.

정의:

인터페이스 RasterOp 내의 createCompatibleDestRaster

파라미터:

src - 전송원의 Raster

반환값:

src 와 호환성이 있는 WritableRaster

getBounds2D

public final Rectangle2D  getBounds2D(BufferedImage  src)

필터 처리된 목적지 이미지의 바운딘그복스를 돌려줍니다. 이것은 기하학적인 조작은 아니기 때문에, 바운딘그복스는 변화하지 않습니다.

정의:

인터페이스 BufferedImageOp 내의 getBounds2D

파라미터:

src - 필터 처리되는 BufferedImage

반환값:

목적지 이미지의 바운딘그복스를 나타내는 Rectangle2D

getBounds2D

public final Rectangle2D  getBounds2D(Raster  src)

필터 처리된 목적지의 Raster 의 바운딘그복스를 돌려줍니다. 이것은 기하학적인 조작은 아니기 때문에, 바운딘그복스는 변화하지 않습니다.

정의:

인터페이스 RasterOp 내의 getBounds2D

파라미터:

src - 전송원의 Raster

반환값:

필터링 조작의 Raster 의 바운딘그복스를 나타내는 Rectangle2D

getPoint2D

public final Point2D  getPoint2D(Point2D  srcPt,
                                Point2D  dstPt)

지정된 소스내의 포인트에 대응하는 목적지의 포인트의 위치를 돌려줍니다. dstPt 가 null 가 아닌 경우는 반환값의 저장처로서 dstPt 가 사용됩니다. 기하학적인 조작은 아니기 때문에, srcPt 는 dstPt 와 동일해집니다.

정의:

인터페이스 BufferedImageOp 내의 getPoint2D

파라미터:

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

dstPt - 결과가 저장되는 Point2D

반환값:

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

getRenderingHints

public final RenderingHints  getRenderingHints()

이 오퍼레이션의 표현 힌트를 돌려줍니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

반환값:

BufferedImageOp 에 관련지을 수 있었던 RenderingHints 오브젝트. 힌트가 설정되어 있지 않은 경우는 null 를 돌려준다