JavaTM Platform
Standard Ed. 6

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 와 조합해, 기존 이미지의 필터 처리에 사용됩니다. 이 기본 클래스는, 「빈 상태(empty) 필터」를 구현하기 위한 호출을 실시합니다. 「빈 상태(empty) 필터」는, 전송 되어 오는 데이터에 어떤 영향도 주지 않습니다. 필터를 구현할 때는, 이 클래스를 서브 클래스화해, 데이터를 필터 처리하는 메소드를 오버라이드(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
파라미터:
x - 설정되는 픽셀 영역의 좌상구석의 X 좌표
y - 설정되는 픽셀 영역의 좌상구석의 Y 좌표
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
파라미터:
x - 설정되는 픽셀 영역의 좌상구석의 X 좌표
y - 설정되는 픽셀 영역의 좌상구석의 Y 좌표
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 가 상하 좌우순서에서의 데이터의 재발송신을 요구하는 경우,FilteredImageSourceImageFilter 의 이 메소드를 호출합니다.

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

파라미터:
ip - 이 필터의 인스턴스를 공급하는, 또 필요에 따라서 요구를 전송 한다 ImageProducer
예외:
NullPointerException - ip 가 null 의 경우
관련 항목:
ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object  clone()
이 객체를 복제합니다.

오버라이드(override):
클래스 Object 내의 clone
반환값:
이 인스턴스의 복제
관련 항목:
Cloneable

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.