javax.imageio
인터페이스 ImageTranscoder

기존의 구현 클래스의 일람:

ImageWriter

public interface ImageTranscoder

메타데이타 변환 기능을 제공하는 인터페이스입니다.

read에 이어 기입하는 것만으로, 모든 이미지를 변환, 즉 원래 보존되고 있던 이미지와는 다른 형식에서 기입할 수가 있습니다. 다만, 형식의 차이이기 때문에, 이 처리중에 데이터가 손실할 가능성이 있습니다.

일반적으로, 가장 좋은 결과를 얻을 수 있는 것은 형식 고유의 메타데이타오브제크트를 작성해, 이미지와 거기에 관련지을 수 있었던 메타데이타에 대해 가능한 한 많은 정보를 캡슐화할 수 있는 경우입니다. encode에 사용되는 고유의 ImageWriter 에 의해 이해되기 (위해)때문에입니다.

ImageTranscoder 는 스트림마다, 이미지마다의 메타데이타를 나타내는 ImageReader 가 제공하는 IIOMetadata 오브젝트를, 특정의 ImageWriter 가 encode 하는데 적합한, 대응하는 오브젝트로 변환하기 위해서(때문에) 사용합니다. 이 인터페이스의 메소드가 직접 ImageWriter 상에 불려 가는 경우, 출력은 그 기입 측에 적합한 것이 됩니다.

IIOMetadata 오브젝트를 기입해 측에 고유의 형식에 변환할 때의 내부 자세한 것은 그 변환하는 조작의 문맥에 응해 바뀝니다. 통상,ImageWriter 는 라이터를 이해할 수 있는 추가 인터페이스가 입력 오브젝트에 구현되고 있는지 어떤지를 조사합니다. 예를 들어, 라이터와 같은 메이커가 기입한, read측 플러그 인에서의 읽어들여 조작에 의해 오브젝트가 취득되었을 경우등이 이것에 해당합니다. 이 경우, 플러그 인 고유의 인터페이스에 의해, 기입측은 입력 오브젝트에 액세스 할 수 있습니다. 이미지 파일 형식이 일정으로 유지되고 있으면, 거의 손실 없고 재encode 할 수 있습니다. 형식이 변경되어도, 기입측은 가능한 한 많은 정보를 보존하려고 합니다.

입력 오브젝트가 기입해 옆의 이해하는 추가 인터페이스를 구현하지 않는 경우, 기입측을 선택할 수 있는 것은 IIOMetadata.getAsTree 로 제공되는 트리 표시와 같은 표준 IIOMetadata 인터페이스를 개입시킨 액세스만입니다. 이 경우, 정보의 대부분이 없어질 가능성이 있습니다.

독립한 ImageTranscoder 는 기본적으로, 상기의 예의 기입측 플러그 인과 같은 기능을 가집니다. read측과 기입해 옆플러그 인의 양쪽 모두가 사용하는 private 인터페이스를 이해해, 기입측에서 사용할 수 있는 오브젝트를 수작업으로 인스턴스화할 필요가 있습니다. 생성되는 메타데이타오브제크트는 기입측으로부터 직접 사용할 수 있습니다.

ImageTranscoder 는 표준 API 의 일부로서 독립한 구현은 되고 있지 않습니다. 오히려, 이 인터페이스의 목적은 어플리케이션이 필요에 따라서 구현을 발견해, 작성하는 방법을 제공하는 것입니다.

메소드의 개요

IIOMetadata	convertImageMetadata (IIOMetadata inData, ImageTypeSpecifier imageType, ImageWriteParam param) encode에 사용할 수 있어 필요에 따라서, 문서 인터페이스 또는 encode에 사용하는 기입측 플러그 인에 고유의 다른 인터페이스를 사용해 변경할 수 있는 IIOMetadata 오브젝트를 돌려줍니다.
IIOMetadata	convertStreamMetadata (IIOMetadata inData, ImageWriteParam param) encode에 사용할 수 있어 필요에 따라서, 문서 인터페이스, 또는 encode에 사용하는 기입측 플러그 인에 고유의 다른 인터페이스를 사용해 변경할 수 있는 IIOMetadata 오브젝트를 돌려줍니다.

메소드의 상세

convertStreamMetadata

public IIOMetadata  convertStreamMetadata(IIOMetadata  inData,
                                         ImageWriteParam  param)

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

스트림메타데이타의 구조에 영향을 주는 것 같은 경우, 옵션의 code>ImageWriteParam 를 제공할 수 있습니다.

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

파라미터:

inData - 스트림메타데이타를 나타내, 돌려주어진 오브젝트 상태의 초기화에 사용되는 IIOMetadata 오브젝트

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

반환값:

IIOMetadata 오브젝트 또는 플러그 인이 메타데이타를 encode 하는 기능을 제공하지 않는 경우는 null

예외:

IllegalArgumentException - inData 가 null 의 경우

convertImageMetadata

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

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

이메이지메타데이타의 구조에 영향을 주는 것 같은 경우, 옵션의 ImageWriteParam 를 제공할 수 있습니다.

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

파라미터:

inData - 이메이지메타데이타를 나타내, 되돌려진 오브젝트 상태의 초기화에 사용되는 IIOMetadata 오브젝트

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

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

반환값:

IIOMetadata 오브젝트 또는 플러그 인이 메타데이타를 encode 하는 기능을 제공하지 않는 경우는 null

예외:

IllegalArgumentException - inData 와 code>imageType 의 어느 쪽인지가 null 의 경우