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 () 읽기측이 인스턴스화 되었는지, 또는 clearAbortRequest 가 불려 갔기 때문에, 현재의 read 오퍼레이션을 중단하는 요구를 했을 경우,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 () 등록된 모든 IIOReadProgressListener 에 대해, 그 imageComplete 메소드를 호출하는 것으로, 이미지 읽을 완료를 통지합니다.
protected void	processImageProgress (float percentageDone) 등록된 모든 IIOReadProgressListener 에 대해, 그 imageProgress 메소드를 호출하는 것으로, 이미지 완성의 현재의 비율을 통지합니다.
protected void	processImageStarted (int imageIndex) 등록된 모든 IIOReadProgressListener 에 대해, 그 imageStarted 메소드를 호출하는 것으로, 이미지 읽을 개시를 통지합니다.
protected void	processImageUpdate (BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands) 등록된 모든 IIOReadUpdateListener 에 대해, 그 imageUpdate 메소드를 호출하는 것으로, 샘플세트의 갱신을 통지합니다.
protected void	processPassComplete (BufferedImage theImage) 등록된 모든 IIOReadUpdateListener 에 대해, 그 passComplete 메소드를 호출하는 것으로, 프로그래시브 패스의 종료를 통지합니다.
protected void	processPassStarted (BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands) 등록된 모든 IIOReadUpdateListener 에 대해, 그 passStarted 메소드를 호출하는 것으로, 프로그래시브 패스의 개시를 통지합니다.
protected void	processReadAborted () readAborted 메소드를 호출하는 것으로, read가 중단된 것을, 등록된 모든 IIOReadProgressListener 에 통지합니다.
protected void	processSequenceComplete () 등록된 모든 IIOReadProgressListener 에 대해, 그 sequenceComplete 메소드를 호출하는 것으로, 이미지 읽을 순서의 완료를 통지합니다.
protected void	processSequenceStarted (int minIndex) 등록된 모든 IIOReadProgressListener 에 대해, 그 sequenceStarted 메소드를 호출하는 것으로, 이미지 읽을 순서의 개시를 통지합니다.
protected void	processThumbnailComplete () 등록된 모든 IIOReadProgressListener 에 대해, 그 thumbnailComplete 메소드를 호출하는 것으로, 썸네일 읽을 완료를 통지합니다.
protected void	processThumbnailPassComplete (BufferedImage theThumbnail) 등록된 모든 IIOReadUpdateListener 에 대해,thumbnailPassComplete 메소드를 호출하는 것으로, 썸네일의 프로그래시브 패스의 종료를 통지합니다.
protected void	processThumbnailPassStarted (BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands) 등록된 모든 IIOReadUpdateListener 에 대해, 그 thumbnailPassStarted 메소드를 호출하는 것으로, 썸네일의 프로그래시브 패스의 개시를 통지합니다.
protected void	processThumbnailProgress (float percentageDone) 등록된 모든 IIOReadProgressListener 에 대해, 그 thumbnailProgress 메소드를 호출하는 것으로, 썸네일 완성의 현재의 비율을 통지합니다.
protected void	processThumbnailStarted (int imageIndex, int thumbnailIndex) 등록된 모든 IIOReadProgressListener 에 대해, 그 thumbnailStarted 메소드를 호출하는 것으로, 썸네일 읽을 개시를 통지합니다.
protected void	processThumbnailUpdate (BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands) 등록된 모든 IIOReadUpdateListener 에 대해, 그 thumbnailUpdate 메소드를 호출하는 것으로, 썸네일 이미지의 샘플세트의 갱신을 통지합니다.
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 에 초기화되어 빈 상태(empty)의 List 와 같은 의미가 됩니다.

warningLocales

protected List <Locale > warningLocales

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

progressListeners

protected List <IIOReadProgressListener > progressListeners

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

updateListeners

protected List <IIOReadUpdateListener > updateListeners

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

생성자 의 상세

ImageReader

protected ImageReader(ImageReaderSpi  originatingProvider)

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

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

