IIOMetadata (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

javax.imageio.metadata
클래스 IIOMetadata

java.lang.Object 
  javax.imageio.metadata.IIOMetadata

public abstract class IIOMetadata
extends Object
extends Object

이미지와 스트림에 관련지을 수 있었던 메타데이타 (이미지 이외의 데이터)를 나타내는 객체에 의해 확장되는 추상 클래스입니다. 플러그 인은, 불투명한, 플러그 인 고유의 객체를 사용하는 메타데이타를 나타냅니다. 다만, 이러한 객체는, XML DOM 인터페이스를 지원하는 IIOMetadataNode 객체의 트리로서 내부 정보에 액세스 하는 기능과 텍스트 이외의 데이터를 포함해, 정당한 데이터값에 관한 정보를 꺼내기 위한 추가의 인터페이스를 제공합니다. 이러한 트리의 형식은 플러그 인에 의존합니다만, 플러그 인은, 아래와 같은 플러그 인에 의존하지 않는 형식을 지원할 수 있습니다. 1 개의 플러그 인으로 복수의 메타데이타 형식을 지원할 수가 있어 그 이름은 getMetadataFormatNames 를 호출하는 것으로 판정할 수 있습니다. 그 플러그 인은, 메타데이타를 손실없이 encode 하도록(듯이) 설계된 「네이티브」형식으로 불리는 단일의 특수한 형식을 지원하는 일도 있습니다. 일반적으로, 이 형식은, 특정의 파일 형식과 함께 동작하도록(듯이) 특별히 설계되어 메타데이타의 손실이 없는 같은 형식에서 이미지를 로드 및 포함할 수가 있습니다만, 이미지 형식이 다른 ImageReader 와 ImageWriter 의 사이에 메타데이타를 전송 하기에는 불편한 경우가 있습니다. 2 개의 네이티브 형식의 사이에 이미지의 파일 형식의 경우와 같은 정도로 손실없이 변환하려면 ,ImageTranscoder 객체를 사용할 필요가 있습니다.

관련 항목:: ImageReader.getImageMetadata(int) , ImageReader.getStreamMetadata() , ImageReader.readAll(int, javax.imageio.ImageReadParam) , ImageWriter.getDefaultStreamMetadata(javax.imageio.ImageWriteParam) , ImageWriter.getDefaultImageMetadata(javax.imageio.ImageTypeSpecifier, javax.imageio.ImageWriteParam) , ImageWriter.write(javax.imageio.metadata.IIOMetadata, javax.imageio.IIOImage, javax.imageio.ImageWriteParam) , ImageWriter.convertImageMetadata(javax.imageio.metadata.IIOMetadata, javax.imageio.ImageTypeSpecifier, javax.imageio.ImageWriteParam) , ImageWriter.convertStreamMetadata(javax.imageio.metadata.IIOMetadata, javax.imageio.ImageWriteParam) , IIOImage , ImageTranscoder

필드의 개요
`protected IIOMetadataController`	`controller` `activateController` 메소드가 불려 갔을 때에, 이 `IIOMetadata` 객체의 설정을 지정하기 위해서 사용하는 `IIOMetadataController` 입니다.
`protected IIOMetadataController`	`defaultController` 이 `IIOMetadata` 객체의 콘트롤러로서 사용하도록(듯이) 추천 되고 있는 `IIOMetadataController` 입니다.
`protected String []`	`extraMetadataFormatClassNames` `null` 에 초기화되어 생성자 을 개입시켜 설정된,`IIOMetadataFormat` 를 구현해, 이 플러그 인으로 지원되는 표준 및 네이티브 형식 이외의 메타데이타 형식을 나타내는 클래스의 이름의 배열입니다.
`protected String []`	`extraMetadataFormatNames` `null` 에 초기화되어 생성자 을 개입시켜 설정된, 이 플러그 인으로 지원되는 표준 및 네이티브 형식 이외의 형식의 이름의 배열입니다.
`protected String`	`nativeMetadataFormatClassName` `null` 에 초기화되어 생성자 을 개입시켜 설정된,`IIOMetadataFormat` 를 구현해, 네이티브메타데이타 형식을 나타내는 클래스의 이름입니다.
`protected String`	`nativeMetadataFormatName` `null` 에 초기화되어 생성자 을 개입시켜 설정된, 이 객체의 네이티브메타데이타 형식의 이름입니다.
`protected boolean`	`standardFormatSupported` 구상 서브 클래스가, 생성자 을 개입시켜 설정된 표준의 메타데이타 형식을 지원할지 어떨지를 나타내는 boolean 치입니다.

생성자 의 개요
`protected`	`IIOMetadata ()` 빈 상태(empty)의 `IIOMetadata` 객체를 구축합니다.
`protected`	`IIOMetadata (boolean standardMetadataFormatSupported, String nativeMetadataFormatName, String nativeMetadataFormatClassName, String [] extraMetadataFormatNames, String [] extraMetadataFormatClassNames)` 지정된 형식명과 형식의 클래스명, 및 표준의 형식을 지원할지 어떨지를 나타내는 boolean 치를 사용해,`IIOMetadata` 객체를 구축합니다.

메소드의 개요
`boolean`	`activateController ()` 이 `IIOMetadata` 객체에 대해서 인스톨 되고 있는 `IIOMetadataController` 를 액티브하게 해, 결과의 값을 돌려줍니다.
`abstract Node`	`getAsTree (String formatName)` 지정된 메타데이타 형식에서 정의되는 규칙에 따라, 이 객체내에 포함되는 메타데이타의 트리의 루트를 나타내는 XML DOM `Node` 객체를 돌려줍니다.
`IIOMetadataController`	`getController ()` 현재 인스톨 되고 있는 `IIOMetadataController` 를 돌려줍니다.
`IIOMetadataController`	`getDefaultController ()` 디폴트가 존재하는 경우는, 현재 인스톨 되고 있는 콘트롤러에 관계없이, 디폴트의 `IIOMetadataController` 를 돌려줍니다.
`String []`	`getExtraMetadataFormatNames ()` 이 플러그 인의 `getAsTree`,`setFromTree`, 및 `mergeTree` 메소드로 인식되는, 네이티브 및 표준의 형식 이외의, 추가의 메타데이타 형식의 이름이 포함된 `String` 의 배열을 돌려줍니다.
`IIOMetadataFormat`	`getMetadataFormat (String formatName)` 지정된 메타데이타 형식을 기술하는 `IIOMetadataFormat` 객체를 돌려줍니다.
`String []`	`getMetadataFormatNames ()` 이 플러그 인의 `getAsTree`,`setFromTree`, 및 `mergeTree` 메소드로 인식되는, 네이티브와 표준의 형식을 포함한, 모든 메타데이타 형식의 이름이 포함된 `String` 의 배열을 돌려줍니다.
`String`	`getNativeMetadataFormatName ()` 이 플러그 인의 「네이티브」메타데이타 형식의 이름을 돌려줍니다.
`protected IIOMetadataNode`	`getStandardChromaNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 채도 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardCompressionNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 압축 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardDataNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 데이터 형식 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardDimensionNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 치수 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardDocumentNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 문서 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardTextNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 텍스트 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardTileNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 타일링 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardTransparencyNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 투과성 정보를 나타내는 `IIOMetadataNode` 를 돌려줍니다.
`protected IIOMetadataNode`	`getStandardTree ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 규칙에 따라, 이 객체내에 포함되는 메타데이타를 나타내는 `IIOMetadataNode` 의 트리를 돌려주는 유틸리티 메소드입니다.
`boolean`	`hasController ()` 이 `IIOMetadata` 객체에 대해서 콘트롤러가 인스톨 되고 있는 경우는,`true` 를 돌려줍니다.
`abstract boolean`	`isReadOnly ()` 이 객체가 `mergeTree`,`setFromTree`, 및 `reset` 메소드를 지원하지 않는 경우는 `true` 를 돌려줍니다.
`boolean`	`isStandardMetadataFormatSupported ()` 표준의 메타데이타 형식이 `getMetadataFormat`,`getAsTree`,`setFromTree`, 및 `mergeTree` 로 지원되는 경우는 `true` 를 돌려줍니다.
`abstract void`	`mergeTree (String formatName, Node root)` 지정된 메타데이타 형식에서 구문이 정의되는 XML DOM `Node` 의 트리로부터, 이 `IIOMetadata` 객체의 내부 상태를 변경합니다.
`abstract void`	`reset ()` 이 객체에 포함 떠날 수 있어 모든 데이터를 디폴트 값에 리셋 합니다.
`void`	`setController (IIOMetadataController controller)` `activateController` 메소드를 호출해, 모든 디폴트 콘트롤러를 오버라이드(override) 할 경우에, 이 `IIOMetadata` 객체의 설정치를 지정하기 위해서 사용하는 `IIOMetadataController` 를 설정합니다.
`void`	`setFromTree (String formatName, Node root)` 지정된 메타데이타 형식에서 구문이 정의되는 XML DOM `Node` 의 트리로부터, 이 `IIOMetadata` 객체의 내부 상태를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

필드의 상세

standardFormatSupported

protected boolean standardFormatSupported

구상 서브 클래스가, 생성자 을 개입시켜 설정된 표준의 메타데이타 형식을 지원할지 어떨지를 나타내는 boolean 치입니다.

nativeMetadataFormatName

protected String  nativeMetadataFormatName

null 에 초기화되어 생성자 을 개입시켜 설정된, 이 객체의 네이티브메타데이타 형식의 이름입니다.

nativeMetadataFormatClassName

protected String  nativeMetadataFormatClassName

null 에 초기화되어 생성자 을 개입시켜 설정된,IIOMetadataFormat 를 구현해, 네이티브메타데이타 형식을 나타내는 클래스의 이름입니다.

extraMetadataFormatNames

protected String [] extraMetadataFormatNames

null 에 초기화되어 생성자 을 개입시켜 설정된, 이 플러그 인으로 지원되는 표준 및 네이티브 형식 이외의 형식의 이름의 배열입니다.

extraMetadataFormatClassNames

protected String [] extraMetadataFormatClassNames

null 에 초기화되어 생성자 을 개입시켜 설정된,IIOMetadataFormat 를 구현해, 이 플러그 인으로 지원되는 표준 및 네이티브 형식 이외의 메타데이타 형식을 나타내는 클래스의 이름의 배열입니다.

defaultController

protected IIOMetadataController  defaultController

이 IIOMetadata 객체의 콘트롤러로서 사용하도록(듯이) 추천 되고 있는 IIOMetadataController 입니다. getDefaultController 를 사용해 꺼낼 수가 있습니다. 디폴트의 콘트롤러를 인스톨 하려면 ,setController(getDefaultController()) 를 호출합니다. 이 인스턴스 변수는, 파라미터를 설정하기 위해서 독자적인 디폴트 콘트롤러 (일반적으로은 GUI)를 제공하는 서브 클래스에서 설정할 필요가 있습니다.

관련 항목:: IIOMetadataController , getDefaultController()

controller

protected IIOMetadataController  controller

activateController 메소드가 불려 갔을 때에, 이 IIOMetadata 객체의 설정을 지정하기 위해서 사용하는 IIOMetadataController 입니다. 이 값은,null 의 경우에서도, 디폴트의 콘트롤러를 모두 오버라이드(override) 합니다.

관련 항목:: IIOMetadataController , setController(IIOMetadataController) , hasController() , activateController()

생성자 의 상세

IIOMetadata

protected IIOMetadata()

빈 상태(empty)의 IIOMetadata 객체를 구축합니다. 서브 클래스는, 오버라이드(override) 되지 않는 디폴트의 메소드 구현이 그 규약을 채우도록(듯이) 하는 모든 보호된 인스턴스 변수의 값을 지정합니다. 예를 들어,extraMetadataFormatNames 의 길이는 0 이어서는 안됩니다.

IIOMetadata

protected IIOMetadata(boolean standardMetadataFormatSupported,
                      String  nativeMetadataFormatName,
                      String  nativeMetadataFormatClassName,
                      String [] extraMetadataFormatNames,
                      String [] extraMetadataFormatClassNames)

지정된 형식명과 형식의 클래스명, 및 표준의 형식을 지원할지 어떨지를 나타내는 boolean 치를 사용해,IIOMetadata 객체를 구축합니다.

이 생성자 은 클래스명의 유효성은 판정하지 않습니다. 클래스명이 무효인 경우는,getMetadataFormat 의 그 후의 호출로 예외가 발생하는 경우가 있습니다.

파라미터:: standardMetadataFormatSupported - 이 객체가 표준의 메타데이타 형식을 사용해 DOM 트리를 돌려줄까 받는 것이 할 수 있는 경우는 true; nativeMetadataFormatName - 네이티브의 메타데이타 형식의 String 명. 네이티브의 형식이 없는 경우는 null; nativeMetadataFormatClassName - 네이티브메타데이타 형식의 클래스의 이름. 네이티브의 형식이 없는 경우는 null; extraMetadataFormatNames - 이 객체로 지원된다 추가 형식을 나타내는 String 의 배열. 존재하지 않는 경우는 null; extraMetadataFormatClassNames - 이 객체로 지원된다 추가 형식의 클래스명을 나타내는 String 의 배열. 존재하지 않는 경우는 null
예외:: IllegalArgumentException - extraMetadataFormatNames 의 길이가 0 의 경우; IllegalArgumentException - extraMetadataFormatNames 및 extraMetadataFormatClassNames 가 null 에서도 같은 길이도 아닌 경우

메소드의 상세

isStandardMetadataFormatSupported

public boolean isStandardMetadataFormatSupported()

표준의 메타데이타 형식이 getMetadataFormat,getAsTree,setFromTree, 및 mergeTree 로 지원되는 경우는 true 를 돌려줍니다.

디폴트의 구현은 standardFormatSupported 인스턴스 변수의 값을 돌려줍니다.

반환값:: 표준의 메타데이타 형식이 지원되고 있는 경우는 true
관련 항목:: getAsTree(java.lang.String) , setFromTree(java.lang.String, org.w3c.dom.Node) , mergeTree(java.lang.String, org.w3c.dom.Node) , getMetadataFormat(java.lang.String)

isReadOnly

public abstract boolean isReadOnly()

이 객체가 mergeTree,setFromTree, 및 reset 메소드를 지원하지 않는 경우는 true 를 돌려줍니다.

반환값:: 이 IIOMetadata 객체를 변경할 수 없는 경우는 true

getNativeMetadataFormatName

public String  getNativeMetadataFormatName()

이 플러그 인의 「네이티브」메타데이타 형식의 이름을 돌려줍니다. 일반적으로, 이 형식을 사용하면(자), 이 플러그 인으로 처리되는 형식에서 포함되고 있는 메타데이타를 손실없이 encode 및 전송 할 수 있습니다. 그러한 형식이 지원되어 있지 않은 경우는,null 가 돌려주어집니다.

「네이티브」메타데이타 형식의 구조와 내용은, 이 IIOMetadata 객체를 작성한 플러그 인으로 정의됩니다. 일반적으로, 단순한 형식의 플러그 인은, 루트에 더미 노드를 작성하고 나서, 개개의 태그, 체크, 또는 키워드와 값의 페어를 나타내는 일련의 자식(child) 노드를 작성합니다. 플러그 인은, 네이티브 형식을 문서화할지 어떨지를 선택할 수가 있습니다.

디폴트의 구현은 nativeMetadataFormatName 인스턴스 변수의 값을 돌려줍니다.

반환값:: 네이티브 형식의 이름, 또는 null
관련 항목:: getExtraMetadataFormatNames() , getMetadataFormatNames()

getExtraMetadataFormatNames

public String [] getExtraMetadataFormatNames()

이 플러그 인의 getAsTree,setFromTree, 및 mergeTree 메소드로 인식되는, 네이티브 및 표준의 형식 이외의, 추가의 메타데이타 형식의 이름이 포함된 String 의 배열을 돌려줍니다. 그러한 추가의 형식이 없는 경우는,null 가 돌려주어집니다.

디폴트의 구현은 extraMetadataFormatNames 인스턴스 변수의 복제를 돌려줍니다.

반환값:: 적어도 길이 1 의 String 의 배열, 또는 null
관련 항목:: getAsTree(java.lang.String) , setFromTree(java.lang.String, org.w3c.dom.Node) , mergeTree(java.lang.String, org.w3c.dom.Node) , getNativeMetadataFormatName() , getMetadataFormatNames()

getMetadataFormatNames

public String [] getMetadataFormatNames()

이 플러그 인의 getAsTree,setFromTree, 및 mergeTree 메소드로 인식되는, 네이티브와 표준의 형식을 포함한, 모든 메타데이타 형식의 이름이 포함된 String 의 배열을 돌려줍니다. 그러한 형식이 없는 경우는,null 가 돌려주어집니다.

디폴트의 구현은 getNativeMetadataFormatName,isStandardMetadataFormatSupported, 및 getExtraMetadataFormatNames 를 호출해, 결합된 결과를 돌려줍니다.

반환값:: String 의 배열
관련 항목:: getNativeMetadataFormatName() , isStandardMetadataFormatSupported() , getExtraMetadataFormatNames()

getMetadataFormat

public IIOMetadataFormat  getMetadataFormat(String  formatName)

지정된 메타데이타 형식을 기술하는 IIOMetadataFormat 객체를 돌려줍니다. 기술을 사용할 수 없는 경우는 null 를 돌려줍니다. 지정하는 이름은,getMetadataFormatNames 로부터 반환된 이름의 1 개가 아니면 안됩니다 (즉, 네이티브의 형식명, 표준의 형식명, 또는 getExtraMetadataFormatNames 로부터 반환된 이름의 1 개).

디폴트의 구현에서는, 글로벌 표준 메타데이타 형식명과 이름을 조합해, 지원되고 있는 경우는 그 형식을 돌려줍니다. 그렇지 않은 경우는, 나중에 추가의 형식명이 계속되는 네이티브의 형식명으로 조합합니다. 일치가 발견되었을 경우는, 해당하는 nativeMetadataFormatClassName 또는 extraMetadataFormatClassNames 로부터 IIOMetadataFormat 클래스의 이름을 꺼내,getInstance 메소드를 사용해 그 클래스의 인스턴스를 구축합니다.

파라미터:: formatName - 목적의 메타데이타 형식
반환값:: IIOMetadataFormat 객체
예외:: IllegalArgumentException - formatName 가 null 인지, 플러그 인으로 인식된 이름이 아닌 경우; IllegalStateException - 형식명에 대응하는 클래스를 로드할 수 없는 경우

getAsTree

public abstract Node  getAsTree(String  formatName)

지정된 메타데이타 형식에서 정의되는 규칙에 따라, 이 객체내에 포함되는 메타데이타의 트리의 루트를 나타내는 XML DOM Node 객체를 돌려줍니다.

사용 가능한 메타데이타 형식의 이름은,getMetadataFormatNames 메소드를 사용해 조회할 수가 있습니다.

파라미터:: formatName - 목적의 메타데이타 형식
반환값:: 트리의 루트를 형성하는 XML DOM Node 객체
예외:: IllegalArgumentException - formatName 가 null 인지, getMetadataFormatNames 로부터 반환된 이름이 아닌 경우
관련 항목:: getMetadataFormatNames() , setFromTree(java.lang.String, org.w3c.dom.Node) , mergeTree(java.lang.String, org.w3c.dom.Node)

mergeTree

public abstract void mergeTree(String  formatName,
                               Node  root)
                        throws IIOInvalidTreeException

지정된 메타데이타 형식에서 구문이 정의되는 XML DOM Node 의 트리로부터, 이 IIOMetadata 객체의 내부 상태를 변경합니다. 이전 상태는, 지정된 트리에 존재하는 노드에 적합하기 위해서 필요한 경우에만 변경됩니다. 트리의 구조 또는 내용이 무효인 경우는,IIOInvalidTreeException 가 throw 됩니다.

트리 또는 서브 트리를 다른 트리와 머지 하는 방법의 시멘틱스는 완전하게 형식 고유해서, 플러그 인의 작성자는, 그 형식에 가장 적절한 방법으로 이 메소드를 구현할 수가 있습니다. 기존의 모든 상태가 지정된 트리의 내용에 옮겨놓을 뿐(만큼)등의 방법이 있습니다.

파라미터:: formatName - 목적의 메타데이타 형식; root - 트리의 루트를 형성하는 XML DOM Node 객체
예외:: IllegalStateException - 이 객체가 읽어들여 전용의 경우; IllegalArgumentException - formatName 가 null 인지, getMetadataFormatNames 로부터 반환된 이름이 아닌 경우; IllegalArgumentException - root 가 null 의 경우; IIOInvalidTreeException - 지정된 형식의 규칙을 사용해 트리를 정상적으로 구문 분석 할 수 없는 경우
관련 항목:: getMetadataFormatNames() , getAsTree(java.lang.String) , setFromTree(java.lang.String, org.w3c.dom.Node)

getStandardChromaNode

protected IIOMetadataNode  getStandardChromaNode()

표준의 javax_imageio_1. 0 메타데이타 형식의 채도 정보를 나타내는 IIOMetadataNode 를 돌려줍니다. 그러한 정보를 사용할 수 없는 경우는 null 를 돌려줍니다. 이 메소드는, 유틸리티 루틴 getStandardTree 로부터 호출하는 것을 상정하고 있습니다.

디폴트 구현은 null 를 돌려줍니다.