java.awt.image
인터페이스 ImageConsumer

기존의 구현 클래스의 일람:

ImageFilter , PixelGrabber

public interface ImageConsumer

ImageProducer 인터페이스 경유로 이미지 데이터를 표시하는 오브젝트를 위한 인터페이스입니다. 컨슈머(consumer)가 이메이지프로듀사에 추가되면(자), 프로듀사는 이 인터페이스로 정의된 메소드를 호출하는 것에 의해 이미지 데이터를 전송 합니다.

관련 항목:

ImageProducer

필드의 개요

static int	COMPLETESCANLINES 픽셀은 1 번에 (복수의) 완전한 주사선 단위로 전송 됩니다.
static int	IMAGEABORTED 이미지 생성이 고의로 중단되었습니다.
static int	IMAGEERROR 이미지의 생성중에 에러가 발생했습니다.
static int	RANDOMPIXELORDER 픽셀의 전송 순서는 랜덤입니다.
static int	SINGLEFRAME 이미지 데이터는 1 매의 정지화면상을 포함하고 있습니다.
static int	SINGLEFRAMEDONE 이미지의 1 프레임의 전송이 완료했습니다만, 아직 전송 대상의 프레임이 있습니다.
static int	SINGLEPASS 픽셀은 1 살의 패스로 전송 됩니다.
static int	STATICIMAGEDONE 이미지의 전송이 완료해, 전송 대상의 픽셀도 프레임도 남아 있지 않습니다.
static int	TOPDOWNLEFTRIGHT 픽셀은 위에서 아래, 왼쪽에서 오른쪽의 순서로 전송 됩니다.

메소드의 개요

void	imageComplete (int status) imageComplete 메소드는 ImageProducer 가 소스 이미지의 모든 픽셀을 전송 끝마쳤을 때, 멀티 프레임 애니메이션의 1 프레임을 전송 끝마쳤을 때, 또는 이미지의 생성중 및 로딩중에 에러가 발생했을 때에 불려 갑니다.
void	setColorModel (ColorModel model) setPixels 메소드를 사용해 보고되는 픽셀의 대부분에 대해서 사용되는 ColorModel 오브젝트를 설정합니다.
void	setDimensions (int width, int height) setDimensions 메소드 호출을 사용해, 소스 이미지의 크기를 보고합니다.
void	setHints (int hintflags) ImageConsumer 가 ImageProducer 로부터 전송 되는 픽셀을 처리하기 위해서 사용되는 힌트를 설정합니다.
void	setPixels (int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) 이미지의 픽셀을 1 회 이상의 setPixels 메소드 호출에 의해 전송 합니다.
void	setPixels (int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) 이미지의 픽셀은 1 회 이상의 setPixels 메소드의 호출에 의해 전송 됩니다.
void	setProperties (Hashtable props) 이 이미지에 관해서, 확장 가능한 프로퍼티의 리스트를 설정합니다.

필드의 상세

RANDOMPIXELORDER

public static final int RANDOMPIXELORDER

픽셀의 전송 순서는 랜덤입니다. 즉, ImageConsumer 에서는 픽셀의 전송 순서의 최적화를 실시하지 않습니다. setHints 메소드가 불려 가지 않을 때는 이 랜덤 전송이 디폴트가 됩니다.

관련 항목:

setHints(int) , 정수 필드치

TOPDOWNLEFTRIGHT

public static final int TOPDOWNLEFTRIGHT

픽셀은 위에서 아래, 왼쪽에서 오른쪽의 순서로 전송 됩니다.

관련 항목:

setHints(int) , 정수 필드치

COMPLETESCANLINES

public static final int COMPLETESCANLINES

픽셀은 1 번에 (복수의) 완전한 주사선 단위로 전송 됩니다.

관련 항목:

setHints(int) , 정수 필드치

SINGLEPASS

public static final int SINGLEPASS

픽셀은 1 살의 패스로 전송 됩니다. 각 픽셀은 setPixels 메소드의 호출로 1 번만 전송 됩니다. 이 기준과 다른 이미지 형식의 예로서 프로그래시브 JPEG 이미지가 있습니다. 이 형식은 복수의 패스로 픽셀을 정의해, 보다 세련된 이미지를 구성합니다.

관련 항목:

setHints(int) , 정수 필드치

SINGLEFRAME

public static final int SINGLEFRAME

이미지 데이터는 1 매의 정지화면상을 포함하고 있습니다. 픽셀을 setPixels 메소드의 호출로 정의한 뒤, 전송 해야 할 데이터가 없어지면(자), imageComplete 메소드를 STATICIMAGEDONE 플래그 첨부로 호출합니다. 이 기준과 다른 이미지의 예는 유저가 조작하는 3D 렌더링의 표시나 비디오 출력입니다. 이러한 각 프레임의 끝에는 SINGLEFRAMEDONE 플래그를 사용하는 imageComplete 의 호출이 지시받고 있습니다.

관련 항목:

setHints(int) , imageComplete(int) , 정수 필드치

IMAGEERROR

public static final int IMAGEERROR

이미지의 생성중에 에러가 발생했습니다.

