javax.imageio
클래스 ImageReader

java.lang.Object 
  javax.imageio.ImageReader

public abstract class ImageReader
extends Object 

이미지를 해석해 복호화 하는 추상 슈퍼 클래스입니다. 이 클래스는 Java Image I/O 체제의 컨텍스트 으로 이미지에 읽어내지는 클래스에 의해 상속합니다.

ImageReader객체는 보통, 특정의 형식의 서비스 프로바이더 인터페이스 (SPI)에 의해 인스턴스화 됩니다. ImageReaderSpi인스턴스등의 서비스 프로바이더 클래스는 그러한 클래스의 포맷 인식과 사용 가능한 포맷 리더 및 라이터의 표시에 사용하는 IIORegistry에 등록됩니다.

입력 소스가 setInput 메서드를 사용해 설정되는 경우, 「순서 방향 검색만」으로서 지정됩니다. 이 설정은 이전에 읽어내진 이미지와 관련된 데이터를 보관 유지하는 입력 부분의 캐쉬를 회피하기 위해서 입력 소스에 보관 유지되는 이미지가 차례로 읽어내지는 것만으로 있는 것을의미합니다.

관련 항목:

ImageWriter, IIORegistry, ImageReaderSpi

필드 개요

protected Locale []	availableLocales 경고 메세지를 지역 대응하기 위해서 사용하는 Locale 배열, 또는 지역 대응화가 지원 되어 있지 않은 경우는 null 입니다.
protected boolean	ignoreMetadata 현재의 입력 소스가setInput에 의해 메타데이타가 무시되도록 가리키는 경우는 true 입니다.
protected Object	input ImageInputStream 또는 setInput에 의해 설정되었는지, getInput에 의해 취득된 그 외의 Object 입니다.
protected Locale	locale 지역 대응화에 사용하는 현재의 Locale, 또는 설정되어 있지 않은 경우는 null 입니다.
protected int	minIndex read용의 최소 유효 인덱스는 초기 상태로 0 입니다.
protected ImageReaderSpi	originatingProvider 이 객체를 인스턴스화하는 ImageReaderSpi, 또는 식별 정보가 불명한가 존재하지 않는 경우는 null 입니다.
protected List <IIOReadProgressListener >	progressListeners 현재 등록되어 있는 각 IIOReadProgressListener List 입니다.
protected boolean	seekForwardOnly 현재의 입력 소스가setInput에 한 순서 방향 검색만이 가능해지도록 가리키는 경우는 true 입니다.
protected List <IIOReadUpdateListener >	updateListeners 현재 등록되어 있는 각 IIOReadUpdateListener List 입니다.
protected List <IIOReadWarningListener >	warningListeners 현재 등록되어 있는 IIOReadWarningListener List 입니다.
protected List <Locale >	warningLocales 현재 등록되어 있는 각 IIOReadWarningListener에 관련된 Locale List 입니다.

생성자 개요

protected

ImageReader (ImageReaderSpi originatingProvider) ImageReader을 구축해, originatingProvider 필드를, 지정된 값으로 설정합니다.

메서드 개요

void	abort () 현재의 read 오퍼레이션의 중단을 요구합니다.
protected boolean	abortRequested () 현재의 read 오퍼레이션을 중단하는 요구를 했을 경우, 리더가 인스턴스화 되는지, 또는 clearAbortRequest이 불려가기 때문에 true를 리턴합니다.
void	addIIOReadProgressListener (IIOReadProgressListener listener) IIOReadProgressListener를 등록된 진척 리스너의 리스트에 추가합니다.
void	addIIOReadUpdateListener (IIOReadUpdateListener listener) IIOReadUpdateListener를, 등록된 갱신 리스너의 리스트에 추가합니다.
void	addIIOReadWarningListener (IIOReadWarningListener listener) IIOReadWarningListener를 등록된 경고 리스너의 리스트에 추가합니다.
boolean	canReadRaster () 이 플러그 인이 픽셀 데이터 Raster 만의 read를 지원하는인 경우, true를 리턴합니다.
protected static void	checkReadParamBandSettings (ImageReadParam param, int numSrcBands, int numDstBands) ImageReadParam 소스와 목적지 밴드의 설정의 유효성을 판정하기 위해서 리더가 사용하는 유틸리티 메서드입니다.
protected void	clearAbortRequest () 이전의 중단 요구를 클리어 합니다.
protected static void	computeRegions (ImageReadParam param, int srcWidth, int srcHeight, BufferedImage image, Rectangle srcRegion, Rectangle destRegion) 소스 이미지의 폭과 높이, 옵션의 목적지 이미지 및 옵션의 ImageReadParam를 고려해, 대상의 소스 영역 및 대상의 목적지 영역을 계산합니다.
void	dispose () 이 객체가 보관 유지하는 모든 자원을 해방할 수 있도록 합니다.
float	getAspectRatio (int imageIndex) 지정된 이미지의 종횡비 (즉, 넓이를 높이로 나눈 값)를 float로 리턴합니다.
Locale []	getAvailableLocales () 경고 리스너와 압축 설정의 지역 대응화를 위해서 사용하는 Locale 배열을 리턴합니다.
ImageReadParam	getDefaultReadParam () 이 형식에 대해서 적절한 디폴트의 ImageReadParam 객체를 리턴합니다.
protected static BufferedImage	getDestination (ImageReadParam param, Iterator <ImageTypeSpecifier > imageTypes, int width, int height) 복호화 된 픽셀 데이터가 출력해지는 BufferedImage를 리턴합니다.
String	getFormatName () 입력 소스의 형식을 식별하는 String를 리턴합니다.
abstract int	getHeight (int imageIndex) 입력 소스의 지정된 이미지의 높이를 픽셀 단위로 리턴합니다.
abstract IIOMetadata	getImageMetadata (int imageIndex) 지정된 이미지에 관련된 메타데이타를 보관 유지하는 IIOMetadata 객체를 리턴합니다.
IIOMetadata	getImageMetadata (int imageIndex, String formatName, Set <String > nodeNames) 지정된 이미지에 관련된 메타데이타를 나타내는 IIOMetadata 객체를 리턴합니다.
abstract Iterator <ImageTypeSpecifier >	getImageTypes (int imageIndex) ImageTypeSpecifiers 형식에서 지정된 이미지가 복호화 되는 이미지형을 포함한 Iterator를 리턴합니다.
Object	getInput () ImageReaderSpi 또는 이전에 입력 소스로서 설정된 다른 Object를 리턴합니다.
Locale	getLocale () 현재 설정되어 있는 Locale, 아무것도 설정되어 있지 않은 경우는 null을 리턴합니다.
int	getMinIndex () 이미지, 썸네일, 또는 이메이지메타데이타의 read에 대해서 유효한, 최소의 인덱스를 리턴합니다.
abstract int	getNumImages (boolean allowSearch) 현재의 입력 소스로부터, 썸네일를 제외한 사용 가능한 이미지의 수를 리턴합니다.
int	getNumThumbnails (int imageIndex) 지정된 이미지에 관련된 썸네일 프리뷰 이미지의 수를 리턴합니다.
ImageReaderSpi	getOriginatingProvider () 이 생성자에게 건네진 ImageReaderSpi를 리턴합니다.
ImageTypeSpecifier	getRawImageType (int imageIndex) 이미지의 raw 내부 형식에 가장 가까운 형식을 나타내는 SampleModel와 ColorModel을 나타내, ImageTypeSpecifier를 리턴합니다.
protected static Rectangle	getSourceRegion (ImageReadParam param, int srcWidth, int srcHeight) 지정된 ImageReadParam 소스 영역과 서브 샘플링의 좌표의 설정을 고려해, 리더가 읽어내는 소스 이미지의 영역을 계산하기 위해서 사용하는 유틸리티 메서드입니다.
abstract IIOMetadata	getStreamMetadata () 입력 소스에 전체적으로 관련된, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 객체를 리턴합니다.
IIOMetadata	getStreamMetadata (String formatName, Set <String > nodeNames) 입력 소스에 전체적으로 관련된, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 객체를 리턴합니다.
int	getThumbnailHeight (int imageIndex, int thumbnailIndex) thumbnailIndex에 의해 인덱스를 붙일 수 있었던 썸네일 프리뷰 이미지의 높이를 리턴합니다.
int	getThumbnailWidth (int imageIndex, int thumbnailIndex) thumbnailIndex에 의해 인덱스를 붙일 수 있었던 썸네일 프리뷰 이미지의 넓이를 리턴합니다.
int	getTileGridXOffset (int imageIndex) 지정된 이미지의 타일 (0, 0)의 좌상구석의 X 좌표를 리턴합니다.
int	getTileGridYOffset (int imageIndex) 지정된 이미지의 타일 (0, 0)의 좌상구석의 Y 좌표를 리턴합니다.
int	getTileHeight (int imageIndex) 지정된 이미지의 타일의 높이를 리턴합니다.
int	getTileWidth (int imageIndex) 지정된 이미지의 타일의 넓이를 리턴합니다.
abstract int	getWidth (int imageIndex) 입력 소스의 지정된 이미지의 넓이를 픽셀 단위로 리턴합니다.
boolean	hasThumbnails (int imageIndex) 지정된 이미지가 거기에 관련된 썸네일 프리뷰 이미지를 가지는 경우, true를 리턴합니다.
boolean	isIgnoringMetadata () 현재의 입력 소스가setInput 메서드의 ignoreMetadata인수로서 true를 건네주는 것으로 메타데이타를 무시할 수 있도록 가리키는 경우는 true를 리턴합니다.
boolean	isImageTiled (int imageIndex) 이미지가 타일, 즉 오버랩 하지 않는 동일한 사이즈의 구형에 집어 넣을 수 있는 경우는 true를 리턴합니다.
boolean	isRandomAccessEasy (int imageIndex) 픽셀에의 랜덤 액세스에 관해서, 지정된 이미지의 포함 형식에 고유의 장해가 아무것도 없는 경우는 true를 리턴합니다.
boolean	isSeekForwardOnly () 현재의 입력 소스가setInput 메서드의 seekForwardOnly인수로서 true를 건네주는 것으로 순서 방향 검색만으로 실시와 가리키는 경우는 true를 리턴합니다.
protected void	processImageComplete () imageComplete 메서드의 호출에의해 이미지 읽을 완료를, 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processImageProgress (float percentageDone) imageProgress 메서드의 호출에의해 이미지 완성의 현재의 비율을 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processImageStarted (int imageIndex) imageStarted 메서드의 호출에의해 이미지 읽을 개시를, 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processImageUpdate (BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands) imageUpdate 메서드의 호출에의해 샘플세트의 갱신을 등록된 모든 IIOReadUpdateListener에 통지합니다.
protected void	processPassComplete (BufferedImage theImage) passComplete 메서드의 호출에의해 프로그래시브 패스의 종료를, 등록된 모든 IIOReadUpdateListener에 통지합니다.
protected void	processPassStarted (BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands) passStarted 메서드의 호출에의해 프로그래시브 패스의 개시를, 등록된 모든 IIOReadUpdateListener에 통지합니다.
protected void	processReadAborted () readAborted 메서드의 호출에의해 read가 중단된 것을 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processSequenceComplete () sequenceComplete 메서드의 호출에의해 이미지 읽을 순서의 완료를, 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processSequenceStarted (int minIndex) sequenceStarted 메서드의 호출에의해 이미지 읽을 순서의 개시를, 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processThumbnailComplete () thumbnailComplete 메서드의 호출에의해 썸네일 읽을 완료를, 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processThumbnailPassComplete (BufferedImage theThumbnail) thumbnailPassComplete 메서드의 호출에의해 썸네일의 프로그래시브 패스의 종료를, 등록된 모든 IIOReadUpdateListener에 통지합니다.
protected void	processThumbnailPassStarted (BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands) thumbnailPassStarted 메서드의 호출에의해 썸네일의 프로그래시브 패스의 개시를, 등록된 모든 IIOReadUpdateListener에 통지합니다.
protected void	processThumbnailProgress (float percentageDone) thumbnailProgress 메서드의 호출에의해 썸네일 완성의 현재의 비율을 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processThumbnailStarted (int imageIndex, int thumbnailIndex) thumbnailStarted 메서드의 호출에의해 썸네일 읽을 개시를, 등록된 모든 IIOReadProgressListener에 통지합니다.
protected void	processThumbnailUpdate (BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands) thumbnailUpdate 메서드의 호출에의해 썸네일 이미지의 샘플세트의 갱신을 등록된 모든 IIOReadUpdateListener에 통지합니다.
protected void	processWarningOccurred (String warning) warningOccurred 메서드의 호출에의해 경고 메세지를, 등록된 모든 IIOReadWarningListener에 통지합니다.
protected void	processWarningOccurred (String baseName, String keyword) ResourceBundle로 부터 취득한 캐릭터 라인을 가지는 warningOccurred 메서드의 호출에의해 지역 대응된 경고 메세지를, 등록된 모든 IIOReadWarningListener에 통지합니다.
BufferedImage	read (int imageIndex) imageIndex에 의해 인덱스를 붙일 수 있었던 이미지를 읽기, 디폴트의 ImageReadParam를 사용해, 완전한 BufferedImage로 서 리턴합니다.
abstract BufferedImage	read (int imageIndex, ImageReadParam param) imageIndex에 의해 인덱스를 붙일 수 있었던 이미지를 읽기, 지정된 ImageReadParam를 사용해, 완전한 BufferedImage로 서 리턴합니다.
IIOImage	readAll (int imageIndex, ImageReadParam param) imageIndex에 의해 인덱스를 붙일 수 있었던 이미지를 읽기, 지정된 ImageReadParam를 사용해, 이미지, 썸네일 및 관련된 이미지의 메타데이타를 보관 유지하는 IIOImage를 리턴합니다.
Iterator <IIOImage >	readAll (Iterator <? extends ImageReadParam > params) 모든 이미지, 썸네일 및 메타데이타를 보관 유지해, getMinIndex에 의해 지정된 인덱스로 시작되는 Iterator를, IIOImage 객체의 형식에서 입력 소스로부터 리턴합니다.
RenderedImage	readAsRenderedImage (int imageIndex, ImageReadParam param) imageIndex에 의해 인덱스를 붙일 수 있었던 이미지의 내용을 보관 유지하는 RenderedImage 객체를 리턴합니다.
boolean	readerSupportsThumbnails () 이 리더에 의해 이해되는 이미지 형식이, 거기에 관련된 썸네일 프리뷰 이미지를 지원하는인 경우, true를 리턴합니다.
Raster	readRaster (int imageIndex, ImageReadParam param) 색변환을 적용하지 않고, 이미지 스트림로부터의 픽셀 데이터를 보관 유지하는 새로운 Raster 객체를 리턴합니다.
BufferedImage	readThumbnail (int imageIndex, int thumbnailIndex) thumbnailIndex에 의해 인덱스를 붙일 수 있었던 썸네일 프리뷰 이미지를 리턴합니다.
BufferedImage	readTile (int imageIndex, int tileX, int tileY) tileX 및 tileY인수에 의해 지정되어BufferedImage로 서 리턴된 타일을 읽어들입니다.
Raster	readTileRaster (int imageIndex, int tileX, int tileY) 색변환을 적용하지 않고, 타일로부터의 raw 픽셀 데이터를 보관 유지하는 새로운 Raster 객체를 리턴합니다.
void	removeAllIIOReadProgressListeners () 현재 등록되어 모든 IIOReadProgressListener 객체를 삭제합니다.
void	removeAllIIOReadUpdateListeners () 현재 등록되어 모든 IIOReadUpdateListener 객체를 삭제합니다.
void	removeAllIIOReadWarningListeners () 현재 등록되어 모든 IIOReadWarningListener 객체를 삭제합니다.
void	removeIIOReadProgressListener (IIOReadProgressListener listener) 등록된 진척 리스너의 리스트로부터, IIOReadProgressListener를 삭제합니다.
void	removeIIOReadUpdateListener (IIOReadUpdateListener listener) 등록된 갱신 리스너의 리스트로부터, IIOReadUpdateListener를 삭제합니다.
void	removeIIOReadWarningListener (IIOReadWarningListener listener) 등록된 에러 리스너의 리스트로부터, IIOReadWarningListener를 삭제합니다.
void	reset () ImageReader를 초기 상태에 복원합니다.
void	setInput (Object input) 지정된 ImageInputStream 또는 다른 Object에 사용하기 위해서 입력 소스를 설정합니다.
void	setInput (Object input, boolean seekForwardOnly) 지정된 ImageInputStream 또는 다른 Object에 사용하기 위해서 입력 소스를 설정합니다.
void	setInput (Object input, boolean seekForwardOnly, boolean ignoreMetadata) 지정된 ImageInputStream 또는 다른 Object에 사용하기 위해서 입력 소스를 설정합니다.
void	setLocale (Locale locale) 이 ImageReader 현재의 Locale가 지정된 값으로 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

