author | ohair |
Wed, 26 May 2010 20:28:04 -0700 | |
changeset 5551 | 327690766109 |
parent 5506 | 202f599c92aa |
permissions | -rw-r--r-- |
2 | 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
2 |
<html> |
|
3 |
<head> |
|
4 |
<!-- |
|
5506 | 5 |
Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved. |
2 | 6 |
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
7 |
||
8 |
This code is free software; you can redistribute it and/or modify it |
|
9 |
under the terms of the GNU General Public License version 2 only, as |
|
5506 | 10 |
published by the Free Software Foundation. Oracle designates this |
2 | 11 |
particular file as subject to the "Classpath" exception as provided |
5506 | 12 |
by Oracle in the LICENSE file that accompanied this code. |
2 | 13 |
|
14 |
This code is distributed in the hope that it will be useful, but WITHOUT |
|
15 |
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
16 |
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
17 |
version 2 for more details (a copy is included in the LICENSE file that |
|
18 |
accompanied this code). |
|
19 |
||
20 |
You should have received a copy of the GNU General Public License version |
|
21 |
2 along with this work; if not, write to the Free Software Foundation, |
|
22 |
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
23 |
||
5551
327690766109
6956202: Fix a few missed rebranding issues, please contact lines etc.
ohair
parents:
5506
diff
changeset
|
24 |
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
327690766109
6956202: Fix a few missed rebranding issues, please contact lines etc.
ohair
parents:
5506
diff
changeset
|
25 |
or visit www.oracle.com if you need additional information or have any |
327690766109
6956202: Fix a few missed rebranding issues, please contact lines etc.
ohair
parents:
5506
diff
changeset
|
26 |
questions. |
2 | 27 |
--> |
28 |
||
29 |
</head> |
|
30 |
||
31 |
<body bgcolor="white"> |
|
32 |
||
33 |
A package of the Java Image I/O API dealing with reading and writing |
|
34 |
metadata. |
|
35 |
||
36 |
<p> |
|
37 |
||
38 |
When reading an image, its per-stream and per-image metadata is made |
|
39 |
available as an <code>IIOMetadata</code> object. The internals of |
|
40 |
this object are specific to the plug-in that created it. Its contents |
|
41 |
may be accessed in the form of an XML <code>Document</code>, which is |
|
42 |
implemented as a tree of <code>IIOMetadataNode</code> objects. |
|
43 |
||
44 |
<p> |
|
45 |
||
46 |
When writing an image, its metadata may be set by defining or |
|
47 |
modifying an <code>IIOMetadata</code> object. Such an object may be |
|
48 |
obtained from an <code>ImageWriter</code> or |
|
49 |
<code>ImageTranscoder</code> (from the |
|
50 |
<code>javax.imageio</code> package). Once such an object has |
|
51 |
been obtained, its contents may be set of modified via a |
|
52 |
<code>Document</code> consisting of <code>IIOMetadataNode</code>s. |
|
53 |
The document format may optionally be described using an |
|
54 |
<code>IIOMetadataFormat</code> object. |
|
55 |
||
56 |
<p> |
|
57 |
||
58 |
The format of the metadata contained in the XML <code>Document</code> |
|
59 |
is identified by a string which appears as the root node of the tree |
|
60 |
of <code>IIOMetadataNode</code> objects. This string contains a version |
|
61 |
number, e.g. "javax_imageio_jpeg_image_1.0". Readers and writers may |
|
62 |
support multiple versions of the same basic format and the Image I/O |
|
63 |
API has methods that allow specifying which version to use by passing |
|
64 |
the string to the method/constructor used to obtain an <code>IIOMetadata</code> |
|
65 |
object. In some cases, a more recent version may not be strictly |
|
66 |
compatible with a program written expecting an older version (for |
|
67 |
an example, see the Native Metadata Format section of the JPEG Metadata |
|
68 |
Usage Notes below). |
|
69 |
||
70 |
<p> |
|
71 |
||
72 |
Plug-ins may choose to support a <A |
|
73 |
HREF="doc-files/standard_metadata.html">standard (plug-in neutral) |
|
74 |
format</A>. This format does not provide lossless encoding of |
|
75 |
metadata, but allows a portion of the metadata to be accessed in a |
|
76 |
generic manner. |
|
77 |
||
78 |
<p> |
|
79 |
||
80 |
Each of the standard plug-ins supports a so-called "native" metadata |
|
81 |
format, which encodes its metadata losslessly: |
|
82 |
||
83 |
<ul> |
|
84 |
<li> |
|
85 |
<A HREF="doc-files/gif_metadata.html"> |
|
86 |
GIF metadata |
|
87 |
</A> |
|
88 |
||
89 |
<li> |
|
90 |
<A HREF="doc-files/jpeg_metadata.html"> |
|
91 |
JPEG metadata |
|
92 |
</A> |
|
93 |
||
94 |
<li> |
|
95 |
<A HREF="doc-files/png_metadata.html"> |
|
96 |
PNG metadata |
|
97 |
</A> |
|
98 |
||
99 |
<li> |
|
100 |
<A HREF="doc-files/bmp_metadata.html"> |
|
101 |
BMP metadata |
|
102 |
</A> |
|
103 |
||
104 |
<li> |
|
105 |
<A HREF="doc-files/wbmp_metadata.html"> |
|
106 |
WBMP metadata |
|
107 |
</A> |
|
108 |
||
109 |
</ul> |
|
110 |
||
111 |
@since 1.4 |
|
112 |
||
113 |
</body> |
|
114 |
</html> |