javax.imageio
클래스 ImageReader

java.lang.Object 
  |
  +--javax.imageio.ImageReader

public abstract class ImageReader

extends Object

이미지를 해석해 복호화(decode) 하는 추상 슈퍼 클래스입니다. 이 클래스는 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	progressListeners 현재 등록되어 있는 각 IIOReadProgressListener 의 List 입니다.
protected boolean	seekForwardOnly 현재의 입력 소스가,setInput 에 의한 순서 방향 검색만이 가능해지도록(듯이) 지정되고 있는 경우는 true 입니다.
protected List	updateListeners 현재 등록되어 있는 각 IIOReadUpdateListener 의 List 입니다.
protected List	warningListeners 현재 등록되어 있는 IIOReadWarningListener 의 List 입니다.
protected List	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 를 고려해, 대상의 소스 area 및 대상의 목적지 area를 계산합니다.
void	dispose () 이 오브젝트가 보관 유지하는 모든 리소스를 해방할 수 있게 합니다.
float	getAspectRatio (int imageIndex) 지정된 이미지의 종횡비 (즉, 폭을 높이로 나눈 값)를 float 로 돌려줍니다.
Locale []	getAvailableLocales () 경고 청취자와 압축 설정의 지역 대응화를 위해서(때문에) 사용하는 Locale 의 배열을 돌려줍니다.
ImageReadParam	getDefaultReadParam () 이 형식에 대해서 적절한 디폴트의 ImageReadParam 오브젝트를 돌려줍니다.
protected static BufferedImage	getDestination (ImageReadParam param, Iterator imageTypes, int width, int height) 복호화(decode) 된 픽셀 데이터가 기입해지는 BufferedImage 를 돌려줍니다.
String	getFormatName () 입력 소스의 형식을 식별하는 String 를 돌려줍니다.
abstract int	getHeight (int imageIndex) 입력 소스의 지정된 이미지의 높이를 픽셀 단위로 돌려줍니다.
abstract IIOMetadata	getImageMetadata (int imageIndex) 지정된 이미지에 관련지을 수 있었던 메타데이타를 보관 유지하는 IIOMetadata 오브젝트를 돌려줍니다.
IIOMetadata	getImageMetadata (int imageIndex, String formatName, Set nodeNames) 지정된 이미지에 관련지을 수 있었던 메타데이타를 나타내는 IIOMetadata 오브젝트를 돌려줍니다.
abstract Iterator	getImageTypes (int imageIndex) ImageTypeSpecifiers 의 형식에서 지정된 이미지가 복호화(decode) 되는 이미지형을 포함한 Iterator 를 돌려줍니다.
Object	getInput () ImageReaderSpi 또는 이전에 입력 소스로서 설정된 다른 Object 를 돌려줍니다.
Locale	getLocale () 현재 설정되어 있는 Locale, 아무것도 설정되어 있지 않은 경우는 null 를 돌려줍니다.
int	getMinIndex () 이미지 샘 네루, 또는 이메이지메타데이타의 read에 대해서 유효한, 최소의 인덱스를 돌려줍니다.
abstract int	getNumImages (boolean allowSearch) 현재의 입력 소스로부터, 샘 네루를 제외한 사용 가능한 이미지의 수를 돌려줍니다.
int	getNumThumbnails (int imageIndex) 지정된 이미지에 관련지을 수 있었던 샘 네루 preview 이미지의 수를 돌려줍니다.
ImageReaderSpi	getOriginatingProvider () 이 constructor로 건네진 ImageReaderSpi 를 돌려줍니다.
ImageTypeSpecifier	getRawImageType (int imageIndex) 이미지의 raw 내부 형식에 가장 가까운 형식을 나타내는 SampleModel 와 ColorModel 를 나타내,ImageTypeSpecifier 를 돌려줍니다.
protected static Rectangle	getSourceRegion (ImageReadParam param, int srcWidth, int srcHeight) 지정된 ImageReadParam 의 소스 area와 서브 샘플링의 좌표의 설정을 고려해, 리더가 읽어내는 소스 이미지의 area를 계산하기 위해서 사용하는 유틸리티 메소드입니다.
abstract IIOMetadata	getStreamMetadata () 입력 소스에 전체적으로 관련지을 수 있던, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 오브젝트를 돌려줍니다.
IIOMetadata	getStreamMetadata (String formatName, Set nodeNames) 입력 소스에 전체적으로 관련지을 수 있던, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 오브젝트를 돌려줍니다.
int	getThumbnailHeight (int imageIndex, int thumbnailIndex) thumbnailIndex 에 의해 인덱스를 붙일 수 있었던 샘 네루 preview 이미지의 높이를 돌려줍니다.
int	getThumbnailWidth (int imageIndex, int thumbnailIndex) thumbnailIndex 에 의해 인덱스를 붙일 수 있었던 샘 네루 preview 이미지의 폭을 돌려줍니다.
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) 지정된 이미지가, 거기에 관련지을 수 있었던 샘 네루 preview 이미지를 가지는 경우,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	readAll (Iterator params) 모든 이미지 샘 네루, 및 메타데이타를 보관 유지해,getMinIndex 에 의해 지정된 인덱스로 시작되는 Iterator 를,IIOImage 오브젝트의 형식에서 입력 소스로부터 돌려줍니다.
RenderedImage	readAsRenderedImage (int imageIndex, ImageReadParam param) imageIndex 에 의해 인덱스를 붙일 수 있었던 이미지의 내용을 보관 유지하는 RenderedImage 오브젝트를 돌려줍니다.
boolean	readerSupportsThumbnails () 이 리더에 의해 이해되는 이미지 형식이, 거기에 관련지을 수 있었던 샘 네루 preview 이미지를 서포트하는 경우,true 를 돌려줍니다.
Raster	readRaster (int imageIndex, ImageReadParam param) 색변환을 적용하지 않고 , 이미지 스트림으로부터 의 픽셀 데이터를 보관 유지하는 새로운 Raster 오브젝트를 돌려줍니다.
BufferedImage	readThumbnail (int imageIndex, int thumbnailIndex) thumbnailIndex 에 의해 인덱스를 붙일 수 있었던 샘 네루 preview 이미지를 돌려줍니다.
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 를 슬로우 합니다.

