javax.imageio
인터페이스 ImageTranscoder

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

ImageWriter

public interface ImageTranscoder

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

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

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

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

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

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

독립한 ImageTranscoder 는 기본적으로, 상기의 예의 기입측 플러그 인과 같은 기능을 가집니다. 이것은 읽어들여 옆플러그 인과 기입해 옆플러그 인의 양쪽 모두가 사용하는 private 인터페이스를 인식해, 기입측에서 사용할 수 있는 객체를 수동으로 인스턴스화합니다. 생성되는 메타데이타객체는, 기입측으로부터 직접 사용할 수 있습니다.

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

메소드의 개요

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

메소드의 상세

convertStreamMetadata

IIOMetadata  convertStreamMetadata(IIOMetadata  inData,
                                  ImageWriteParam  param)

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

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

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

파라미터:

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

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

반환값:

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

예외:

IllegalArgumentException - inData 가 null 의 경우

convertImageMetadata

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 와 imageType 중 한쪽이 null 의 경우