패키지 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 의 트리의 구문 분석을 할 수 없었던 경우에 슬로우 됩니다.

패키지 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 오브젝트의 취득에 사용되는 메소드 또는 constructor 에 이 캐릭터 라인을 건네주어, 사용하는 버젼을 지정할 수 있는 메소드가 있습니다. 경우에 따라서는 새로운 버젼은 낡은 버젼을 상정해 기술된 프로그램과 엄밀한 호환성이 없는 것이 있습니다. 이 예에 대해서는 아래와 같은 「JPEG 메타데이타의 사용법에 관한 주기」의 「네이티브의 메타데이타 형식」의 섹션을 참조해 주세요.

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

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

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

도입된 버젼:

1.4