originatingProvider

protected ImageReaderSpi  originatingProvider

이 객체를 인스턴스화하는 ImageReaderSpi, 또는 식별 정보가 불명한가 존재하지 않는 경우는 null 입니다. 디폴트에서는 null에 초기화됩니다.

input

protected Object  input

ImageInputStream 또는 setInput에 의해 설정되었는지, getInput에 의해 취득된 그 외의 Object 입니다. 디폴트에서는 null에 초기화됩니다.

seekForwardOnly

protected boolean seekForwardOnly

현재의 입력 소스가setInput에 한 순서 방향 검색만이 가능해지도록 가리키는 경우는 true 입니다. 디폴트로 값은 false 입니다.

관련 항목:

minIndex, setInput(java.lang.Object, boolean, boolean)

ignoreMetadata

protected boolean ignoreMetadata

현재의 입력 소스가setInput에 의해 메타데이타가 무시되도록 가리키는 경우는 true 입니다. 디폴트의 값은 false 입니다.

관련 항목:

setInput(java.lang.Object, boolean, boolean)

minIndex

protected int minIndex

read용의 최소 유효 인덱스는 초기 상태로 0 입니다. seekForwardOnly가 true인 경우, 다양한 메서드가 보다 작은 인덱스를 가지는 이미지에 관련된 데이터에 액세스 하려고의해 IndexOutOfBoundsException을 Throw 합니다.

관련 항목:

seekForwardOnly, setInput(java.lang.Object, boolean, boolean)

availableLocales

protected Locale [] availableLocales

경고 메세지를 지역 대응하기 위해서 사용하는 Locale 배열, 또는 지역 대응화가 지원 되어 있지 않은 경우는 null 입니다.

locale

protected Locale  locale

지역 대응화에 사용하는 현재의 Locale, 또는 설정되어 있지 않은 경우는 null 입니다.

warningListeners

protected List <IIOReadWarningListener > warningListeners

현재 등록되어 있는 IIOReadWarningListener List 입니다. 디폴트에서는 null에 초기화되어 비어있는 List와 같은 의미가 됩니다.

warningLocales

protected List <Locale > warningLocales

현재 등록되어 있는 각 IIOReadWarningListener에 관련된 Locale List 입니다. 디폴트에서는 null에 초기화되어 비어있는 List와 같은 의미가 됩니다.

progressListeners

protected List <IIOReadProgressListener > progressListeners

현재 등록되어 있는 각 IIOReadProgressListener List 입니다. 디폴트에서는 null에 초기화되어 비어있는 List와 같은 의미가 됩니다.

updateListeners

protected List <IIOReadUpdateListener > updateListeners

현재 등록되어 있는 각 IIOReadUpdateListener List 입니다. 디폴트에서는 null에 초기화되어 비어있는 List와 같은 의미가 됩니다.

생성자 상세

ImageReader

protected ImageReader(ImageReaderSpi  originatingProvider)

ImageReader을 구축해, originatingProvider 필드를, 지정된 값으로 설정합니다.

확장 기능을 사용하는 서브 클래스는 확장 객체를 취득하기 위해서 (ImageReaderSpi, Object) 시그니쳐를 가지는 생성자를 제공할 필요가 있습니다. 확장 객체가 적절하지 않은 경우, IllegalArgumentException가 발생 됩니다.

파라미터:

originatingProvider - 이 생성자를 호출하는 ImageReaderSpi 또는 null

메서드의 상세

getFormatName

public String  getFormatName()
                     throws IOException 

입력 소스의 형식을 식별하는 String를 리턴합니다.

디폴트 구현은 originatingProvider.getFormatNames()[0]을 리턴합니다. 발생원의 서비스 프로바이더를 가지지 않는가 다른 네이밍 정책가 필요한 구현은 이 메서드를 오버라이드(override) 할 필요가 있습니다.

반환값:

String로서의 형식명

예외:

IOException - 입력 소스로부터의 정보의 read error가 발생했을 경우

getOriginatingProvider

public ImageReaderSpi  getOriginatingProvider()

이 생성자에게 건네진 ImageReaderSpi를 리턴합니다. 이 값은 null인 경우가 있는 것에 주의해 주세요.

반환값:

ImageReaderSpi 또는 null

관련 항목:

ImageReaderSpi

setInput

public void setInput(Object  input,
                     boolean seekForwardOnly,
                     boolean ignoreMetadata)

지정된 ImageInputStream 또는 다른 Object에 사용하기 위해서 입력 소스를 설정합니다. 입력 소스는 조회 또는 읽기 메서드를 사용하기 전으로 설정합니다. input이 null인 경우, 현재 설정되어 있는 입력 소스는 삭제됩니다. 어느 경우도, minIndex값은 0에 초기화됩니다.

seekForwardOnly 파라미터는 getMinIndex에 의해 리턴된 값이, 이미지, 썸네일, 또는 이메이지메타데이타가 읽어내질 때 마다 증가할지 어떨지를 제어합니다. seekForwardOnly가 true 때, read(index) 호출은, index < this.minIndex인 경우에는 IndexOutOfBoundsException을 Throw 해, 그렇지 않은 경우에는 minIndex값을 index로 설정합니다. seekForwardOnly가 false인 경우, read 오퍼레이션에 관계없이 minIndex값은 0 대로 됩니다.

true로 설정되어 있는 경우, ignoreMetadata 파라미터는 read중에 발생한 메타데이타를 리더가 무시할 수 있도록 합니다. 그 후의 getStreamMetadata 및 getImageMetadata 메서드의 호출은 null을 돌려주고, readAll로 부터 리턴된 IIOImage는 getMetadata 메서드로부터 null을 리턴합니다. 이 파라미터의 설정에의해 리더는 보다 효율적으로 작업할 수 있게 됩니다. 리더는 이 설정을 무효로의해 보통 대로 메타데이타를 돌려줄 수가 있습니다.

