javax.imageio.plugins.jpeg
클래스 JPEGImageWriteParam

java.lang.Object 
  javax.imageio.IIOParam 
      javax.imageio.ImageWriteParam 
          javax.imageio.plugins.jpeg.JPEGImageWriteParam

public class JPEGImageWriteParam
extends ImageWriteParam 

이 클래스는 빌트인 JPEG 라이터 플러그 인을 사용하는 경우에 JPEG 수량화 테이블 및 하프맨 테이블을 설정하는 기능과 이미지용으로 최적화된 하프맨 테이블을 계산하도록 요구하는 기능을 추가합니다. 이 클래스의 인스턴스는 빌트인 JPEG ImageWriter getDefaultImageWriteParam 메서드로부터 리턴됩니다 .

이것들을 추가하는 주된 목적은 테이블의 지정을 생략 된 스트림의 encode로 사용할 수 있도록 하는 것입니다. 빌트인 JPEG 라이터는 보통 의 ImageWriteParam도 받아들입니다. 이 경우 라이터는 필요한 테이블을 내부적으로 구축합니다.

어느 쪽의 경우도, ImageWriteParam 품질의 설정에는 기본이 되는 라이브러리의 경우와 같은 의미가 있습니다. 1.00 은 모든 1 수량화 테이블을 0.75는 「표준의」시각적으로 손실이 없는 수량화 테이블을 0.00 은 모든 255 수량화 테이블을의미합니다.

생략 된 스트림의 테이블은 보통, 테이블만을 포함한 생략 된 스트림을 최초로 출력하는 것으로 지정됩니다만, 어플리케이션에 따라서는 테이블이 미리 고정되고 있습니다. 이 클래스에의해 테이블을 클라이언트 코드로부터 직접 지정할 수 있게 됩니다.

보통, 테이블은 Writer에게 건네진 IIOMetadata 객체로 지정되어 이러한 객체에 포함되는 테이블은 모두 스트림에 출력해집니다. 메타데이타에 테이블이 지정되어 있지 않은 경우는 생략 된 스트림이 출력해집니다. 메타데이타에 테이블이 포함되지 않고, JPEGImageWriteParam로 테이블이 지정되지 않는 경우, 생략 된 스트림은 「표준의」시각적으로 손실이 없는 테이블을 사용해 encode 됩니다. 최초로 테이블을 스트림에 출력하지 말고, 생략 된 스트림을 출력할 필요가 있는 경우는 테이블의 지정에 이 클래스가 필요합니다. 이 클래스를 사용하기 위해서는 Writer에게 건네진 메타데이타오브제크트에 테이블을 포함해 안되어, 스트림메타데이타를 제공해 되지 않습니다. 디폴트의 테이블의 상세한 것에 대하여는 JPEGQTable 및 JPEGHuffmanTable를 참조하십시오.

라이터의 getDefaultWriteParam 메서드로부터 리턴된 디폴트의 JPEGImageWriteParam에는 테이블은 포함되지 않습니다. 디폴트의 테이블은 라이터로부터 리턴된 디폴트의 IIOMetadata 객체에 포함되어 있습니다.

메타데이타에 테이블이 포함되어 있지 않은 경우, JPEGImageWriteParam로 지정되는 테이블은 무시됩니다. 게다가 테이블세트가 출력해지면, 같은 스트림 또는 다른 스트림에의 그 후의 출력에 대해서 그러한 테이블을 오버라이드(override) 할 수 있는 것은 메타데이타내의 테이블 뿐입니다. 이 클래스를 사용해 새로운 테이블을 지정하기 위해서는 라이터의 reset 메서드를 호출할 필요가 있습니다.

빌트인 JPEG 플러그 인의 조작의 상세한 것에 대하여는 「JPEG 메타데이타 형식의 사양과 사용법에 관한 주기」를 참조하십시오.

필드 개요

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

canOffsetTiles, canWriteCompressed, canWriteProgressive, canWriteTiles, compressionMode, compressionQuality, compressionType, compressionTypes, locale, MODE_COPY_FROM_METADATA, MODE_DEFAULT, MODE_DISABLED, MODE_EXPLICIT, preferredTileSizes, progressiveMode, tileGridXOffset, tileGridYOffset, tileHeight, tileWidth, tilingMode, tilingSet

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

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

생성자 개요

JPEGImageWriteParam (Locale locale)
JPEGImageWriteParam를 구축합니다.

