java.awt.image
클래스 ImageFilter

java.lang.Object 
  java.awt.image.ImageFilter

모든 구현된 인터페이스:

ImageConsumer, Cloneable

알려진 직계 서브 클래스:

BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter
extends Object 
implements ImageConsumer,
 Cloneable 

이 클래스에는 일련의 인터페이스 메서드용의 필터가 구현되고 있어 ImageProducer 로부터 ImageConsumer에 데이터를 전송 하기 위해서 사용됩니다. 기존 이미지를 필터 처리하려면, FilteredImageSource 객체와 연결해 사용합니다. 이 기본 클래스는 「비어있는 필터」를 구현하기 위한 호출을 실시합니다. 「비어있는 필터」는 전송 되어 오는 데이터에 어떤 영향도 주지 않습니다. 필터를 구현할 때는 이 클래스를 상속해, 데이터를 필터 처리하는 메서드를 오버라이드(override) 합니다. 또, 필요에 따라서 수정을 더합니다.

관련 항목:

FilteredImageSource, ImageConsumer

필드 개요

protected ImageConsumer

consumer 특별한 이미지 데이터 스트림의 컨슈머(consumer)이며, ImageFilter 이 인스턴스가 데이터를 필터 처리합니다.

인터페이스 java.awt.image. ImageConsumer 로부터 상속된 필드

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

생성자 개요

ImageFilter ()

메서드 개요

Object	clone () 이 객체를 복제합니다.
ImageFilter	getFilterInstance (ImageConsumer ic) 지정된 ImageConsumer 필터링을 실제로 실시하는 ImageFilter 객체의 일의인 인스턴스를 리턴합니다.
void	imageComplete (int status) ImageConsumer 인터페이스의 imageComplete 메서드로 제공되는 정보를 필터 처리합니다.
void	resendTopDownLeftRight (ImageProducer ip) ImageConsumer로 부터의 픽셀 데이터 재전송요구에 응합니다.
void	setColorModel (ColorModel model) ImageConsumer 인터페이스의 setColorModel 메서드로 제공되는 정보를 필터 처리합니다.
void	setDimensions (int width, int height) ImageConsumer 인터페이스의 setDimensions 메서드로 제공되는 정보를 필터 처리합니다.
void	setHints (int hints) ImageConsumer 인터페이스의 setHints 메서드로 제공되는 정보를 필터 처리합니다.
void	setPixels (int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) byte 배열을 취하는 ImageConsumer 인터페이스의 setPixels 메서드로 제공되는 정보를 필터 처리합니다.
void	setPixels (int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) int 배열을 취하는 ImageConsumer 인터페이스의 setPixels 메서드로 제공되는 정보를 필터 처리합니다.
void	setProperties (Hashtable <?,?> props) 필터의 스트림을 통과한 것을 나타내는 프로퍼티를 추가한뒤 소스 객체로부터 프로퍼티를 건네줍니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

consumer

protected ImageConsumer  consumer

특별한 이미지 데이터 스트림의 컨슈머(consumer)이며, ImageFilter 이 인스턴스가 데이터를 필터 처리합니다. 이 초기화는 생성자 안에서는 없고, getFilterInstance() 메서드의 호출중에 행해집니다. 그 때에 FilteredImageSource 에의해 특별한 이미지 데이터 스트림을 위한 객체 고유의 인스턴스가 생성됩니다.

관련 항목:

getFilterInstance(java.awt.image.ImageConsumer), ImageConsumer

생성자 상세

ImageFilter

public ImageFilter()

메서드의 상세

getFilterInstance

public ImageFilter  getFilterInstance(ImageConsumer  ic)

지정된 ImageConsumer 필터링을 실제로 실시하는 ImageFilter 객체의 일의인 인스턴스를 리턴합니다. 디폴트의 구현에서는 이 객체를 복제할 뿐입니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

파라미터:

ic - 지정된 ImageConsumer

반환값:

지정된 ImageConsumer 필터 처리에 사용되는 ImageFilter

setDimensions

public void setDimensions(int width,
                          int height)

ImageConsumer 인터페이스의 setDimensions 메서드로 제공되는 정보를 필터 처리합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setDimensions