서브 클래스는 헤더 정보나 부분적으로 복호화 된 이미지 데이터 등, 이전의 스트림에 근거하는 캐쉬 정보의 삭제에 주의할 필요가 있습니다.

ImageInputStream는 아니고, 일반적인 Object를 사용하는 것은 취득 디바이스 또는 이미지 처리 프로토콜과 직접 대화하는 리더를 도하고 있습니다. 정당한 클래스세트는 리더의 서비스 프로바이더의 getInputTypes 메서드에 의해 통지됩니다. 대부분의 리더는 ImageInputStream.class 만을 보관 유지하는 단일 요소의 배열을 돌려주고, ImageInputStream 만을 받는 것을 나타냅니다.

디폴트 구현은, originatingProvider.getInputTypes()에 의해 리턴된 리스트에 대해서 input인수를 확인해, 인수가 리스트내의 1개의 클래스의 인스턴스가 아닌 경우는 실패합니다. 발생원의 프로바이더가 null로 설정되어 있는 경우, 입력이 ImageInputStream인 경우인 만큼 수취됩니다.

파라미터:

input - ImageInputStream 또는 향후, 복호화로 사용하는 다른 Object

seekForwardOnly - true인 경우, 이미지와 메타데이타는 이 입력 소스로부터 승순으로만 읽어내지는

ignoreMetadata - true인 경우, 메타데이타는 읽기 안에 무시된다

예외:

IllegalArgumentException - input이 발생원서비스 프로바이더의 getInputTypes 메서드에 의해 리턴된 1개의 클래스의 인스턴스가 아닌 경우, 또는 ImageInputStream가 아닌 경우

관련 항목:

ImageInputStream, getInput(), ImageReaderSpi.getInputTypes()

setInput

public void setInput(Object  input,
                     boolean seekForwardOnly)

지정된 ImageInputStream 또는 다른 Object에 사용하기 위해서 입력 소스를 설정합니다. 입력 소스는 조회 또는 읽기 메서드를 사용하기 전으로 설정합니다. input이 null인 경우, 현재 설정되어 있는 입력 소스는 삭제됩니다. 어느 경우도, minIndex값은 0에 초기화됩니다.

seekForwardOnly 파라미터는 getMinIndex에 의해 리턴된 값이, 이미지, 썸네일, 또는 이메이지메타데이타가 읽어내질 때 마다 증가할지 어떨지를 제어합니다. seekForwardOnly가 true 때, read(index) 호출은, index < this.minIndex인 경우에는 IndexOutOfBoundsException을 Throw 해, 그렇지 않은 경우에는 minIndex값을 index로 설정합니다. seekForwardOnly가 false인 경우, read 오퍼레이션에 관계없이 minIndex값은 0 대로 됩니다.

이 메서드는 setInput(input, seekForwardOnly, false)와 동등합니다.

파라미터:

input - ImageInputStream 또는 향후, 복호화로 사용하는 다른 Object

seekForwardOnly - true인 경우, 이미지와 메타데이타는 이 입력 소스로부터 승순으로만 읽어내진다

예외:

IllegalArgumentException - input이 발생원서비스 프로바이더의 getInputTypes 메서드에 의해 리턴된 1개의 클래스의 인스턴스가 아닌 경우, 또는 ImageInputStream가 아닌 경우

관련 항목:

getInput()

setInput

public void setInput(Object  input)

지정된 ImageInputStream 또는 다른 Object에 사용하기 위해서 입력 소스를 설정합니다. 입력 소스는 조회 또는 읽기 메서드를 사용하기 전으로 설정합니다. input이 null인 경우, 현재 설정되어 있는 입력 소스는 삭제됩니다. 어느 경우도, minIndex값은 0에 초기화됩니다.

이 메서드는 setInput(input, false, false)와 동등합니다.

파라미터:

input - ImageInputStream 또는 향후, 복호화로 사용하는 다른 Object

예외:

IllegalArgumentException - input이 발생원서비스 프로바이더의 getInputTypes 메서드에 의해 리턴된 1개의 클래스의 인스턴스가 아닌 경우, 또는 ImageInputStream가 아닌 경우

관련 항목:

getInput()

getInput

public Object  getInput()

ImageReaderSpi 또는 이전에 입력 소스로서 설정된 다른 Object를 리턴합니다. 입력 소스가 설정되어 있지 않은 경우, null이 리턴됩니다 .

반환값:

향후, 복호화로 사용되는 Object 또는 null

관련 항목:

ImageInputStream, setInput(java.lang.Object, boolean, boolean)

isSeekForwardOnly

public boolean isSeekForwardOnly()

현재의 입력 소스가setInput 메서드의 seekForwardOnly인수로서 true를 건네주는 것으로 순서 방향 검색만으로 실시와 가리키는 경우는 true를 리턴합니다.

반환값:

입력 소스가 순서 방향 검색만의 경우는 true

관련 항목:

setInput(java.lang.Object, boolean, boolean)

isIgnoringMetadata

public boolean isIgnoringMetadata()

현재의 입력 소스가setInput 메서드의 ignoreMetadata인수로서 true를 건네주는 것으로 메타데이타를 무시할 수 있도록 가리키는 경우는 true를 리턴합니다.

반환값:

메타데이타를 무시할 수 있는 경우는 true

관련 항목:

setInput(java.lang.Object, boolean, boolean)

getMinIndex

public int getMinIndex()

이미지, 썸네일, 또는 이메이지메타데이타의 read에 대해서 유효한, 최소의 인덱스를 리턴합니다. seekForwardOnly()가 false인 경우, 이 값은 보통 0 인 채되어, 랜덤 액세스가 가능한 것을 나타냅니다. 그 외의 경우, 직전에 액세스 된 인덱스의 값을 보관 유지해, 단조롭게 증가합니다.

반환값:

read용의 정당한 최소 인덱스

getAvailableLocales

public Locale [] getAvailableLocales()

경고 리스너와 압축 설정의 지역 대응화를 위해서 사용하는 Locale 배열을 리턴합니다. 반환값 null은 지역 대응화가 지원 되어 있지 않은 것을 나타냅니다.

디폴트 구현은 그것이 null 이외의 경우는 availableLocales인스턴스 변수의 복제를 돌려주고, null인 경우는 null을 리턴합니다.

반환값:

setLocale 인수로서 사용하는 Locale 배열, 또는 null

setLocale

public void setLocale(Locale  locale)

이 ImageReader 현재의 Locale가 지정된 값으로 설정합니다. 값 null은 이전의 설정을 삭제해, 리더가 적절한 방법으로 지역 대응할 필요가 있는 것을 나타냅니다.

파라미터:

locale - 목적의 Locale 또는 null

예외:

IllegalArgumentException - locale가 null은 아니지만, getAvailableLocales에 의해 리턴된 값의 1개가 아닌 경우

관련 항목:

getLocale()

getLocale

public Locale  getLocale()

현재 설정되어 있는 Locale, 아무것도 설정되어 있지 않은 경우는 null을 리턴합니다.

반환값:

현재의 Locale 또는 null

관련 항목:

setLocale(java.util.Locale)

getNumImages

public abstract int getNumImages(boolean allowSearch)
                          throws IOException 

현재의 입력 소스로부터, 썸네일를 제외한 사용 가능한 이미지의 수를 리턴합니다.

동영상 GIF 등 일부의 이미지 형식은 현재의 스트림에 있는 이미지의 수를 지정하지 않는 것에 주의해 주세요. 이 때문에 이미지수를 확인하려면 스트림 전체의 주사와 버퍼링을 실시하기 때문에 많은 메모리가 필요하게 됩니다. 이미지가 차례로 처리되는 경우는 단순하게 read를 호출해, IndexOutOfBoundsException가 발생되는 것으로 사용할 수 있는 이미지가 더 이상 없는 것을 나타낼 때까지 인덱스를 증가시키는 (분)편이 효율적입니다. allowSearch 파라미터를 false로 설정해, 철저한 검색이 불필요한 것을 지시할 수 있습니다. 이 경우 반환값은 -1 되어, 검색이 필요한 것을 나타냅니다. 입력이 seekForwardOnly로 지정되어true로 설정되어 있을 때, 이 메서드는 allowSearch가 true로 설정되어 있으면, IllegalStateException을 Throw 합니다.

파라미터:

allowSearch - true인 경우, 검색이 필요한 때에도 진정한 이미지의 수를 돌려준다. false인 경우, 리더는 검색을 실행하지 않고 -1를 돌려준다

반환값:

int로서의 이미지의 수, 또는 allowSearch가 false인 경우는 -1을 돌려주고, 검색을 요구한다

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우, 또는 입력 소스가 true로 설정된 seekForwardOnly에 의해 가리키는 경우

IOException - 입력 소스로부터의 정보의 read error가 발생했을 경우

관련 항목:

setInput(java.lang.Object, boolean, boolean)

getWidth

public abstract int getWidth(int imageIndex)
                      throws IOException 

입력 소스의 지정된 이미지의 넓이를 픽셀 단위로 리턴합니다.

사용자 지정의 사이즈로 이미지를 렌더링 할 수 있는 경우, 이 메서드는 디폴트의 넓이를 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

int로서의 이미지의 폭

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - 입력 소스로부터 폭의 정보의 read중에 에러가 발생했을 경우

getHeight

public abstract int getHeight(int imageIndex)
                       throws IOException 

입력 소스의 지정된 이미지의 높이를 픽셀 단위로 리턴합니다.

사용자 지정의 사이즈로 이미지를 렌더링 할 수 있는 경우, 이 메서드는 디폴트의 높이를 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

int로서의 이미지의 높이

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - 입력 소스로부터 높이의 정보의 read중에 에러가 발생했을 경우

isRandomAccessEasy

public boolean isRandomAccessEasy(int imageIndex)
                           throws IOException 

픽셀에의 랜덤 액세스에 관해서, 지정된 이미지의 포함 형식에 고유의 장해가 아무것도 없는 경우는 true를 리턴합니다. JPEG 등 대부분의 압축 형식의 경우, 대상의 영역에 더해대규모 섹션을 복호화 할 필요가 있기 때문에 이 메서드는 false를 리턴합니다.

이것은 프로그램을 효율적으로 실시하기 위한 힌트에 지나지 않습니다. 모든 리더는 ImageReadParam로 가리키는 대로 임의의 영역을 읽어낼 필요가 있습니다.

그 경우에서도, 이 메서드로부터 false를 돌려주는 형식은 JPEG Restart Marker와 같은 타일링이 가능하고, 타일상의 랜덤 액세스가 매우 효율적이 되는 것에 주의해 주세요. 자세한 것은 isImageTiled를 참조하십시오.

모든 이미지가 간단한 랜덤 액세스의 지원가 보증되고 있는 리더, 또는 간단한 랜덤 액세스의 지원가 보증되지 않는 리더는 이미지 데이터에 액세스 하지 않고, 각각 true 또는 false를 리턴합니다. 이러한 경우는 입력 소스가 설정되어 있지 않아도, 혹은 이미지의 인덱스가 범위외에서 만나도, 예외를 Throw 할 필요는 없습니다.

디폴트 구현은 false를 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

