JavaTM Platform
Standard Ed. 6

javax.imageio.event
인터페이스 IIOReadUpdateListener

모든 슈퍼 인터페이스:
EventListener


public interface IIOReadUpdateListener
extends EventListener

호출 측에 이미지와 썸네일의 픽셀 갱신의 read 메소드를 통지하는,ImageReader 구현으로 사용되는 인터페이스입니다.

관련 항목:
ImageReader.addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener) , ImageReader.removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

메소드의 개요
 void imageUpdate (ImageReader  source, BufferedImage  theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
          지정된 이미지 영역이 갱신된 것을 통지합니다.
 void passComplete (ImageReader  source, BufferedImage  theImage)
          현재의 read 오퍼레이션이 프로그래시브 패스를 완료한 것을 통지합니다.
 void passStarted (ImageReader  source, BufferedImage  theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
          현재의 read 오퍼레이션이 프로그래시브 패스를 개시하는 것을 통지합니다.
 void thumbnailPassComplete (ImageReader  source, BufferedImage  theThumbnail)
          현재의 썸네일 read 오퍼레이션이 프로그래시브 패스를 완료한 것을 통지합니다.
 void thumbnailPassStarted (ImageReader  source, BufferedImage  theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
          현재의 썸네일 read 오퍼레이션이 프로그래시브 패스를 개시하는 것을 통지합니다.
 void thumbnailUpdate (ImageReader  source, BufferedImage  theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
          썸네일 이미지의 지정된 영역이 갱신된 것을 통지합니다.
 

메소드의 상세

passStarted

void passStarted(ImageReader  source,
                 BufferedImage  theImage,
                 int pass,
                 int minPass,
                 int maxPass,
                 int minX,
                 int minY,
                 int periodX,
                 int periodY,
                 int[] bands)
현재의 read 오퍼레이션이 프로그래시브 패스를 개시하는 것을 통지합니다. 프로그래시브 인코딩을 지원하는 형식의 리더는 이것을 사용해, 단계적으로 encode 된 이미지를 읽어들일 때, 각 패스가 완료할 때 마다 클라이언트에 통지할 필요가 있습니다.

패스에 의해 갱신되는 영역은,minXminY 파라미터로 나타납니다. 패스가 interlace가 되어 있는 경우, 즉 선택한 행 또는 열만을 갱신하는 경우는,periodXperiodY 파라미터가 서브 샘플링의 정도를 나타냅니다. 영향을 받는 밴드세트는 bands 의 값으로 나타납니다.

파라미터:
source - 이 메소드를 호출한다 ImageReader 객체
theImage - 갱신된 BufferedImage
pass - 0 으로부터 시작된다 패스의 번호
minPass - 복호화 되는 최초의 패스의 인덱스
maxPass - 복호화 되는 마지막 패스의 인덱스
minX - 갱신된 픽셀의 무엇보다 좌측의 열의 X 좌표
minY - 갱신된 픽셀의 맨 위의 행의 Y 좌표
periodX - 갱신된 픽셀간의 수평 간격. 값 1 은 간격 없음을 의미하는
periodY - 갱신된 픽셀간의 수직 간격. 값 1 은 간격 없음을 의미하는
bands - 갱신되는 밴드 세트를 나타낸다 int 의 배열

imageUpdate

void imageUpdate(ImageReader  source,
                 BufferedImage  theImage,
                 int minX,
                 int minY,
                 int width,
                 int height,
                 int periodX,
                 int periodY,
                 int[] bands)
지정된 이미지 영역이 갱신된 것을 통지합니다. 프로그래시브인 표시 효과를 내거나 다른 추가적인 처리를 실행하거나 하기 위해서, 지정된 영역을 어플리케이션으로 재표시하는 일도 있습니다.

이미지 형식의 리더가 다르면 복호화 된 픽셀의 생성 순서도 다른 경우가 있습니다. 많은 리더는 위에서 아래, 왼쪽에서 오른쪽의 순서에 픽셀을 생성합니다만, interlace, 타일링등의 복수의 패스를 사용하는 것도 있습니다. 갱신의 순서는, 네트워크의 속도등에 의해, 호출마다 다른 경우마저 있습니다. 이 메소드의 호출에서는, 지정된 픽셀이 모두 실제로 갱신되었다고 하는 것은 보증되지 않습니다. 지정된 영역의 일부로, 어느 작업이 실행된 것만이 보증됩니다.

특정의 ImageReader 구현으로 갱신의 빈도를 선택할 수가 있습니다. 각 갱신으로, 전회의 갱신 이후 지정된 영역의 이미지가 갱신되었던 것이 지정됩니다. 영역은 공간 바운딩 박스 (minX,minY,width, 및 height), X 및 Y 서브 샘플링 계수 (periodXperiodY), 및 갱신된 밴드세트 (bands)로 나타납니다. 예를 들어, 다음의 코우신에 도착해 생각해 봅시다.

 minX = 10
 minY = 20
 width = 3
 height = 4
 periodX = 2
 periodY = 3
 bands = { 1, 3 }
 
이것은, 다음의 픽셀의 밴드 1 으로 3 이 갱신된 것을 나타냅니다.
 (10, 20) (12, 20) (14, 20)
 (10, 23) (12, 23) (14, 23)
 (10, 26) (12, 26) (14, 26)
 (10, 29) (12, 29) (14, 29)
 

파라미터:
source - 이 메소드를 호출하는 ImageReader 객체
theImage - 갱신된 BufferedImage
minX - 갱신된 픽셀의 무엇보다 좌측의 열의 X 좌표
minY - 갱신된 픽셀의 맨 위의 행의 Y 좌표
width - 수평 방향의 갱신된 픽셀수
height - 수직 방향의 갱신된 픽셀수
periodX - 갱신된 픽셀간의 수평 간격. 값 1 은 간격 없음을 의미하는
periodY - 갱신된 픽셀간의 수직 간격. 값 1 은 간격 없음을 의미하는
bands - 갱신중의 밴드를 나타낸다 int 의 배열

passComplete

void passComplete(ImageReader  source,
                  BufferedImage  theImage)
현재의 read 오퍼레이션이 프로그래시브 패스를 완료한 것을 통지합니다. 프로그래시브 인코딩을 지원하는 형식의 리더는 이것을 사용해, 단계적으로 encode 된 이미지를 읽어들일 때, 각 패스가 완료할 때 마다 클라이언트에 통지할 필요가 있습니다.

파라미터:
source - 이 메소드를 호출한다 ImageReader 객체
theImage - 갱신된 BufferedImage
관련 항목:
ImageReadParam.setSourceProgressivePasses(int, int)

thumbnailPassStarted

void thumbnailPassStarted(ImageReader  source,
                          BufferedImage  theThumbnail,
                          int pass,
                          int minPass,
                          int maxPass,
                          int minX,
                          int minY,
                          int periodX,
                          int periodY,
                          int[] bands)
현재의 썸네일 read 오퍼레이션이 프로그래시브 패스를 개시하는 것을 통지합니다. 프로그래시브 인코딩을 지원하는 형식의 리더는 이것을 사용해, 단계적으로 encode 된 썸네일 이미지를 읽어들일 때, 각 패스가 완료할 때 마다 클라이언트에 통지할 필요가 있습니다.

파라미터:
source - 이 메소드를 호출한다 ImageReader 객체
theThumbnail - 갱신되었다 BufferedImage 썸네일
pass - 0 으로부터 시작된다 패스의 번호
minPass - 복호화 되는 최초의 패스의 인덱스
maxPass - 복호화 되는 마지막 패스의 인덱스
minX - 갱신된 픽셀의 무엇보다 좌측의 열의 X 좌표
minY - 갱신된 픽셀의 맨 위의 행의 Y 좌표
periodX - 갱신된 픽셀간의 수평 간격. 값 1 은 간격 없음을 의미하는
periodY - 갱신된 픽셀간의 수직 간격. 값 1 은 간격 없음을 의미하는
bands - 갱신되는 밴드 세트를 나타낸다 int 의 배열
관련 항목:
passStarted(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int, int[])

thumbnailUpdate

void thumbnailUpdate(ImageReader  source,
                     BufferedImage  theThumbnail,
                     int minX,
                     int minY,
                     int width,
                     int height,
                     int periodX,
                     int periodY,
                     int[] bands)
썸네일 이미지의 지정된 영역이 갱신된 것을 통지합니다. 프로그래시브인 표시 효과를 내거나 다른 추가적인 처리를 실행하거나 하기 위해서, 지정된 영역을 어플리케이션으로 재표시하는 일도 있습니다.

파라미터:
source - 이 메소드를 호출하는 ImageReader 객체
theThumbnail - 갱신되었다 BufferedImage 썸네일
minX - 갱신된 픽셀의 무엇보다 좌측의 열의 X 좌표
minY - 갱신된 픽셀의 맨 위의 행의 Y 좌표
width - 수평 방향의 갱신된 픽셀수
height - 수직 방향의 갱신된 픽셀수
periodX - 갱신된 픽셀간의 수평 간격. 값 1 은 간격 없음을 의미하는
periodY - 갱신된 픽셀간의 수직 간격. 값 1 은 간격 없음을 의미하는
bands - 갱신중의 밴드를 나타낸다 int 의 배열
관련 항목:
imageUpdate(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int[])

thumbnailPassComplete

void thumbnailPassComplete(ImageReader  source,
                           BufferedImage  theThumbnail)
현재의 썸네일 read 오퍼레이션이 프로그래시브 패스를 완료한 것을 통지합니다. 프로그래시브 인코딩을 지원하는 형식의 리더는 이것을 사용해, 단계적으로 encode 된 썸네일 이미지를 읽어들일 때, 각 패스가 완료할 때 마다 클라이언트에 통지할 필요가 있습니다.

파라미터:
source - 이 메소드를 호출한다 ImageReader 객체
theThumbnail - 갱신되었다 BufferedImage 썸네일
관련 항목:
passComplete(javax.imageio.ImageReader, java.awt.image.BufferedImage)

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