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 메서드를 사용합니다.

생성자 으로 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이 아닌 경우는 반환값의 포함처로서 사용됩니다. 기하학적인 조작은 아니기 때문에 srcPt는 dstPt와 동일해집니다.

정의:

인터페이스 BufferedImageOp 내의 getPoint2D

정의:

인터페이스 RasterOp 내의 getPoint2D

파라미터:

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

dstPt - 결과가 포함되는 Point2D

반환값:

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

getRenderingHints

public final RenderingHints  getRenderingHints()

이 조작의 렌더링 힌트를 리턴합니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

이 BufferedImageOp RenderingHints 객체. 힌트가 설정되어 있지 않은 경우는 null을 돌려준다