파라미터:

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 만을 받아들이는 것을 나타내기 위해서(때문에),ImageInputStream.class 만을 포함한 1 개의 요소의 배열을 돌려줍니다.

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

파라미터:

input - ImageInputStream 또는 향후, 복호화로 사용하는 것 외의 Object

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

ignoreMetadata - true 의 경우, 메타데이타는 읽어들여 안에 무시된다

예외:

IllegalArgumentException - input 가 발생원서비스 프로바이더의 getInputTypes 메소드에 의해 돌려주어지고 싶은 차이인가의 클래스의 인스턴스가 아닌 경우, 또는 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 메소드에 의해 돌려주어지고 싶은 차이인가의 클래스의 인스턴스가 아닌 경우, 또는 ImageInputStream 가 아닌 경우

관련 항목:

getInput()

setInput

public void setInput(Object  input)

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

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

파라미터:

input - ImageInputStream 또는 향후, 복호화로 사용하는 것 외의 Object

예외:

IllegalArgumentException - input 가 발생원서비스 프로바이더의 getInputTypes 메소드에 의해 돌려주어지고 싶은 차이인가의 클래스의 인스턴스가 아닌 경우, 또는 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 가 throw 되는 것으로 사용할 수 있는 이미지가 더 이상 없는 것이 나타날 때까지 인덱스를 증가시키는 편이 효율적입니다. allowSearch 파라미터를 false 로 설정해, 철저한 검색이 불필요한 것을 지시할 수 있습니다. 이 경우, 반환값은 -1 되어, 검색이 필요한 것을 나타냅니다. 입력이 seekForwardOnly 로 지정되어true 로 설정되어 있을 때, 이 메소드는,allowSearch 가 true 로 설정되어 있으면,IllegalStateException 를 throw 합니다.

파라미터:

allowSearch - true 의 경우, false 의 경우, 읽기측은 검색을 실행하지 않고 -1 를 돌려준다

반환값:

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

예외:

IllegalStateException - 입력 소스가 설정되어 있지 않은 경우, 또는 입력이 seekForwardOnly 로 지정되어 true 로 설정되어 있는 경우

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

관련 항목:

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

getWidth

public abstract int getWidth(int imageIndex)
                      throws IOException 

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

사용자 지정의 사이즈로 이미지를 draw 할 수 있는 경우, 이 메소드는 디폴트의 폭을 돌려줍니다.

파라미터:

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

반환값:

int 로서의 이미지의 폭

예외:

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

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

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

getHeight

public abstract int getHeight(int imageIndex)
                       throws IOException 

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

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

파라미터:

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 가 throw 됩니다.

