javax.imageio
클래스 ImageWriteParam

java.lang.Object 
  javax.imageio.IIOParam 
      javax.imageio.ImageWriteParam

알려진 직계 서브 클래스:

BMPImageWriteParam, JPEGImageWriteParam

public class ImageWriteParam
extends IIOParam 

스트림의 encode의 방법을 기술하는 클래스입니다. 이 클래스 또는 서브 클래스의 인스턴스는 ImageWriter 인스턴스에 규정의 「방법」에 대한 정보를 제공하기 위해서 사용됩니다.

특정의 이미지 형식을 위한 플러그 인으로 이 클래스의 서브 클래스를 정의해, ImageWriter가 구현하는 getDefaultWriteParam 메서드로부터 그 클래스의 객체를 돌려줄 수가 있습니다. 예를 들어 빌트인 JPEG 출력측 플러그 인은, javax.imageio.plugins.jpeg.JPEGImageWriteParam 인스턴스를 리턴합니다.

출력하는 이미지의 범위는 우선 IIOParam.setSourceRegion가 있으면, 이것이 지정하는 구형과 이미지의 실제의 범위가 교차하는 것으로써 결정됩니다. 생성되는 구형의넓이 또는 높이가 0인 경우, 출력측은 IIOException을 Throw 합니다. 교차가 있는 경우, 최초로 서브 샘플 된 픽셀로 출력이 시작되어, IIOParam.setSourceSubsampling 로 지정되는 수평 및 수직의 서브 샘플링 계수에 따라, 교차한 범위내에 추가의 픽셀을 짜넣습니다.

타일링, 프로그래시브 인코딩, 압축과 같은 개개의 기능은 4개의 모드 가운데 1개 로 설정할 수 있습니다. MODE_DISABLED는 기능을 사용 불가로 합니다. MODE_DEFAULT는 출력측에서 제어되는 파라미터값로 기능을 사용 가능하게 합니다. MODE_EXPLICIT는 기능을 사용 가능하게 해, 추가 파라미터를 제공하기 위한 set 메서드를 사용 가능하게 합니다. MODE_COPY_FROM_METADATA는 출력 측에 건네받는 스트림과 이메이지메타데이타오브제크트로부터, 해당하는 파라미터값를 카피합니다. 모든 기능의 디폴트는 MODE_COPY_FROM_METADATA 입니다. 표준 이외의 기능을 서브 클래스내에서 제공하는 것은 추천 합니다만, 같은 schema의 사용에는 불필요합니다.

플러그 인의 라이터는 플러그 인 고유의 추가의 인터페이스를 구현하는 서브 클래스를 제공하는 것으로써, ImageWriteParam 기능을 확장할 수 있습니다. 어느 인터페이스가 이용 가능한가 그것이 어떻게 사용될까는 플러그 인에 합니다. 출력측에서는 인식하지 않는 ImageWriteParam 서브 클래스의 확장 기능은 그대로 무시합니다. 또, getDefaultWriteParam를 개입시켜, 라이터 자체의 ImageWriteParam인스턴스를 작성하는 경우, 보통, 사용 불가인 옵션 기능은 모두 무시됩니다.

쿼리메서드는 장래를 위해서 준비되어 있는 경우를 제외해, ImageWriter 모든 구현으로 지원 될 필요가 있습니다. 예를 들어 프로그래시브 인코딩은 생략 가능하지만, 서브 샘플링은 지원 될 필요가 있습니다.

관련 항목:

ImageReadParam

필드 개요

protected boolean	canOffsetTiles 이 ImageWriteParam로 타일링 구라두 좌표 파라미터를 설정할 수 있는 경우에 true가 되는 boolean 입니다.
protected boolean	canWriteCompressed 이 출력측이, 압축을 사용해 이미지를 출력할 수 있는 경우에 true가 되는 boolean 입니다.
protected boolean	canWriteProgressive 이 ImageWriteParam로 품질 패스를 증가시키는 단계적인 처리로서 이미지의 write를 할 수 있는 경우에 true가 되는 boolean 입니다.
protected boolean	canWriteTiles 이 ImageWriteParam로 타일의 폭과 높이의 파라미터를 설정할 수 있는 경우에 true가 되는 boolean 입니다.
protected int	compressionMode 압축 설정을 제어하는 모드로 4개의 MODE_*값의 1개 로 설정할 필요가 있습니다.
protected float	compressionQuality 현재의 압축 품질 설정을 포함한 float 입니다.
protected String	compressionType 현재의 압축 방식명을 포함한 String로 설정되어 있지 않은 경우는 null 입니다.
protected String []	compressionTypes 사용 가능한 압축 방식명을 포함한 String 배열입니다.
protected Locale	locale 압축 방식명과 품질 개요를 지역 대응으로 하기 위해서 사용되는 Locale, 혹은 디폴트의 Locale를 사용하기 위한 null 입니다.
static int	MODE_COPY_FROM_METADATA 향후의 출력 기능을 사용 가능하게 하기 위해서 setTilingMode, setProgressiveMode, 또는 setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다.
static int	MODE_DEFAULT 향후의 출력 기능을 사용 가능하게 하기 위해서 setTilingMode, setProgressiveMode, setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다.
static int	MODE_DISABLED 향후의 출력 기능을 사용 불가로 하기 위해서 setTilingMode, setProgressiveMode, setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다.
static int	MODE_EXPLICIT 향후의 출력 기능을 사용 가능하게 하기 위해서 setTilingMode 또는 setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다.
protected Dimension []	preferredTileSizes 적절한 타일 사이즈의 범위 페어의 배열입니다.
protected int	progressiveMode 프로그래시브 인코딩을 제어하는 모드로MODE_EXPLICIT 이외의 4개의 MODE_*값의 1개를 설정할 필요가 있습니다.
protected int	tileGridXOffset 타일링이 설정되어 있는 경우, 이미지의 기점으로부터 타일 구라두의 원점까지의 수평 좌표에서의 거리로 설정되어 있지 않은 경우는 0 입니다.
protected int	tileGridYOffset 타일링이 설정되어 있는 경우, 이미지의 기점으로부터 타일 구라두의 원점까지의 수직 좌표에서의 거리로 설정되어 있지 않은 경우는 0 입니다.
protected int	tileHeight 타일링이 설정되어 있는 경우는 각 타일의 높이가 되어, 설정되어 있지 않은 경우는 0 이 됩니다.
protected int	tileWidth 타일링이 설정되어 있는 경우는 각 타일의 폭이 되어, 설정되어 있지 않은 경우는 0 이 됩니다.
protected int	tilingMode 타일링 설정을 제어하는 모드로 4개의 MODE_*값의 1개 로 설정할 필요가 있습니다.
protected boolean	tilingSet 타일링 파라미터가 가리키는 경우에 true가 되는 boolean 입니다.

클래스 javax.imageio. IIOParam 로부터 상속된 필드

controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

생성자 개요

protected	ImageWriteParam () 비어있는 ImageWriteParam를 구축합니다.
	ImageWriteParam (Locale locale) 주어진 Locale를 사용하기 위해서 설정되는 ImageWriteParam를 구축합니다.

메서드 개요

boolean	canOffsetTiles () 라이터가 출력안에 0 이외의 구라두 좌표로 타일링을 실행할 수 있는 경우에 true를 리턴합니다.
boolean	canWriteCompressed () 이 출력측이 압축을 지원하는인 경우, true를 리턴합니다.
boolean	canWriteProgressive () 품질을 단계적으로 향상시키는 일련의 패스로서 Writer가 출력 이미지를 써낼 수 있는인 경우에 true를 리턴합니다.
boolean	canWriteTiles () 라이터가 출력안에 타일링을 실행할 수 있는 경우, true를 리턴합니다.
float	getBitRate (float quality) 입력 이미지 데이터의 각 비트에 대해서 주어진 품질 레벨로 출력 데이터의 비트수의 견적을 나타내는 float를 리턴합니다.
int	getCompressionMode () 압축이 지원 되는 경우, 현재의 압축 모드를 리턴합니다.
float	getCompressionQuality () 현재의 압축 품질 설정을 리턴합니다.
String []	getCompressionQualityDescriptions () 압축 품질 레벨의 표시 또는 설정을 위해서 사용자 인터페이스의 일부로서 getCompressionQualityValues와 함께 사용할 수 있는 String 배열을 리턴합니다.
float[]	getCompressionQualityValues () 압축 품질 레벨의 표시 또는 설정을 위한 사용자 인터페이스의 일부로서getCompressionQualityDescriptions와 함께 사용할 수 있는 float 배열을 리턴합니다.
String	getCompressionType () 현재 설정된 압축 방식을 돌려주는지, 아무것도 설정되어 있지 않은 경우는 null을 리턴합니다.
String []	getCompressionTypes () 사용 가능한 압축 방식의 리스트를 배열 또는 String로 서 돌려주고, 이러한 인터페이스를 사용해 압축 방식을 선택할 수 없는 경우에 null을 리턴합니다.
Locale	getLocale () 현재 설정되어 있는 Locale를 돌려주는 경우, 혹은 디폴트 Locale 만이 지원 되고 있는 경우는 null이 됩니다.
String	getLocalizedCompressionTypeName () getLocale가 돌려준 Locale를 사용해, 현재의 압축 방식의 지역 대응된 이름을 리턴합니다.
Dimension []	getPreferredTileSizes () 타일이 출력 파일 또는 스트림로 encode 될 때, 타일의 정규의 사이즈 범위를 나타내는 Dimension 배열을 리턴합니다.
int	getProgressiveMode () 프로그래시브 방식에서 스트림을 출력하기 위한, 현재의 모드를 리턴합니다.
int	getTileGridXOffset () 이미지가 출력 스트림에 출력해질 때, 이미지의 수평 타일 구라두 좌표를 리턴합니다.
int	getTileGridYOffset () 이미지가 출력 스트림에 출력해질 때, 이미지의 수직 타일 구라두 좌표를 리턴합니다.
int	getTileHeight () 이미지가 출력 스트림에 출력해질 때, 이미지내의 각 타일의 높이를 리턴합니다.
int	getTileWidth () 이미지가 출력 스트림에 출력해질 때, 이미지내의 각 타일의 넓이를 리턴합니다.
int	getTilingMode () 타일링이 지원 되고 있는 경우, 현재의 타일링 모드를 리턴합니다.
boolean	isCompressionLossless () 현재의 압축 방식이, 손실 없음 압축을 제공하는 경우, true를 리턴합니다.
void	setCompressionMode (int mode) 압축을 실행할지 어떨지를 지정해, 실행하는 경우는 압축 파라미터의 지정 방법을 결정합니다.
void	setCompressionQuality (float quality) 압축 품질을 0에 서 1 사이의 값으로 설정합니다.
void	setCompressionType (String compressionType) getCompressionTypes로 나타나는 값의 1개에 압축 방식을 설정합니다.
void	setProgressiveMode (int mode) 품질을 향상시키는 일련의 스캔이 스트림에 포함되는 것 같은 프로그래시브 모드로 출력측이 이미지를 써내는 것을 지정합니다.
void	setTiling (int tileWidth, int tileHeight, int tileGridXOffset, int tileGridYOffset) 이미지가 출력 스트림내에서 타일링 되도록 지정합니다.
void	setTilingMode (int mode) 이미지를 출력 스트림중에 타일링 하는지, 또 타일링 하는 경우에는 타일링 파라미터의 지정 방법을 지정합니다.
void	unsetCompression () 이전의 압축 방식과 품질 설정을 모두 삭제합니다.
void	unsetTiling () setTiling에 의 호출로 지정되는 이전의 타일 구라두 파라미터를 모두 삭제합니다.

클래스 javax.imageio. IIOParam 로부터 상속된 메서드

activateController, getController, getDefaultController, getDestinationOffset, getDestinationType, getSourceBands, getSourceRegion, getSourceXSubsampling, getSourceYSubsampling, getSubsamplingXOffset, getSubsamplingYOffset, hasController, setController, setDestinationOffset, setDestinationType, setSourceBands, setSourceRegion, setSourceSubsampling

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

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

필드의 상세

MODE_DISABLED

public static final int MODE_DISABLED

향후의 출력 기능을 사용 불가로 하기 위해서 setTilingMode, setProgressiveMode, setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다. 즉, 이 모드가 설정되어 있는 경우, 스트림의 타일링, 프로그래시브 인코딩, 또는 압축은행해지지 않고, 해당하는 액세스용 메서드는 IllegalStateException을 Throw 합니다.

관련 항목:

MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), 정수 필드값

MODE_DEFAULT

public static final int MODE_DEFAULT

향후의 출력 기능을 사용 가능하게 하기 위해서 setTilingMode, setProgressiveMode, setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다. 즉, 이 모드가 사용 가능한 경우, 출력측이 플러그 인에 존한 방법으로 내부에서 선택한 실제적인 디폴트에 따라, 스트림의 타일링, 프로그래시브 인코딩, 또는 압축을의해 해당하는 액세스용 메서드는 IllegalStateException을 Throw 합니다.

관련 항목:

MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), 정수 필드값

MODE_EXPLICIT

public static final int MODE_EXPLICIT

향후의 출력 기능을 사용 가능하게 하기 위해서 setTilingMode 또는 setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다. 즉, 이 모드가 설정되어 있는 경우, 이 클래스내의 대응하는 set 메서드가 제공해, 대응하는 get 메서드로부터 취득할 수 있는 추가 정보에 따라, 스트림의 타일링 또는 압축을 합니다. 이 모드는 단계적인 출력으로는 지원 되지 않습니다.

관련 항목:

MODE_DISABLED, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), 정수 필드값

MODE_COPY_FROM_METADATA

public static final int MODE_COPY_FROM_METADATA

향후의 출력 기능을 사용 가능하게 하기 위해서 setTilingMode, setProgressiveMode, 또는 setCompressionMode와 같은 메서드에 건네줄 수 있는 정수값 입니다. 즉, 이 모드가 사용 가능한 경우, 출력 조작에게 건네지는 이메이지메타데이타 또는 스트림의 컨텐츠, 혹은 그 양쪽 모두의 컨텐츠에 기반해 스트림의 타일링, 프로그래시브 인코딩, 또는 압축을의해 해당하는 액세스용 메서드는 IllegalStateException을 Throw 합니다.

이것은 모든 기능의 디폴트 모드이므로 메타데이타를 포함한 read에 이어 메타데이타를 포함한 write를 실시하면, 가능한 한 많은 정보가 보존됩니다.

관련 항목:

MODE_DISABLED, MODE_EXPLICIT, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode(), setTilingMode(int), getTilingMode(), setCompressionMode(int), getCompressionMode(), 정수 필드값

canWriteTiles

protected boolean canWriteTiles

이 ImageWriteParam로 타일의 폭과 높이의 파라미터를 설정할 수 있는 경우에 true가 되는 boolean 입니다. 기본값는 false 입니다. 서브 클래스에서는 값을 수동으로 설정할 필요가 있습니다.

타일의 write를 지원 하지 않는 서브 클래스에서는 이 값을 false로 설정할 필요가 있습니다.

tilingMode

protected int tilingMode

타일링 설정을 제어하는 모드로 4개의 MODE_*값의 1개 로 설정할 필요가 있습니다. 디폴트는 MODE_COPY_FROM_METADATA 입니다.

타일의 write를 실시하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

관련 항목:

MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setTilingMode(int), getTilingMode()

preferredTileSizes

protected Dimension [] preferredTileSizes

적절한 타일 사이즈의 범위 페어의 배열입니다. 기본값는 null로 이것은 적절한 사이즈가 없는 것을 나타냅니다. 값이 null이 아닌 경우, 2 이상의 같은 길이를 가질 필요가 있습니다.

타일의 write를 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

관련 항목:

getPreferredTileSizes()

tilingSet

protected boolean tilingSet

타일링 파라미터가 가리키는 경우에 true가 되는 boolean 입니다.

타일의 write를 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

tileWidth

protected int tileWidth

타일링이 설정되어 있는 경우는 각 타일의 폭이 되어, 설정되어 있지 않은 경우는 0 이 됩니다.

타일링을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

tileHeight

protected int tileHeight

타일링이 설정되어 있는 경우는 각 타일의 높이가 되어, 설정되어 있지 않은 경우는 0 이 됩니다. 초기값 는 0 입니다.

타일링을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

canOffsetTiles

protected boolean canOffsetTiles

이 ImageWriteParam로 타일링 구라두 좌표 파라미터를 설정할 수 있는 경우에 true가 되는 boolean 입니다. 기본값는 false 입니다. 서브 클래스에서는 값을 수동으로 설정할 필요가 있습니다.

타일의 write를 지원 하지 않는 또는 write를 지원 해도, 타일의 좌표화를 지원 하지 않는 서브 클래스에서는 이 값은 false로 설정할 필요가 있습니다.

tileGridXOffset

protected int tileGridXOffset

타일링이 설정되어 있는 경우, 이미지의 기점으로부터 타일 구라두의 원점까지의 수평 좌표에서의 거리로 설정되어 있지 않은 경우는 0 입니다. 초기값 는 0 입니다.

타일의 좌표화를 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

tileGridYOffset

protected int tileGridYOffset

타일링이 설정되어 있는 경우, 이미지의 기점으로부터 타일 구라두의 원점까지의 수직 좌표에서의 거리로 설정되어 있지 않은 경우는 0 입니다. 초기값 는 0 입니다.

타일의 좌표화를 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

canWriteProgressive

protected boolean canWriteProgressive

이 ImageWriteParam로 품질 패스를 증가시키는 단계적인 처리로서 이미지의 write를 할 수 있는 경우에 true가 되는 boolean 입니다. 기본값는 false 입니다. 서브 클래스에서는 값을 수동으로 설정할 필요가 있습니다.

프로그래시브 인코딩을 지원 하지 않는 서브 클래스에서는 이 값은 false로 설정할 필요가 있습니다.

progressiveMode

protected int progressiveMode

프로그래시브 인코딩을 제어하는 모드로MODE_EXPLICIT 이외의 4개의 MODE_*값의 1개를 설정할 필요가 있습니다. 디폴트는 MODE_COPY_FROM_METADATA 입니다.

프로그래시브 인코딩을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

관련 항목:

MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setProgressiveMode(int), getProgressiveMode()

canWriteCompressed

protected boolean canWriteCompressed

이 출력측이, 압축을 사용해 이미지를 출력할 수 있는 경우에 true가 되는 boolean 입니다. 기본값는 false 입니다. 서브 클래스에서는 값을 수동으로 설정할 필요가 있습니다.

압축을 지원 하지 않는 서브 클래스에서는 이 값은 false로 설정할 필요가 있습니다.

compressionMode

protected int compressionMode

압축 설정을 제어하는 모드로 4개의 MODE_*값의 1개 로 설정할 필요가 있습니다. 디폴트는 MODE_COPY_FROM_METADATA 입니다.

압축을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

관련 항목:

MODE_DISABLED, MODE_EXPLICIT, MODE_COPY_FROM_METADATA, MODE_DEFAULT, setCompressionMode(int), getCompressionMode()

compressionTypes

protected String [] compressionTypes

사용 가능한 압축 방식명을 포함한 String 배열입니다. 서브 클래스에서는 값을 수동으로 설정할 필요가 있습니다.

압축을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

compressionType

protected String  compressionType

현재의 압축 방식명을 포함한 String로 설정되어 있지 않은 경우는 null 입니다.

압축을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

compressionQuality

protected float compressionQuality

현재의 압축 품질 설정을 포함한 float 입니다. 초기값 는 1.0F 입니다.

압축을 지원 하지 않는 서브 클래스에서는 이 값을 무시할 수 있습니다.

locale

protected Locale  locale

압축 방식명과 품질 개요를 지역 대응으로 하기 위해서 사용되는 Locale, 혹은 디폴트의 Locale를 사용하기 위한 null 입니다. 서브 클래스에서는 값을 수동으로 설정할 필요가 있습니다.

생성자 상세

ImageWriteParam

protected ImageWriteParam()

비어있는 ImageWriteParam를 구축합니다. 인스턴스 변수를 적절히 설정하는 것은 서브 클래스의 일이 됩니다.

ImageWriteParam

public ImageWriteParam(Locale  locale)

주어진 Locale를 사용하기 위해서 설정되는 ImageWriteParam를 구축합니다.

파라미터:

locale - 압축 방식명과 품질 개요를 지역 대응으로 하기 위해서 사용되는 Locale, 또는 null

메서드의 상세

getLocale

public Locale  getLocale()

현재 설정되어 있는 Locale를 돌려주는 경우, 혹은 디폴트 Locale 만이 지원 되고 있는 경우는 null이 됩니다.

반환값:

현재의 Locale 또는 null

canWriteTiles

public boolean canWriteTiles()

라이터가 출력안에 타일링을 실행할 수 있는 경우, true를 리턴합니다. 이 메서드가 false를 돌려주는 경우, setTiling가 UnsupportedOperationException을 Throw 합니다.

반환값:

출력측이 타일링을 지원하는인 경우는 true

관련 항목:

canOffsetTiles(), setTiling(int, int, int, int)

canOffsetTiles

public boolean canOffsetTiles()

라이터가 출력안에 0 이외의 구라두 좌표로 타일링을 실행할 수 있는 경우에 true를 리턴합니다. 이 메서드가 false를 돌려주는 경우, 구라두 좌표의 인수가 어느쪽이나 0 이 아닐 때, setTiling는 UnsupportedOperationException을 Throw 합니다. canWriteTiles가 false를 돌려주는 경우, 이 메서드도 false를 리턴합니다.

반환값:

출력측이 0 이외의 타일 좌표를 지원하는인 경우는 true

관련 항목:

canWriteTiles(), setTiling(int, int, int, int)

setTilingMode

public void setTilingMode(int mode)

이미지를 출력 스트림중에 타일링 하는지, 또 타일링 하는 경우에는 타일링 파라미터의 지정 방법을 지정합니다. 모드는 아래와 같이 해석됩니다.

• MODE_DISABLED - 이미지는 타일링 되지 않는다. setTiling는 IllegalStateException을 Throw 한다
• MODE_DEFAULT - 이미지는 디폴트 패러미터를 사용해 타일링 된다. setTiling는 IllegalStateException을 Throw 한다
• MODE_EXPLICIT - 이미지는 setTiling 메서드로 주어지는 파라미터에 따라 타일링 된다. 미리 설정된 타일링 파라미터는 모두 파기된다
• MODE_COPY_FROM_METADATA - 이미지는 출력에게 건네지는 메타데이타오브제크트에 준거한다. setTiling는 IllegalStateException을 Throw 합니다.

파라미터:

mode - 타일링에 사용하는 메서드

예외:

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

IllegalArgumentException - mode가 상기의 모드의 어떤 것도 아닌 경우

관련 항목:

setTiling(int, int, int, int), getTilingMode()

getTilingMode

public int getTilingMode()

타일링이 지원 되고 있는 경우, 현재의 타일링 모드를 리턴합니다. 지원 되어 있지 않은 경우는 UnsupportedOperationException을 Throw 합니다.

반환값:

현재의 타일링 모드

예외:

UnsupportedOperationException - canWriteTiles 이 false를 돌려주는 경우

관련 항목:

setTilingMode(int)

getPreferredTileSizes

public Dimension [] getPreferredTileSizes()

타일이 출력 파일 또는 스트림로 encode 될 때, 타일의 정규의 사이즈 범위를 나타내는 Dimension 배열을 리턴합니다. 리턴된 배열은 카피입니다.

정보는 페어로 리턴됩니다 . 페어의 최초의 요소에는 포괄적인 최소의 폭과 높이가 다음의 요소에는 포괄적인 최대의 폭과 높이가 포함됩니다. 아울러, 각 페어는 사이즈의 유효 범위를 정의합니다. 고정 사이즈를 지정하려면, 양쪽 모두의 요소에 같은 폭과 높이를 사용합니다. 임의의 범위를 지정하려면, Dimension 실제의 배열 대신에 null값이 사용됩니다.

생성자에 배열이 지정되지 않아도 타일링을 사용할 수 있는 경우, 이 메서드는 null을 리턴합니다.

반환값:

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

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

setTiling

public void setTiling(int tileWidth,
                      int tileHeight,
                      int tileGridXOffset,
                      int tileGridYOffset)

이미지가 출력 스트림내에서 타일링 되도록 지정합니다. tileWidth와 tileHeight 파라미터는 파일내의 타일의 폭과 높이를 지정합니다. 타일의넓이 또는 높이가 이미지의넓이 또는 높이보다 큰 경우, 이미지는 그 범위내에 타일링 되지 않습니다.

canOffsetTiles가 false를 돌려주는 경우, tileGridXOffset와 tileGridYOffset 파라미터는 0 이 됩니다.

파라미터:

tileWidth - 각 타일의 폭

tileHeight - 각 타일의 높이

tileGridXOffset - 타일 구라두의 수평 좌표

tileGridYOffset - 타일 구라두의 수직 좌표

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

IllegalStateException - 타일링 모드가 MODE_EXPLICIT가 아닌 경우

UnsupportedOperationException - 플러그 인이 구라두 좌표를 지원 하지 않고, 구라두 좌표가 어느쪽이나 0 이 아닌 경우

IllegalArgumentException - 타일 사이즈가 getPreferredTileSizes 이 돌려준 사용 가능한 범위내에 없는 경우

IllegalArgumentException - tileWidth 또는 tileHeight이 0 아래의 경우

관련 항목:

canWriteTiles, canOffsetTiles, getTileWidth(), getTileHeight(), getTileGridXOffset(), getTileGridYOffset()

unsetTiling

public void unsetTiling()

setTiling에 의 호출로 지정되는 이전의 타일 구라두 파라미터를 모두 삭제합니다.

디폴트 구현에서는 인스턴스 변수 tileWidth, tileHeight, tileGridXOffset, tileGridYOffset를 0 으로 설정합니다.

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

IllegalStateException - 타일링 모드가 MODE_EXPLICIT가 아닌 경우

관련 항목:

setTiling(int, int, int, int)

getTileWidth

public int getTileWidth()

이미지가 출력 스트림에 출력해질 때, 이미지내의 각 타일의 넓이를 리턴합니다. 타일링 파라미터가 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

반환값:

encode에 사용되는 타일의 폭

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

IllegalStateException - 타일링 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 타일링 파라미터가 설정되어 있지 않은 경우

관련 항목:

setTiling(int, int, int, int), getTileHeight()

getTileHeight

public int getTileHeight()

이미지가 출력 스트림에 출력해질 때, 이미지내의 각 타일의 높이를 리턴합니다. 타일링 파라미터가 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

반환값:

encode에 사용되는 타일의 높이

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

IllegalStateException - 타일링 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 타일링 파라미터가 설정되어 있지 않은 경우

관련 항목:

setTiling(int, int, int, int), getTileWidth()

getTileGridXOffset

public int getTileGridXOffset()

이미지가 출력 스트림에 출력해질 때, 이미지의 수평 타일 구라두 좌표를 리턴합니다. 타일링 파라미터가 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

반환값:

encode에 사용되는 타일 구라두 X 좌표

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

IllegalStateException - 타일링 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 타일링 파라미터가 설정되어 있지 않은 경우

관련 항목:

setTiling(int, int, int, int), getTileGridYOffset()

getTileGridYOffset

public int getTileGridYOffset()

이미지가 출력 스트림에 출력해질 때, 이미지의 수직 타일 구라두 좌표를 리턴합니다. 타일링 파라미터가 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

반환값:

encode에 사용되는 타일 구라두 Y 좌표

예외:

UnsupportedOperationException - 플러그 인이 타일링을 지원 하지 않는 경우

IllegalStateException - 타일링 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 타일링 파라미터가 설정되어 있지 않은 경우

관련 항목:

setTiling(int, int, int, int), getTileGridXOffset()

canWriteProgressive

public boolean canWriteProgressive()

품질을 단계적으로 향상시키는 일련의 패스로서 Writer가 출력 이미지를 써낼 수 있는인 경우에 true를 리턴합니다.

반환값:

출력측이 프로그래시브 인코딩을 지원하는인 경우는 true

관련 항목:

setProgressiveMode(int), getProgressiveMode()

setProgressiveMode

public void setProgressiveMode(int mode)

품질을 향상시키는 일련의 스캔이 스트림에 포함되는 것 같은 프로그래시브 모드로 출력측이 이미지를 써내는 것을 지정합니다. 단계적인 encode가 지원 되어 있지 않은 경우, UnsupportedOperationException가 발생 됩니다.

모드 인수는 프로그렛션파라메이타의 선택 방법을 지정해, MODE_DISABLED, MODE_COPY_FROM_METADATA, MODE_DEFAULT 어느 쪽인지일 필요가 있습니다. 그 외의 경우는 IllegalArgumentException가 발생 됩니다.

모드는 아래와 같이 해석됩니다.

• MODE_DISABLED - 프로그렛션 없음. 프로그렛션을 오프로 설정하는 경우에 사용한다
• MODE_COPY_FROM_METADATA - 출력 이미지는 출력 측에 건네받은 메타데이타오브제크트내의 임의의 프로그렛션파라메이타를 사용한다
• MODE_DEFAULT - 이미지는 출력측에서 선택한 파라미터로 단계적으로 출력해진다

디폴트는 MODE_COPY_FROM_METADATA 입니다.

파라미터:

mode - 출력 스트림내에서 프로그렛션을 설정하기 위한 모드

예외:

UnsupportedOperationException - 출력측이 프로그래시브 인코딩을 지원 하지 않는 경우

IllegalArgumentException - mode가 상기의 모드의 어떤 것도 아닌 경우

관련 항목:

getProgressiveMode()

getProgressiveMode

public int getProgressiveMode()

프로그래시브 방식에서 스트림을 출력하기 위한, 현재의 모드를 리턴합니다.

반환값:

프로그래시브 인코딩을 위한 현재의 모드

예외:

UnsupportedOperationException - 출력측이 프로그래시브 인코딩을 지원 하지 않는 경우

관련 항목:

setProgressiveMode(int)

canWriteCompressed

public boolean canWriteCompressed()

이 출력측이 압축을 지원하는인 경우, true를 리턴합니다.

반환값:

출력측이 압축을 지원하는인 경우는 true

setCompressionMode

public void setCompressionMode(int mode)

압축을 실행할지 어떨지를 지정해, 실행하는 경우는 압축 파라미터의 지정 방법을 결정합니다. mode인수는 아래와 같이 해석되는 4개의 모드 가운데 1개 일 필요가 있습니다.

• MODE_DISABLED - 압축하지 않는다. JPEG와 같은 보통 압축 출력만을 제공하는 출력측에서는 허가되지 않는다. 대응하는 set와 get 메서드는 IllegalStateException을 Throw 한다
• MODE_EXPLICIT - 이 ImageWriteParam로 지정되는 압축 방식과 품질 설정을 사용해 압축한다. 이전으로 설정된 압축 파라미터는 모두 파기된다
• MODE_COPY_FROM_METADATA - 출력 측에 건네받는 메타데이타오브제크트로 지정되는 임의의 압축 파라미터를 사용한다
• MODE_DEFAULT - 디폴트의 압축 파라미터를 사용한다

디폴트는 MODE_COPY_FROM_METADATA 입니다.

파라미터:

mode - 출력 스트림내에서 압축을 설정하기 위한 모드

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우, 또는 요구된 모드를 지원 하지 않는 경우

IllegalArgumentException - mode가 상기의 모드의 어떤 것도 아닌 경우

관련 항목:

getCompressionMode()

getCompressionMode

public int getCompressionMode()

압축이 지원 되는 경우, 현재의 압축 모드를 리턴합니다.

반환값:

현재의 압축 모드

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

관련 항목:

setCompressionMode(int)

getCompressionTypes

public String [] getCompressionTypes()

사용 가능한 압축 방식의 리스트를 배열 또는 String로 서 돌려주고, 이러한 인터페이스를 사용해 압축 방식을 선택할 수 없는 경우에 null을 리턴합니다.

출력측이, 규정의 압축 방식을 1개 만 제공하는 경우, 압축 방식을 지정할 필요는 없습니다. 압축 방식을 지정할 필요가 있는 것은 사용자가 다른 schema간에 미가 있는 선택을 할 수 있는 경우만입니다.

디폴트 구현에서는 압축이 지원 되고 있을까를 조사해 구현되어 있지 않은 경우는 UnsupportedOperationException을 Throw 합니다. 구현되고 있는 경우는 compressionTypes인스턴스 변수의 복사본을 돌려주고, 이 변수가 null 때는 null을 리턴합니다.

반환값:

사용 가능한 압축 방식에서 지역 대응되어 있지 않은 이름을 포함한 String 배열, 또는 null

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

setCompressionType

public void setCompressionType(String  compressionType)

getCompressionTypes로 나타나는 값의 1개에 압축 방식을 설정합니다. null값이 건네받는 경우, 이전의 설정은 모두 삭제됩니다.

디폴트 구현에서는 압축이 지원 되고 있는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes를 호출해, compressionType 이 정규의 값의 1개 일까를 조사합니다. 정규의 값의 경우, compressionType인스턴스 변수가 설정됩니다. compressionType가 null인 경우, 인스턴스 변수는 체크를 실행하지 않고 로 설정됩니다.

파라미터:

compressionType - getCompressionTypes가 돌려준 String 1개, 또는 이전의 설정을 모두 삭제하기 위한 null

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

UnsupportedOperationException - 설정 가능한 압축 방식이 없는 경우

IllegalArgumentException - compressionType가 null이 아니고, getCompressionTypes가 돌려준 값의 1개 도 아닌 경우

관련 항목:

getCompressionTypes(), getCompressionType(), unsetCompression()

getCompressionType

public String  getCompressionType()

현재 설정된 압축 방식을 돌려주는지, 아무것도 설정되어 있지 않은 경우는 null을 리턴합니다. 방식은, getCompressionTypes가 돌려준 안으로부터 String로 서 리턴됩니다 . 압축 방식이 설정되어 있지 않은 경우, null을 리턴합니다.

디폴트 구현에서는 압축이 지원 되고 있는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, compressionType인스턴스 변수의 값을 리턴합니다.

반환값:

현재의 압축 방식으로서 String, 방식이 설정되어 있지 않은 경우는 null

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

관련 항목:

setCompressionType(java.lang.String)

unsetCompression

public void unsetCompression()

이전의 압축 방식과 품질 설정을 모두 삭제합니다.

디폴트 구현에서는 인스턴스 변수 compressionType를 null에 인스턴스 변수 compressionQuality를 1.0F로 설정합니다.

예외:

UnsupportedOperationException - 플러그 인이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

관련 항목:

setCompressionType(java.lang.String), setCompressionQuality(float)

getLocalizedCompressionTypeName

public String  getLocalizedCompressionTypeName()

getLocale가 돌려준 Locale를 사용해, 현재의 압축 방식의 지역 대응된 이름을 리턴합니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, compressionType가 null이 아닐 때, 편의상 getCompressionType값이 리턴됩니다 .

반환값:

현재의 압축 방식의 지역 대응된 이름을 포함한 String

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 압축 방식이 설정되어 있지 않은 경우

isCompressionLossless

public boolean isCompressionLossless()

현재의 압축 방식이, 손실 없음 압축을 제공하는 경우, true를 리턴합니다. 플러그 인이 규정의 압축 방식을 1개 만 제공하는 경우는 최초로 setCompressionType를 호출하지 않고, 이 메서드를 호출할 수 있습니다 .

복수의 압축 방식이 있어, 그 모두 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes()가 null 일 때, 혹은 getCompressionType()가 null이 아닐 때, 편의상 true가 리턴됩니다 .

반환값:

현재의 압축 방식이 손실 없음의 경우는 true

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 정규의 압축 방식세트가 null이 아니고, 현재의 압축 방식이 null인 경우

setCompressionQuality

public void setCompressionQuality(float quality)

압축 품질을 0에 서 1 사이의 값으로 설정합니다. 디폴트에서는 1개의 압축 품질 설정만이 지원 됩니다. 출력측은 많은 제어를 할 수 있는 ImageWriteParam 확장 버전을 제공할 수 있습니다. 손실이 있는 압축 schema에서는 압축 품질은 파일 사이즈와 이미지 품질과의 균형을 조정할 필요가 있습니다. 예를 들어 JPEG 이미지를 출력할 때, 양자화 테이블을 선택해 조정합니다. 손실이 없는 schema에서는 압축 품질은 파일 사이즈와 압축 실행에 걸리는 시간과의 균형을 조정하기 위해서 사용할 수 있습니다. 예를 들어 PNG 이미지를 출력할 때, 행 필터의 최적화와 ZLIB 압축 레벨의 설정에 의해 조정합니다.

일반적으로 압축 품질의 설정치 0.0 은 「압축율의 높이를 중시」해, 설정치 1.0 은 「화질의 높이를 중시」하는 것이라고 해석할 수 있습니다.