지정된 이미지의 대상 영역의 read를 효율적이 된다고 생각되는 경우는 true

예외:

IllegalStateException - 입력 소스가 반환값의 결정이 요구되는 경우로 아무것도 설정되어 있지 않은 경우

IndexOutOfBoundsException - 반환값을 결정하기 위해서 이미지에 액세스 할 필요가 있지만, 지정된 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getAspectRatio

public float getAspectRatio(int imageIndex)
                     throws IOException 

지정된 이미지의 종횡비 (즉, 넓이를 높이로 나눈 값)를 float로 리턴합니다. 본래 사이즈 변경이 가능한 이미지의 경우, 이 메서드는 지정된 적절한 높이를 가지는넓이 (또는 그 역의 경우)을 결정하는 방법을 제공합니다. 사이즈 변경을 할 수 없는 이미지의 경우, 실제의 폭과 높이를 사용합니다.

디폴트 구현은 단지 (float) getWidth(imageIndex) /getHeight(imageIndex)를 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

지정된 이미지의 종횡비를 나타내는 float

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getRawImageType

public ImageTypeSpecifier  getRawImageType(int imageIndex)
                                   throws IOException 

이미지의 raw 내부 형식에 가장 가까운 형식을 나타내는 SampleModel와 ColorModel을 나타내, ImageTypeSpecifier를 리턴합니다. 예를 들어 JPEG 이미지의 경우, 보통, 표시되기 전에 이미지를 RGB 컬러 영역로 변환하는 경우에서도, raw 형은 YCbCr 컬러 영역를 가집니다. 또, 리턴된 값은 getImageTypes에 의해 리턴된 값의 리스트에 포함될 필요가 있습니다.

디폴트 구현은, getImageType가 제공하는 리스트로부터 최초의 엔트리를 돌려줄 뿐입니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

ImageTypeSpecifier

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - 입력 소스로부터의 형식 정보의 read중에 에러가 발생했을 경우

getImageTypes

public abstract Iterator <ImageTypeSpecifier > getImageTypes(int imageIndex)
                                                    throws IOException 

ImageTypeSpecifiers 형식에서 지정된 이미지가 복호화 되는 이미지형을 포함한 Iterator를 리턴합니다. 적어도 1개의 유효한 이미지형이 리턴됩니다 .

반복자의 최초의 요소는 이미지를 가능한 한 작고 복호화 하기 위해서 가장 「자연스러운」형태가 아니면 안됩니다. 예를 들어 JPEG 이미지의 경우, 이미지 데이터가 내부적으로 YCbCr 컬러 영역에 포함되고 있는 경우에서도, 최초의 엔트리는 RGB 이미지가 됩니다.

파라미터:

imageIndex - retrieved 되는 이미지의 인덱스

반환값:

현재 가리키는 이미지를 복호화 하기 위해서 추천 된 이미지형을 나타낸다, 적어도 1개의 ImageTypeSpecifier를 보관 유지하는 Iterator

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - 입력 소스로부터의 형식 정보의 read중에 에러가 발생했을 경우

관련 항목:

ImageReadParam.setDestination(BufferedImage), ImageReadParam.setDestinationType(ImageTypeSpecifier)

getDefaultReadParam

public ImageReadParam  getDefaultReadParam()

이 형식에 대해서 적절한 디폴트의 ImageReadParam 객체를 리턴합니다. 모든 서브 클래스는 모든 파라미터의 기본값 세트를 정의해, 이 호출로 그것들을 돌려주지 않으면 안됩니다. 이 메서드는 입력 소스가 설정되기 전에 호출합니다.

디폴트 구현은 소스의 슬캘링을 실행할 수 없는 새로운 ImageReadParam 객체를 구축해 리턴합니다. 즉, new ImageReadParam()를 리턴합니다.

반환값:

일련의 디폴트의 설정을 사용해, 복호화 프로세스를 제어하기 위해서 사용되는 ImageReadParam 객체

getStreamMetadata

public abstract IIOMetadata  getStreamMetadata()
                                       throws IOException 

입력 소스에 전체적으로 관련된, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 객체를 리턴합니다. 또는 리더가 메타데이타를 무시하도록 설정되어 메타데이타의 read를 지원 하고 있지 않는 경우, 혹은 메타데이타를 사용할 수 없는 경우는 null을 리턴합니다.

반환값:

IIOMetadata 객체, 또는 null

예외:

IOException - read중에 에러가 발생했을 경우

getStreamMetadata

public IIOMetadata  getStreamMetadata(String  formatName,
                                     Set <String > nodeNames)
                              throws IOException 

입력 소스에 전체적으로 관련된, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 객체를 리턴합니다. 이러한 데이터가 존재하지 않는 경우는 null을 리턴합니다.

결과의 메타데이타오브제크트는 formatName와 이름을 붙일 수 있었던 형식의 문서를 돌려줄 뿐입니다. 리턴된 문서내에서 이름이 nodeNames 멤버인 노드만을 돌려주도록 요구됩니다. 이와 같이 해, 리더에 의해 처리된 메타데이타의 양이 실제로 필요한 정보에 근거하는 최소의 양이 되도록 관리됩니다.

formatName가 지원 된 메타데이타 형식의 이름이 아닌 경우, null을 리턴합니다.

어떠한 경우에서도, 엄밀하게 필요한 객체보다, 유효한 메타데이타오브제크트를 돌려줄 수가 있습니다. 형식명 및 노드명은 리더의 작업 부하를 삭감하기 위해서 사용하는 힌트에 지나지 않습니다.

디폴트 구현은 형식명이 지원 되고 있는 것을 확인하고 나서 getStreamMetadata() 호출의 결과를 돌려줄 뿐입니다. 지원 되어 있지 않은 경우는 null을 리턴합니다.

파라미터:

formatName - 리턴된 IIOMetadata 객체로부터 문서를 취득하기 위해서 사용하는 메타데이타의 형식명

nodeNames - 취득된 문서에 포함되는 노드명을 보관 유지하는 Set

반환값:

IIOMetadata 객체, 또는 null

예외:

IllegalArgumentException - formatName가 null인 경우

IllegalArgumentException - nodeNames가 null인 경우

IOException - read중에 에러가 발생했을 경우

getImageMetadata

public abstract IIOMetadata  getImageMetadata(int imageIndex)
                                      throws IOException 

지정된 이미지에 관련된 메타데이타를 보관 유지하는 IIOMetadata 객체를 리턴합니다. 또는 리더가 메타데이타를 무시하도록 설정되어 메타데이타의 read를 지원 하고 있지 않는 경우, 혹은 메타데이타를 사용할 수 없는 경우는 null을 리턴합니다.

파라미터:

imageIndex - 메타데이타의 취득원이미지의 인덱스

반환값:

IIOMetadata 객체, 또는 null

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getImageMetadata

public IIOMetadata  getImageMetadata(int imageIndex,
                                    String  formatName,
                                    Set <String > nodeNames)
                             throws IOException 

지정된 이미지에 관련된 메타데이타를 나타내는 IIOMetadata 객체를 리턴합니다. 또는 리더가 메타데이타의 read를 지원 하고 있지 않는 경우, 혹은 메타데이타를 사용할 수 없는 경우는 null을 리턴합니다.

결과의 메타데이타오브제크트는 formatName와 이름을 붙일 수 있었던 형식의 문서를 돌려줄 뿐입니다. 리턴된 문서내에서 이름이 nodeNames 멤버인 노드만을 돌려주도록 요구됩니다. 이와 같이 해, 리더에 의해 처리된 메타데이타의 양이 실제로 필요한 정보에 근거하는 최소의 양이 되도록 관리됩니다.

formatName가 지원 된 메타데이타 형식의 이름이 아닌 경우, null을 리턴합니다.

어떠한 경우에서도, 엄밀하게 필요한 객체보다, 유효한 메타데이타오브제크트를 돌려줄 수가 있습니다. 형식명 및 노드명은 리더의 작업 부하를 삭감하기 위해서 사용하는 힌트에 지나지 않습니다.

디폴트 구현은 형식명이 지원 되고 있는 것을 확인하고 나서 getImageMetadata(imageIndex) 호출의 결과를 돌려줄 뿐입니다. 지원 되어 있지 않은 경우는 null을 리턴합니다.

파라미터:

imageIndex - 메타데이타의 취득원이미지의 인덱스

formatName - 리턴된 IIOMetadata 객체로부터 문서를 취득하기 위해서 사용하는 메타데이타의 형식명

nodeNames - 취득된 문서에 포함되는 노드명을 보관 유지하는 Set

반환값:

IIOMetadata 객체, 또는 null

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IllegalArgumentException - formatName가 null인 경우

IllegalArgumentException - nodeNames가 null인 경우

IOException - read중에 에러가 발생했을 경우

read

public BufferedImage  read(int imageIndex)
                   throws IOException 

imageIndex에 의해 인덱스를 붙일 수 있었던 이미지를 읽기, 디폴트의 ImageReadParam를 사용해, 완전한 BufferedImage로 서 리턴합니다. 이것은 read(imageIndex, null)를 호출하는 간이 메서드입니다.

리턴된 이미지는 getImageTypes로 부터 리턴된 최초의 ImageTypeSpecifier에 의해 포맷 됩니다.

등록된 IIOReadProgressListener객체는 imageStarted 메서드의 호출에 의해 통지되어 그 후에 읽을 진척과 함께 imageProgress 메서드의 호출이 계속됩니다. 마지막에 imageComplete 메서드가 호출됩니다. IIOReadUpdateListener객체는 read중에 픽셀이 복호화 될 때 갱신됩니다. 마지막으로IIOReadWarningListener객체는 복호화중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

반환값:

BufferedImage로서의 이미지의 필요한 부분

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

read

public abstract BufferedImage  read(int imageIndex,
                                   ImageReadParam  param)
                            throws IOException 

imageIndex에 의해 인덱스를 붙일 수 있었던 이미지를 읽기, 지정된 ImageReadParam를 사용해, 완전한 BufferedImage로 서 리턴합니다.

리턴된 실제의 BufferedImage는 getDestination 메서드에 의해 정의된 알고리즘을 사용해 선택됩니다.

등록된 IIOReadProgressListener객체는 imageStarted 메서드의 호출에 의해 통지되어 그 후에 읽을 진척과 함께 imageProgress 메서드의 호출이 계속됩니다. 마지막에 imageComplete 메서드가 호출됩니다. IIOReadUpdateListener객체는 read중에 픽셀이 복호화 될 때 갱신됩니다. 마지막으로IIOReadWarningListener객체는 복호화중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

읽어내지는 소스 밴드 및 출력해지는 목적지 밴드세트는 지정된 ImageReadParam로 getSourceBands와 getDestinationBands를 호출하는 것에 결정됩니다. 이러한 메서드에 의해 리턴된 배열의 길이가 다른 경우, 소스 밴드세트가 사용 가능한 최대의 소스 인덱스보다 큰 인덱스를 보관 유지하는 경우, 또는 목적지 밴드세트가 유효한 최대의 목적지 인덱스보다 큰 인덱스를 보관 유지하는 경우, IllegalArgumentException가 발생 됩니다.