파라미터:

width - 소스 이미지의 폭

height - 소스 이미지의 높이

관련 항목:

ImageConsumer.setDimensions(int, int)

setProperties

public void setProperties(Hashtable <?,?> props)

필터의 스트림을 통과한 것을 나타내는 프로퍼티를 추가한뒤 소스 객체로부터 프로퍼티를 건네줍니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setProperties

파라미터:

props - 소스 객체로부터의 프로퍼티

예외:

NullPointerException - props가 null인 경우

setColorModel

public void setColorModel(ColorModel  model)

ImageConsumer 인터페이스의 setColorModel 메서드로 제공되는 정보를 필터 처리합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setColorModel

파라미터:

model - 지정된 ColorModel

관련 항목:

ImageConsumer.setColorModel(java.awt.image.ColorModel)

setHints

public void setHints(int hints)

ImageConsumer 인터페이스의 setHints 메서드로 제공되는 정보를 필터 처리합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setHints

파라미터:

hints - ImageConsumer가 픽셀 처리에 사용하는 힌트세트

관련 항목:

ImageConsumer.setHints(int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel  model,
                      byte[] pixels,
                      int off,
                      int scansize)

byte 배열을 취하는 ImageConsumer 인터페이스의 setPixels 메서드로 제공되는 정보를 필터 처리합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setPixels

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

off - pixels 배열의 오프셋(offset)

scansize - pixels 배열내의, 어느 픽셀행으로부터 다음의 픽셀행까지의 거리

관련 항목:

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel  model,
                      int[] pixels,
                      int off,
                      int scansize)

int 배열을 취하는 ImageConsumer 인터페이스의 setPixels 메서드로 제공되는 정보를 필터 처리합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setPixels

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

off - pixels 배열의 오프셋(offset)

scansize - pixels 배열내의, 어느 픽셀행으로부터 다음의 픽셀행까지의 거리

관련 항목:

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

imageComplete

public void imageComplete(int status)

ImageConsumer 인터페이스의 imageComplete 메서드로 제공되는 정보를 필터 처리합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출합니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 처리를 방해할 수 있을 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 imageComplete

파라미터:

status - 이미지 로드 상태

관련 항목:

ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer  ip)

ImageConsumer로 부터의 픽셀 데이터 재전송요구에 응합니다. 위에서 아래, 왼쪽에서 오른쪽의 차례로 처리됩니다. 이 ImageFilter 인스턴스에 의해 지정된 ImageConsumer가 상하 좌우순서에서의 데이터의 재발송신을 요구하는 경우, FilteredImageSource는 ImageFilter 이 메서드를 호출합니다.

ImageFilter 서브 클래스는 상하 좌우순서로 데이터를 송신할지 어떨지 및 그방법에 따라, 이 메서드를 오버라이드(override) 할 수 있는 경우로 기내 경우가 있습니다. 가능성은 3 개 있습니다.

• 이 메서드는 오버라이드(override) 하지 않는다. 이것에 의해 서브 클래스는 디폴트의 구현을 사용한다. 디폴트의 구현은 요구하고 있는 ImageConsumer로 서 이 필터를 사용해, 지정된 ImageProducer에 요구를 전송 한다. 이 동작은 상위의 프로듀서오브제크트가 상하 좌우순서로 픽셀을 송신하는 경우에 필터가 상하 좌우순서로 픽셀을 송신하는 것을 판단할 수 있는 경우에 적절
• 데이터를 단지 송신하는 경우는 메서드를 오버라이드(override) 한다. 이것은 필터 자체가 요구를 처리할 수 있는 경우에 적절. 예를 들어 생성된 픽셀이 버퍼 등에 보존되고 있는 경우 등
• 아무것도 실행하지 않는 경우는 메서드를 오버라이드(override) 한다. 이것은 필터로 상하 좌우순서에 필터를 통한 데이터를 생성할 수 없는 경우에 적절

파라미터:

ip - 이 필터의 인스턴스를 공급한다, 또 필요에 따라서 요구를 전송 하는 ImageProducer

예외:

NullPointerException - ip가 null인 경우

관련 항목:

ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object  clone()

이 객체를 복제합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable