javax.imageio
클래스 ImageWriter

java.lang.Object 
  javax.imageio.ImageWriter

모든 구현된 인터페이스:

ImageTranscoder

public abstract class ImageWriter
extends Object 
implements ImageTranscoder 

encode와 이미지의 기입을 위한 추상 슈퍼 클래스입니다. Java Image I/O 시스템의 문맥내에서, 이미지를 써내는 클래스가, 이 클래스를 서브 클래스화할 필요가 있습니다.

ImageWriter 객체는 일반적으로, 특정 형식을 위한 서비스 프로바이더 클래스에 의해 인스턴스화 됩니다. 서비스 프로바이더 클래스는 IIORegistry 에 등록되어 형식을 식별해, 사용 가능한 형식의 읽기측과 기입해 옆을 제시하기 위해서 사용됩니다.

관련 항목:

ImageReader , ImageWriteParam , IIORegistry , ImageWriterSpi

필드의 개요

protected Locale []	availableLocales 경고 메세지와 압축 설정치를 로컬라이즈 하기 위해서 사용할 수 있는 Locale 의 배열, 또는 로컬라이즈판이 지원되어 있지 않은 경우는 null 가 됩니다.
protected Locale	locale 로컬라이즈판에 사용하는 현재의 Locale, 또는 설정되어 있지 않은 경우는 null 입니다.
protected ImageWriterSpi	originatingProvider 이 객체를 인스턴스화한 ImageWriterSpi, 혹은 그 식별 정보가 존재하지 않는, 또는 모르는 경우,null 가 됩니다.
protected Object	output ImageOutputStream 또는 setOutput 가 설정해,getOutput 가 꺼낸 그 외의 Object 입니다.
protected List <IIOWriteProgressListener >	progressListeners 현재 등록된 IIOWriteProgressListener 의 List 로, 디폴트에서는 null 에 초기화되어 빈 상태(empty)의 List 와 같은 의미가 됩니다.
protected List <IIOWriteWarningListener >	warningListeners 현재 등록된 IIOWriteWarningListener 의 List 로, 디폴트에서는 null 에 초기화되어 빈 상태(empty)의 List 와 같은 의미가 됩니다.
protected List <Locale >	warningLocales warningListeners 의 각 요소에 대한 Locale 의 List 로, 디폴트에서는 null 에 초기화되어 빈 상태(empty)의 List 와 같은 의미가 됩니다.

생성자 의 개요

protected

ImageWriter (ImageWriterSpi originatingProvider) ImageWriter 을 구축해, 그 originatingProvider 인스턴스 변수를, 제공된 값으로 설정합니다.

메소드의 개요

void	abort () 현재의 기입 오퍼레이션의 중단을 요구합니다.
protected boolean	abortRequested () 기입측이 인스턴스화 된, 또는 clearAbortRequest 가 불려 갔기 때문에, 현재의 기입 조작의 중지 요구가 나왔을 경우,true 를 돌려줍니다.
void	addIIOWriteProgressListener (IIOWriteProgressListener listener) 등록된 진척 청취자의 리스트에 IIOWriteProgressListener 를 추가합니다.
void	addIIOWriteWarningListener (IIOWriteWarningListener listener) 등록된 경고 청취자의 리스트에 IIOWriteWarningListener 를 추가합니다.
boolean	canInsertEmpty (int imageIndex) 지정된 인덱스에서의 신규의 빈 상태(empty) 이미지의 삽입을 기입해 옆이 지원하는 경우,true 를 돌려줍니다.
boolean	canInsertImage (int imageIndex) 지정된 인덱스에서의 신규 이미지의 삽입을 기입해 옆이 지원하는 경우,true 를 돌려줍니다.
boolean	canRemoveImage (int imageIndex) 기입측이, 지정된 인덱스에서의 기존 이미지의 삭제를 지원하는 경우,true 를 돌려줍니다.
boolean	canReplaceImageMetadata (int imageIndex) 기존의 이미지에 관련지을 수 있었던 이메이지메타데이타를, 인덱스 imageIndex 에 옮겨놓을 수가 있는 경우,true 를 돌려줍니다.
boolean	canReplacePixels (int imageIndex) 기입측에서,replacePixels 메소드를 사용해, 지정된 이미지의 픽셀의 치환을 허가하는 경우,true 를 돌려줍니다.
boolean	canReplaceStreamMetadata () 벌써 출력에 존재하는 스트림메타데이타를 옮겨놓을 수 있는 경우,true 를 돌려줍니다.
boolean	canWriteEmpty () 미정도리의 픽셀치를 가지는 1 개의 이미지와 관련지을 수 있었던 메타데이타와 썸네일로부터 완성되는, 완전한 이미지 스트림의 출력에의 기입을 기입해 옆이 지원하는 경우,true 를 돌려줍니다.
boolean	canWriteRasters () IIOImage 파라미터를 취하는 메소드가, (RenderedImage 에 대해서) Raster 소스 이미지를 처리할 수 있는 경우,true 를 돌려줍니다.
boolean	canWriteSequence () 벌써 헤더 정보를 포함해, 이전의 이미지일 가능성을 가지는 이미지 스트림에, 기입측이 이미지를 추가할 수 있는 경우,true 를 돌려줍니다.
protected void	clearAbortRequest () 이전의 중단 요구를 클리어 합니다.
abstract IIOMetadata	convertImageMetadata (IIOMetadata inData, ImageTypeSpecifier imageType, ImageWriteParam param) encode에 사용할 수 있어 필요에 따라서, 문서 인터페이스 또는 encode에 사용하는 기입측 플러그 인에 고유외의 인터페이스를 사용해 변경할 수 있는,IIOMetadata 객체를 돌려줍니다.
abstract IIOMetadata	convertStreamMetadata (IIOMetadata inData, ImageWriteParam param) encode에 사용할 수 있어 필요에 따라서, 문서 인터페이스 또는 encode에 사용하는 기입측 플러그 인에 고유외의 인터페이스를 사용해 변경할 수 있는,IIOMetadata 객체를 돌려줍니다.
void	dispose () 이 객체가 보관 유지하는 모든 자원을 해제할 수 있도록(듯이) 합니다.
void	endInsertEmpty () 이전의 prepareInsertEmpty 의 호출로 시작된, 신규 이미지의 삽입을 완료합니다.
void	endReplacePixels () replacePixels 의 호출 처리를 종료합니다.
void	endWriteEmpty () 이전의 prepareWriteEmpty 의 호출로 시작된, 신규 이미지의 기입을 완료합니다.
void	endWriteSequence () prepareWriteSequence 로 시작되는 일련의 이미지의 기입을 완료합니다.
Locale []	getAvailableLocales () 경고 청취자와 압축 설정의 로컬라이즈에 사용하는 Locale 의 배열을 돌려줍니다.
abstract IIOMetadata	getDefaultImageMetadata (ImageTypeSpecifier imageType, ImageWriteParam param) 지정된 형태의 이미지를 encode하기 위한 디폴트 값를 포함한 IIOMetadata 객체를 돌려줍니다.
abstract IIOMetadata	getDefaultStreamMetadata (ImageWriteParam param) 이미지의 스트림을 encode하기 위한 디폴트 값를 포함한 IIOMetadata 객체를 돌려줍니다.
ImageWriteParam	getDefaultWriteParam () 디폴트 값, 즉 ImageWriteParam 객체가 지정되지 않았던 경우에 사용되는 값을 포함한, 이 파일 형식에 적절한 형태의 신규 ImageWriteParam 객체를 돌려줍니다.
Locale	getLocale () 현재 설정되어 있는 Locale, 아무것도 설정되어 있지 않은 경우는 null 를 돌려줍니다.
int	getNumThumbnailsSupported (ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata) encode중에 사용되는 메타데이타객체와 임의의 추가 기입 파라미터, 및 이미지형을 고려해, 기입해지고 있는 형식에서 지원되는 썸네일수를 돌려줍니다.
ImageWriterSpi	getOriginatingProvider () 이 ImageWriter 를 작성한 ImageWriterSpi 객체, 또는 이 객체가 IIORegistry 를 개입시켜 작성되고 싶었던 경우 null 를 돌려줍니다.
Object	getOutput () ImageOutputStream 또는 setOutput 메소드의 최근의 호출로 설정된 것 외의 Object 를 돌려줍니다.
Dimension []	getPreferredThumbnailSizes (ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata) 썸네일 이미지가 출력 파일 또는 스트림중에서 encode 될 때, 그 정규 사이즈의 범위를 나타내는 Dimension 의 배열을 돌려줍니다.
void	prepareInsertEmpty (int imageIndex, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List <? extends BufferedImage > thumbnails, ImageWriteParam param) 미정도리의 픽셀치를 가지는 신규 이미지의, 기존 이미지 스트림에의 삽입을 개시합니다.
void	prepareReplacePixels (int imageIndex, Rectangle region) replacePixels 메소드의 일련의 호출을 처리하기 위해서, 기입측을 준비합니다.
void	prepareWriteEmpty (IIOMetadata streamMetadata, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List <? extends BufferedImage > thumbnails, ImageWriteParam param) 미정도리의 픽셀치를 가지는 1 개의 이미지와 관련지을 수 있었던 메타데이타와 썸네일로부터 완성되는, 완전한 이미지 스트림의 출력에의 기입을 개시합니다.
void	prepareWriteSequence (IIOMetadata streamMetadata) 다음에 계속되는 일련의 writeToSequence 호출을 받아들이기 위해서(때문에), 제공되는 스트림메타데이타객체를 사용해, 스트림을 준비합니다.
protected void	processImageComplete () 등록된 모든 IIOWriteProgressListener 에 대해, 그 imageComplete 메소드를 호출하는 것으로, 이미지 기입의 완료를 통지합니다.
protected void	processImageProgress (float percentageDone) 등록된 모든 IIOWriteProgressListener 에 대해, 그 imageProgress 메소드를 호출하는 것으로, 이미지 완성의 현재의 비율을 통지합니다.
protected void	processImageStarted (int imageIndex) 등록된 모든 IIOWriteProgressListener 에 대해, 그 imageStarted 메소드를 호출하는 것으로, 이미지 기입의 개시를 통지합니다.
protected void	processThumbnailComplete () 등록된 모든 IIOWriteProgressListener 에 대해, 그 thumbnailComplete 메소드를 호출하는 것으로, 썸네일 기입의 완료를 통지합니다.
protected void	processThumbnailProgress (float percentageDone) 등록된 모든 IIOWriteProgressListener 에 대해, 그 thumbnailProgress 메소드를 호출하는 것으로, 썸네일 완성의 현재의 비율을 통지합니다.
protected void	processThumbnailStarted (int imageIndex, int thumbnailIndex) 등록된 모든 IIOWriteProgressListener 에 대해, 그 thumbnailStarted 메소드를 호출하는 것으로, 썸네일 기입의 개시를 통지합니다.
protected void	processWarningOccurred (int imageIndex, String warning) 등록된 모든 IIOWriteWarningListener 에 대해, 그 warningOccurred 메소드를 호출하는 것으로, 경고 메세지를 통지합니다.
protected void	processWarningOccurred (int imageIndex, String baseName, String keyword) 등록된 모든 IIOWriteWarningListener 에 대해,ResourceBundle 로부터 취득한 캐릭터 라인을 사용해 그 warningOccurred 메소드를 호출하는 것으로, 로컬라이즈 된 경고 메세지를 통지합니다.
protected void	processWriteAborted () 등록된 모든 IIOWriteProgressListener 에 대해, 그 writeAborted 메소드를 호출하는 것으로, 기입이 중지된 것을 통지합니다.
void	removeAllIIOWriteProgressListeners () 현재 등록된 IIOWriteProgressListener 객체를 모두 삭제합니다.
void	removeAllIIOWriteWarningListeners () 현재 등록된 IIOWriteWarningListener 객체를 모두 삭제합니다.
void	removeIIOWriteProgressListener (IIOWriteProgressListener listener) 등록된 진척 청취자의 리스트로부터,IIOWriteProgressListener 를 삭제합니다.
void	removeIIOWriteWarningListener (IIOWriteWarningListener listener) 등록된 경고 청취자의 리스트로부터,IIOWriteWarningListener 를 삭제합니다.
void	removeImage (int imageIndex) 스트림로부터 이미지를 삭제합니다.
void	replaceImageMetadata (int imageIndex, IIOMetadata imageMetadata) 기존 이미지에 관련지을 수 있었던 이메이지메타데이타를 옮겨놓습니다.
void	replacePixels (Raster raster, ImageWriteParam param) 벌써 출력내에 있는 이미지의 일부를, 지정된 Raster 의 일부에 옮겨놓습니다.
void	replacePixels (RenderedImage image, ImageWriteParam param) 벌써 출력내에 있는 이미지의 일부를, 지정된 이미지의 일부에 옮겨놓습니다.
void	replaceStreamMetadata (IIOMetadata streamMetadata) 출력내의 스트림메타데이타를 신규 정보에 옮겨놓습니다.
void	reset () ImageWriter 를 초기 상태에 복원합니다.
void	setLocale (Locale locale) 이 ImageWriter 의 현재의 Locale 를, 지정된 값으로 설정합니다.
void	setOutput (Object output) 출력처를, 지정된 ImageOutputStream 또는 다른 Object 로 설정합니다.
void	write (IIOImage image) 데포르트메타데이타와 썸네일가 뒤따른 1 개의 이미지를 포함한, 완전한 이미지 스트림을 출력에 추가합니다.
abstract void	write (IIOMetadata streamMetadata, IIOImage image, ImageWriteParam param) 1 개의 이미지, 관련지을 수 있었던 스트림과 이메이지메타데이타, 및 썸네일를 포함한 완전한 이미지 스트림을 출력에 추가합니다.
void	write (RenderedImage image) 데포르트메타데이타와 썸네일가 뒤따른 1 개의 이미지로부터 완성되는, 완전한 이미지 스트림을 출력에 추가합니다.
void	writeInsert (int imageIndex, IIOImage image, ImageWriteParam param) 기존 이미지 스트림에 신규 이미지를 삽입합니다.
void	writeToSequence (IIOImage image, ImageWriteParam param) 1 개의 이미지와 관련지을 수 있을 가능성이 있는 메타데이타와 썸네일를, 출력에 추가합니다.

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

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

필드의 상세

originatingProvider

protected ImageWriterSpi  originatingProvider

이 객체를 인스턴스화한 ImageWriterSpi, 혹은 그 식별 정보가 존재하지 않는, 또는 모르는 경우,null 가 됩니다. 디폴트에서는,null 에 초기화됩니다.

output

protected Object  output

ImageOutputStream 또는 setOutput 가 설정해,getOutput 가 꺼낸 그 외의 Object 입니다. 디폴트에서는,null 에 초기화됩니다.

availableLocales

protected Locale [] availableLocales

경고 메세지와 압축 설정치를 로컬라이즈 하기 위해서 사용할 수 있는 Locale 의 배열, 또는 로컬라이즈판이 지원되어 있지 않은 경우는 null 가 됩니다. 디폴트에서는,null 에 초기화됩니다.

locale

protected Locale  locale

로컬라이즈판에 사용하는 현재의 Locale, 또는 설정되어 있지 않은 경우는 null 입니다. 디폴트에서는,null 에 초기화됩니다.

warningListeners

protected List <IIOWriteWarningListener > warningListeners

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

warningLocales

protected List <Locale > warningLocales

warningListeners 의 각 요소에 대한 Locale 의 List 로, 디폴트에서는 null 에 초기화되어 빈 상태(empty)의 List 와 같은 의미가 됩니다.

progressListeners

protected List <IIOWriteProgressListener > progressListeners

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

생성자 의 상세

ImageWriter

protected ImageWriter(ImageWriterSpi  originatingProvider)

ImageWriter 을 구축해, 그 originatingProvider 인스턴스 변수를, 제공된 값으로 설정합니다.

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

파라미터:

originatingProvider - 이 객체를 구축하는 ImageWriterSpi, 또는 null

메소드의 상세

getOriginatingProvider

public ImageWriterSpi  getOriginatingProvider()

이 ImageWriter 를 작성한 ImageWriterSpi 객체, 또는 이 객체가 IIORegistry 를 개입시켜 작성되고 싶었던 경우 null 를 돌려줍니다.

디폴트 구현에서는,originatingProvider 인스턴스 변수의 값을 돌려줍니다.

반환값:

ImageWriterSpi, 또는 null

관련 항목:

ImageWriterSpi

setOutput

public void setOutput(Object  output)

출력처를, 지정된 ImageOutputStream 또는 다른 Object 로 설정합니다. 출력처는 데이터를 받을 준비가 되어 있다고 보여져 각 기입의 종료시에 클로즈 되지 않습니다. 이것에 의해, 분산 이미지 어플리케이션은, 1 개의 네트워크 접속상에 일련의 이미지를 송신할 수 있습니다. output 가 null 의 경우, 현재 설정되어 있는 출력은 모두 삭제됩니다.

output 가 ImageOutputStream 의 경우,write,writeToSequence,prepareWriteEmpty/endWriteEmpty 메소드의 호출은, 기존의 스트림 내용을 보관 유지합니다. writeInsert,replaceStreamMetadata,replaceImageMetadata,replacePixels,prepareInsertEmpty/endInsertEmpty,endWriteSequence 와 같은 그 외의 기입 메소드는, 완전한 스트림 내용의 읽어들여, 기입을 할 수 있는 것을 요구해, 스트림의 임의의 부분을 변경할 수 있습니다.

ImageOutputStream 이외의 일반의 Object 는, 출력 길이치 또는 이미징 프로토콜과 직접 대화하는 기입측을 위해서(때문에) 사용됩니다. 기입측의 서비스 프로바이더의 getOutputTypes 메소드에 의해, 정규의 클래스세트가 공시되어 대부분의 기입측이,ImageOutputStream 만을 받아들이는 것을 나타내기 위해서(때문에),ImageOutputStream.class 만을 포함한 1 개의 요소의 배열을 돌려줍니다.

디폴트 구현에서는, 발신 프로바이더가 공시한 클래스의 설정이 있으면, 이것에 output 를 대조한 뒤,output 인스턴스 변수를 output 의 값으로 설정합니다.

파라미터:

output - ImageOutputStream 또는 향후의 기입해에 사용하는 것 외의 Object

예외:

IllegalArgumentException - output 가, 발생원서비스 프로바이더의 getOutputTypes 메소드에 의해 돌려주어졌다 몇개의 클래스의 인스턴스가 아닌 경우

관련 항목:

getOutput()

getOutput

public Object  getOutput()

ImageOutputStream 또는 setOutput 메소드의 최근의 호출로 설정된 것 외의 Object 를 돌려줍니다. 출력처가 설정되어 있지 않은 경우,null 가 돌려주어집니다.

디폴트 구현에서는,output 인스턴스 변수의 값을 돌려줍니다.

반환값:

setOutput 를 사용해 지정된 Object, 또는 null

관련 항목:

setOutput(java.lang.Object)

getAvailableLocales

public Locale [] getAvailableLocales()

경고 청취자와 압축 설정의 로컬라이즈에 사용하는 Locale 의 배열을 돌려줍니다. 반환값 null 는, 로컬라이즈판이 지원되어 있지 않은 것을 나타냅니다.

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

반환값:

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

setLocale

public void setLocale(Locale  locale)

이 ImageWriter 의 현재의 Locale 를, 지정된 값으로 설정합니다. 값 null 는, 이전의 설정을 모두 삭제해, 기입측이 적절히 로컬라이즈 할 필요가 있는 것을 나타냅니다.

디폴트 구현에서는,locale 를 getAvailableLocales 가 돌려준 값과 대조해 발견되면 locale 인스턴스 변수를 설정합니다. locale 가 null 의 경우, 어떤 체크도 없이 , 인스턴스 변수는 null 로 설정됩니다.

파라미터:

locale - 목적의 Locale, 또는 null

예외:

IllegalArgumentException - locale 가 null 는 아니지만, getAvailableLocales 에 의해 돌려주어졌다 값의 1 개가 아닌 경우

관련 항목:

getLocale()

getLocale

public Locale  getLocale()

현재 설정되어 있는 Locale, 아무것도 설정되어 있지 않은 경우는 null 를 돌려줍니다.

디폴트 구현에서는,locale 인스턴스 변수의 값을 돌려줍니다.

반환값:

현재의 Locale 또는 null

관련 항목:

setLocale(java.util.Locale)

getDefaultWriteParam

public ImageWriteParam  getDefaultWriteParam()

디폴트 값, 즉 ImageWriteParam 객체가 지정되지 않았던 경우에 사용되는 값을 포함한, 이 파일 형식에 적절한 형태의 신규 ImageWriteParam 객체를 돌려줍니다. 이것은, 2, 3 의 파라미터만을 미조정하기 위한 기점으로서 유효해, 그 외의 경우는 디폴트 설정대로 합니다.

디폴트 구현에서는, 타일링, 프로그래시브 인코딩, 또는 압축을 허가하지 않는 신규 ImageWriteParam 객체를 구축해, 돌려줍니다. 현재의 Locale (즉,new ImageWriteParam(getLocale()) 의 호출로 취득하는 것)로 로컬라이즈 됩니다.

개개의 플러그 인은, 추가의 옵션 기능을 사용 가능하게 해,ImageWriteParam 의 인스턴스를 돌려줄 수가 있습니다. 혹은,ImageWriteParam 의 플러그 인 고유 서브 클래스의 인스턴스를 돌려줄 수가 있습니다.

반환값:

디폴트 값를 포함한 신규 ImageWriteParam 객체

getDefaultStreamMetadata

public abstract IIOMetadata  getDefaultStreamMetadata(ImageWriteParam  param)

이미지의 스트림을 encode하기 위한 디폴트 값를 포함한 IIOMetadata 객체를 돌려줍니다. 객체의 내용은,IIOMetadata.getAsTree 메소드가 돌려준 XML 트리 구조,IIOMetadataController 객체, 또는 플러그 인 고유의 인터페이스 경유의 어느쪽이든을 사용해 조작할 수 있어 그 결과 데이터는, 스트림메타데이타파라메이타를 취하는 write 메소드의 1 개에 제공할 수 있습니다.

스트림메타데이타의 구조에 영향을 주는 경우를 위해서(때문에), 옵션의 ImageWriteParam 를 제공할 수 있습니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

스트림메타데이타를 사용하지 않는 기입측 (예를 들어, 1 개의 이미지 형식을 위한 기입해 옆)은,null 를 돌려줄 필요가 있습니다.

파라미터:

param - 이미지의 encode에 사용되는 ImageWriteParam, 또는 null

반환값:

IIOMetadata 객체

getDefaultImageMetadata

public abstract IIOMetadata  getDefaultImageMetadata(ImageTypeSpecifier  imageType,
                                                    ImageWriteParam  param)

지정된 형태의 이미지를 encode하기 위한 디폴트 값를 포함한 IIOMetadata 객체를 돌려줍니다. 객체의 내용은,IIOMetadata.getAsTree 메소드가 돌려준 XML 트리 구조,IIOMetadataController 객체, 또는 플러그 인 고유의 인터페이스 경유의 어느쪽이든을 사용해 조작할 수 있어 그 결과 데이터는, 스트림메타데이타파라메이타를 취하는 write 메소드의 1 개에 제공할 수 있습니다.

이메이지메타데이타의 구조에 영향을 주는 경우를 위해서(때문에), 옵션의 ImageWriteParam 를 제공할 수 있습니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

파라미터:

imageType - 나중에 기입해지는 이미지의 형식을 나타낸다 ImageTypeSpecifier

param - 이미지의 encode에 사용되는 ImageWriteParam, 또는 null

반환값:

IIOMetadata 객체

convertStreamMetadata

public abstract IIOMetadata  convertStreamMetadata(IIOMetadata  inData,
                                                  ImageWriteParam  param)

인터페이스 ImageTranscoder 의 기술:

encode에 사용할 수 있어 필요에 따라서, 문서 인터페이스 또는 encode에 사용하는 기입측 플러그 인에 고유외의 인터페이스를 사용해 변경할 수 있는,IIOMetadata 객체를 돌려줍니다.

스트림메타데이타의 구조에 영향을 주는 경우를 위해서(때문에), 옵션의 ImageWriteParam 를 제공할 수 있습니다.

제공된 ImageWriteParam 에, 기입측 또는 변환측이 이해하지 않는 옵션 설정치가 포함되는 경우, 그러한 설정치는 무시됩니다.

정의:

인터페이스 ImageTranscoder 내의 convertStreamMetadata

파라미터:

inData - 스트림메타데이타를 나타내, 반환된 객체 상태의 초기화에 사용된다 IIOMetadata 객체

param - 이미지의 encode에 사용되는 ImageWriteParam, 또는 null

반환값:

IIOMetadata 객체, 또는 플러그 인이 메타데이타를 encode 하는 기능을 제공하지 않는 경우는 null

convertImageMetadata

public abstract IIOMetadata  convertImageMetadata(IIOMetadata  inData,
                                                 ImageTypeSpecifier  imageType,
                                                 ImageWriteParam  param)

인터페이스 ImageTranscoder 의 기술:

encode에 사용할 수 있어 필요에 따라서, 문서 인터페이스 또는 encode에 사용하는 기입측 플러그 인에 고유외의 인터페이스를 사용해 변경할 수 있는,IIOMetadata 객체를 돌려줍니다.

이메이지메타데이타의 구조에 영향을 주는 경우를 위해서(때문에), 옵션의 ImageWriteParam 를 제공할 수 있습니다.

제공된 ImageWriteParam 에, 기입측 또는 변환측이 이해하지 않는 옵션 설정치가 포함되는 경우, 그러한 설정치는 무시됩니다.

정의:

인터페이스 ImageTranscoder 내의 convertImageMetadata

파라미터:

inData - 이메이지메타데이타를 나타내, 반환된 객체 상태의 초기화에 사용된다 IIOMetadata 객체

imageType - 메타데이타에 관련지을 수 있는 이미지의 배치와 배색 정보를 나타낸다 ImageTypeSpecifier

param - 이미지의 encode에 사용되는 ImageWriteParam, 또는 null

반환값:

IIOMetadata 객체, 또는 플러그 인이 메타데이타를 encode 하는 기능을 제공하지 않는 경우는 null

getNumThumbnailsSupported

public int getNumThumbnailsSupported(ImageTypeSpecifier  imageType,
                                     ImageWriteParam  param,
                                     IIOMetadata  streamMetadata,
                                     IIOMetadata  imageMetadata)

encode중에 사용되는 메타데이타객체와 임의의 추가 기입 파라미터, 및 이미지형을 고려해, 기입해지고 있는 형식에서 지원되는 썸네일수를 돌려줍니다. 반환값 -1 은, 충분한 정보를 사용할 수 없는 것을 나타냅니다.

엄지손가락 처리에 영향을 주는 경우를 위해서(때문에), 옵션으로서 ImageWriteParam 를 제공할 수 있습니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

디폴트 구현은 0 을 돌려줍니다.

파라미터:

imageType - 기입해지는 이미지형을 나타내는 ImageTypeSpecifier, 또는 null

param - 기입에 사용되는 ImageWriteParam, 또는 null

streamMetadata - 기입에 사용되는 IIOMetadata 객체, 또는 null

imageMetadata - 기입에 사용되는 IIOMetadata 객체, 또는 null

반환값:

제공된 파라미터를 고려한, 기입할 수 있는 썸네일수, 또는 충분한 정보를 사용할 수 없는 경우는 -1

getPreferredThumbnailSizes

public Dimension [] getPreferredThumbnailSizes(ImageTypeSpecifier  imageType,
                                              ImageWriteParam  param,
                                              IIOMetadata  streamMetadata,
                                              IIOMetadata  imageMetadata)

썸네일 이미지가 출력 파일 또는 스트림중에서 encode 될 때, 그 정규 사이즈의 범위를 나타내는 Dimension 의 배열을 돌려줍니다. 이 정보는 단순한 조언이며, 기입측은, 필요에 따라서 임의의 제공된 썸네일의 사이즈를 변경할 수 있습니다.

정보는 페어로 돌려주어집니다. 페어의 최초의 요소에는, 포괄적인 최소의 폭과 높이가, 다음의 요소에는 포괄적인 최대의 폭과 높이가 포함됩니다. 아울러, 각 페어는 사이즈의 유효 범위를 정의합니다. 고정 사이즈를 지정하려면 , 양쪽 모두의 요소에 같은 폭과 높이를 사용합니다. 반환값 null 는, 사이즈가 임의 또는 불명한 것을 나타냅니다.

엄지손가락 처리에 영향을 주는 경우를 위해서(때문에), 옵션으로서 ImageWriteParam 를 제공할 수 있습니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

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

파라미터:

imageType - 기입해지는 이미지형을 나타내는 ImageTypeSpecifier, 또는 null

param - 기입에 사용되는 ImageWriteParam, 또는 null

streamMetadata - 기입에 사용되는 IIOMetadata 객체, 또는 null

imageMetadata - 기입에 사용되는 IIOMetadata 객체, 또는 null

반환값:

2 이상의 같은 길이를 가지는 Dimension 의 배열, 또는 null

canWriteRasters

public boolean canWriteRasters()

IIOImage 파라미터를 취하는 메소드가, (RenderedImage 에 대해서) Raster 소스 이미지를 처리할 수 있는 경우,true 를 돌려줍니다. 이 메소드가 false 를 돌려주는 경우, 이러한 메소드는,Raster 를 포함한 IIOImage 가 제공될 때, UnsupportedOperationException 를 throw 합니다.

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

반환값:

Raster 소스가 지원되는 경우는 true

write

public abstract void write(IIOMetadata  streamMetadata,
                           IIOImage  image,
                           ImageWriteParam  param)
                    throws IOException 

1 개의 이미지, 관련지을 수 있었던 스트림과 이메이지메타데이타, 및 썸네일를 포함한 완전한 이미지 스트림을 출력에 추가합니다. 필요한 헤더 정보가 포함되어 있습니다. 출력이 ImageOutputStream 의 경우, 현재의 시크 위치 이전의 기존의 내용은 영향을 받지 않고, read 가능 또는 기입해 가능한 필요는 없습니다.

출력은,setOutput 메소드를 사용해 미리 설정되어 있을 필요가 있습니다.

스트림메타데이타가 옵션으로 제공되어null 의 경우, 디폴트의 스트림메타데이타가 사용됩니다.

canWriteRasters 가 true 를 돌려주는 경우,IIOImage 는 Raster 소스를 포함할 수가 있습니다. 그렇지 않은 경우는,RenderedImage 소스를 포함할 필요가 있습니다.

제공되는 썸네일는, 필요하면 사이즈 변경되어 지원되는 수를 초과한 썸네일는, 모두 무시됩니다. 제공되지 않는 추가의 썸네일가 그 형식에서 필요한 경우, 기입측이 내부에서 생성할 필요가 있습니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

파라미터:

streamMetadata - 스트림메타데이타를 나타내는 IIOMetadata 객체, 또는 디폴트 값를 사용하기 위한 null

image - 기입해지는 이미지, 썸네일, 및 메타데이타를 포함한 IIOImage 객체

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - image 가 Raster 를 포함해,canWriteRasters 이 false 를 돌려주는 경우

IllegalArgumentException - image 가 null 의 경우

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

write

public void write(IIOImage  image)
           throws IOException 

데포르트메타데이타와 썸네일가 뒤따른 1 개의 이미지를 포함한, 완전한 이미지 스트림을 출력에 추가합니다. 이 메소드는,write(null, image, null) 의 단축형입니다.

파라미터:

image - 기입해지는 이미지, 썸네일, 및 메타데이타를 포함한 IIOImage 객체

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IllegalArgumentException - image 가 null 의 경우

UnsupportedOperationException - image 가 Raster 를 포함해,canWriteRasters 이 false 를 돌려주는 경우

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

write

public void write(RenderedImage  image)
           throws IOException 

데포르트메타데이타와 썸네일가 뒤따른 1 개의 이미지로부터 완성되는, 완전한 이미지 스트림을 출력에 추가합니다. 이 메소드는,write(null, new IIOImage(image, null, null), null) 의 단축형입니다.

파라미터:

image - 기입해지는 RenderedImage

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IllegalArgumentException - image 가 null 의 경우

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

canWriteSequence

public boolean canWriteSequence()

벌써 헤더 정보를 포함해, 이전의 이미지일 가능성을 가지는 이미지 스트림에, 기입측이 이미지를 추가할 수 있는 경우,true 를 돌려줍니다.

canWriteSequence 가 false 를 돌려주는 경우,writeToSequence 와 endWriteSequence 는 UnsupportedOperationException 를 throw 합니다.

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

반환값:

이미지를 연속해 추가할 수 있는 경우 true

prepareWriteSequence

public void prepareWriteSequence(IIOMetadata  streamMetadata)
                          throws IOException 

다음에 계속되는 일련의 writeToSequence 호출을 받아들이기 위해서(때문에), 제공되는 스트림메타데이타객체를 사용해, 스트림을 준비합니다. 메타데이타가 이미지 데이터에 선행할 필요가 있는 경우, 이 메타데이타는 스트림에 기입해집니다. 인수가 null 의 경우, 데포르트스트림메타데이타가 사용됩니다.

출력이 ImageOutputStream 의 경우, 현재의 시크 위치 이전의 기존의 출력 내용은 플래시 되어 read 가능 또는 기입해 가능한 필요는 없습니다. 그 형식에서, 1 개의 TIFF 파일내의 일련의 이미지와 같이, 헤더 정보를 보수하기 위해서 endWriteSequence 가 감아 반환 할 수 있는 것이 필요한 경우, 이 메소드로 기입해지는 메타데이타는, 스트림의 기입 가능 부분에 존재할 필요가 있습니다. 다른 형식은, 이 메소드와 각 이미지의 나중에, 스트림을 플래시 할 수 있습니다.

canWriteSequence 가 false 를 돌려주는 경우, 이 메소드는 UnsupportedOperationException 를 throw 합니다.

출력은,setOutput 메소드를 사용해 미리 설정되어 있을 필요가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

streamMetadata - 스트림메타데이타객체, 또는 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canWriteSequence 가 false 를 돌려주는 경우

IOException - 스트림메타데이타의 기입으로 에러가 발생했을 경우

writeToSequence

public void writeToSequence(IIOImage  image,
                            ImageWriteParam  param)
                     throws IOException 

1 개의 이미지와 관련지을 수 있을 가능성이 있는 메타데이타와 썸네일를, 출력에 추가합니다. 출력이 ImageOutputStream 의 경우, 현재의 시크 위치 이전의 기존의 출력 내용은 플래시 되어endWriteSequence 가 불려 가는 (예를 들어 TIFF) 때에, 플러그 인이 헤더 정보를 보수할 수 있을 필요가 있는 경우를 제외해, read 가능 또는 기입해 가능한 필요는 없습니다.

canWriteSequence 가 false 를 돌려주는 경우, 이 메소드는 UnsupportedOperationException 를 throw 합니다.

출력은,setOutput 메소드를 사용해 미리 설정되어 있을 필요가 있습니다.

미리 prepareWriteSequence 가 불려 가고 있을 필요가 있어, 그렇지 않은 경우 IllegalStateException 가 throw 됩니다.

canWriteRasters 가 true 를 돌려주는 경우,IIOImage 는 Raster 소스를 포함할 수가 있습니다. 그렇지 않은 경우는,RenderedImage 소스를 포함할 필요가 있습니다.

제공되는 썸네일는, 필요하면 사이즈 변경되어 지원되는 수를 초과한 썸네일는, 모두 무시됩니다. 제공되지 않는 추가의 썸네일가 그 형식에서 필요한 경우, 기입측이 내부에서 생성합니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

image - 기입해지는 이미지, 썸네일, 및 메타데이타를 포함한 IIOImage 객체

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않았는지, prepareWriteSequence 가 불려 가지 않았던 경우

UnsupportedOperationException - canWriteSequence 가 false 를 돌려주는 경우

IllegalArgumentException - image 가 null 의 경우

UnsupportedOperationException - image 가 Raster 를 포함해,canWriteRasters 이 false 를 돌려주는 경우

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

endWriteSequence

public void endWriteSequence()
                      throws IOException 

prepareWriteSequence 로 시작되는 일련의 이미지의 기입을 완료합니다. 이미지의 처리의 마지막에 오는 스트림메타데이타는 모두 써내져 처리의 최초의 헤더 정보는, 필요하면 모두 보수됩니다. 출력이 ImageOutputStream 의 경우, 처리의 최후로 스트림메타데이타를 통과한 데이터는 플래시 되어 read 가능 또는 기입해 가능한 필요는 없습니다.

canWriteSequence 가 false 를 돌려주는 경우, 이 메소드는 UnsupportedOperationException 를 throw 합니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

예외:

IllegalStateException - 출력이 설정되어 있지 않았는지, prepareWriteSequence 가 불려 가지 않았던 경우

UnsupportedOperationException - canWriteSequence 가 false 를 돌려주는 경우

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

canReplaceStreamMetadata

public boolean canReplaceStreamMetadata()
                                 throws IOException 

벌써 출력에 존재하는 스트림메타데이타를 옮겨놓을 수 있는 경우,true 를 돌려줍니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,false 를 돌려줍니다.

반환값:

스트림메타데이타의 치환이 허가되는 경우 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IOException - 조회중에 입출력 에러가 발생했을 경우

replaceStreamMetadata

public void replaceStreamMetadata(IIOMetadata  streamMetadata)
                           throws IOException 

출력내의 스트림메타데이타를 신규 정보에 옮겨놓습니다. 출력이 ImageOutputStream 의 경우, 이전의 스트림 내용이 조사할 수 있어 가능한 한편집되어, 신규 데이터를 위한 장소를 만듭니다. 이전의 출력 내용은 모두, read와 기입을 위해서(때문에) 사용할 수 있을 필요가 있습니다.

canReplaceStreamMetadata 가 false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

streamMetadata - 스트림메타데이타를 나타내는 IIOMetadata 객체, 또는 디폴트 값를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canReplaceStreamMetadata 가 false 를 돌려주는 경우. 모드는 포함하지 않는다

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

canReplaceImageMetadata

public boolean canReplaceImageMetadata(int imageIndex)
                                throws IOException 

기존의 이미지에 관련지을 수 있었던 이메이지메타데이타를, 인덱스 imageIndex 에 옮겨놓을 수가 있는 경우,true 를 돌려줍니다. 이 메소드가 false 를 돌려주는 경우,replaceImageMetadata(imageIndex) 의 호출은 UnsupportedOperationException 를 throw 합니다.

이메이지메타데이타의 치환을 지원하지 않는 기입측은, 인덱스상에서의 범위의 체크를 실행하지 않고 false 를 돌려줄 수가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,imageIndex 의 값을 체크하지 않고 false 를 돌려줍니다.

파라미터:

imageIndex - 메타데이타를 옮겨놓을 수 있는 이미지의 인덱스

반환값:

지정된 이미지의 이메이지메타데이타가 옮겨놓고 할 수 있는 경우 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IndexOutOfBoundsException - 일반적으로, 기입측이 이메이지메타데이타의 치환을 지원해, imageIndex 가 0 미만, 또는 사용 가능한 최대의 인덱스보다 큰 경우

IOException - 조회중에 입출력 에러가 발생했을 경우

replaceImageMetadata

public void replaceImageMetadata(int imageIndex,
                                 IIOMetadata  imageMetadata)
                          throws IOException 

기존 이미지에 관련지을 수 있었던 이메이지메타데이타를 옮겨놓습니다.

canReplaceImageMetadata(imageIndex) 가 false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

imageIndex - 메타데이타를 옮겨놓을 수 있는 이미지의 인덱스

imageMetadata - 이메이지메타데이타를 나타내는 IIOMetadata 객체, 또는 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canReplaceImageMetadata 가 false 를 돌려준다 경우

IndexOutOfBoundsException - imageIndex 가 0 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

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

canInsertImage

public boolean canInsertImage(int imageIndex)
                       throws IOException 

지정된 인덱스에서의 신규 이미지의 삽입을 기입해 옆이 지원하는 경우,true 를 돌려줍니다. 삽입 인덱스 이상의 인덱스를 가지는 기존 이미지는, 스스로의 인덱스에 1 을 더합니다. imageIndex 의 값 -1 은, 현재의 최대 인덱스보다 1 큰 인덱스를 나타내기 위해서(때문에) 사용할 수 있습니다.

이미지 삽입을 지원하지 않는 기입측은, 인덱스상에서의 범위 체크를 실행하지 않고 false 를 돌려줄 수가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,imageIndex 의 값을 체크하지 않고 false 를 돌려줍니다.

파라미터:

imageIndex - 이미지가 삽입된다 인덱스

반환값:

지정된 인덱스로 이미지를 삽입할 수 있는 경우 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IndexOutOfBoundsException - 일반적으로, 기입측이 이미지 삽입을 지원해,imageIndex 가 -1 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IOException - 조회중에 입출력 에러가 발생했을 경우

writeInsert

public void writeInsert(int imageIndex,
                        IIOImage  image,
                        ImageWriteParam  param)
                 throws IOException 

기존 이미지 스트림에 신규 이미지를 삽입합니다. imageIndex 보다 큰 인덱스를 가지는 기존 이미지가 보관 유지되어 그 인덱스에는, 각각 1 이 더해집니다. imageIndex 의 값 -1 은, 이전의 최대 인덱스보다 1 큰 인덱스를 나타내기 위해서(때문에) 사용할 수 있습니다. 즉, 이것에 의해, 이미지가 논리적으로, 처리의 마지막에 추가됩니다. 출력이 ImageOutputStream 의 경우, 스트림 전체는, read 가능과 기입해 가능의 양쪽 모두일 필요가 있습니다.

canInsertImage(imageIndex) 이 false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

imageIndex - 이미지가 기입해지는 인덱스

image - 기입해지는 이미지, 썸네일, 및 메타데이타를 포함한 IIOImage 객체

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canInsertImage(imageIndex) 가 false 를 돌려주는 경우

IllegalArgumentException - image 가 null 의 경우

IndexOutOfBoundsException - imageIndex 가 -1 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

UnsupportedOperationException - image 가 Raster 를 포함해,canWriteRasters 이 false 를 돌려주는 경우

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

canRemoveImage

public boolean canRemoveImage(int imageIndex)
                       throws IOException 

기입측이, 지정된 인덱스에서의 기존 이미지의 삭제를 지원하는 경우,true 를 돌려줍니다. 삽입 인덱스보다 큰 인덱스를 가지는 기존 이미지는, 스스로의 인덱스로부터 1 을 뺍니다.

이미지 삭제를 지원하지 않는 기입측은, 인덱스상에서의 범위 체크를 실행하지 않고 false 를 돌려줄 수가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,imageIndex 의 값을 체크하지 않고 false 를 돌려줍니다.

파라미터:

imageIndex - 삭제되는 이미지의 인덱스

반환값:

지정된 이미지를 삭제할 수 있는 경우는 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IndexOutOfBoundsException - 일반적으로, 기입측이 이미지 삭제를 지원해,imageIndex 가 0 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IOException - 조회중에 입출력 에러가 발생했다 경우

removeImage

public void removeImage(int imageIndex)
                 throws IOException 

스트림로부터 이미지를 삭제합니다.

canRemoveImage(imageIndex) 이 false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

삭제에 의해, 실제의 파일 사이즈가 축소되는 경우로 여겨지지 않는 경우가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

imageIndex - 삭제되는 이미지의 인덱스

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canRemoveImage(imageIndex) 가 false 를 돌려주는 경우

IndexOutOfBoundsException - imageIndex 가 0 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IOException - 삭제중에 입출력 에러가 발생했다 경우

canWriteEmpty

public boolean canWriteEmpty()
                      throws IOException 

미정도리의 픽셀치를 가지는 1 개의 이미지와 관련지을 수 있었던 메타데이타와 썸네일로부터 완성되는, 완전한 이미지 스트림의 출력에의 기입을 기입해 옆이 지원하는 경우,true 를 돌려줍니다. 픽셀치는,replacePixels 메소드의 향후의 호출로 정의할 수 있습니다. 출력이 ImageOutputStream 의 경우, 현재의 시크 위치 이전의 기존의 내용은 영향을 받지 않고, read 가능 또는 기입해 가능한 필요는 없습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,false 를 돌려줍니다.

반환값:

나중에 정의되는 내용을 가지는 완전한 이미지 스트림의 기입이 지원되는 경우는 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IOException - 조회중에 입출력 에러가 발생했다 경우

prepareWriteEmpty

public void prepareWriteEmpty(IIOMetadata  streamMetadata,
                              ImageTypeSpecifier  imageType,
                              int width,
                              int height,
                              IIOMetadata  imageMetadata,
                              List <?  extends BufferedImage > thumbnails,
                              ImageWriteParam  param)
                       throws IOException 

미정도리의 픽셀치를 가지는 1 개의 이미지와 관련지을 수 있었던 메타데이타와 썸네일로부터 완성되는, 완전한 이미지 스트림의 출력에의 기입을 개시합니다. 픽셀치는,replacePixels 메소드의 향후의 호출로 정의됩니다. 출력이 ImageOutputStream 의 경우, 현재의 시크 위치 이전의 기존의 내용은 영향을 받지 않고, read 가능 또는 기입해 가능한 필요는 없습니다.

endWriteEmpty 의 호출이 발생할 때까지, 기입은 완전하지는 않습니다. prepareWriteEmpty 와 endWriteEmpty 의 호출동안에,prepareReplacePixels,replacePixels, 및 endReplacePixels 의 호출이 발생합니다. 다만,prepareWriteEmpty 의 호출은 상자로 할 수 있지 않고,prepareWriteEmpty 와 prepareInsertEmpty 의 호출은 삽입할 수 없습니다.

canWriteEmpty 이 false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

streamMetadata - 스트림메타데이타를 나타내는 IIOMetadata 객체, 또는 디폴트 값를 사용하기 위한 null

imageType - 이미지의 배치를 기술한다 ImageTypeSpecifier

width - 이미지의 폭

height - 이미지의 높이

imageMetadata - 이메이지메타데이타를 나타내는 IIOMetadata 객체, 또는 null

thumbnails - 이 이미지를 위한 BufferedImage 썸네일의 List, 또는 null

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canWriteEmpty 가 false 를 돌려주는 경우

IllegalStateException - 대응하는 endWriteEmpty 의 호출 없이 , 선행하는 prepareWriteEmpty 의 호출이 생성되었을 경우

IllegalStateException - 대응하는 endInsertEmpty 의 호출 없이 , 선행하는 prepareInsertEmpty 의 호출이 생성되었을 경우

IllegalArgumentException - imageType 가 null, 혹은 thumbnails 가 null 참조, 또는 BufferedImage 이외의 객체를 포함한 경우

IllegalArgumentException - 폭 또는 높이가 1 보다 작은 경우

IOException - 기입중에 입출력 에러가 발생했을 경우

endWriteEmpty

public void endWriteEmpty()
                   throws IOException 

이전의 prepareWriteEmpty 의 호출로 시작된, 신규 이미지의 기입을 완료합니다.

canWriteEmpty()false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canWriteEmpty(imageIndex) 가 false 를 돌려주는 경우

IllegalStateException - 대응하는 endWriteEmpty 의 호출 없음으로, 선행하는 prepareWriteEmpty 의 호출이 생성되지 않았던 경우

IllegalStateException - 대응하는 endInsertEmpty 의 호출 없음으로, 선행하는 prepareInsertEmpty 의 호출이 생성되었을 경우

IllegalStateException - 대응하는 endReplacePixels 의 호출 없이 , prepareReiplacePixels 의 호출이 생성되었을 경우

IOException - 기입중에 입출력 에러가 발생했을 경우

canInsertEmpty

public boolean canInsertEmpty(int imageIndex)
                       throws IOException 

지정된 인덱스에서의 신규의 빈 상태(empty) 이미지의 삽입을 기입해 옆이 지원하는 경우,true 를 돌려줍니다. 이미지의 픽셀치는 미정도리로,replacePixels 메소드를 사용해 세세하게 지정할 수 있습니다. 삽입 인덱스 이상의 인덱스를 가지는 기존 이미지는, 스스로의 인덱스에 1 을 더합니다. imageIndex 의 값 -1 은, 현재의 최대 인덱스보다 1 큰 인덱스를 나타내기 위해서(때문에) 사용할 수 있습니다.

빈 상태(empty) 이미지의 삽입을 지원하지 않는 기입측은, 인덱스상에서의 범위 체크를 실행하지 않고 false 를 돌려줄 수가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,imageIndex 의 값을 체크하지 않고 false 를 돌려줍니다.

파라미터:

imageIndex - 이미지가 삽입된다 인덱스

반환값:

지정된 인덱스로 빈 상태(empty) 이미지를 삽입할 수 있는 경우는 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IndexOutOfBoundsException - 일반적으로, 기입측이 빈 상태(empty) 이미지의 삽입을 지원해,imageIndex 가 -1 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IOException - 조회중에 입출력 에러가 발생했다 경우

prepareInsertEmpty

public void prepareInsertEmpty(int imageIndex,
                               ImageTypeSpecifier  imageType,
                               int width,
                               int height,
                               IIOMetadata  imageMetadata,
                               List <?  extends BufferedImage > thumbnails,
                               ImageWriteParam  param)
                        throws IOException 

미정도리의 픽셀치를 가지는 신규 이미지의, 기존 이미지 스트림에의 삽입을 개시합니다. imageIndex 보다 큰 인덱스를 가지는 기존 이미지가 보관 유지되어 그 인덱스에는, 각각 1 이 더해집니다. imageIndex 의 값 -1 은, 이전의 최대 인덱스보다 1 큰 인덱스를 나타내기 위해서(때문에) 사용할 수 있습니다. 즉, 이것에 의해, 이미지가 논리적으로, 처리의 마지막에 추가됩니다. 출력이 ImageOutputStream 의 경우, 스트림 전체는, read 가능과 기입해 가능의 양쪽 모두일 필요가 있습니다.

이미지의 내용은,replacePixels 메소드를 사용해 나중에 제공할 수 있겠습니다. endInsertEmpty 의 호출이 발생할 때까지, 삽입은 완전하지는 않습니다. prepareReplacePixels,replacePixels,endReplacePixels 의 호출은,prepareInsertEmpty 와 endInsertEmpty 의 호출동안에 발생합니다. 다만,prepareInsertEmpty 의 호출은 상자로 할 수 있지 않고,prepareWriteEmpty 와 prepareInsertEmpty 의 호출은 삽입할 수 없습니다.

canInsertEmpty(imageIndex) 이 false 를 돌려주는 경우,UnsupportedOperationException 가 throw 됩니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

imageIndex - 이미지가 기입해지는 인덱스

imageType - 이미지의 배치를 기술한다 ImageTypeSpecifier

width - 이미지의 폭

height - 이미지의 높이

imageMetadata - 이메이지메타데이타를 나타내는 IIOMetadata 객체, 또는 null

thumbnails - 이 이미지를 위한 BufferedImage 썸네일의 List, 또는 null

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canInsertEmpty(imageIndex) 가 false 를 돌려주는 경우

IndexOutOfBoundsException - imageIndex 가 -1 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IllegalStateException - 대응하는 endInsertEmpty 의 호출 없음으로, 선행하는 prepareInsertEmpty 의 호출이 생성되었을 경우

IllegalStateException - 대응하는 endWriteEmpty 의 호출 없음으로, 선행하는 prepareWriteEmpty 의 호출이 생성되었을 경우

IllegalArgumentException - imageType 가 null, 혹은 thumbnails 가 null 참조, 또는 BufferedImage 이외의 객체를 포함한 경우

IllegalArgumentException - 폭 또는 높이가 1 보다 작은 경우

IOException - 기입중에 입출력 에러가 발생했을 경우

endInsertEmpty

public void endInsertEmpty()
                    throws IOException 

이전의 prepareInsertEmpty 의 호출로 시작된, 신규 이미지의 삽입을 완료합니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canInsertEmpty(imageIndex) 가 false 를 돌려주는 경우

IllegalStateException - 대응하는 endInsertEmpty 의 호출 없음으로, 선행하는 prepareInsertEmpty 의 호출이 생성되지 않았던 경우

IllegalStateException - 대응하는 endWriteEmpty 의 호출 없음으로, 선행하는 prepareWriteEmpty 의 호출이 생성되었을 경우

IllegalStateException - 대응하는 endReplacePixels 의 호출 없이 , prepareReplacePixels 의 호출이 생성되었을 경우

IOException - 기입중에 입출력 에러가 발생했을 경우

canReplacePixels

public boolean canReplacePixels(int imageIndex)
                         throws IOException 

기입측에서,replacePixels 메소드를 사용해, 지정된 이미지의 픽셀의 치환을 허가하는 경우,true 를 돌려줍니다.

픽셀의 치환을 지원하지 않는 기입측은, 인덱스상에서의 범위 체크를 실행하지 않고 false 를 돌려줄 수가 있습니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,imageIndex 의 값을 체크하지 않고 false 를 돌려줍니다.

파라미터:

imageIndex - 픽셀을 옮겨놓을 수 있는 이미지의 인덱스

반환값:

지정된 이미지의 픽셀을 옮겨놓을 수가 있는 경우는 true

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

IndexOutOfBoundsException - 일반적으로, 기입측이 픽셀의 치환을 지원해,imageIndex 가 0 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IOException - 조회중에 입출력 에러가 발생했을 경우

prepareReplacePixels

public void prepareReplacePixels(int imageIndex,
                                 Rectangle  region)
                          throws IOException 

replacePixels 메소드의 일련의 호출을 처리하기 위해서, 기입측을 준비합니다. 영향을 받는 픽셀 영역은, 제공된 영역에 대해서 클립 됩니다.

canReplacePixels 가 false 를 돌려주어,UnsupportedOperationException 가 throw 되는 경우입니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

imageIndex - 픽셀을 옮겨놓을 수 있는 이미지의 인덱스

region - 후의 픽셀 범위의 클리핑에 사용된다 Rectangle

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canReplacePixels(imageIndex) 가 false 를 돌려주는 경우

IndexOutOfBoundsException - imageIndex 가 0 미만, 또는 사용 가능한 최대 인덱스보다 큰 경우

IllegalStateException - 대응하는 endReplacePixels 의 호출 없이 , 선행하는 prepareReplacePixels 의 의 호출이 있다 (즉, 상자가 허가되지 않는다) 경우

IllegalArgumentException - region 가 null, 또는 1 미만의 폭 또는 높이를 가지는 경우

IOException - 준비중에 입출력 에러가 발생했다 경우

replacePixels

public void replacePixels(RenderedImage  image,
                          ImageWriteParam  param)
                   throws IOException 

벌써 출력내에 있는 이미지의 일부를, 지정된 이미지의 일부에 옮겨놓습니다. 이미지 데이터는, 기존 이미지의 이미지 배치와 일치하는지, 또는 옮겨놓을 수 있을 필요가 있습니다.

