java.awt.image
인터페이스 ImageConsumer

알려진 구현 클래스 목록:

AreaAveragingScaleFilter, BufferedImageFilter, CropImageFilter, GrayFilter, ImageFilter, PixelGrabber, ReplicateScaleFilter, RGBImageFilter

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

static final int RANDOMPIXELORDER

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

관련 항목:

setHints(int), 정수 필드값

TOPDOWNLEFTRIGHT

static final int TOPDOWNLEFTRIGHT

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

관련 항목:

setHints(int), 정수 필드값

COMPLETESCANLINES

static final int COMPLETESCANLINES

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

관련 항목:

setHints(int), 정수 필드값

SINGLEPASS

static final int SINGLEPASS

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

관련 항목:

setHints(int), 정수 필드값

SINGLEFRAME

static final int SINGLEFRAME

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

관련 항목:

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

IMAGEERROR

static final int IMAGEERROR

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

관련 항목:

imageComplete(int), 정수 필드값

SINGLEFRAMEDONE

static final int SINGLEFRAMEDONE

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

관련 항목:

imageComplete(int), 정수 필드값

STATICIMAGEDONE

static final int STATICIMAGEDONE

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

관련 항목:

imageComplete(int), 정수 필드값

IMAGEABORTED

static final int IMAGEABORTED

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

관련 항목:

imageComplete(int), 정수 필드값

메서드의 상세

setDimensions

void setDimensions(int width,
                   int height)

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

파라미터:

width - 소스 이미지의 폭

height - 소스 이미지의 높이

setProperties

void setProperties(Hashtable <?,?> props)

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

파라미터:

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

setColorModel

void setColorModel(ColorModel  model)

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

파라미터:

model - 지정된 ColorModel

관련 항목:

ColorModel

setHints

void setHints(int hintflags)

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

파라미터:

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

setPixels

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 로 포함됩니다.

파라미터:

x, y - 설정되는 픽셀 영역의 좌상구석의 좌표

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

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

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

관련 항목:

ColorModel

setPixels

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 로 포함되어 있습니다.

파라미터:

x, y - 설정되는 픽셀 영역의 좌상구석의 좌표

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

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

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

관련 항목:

ColorModel

imageComplete

void imageComplete(int status)

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

파라미터:

status - 이미지 로드 상태

관련 항목:

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