복수의 압축 방식이 있어, 그 모두 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes()가 null을 돌려준다, 혹은 compressionType가 null이 아닐 때, compressionQuality인스턴스 변수를 설정합니다.

파라미터:

quality - 희망하는 품질 레벨을 나타내는 0에 서 1 까지의 float

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 정규의 압축 방식세트가 null이 아니고, 현재의 압축 방식이 null인 경우

IllegalArgumentException - quality가 0 미만, 또는 1 보다 큰 경우

관련 항목:

getCompressionQuality()

getCompressionQuality

public float getCompressionQuality()

현재의 압축 품질 설정을 리턴합니다.

복수의 압축 방식이 있어, 그 모두 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes()가 null, 혹은 getCompressionType()가 null이 아닐 때, compressionQuality인스턴스 변수를 리턴합니다.

반환값:

현재의 압축 품질 설정

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 정규의 압축 방식세트가 null이 아니고, 현재의 압축 방식이 null인 경우

관련 항목:

setCompressionQuality(float)

getBitRate

public float getBitRate(float quality)

입력 이미지 데이터의 각 비트에 대해서 주어진 품질 레벨로 출력 데이터의 비트수의 견적을 나타내는 float를 리턴합니다. 보통, 값은 0에 서 1 이 됩니다. 여기서, 값이 작을 정도 압축이 큰 일을 나타냅니다. 견적을 사용할 수 없는 것을 나타내기 위해서 특별한 값 -1. 0F가 사용됩니다.

복수의 압축 방식이 있어, 그 모두 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes()가 null 때, 혹은 getCompressionType()가 null이 아니고, quality가 범위내에 있을 때, -1. 0을 리턴합니다.

파라미터:

quality - bit rate가 조회되는 품질 설정

반환값:

압축 bit rate의 추측해, 혹은 견적을 사용할 수 없는 경우는 -1. 0F

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 정규의 압축 방식세트가 null이 아니고, 현재의 압축 방식이 null인 경우

IllegalArgumentException - quality가 0 미만, 또는 1 보다 큰 경우

getCompressionQualityDescriptions

public String [] getCompressionQualityDescriptions()

압축 품질 레벨의 표시 또는 설정을 위해서 사용자 인터페이스의 일부로서 getCompressionQualityValues와 함께 사용할 수 있는 String 배열을 리턴합니다. 인덱스 i를 가지는 String는 getCompressionQualityValues[i]로 부터 getCompressionQualityValues[i + 1] 까지의 품질 레벨 범위의 개요를 제공합니다. getCompressionQualityValues로 부터 리턴된 배열의 길이는 getCompressionQualityDescriptions로 부터 리턴된 배열의 길이보다, 항상 길어집니다.

예로서 캐릭터 라인 「Good」, 「Better」, 「Best」는 범위 [0, . 33), [. 33, . 66), [. 66, 1.0]에 관련지을 수가 있습니다. 이 경우 getCompressionQualityDescriptions는 { "Good", "Better", "Best" }를 돌려주고, getCompressionQualityValues는 { 0.0F, . 33F, . 66F, 1.0F }를 리턴합니다.

개요를 사용할 수 없는 경우, null이 리턴됩니다 . getCompressionQualityValues로 부터 null이 리턴된인 경우, 이 메서드는 null도 돌려줄 필요가 있습니다.

개요는 null이 아닌 경우, getLocale가 돌려준 Locale에 대해서 지역 대응으로 할 필요가 있습니다.

복수의 압축 방식이 있어, 그 모두 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes()가 null 때, 혹은 getCompressionType()가 null이 아닐 때에 null을 리턴합니다.

반환값:

압축 품질 레벨의 지역 대응으로 한 개요를 포함한 String 배열

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 정규의 압축 방식세트가 null이 아니고, 현재의 압축 방식이 null인 경우

관련 항목:

getCompressionQualityValues()

getCompressionQualityValues

public float[] getCompressionQualityValues()

압축 품질 레벨의 표시 또는 설정을 위한 사용자 인터페이스의 일부로서getCompressionQualityDescriptions와 함께 사용할 수 있는 float 배열을 리턴합니다. 자세한 내용은 getCompressionQualityDescriptions를 참조하십시오.

개요를 사용할 수 없는 경우, null이 리턴됩니다 . getCompressionQualityDescriptions로 부터 null이 리턴된인 경우, 이 메서드는 null도 돌려줄 필요가 있습니다.

복수의 압축 방식이 있어, 그 모두 설정되어 있지 않은 경우, IllegalStateException가 발생 됩니다.

디폴트 구현에서는 압축이 지원 되는지, 압축 모드가 MODE_EXPLICIT 일까를 조사합니다. 이것에 들어맞는 경우, getCompressionTypes()가 null 때, 혹은 getCompressionType()가 null이 아닐 때에 null을 리턴합니다.

반환값:

getCompressionQualityDescriptions로 부터의 String로 기술되는 압축 품질 레벨간의 범위를 나타내는 float 배열

예외:

UnsupportedOperationException - 출력측이 압축을 지원 하지 않는 경우

IllegalStateException - 압축 모드가 MODE_EXPLICIT가 아닌 경우

IllegalStateException - 정규의 압축 방식세트가 null이 아니고, 현재의 압축 방식이 null인 경우

관련 항목:

getCompressionQualityDescriptions()