관련 항목:

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

availableLocales

protected Locale [] availableLocales

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

locale

protected Locale  locale

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

warningListeners

protected List  warningListeners

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

warningLocales

protected List  warningLocales

현재 등록되어 있는 각 IIOReadWarningListener 에 관련지을 수 있었던 Locale 의 List 입니다. 디폴트에서는 null 에 초기화되어 하늘의 List 와 같은 의미가 됩니다.

progressListeners

protected List  progressListeners

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

updateListeners

protected List  updateListeners

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

생성자의 상세

ImageReader

protected ImageReader(ImageReaderSpi  originatingProvider)

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

확장 기능을 사용하는 서브 클래스는 확장 오브젝트를 취득하기 위해서 (ImageReaderSpi, Object) 형태를 가지는 constructor를 제공할 필요가 있습니다. 확장 오브젝트가 적절하지 않은 경우,IllegalArgumentException 가 슬로우 됩니다.

파라미터:

originatingProvider - 이 constructor를 호출하는 ImageReaderSpi 또는 null

메소드의 상세

getFormatName

public String  getFormatName()
                     throws IOException 

입력 소스의 형식을 식별하는 String 를 돌려줍니다.

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

반환값:

String 로서의 형식명

예외:

IOException - 입력 소스로부터의 정보를 읽어들여 안에 에러가 발생했을 경우

getOriginatingProvider

public ImageReaderSpi  getOriginatingProvider()

이 constructor로 건네진 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 를 슬로우 해, 그렇지 않은 경우는 minIndex 의 값을 index 로 설정합니다. seekForwardOnly 이 false 의 경우, read 오퍼레이션에 관계없이 minIndex 의 값은 0 대로 됩니다.

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

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

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

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

파라미터:

