패키지 javax.imageio.metadata

메타데이타의 read 및 기입을 처리하는 Java 이미지 입출력 API 의 패키지입니다.

참조처:
설명

인터페이스의 개요

IIOMetadataController	GUI 를 사용해 사용자로부터 값을 취득하는지, 또는 다른 수단에 의해,IIOMetadata 객체의 설정치를 판정할 수 있는 객체에 의해 구현되는 인터페이스입니다.
IIOMetadataFormat	IIOMetadata.getAsTree 로부터 돌려주어져 IIOMetadata.setFromTree 와 mergeTree 에게 건네지는 메타데이타드큐먼트의 구조를 기술하는 객체입니다.

클래스의 개요

IIOMetadata	이미지와 스트림에 관련지을 수 있었던 메타데이타 (이미지 이외의 데이터)를 나타내는 객체에 의해 확장되는 추상 클래스입니다.
IIOMetadataFormatImpl	IIOMetadataFormat 인터페이스의 재사용 가능한 구현을 제공하는 구상 클래스입니다.
IIOMetadataNode	메타데이타트리의 노드를 나타내는 클래스에서,org.w3c.dom.Element 인터페이스를 구현해, 한층 더 getUserObject 및 setUserObject 메소드를 사용해 텍스트 이외의 객체를 포함할 수 있도록(듯이) 합니다.

예외의 개요

IIOInvalidTreeException

IIOInvalidTreeException 는,IIOMetadata 객체에 의한 IIOMetadataNode 의 트리의 구문 분석을 할 수 없었던 경우에 throw 됩니다.

패키지 javax.imageio.metadata 의 설명

메타데이타의 read 및 기입을 처리하는 Java 이미지 입출력 API 의 패키지입니다.

이미지를 읽어들이는 경우는, 그 스트림마다 및 이미지마다의 메타데이타가 IIOMetadata 객체로서 사용 가능하게 됩니다. 이 객체의 내부는 작성에 사용한 플러그 인에 고유합니다. 그 내용은,IIOMetadataNode 객체의 트리로서 구현되는 XML Document 의 형식에서 액세스 할 수 있습니다.

이미지를 기입하는 경우는, 그 메타데이타를 IIOMetadata 객체의 정의 또는 변경에 의해 설정할 수가 있습니다. 이러한 객체는,javax.imageio 패키지의 ImageWriter 또는 ImageTranscoder 로부터 취득할 수가 있습니다. 이러한 객체가 취득되면(자),IIOMetadataNode 로 구성되는 Document 를 사용해, 그 내용을 변경할 수 있습니다. 문서 형식은, 필요에 따라서,IIOMetadataFormat 객체를 사용해 기술할 수가 있습니다.

XML Document 에 포함되는 메타데이타의 형식은,IIOMetadataNode 객체의 트리의 루트 노드로서 표시되는 캐릭터 라인에 의해 식별됩니다. 이 캐릭터 라인에는, javax_imageio_jpeg_image_1. 0 등의 버젼 번호가 포함됩니다. 리더와 라이터는 복수 버젼의 같은 기본 형식을 지원할 수가 있어 이미지 입출력 API 에는,IIOMetadata 객체의 취득에 사용되는 메소드 또는 생성자 에 이 캐릭터 라인을 건네주어, 사용하는 버젼을 지정할 수 있는 메소드가 있습니다. 경우에 따라서는, 새로운 버젼은, 낡은 버젼을 상정해 기술된 프로그램과 엄밀한 호환성이 없는 것이 있습니다. 이 예에 대해서는, 아래와 같은 「JPEG 메타데이타의 사용법에 관한 주기」의 「네이티브의 메타데이타 형식」의 섹션을 참조해 주세요.

플러그 인은,표준의 (플러그 인에 의존하지 않는다) 형식의 지원를 선택할 수가 있습니다. 이 형식은, 메타데이타의 손실이 없는 encode를 제공할 수 없습니다만, 일반적인 방법으로 메타데이타의 일부에의 액세스를 가능하게 할 수 있습니다.

각 표준 플러그 인은, 손실없이 메타데이타를 encode 하는 「네이티브」라고 불리는 메타데이타 형식을 지원합니다.

• GIF 메타데이타
• JPEG 메타데이타
• PNG 메타데이타
• BMP 메타데이타
• WBMP 메타데이타

도입된 버젼:

1.4