관련 항목:

imageComplete(int) , 정수 필드치

SINGLEFRAMEDONE

public static final int SINGLEFRAMEDONE

이미지의 1 프레임의 전송이 완료했습니다만, 아직 전송 대상의 프레임이 있습니다.

관련 항목:

imageComplete(int) , 정수 필드치

STATICIMAGEDONE

public static final int STATICIMAGEDONE

이미지의 전송이 완료해, 전송 대상의 픽셀도 프레임도 남아 있지 않습니다.

관련 항목:

imageComplete(int) , 정수 필드치

IMAGEABORTED

public static final int IMAGEABORTED

이미지 생성이 고의로 중단되었습니다.

관련 항목:

imageComplete(int) , 정수 필드치

메소드의 상세

setDimensions

public void setDimensions(int width,
                          int height)

setDimensions 메소드 호출을 사용해, 소스 이미지의 크기를 보고합니다.

파라미터:

width - 소스 이미지의 폭

height - 소스 이미지의 높이

setProperties

public void setProperties(Hashtable  props)

이 이미지에 관해서, 확장 가능한 프로퍼티의 리스트를 설정합니다.

파라미터:

props - 이 이미지에 관련짓는 프로퍼티의 리스트

setColorModel

public void setColorModel(ColorModel  model)

setPixels 메소드를 사용해 보고되는 픽셀의 대부분에 대해서 사용되는 ColorModel 오브젝트를 설정합니다. setPixels 메소드에 의해 전송 되는 픽셀세트는 각각 ColorModel 오브젝트를 포함하고 있으므로, 픽셀치의 전송시로 지정된 ColorModel 만이 사용되는 것은 아닌 것에 주의해 주세요. 복수의 ColorModel 오브젝트가 사용되는 예로서는 필터 처리되는 이미지가 있습니다. 필터 처리 대상의 픽셀에 수정을 실시할지 어떨지를 결정해, 수정 불요의 경우는 원의 ColorModel 를 사용해, 수정하는 경우는 보다 필터 처리에 적절한 ColorModel 를 사용합니다.

파라미터:

model - 지정된 ColorModel

관련 항목:

ColorModel

setHints

public void setHints(int hintflags)

ImageConsumer 가 ImageProducer 로부터 전송 되는 픽셀을 처리하기 위해서 사용되는 힌트를 설정합니다. ImageProducer 는 어떠한 순서에서도 픽셀을 전송 할 수가 있습니다만, 픽셀의 전송에 대한 정보를 ImageConsumer 에 건네줄 수가 있으면, ImageConsumer 는 ColorModel 에의 픽셀의 슬캘링이나 변환을 보다 능률적이고 고품질에 실시할 수가 있습니다. setHints 메소드의 인수가, 픽셀의 전송 방법에 관한 정보의 비트 마스크를 가지므로, setPixels 메소드보다 전에 setHints 메소드를 호출합니다. ImageProducer 가, 이 가이드 라인에 따르지 않은 경우의 결과는 프로텍션되지 않습니다.

파라미터:

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

setPixels

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

이미지의 픽셀을 1 회 이상의 setPixels 메소드 호출에 의해 전송 합니다. 각 호출은 픽셀 배열에 저장되고 있는 소스 픽셀의 위치와 구형의 크기를 지정합니다. 픽셀을 적절한 색과 알파 성분으로 변환하려면 , 지정된 ColorModel 오브젝트를 사용하지 않으면 안됩니다. (m, n 의 위치의) 픽셀은 인덱스 (n * scansize + m + off)의 pixels 배열에 놓여집니다. 이 메소드로 전송 되는 픽셀은 모두 byte 로 저장됩니다.

파라미터:

w - 픽셀 area의 폭

h - 픽셀 area의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

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

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

관련 항목:

ColorModel

setPixels

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

이미지의 픽셀은 1 회 이상의 setPixels 메소드의 호출에 의해 전송 됩니다. 각 호출은 픽셀 배열에 포함되는 소스 픽셀의 위치와 구형의 크기를 지정합니다. 픽셀을 적절한 색과 알파 성분으로 변환하려면 , 지정된 ColorModel 오브젝트를 사용합니다. (m, n 의 위치의) 픽셀은 인덱스 (n * scansize + m + off)의 pixels 배열에 놓여집니다. 이 메소드로 전송 되는 픽셀은 모두 int 로 저장되고 있습니다.

파라미터:

w - 픽셀 area의 폭

h - 픽셀 area의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

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

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

관련 항목:

ColorModel

imageComplete

public void imageComplete(int status)

imageComplete 메소드는 ImageProducer 가 소스 이미지의 모든 픽셀을 전송 끝마쳤을 때, 멀티 프레임 애니메이션의 1 프레임을 전송 끝마쳤을 때, 또는 이미지의 생성중 및 로딩중에 에러가 발생했을 때에 불려 갑니다. 연속하고 있는 프레임측에서 ImageConsumer 가 불필요하면, ImageProducer 로 등록된 컨슈머리스트로부터 ImageConsumer 자체를 삭제합니다.

파라미터:

status - 이미지 로드 상태

관련 항목:

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