input - ImageInputStream 또는 향후, 복호화(decode)으로 사용하는 다른 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 를 슬로우 해, 그렇지 않은 경우에는 minIndex 의 값을 index 로 설정합니다. seekForwardOnly 가 false 의 경우, read 오퍼레이션에 관계없이 minIndex 의 값은 0 대로 됩니다.

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

파라미터:

input - ImageInputStream 또는 향후, 복호화(decode)으로 사용하는 다른 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 또는 향후, 복호화(decode)로 사용하는 다른 Object

예외:

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

관련 항목:

getInput()

getInput

public Object  getInput()

ImageReaderSpi 또는 이전에 입력 소스로서 설정된 다른 Object 를 돌려줍니다. 입력 소스가 설정되어 있지 않은 경우,null 가 돌려주어집니다.

반환값:

향후, 복호화(decode)로 사용되는 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 를 슬로우 합니다.

파라미터:

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 - 입력 소스로부터 폭의 정보의 읽어들여에 에러가 발생했을 경우

getHeight

public abstract int getHeight(int imageIndex)
                       throws IOException 

입력 소스의 지정된 이미지의 높이를 픽셀 단위로 돌려줍니다.

유저 지정의 사이즈로 이미지를 표현 할 수 있는 경우, 이 메소드는 디폴트의 높이를 돌려줍니다.

파라미터:

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

반환값:

int 로서의 이미지의 높이

예외:

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

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

IOException - 입력 소스로부터 높이의 정보의 읽어들여에 에러가 발생했을 경우

isRandomAccessEasy

public boolean isRandomAccessEasy(int imageIndex)
                           throws IOException 

픽셀에의 랜덤 억세스에 관해서, 지정된 이미지의 저장 형식에 고유의 장해가 아무것도 없는 경우는 true 를 돌려줍니다. JPEG 등 대부분의 압축 형식의 경우, 대상의 area에 가세해 대규모 섹션을 복호화(decode) 할 필요가 있기 (위해)때문에, 이 메소드는 false 를 돌려줍니다.

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

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

모든 이미지가 간단한 랜덤 억세스의 서포트가 프로텍션되고 있는 리더, 또는 간단한 랜덤 억세스의 서포트가 프로텍션되지 않는 리더는 이미지 데이터에 액세스 하지 않고 , 각각 true 또는 false 를 돌려줍니다. 이러한 경우는 입력 소스가 설정되어 있지 않아도, 혹은 이미지의 인덱스가 범위외에서 만나도, 예외를 슬로우 할 필요는 없습니다.

디폴트 구현은 false 를 돌려줍니다.

파라미터:

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

반환값:

지정된 이미지의 대상 area의 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 - 입력 소스로부터의 형식 정보의 읽어들여에 에러가 발생했을 경우

getImageTypes

public abstract Iterator  getImageTypes(int imageIndex)
                                throws IOException 

ImageTypeSpecifiers 의 형식에서 지정된 이미지가 복호화(decode) 되는 이미지형을 포함한 Iterator 를 돌려줍니다. 적어도 1 kr의 유효한 이미지형이 돌려주어집니다.

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

파라미터:

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

반환값:

현재 지정되고 있는 이미지를 복호화(decode) 하기 위해서, 추천 된 이미지형을 나타낸다, 적어도 1 개의 ImageTypeSpecifier 를 보관 유지하는 Iterator

예외:

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

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

IOException - 입력 소스로부터의 형식 정보의 읽어들여에 에러가 발생했을 경우

관련 항목:

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

getDefaultReadParam

public ImageReadParam  getDefaultReadParam()

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

디폴트 구현은 소스의 슬캘링을 실행할 수 없는 새로운 ImageReadParam 오브젝트를 구축해 돌려줍니다. 즉,new ImageReadParam() 를 돌려줍니다.

반환값:

일련의 디폴트의 설정을 사용해, 복호화(decode) 프로세스를 제어하기 위해서 사용되는 ImageReadParam 오브젝트

getStreamMetadata

public abstract IIOMetadata  getStreamMetadata()
                                       throws IOException 

