java.awt.image
클래스 ConvolveOp

java.lang.Object 
  java.awt.image.ConvolveOp

모든 구현된 인터페이스:

BufferedImageOp , RasterOp

public class ConvolveOp
extends Object 
implements BufferedImageOp , RasterOp 

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

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

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

생성자 으로 RenderingHints 객체가 지정되었을 경우, 색변환이 필요한 때에, 칼라 draw 힌트 및 디저링 힌트를 사용할 수 있습니다.

전송원과 전송처를 같은 객체에는 하지 말아 주세요.

관련 항목:

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 () 이 조작의 draw 힌트를 돌려줍니다.

클래스 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 가 throw 됩니다.

정의:

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

정의:

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

이 조작의 draw 힌트를 돌려줍니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

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