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

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

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인 경우