javax.imageio.event
인터페이스 IIOReadProgressListener

모든 슈퍼 인터페이스:

EventListener

public interface IIOReadProgressListener

extends EventListener

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

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

public void sequenceStarted(ImageReader  source,
                            int minIndex)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

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

sequenceComplete

public void sequenceComplete(ImageReader  source)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

imageStarted

public void imageStarted(ImageReader  source,
                         int imageIndex)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

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

imageProgress

public void imageProgress(ImageReader  source,
                          float percentageDone)

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

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

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

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

imageComplete

public void imageComplete(ImageReader  source)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

thumbnailStarted

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

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

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

thumbnailIndex - 읽히는 샘 네루의 인덱스

thumbnailProgress

public void thumbnailProgress(ImageReader  source,
                              float percentageDone)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

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

thumbnailComplete

public void thumbnailComplete(ImageReader  source)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트

readAborted

public void readAborted(ImageReader  source)

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

파라미터:

source - 이 메소드를 호출하는 ImageReader 오브젝트