입력 소스에 전체적으로 관련지을 수 있던, 즉 특정의 이미지에 관련지을 수 있지 않은 메타데이타를 나타내는 IIOMetadata 오브젝트를 돌려줍니다. 또는 리더가 메타데이타를 무시하도록(듯이) 설정되어 메타데이타의 read를 서포트하고 있지 않는 경우, 혹은 메타데이타를 사용할 수 없는 경우는 null 를 돌려줍니다.

반환값:

IIOMetadata 오브젝트, 또는 null

예외:

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

getStreamMetadata

public IIOMetadata  getStreamMetadata(String  formatName,
                                     Set  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  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중에 픽셀이 복호화(decode) 될 때 갱신됩니다. 마지막으로,IIOReadWarningListener 오브젝트는 복호화(decode)중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

파라미터:

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중에 픽셀이 복호화(decode) 될 때 갱신됩니다. 마지막으로,IIOReadWarningListener 오브젝트는 복호화(decode)중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

읽어내지는 소스 밴드 및 기입해지는 목적지 밴드세트는 지정된 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중에 픽셀이 복호화(decode) 될 때 갱신됩니다. 마지막으로,IIOReadWarningListener 오브젝트는 복호화(decode)중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

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

area의 설정에 관계없이, 샘 네루의 전체가 돌려주어집니다.

지정된 ImageReadParam 가 리더에 의해 서포트되지 않는 옵션의 설정치를 보관 유지하는 경우, 이러한 값은 무시됩니다.

파라미터:

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

param - read 프로세스를 제어하기 위해서 사용하는 ImageReadParam, 또는 null

반환값:

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

예외:

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

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

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

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

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

readAll

public Iterator  readAll(Iterator  params)
                 throws IOException 

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

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

돌려주어지는 IIOImage 에 의해 참조되는 BufferedImage 는 getDestination 메소드에 의해 정의된 알고리즘을 사용해 선택됩니다.

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

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

area의 설정에 관계없이, 샘 네루의 전체가 돌려주어집니다.

지정된 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 를 슬로우 합니다.

디폴트 구현은 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 의 사이즈는 항상 실제의 이미지에 클립 된 소스 area의 사이즈가 됩니다. 스트림 자체의 논리 좌표는 무시됩니다.

이 메소드는 JPEG 등 통상, 색변환을 적용하는 형식이나, 원격 탐사 또는 의료용 이미지 데이터 등 통상, 관련하는 칼라 스페이스를 가지지 않는 형식이 raw 픽셀 데이터에 액세스 할 수 있게 합니다.

등록된 readUpdateListener 는 무시되므로,BufferedImage 는 없습니다만, 다른 모든 청취자는 read 메소드의 경우와 같이 정확하게 불려 갑니다.

canReadRaster() 이 false 를 돌려주는 경우, 이 메소드는 UnsupportedOperationException 를 슬로우 합니다.

지정된 ImageReadParam 가, 이 리더에 의해 서포트되지 않는 옵션의 설정치를 보관 유지하는 경우, 이것들은 무시됩니다.

디폴트 구현은 UnsupportedOperationException 를 슬로우 합니다.

파라미터:

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 로 지정된 임의의 구형 area를 읽어낼 수가 있을 필요가 있습니다.

모든 이미지를 타일링 하도록(듯이) 프로텍션되고 있다, 혹은 타일링 하지 않게 프로텍션되고 있는 리더는 이미지 데이터에 액세스 하지 않고 각각 true 또는 false 를 돌려줍니다. 이러한 경우, 입력 소스가 설정되어 있지 않은지 또는 이미지의 인덱스가 범위외에 있는 경우에서도 예외를 슬로우 할 필요는 없습니다.

디폴트 구현은 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)을 가지는 리더는 이미지 데이터에 액세스 하지 않고 값을 돌려줍니다. 이러한 경우, 입력 소스가 설정되어 있지 않은지 혹은 이미지의 인덱스가 범위외에 있을 때에도, 예외를 슬로우 할 필요는 없습니다.

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

파라미터:

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

반환값:

타일 구라두의 X 좌표

예외:

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

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

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

getTileGridYOffset

