javax.imageio.plugins.jpeg
클래스 JPEGImageReadParam

java.lang.Object 
  |
  +--javax.imageio.IIOParam 
        |
        +--javax.imageio.ImageReadParam 
              |
              +--javax.imageio.plugins.jpeg.JPEGImageReadParam

public class JPEGImageReadParam

extends ImageReadParam

이 클래스는 편입 JPEG 리더 플러그 인을 사용하는 경우에, JPEG 의 수량화 테이블 및 하프맨 테이블을 설정하는 기능을 추가합니다. 이 클래스의 인스턴스는 편입 JPEG ImageReader 의 getDefaultImageReadParam 메소드로부터 돌려주어집니다.

이것을 추가하는 유일한 목적은 테이블의 지정을, 생략 된 스트림의 복호화(decode)로 사용할 수 있게 하는 것입니다. 편입 JPEG 리더는 생략되어 있지 않은 스트림을 복호화(decode) 할 수 있는 통상의 ImageReadParam 도 받아들입니다.

생략 된 스트림의 테이블은 통상, 테이블만을 포함한 다른 생략 된 스트림을 최초로 읽어들이는 것으로 취득됩니다만, 어플리케이션에 따라서는 테이블이 미리 고정되고 있습니다. 이 클래스에 의해, 테이블을 클라이언트 코드로부터 직접 지정할 수 있게 됩니다. 테이블이 스트림 또는 JPEGImageReadParam 로 지정되어 있지 않은 경우, 스트림은 「표준의」시각적으로 손실이 없는 테이블을 사용하도록(듯이) 상정되고 있습니다. 디폴트의 테이블의 상세한 것에 대하여는 JPEGQTable 및 JPEGHuffmanTable 를 참조해 주세요.

편입 JPEG 리더의 getDefaultReadParam 메소드로부터 돌려주어지는 디폴트의 JPEGImageReadParam 에는 테이블이 저장되고 있지 않습니다. 디폴트의 테이블은 테이블 클래스 JPEGQTable 및 JPEGHuffmanTable 로부터 취득할 수 있습니다.

스트림에 테이블이 저장되어 있지 않은 경우,JPEGImageReadParam 로 지정된 테이블은 무시됩니다. 게다가 스트림내의 최초의 이미지에 테이블이 저장되지 않고 그 후의 이미지에도 저장되어 있지 않은 경우는 최초의 이미지로 지정된 테이블이 모든 생략 된 이미지에 대해서 사용됩니다. 스트림으로부터 테이블이 읽히면(자), 그 테이블을 오버라이드(override) 할 수 있는 것은 그 후에 같은 스트림으로부터 읽히는 테이블만입니다. 새로운 테이블을 지정하려면 , 리더의 setInput 메소드를 호출해 스트림을 변경할 필요가 있습니다.

이 클래스에는 스트림으로 검출된 테이블을 취득하는 수단은 없습니다. 이러한 테이블은 리더로부터 돌려주어지는 IIOMetadata 오브젝트를 참조해 스트림으로부터 추출할 수가 있습니다.

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

필드의 개요

클래스 javax.imageio. ImageReadParam 에서 상속받은 필드

canSetSourceRenderSize , destination , destinationBands , minProgressivePass , numProgressivePasses , sourceRenderSize

클래스 javax.imageio. IIOParam 에서 상속받은 필드

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

생성자의 개요

JPEGImageReadParam ()
JPEGImageReadParam 를 구축합니다.

메소드의 개요

boolean	areTablesSet () 현재 테이블이 설정되어 있는 경우는 true 를 돌려줍니다.
JPEGHuffmanTable []	getACHuffmanTables () setDecodeTables 에의 직전의 호출로 설정된 AC 하프맨 테이블의 배열의 카피를 돌려줍니다.
JPEGHuffmanTable []	getDCHuffmanTables () setDecodeTables 에의 직전의 호출로 설정된 DC 하프맨 테이블의 배열의 카피를 돌려줍니다.
JPEGQTable []	getQTables () setDecodeTables 에의 직전의 호출로 설정된 수량화 테이블의 배열의 카피를 돌려줍니다.
void	setDecodeTables (JPEGQTable [] qTables, JPEGHuffmanTable [] DCHuffmanTables, JPEGHuffmanTable [] ACHuffmanTables) 생략 된 스트림의 복호화(decode)로 사용하기 위해서 수량화 테이블 및 하프맨 테이블을 설정합니다.
void	unsetDecodeTables () 현재 설정되어 있는 수량화 테이블 및 하프맨 테이블을 삭제합니다.

클래스 javax.imageio. ImageReadParam 에서 상속받은 메소드

canSetSourceRenderSize , getDestination , getDestinationBands , getSourceMaxProgressivePass , getSourceMinProgressivePass , getSourceNumProgressivePasses , getSourceRenderSize , setDestination , setDestinationBands , setDestinationType , setSourceProgressivePasses , setSourceRenderSize

클래스 javax.imageio. IIOParam 에서 상속받은 메소드

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

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

JPEGImageReadParam

public JPEGImageReadParam()

JPEGImageReadParam 를 구축합니다.

메소드의 상세

areTablesSet

public boolean areTablesSet()

현재 테이블이 설정되어 있는 경우는 true 를 돌려줍니다.

반환값:

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

setDecodeTables

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

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

파라미터:

qTables - 수량화 테이블 오브젝트의 배열

DCHuffmanTables - 하프맨 테이블 오브젝트의 배열

ACHuffmanTables - 하프맨 테이블 오브젝트의 배열

예외:

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

관련 항목:

unsetDecodeTables()

unsetDecodeTables

public void unsetDecodeTables()

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

관련 항목:

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

getQTables

public JPEGQTable [] getQTables()

setDecodeTables 에의 직전의 호출로 설정된 수량화 테이블의 배열의 카피를 돌려줍니다. 현재 테이블이 설정되어 있지 않은 경우는 null 를 돌려줍니다.

반환값:

JPEGQTable 오브젝트의 배열, 또는 null

관련 항목:

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

getDCHuffmanTables

public JPEGHuffmanTable [] getDCHuffmanTables()

setDecodeTables 에의 직전의 호출로 설정된 DC 하프맨 테이블의 배열의 카피를 돌려줍니다. 현재 테이블이 설정되어 있지 않은 경우는 null 를 돌려줍니다.

반환값:

JPEGHuffmanTable 오브젝트의 배열, 또는 null

관련 항목:

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

getACHuffmanTables

public JPEGHuffmanTable [] getACHuffmanTables()

setDecodeTables 에의 직전의 호출로 설정된 AC 하프맨 테이블의 배열의 카피를 돌려줍니다. 현재 테이블이 설정되어 있지 않은 경우는 null 를 돌려줍니다.

반환값:

JPEGHuffmanTable 오브젝트의 배열, 또는 null

관련 항목:

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