메서드 개요

boolean	areTablesSet () 현재 테이블이 설정되어 있는 경우는 true를 리턴합니다.
JPEGHuffmanTable []	getACHuffmanTables () setEncodeTables에 의 직전의 호출로 설정된 AC 하프맨 테이블의 배열의 복사본을 리턴합니다.
String []	getCompressionQualityDescriptions () 압축 품질 레벨의 표시 또는 설정을 위해서 사용자 인터페이스의 일부로서 getCompressionQualityValues와 함께 사용할 수 있는 String 배열을 리턴합니다.
float[]	getCompressionQualityValues () 압축 품질 레벨의 표시 또는 설정을 위한 사용자 인터페이스의 일부로서getCompressionQualityDescriptions와 함께 사용할 수 있는 float 배열을 리턴합니다.
JPEGHuffmanTable []	getDCHuffmanTables () setEncodeTables에 의 직전의 호출로 설정된 DC 하프맨 테이블의 배열의 복사본을 리턴합니다.
boolean	getOptimizeHuffmanTables () setOptimizeHuffmanTables 직전의 호출에게 건네진 값을 리턴합니다.
JPEGQTable []	getQTables () setEncodeTables에 의 직전의 호출로 설정된 수량화 테이블의 배열의 복사본을 리턴합니다.
boolean	isCompressionLossless () JPEG 플러그 인은 손실의 발생하는 압축만을 지원 하므로false를 리턴합니다.
void	setEncodeTables (JPEGQTable [] qTables, JPEGHuffmanTable [] DCHuffmanTables, JPEGHuffmanTable [] ACHuffmanTables) 생략 된 스트림의 encode로 사용하기 위해서 수량화 테이블 및 하프맨 테이블을 설정합니다.
void	setOptimizeHuffmanTables (boolean optimize) 출력 처리의 일부로서 최적화된 이미지용 하프맨 테이블을 생성하도록 Writer에 통지합니다.
void	unsetCompression () 이전의 모든 압축 품질 설정을 삭제합니다.
void	unsetEncodeTables () 현재 설정되어 있는 수량화 테이블 및 하프맨 테이블을 삭제합니다.

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

canOffsetTiles, canWriteCompressed, canWriteProgressive, canWriteTiles, getBitRate, getCompressionMode, getCompressionQuality, getCompressionType, getCompressionTypes, getLocale, getLocalizedCompressionTypeName, getPreferredTileSizes, getProgressiveMode, getTileGridXOffset, getTileGridYOffset, getTileHeight, getTileWidth, getTilingMode, setCompressionMode, setCompressionQuality, setCompressionType, setProgressiveMode, setTiling, setTilingMode, unsetTiling

클래스 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

생성자 상세

JPEGImageWriteParam

public JPEGImageWriteParam(Locale  locale)

JPEGImageWriteParam를 구축합니다. 타일링은 지원 되지 않습니다. 프로그래시브 인코딩은 지원 됩니다. 디폴트의 프로그래시브 모드는 MODE_DISABLED 입니다. JPEG 로 불리는 1개의 압축 형식이 지원 됩니다. 디폴트의 압축 품질은 0.75 입니다.

파라미터:

locale - 압축 타입명과 품질 설명을 지역 대응으로 하기 위해서 슈퍼 클래스가 사용하는 Locale, 또는 null

메서드의 상세

unsetCompression

public void unsetCompression()

이전의 모든 압축 품질 설정을 삭제합니다.

디폴트의 구현은 압축 품질을 0.75F에 리셋 합니다.

오버라이드(override):

클래스 ImageWriteParam 내의 unsetCompression

예외:

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

관련 항목:

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

isCompressionLossless

public boolean isCompressionLossless()

JPEG 플러그 인은 손실의 발생하는 압축만을 지원 하므로false를 리턴합니다.

오버라이드(override):

클래스 ImageWriteParam 내의 isCompressionLossless

반환값:

false

예외:

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

getCompressionQualityDescriptions

public String [] getCompressionQualityDescriptions()

클래스 ImageWriteParam 기술:

압축 품질 레벨의 표시 또는 설정을 위해서 사용자 인터페이스의 일부로서 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을 리턴합니다.

오버라이드(override):

클래스 ImageWriteParam 내의 getCompressionQualityDescriptions

반환값:

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

관련 항목:

ImageWriteParam.getCompressionQualityValues()

getCompressionQualityValues