public int getTileGridYOffset(int imageIndex)
                       throws IOException 

지정된 이미지의 타일 (0, 0)의 좌상구석의 Y 좌표를 돌려줍니다.

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

디폴트 구현은 타일링 되지 않는 이미지와 대부분의 형식의 타일링 된 이미지에 대해서 올바른 값 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 로서 돌려주어지는 타일을 읽어들입니다. 인수가 area외에 있는 경우,IllegalArgumentException 가 슬로우 됩니다. 이미지가 타일링 되지 않는 경우, 값 0, 0 은 이미지 전체를 돌려줍니다. 그 외의 값은 IllegalArgumentException 를 슬로우 시킵니다.

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

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

파라미터:

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 를 슬로우 합니다.

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

파라미터:

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()

이 리더에 의해 이해되는 이미지 형식이, 거기에 관련지을 수 있었던 샘 네루 preview 이미지를 서포트하는 경우,true 를 돌려줍니다. 디폴트 구현은 false 를 돌려줍니다.

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

샘 네루를 서포트하지 않는 리더는 샘 네루에게 관련하는 메소드를 구현할 필요가 없습니다.

반환값:

샘 네루가 서포트되는 경우는 true

hasThumbnails

public boolean hasThumbnails(int imageIndex)
                      throws IOException 

지정된 이미지가, 거기에 관련지을 수 있었던 샘 네루 preview 이미지를 가지는 경우,true 를 돌려줍니다. 형식이 샘 네루를 서포트하지 않는 경우, 즉 readerSupportsThumbnails 가 false 를 돌려주는 경우, 입력 소스가 설정되어 있는지 어떤지 또는 imageIndex 가 경계내에 있을지 어떨지에 관계없이 false 를 돌려줍니다.

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

파라미터:

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

반환값:

지정된 이미지가 샘 네루의 경우는 true

예외:

IllegalStateException - 리더가 샘 네루를 서포트하지만, 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 리더가 샘 네루를 서포트하지만,imageIndex 가 범위외에 있는 경우

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

getNumThumbnails

public int getNumThumbnails(int imageIndex)
                     throws IOException 

지정된 이미지에 관련지을 수 있었던 샘 네루 preview 이미지의 수를 돌려줍니다. 형식이 샘 네루를 서포트하지 않는 경우, 즉 readerSupportsThumbnails 가 false 를 돌려주는 경우, 입력 소스가 설정되어 있는지 어떤지 또는 imageIndex 가 경계내에 있을지 어떨지에 관계없이 0 을 돌려줍니다.

디폴트 구현은 그 인수를 확인하는 일 없이, 0 을 돌려줍니다.

파라미터:

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

반환값:

지정된 이미지에 관련지을 수 있었던 샘 네루의 수

예외:

IllegalStateException - 리더가 샘 네루를 서포트하지만, 입력 소스가 설정되어 있지 않은 경우

IndexOutOfBoundsException - 리더가 샘 네루를 서포트하지만,imageIndex 가 범위외에 있는 경우

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

getThumbnailWidth

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

thumbnailIndex 에 의해 인덱스를 붙일 수 있었던 샘 네루 preview 이미지의 폭을 돌려줍니다. 이 이미지는 ImageIndex 에 의해 인덱스를 붙일 수 있었던 이미지에 관련지을 수 있고 있습니다.

리더가 샘 네루를 서포트하지 않는 경우, 즉 readerSupportsThumbnails 가 false 를 돌려주는 경우,UnsupportedOperationException 를 슬로우 합니다.

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

파라미터:

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

thumbnailIndex - 취득되는 샘 네루의 인덱스

반환값:

int 로서 바람직한 샘 네루의 폭

예외:

UnsupportedOperationException - 샘 네루가 서포트되지 않는 경우

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

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

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

getThumbnailHeight

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

thumbnailIndex 에 의해 인덱스를 붙일 수 있었던 샘 네루 preview 이미지의 높이를 돌려줍니다. 이 이미지는 ImageIndex 에 의해 인덱스를 붙일 수 있었던 이미지에 관련지을 수 있고 있습니다.

