0N/A<!
DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2362N/ACopyright (c) 2000, 2001, Oracle and/or its affiliates. All rights reserved. 0N/ADO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/AThis code is free software; you can redistribute it and/or modify it 0N/Aunder the terms of the GNU General Public License version 2 only, as 2362N/Apublished by the Free Software Foundation. Oracle designates this 0N/Aparticular file as subject to the "Classpath" exception as provided 2362N/Aby Oracle in the LICENSE file that accompanied this code. 0N/AThis code is distributed in the hope that it will be useful, but WITHOUT 0N/AANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/AFITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/Aversion 2 for more details (a copy is included in the LICENSE file that 0N/Aaccompanied this code). 0N/AYou should have received a copy of the GNU General Public License version 0N/A2 along with this work; if not, write to the Free Software Foundation, 0N/AInc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2365N/APlease contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 0N/A<
title>Standard Metadata Format Specification</
title>
0N/A<
body bgcolor="white">
0N/AStandard (Plug-in Neutral) Metadata Format Specification
0N/A<
p> The plug-in neutral "javax_imageio_1.0" format consists
0N/Aof a root node named "javax_imageio_1.0" which has child
0N/Anodes "chroma", "compression", "dimension", "document", "text",
0N/A"tile", and "transparency". The format is described by the
0N/A<!DOCTYPE "javax_imageio_1.0" [
0N/A <!ELEMENT "javax_imageio_1.0" (Chroma?, Compression?, Data?, Dimension?,
0N/A Document?, Text?, Transparency?)>
0N/A <!ELEMENT "Chroma" (ColorSpaceType?, NumChannels?, Gamma?,
0N/A BlackIsZero?, Palette?, BackgroundIndex?, BackgroundColor?)>
0N/A <!-- Chroma (color) information -->
0N/A <!ELEMENT "ColorSpaceType" EMPTY>
0N/A <!-- The raw color space of the image -->
0N/A <!ATTLIST "ColorSpaceType" "name" ("XYZ" | "Lab" | "Luv" |
0N/A "YCbCr" | "Yxy" | "YCCK" | "PhotoYCC" | "RGB" | "GRAY" | "HSV" |
0N/A "HLS" | "CMYK" | "CMY" | "2CLR" | "3CLR" | "4CLR" | "5CLR" |
0N/A "6CLR" | "7CLR" | "8CLR" | "9CLR" | "ACLR" | "BCLR" | "CCLR" |
0N/A "DCLR" | "ECLR" | "FCLR") #REQUIRED>
0N/A <!ELEMENT "NumChannels" EMPTY>
0N/A <!-- The number of channels in the raw image, including alpha -->
0N/A <!ATTLIST "NumChannels" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: List of Integer -->
0N/A <!ELEMENT "Gamma" EMPTY>
0N/A <!-- The image gamma -->
0N/A <!ATTLIST "Gamma" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "BlackIsZero" EMPTY>
0N/A <!-- True if smaller values represent darker shades -->
0N/A <!ATTLIST "BlackIsZero" "value" ("TRUE" | "FALSE") "TRUE">
0N/A <!ELEMENT "Palette" (PaletteEntry)*>
0N/A <!-- Palette-color information -->
0N/A <!ELEMENT "PaletteEntry" EMPTY>
0N/A <!-- A palette entry -->
0N/A <!ATTLIST "PaletteEntry" "index" #CDATA #REQUIRED>
0N/A <!-- The index of the palette entry -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "PaletteEntry" "red" #CDATA #REQUIRED>
0N/A <!-- The red value for the palette entry -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "PaletteEntry" "green" #CDATA #REQUIRED>
0N/A <!-- The green value for the palette entry -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "PaletteEntry" "blue" #CDATA #REQUIRED>
0N/A <!-- The blue value for the palette entry -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "PaletteEntry" "alpha" #CDATA "255">
0N/A <!-- The alpha value for the palette entry -->
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "BackgroundIndex" EMPTY>
0N/A <!-- A palette index to be used as a background -->
0N/A <!ATTLIST "BackgroundIndex" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "BackgroundColor" EMPTY>
0N/A <!-- An RGB triple to be used as a background -->
0N/A <!ATTLIST "BackgroundColor" "red" #CDATA #REQUIRED>
0N/A <!-- The red background value -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "BackgroundColor" "green" #CDATA #REQUIRED>
0N/A <!-- The green background value -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "BackgroundColor" "blue" #CDATA #REQUIRED>
0N/A <!-- The blue background value -->
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "Compression" (CompressionTypeName?, Lossless?,
0N/A NumProgressiveScans?, BitRate?)>
0N/A <!-- Compression information -->
0N/A <!ELEMENT "CompressionTypeName" EMPTY>
0N/A <!-- The name of the compression scheme in use -->
0N/A <!ATTLIST "CompressionTypeName" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: String -->
0N/A <!ELEMENT "Lossless" EMPTY>
0N/A <!-- True if the compression scheme is lossless -->
0N/A <!ATTLIST "Lossless" "value" ("TRUE" | "FALSE") "TRUE">
0N/A <!ELEMENT "NumProgressiveScans" EMPTY>
0N/A <!-- The number of progressive scans used in the image encoding -->
0N/A <!ATTLIST "NumProgressiveScans" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "BitRate" EMPTY>
0N/A <!-- The estimated bit rate of the compression scheme -->
0N/A <!ATTLIST "BitRate" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "Data" (PlanarConfiguration?, SampleFormat?, BitsPerSample?,
0N/A SignificantBitsPerSample?, SampleMSB?)>
0N/A <!-- Information on the image layout -->
0N/A <!ELEMENT "PlanarConfiguration" EMPTY>
0N/A <!-- The organization of image samples in the stream -->
0N/A <!ATTLIST "PlanarConfiguration" "value" ("PixelInterleaved" |
0N/A "PlaneInterleaved" | "LineInterleaved" | "TileInterleaved")
0N/A <!ELEMENT "SampleFormat" EMPTY>
0N/A <!-- The numeric format of image samples -->
0N/A <!ATTLIST "SampleFormat" "value" ("SignedIntegral" |
0N/A "UnsignedIntegral" | "Real" | "Index") #REQUIRED>
0N/A <!ELEMENT "BitsPerSample" EMPTY>
0N/A <!-- The number of bits per sample -->
0N/A <!ATTLIST "BitsPerSample" "value" #CDATA #REQUIRED>
0N/A <!-- A list of integers, one per channel -->
0N/A <!-- Data type: List of Integer -->
0N/A <!-- Min length: 1 -->
0N/A <!ELEMENT "SignificantBitsPerSample" EMPTY>
0N/A <!-- The number of significant bits per sample -->
0N/A <!ATTLIST "SignificantBitsPerSample" "value" #CDATA #REQUIRED>
0N/A <!-- A list of integers, one per channel -->
0N/A <!-- Data type: List of Integer -->
0N/A <!-- Min length: 1 -->
0N/A <!ELEMENT "SampleMSB" EMPTY>
0N/A <!-- The position of the most significant bit of each sample -->
0N/A <!ATTLIST "SampleMSB" "value" #CDATA #REQUIRED>
0N/A <!-- A list of integers, one per channel -->
0N/A <!-- Data type: List of Integer -->
0N/A <!-- Min length: 1 -->
0N/A <!ELEMENT "Dimension" (PixelAspectRatio?, ImageOrientation?,
0N/A HorizontalPixelSize?, VerticalPixelSize?,
0N/A HorizontalPhysicalPixelSpacing?, VerticalPhysicalPixelSpacing?,
0N/A HorizontalPosition?, VerticalPosition?, HorizontalPixelOffset?,
0N/A VerticalPixelOffset?, HorizontalScreenSize?, VerticalScreenSize?)>
0N/A <!-- Dimension information -->
0N/A <!ELEMENT "PixelAspectRatio" EMPTY>
0N/A <!-- The width of a pixel divided by its height -->
0N/A <!ATTLIST "PixelAspectRatio" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "ImageOrientation" EMPTY>
0N/A <!-- The desired orientation of the image in terms of flips and
0N/A counter-clockwise rotations -->
0N/A <!ATTLIST "ImageOrientation" "value" ("Normal" | "Rotate90" |
0N/A "Rotate180" | "Rotate270" | "FlipH" | "FlipV" |
0N/A "FlipHRotate90" | "FlipVRotate90") #REQUIRED>
0N/A <!ELEMENT "HorizontalPixelSize" EMPTY>
0N/A <!-- The width of a pixel, in millimeters, as it should be rendered
0N/A <!ATTLIST "HorizontalPixelSize" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "VerticalPixelSize" EMPTY>
0N/A <!-- The height of a pixel, in millimeters, as it should be
0N/A rendered on media -->
0N/A <!ATTLIST "VerticalPixelSize" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "HorizontalPhysicalPixelSpacing" EMPTY>
0N/A <!-- The horizontal distance in the subject of the image, in
0N/A millimeters, represented by one pixel at the center of the
0N/A <!ATTLIST "HorizontalPhysicalPixelSpacing" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "VerticalPhysicalPixelSpacing" EMPTY>
0N/A <!-- The vertical distance in the subject of the image, in
0N/A millimeters, represented by one pixel at the center of the
0N/A <!ATTLIST "VerticalPhysicalPixelSpacing" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "HorizontalPosition" EMPTY>
0N/A <!-- The horizontal position, in millimeters, where the image
0N/A should be rendered on media -->
0N/A <!ATTLIST "HorizontalPosition" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "VerticalPosition" EMPTY>
0N/A <!-- The vertical position, in millimeters, where the image should
0N/A be rendered on media -->
0N/A <!ATTLIST "VerticalPosition" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Float -->
0N/A <!ELEMENT "HorizontalPixelOffset" EMPTY>
0N/A <!-- The horizonal position, in pixels, where the image should be
0N/A rendered onto a raster display -->
0N/A <!ATTLIST "HorizontalPixelOffset" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "VerticalPixelOffset" EMPTY>
0N/A <!-- The vertical position, in pixels, where the image should be
0N/A rendered onto a raster display -->
0N/A <!ATTLIST "VerticalPixelOffset" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "HorizontalScreenSize" EMPTY>
0N/A <!-- The width, in pixels, of the raster display into which the
0N/A image should be rendered -->
0N/A <!ATTLIST "HorizontalScreenSize" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "VerticalScreenSize" EMPTY>
0N/A <!-- The height, in pixels, of the raster display into which the
0N/A image should be rendered -->
0N/A <!ATTLIST "VerticalScreenSize" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "Document" (FormatVersion?, SubimageInterpretation?,
0N/A ImageCreationTime?, ImageModificationTime?)>
0N/A <!-- Document information -->
0N/A <!ELEMENT "FormatVersion" EMPTY>
0N/A <!-- The version of the format used by the stream -->
0N/A <!ATTLIST "FormatVersion" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: String -->
0N/A <!ELEMENT "SubimageInterpretation" EMPTY>
0N/A <!-- The interpretation of this image in relation to the other
0N/A images stored in the same stream -->
0N/A <!ATTLIST "SubimageInterpretation" "value" ("Standalone" |
0N/A "SinglePage" | "FullResolution" | "ReducedResolution" |
0N/A "PyramidLayer" | "Preview" | "VolumeSlice" | "ObjectView" |
0N/A "Panorama" | "AnimationFrame" | "TransparencyMask" |
0N/A "CompositingLayer" | "SpectralSlice" | "Unknown") #REQUIRED>
0N/A <!ELEMENT "ImageCreationTime" EMPTY>
0N/A <!-- The time of image creation -->
0N/A <!ATTLIST "ImageCreationTime" "year" #CDATA #REQUIRED>
0N/A <!-- The full year (
e.g., 1967, not 67) -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "ImageCreationTime" "month" #CDATA #REQUIRED>
0N/A <!-- The month, with January = 1 -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 1 (inclusive) -->
0N/A <!-- Max value: 12 (inclusive) -->
0N/A <!ATTLIST "ImageCreationTime" "day" #CDATA #REQUIRED>
0N/A <!-- The day of the month -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 1 (inclusive) -->
0N/A <!-- Max value: 31 (inclusive) -->
0N/A <!ATTLIST "ImageCreationTime" "hour" #CDATA "0">
0N/A <!-- The hour from 0 to 23 -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 0 (inclusive) -->
0N/A <!-- Max value: 23 (inclusive) -->
0N/A <!ATTLIST "ImageCreationTime" "minute" #CDATA "0">
0N/A <!-- The minute from 0 to 59 -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 0 (inclusive) -->
0N/A <!-- Max value: 59 (inclusive) -->
0N/A <!ATTLIST "ImageCreationTime" "second" #CDATA "0">
0N/A <!-- The second from 0 to 60 (60 = leap second) -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 0 (inclusive) -->
0N/A <!-- Max value: 60 (inclusive) -->
0N/A <!ELEMENT "ImageModificationTime" EMPTY>
0N/A <!-- The time of the last image modification -->
0N/A <!ATTLIST "ImageModificationTime" "year" #CDATA #REQUIRED>
0N/A <!-- The full year (
e.g., 1967, not 67) -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "ImageModificationTime" "month" #CDATA #REQUIRED>
0N/A <!-- The month, with January = 1 -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 1 (inclusive) -->
0N/A <!-- Max value: 12 (inclusive) -->
0N/A <!ATTLIST "ImageModificationTime" "day" #CDATA #REQUIRED>
0N/A <!-- The day of the month -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 1 (inclusive) -->
0N/A <!-- Max value: 31 (inclusive) -->
0N/A <!ATTLIST "ImageModificationTime" "hour" #CDATA "0">
0N/A <!-- The hour from 0 to 23 -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 0 (inclusive) -->
0N/A <!-- Max value: 23 (inclusive) -->
0N/A <!ATTLIST "ImageModificationTime" "minute" #CDATA "0">
0N/A <!-- The minute from 0 to 59 -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 0 (inclusive) -->
0N/A <!-- Max value: 59 (inclusive) -->
0N/A <!ATTLIST "ImageModificationTime" "second" #CDATA "0">
0N/A <!-- The second from 0 to 60 (60 = leap second) -->
0N/A <!-- Data type: Integer -->
0N/A <!-- Min value: 0 (inclusive) -->
0N/A <!-- Max value: 60 (inclusive) -->
0N/A <!ELEMENT "Text" (TextEntry)*>
0N/A <!-- Text information -->
0N/A <!ELEMENT "TextEntry" EMPTY>
0N/A <!-- A text entry -->
0N/A <!ATTLIST "TextEntry" "keyword" #CDATA #IMPLIED>
0N/A <!-- A keyword associated with the text entry -->
0N/A <!-- Data type: String -->
0N/A <!ATTLIST "TextEntry" "value" #CDATA #REQUIRED>
0N/A <!-- the text entry -->
0N/A <!-- Data type: String -->
0N/A <!ATTLIST "TextEntry" "language" #CDATA #IMPLIED>
0N/A <!-- The language of the text -->
0N/A <!-- Data type: String -->
0N/A <!ATTLIST "TextEntry" "encoding" #CDATA #IMPLIED>
0N/A <!-- The encoding of the text -->
0N/A <!-- Data type: String -->
0N/A <!ATTLIST "TextEntry" "compression" ("none" | "lzw" | "zip" |
0N/A "bzip" | "other") "none">
0N/A <!-- The method used to compress the text -->
0N/A <!ELEMENT "Transparency" (Alpha?, TransparentIndex?,
0N/A TransparentColor?, TileTransparencies?, TileOpacities?)>
0N/A <!-- Transparency information -->
0N/A <!ELEMENT "Alpha" EMPTY>
0N/A <!-- The type of alpha information contained in the image -->
0N/A <!ATTLIST "Alpha" "value" ("none" | "premultiplied" |
0N/A "nonpremultiplied") "none">
0N/A <!ELEMENT "TransparentIndex" EMPTY>
0N/A <!-- A palette index to be treated as transparent -->
0N/A <!ATTLIST "TransparentIndex" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "TransparentColor" EMPTY>
0N/A <!-- An RGB color to be treated as transparent -->
0N/A <!ATTLIST "TransparentColor" "value" #CDATA #REQUIRED>
0N/A <!-- Data type: List of Integer -->
0N/A <!ELEMENT "TileTransparencies" (TransparentTile)*>
0N/A <!-- A list of completely transparent tiles -->
0N/A <!ELEMENT "TransparentTile" EMPTY>
0N/A <!-- The index of a completely transparent tile -->
0N/A <!ATTLIST "TransparentTile" "x" #CDATA #REQUIRED>
0N/A <!-- The tile's X index -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "TransparentTile" "y" #CDATA #REQUIRED>
0N/A <!-- The tile's Y index -->
0N/A <!-- Data type: Integer -->
0N/A <!ELEMENT "TileOpacities" (OpaqueTile)*>
0N/A <!-- A list of completely opaque tiles -->
0N/A <!ELEMENT "OpaqueTile" EMPTY>
0N/A <!-- The index of a completely opaque tile -->
0N/A <!ATTLIST "OpaqueTile" "x" #CDATA #REQUIRED>
0N/A <!-- The tile's X index -->
0N/A <!-- Data type: Integer -->
0N/A <!ATTLIST "OpaqueTile" "y" #CDATA #REQUIRED>
0N/A <!-- The tile's Y index -->
0N/A <!-- Data type: Integer -->