javax.imageio.event
인터페이스 IIOReadProgressListener

모든 슈퍼 인터페이스:

EventListener

public interface IIOReadProgressListener
extends EventListener 

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

이 인터페이스는,imageProgress 및 thumbnailProgress 메소드를 개입시켜 복호화의 진척에 관한 일반적인 지시를 받아들여,imageStarted,imageComplete,thumbnailStarted, 및 thumbnailComplete 메소드를 개입시켜 이미지 전체의 갱신이 완료한 것을 나타내는 이벤트를 받습니다. 예를 들어 단계적으로 복호화 할 경우에, 픽셀의 갱신이 발생한 것을 어플리케이션에 통지하는 경우는, 어플리케이션이 IIOReadUpdateListener 를 제공할 필요가 있습니다.

관련 항목:

IIOReadUpdateListener , ImageReader.addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener) , ImageReader.removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

메소드의 개요

void	imageComplete (ImageReader source) 현재의 이미지의 read 오퍼레이션이 완료한 것을 통지합니다.
void	imageProgress (ImageReader source, float percentageDone) 관련하는 ImageReader 의, 현재의 read 호출의 대체로의 완료 정도를 통지합니다.
void	imageStarted (ImageReader source, int imageIndex) 이미지의 read 오퍼레이션이 시작되는 것을 통지합니다.
void	readAborted (ImageReader source) 리더의 abort 메소드에 의해 read가 중단된 것을 통지합니다.
void	sequenceComplete (ImageReader source) read 오퍼레이션의 순서가 완료한 것을 통지합니다.
void	sequenceStarted (ImageReader source, int minIndex) read 오퍼레이션의 순서가 시작되는 것을 통지합니다.
void	thumbnailComplete (ImageReader source) 썸네일의 read 오퍼레이션이 완료한 것을 통지합니다.
void	thumbnailProgress (ImageReader source, float percentageDone) 관련하는 ImageReader 내의, 현재의 getThumbnail 호출의 대체로의 완료 정도를 통지합니다.
void	thumbnailStarted (ImageReader source, int imageIndex, int thumbnailIndex) 썸네일의 read 오퍼레이션이 시작되는 것을 통지합니다.

메소드의 상세

sequenceStarted

void sequenceStarted(ImageReader  source,
                     int minIndex)

read 오퍼레이션의 순서가 시작되는 것을 통지합니다. ImageReader 구현은, 그 readAll(Iterator) 메소드로부터 이 메소드를 1 회만 호출할 필요가 있습니다.

파라미터:

source - 이 메소드를 호출하는 ImageReader 객체

minIndex - 읽히는 최초의 이미지의 인덱스

sequenceComplete

void sequenceComplete(ImageReader  source)

read 오퍼레이션의 순서가 완료한 것을 통지합니다. ImageReader 구현은, 그 readAll(Iterator) 메소드로부터 이 메소드를 1 회만 호출할 필요가 있습니다.

파라미터:

source - 이 메소드를 호출하는 ImageReader 객체

imageStarted

void imageStarted(ImageReader  source,
                  int imageIndex)

이미지의 read 오퍼레이션이 시작되는 것을 통지합니다. ImageReader 구현은 모두, 이미지의 read 오퍼레이션의 개시시에 이 메소드를 1 회만 호출할 필요가 있습니다.

파라미터:

source - 이 메소드를 호출하는 ImageReader 객체

imageIndex - 입력 파일 또는 스트림내에 포함되는, 읽히는 이미지의 인덱스

imageProgress

void imageProgress(ImageReader  source,
                   float percentageDone)

관련하는 ImageReader 의, 현재의 read 호출의 대체로의 완료 정도를 통지합니다.

완료의 정도는,0.0F 에서 100.0F 까지의 퍼센트치로 표현됩니다. 퍼센트는 완료까지의 남은 시간에 대해 계산하는 것이 이상적입니다만, 일반적으로은 복호화 된 픽셀이나 사용된 입력 스트림의 일부등이 명확한 메트릭스를 사용하는 편이 실제적입니다. 어쨌든, 지정된 read 오퍼레이션중의 이 메소드의 일련의 호출에 의해, 퍼센트치가 단조롭게 증가해 나가도록(듯이) 할 필요가 있습니다. 0 으로 100 의 정확한 값은, 다른 메소드로부터 불려 가는 측에서 추측할 수 있으므로, 지정할 필요는 없습니다.

특정의 ImageReader 구현은, 각각 필요한 빈도로 이 메소드를 호출할 수가 있습니다. 경험치에서는, 약 5 퍼센트 잘게 써는 것이 되도록(듯이) 호출합니다.

파라미터:

source - 이 메소드를 호출하는 ImageReader 객체

percentageDone - 완료한 복호화의 대체로의 퍼센트치

imageComplete

void imageComplete(ImageReader  source)

현재의 이미지의 read 오퍼레이션이 완료한 것을 통지합니다. ImageReader 구현은 모두, 이미지의 read 오퍼레이션이 완료할 때 마다 이 메소드를 1 회만 호출할 필요가 있습니다.

파라미터:

source - 이 메소드를 호출한다 ImageReader 객체

thumbnailStarted

void thumbnailStarted(ImageReader  source,
                      int imageIndex,
                      int thumbnailIndex)

썸네일의 read 오퍼레이션이 시작되는 것을 통지합니다. ImageReader 구현은 모두, 썸네일의 read 오퍼레이션의 개시시에 이 메소드를 1 회만 호출할 필요가 있습니다.

파라미터:

source - 이 메소드를 호출하는 ImageReader 객체

imageIndex - 입력 파일 또는 스트림내에 포함되는, 읽히는 이미지의 인덱스

thumbnailIndex - 읽히는 썸네일의 인덱스

thumbnailProgress

void thumbnailProgress(ImageReader  source,
                       float percentageDone)

관련하는 ImageReader 내의, 현재의 getThumbnail 호출의 대체로의 완료 정도를 통지합니다. 시멘틱스는 imageProgress 의 경우와 같습니다.

파라미터:

source - 이 메소드를 호출하는 ImageReader 객체

percentageDone - 완료한 복호화의 대체로의 퍼센트치

thumbnailComplete

void thumbnailComplete(ImageReader  source)

썸네일의 read 오퍼레이션이 완료한 것을 통지합니다. ImageReader 구현은 모두, 썸네일의 read 오퍼레이션이 완료할 때 마다 이 메소드를 1 회만 호출할 필요가 있습니다.

파라미터:

source - 이 메소드를 호출한다 ImageReader 객체

readAborted

void readAborted(ImageReader  source)

리더의 abort 메소드에 의해 read가 중단된 것을 통지합니다. 이외의 통지는 행해지지 않습니다.

파라미터:

source - 이 메소드를 호출한다 ImageReader 객체