리더가 샘 네루를 서포트하지 않는 경우, 즉 readerSupportsThumbnails 가 false 를 돌려주는 경우,UnsupportedOperationException 를 슬로우 합니다.

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

파라미터:

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

thumbnailIndex - 취득되는 샘 네루의 인덱스

반환값:

int 로서 바람직한 샘 네루의 높이

예외:

UnsupportedOperationException - 샘 네루가 서포트되지 않는 경우

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

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

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

readThumbnail

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

thumbnailIndex 에 의해 인덱스를 붙일 수 있었던 샘 네루 preview 이미지를 돌려줍니다. 이 이미지는 BufferedImage 로서 ImageIndex 에 의해 인덱스를 붙일 수 있었던 이미지에 관련지을 수 있고 있습니다.

등록된 IIOReadProgressListener 오브젝트는 thumbnailStarted,thumbnailProgress, 및 thumbnailComplete 메소드를 호출하는 것으로 통지됩니다.

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

디폴트 구현은 UnsupportedOperationException 를 슬로우 합니다.

파라미터:

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 의 경우, 예외는 슬로우 되지 않고 액션은 아무것도 행해지지 않습니다. 청취자는 이미지와 샘 네루가 복호화(decode) 될 때, 단계적으로 진행하는 패스의 시작과 종료를 포함한 픽셀 데이터 갱신의 통지를 받습니다.

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

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

복호화(decode)의 최종 결과는 중간 갱신이 실행되고 있는지 어떤지에 관계없이 같습니다. 따라서, 최종 이미지만이 필요한 경우는 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 - 복호화(decode) 되는 최초의 패스의 인덱스

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

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 의 경우에 스킵 된 픽셀을 포함한, 갱신된 area의 폭의 합계

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

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 - 복호화(decode) 되는 최초의 패스의 인덱스

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

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 의 경우에 스킵 된 픽셀을 포함한, 갱신된 area의 폭의 합계

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

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 이외의 다른 메소드의 호출의 결과는 미정도리입니다.

디폴트 구현은 아무것도 실행하지 않습니다.

getSourceRegion

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

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

파라미터:

param - 사용된 ImageReadParam, 또는 null

srcWidth - 소스 이미지의 폭

srcHeight - 소스 이미지의 높이

반환값:

Rectangle 로서의 소스 area

computeRegions

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

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

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

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

소스 또는 목적지 area의 어떤 것인가가 폭 또는 높이 0 으로 끝나는 경우,IllegalArgumentException 이 슬로우 됩니다.

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

파라미터:

param - ImageReadParam 또는 null

srcWidth - 소스 이미지의 폭

srcHeight - 소스 이미지의 높이

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

srcRegion - 대상의 소스 area가 삽입되는 Rectangle

destRegion - 대상의 목적지 area가 삽입되는 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 가 슬로우 되어 성공하면(자) 그대로 메소드가 돌려주어집니다.

파라미터:

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

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

numDstBands - 기입해진 목적지 이미지의 밴드의 수

예외:

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

getDestination

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

복호화(decode) 된 픽셀 데이터가 기입해지는 BufferedImage 를 돌려줍니다. 이미지는 null 이외의 경우, 지정된 ImageReadParam 를 확인하는 것으로써 판정됩니다. getDestination 메소드가 null 이외의 값을 돌려주는 경우는 단지 그 이미지가 돌려주어집니다. 그 이외의 경우는 param.getDestinationType 메소드가 불려 가, 특정의 이미지의 형태가 지정되고 있는지 어떤지를 확인합니다. 그 경우에는 imageTypes 에 포함되는 것의 1 kr과 같은 것을 확인하고 나서, 돌려주어진 ImageTypeSpecifier 가 사용됩니다.

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

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

파라미터:

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

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

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

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

반환값:

복호화(decode) 된 픽셀 데이터가 기입해지는 BufferedImage

예외:

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

IllegalArgumentException - imageTypes 가 null 또는 비었을 경우, 또는 ImageTypeSpecifier 가 지정하는 형태가 아닌 오브젝트를 꺼냈을 경우

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

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