지정된 ImageReadParam가 이 리더에 의해 지원 되지 않는 옵션의 설정치 (소스의 렌더링 사이즈 또는 임의의 형식별 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

param - read 프로세스의 제어에 사용하는 ImageReadParam, 또는 null

반환값:

BufferedImage로서의 이미지의 필요한 부분

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IllegalArgumentException - param.getSourceBands 및 param.getDestinationBands에 의해 지정된 소스와 목적지 밴드세트의 길이가 다른 경우, 또는 범위외의 인덱스를 포함하고 있는 경우

IllegalArgumentException - 결과의 이미지가 1 보다 작은넓이 또는 높이를 가지는 경우

IOException - read중에 에러가 발생했을 경우

readAll

public IIOImage  readAll(int imageIndex,
                        ImageReadParam  param)
                 throws IOException 

imageIndex에 의해 인덱스를 붙일 수 있었던 이미지를 읽기, 지정된 ImageReadParam를 사용해, 이미지, 썸네일 및 관련된 이미지의 메타데이타를 보관 유지하는 IIOImage를 리턴합니다.

리턴된 IIOImage에 의해 참조되는 BufferedImage는 getDestination 메서드에 의해 정의된 알고리즘을 사용해 선택됩니다.

등록된 IIOReadProgressListener객체는 imageStarted 메서드의 호출에 의해 통지되어 그 후에 읽을 진척과 함께 imageProgress 메서드의 호출이 계속됩니다. 마지막에 imageComplete 메서드가 호출됩니다. IIOReadUpdateListener객체는 read중에 픽셀이 복호화 될 때 갱신됩니다. 마지막으로IIOReadWarningListener객체는 복호화중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

읽어내지는 소스 밴드 및 출력해지는 목적지 밴드세트는 지정된 ImageReadParam로 getSourceBands와 getDestinationBands를 호출하는 것에 결정됩니다. 이러한 메서드에 의해 리턴된 배열의 길이가 다른 경우, 소스 밴드세트가 사용 가능한 최대의 소스 인덱스보다 큰 인덱스를 보관 유지하는 경우, 또는 목적지 밴드세트가 유효한 최대의 목적지 인덱스보다 큰 인덱스를 보관 유지하는 경우, IllegalArgumentException가 발생 됩니다.

영역의 설정에 관계없이, 썸네일의 전체가 리턴됩니다 .

지정된 ImageReadParam가 이 리더에 의해 지원 되지 않는 옵션의 설정치 (소스의 렌더링 사이즈 또는 임의의 형식별 설정등)를 보관 유지하는 경우, 이러한 값은 무시됩니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

param - read 프로세스의 제어에 사용하는 ImageReadParam, 또는 null

반환값:

이미지의 필요한 부분, 썸네일세트 및 관련된 메타데이타를 보관 유지하는 IIOImage

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IllegalArgumentException - param.getSourceBands 및 param.getDestinationBands에 의해 지정된 소스와 목적지 밴드세트의 길이가 다른 경우, 또는 범위외의 인덱스를 포함하고 있는 경우

IllegalArgumentException - 결과의 이미지가 1 보다 작은넓이 또는 높이를 가지는 경우

IOException - read중에 에러가 발생했을 경우

readAll

public Iterator <IIOImage > readAll(Iterator <?  extends ImageReadParam > params)
                           throws IOException 

모든 이미지, 썸네일 및 메타데이타를 보관 유지해, getMinIndex에 의해 지정된 인덱스로 시작되는 Iterator를, IIOImage 객체의 형식에서 입력 소스로부터 리턴합니다. ImageReadParam 객체를 보관 유지하는 Iterator가 제공됩니다. 사용할 수 있는 이미지가 없어질 때까지, 입력 소스로부터 읽어내지는 이미지 마다 1개의 요소가 소비됩니다. read 파라미터의 Iterator가 요소를 다 소비했을 경우로 입력 소스로부터 사용할 수 있는 이미지가 아직 있을 때는 남겨진 이미지에 대해서 디폴트의 read 파라미터가 사용됩니다.

params가 null인 경우, 모든 이미지에 대해서 디폴트의 read 파라미터가 사용됩니다.

리턴된 IIOImage에 의해 참조되는 BufferedImage는 getDestination 메서드에 의해 정의된 알고리즘을 사용해 선택됩니다.

등록된 IIOReadProgressListener객체는 sequenceStarted 메서드의 호출에 의해 한 번 통지됩니다. 그 다음에 복호화 된 각 이미지에 대해서 imageStarted 호출을의해 그 후에 읽을 진척과 함께 imageProgress 이 불려가 마지막에 imageComplete가 호출됩니다. sequenceComplete 메서드는 마지막 이미지가 데코트 된 뒤에 호출합니다. IIOReadUpdateListener객체는 read중에 픽셀이 복호화 될 때 갱신됩니다. 마지막으로IIOReadWarningListener객체는 복호화중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

읽어내지는 소스 밴드 및 출력해지는 목적지 밴드세트는 지정된 ImageReadParam로 getSourceBands와 getDestinationBands를 호출하는 것에 결정됩니다. 이러한 메서드에 의해 리턴된 배열의 길이가 다른 경우, 소스 밴드세트가 사용 가능한 최대의 소스 인덱스보다 큰 인덱스를 보관 유지하는 경우, 또는 목적지 밴드세트가 유효한 최대의 목적지 인덱스보다 큰 인덱스를 보관 유지하는 경우, IllegalArgumentException가 발생 됩니다.

영역의 설정에 관계없이, 썸네일의 전체가 리턴됩니다 .

지정된 ImageReadParam 중 한쪽이, 이 리더에 의해 지원 되지 않는 옵션의 설정치 (소스의 렌더링 사이즈 또는 임의의 서식별 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

파라미터:

params - ImageReadParam 객체를 보관 유지하는 Iterator

반환값:

IIOImage로 서 입력 소스의 내용을 나타내는 Iterator

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IllegalArgumentException - params null 이외의 요소가 ImageReadParam가 아닌 경우

IllegalArgumentException - param.getSourceBands 및 param.getDestinationBands에 의해 지정된 소스와 목적지 밴드세트의 길이가 다른 경우, 또는 범위외의 인덱스를 포함하고 있는 경우

IllegalArgumentException - 결과의 이미지가 1 보다 작은넓이 또는 높이를 가지는 경우

IOException - read중에 에러가 발생했을 경우

관련 항목:

ImageReadParam, IIOImage

canReadRaster

public boolean canReadRaster()

이 플러그 인이 픽셀 데이터 Raster 만의 read를 지원하는인 경우, true를 리턴합니다. 이 메서드가 false를 돌려주는 경우, readRaster 또는 readTileRaster 호출은 UnsupportedOperationException을 Throw 합니다.

디폴트 구현은 false를 리턴합니다.

반환값:

이 플러그 인이 raw Raster read를 지원하는인 경우는 true

관련 항목:

readRaster(int, javax.imageio.ImageReadParam), readTileRaster(int, int, int)

readRaster

public Raster  readRaster(int imageIndex,
                         ImageReadParam  param)
                  throws IOException 

색변환을 적용하지 않고, 이미지 스트림로부터의 픽셀 데이터를 보관 유지하는 새로운 Raster 객체를 리턴합니다. 어플리케이션은 다른 방법으로 픽셀 데이터를 해석하는 방법을 지정합니다. 지정된 ImageReadParam 객체의 목적지 또는 이미지형의 파라미터는 무시됩니다. 다만, 다른 모든 파라미터는 목적지 좌표가 물리 좌표가 아니고 논리 좌표로서 사용되는 경우를 제외해, read 메서드와 같이 정확하게 사용됩니다. 리턴된 Raster 사이즈는 항상 실제의 이미지에 클립 된 소스 영역의 사이즈가 됩니다. 스트림 자체의 논리 좌표는 무시됩니다.

이 메서드는 JPEG 등 보통, 색변환을 적용하는 형식이나, 원격 탐사 또는 료용 이미지 데이터 등 보통, 관련된 컬러 영역를 가지지 않는 형식이 raw 픽셀 데이터에 액세스 할 수 있도록 합니다.

등록된 readUpdateListener는 무시되므로BufferedImage는 없습니다만, 다른 모든 리스너는 read 메서드의 경우와 같이 정확하게 호출합니다.

canReadRaster() 이 false를 돌려주는 경우, 이 메서드는 UnsupportedOperationException을 Throw 합니다.

지정된 ImageReadParam가 이 리더에 의해 지원 되지 않는 옵션의 설정치 (소스의 렌더링 사이즈 또는 임의의 형식별 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

디폴트 구현은 UnsupportedOperationException을 Throw 합니다.

파라미터:

imageIndex - 읽어내지는 이미지의 인덱스

param - read 프로세스의 제어에 사용하는 ImageReadParam, 또는 null

반환값:

Raster로서의 이미지의 필요한 부분

예외:

UnsupportedOperationException - 이 플러그 인이 raw Raster read를 지원 하지 않는 경우

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

관련 항목:

canReadRaster(), read(int), Raster

isImageTiled

public boolean isImageTiled(int imageIndex)
                     throws IOException 

이미지가 타일, 즉 오버랩 하지 않는 동일한 사이즈의 구형에 집어 넣을 수 있는 경우는 true를 리턴합니다.

리더의 플러그 인은 이미지에 존재하는 타일링이 포함되고 있는 대로 표시할지 어떨지를 선택할 수 있습니다. 분명하게 아무것도 존재하지 않는 경우에서도, 타일링의 통지를 선택할 수 있습니다. 일반적으로 개개의 타일에 액세스 할 경우에 어떠한 이점 (속도나 용량등)이 있는 경우에만, 타일링은 통지됩니다. 리더는 타일링을 통지할지 어떨지에 관계없이, ImageReadParam로 지정된 임의의 구형 영역을 읽어낼 수가 있을 필요가 있습니다.

모든 이미지를 타일링 하도록 보증되고 있다, 혹은 타일링 하지 않게 보증되고 있는 리더는 이미지 데이터에 액세스 하지 않고 각각 true 또는 false를 리턴합니다. 이러한 경우, 입력 소스가 설정되어 있지 않은지, 또는 이미지의 인덱스가 범위외에 있는 경우에서도 예외를 Throw 할 필요는 없습니다.

디폴트 구현은 false를 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

이미지가 타일링 되는 경우는 true

예외:

IllegalStateException - 입력 소스가 반환값의 결정이 요구되는 경우로 아무것도 설정되어 있지 않은 경우

IndexOutOfBoundsException - 반환값을 결정하기 위해서 이미지에 액세스 할 필요가 있지만, 지정된 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getTileWidth

public int getTileWidth(int imageIndex)
                 throws IOException 

지정된 이미지의 타일의 넓이를 리턴합니다.

디폴트 구현은 단지 타일링 되지 않는 이미지에 대해서 올바른 getWidth(imageIndex)를 리턴합니다. 타일링을 지원하는 리더는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

타일의 폭

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getTileHeight

public int getTileHeight(int imageIndex)
                  throws IOException 

지정된 이미지의 타일의 높이를 리턴합니다.

디폴트 구현은 단지 타일링 되지 않는 이미지에 대해서 올바른 getHeight(imageIndex)를 리턴합니다. 타일링을 지원하는 리더는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

타일의 높이

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getTileGridXOffset

public int getTileGridXOffset(int imageIndex)
                       throws IOException 

지정된 이미지의 타일 (0, 0)의 좌상구석의 X 좌표를 리턴합니다.

타일 구라두의 X 좌표가 항상 같은 값 (일반적으로 0)을 가지는 리더는 이미지 데이터에 액세스 하지 않고 값을 리턴합니다. 이러한 경우, 입력 소스가 설정되어 있지 않은지, 혹은 이미지의 인덱스가 범위외에 있을 때에도, 예외를 Throw 할 필요는 없습니다.

디폴트 구현은 타일링 되지 않는 이미지와 대부분의 형식의 타일링 된 이미지에 대해서 올바른 값 0을 돌려줄 뿐입니다. (0, 0) 이외의 좌표를 가지는 타일링을 지원하는 리더는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

타일 구라두의 X 좌표

예외:

IllegalStateException - 입력 소스가 반환값의 결정이 요구되는 경우로 아무것도 설정되어 있지 않은 경우

IndexOutOfBoundsException - 반환값을 결정하기 위해서 이미지에 액세스 할 필요가 있지만, 지정된 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getTileGridYOffset

public int getTileGridYOffset(int imageIndex)
                       throws IOException 

지정된 이미지의 타일 (0, 0)의 좌상구석의 Y 좌표를 리턴합니다.

타일 구라두의 Y 좌표가 항상 같은 값 (일반적으로 0)을 가지는 리더는 이미지 데이터에 액세스 하지 않고 값을 리턴합니다. 이러한 경우, 입력 소스가 설정되어 있지 않은지, 또는 이미지의 인덱스가 범위외에 있는 경우에서도, 예외를 Throw 할 필요는 없습니다.

디폴트 구현은 타일링 되지 않는 이미지와 대부분의 형식의 타일링 된 이미지에 대해서 올바른 값 0을 돌려줄 뿐입니다. (0, 0) 이외의 좌표를 가지는 타일링을 지원하는 리더는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

타일 구라두의 Y 좌표

예외:

IllegalStateException - 입력 소스가 반환값의 결정이 요구되는 경우로 아무것도 설정되어 있지 않은 경우

IndexOutOfBoundsException - 반환값을 결정하기 위해서 이미지에 액세스 할 필요가 있지만, 지정된 인덱스가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

readTile

public BufferedImage  readTile(int imageIndex,
                              int tileX,
                              int tileY)
                       throws IOException 

tileX 및 tileY인수에 의해 지정되어BufferedImage로 서 리턴된 타일을 읽어들입니다. 인수가 영역외에 있는 경우, IllegalArgumentException가 발생 됩니다. 이미지가 타일링 되지 않는 경우, 값 0, 0 은 이미지 전체를 리턴합니다. 그 외의 값은 IllegalArgumentException을 Throw 시킵니다.

이 메서드는 단지 읽기 파라미터를 사용해 read(int, ImageReadParam)를 읽어내는 경우와 동등의 간이 메서드입니다. 이 read 파라미터는 tileX*getTileWidth(imageIndex), tileY*getTileHeight(imageIndex) 좌표 및 getTileWidth(imageIndex), getTileHeight(imageIndex) 폭과 높이를 가지는 소스 영역을 지정해, 서브 샘플링 계수 1 및 좌표 0을 지정합니다. 타일을 솎아냄 하려면, 이 영역과 다른 서브 샘플링 파라미터를 지정하는 read 파라미터를 사용해, read를 호출합니다.

디폴트 구현은, tileX 및 tileY가 0인 경우, 이미지 전체를 돌려주고, 0 이외의 경우는 IllegalArgumentException을 Throw 합니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

tileX - 취득되는 타일의 0 으로 시작되는 열의 인덱스

tileY - 취득되는 타일의 0 으로 시작되는 행의 인덱스

반환값:

BufferedImage로서의 타일

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - imageIndex가 범위외에 있는 경우

IllegalArgumentException - 타일의 인덱스가 범위외의 경우

IOException - read중에 에러가 발생했을 경우

readTileRaster

public Raster  readTileRaster(int imageIndex,
                             int tileX,
                             int tileY)
                      throws IOException 

색변환을 적용하지 않고, 타일로부터의 raw 픽셀 데이터를 보관 유지하는 새로운 Raster 객체를 리턴합니다. 어플리케이션은 다른 방법으로 픽셀 데이터를 해석하는 방법을 지정합니다.

canReadRaster() 이 false를 돌려주는 경우, 이 메서드는 UnsupportedOperationException을 Throw 합니다.

디폴트 구현은, Raster read를 지원 하고 있을지 어떨지를 확인합니다. 지원 하고 있는 경우는 tileX 및 tileY가 0인 경우, readRaster(imageIndex, null)를 호출합니다. 0 이외의 경우는 IllegalArgumentException을 Throw 합니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

tileX - 취득되는 타일의 0 으로 시작되는 열의 인덱스

tileY - 취득되는 타일의 0 으로 시작되는 행의 인덱스

반환값:

Raster로서의 타일

예외:

UnsupportedOperationException - 이 플러그 인이 raw Raster read를 지원 하지 않는 경우

IllegalArgumentException - 타일의 인덱스가 범위외의 경우

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - imageIndex가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

관련 항목:

readTile(int, int, int), readRaster(int, javax.imageio.ImageReadParam), Raster

readAsRenderedImage

public RenderedImage  readAsRenderedImage(int imageIndex,
                                         ImageReadParam  param)
                                  throws IOException 

imageIndex에 의해 인덱스를 붙일 수 있었던 이미지의 내용을 보관 유지하는 RenderedImage 객체를 리턴합니다. 디폴트에서는 리턴된 이미지는 단순하게 read(imageIndex, param)에 의해 리턴된 BufferedImage 입니다.

이 메서드의 시멘틱스는 다른 read 메서드의 시멘틱스 물어 구두인가의 점으로써 다릅니다. 제일에 ImageReadParam로 설정되는 임의의 목적지 이미지 또는 이미지형 및 그 양쪽 모두는 무시됩니다. 2번째로 보통 의 리스너의 호출은 그것들이 실행되어 그대로의 의미가 있는 것을 보증하지 않습니다. 이것은 리턴된 이미지가 돌려주고졌을 때, 혹은 실제로는 임의의 시점에서 픽셀 데이터에 의해 완전하게는 생성되지 않기 때문입니다.

지정된 ImageReadParam가 이 리더에 의해 지원 되지 않는 옵션의 설정치 (소스의 렌더링 사이즈 또는 임의의 형식별 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

디폴트 구현은 read(imageIndex, param)를 호출할 뿐입니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

param - read 프로세스의 제어에 사용하는 ImageReadParam, 또는 null

반환값:

이미지의 뷰를 제공하는 RenderedImage 객체

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정한 인덱스가 범위외에 있는 경우

IllegalArgumentException - param.getSourceBands 및 param.getDestinationBands에 의해 지정된 소스와 목적지 밴드세트의 길이가 다른 경우, 또는 범위외의 인덱스를 포함하고 있는 경우

IllegalArgumentException - 결과의 이미지가 1 보다 작은넓이 또는 높이를 가지는 경우

IOException - read중에 에러가 발생했을 경우

readerSupportsThumbnails

public boolean readerSupportsThumbnails()

이 리더에 의해 이해되는 이미지 형식이, 거기에 관련된 썸네일 프리뷰 이미지를 지원하는인 경우, true를 리턴합니다. 디폴트 구현은 false를 리턴합니다.

이 메서드가 false를 돌려주는 경우, hasThumbnails와 getNumThumbnails는 각각 false와 0을 리턴합니다. 또, readThumbnail는 당기는 수에 관계없이 UnsupportedOperationException을 리턴합니다.

썸네일를 지원 하지 않는 리더는 썸네일에게 관련된 메서드를 구현할 필요가 없습니다.

반환값:

썸네일가 지원 되는 경우는 true

hasThumbnails

public boolean hasThumbnails(int imageIndex)
                      throws IOException 

지정된 이미지가 거기에 관련된 썸네일 프리뷰 이미지를 가지는 경우, true를 리턴합니다. 형식이 썸네일를 지원 하지 않는 경우, 즉 readerSupportsThumbnails가 false를 돌려주는 경우, 입력 소스가 설정되어 있는지 어떤지, 또는 imageIndex가 경계내에 있을지 어떨지에 관계없이 false를 리턴합니다.

getNumThumbnails가 0 보다 큰 값을 돌려주는 경우, 디폴트 구현은. true.를 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

지정된 이미지가 썸네일의 경우는 true

예외:

IllegalStateException - 리더가 썸네일를 지원 하지만, 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 리더가 썸네일를 지원 하지만, imageIndex가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getNumThumbnails

public int getNumThumbnails(int imageIndex)
                     throws IOException 

지정된 이미지에 관련된 썸네일 프리뷰 이미지의 수를 리턴합니다. 형식이 썸네일를 지원 하지 않는 경우, 즉 readerSupportsThumbnails가 false를 돌려주는 경우, 입력 소스가 설정되어 있는지 어떤지, 또는 imageIndex가 경계내에 있을지 어떨지에 관계없이 0을 리턴합니다.

디폴트 구현은 그 인수를 확인하는 일 없이, 0을 리턴합니다.

파라미터:

imageIndex - 조회되는 이미지의 인덱스

반환값:

지정된 이미지에 관련된 썸네일의 수

예외:

IllegalStateException - 리더가 썸네일를 지원 하지만, 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 리더가 썸네일를 지원 하지만, imageIndex가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getThumbnailWidth

public int getThumbnailWidth(int imageIndex,
                             int thumbnailIndex)
                      throws IOException 

thumbnailIndex에 의해 인덱스를 붙일 수 있었던 썸네일 프리뷰 이미지의 넓이를 리턴합니다. 이 이미지는 ImageIndex에 의해 인덱스를 붙일 수 있었던 이미지에 관련지을 수 있고 있습니다.

리더가 썸네일를 지원 하지 않는 경우, 즉 readerSupportsThumbnails가 false를 돌려주는 경우, UnsupportedOperationException을 Throw 합니다.

디폴트 구현은 단지 readThumbnail(imageindex, thumbnailIndex). getWidth()를 리턴합니다. 따라서, 서브 클래스는 썸네일를 읽어내지 않게 하기 위해서 가능한 경우는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

thumbnailIndex - 취득되는 썸네일의 인덱스

반환값:

int로 서 바람직한 썸네일의 폭

예외:

UnsupportedOperationException - 썸네일가 지원 되지 않는 경우

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정된 인덱스의 어떤 것인가가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

getThumbnailHeight

public int getThumbnailHeight(int imageIndex,
                              int thumbnailIndex)
                       throws IOException 

thumbnailIndex에 의해 인덱스를 붙일 수 있었던 썸네일 프리뷰 이미지의 높이를 리턴합니다. 이 이미지는 ImageIndex에 의해 인덱스를 붙일 수 있었던 이미지에 관련지을 수 있고 있습니다.

리더가 썸네일를 지원 하지 않는 경우, 즉 readerSupportsThumbnails가 false를 돌려주는 경우, UnsupportedOperationException을 Throw 합니다.

디폴트 구현은, readThumbnail(imageindex, thumbnailIndex). getHeight()를 돌려줄 뿐입니다. 따라서, 서브 클래스는 썸네일를 읽어내지 않게 하기 위해서 가능한 경우는 이 메서드를 오버라이드(override) 할 필요가 있습니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

thumbnailIndex - 취득되는 썸네일의 인덱스

반환값:

int로 서 바람직한 썸네일의 높이

예외:

UnsupportedOperationException - 썸네일가 지원 되지 않는 경우

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정된 인덱스의 어떤 것인가가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

readThumbnail

public BufferedImage  readThumbnail(int imageIndex,
                                   int thumbnailIndex)
                            throws IOException 

thumbnailIndex에 의해 인덱스를 붙일 수 있었던 썸네일 프리뷰 이미지를 리턴합니다. 이 이미지는 BufferedImage로 서 ImageIndex에 의해 인덱스를 붙일 수 있었던 이미지에 관련지을 수 있고 있습니다.

등록된 IIOReadProgressListener객체는 thumbnailStarted, thumbnailProgress 및 thumbnailComplete 메서드를 호출하는 것으로 통지됩니다.

리더가 썸네일를 지원 하지 않는 경우, 즉 readerSupportsThumbnails가 false를 돌려줄 때, 입력 소스가 설정되어 있는지 어떤지, 또는 인덱스가 경계내에 있을지 어떨지에 관계없이 UnsupportedOperationException을 Throw 합니다.

디폴트 구현은 UnsupportedOperationException을 Throw 합니다.

파라미터:

imageIndex - 취득되는 이미지의 인덱스

thumbnailIndex - 취득되는 썸네일의 인덱스

반환값:

BufferedImage로서의 목적의 썸네일

예외:

UnsupportedOperationException - 썸네일가 지원 되지 않는 경우

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 지정된 인덱스의 어떤 것인가가 범위외에 있는 경우

IOException - read중에 에러가 발생했을 경우

abort

public void abort()

현재의 read 오퍼레이션의 중단을 요구합니다. 중단 후의 이미지의 내용은 정의되지 않습니다.

리더는 각 read 오퍼레이션의 개시시에 clearAbortRequest를 호출해, read중에 abortRequested값을 정기적으로 폴링 할 필요가 있습니다.

abortRequested

protected boolean abortRequested()

현재의 read 오퍼레이션을 중단하는 요구를 했을 경우, 리더가 인스턴스화 되는지, 또는 clearAbortRequest이 불려가기 때문에 true를 리턴합니다.

반환값:

현재의 read 오퍼레이션을 중단할 필요가 있는 경우는 true

관련 항목:

abort(), clearAbortRequest()

clearAbortRequest

protected void clearAbortRequest()

이전의 중단 요구를 클리어 합니다. 이 메서드가 불려가 면, abortRequested는 false를 리턴합니다.

관련 항목:

abort(), abortRequested()

addIIOReadWarningListener

public void addIIOReadWarningListener(IIOReadWarningListener  listener)

IIOReadWarningListener를 등록된 경고 리스너의 리스트에 추가합니다. listener가 null인 경우, 예외가 발생되지 않고 액션은 아무것도 행해지지 않습니다. 지정된 리스너에게 송신되는 메세지는 현재의 Locale에 조합되어 지역 대응됩니다 (가능한 경우). Locale가 설정되어 있지 않은 경우는 경고 메세지는 리더가 적절이라고 보는 대로 지역 대응됩니다.

파라미터:

listener - 등록되는 IIOReadWarningListener

관련 항목:

removeIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)

removeIIOReadWarningListener

public void removeIIOReadWarningListener(IIOReadWarningListener  listener)

등록된 에러 리스너의 리스트로부터, IIOReadWarningListener를 삭제합니다. 이전에 리스너가 등록되지 않은 경우, 또는 listener가 null인 경우, 예외가 발생되지 않고 아무것도 액션은 행해지지 않습니다.

파라미터:

listener - 등록 해제되는 IIOReadWarningListener

관련 항목:

addIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)

removeAllIIOReadWarningListeners

public void removeAllIIOReadWarningListeners()

현재 등록되어 모든 IIOReadWarningListener 객체를 삭제합니다.

디폴트 구현은 warningListeners와 warningLocales인스턴스의 변수를 null로 설정합니다.

addIIOReadProgressListener

public void addIIOReadProgressListener(IIOReadProgressListener  listener)

IIOReadProgressListener를 등록된 진척 리스너의 리스트에 추가합니다. listener가 null인 경우, 예외가 발생되지 않고 액션은 아무것도 행해지지 않습니다.

파라미터:

listener - 등록되는 IIOReadProgressListener

관련 항목:

removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

removeIIOReadProgressListener

public void removeIIOReadProgressListener(IIOReadProgressListener  listener)

등록된 진척 리스너의 리스트로부터, IIOReadProgressListener를 삭제합니다. 이전에 리스너가 등록되지 않은 경우, 또는 listener가 null인 경우, 예외가 발생되지 않고 액션은 아무것도 행해지지 않습니다.

파라미터:

listener - 등록 해제되는 IIOReadProgressListener

관련 항목:

addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

removeAllIIOReadProgressListeners

public void removeAllIIOReadProgressListeners()

현재 등록되어 모든 IIOReadProgressListener 객체를 삭제합니다.

디폴트 구현은 progressListeners인스턴스의 변수를 null로 설정합니다.

addIIOReadUpdateListener

public void addIIOReadUpdateListener(IIOReadUpdateListener  listener)

IIOReadUpdateListener를, 등록된 갱신 리스너의 리스트에 추가합니다. listener가 null인 경우, 예외가 발생되지 않고 액션은 아무것도 행해지지 않습니다. 리스너는 이미지와 썸네일가 복호화 될 때, 단계적으로 진행하는 패스의 개시와 종료를 포함한 픽셀 데이터 갱신의 통지를 받습니다.

갱신 리스너가 존재하지 않는 경우, 리더는 목적지 이미지 또는 썸네일, 혹은 그 양쪽 모두의 픽셀의 갱신을 보다 적게 실행하도록 선택할 수 있습니다. 이것에 의해 복호화가 보다 효율적에 행해지게 됩니다.

예를 들어 프로그래시브 JPEG 디코딩에서는 각 패스에 일련의 계수의 갱신이 포함됩니다. 리스너가 존재하는 경우, 이러한 계수는 픽셀치에 변환되어 각 패스의 RGB 컬러 영역에 변환될 필요가 있습니다. 리스너가 존재하지 않는 경우, 계수는 단순하게 누적되어 최종 결과의 변환과 색의 변환이 한 번만 행해집니다.

복호화의 최종 결과는 중간 갱신이 실행되고 있는지 어떤지에 관계없이 같습니다. 따라서, 최종 이미지만이 필요한 경우는 IIOReadUpdateListener를 등록하지 않는 편이 바람직한 결과를 얻을 수 있습니다. 일반적으로는 로컬 CPU 처리에 비해 매우 늦은 네트워크 접속을 개입시켜 이미지를 얻는인 경우는 단계적으로 진행하는 갱신이 가장 효율적입니다. 고속 접속에 한 경우는 단계적으로 진행하는 갱신에 의해 실제로 이미지의 표시는 늦어집니다.

파라미터:

listener - 등록되는 IIOReadUpdateListener

관련 항목:

removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

removeIIOReadUpdateListener

public void removeIIOReadUpdateListener(IIOReadUpdateListener  listener)

등록된 갱신 리스너의 리스트로부터, IIOReadUpdateListener를 삭제합니다. 이전에 리스너가 등록되지 않은 경우, 또는 listener가 null인 경우, 예외가 발생되지 않고 아무것도 액션은 행해지지 않습니다.

파라미터:

listener - 등록 해제되는 IIOReadUpdateListener

관련 항목:

addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

removeAllIIOReadUpdateListeners

public void removeAllIIOReadUpdateListeners()

현재 등록되어 모든 IIOReadUpdateListener 객체를 삭제합니다.

디폴트 구현은 updateListeners인스턴스의 변수를 null로 설정합니다.

processSequenceStarted

protected void processSequenceStarted(int minIndex)

sequenceStarted 메서드의 호출에의해 이미지 읽을 순서의 개시를, 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

minIndex - 읽어내진 최소의 인덱스

processSequenceComplete

protected void processSequenceComplete()

sequenceComplete 메서드의 호출에의해 이미지 읽을 순서의 완료를, 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

processImageStarted

protected void processImageStarted(int imageIndex)

imageStarted 메서드의 호출에의해 이미지 읽을 개시를, 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

imageIndex - 읽어내지는 이미지의 인덱스

processImageProgress

protected void processImageProgress(float percentageDone)

imageProgress 메서드의 호출에의해 이미지 완성의 현재의 비율을 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

percentageDone - float로서의 현재의 완성한 비율

processImageComplete

protected void processImageComplete()

imageComplete 메서드의 호출에의해 이미지 읽을 완료를, 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

processThumbnailStarted

protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)

thumbnailStarted 메서드의 호출에의해 썸네일 읽을 개시를, 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

imageIndex - 썸네일가 관련된 이미지의 인덱스

thumbnailIndex - 썸네일의 인덱스

processThumbnailProgress

protected void processThumbnailProgress(float percentageDone)

thumbnailProgress 메서드의 호출에의해 썸네일 완성의 현재의 비율을 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

percentageDone - float로서의 현재의 완성한 비율

processThumbnailComplete

protected void processThumbnailComplete()

thumbnailComplete 메서드의 호출에의해 썸네일 읽을 완료를, 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

processReadAborted

protected void processReadAborted()

readAborted 메서드의 호출에의해 read가 중단된 것을 등록된 모든 IIOReadProgressListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

processPassStarted

protected void processPassStarted(BufferedImage  theImage,
                                  int pass,
                                  int minPass,
                                  int maxPass,
                                  int minX,
                                  int minY,
                                  int periodX,
                                  int periodY,
                                  int[] bands)

passStarted 메서드의 호출에의해 프로그래시브 패스의 개시를, 등록된 모든 IIOReadUpdateListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

theImage - 갱신된 BufferedImage

pass - 0 으로부터 시작되는 현재의 패스의 인덱스

minPass - 복호화 되는 최초의 패스의 인덱스

maxPass - 복호화 되는 마지막 패스의 인덱스

minX - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

minY - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

periodX - 픽셀간의 수평 방향의 단락

periodY - 픽셀간의 수직 방향의 단락

bands - 영향을 받는 목적지 밴드세트를 나타내는 int 배열

processImageUpdate

protected void processImageUpdate(BufferedImage  theImage,
                                  int minX,
                                  int minY,
                                  int width,
                                  int height,
                                  int periodX,
                                  int periodY,
                                  int[] bands)

imageUpdate 메서드의 호출에의해 샘플세트의 갱신을 등록된 모든 IIOReadUpdateListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

theImage - 갱신된 BufferedImage

minX - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

minY - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

width - periodX > 1인 경우에 스킵 된 픽셀을 포함한, 갱신된 영역의 폭의 합계

height - periodY > 1인 경우에 스킵 된 픽셀을 포함한, 갱신된 영역의 높이의 합계

periodX - 픽셀간의 수평 방향의 단락

periodY - 픽셀간의 수직 방향의 단락

bands - 영향을 받는 목적지 밴드세트를 나타내는 int 배열

processPassComplete

protected void processPassComplete(BufferedImage  theImage)

passComplete 메서드의 호출에의해 프로그래시브 패스의 종료를, 등록된 모든 IIOReadUpdateListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

theImage - 갱신된 BufferedImage

processThumbnailPassStarted

protected void processThumbnailPassStarted(BufferedImage  theThumbnail,
                                           int pass,
                                           int minPass,
                                           int maxPass,
                                           int minX,
                                           int minY,
                                           int periodX,
                                           int periodY,
                                           int[] bands)

thumbnailPassStarted 메서드의 호출에의해 썸네일의 프로그래시브 패스의 개시를, 등록된 모든 IIOReadUpdateListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

theThumbnail - 갱신된 썸네일의 BufferedImage

pass - 0 으로부터 시작되는 현재의 패스의 인덱스

minPass - 복호화 되는 최초의 패스의 인덱스

maxPass - 복호화 되는 마지막 패스의 인덱스

minX - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

minY - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

periodX - 픽셀간의 수평 방향의 단락

periodY - 픽셀간의 수직 방향의 단락

bands - 영향을 받는 목적지 밴드세트를 나타내는 int 배열

processThumbnailUpdate

protected void processThumbnailUpdate(BufferedImage  theThumbnail,
                                      int minX,
                                      int minY,
                                      int width,
                                      int height,
                                      int periodX,
                                      int periodY,
                                      int[] bands)

thumbnailUpdate 메서드의 호출에의해 썸네일 이미지의 샘플세트의 갱신을 등록된 모든 IIOReadUpdateListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

theThumbnail - 갱신된 썸네일의 BufferedImage

minX - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

minY - 패스에 포함되는 좌상구석의 픽셀의 X 좌표

width - periodX > 1인 경우에 스킵 된 픽셀을 포함한, 갱신된 영역의 폭의 합계

height - periodY > 1인 경우에 스킵 된 픽셀을 포함한, 갱신된 영역의 높이의 합계

periodX - 픽셀간의 수평 방향의 단락

periodY - 픽셀간의 수직 방향의 단락

bands - 영향을 받는 목적지 밴드세트를 나타내는 int 배열

processThumbnailPassComplete

protected void processThumbnailPassComplete(BufferedImage  theThumbnail)

thumbnailPassComplete 메서드의 호출에의해 썸네일의 프로그래시브 패스의 종료를, 등록된 모든 IIOReadUpdateListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

theThumbnail - 갱신된 썸네일의 BufferedImage

processWarningOccurred

protected void processWarningOccurred(String  warning)

warningOccurred 메서드의 호출에의해 경고 메세지를, 등록된 모든 IIOReadWarningListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

warning - 송신하는 경고 메세지

예외:

IllegalArgumentException - warning가 null인 경우

processWarningOccurred

protected void processWarningOccurred(String  baseName,
                                      String  keyword)

ResourceBundle로 부터 취득한 캐릭터 라인을 가지는 warningOccurred 메서드의 호출에의해 지역 대응된 경고 메세지를, 등록된 모든 IIOReadWarningListener에 통지합니다. 서브 클래스는 이 메서드를 간이 메서드로서 사용합니다.

파라미터:

baseName - 지역 대응된 경고 메세지를 포함한 ResourceBundle 세트의 베이스명

keyword - ResourceBundle 내의 경고 메세지에 인덱스를 붙이기 위해서 사용되는 키워드

예외:

IllegalArgumentException - baseName가 null인 경우

IllegalArgumentException - keyword가 null인 경우

IllegalArgumentException - 적절한 ResourceBundle가 배치되지 않는 경우

IllegalArgumentException - 이름 첨부의 자원이 배치된 ResourceBundle로 검출되지 않는 경우

IllegalArgumentException - ResourceBundle로 부터 취득한 객체가 String가 아닌 경우

reset

public void reset()

ImageReader를 초기 상태에 복원합니다.

디폴트 구현은, setInput(null, false), setLocale(null), removeAllIIOReadUpdateListeners(), removeAllIIOReadWarningListeners(), removeAllIIOReadProgressListeners() 및 clearAbortRequest를 호출합니다.

dispose

public void dispose()

이 객체가 보관 유지하는 모든 자원을 해방할 수 있도록 합니다. 이 메서드의 호출의 후에 계속되는 finalize 이외의 다른 메서드의 호출의 결과는 미정도리입니다.

어플리케이션은, ImageReader가 불필요하게 된 시점에서 이 메서드를 호출하는 것이 중요합니다. 그렇게 하지 않으면 리더는 자원상에 무기한으로 계속 잔존할 가능성이 있습니다.

이 메서드의 디폴트의 구현은 슈퍼 클래스에서는 아무것도 실행하지 않습니다. 서브 클래스의 구현으로 모든 자원, 특히 네이티브 자원이 해방된 것을 확인해 주세요.

getSourceRegion

protected static Rectangle  getSourceRegion(ImageReadParam  param,
                                           int srcWidth,
                                           int srcHeight)

지정된 ImageReadParam 소스 영역과 서브 샘플링의 좌표의 설정을 고려해, 리더가 읽어내는 소스 이미지의 영역을 계산하기 위해서 사용하는 유틸리티 메서드입니다. 실제의 서브 샘플링 계수, 목적지의 사이즈 및 목적지의 좌표는 고려되지 않습니다. 이 때문에 또한 클리핑이 필요하게 됩니다. computeRegions 메서드는 필요한 모든 클리핑을 실행합니다.

파라미터:

param - 사용된 ImageReadParam, 또는 null

srcWidth - 소스 이미지의 폭

srcHeight - 소스 이미지의 높이

반환값:

Rectangle로서의 소스 영역

computeRegions

protected static void computeRegions(ImageReadParam  param,
                                     int srcWidth,
                                     int srcHeight,
                                     BufferedImage  image,
                                     Rectangle  srcRegion,
                                     Rectangle  destRegion)

소스 이미지의 폭과 높이, 옵션의 목적지 이미지 및 옵션의 ImageReadParam를 고려해, 대상의 소스 영역 및 대상의 목적지 영역을 계산합니다. 소스 영역은 전체의 소스 이미지로부터 개시됩니다. 그 다음에 ImageReadParam로 지정된 소스 영역 (가리키는 경우)에 클립 됩니다.

목적지 좌표의 어떤 것인가가 부의 경우, 소스 영역은 서브 샘플링을 고려해, 좌상이 목적지 이미지의 좌상에 일치하도록 클립 됩니다. 그 다음에 그 결과가 서브 샘플링 및 목적지 좌표를 고려해, 오른쪽 및 아래의 목적지 이미지 (가리키는 경우)에 클립 됩니다.

똑같이, 목적지 영역이 소스 이미지로부터 시작되어 ImageReadParam로 지정된 목적지 좌표 (존재하는 경우)에 변환되어 마지막에 목적지 이미지 (존재하는 경우)에 클립 됩니다.

소스 또는 목적지 영역의 어떤 것인가가넓이 또는 높이 0 으로 끝나는 경우, IllegalArgumentException가 발생 됩니다.

소스의 클리핑만이 필요한 경우는 getSourceRegion 메서드를 사용합니다.

파라미터:

param - ImageReadParam 또는 null

srcWidth - 소스 이미지의 폭

srcHeight - 소스 이미지의 높이

image - 목적지 이미지가 되는 BufferedImage, 또는 null

srcRegion - 대상의 소스 영역이 삽입되는 Rectangle

destRegion - 대상의 목적지 영역이 삽입되는 Rectangle

예외:

IllegalArgumentException - srcRegion가 null인 경우

IllegalArgumentException - dstRegion가 null인 경우

IllegalArgumentException - 결과의 소스 또는 목적지가 비어있는 경우

checkReadParamBandSettings

protected static void checkReadParamBandSettings(ImageReadParam  param,
                                                 int numSrcBands,
                                                 int numDstBands)

ImageReadParam 소스와 목적지 밴드의 설정의 유효성을 판정하기 위해서 리더가 사용하는 유틸리티 메서드입니다. 이 메서드는 입력 스트림에 존재하는 소스 이미지의 밴드수로 출력해진 목적지 이미지의 밴드수의 양쪽 모두를, 리더가 알자마자 호출합니다.

메서드는 getSourceBands와 getDestinationBands 메서드를 사용해, param 로부터 소스 및 목적지 밴드의 설정의 배열을 꺼냅니다. param가 null인 경우는 이것들은 null 라고 봅니다. 소스 밴드의 설정의 배열이 null인 경우, 배열 { 0, 1, ..., numSrcBands - 1 } 으로 동등이라고 봅니다. 목적지 밴드의 설정의 배열의 경우도 같습니다.

다음에 메서드는 양쪽 모두의 배열이 길이가 동일하고, 어느 배열과도 유효한 밴드의 최대의 인덱스보다 큰 값을 가지고 있지 않은 것을 판정합니다.

실패하면, IllegalArgumentException가 Throw 되어 성공하면 그대로 메서드가 리턴됩니다 .

파라미터:

param - 이미지의 read에 사용된 ImageReadParam

numSrcBands - 입력 소스에 존재하는 int 이미지의 밴드의 수

numDstBands - 출력해진 목적지 이미지의 밴드의 수

예외:

IllegalArgumentException - param가 소스 또는 목적지 밴드의 부분집합, 혹은 그 양쪽 모두의 무효인 사양을 가지는 경우

getDestination

protected static BufferedImage  getDestination(ImageReadParam  param,
                                              Iterator <ImageTypeSpecifier > imageTypes,
                                              int width,
                                              int height)
                                       throws IIOException 

복호화 된 픽셀 데이터가 출력해지는 BufferedImage를 리턴합니다. 이미지는 null 이외의 경우, 지정된 ImageReadParam를 확인하는 것으로써 판정됩니다. getDestination 메서드가 null 이외의 값을 돌려주는 경우는 단지 그 이미지가 리턴됩니다 . 그 외의 경우는 param.getDestinationType 메서드가 불려가, 특정의 이미지의 형태가 가리키는지를 확인합니다. 그 경우에는 imageTypes에 포함되는 것의 1개과 같은 것을 확인하고 나서, 리턴된 ImageTypeSpecifier가 사용됩니다.

param가 null, 또는 전술의 순서가 이미지, 혹은 ImageTypeSpecifier를 발생시키지 않는 경우, imageTypes 파라미터로부터 취득된 최초의 값이 사용됩니다. 보통, 호출측이 imageTypes를 getImageTypes(imageIndex)값으로 설정합니다.

다음에 이미지의 크기가 computeRegions 호출에 결정됩니다. 복호화 된 이미지의 실제의 폭과 높이가width 및 height 파라미터로서 건네받습니다.

파라미터:

param - 목적지 이미지 또는 이미지형을 취득하기 위해서 사용하는 ImageReadParam, 또는 null

imageTypes - 디폴트를 최초로 해, 정당한 이미지형을 나타내는 ImageTypeSpecifier Iterator

width - 복호화가 요구되는 이미지 또는 타일의 진정한 폭

height - 복호화가 요구되는 이미지 또는 타일의 진정한 폭

반환값:

복호화 된 픽셀 데이터가 출력해지는 BufferedImage

예외:

IIOException - param에 의해 지정된 ImageTypeSpecifier가 imageTypes로 부터의 정당한 형태와 일치하지 않는 경우

IllegalArgumentException - imageTypes가 null 또는 비어있는 경우, 또는 ImageTypeSpecifier가 지정하는 형태가 아닌 객체를 꺼냈을 경우

IllegalArgumentException - 결과의 이미지가 1 보다 작은넓이 또는 높이를 가지는 경우

IllegalArgumentException - width와 height 적이 Integer.MAX_VALUE 보다 큰 경우