출력처 범위는 param 인수로 지정되어 이미지 범위에 클립 되어, 그 범위는 prepareReplacePixels 에 제공됩니다. 적어도 소스의 1 개의 픽셀은, 클립 해서는 안됩니다. 그렇게 하지 않으면 예외가 throw 됩니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

메소드는,prepareReplacePixels 의 호출 후에게만 호출할 수가 있어 그렇지 않은 경우 IllegalStateException 가 throw 됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

image - 소스 픽셀을 포함한다 RenderedImage

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canReplacePixels(imageIndex) 가 false 를 돌려주는 경우

IllegalStateException - 대응하는 endReplacePixels 의 호출 없음으로, 선행하는 prepareReplacePixels 의 호출이 없는 경우

IllegalArgumentException - 다음의 어느 쪽인가에 들어맞는 경우

• image 가 null 이다.
• param 가 null 이다.
• 교차한 범위에 픽셀이 1 개도 포함되지 않는다.
• image 의 배치가 기존의 이미지 배치에 일치하지 않는지, 이 기입측에서 배치를 기존의 이미지 배치로 옮겨지지 않는다.

IOException - 기입중에 입출력 에러가 발생했을 경우

replacePixels

public void replacePixels(Raster  raster,
                          ImageWriteParam  param)
                   throws IOException 

벌써 출력내에 있는 이미지의 일부를, 지정된 Raster 의 일부에 옮겨놓습니다. 이미지 데이터는, 기존 이미지의 이미지 배치와 일치하는지, 또는 옮겨놓을 수 있을 필요가 있습니다.

기입 처리를 제어하기 위해서,ImageWriteParam 를 옵션으로 제공할 수 있습니다. param 가 null 의 경우, 디폴트의 기입 param 가 사용됩니다.

출력처 범위는 param 인수로 지정되어 이미지 범위에 클립 되어, 그 범위는 prepareReplacePixels 에 제공됩니다. 적어도 소스의 1 개의 픽셀은, 클립 해서는 안됩니다. 그렇게 하지 않으면 예외가 throw 됩니다.

지정된 ImageWriteParam 에, 이 기입측이 지원하지 않는 옵션 설정치 (프로그래시브 인코딩이나 형식 고유의 설정등)가 포함되는 경우, 그것들은 무시됩니다.

메소드는,prepareReplacePixels 의 호출 후에게만 호출할 수가 있어 그렇지 않은 경우 IllegalStateException 가 throw 됩니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

파라미터:

raster - 소스 픽셀을 포함한다 Raster

param - ImageWriteParam, 또는 디폴트 ImageWriteParam 를 사용하기 위한 null

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canReplacePixels(imageIndex) 가 false 를 돌려주는 경우

IllegalStateException - 대응하는 endReplacePixels 의 호출 없음으로, 선행하는 prepareReplacePixels 의 호출이 없는 경우

UnsupportedOperationException - canWriteRasters 가 false 를 돌려주는 경우

IllegalArgumentException - 다음의 어느 쪽인가에 들어맞는 경우

• raster 가 null 이다.
• param 가 null 이다.
• 교차한 범위에 픽셀이 1 개도 포함되지 않는다.
• raster 의 배치가 기존의 이미지 배치에 일치하지 않는지, 이 기입측에서 배치를 기존의 이미지 배치로 옮겨지지 않는다.

IOException - 기입중에 입출력 에러가 발생했을 경우

endReplacePixels

public void endReplacePixels()
                      throws IOException 

replacePixels 의 호출 처리를 종료합니다.

canReplacePixels 가 false 를 돌려주어,UnsupportedOperationException 가 throw 되는 경우입니다.

출력이 null 의 경우, 디폴트 구현은 IllegalStateException 을 throw 해, 그렇지 않은 경우는,UnsupportedOperationException 를 throw 합니다.

예외:

IllegalStateException - 출력이 설정되어 있지 않다 경우

UnsupportedOperationException - canReplacePixels(imageIndex) 가 false 를 돌려주는 경우

IllegalStateException - 대응하는 endReplacePixels 의 호출 없음으로, 선행하는 prepareReplacePixels 의 호출이 없는 경우

IOException - 기입중에 입출력 에러가 발생했을 경우

abort

public void abort()

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

기입측은, 각 기입 조작의 초에 clearAbortRequest 를 호출해, 기입중에 정기적으로 abortRequested 의 값을 폴링 할 필요가 있습니다.

abortRequested

protected boolean abortRequested()

기입측이 인스턴스화 된, 또는 clearAbortRequest 가 불려 갔기 때문에, 현재의 기입 조작의 중지 요구가 나왔을 경우,true 를 돌려줍니다.

반환값:

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

관련 항목:

abort() , clearAbortRequest()

clearAbortRequest

protected void clearAbortRequest()

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

관련 항목:

abort() , abortRequested()

addIIOWriteWarningListener

public void addIIOWriteWarningListener(IIOWriteWarningListener  listener)

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

파라미터:

listener - 등록된다 IIOWriteWarningListener

관련 항목:

removeIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)

removeIIOWriteWarningListener

public void removeIIOWriteWarningListener(IIOWriteWarningListener  listener)

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

파라미터:

listener - 등록을 삭제된다 IIOWriteWarningListener

관련 항목:

addIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)

removeAllIIOWriteWarningListeners

public void removeAllIIOWriteWarningListeners()

현재 등록된 IIOWriteWarningListener 객체를 모두 삭제합니다.

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

addIIOWriteProgressListener

public void addIIOWriteProgressListener(IIOWriteProgressListener  listener)

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

파라미터:

listener - 등록된다 IIOWriteProgressListener

관련 항목:

removeIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)

removeIIOWriteProgressListener

public void removeIIOWriteProgressListener(IIOWriteProgressListener  listener)

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

파라미터:

listener - 등록을 삭제된다 IIOWriteProgressListener

관련 항목:

addIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)

removeAllIIOWriteProgressListeners

public void removeAllIIOWriteProgressListeners()

현재 등록된 IIOWriteProgressListener 객체를 모두 삭제합니다.

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

processImageStarted

protected void processImageStarted(int imageIndex)

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

파라미터:

imageIndex - 기입해지려 하고 있는 이미지의 인덱스

processImageProgress

protected void processImageProgress(float percentageDone)

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

파라미터:

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

processImageComplete

protected void processImageComplete()

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

processThumbnailStarted

protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)

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

파라미터:

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

thumbnailIndex - 썸네일의 인덱스

processThumbnailProgress

protected void processThumbnailProgress(float percentageDone)

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

파라미터:

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

processThumbnailComplete

protected void processThumbnailComplete()

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

processWriteAborted

protected void processWriteAborted()

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

processWarningOccurred

protected void processWarningOccurred(int imageIndex,
                                      String  warning)

등록된 모든 IIOWriteWarningListener 에 대해, 그 warningOccurred 메소드를 호출하는 것으로, 경고 메세지를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

imageIndex - 경고가 발생하는 이미지의 인덱스

warning - 경고 메세지

예외:

IllegalArgumentException - warning 가 null 의 경우

processWarningOccurred

protected void processWarningOccurred(int imageIndex,
                                      String  baseName,
                                      String  keyword)

등록된 모든 IIOWriteWarningListener 에 대해,ResourceBundle 로부터 취득한 캐릭터 라인을 사용해 그 warningOccurred 메소드를 호출하는 것으로, 로컬라이즈 된 경고 메세지를 통지합니다. 서브 클래스는, 필요에 따라서 이 메소드를 사용할 수 있습니다.

파라미터:

imageIndex - 경고가 발생하는 이미지의 인덱스

baseName - 로컬라이즈 된 경고 메세지를 포함한다 ResourceBundle 의 세트의 베이스명

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

예외:

IllegalArgumentException - baseName 가 null 의 경우

IllegalArgumentException - keyword 가 null 의 경우

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

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

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

reset

public void reset()

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

디폴트 구현에서는,setOutput(null),setLocale(null),removeAllIIOWriteWarningListeners(),removeAllIIOWriteProgressListeners(),clearAbortRequest 를 호출합니다.

dispose

public void dispose()

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

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

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