22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 /**
27 * The main package of the Java Image I/O API.
28 * <p>
29 * Many common image I/O operations may be performed using the static methods of
30 * the {@code ImageIO} class.
31 * <p>
32 * This package contains the basic classes and interfaces for describing the
33 * contents of image files, including metadata and thumbnails
34 * ({@code IIOImage}); for controlling the image reading process
35 * ({@code ImageReader}, {@code ImageReadParam}, and {@code ImageTypeSpecifier})
36 * and image writing process ({@code ImageWriter} and {@code ImageWriteParam});
37 * for performing transcoding between formats ({@code ImageTranscoder}), and for
38 * reporting errors ({@code IIOException}).
39 * <p>
40 * All implementations of javax.imageio provide the following standard image
41 * format plug-ins:
42 * <div>
43 * <table border=1 cellpadding=5 style="margin: 0px auto;" summary="Standard
44 * image format plug-ins">
45 * <tr>
46 * <th> </th><th>Reading</th><th>Writing</th><th>Notes</th>
47 * <th>Metadata</th>
48 * </tr>
49 *
50 * <!-- BMP plugin -->
51 * <tr>
52 * <td><a href="https://msdn.microsoft.com/en-us/library/dd183391.aspx">
53 * BMP</a></td>
54 * <td align='center'>yes</td>
55 * <td align='center'>yes</td>
56 * <td align='center'>none</td>
57 * <td align='center'><a href='metadata/doc-files/bmp_metadata.html'>BMP
58 * metadata format</a></td>
59 * </tr>
60 *
61 * <!-- GIF plugin -->
62 * <tr>
63 * <td><a href="http://www.w3.org/Graphics/GIF/spec-gif89a.txt">GIF</a>
64 * </td>
65 * <td align='center'>yes</td>
66 * <td align='center'>yes</td>
67 * <td align='center'><a href="#gif_plugin_notes">GIF plug-in notes</a>
68 * </td>
69 * <td align='center'><a href='metadata/doc-files/gif_metadata.html'>GIF
70 * metadata format</a></td>
71 * </tr>
72 *
73 * <!-- JPEG plugin -->
74 * <tr>
75 * <td><a href="http://www.jpeg.org">JPEG</a></td>
76 * <td align='center'>yes</td>
77 * <td align='center'>yes</td>
78 * <td align='center'>none</td>
79 * <td align='center'><a href='metadata/doc-files/jpeg_metadata.html'>
80 * JPEG metadata format</a></td>
81 * </tr>
82 *
83 * <!-- PNG plugin -->
84 * <tr>
85 * <td><a href="http://www.libpng.org/pub/png/spec/">PNG</a></td>
86 * <td align='center'>yes</td>
87 * <td align='center'>yes</td>
88 * <td align='center'>none</td>
89 * <td align='center'><a href='metadata/doc-files/png_metadata.html'>PNG
90 * metadata format</a></td>
91 * </tr>
92 *
93 * <!-- TIFF plugin -->
94 * <tr>
95 * <td><a href="https://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf">
96 * TIFF</a></td>
97 * <td align='center'>yes</td>
98 * <td align='center'>yes</td>
99 * <td align='center'><a href='metadata/doc-files/tiff_metadata.html#Reading'>
100 * TIFF plug-in notes</a></td>
101 * <td align='center'><a href='metadata/doc-files/tiff_metadata.html#StreamMetadata'>
102 * TIFF metadata format</a></td>
103 * </tr>
104 *
105 * <!-- WBMP plugin -->
106 * <tr>
107 * <td><a href="http://www.wapforum.org/what/technical/SPEC-WAESpec-19990524.pdf">
108 * WBMP</a></td>
109 * <td align='center'>yes</td>
110 * <td align='center'>yes</td>
111 * <td align='center'>none</td>
112 * <td align='center'><a href='metadata/doc-files/wbmp_metadata.html'>
113 * WBMP metadata format</a></td>
114 * </tr>
115 * </table>
116 * </div>
117 * <BR>
118 * <BR>
119 * <BR>
120 *
121 * <h2> Standard Plug-in Notes</h2>
122 *
123 * <h3><a name="gif_plugin_notes">Standard plug-in for GIF image format</a></h3>
124 * ImageIO provides {@code ImageReader} and {@code ImageWriter}plug-ins for the
125 * <a href="http://www.w3.org/Graphics/GIF/spec-gif89a.txt"> Graphics
126 * Interchange Format (GIF)</a> image format. These are the "standard" GIF
127 * plug-ins, meaning those that are included in the JRE, as distinct from those
128 * included in standard extensions, or 3rd party plug-ins. The following notes
129 * and metadata specification apply to the standard plug-ins.
130 *
131 * <h3>Writing GIF images</h3>
132 * The GIF image writer plug-in guarantees lossless writing for images which
133 * meet the following requirements:
134 * <ul>
135 * <li>the number of bands is 1;</li>
136 * <li>the number of bits per sample is not greater than 8;</li>
137 * <li>the size of a color component is not greater than 8;</li>
138 * </ul>
139 * <p>
|
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 /**
27 * The main package of the Java Image I/O API.
28 * <p>
29 * Many common image I/O operations may be performed using the static methods of
30 * the {@code ImageIO} class.
31 * <p>
32 * This package contains the basic classes and interfaces for describing the
33 * contents of image files, including metadata and thumbnails
34 * ({@code IIOImage}); for controlling the image reading process
35 * ({@code ImageReader}, {@code ImageReadParam}, and {@code ImageTypeSpecifier})
36 * and image writing process ({@code ImageWriter} and {@code ImageWriteParam});
37 * for performing transcoding between formats ({@code ImageTranscoder}), and for
38 * reporting errors ({@code IIOException}).
39 * <p>
40 * All implementations of javax.imageio provide the following standard image
41 * format plug-ins:
42 *
43 * <table class="striped">
44 * <caption>Standard image format plug-ins</caption>
45 * <thead>
46 * <tr>
47 * <th scope="col">Image format
48 * <th scope="col">Reading
49 * <th scope="col">Writing
50 * <th scope="col">Notes
51 * <th scope="col">Metadata
52 * </thead>
53 * <tbody>
54 * <!-- BMP plugin -->
55 * <tr>
56 * <th scope="row">
57 * <a href="https://msdn.microsoft.com/en-us/library/dd183391.aspx">BMP</a>
58 * <td>yes
59 * <td>yes
60 * <td>none
61 * <td><a href='metadata/doc-files/bmp_metadata.html'>BMP
62 * metadata format</a>
63 * <!-- GIF plugin -->
64 * <tr>
65 * <th scope="row">
66 * <a href="http://www.w3.org/Graphics/GIF/spec-gif89a.txt">GIF</a>
67 * <td>yes
68 * <td>yes
69 * <td><a href="#gif_plugin_notes">GIF plug-in notes</a>
70 * <td><a href='metadata/doc-files/gif_metadata.html'>GIF
71 * metadata format</a>
72 * <!-- JPEG plugin -->
73 * <tr>
74 * <th scope="row"><a href="http://www.jpeg.org">JPEG</a>
75 * <td>yes
76 * <td>yes
77 * <td>none
78 * <td><a href='metadata/doc-files/jpeg_metadata.html'>
79 * JPEG metadata format</a>
80 * <!-- PNG plugin -->
81 * <tr>
82 * <th scope="row"><a href="http://www.libpng.org/pub/png/spec/">PNG</a>
83 * <td>yes
84 * <td>yes
85 * <td>none
86 * <td><a href='metadata/doc-files/png_metadata.html'>PNG
87 * metadata format</a>
88 * <!-- TIFF plugin -->
89 * <tr>
90 * <th scope="row">
91 * <a href="https://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf">
92 * TIFF</a>
93 * <td>yes
94 * <td>yes
95 * <td>
96 * <a href='metadata/doc-files/tiff_metadata.html#Reading'>TIFF plug-in
97 * notes</a>
98 * <td>
99 * <a href='metadata/doc-files/tiff_metadata.html#StreamMetadata'>TIFF
100 * metadata format</a>
101 * <!-- WBMP plugin -->
102 * <tr>
103 * <th scope="row">
104 * <a href="http://www.wapforum.org/what/technical/SPEC-WAESpec-19990524.pdf">
105 * WBMP</a>
106 * <td>yes
107 * <td>yes
108 * <td>none
109 * <td><a href='metadata/doc-files/wbmp_metadata.html'>
110 * WBMP metadata format</a>
111 * </tbody>
112 * </table>
113 *
114 * <h2> Standard Plug-in Notes</h2>
115 *
116 * <h3><a name="gif_plugin_notes">Standard plug-in for GIF image format</a></h3>
117 * ImageIO provides {@code ImageReader} and {@code ImageWriter}plug-ins for the
118 * <a href="http://www.w3.org/Graphics/GIF/spec-gif89a.txt"> Graphics
119 * Interchange Format (GIF)</a> image format. These are the "standard" GIF
120 * plug-ins, meaning those that are included in the JRE, as distinct from those
121 * included in standard extensions, or 3rd party plug-ins. The following notes
122 * and metadata specification apply to the standard plug-ins.
123 *
124 * <h3>Writing GIF images</h3>
125 * The GIF image writer plug-in guarantees lossless writing for images which
126 * meet the following requirements:
127 * <ul>
128 * <li>the number of bands is 1;</li>
129 * <li>the number of bits per sample is not greater than 8;</li>
130 * <li>the size of a color component is not greater than 8;</li>
131 * </ul>
132 * <p>
|