지정된 ImageReadParam 이, 이 읽기 측에야는 지원되지 않는 옵션의 설정치 (소스의 draw 사이즈나 형식 고유의 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

파라미터:

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 가 throw 됩니다.

영역의 설정에 관계없이, 썸네일의 전체가 돌려주어집니다.

지정된 ImageReadParam 이, 이 읽기 측에야는 지원되지 않는 옵션의 설정치 (소스의 draw 사이즈나 형식 고유의 설정등)를 보관 유지하는 경우, 이러한 값은 무시됩니다.

파라미터:

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 메소드의 호출에 의해 1 회 통지됩니다. 다음에, 복호화 된 각 이미지에 대해서,imageStarted 의 호출을 해 그 후에 읽을 진척과 함께 imageProgress 이 불려 가 마지막에 imageComplete 가 불려 갑니다. sequenceComplete 메소드는, 마지막 이미지가 데코트 된 뒤에 불려 갑니다. IIOReadUpdateListener 객체는, read중에 픽셀이 복호화 될 때 갱신됩니다. 마지막으로,IIOReadWarningListener 객체는, 복호화중에 발생하는 치명적이지 않는 경고의 통지를 받습니다.

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

영역의 설정에 관계없이, 썸네일의 전체가 돌려주어집니다.

지정된 ImageReadParam 중 한쪽이, 이 읽기 측에야는 지원되지 않는 옵션의 설정치 (소스의 draw 사이즈나 형식 고유의 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

파라미터:

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 이, 이 읽기 측에야는 지원되지 않는 옵션의 설정치 (소스의 draw 사이즈나 형식 고유의 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

디폴트 구현은 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 가 throw 됩니다. 이미지가 타일링 되지 않는 경우, 값 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 로 설정되는 임의의 목적지 이미지 또는 이미지형, 혹은 그 양쪽 모두는 무시됩니다. 다음에, 일반적으로의 청취자의 호출은, 그것들이 실행되는 것, 또는 실행되어도 의미가 있는 것은 보증되지 않습니다. 이것은, 이미지가 돌려주어졌을 때, 혹은 실제로는 임의의 시점에서, 반환된 이미지가 픽셀 데이터에 의해 완전하게는 생성되지 않는 것이 있기 (위해)때문에입니다.

지정된 ImageReadParam 이, 이 읽기 측에야는 지원되지 않는 옵션의 설정치 (소스의 draw 사이즈나 형식 고유의 설정등)를 보관 유지하는 경우, 이것들은 무시됩니다.

디폴트 구현은,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()

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

반환값:

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

관련 항목:

abort() , clearAbortRequest()

clearAbortRequest

protected void clearAbortRequest()

이전의 중단 요구를 클리어 합니다. 이 메소드가 불려 가면(자),abortRequested 는 false 를 돌려줍니다.

관련 항목:

abort() , abortRequested()

addIIOReadWarningListener

public void addIIOReadWarningListener(IIOReadWarningListener  listener)

IIOReadWarningListener 를 등록된 경고 청취자의 리스트에 추가합니다. listener 가 null 의 경우, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다. 지정된 청취자에게 보내진 메세지는, 가능하면, 현재의 Locale 에 맞도록(듯이) 로컬라이즈 됩니다. Locale 가 설정되어 있지 않은 경우는, 읽기 측에 적합하도록(듯이) 경고 메세지를 로컬라이즈 할 수 있습니다.

파라미터:

listener - 등록되는 IIOReadWarningListener

관련 항목:

removeIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)

removeIIOReadWarningListener

public void removeIIOReadWarningListener(IIOReadWarningListener  listener)

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

파라미터:

listener - 등록 해제되는 IIOReadWarningListener

관련 항목:

addIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)

removeAllIIOReadWarningListeners

public void removeAllIIOReadWarningListeners()

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

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

addIIOReadProgressListener

public void addIIOReadProgressListener(IIOReadProgressListener  listener)

IIOReadProgressListener 를 등록된 진척 청취자의 리스트에 추가합니다. listener 가 null 의 경우, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 등록되는 IIOReadProgressListener

관련 항목:

removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

removeIIOReadProgressListener

public void removeIIOReadProgressListener(IIOReadProgressListener  listener)

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

파라미터:

listener - 등록 해제되는 IIOReadProgressListener

관련 항목:

addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

removeAllIIOReadProgressListeners

public void removeAllIIOReadProgressListeners()

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

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

addIIOReadUpdateListener

public void addIIOReadUpdateListener(IIOReadUpdateListener  listener)

IIOReadUpdateListener 를, 등록된 갱신 청취자의 리스트에 추가합니다. listener 가 null 의 경우, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다. 청취자는, 이미지와 썸네일가 복호화 될 때, 프로그래시브 패스의 개시와 종료를 포함한 픽셀 데이터 갱신의 통지를 받습니다.

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

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

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

파라미터:

listener - 등록되는 IIOReadUpdateListener

관련 항목:

removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

removeIIOReadUpdateListener

public void removeIIOReadUpdateListener(IIOReadUpdateListener  listener)

등록된 갱신 청취자의 리스트로부터,IIOReadUpdateListener 를 삭제합니다. 청취자가 미리 등록되지 않았던 경우, 또는 listener 가 null 의 경우, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 등록 해제되는 IIOReadUpdateListener

관련 항목:

addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

removeAllIIOReadUpdateListeners

public void removeAllIIOReadUpdateListeners()

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

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

processSequenceStarted

protected void processSequenceStarted(int minIndex)

등록된 모든 IIOReadProgressListener 에 대해, 그 sequenceStarted 메소드를 호출하는 것으로, 이미지 읽을 순서의 개시를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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

processSequenceComplete

protected void processSequenceComplete()

등록된 모든 IIOReadProgressListener 에 대해, 그 sequenceComplete 메소드를 호출하는 것으로, 이미지 읽을 순서의 완료를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

processImageStarted

protected void processImageStarted(int imageIndex)

등록된 모든 IIOReadProgressListener 에 대해, 그 imageStarted 메소드를 호출하는 것으로, 이미지 읽을 개시를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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

processImageProgress

protected void processImageProgress(float percentageDone)

등록된 모든 IIOReadProgressListener 에 대해, 그 imageProgress 메소드를 호출하는 것으로, 이미지 완성의 현재의 비율을 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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

processImageComplete

protected void processImageComplete()

등록된 모든 IIOReadProgressListener 에 대해, 그 imageComplete 메소드를 호출하는 것으로, 이미지 읽을 완료를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

processThumbnailStarted

protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)

