ImageConsumer (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

## 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` - 설정되는 픽셀 영역의 좌상구석의 X 좌표
    `y` - 설정되는 픽셀 영역의 좌상구석의 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` - 설정되는 픽셀 영역의 좌상구석의 X 좌표
    `y` - 설정되는 픽셀 영역의 좌상구석의 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)`

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

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 도 참조해 주세요.