public float[] getCompressionQualityValues()

클래스 ImageWriteParam 기술:

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

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

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

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

오버라이드(override):

클래스 ImageWriteParam 내의 getCompressionQualityValues

반환값:

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

관련 항목:

ImageWriteParam.getCompressionQualityDescriptions()

areTablesSet

public boolean areTablesSet()

현재 테이블이 설정되어 있는 경우는 true를 리턴합니다.

반환값:

테이블이 존재하는 경우는 true

setEncodeTables

public void setEncodeTables(JPEGQTable [] qTables,
                            JPEGHuffmanTable [] DCHuffmanTables,
                            JPEGHuffmanTable [] ACHuffmanTables)

생략 된 스트림의 encode로 사용하기 위해서 수량화 테이블 및 하프맨 테이블을 설정합니다. 각 타입의 테이블은 최대로 4 개입니다. 메타데이타로 테이블이 지정되면, 이러한 테이블은 무시됩니다. 모든 인수는 null 여 되지 않습니다. 하프맨 테이블의 2개의 배열의 요소수는 같지 않으면 안됩니다. 메타데이타의 프레임 및 스캔 헤더의 테이블 지시자는 이러한 배열의 인덱스와 동등하다라고 상정됩니다. 인수 배열은 이 메서드에 의해 복사됩니다.

파라미터:

qTables - 수량화 테이블 객체의 배열

DCHuffmanTables - 하프맨 테이블 객체의 배열

ACHuffmanTables - 하프맨 테이블 객체의 배열

예외:

IllegalArgumentException - 몇개의 인수가 null인지, 4 개보다 많은 요소를 가지는 경우, 또는 DC 테이블과 AC 테이블의 수가 다른 경우

관련 항목:

unsetEncodeTables()

unsetEncodeTables

public void unsetEncodeTables()

현재 설정되어 있는 수량화 테이블 및 하프맨 테이블을 삭제합니다.

관련 항목:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getQTables

public JPEGQTable [] getQTables()

setEncodeTables에 의 직전의 호출로 설정된 수량화 테이블의 배열의 복사본을 리턴합니다. 현재 테이블이 설정되어 있지 않은 경우는 null을 리턴합니다.

반환값:

JPEGQTable 객체의 배열, 또는 null

관련 항목:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getDCHuffmanTables

public JPEGHuffmanTable [] getDCHuffmanTables()

setEncodeTables에 의 직전의 호출로 설정된 DC 하프맨 테이블의 배열의 복사본을 리턴합니다. 현재 테이블이 설정되어 있지 않은 경우는 null을 리턴합니다.

반환값:

JPEGHuffmanTable 객체의 배열, 또는 null

관련 항목:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

getACHuffmanTables

public JPEGHuffmanTable [] getACHuffmanTables()

setEncodeTables에 의 직전의 호출로 설정된 AC 하프맨 테이블의 배열의 복사본을 리턴합니다. 현재 테이블이 설정되어 있지 않은 경우는 null을 리턴합니다.

반환값:

JPEGHuffmanTable 객체의 배열, 또는 null

관련 항목:

setEncodeTables(javax.imageio.plugins.jpeg.JPEGQTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[], javax.imageio.plugins.jpeg.JPEGHuffmanTable[])

setOptimizeHuffmanTables

public void setOptimizeHuffmanTables(boolean optimize)

출력 처리의 일부로서 최적화된 이미지용 하프맨 테이블을 생성하도록 Writer에 통지합니다. 디폴트는 false 입니다. 이 플래그가 true로 설정되어 있는 경우는 메타데이타로 지정된 모든 테이블을 오버라이드(override) 합니다. 이것은 이 플래그를 true로 설정해 출력해진 이미지에는 항상 하프맨 테이블이 포함된다고 하는 것입니다.

파라미터:

optimize - 출력시에 최적화된 하프맨 테이블을 생성할지 어떨지를 나타내는 boolean 치

관련 항목:

getOptimizeHuffmanTables()

getOptimizeHuffmanTables

public boolean getOptimizeHuffmanTables()

setOptimizeHuffmanTables 직전의 호출에게 건네진 값을 리턴합니다. setOptimizeHuffmanTables가 불려가 지 않았던 경우는 false를 리턴합니다.

반환값:

라이터가 최적화된 하프맨 테이블을 생성하는 경우는 true

관련 항목:

setOptimizeHuffmanTables(boolean)