등록된 모든 IIOReadProgressListener 에 대해, 그 thumbnailStarted 메소드를 호출하는 것으로, 썸네일 읽을 개시를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

imageIndex - 썸네일가 관련지을 수 있었다 이미지의 인덱스

thumbnailIndex - 썸네일의 인덱스

processThumbnailProgress

protected void processThumbnailProgress(float percentageDone)

등록된 모든 IIOReadProgressListener 에 대해, 그 thumbnailProgress 메소드를 호출하는 것으로, 썸네일 완성의 현재의 비율을 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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

processThumbnailComplete

protected void processThumbnailComplete()

등록된 모든 IIOReadProgressListener 에 대해, 그 thumbnailComplete 메소드를 호출하는 것으로, 썸네일 읽을 완료를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

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)

등록된 모든 IIOReadUpdateListener 에 대해, 그 passStarted 메소드를 호출하는 것으로, 프로그래시브 패스의 개시를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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)

등록된 모든 IIOReadUpdateListener 에 대해, 그 imageUpdate 메소드를 호출하는 것으로, 샘플세트의 갱신을 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

theImage - 갱신된 BufferedImage

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

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

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

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

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

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

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

processPassComplete

protected void processPassComplete(BufferedImage  theImage)

등록된 모든 IIOReadUpdateListener 에 대해, 그 passComplete 메소드를 호출하는 것으로, 프로그래시브 패스의 종료를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

theImage - 갱신된 BufferedImage

processThumbnailPassStarted

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

등록된 모든 IIOReadUpdateListener 에 대해, 그 thumbnailPassStarted 메소드를 호출하는 것으로, 썸네일의 프로그래시브 패스의 개시를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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)

등록된 모든 IIOReadUpdateListener 에 대해, 그 thumbnailUpdate 메소드를 호출하는 것으로, 썸네일 이미지의 샘플세트의 갱신을 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

theThumbnail - 갱신되었다 BufferedImage 썸네일

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

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

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

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

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

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

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

processThumbnailPassComplete

protected void processThumbnailPassComplete(BufferedImage  theThumbnail)

등록된 모든 IIOReadUpdateListener 에 대해,thumbnailPassComplete 메소드를 호출하는 것으로, 썸네일의 프로그래시브 패스의 종료를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

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 가 throw 됩니다.

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

파라미터:

param - ImageReadParam 또는 null

srcWidth - 소스 이미지의 폭

srcHeight - 소스 이미지의 높이

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

srcRegion - 대상의 소스 영역이 삽입된다 Rectangle

destRegion - 대상의 목적지 영역이 삽입된다 Rectangle

예외:

IllegalArgumentException - srcRegion 가 null 의 경우

IllegalArgumentException - dstRegion 가 null 의 경우

IllegalArgumentException - 결과의 소스 또는 목적지가 빈 상태(empty)의 경우

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 - 입력 소스에 존재하는 이미지의 밴드의 수

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 또는 빈 상태(empty)의 경우, 또는 ImageTypeSpecifier 가 지정하는 형태가 아닌 객체를 꺼냈을 경우

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

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