Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / fe776f99fbfae3008bbb5950e8a8d46f2fef74d1 / . / www / formats.html
blob: cc2bc35fac9e26e93e05d462699aa080b317a7dd [file] [log] [blame]
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5<head>
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]6 <meta http-equiv="Content-Type" value="application/xhtml+xml" />
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]7 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
8 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
9 <style type="text/css" media="screen,projection"><!--
10 @import url("../www/magick.css");
11 --></style>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]12 <link rel="shortcut icon" href="../images/wand.ico" type="images/vnd.microsoft.icon"/>
13 <title>ImageMagick: Formats</title>
14 <meta http-equiv="Content-Language" content="en-US"/>
15 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
16 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
17 <meta name="Generator" content="PHP"/>
18 <meta name="Keywords" content="formats, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
19 <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
20 <meta name="Rating" content="GENERAL"/>
21 <meta name="Robots" content="INDEX, FOLLOW"/>
22 <meta name="Generator" content="ImageMagick Studio LLC"/>
23 <meta name="Author" content="ImageMagick Studio LLC"/>
24 <meta name="Revisit-after" content="2 DAYS"/>
25 <meta name="Resource-type" content="document"/>
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]26 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]27 <meta name="Distribution" content="Global"/>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]28</head>
29
30<body id="www-imagemagick-org">
31<div class="titlebar">
32<a href="../index.html">
33 <img src="../images/script.png" alt="[ImageMagick]"
34 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
35<a href="http://www.networkredux.com">
36 <img src="../images/networkredux.png" alt="[sponsor]"
37 style="margin: 45px auto; border: 0px; float: left;" /></a>
38<a href="http://www.imagemagick.org/discourse-server/">
39 <img src="../images/logo.jpg" alt=""
40 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
41<a href="../index.html">
42 <img src="../images/sprite.jpg" alt=""
43 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
44</div>
45
46<div class="eastbar">
47
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]48<div class="menu">
49 <a href="../index.html">About ImageMagick</a>
50</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]51<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]52<div class="menu">
53 <a href="../www/command-line-tools.html">Command-line Tools</a>
54</div>
55<div class="sub">
56 <a href="../www/command-line-processing.html">Processing</a>
57</div>
58<div class="sub">
59 <a href="../www/command-line-options.html">Options</a>
60</div>
61<div class="sub">
62 <a href="http://www.imagemagick.org/Usage/">Usage</a>
63</div>
64<div class="menu">
65 <a href="../www/api.html">Program Interfaces</a>
66</div>
67<div class="sub">
68 <a href="../www/magick-wand.html">MagickWand</a>
69</div>
70<div class="sub">
71 <a href="../www/magick-core.html">MagickCore</a>
72</div>
73<div class="sub">
74 <a href="../www/perl-magick.html">PerlMagick</a>
75</div>
76<div class="sub">
77 <a href="../Magick++/">Magick++</a>
78</div>
79<div class="menu">
80 <a href="../www/architecture.html">Architecture</a>
81</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]82<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]83<div class="menu">
84 <a href="../www/install-source.html">Install from Source</a>
85</div>
86<div class="sub">
87 <a href="../www/install-source.html#unix">Unix</a>
88</div>
89<div class="sub">
90 <a href="../www/install-source.html#windows">Windows</a>
91 </div>
92<div class="menu">
93 <a href="../www/binary-releases.html">Binary Releases</a>
94</div>
95<div class="sub">
96 <a href="../www/binary-releases.html#unix">Unix</a>
97</div>
98<div class="sub">
99 <a href="../www/binary-releases.html#macosx">Mac OS X</a>
100</div>
101<div class="sub">
102 <a href="../www/binary-releases.html#windows">Windows</a>
103</div>
104<div class="menu">
105 <a href="../www/resources.html">Resources</a>
106</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]107<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]108<div class="menu">
109 <a href="../www/download.html">Download</a>
110</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]111<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]112<div class="menu">
113 <a href="http://www.imagemagick.org/script/search.php">Search</a>
114</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]115<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]116<div class="menu">
117 <a href="../www/sitemap.html">Site Map</a>
118</div>
119<div class="sub">
120 <a href="../www/links.html">Links</a>
121</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]122<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]123<div class="menu">
124 <a href="../www/sponsors.html">Sponsors:</a>
125
126<div class="sponsbox">
127<div class="sponsor">
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]128 <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
cristy5f2356f2009-11-16 00:40:46 +0000[diff] [blame]129</div>
130<div class="sponsor">
cristycdbe2742010-02-07 19:30:44 +0000[diff] [blame]131 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
cristy2744bd92009-11-08 22:57:52 +0000[diff] [blame]132</div>
133<div class="sponsor">
134 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]135</div>
136<div class="sponsor">
137 <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
138</div>
139<div class="sponsor">
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]140 <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]141</div>
142<div class="sponsor">
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]143 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]144</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]145</div>
146</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]147
148
149</div>
150
151<div class="main">
152
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]153<p class="navigation-index">[<a href="#intro">Introducing Formats</a> &bull; <a href="#supported">Supported Formats</a> &bull; <a href="#pseudo">Pseudo Formats</a> &bull; <a href="#builtin-images">Built-in Images</a> &bull; <a href="#builtin-patterns">Built-in Patterns</a> &bull; <a href="#embedded">Embedded Profiles</a>]</p>
154
155<h2><a name="intro"></a>Introducing Image Formats</h2>
156<div class="doc-section">
157
158<p>ImageMagick uses an ASCII string known as <em>magick</em> (e.g. <kbd>GIF</kbd>) to identify file formats, algorithms acting as formats, built-in patterns, and embedded profile types.</p>
159
160<p>Support for some of the formats are delegated to libraries or external programs. The Installation Guide describes where to find these distributions and any special configuration options required.</p>
161
162<p>To get a complete listing of which image formats are supported on your system, type</p>
163
164<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -list format</span></p>
165<p>On some platforms, ImageMagick automagically processes these extensions: .gz for Zip compression, .Z for Unix compression, .bz2 for block compression, and .pgp for PGP encryption. For example, a PNM image called image.pnm.gz is automagically uncompressed.</p>
166
167</div>
168
169<h2><a name="supported"></a>Supported Image Formats</h2>
170<div class="doc-section">
171
172<p>ImageMagick supports reading over 100 major file formats (not
173including sub-formats). The following table provides a summary of
174the supported image formats.</p>
175
176<table class="doc">
177 <tbody>
178 <tr>
179 <th>Tag</th>
180 <th>Mode</th>
181 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]182 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]183 </tr>
184
185 <tr>
186 <td valign="top">ART</td>
187 <td valign="top">R</td>
188 <td valign="top">PFS: 1st Publisher</td>
189 <td valign="top">Format originally used on the Macintosh (MacPaint?) and later used for PFS: 1st Publisher clip art.</td>
190 </tr>
191
192 <tr>
193 <td valign="top">ARW</td>
194 <td valign="top">R</td>
195 <td valign="top">Sony Digital Camera Alpha Raw Image Format</td>
196 <td valign="top">&nbsp;</td>
197 </tr>
198
199 <tr>
200 <td valign="top"><a href="http://www.jmcgowan.com/avi.html">AVI</a></td>
201 <td valign="top">R</td>
202 <td valign="top">Microsoft Audio/Visual Interleaved</td>
203 <td valign="top">&nbsp;</td>
204 </tr>
205
206 <tr>
207 <td valign="top">AVS</td>
208 <td valign="top">RW</td>
209 <td valign="top">AVS X image</td>
210 <td valign="top">&nbsp;</td>
211 </tr>
212
213 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]214 <td valign="top"><a href="http://www.fileformat.info/format/bmp/egff.htm">BMP</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]215 <td valign="top">RW</td>
216 <td valign="top">Microsoft Windows bitmap</td>
217 <td valign="top">&nbsp;</td>
218 </tr>
219
220 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]221 <td valign="top"><a href="http://www.fileformat.info/format/cals/egff.htm">CALS</a></td>
222 <td valign="top">R</td>
223 <td valign="top">Continuous Acquisition and Life-cycle Support Type 1 image</td>
224 <td valign="top">Specified in MIL-R-28002 and MIL-PRF-28002. Standard blueprint archive format as used by the US military to replace microfiche.</td>
225 </tr>
226
227 <tr>
228 <td valign="top"><a href="http://www.fileformat.info/format/cgm/egff.htm">CGM</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]229 <td valign="top">R</td>
230 <td valign="top">Computer Graphics Metafile</td>
231 <td valign="top">Requires <a href="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">ralcgm</a> to render CGM files.</td>
232 </tr>
233
234 <tr>
235 <td valign="top"><a href="http://www.cineon.com/ff_draft.html">CIN</a></td>
236 <td valign="top">RW</td>
237 <td valign="top">Kodak Cineon Image Format</td>
238 <td valign="top">Use <a href="../www/command-line-options.html#set">-set</a> to specify the image gamma or black and white points (e.g. <kbd>-set gamma 1.7</kbd>, <kbd>-set reference-black 95</kbd>, <kbd>-set reference-white 685</kbd>). Properties include cin:file.create_date, cin:file.create_time, cin:file.filename, cin:file.version, cin:film.count, cin:film.format, cin:film.frame_id, cin:film.frame_position, cin:film.frame_rate, cin:film.id, cin:film.offset, cin:film.prefix, cin:film.slate_info, cin:film.type, cin:image.label, cin:origination.create_date, cin:origination.create_time, cin:origination.device, cin:origination.filename, cin:origination.model, cin:origination.serial, cin:origination.x_offset, cin:origination.x_pitch, cin:origination.y_offset, cin:origination.y_pitch, cin:user.data.</td>
239 </tr>
240
241 <tr>
242 <td valign="top">CMYK</td>
243 <td valign="top">RW</td>
244 <td valign="top">Raw cyan, magenta, yellow, and black samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]245 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth. To specify a single precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]246 </tr>
247
248 <tr>
249 <td valign="top">CMYKA</td>
250 <td valign="top">RW</td>
251 <td valign="top">Raw cyan, magenta, yellow, black, and alpha samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]252 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth. To specify a single precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]253 </tr>
254
255 <tr>
256 <td valign="top">CR2</td>
257 <td valign="top">R</td>
258 <td valign="top">Canon Digital Camera Raw Image Format</td>
259 <td valign="top">Requires an explicit image format otherwise the image is interpreted as a TIFF image (e.g. cr2:image.cr2).</td>
260 </tr>
261
262 <tr>
263 <td valign="top">CRW</td>
264 <td valign="top">R</td>
265 <td valign="top">Canon Digital Camera Raw Image Format</td>
266 <td valign="top">&nbsp;</td>
267 </tr>
268
269 <tr>
270 <td valign="top">CUR</td>
271 <td valign="top">R</td>
272 <td valign="top">Microsoft Cursor Icon</td>
273 <td valign="top">&nbsp;</td>
274 </tr>
275
276 <tr>
277 <td valign="top">CUT</td>
278 <td valign="top">R</td>
279 <td valign="top">DR Halo</td>
280 <td valign="top">&nbsp;</td>
281 </tr>
282
283 <tr>
284 <td valign="top">DCM</td>
285 <td valign="top">R</td>
286 <td valign="top">Digital Imaging and Communications in Medicine (DICOM) image</td>
287 <td valign="top">Used by the medical community for images like X-rays. ImageMagick sets the initial display range based on the Window Center (0028,1050) and Window Width (0028,1051) tags. Use <a href="../www/command-line-options.html#define">-define dcm:display-range=reset</a> to set the display range to the minimum and maximum pixel values.</td>
288 </tr>
289
290 <tr>
291 <td valign="top">DCR</td>
292 <td valign="top">R</td>
293 <td valign="top">Kodak Digital Camera Raw Image File</td>
294 <td valign="top">&nbsp;</td>
295 </tr>
296
297 <tr>
298 <td valign="top">DCX</td>
299 <td valign="top">RW</td>
300 <td valign="top">ZSoft IBM PC multi-page Paintbrush image</td>
301 <td valign="top">&nbsp;</td>
302 </tr>
303
304 <tr>
305 <td valign="top">DIB</td>
306 <td valign="top">RW</td>
307 <td valign="top">Microsoft Windows Device Independent Bitmap</td>
308 <td valign="top">DIB is a <a href="#BMP">BMP</a> file without the <a href="#BMP">BMP</a> header. Used to support embedded images in compound formats like WMF.</td>
309 </tr>
310
311 <tr>
312 <td valign="top"><a href="http://www.libdjvu.org/">DJVU</a></td>
313 <td valign="top">R</td>
314 <td valign="top"></td>
315 <td valign="top"></td>
316 </tr>
317
318 <tr>
319 <td valign="top"><a href="http://www.adobe.com/products/dng/main.html">DNG</a></td>
320 <td valign="top">R</td>
321 <td valign="top">Digital Negative</td>
322 <td valign="top">Requires an explicit image format otherwise the image is interpreted as a TIFF image (e.g. dng:image.dng).</td>
323 </tr>
324
325 <tr>
326 <td valign="top"><a href="http://www.graphviz.org">DOT</a></td>
327 <td valign="top">R</td>
328 <td valign="top">Graph Visualization</td>
329 <td valign="top">Use <a href="../www/command-line-options.html#define">-define</a> to specify the layout engine (e.g. <kbd>-define dot:layout-engine=neato</kbd>).</td>
330 </tr>
331
332 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]333 <td valign="top"><a href="../www/motion-picture.html">DPX</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]334 <td valign="top">RW</td>
335 <td valign="top">SMPTE Digital Moving Picture Exchange 2.0 (SMPTE 268M-2003)</td>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]336 <td valign="top">&nbsp;</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]337 </tr>
338
339 <tr>
340 <td valign="top">EMF</td>
341 <td valign="top">R</td>
342 <td valign="top">Microsoft Enhanced Metafile (32-bit)</td>
343 <td valign="top">Only available under Microsoft Windows.</td>
344 </tr>
345
346 <tr>
347 <td valign="top">EPDF</td>
348 <td valign="top">RW</td>
349 <td valign="top">Encapsulated Portable Document Format</td>
350 <td valign="top">&nbsp;</td>
351 </tr>
352
353 <tr>
354 <td valign="top">EPI</td>
355 <td valign="top">RW</td>
356 <td valign="top">Adobe Encapsulated PostScript Interchange format</td>
357 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
358 </tr>
359
360 <tr>
361 <td valign="top">EPS</td>
362 <td valign="top">RW</td>
363 <td valign="top">Adobe Encapsulated PostScript</td>
364 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
365 </tr>
366
367 <tr>
368 <td valign="top">EPS2</td>
369 <td valign="top">W</td>
370 <td valign="top">Adobe Level II Encapsulated PostScript</td>
371 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
372 </tr>
373
374 <tr>
375 <td valign="top">EPS3</td>
376 <td valign="top">W</td>
377 <td valign="top">Adobe Level III Encapsulated PostScript</td>
378 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
379 </tr>
380
381 <tr>
382 <td valign="top">EPSF</td>
383 <td valign="top">RW</td>
384 <td valign="top">Adobe Encapsulated PostScript</td>
385 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
386 </tr>
387
388 <tr>
389 <td valign="top">EPSI</td>
390 <td valign="top">RW</td>
391 <td valign="top">Adobe Encapsulated PostScript Interchange format</td>
392 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
393 </tr>
394
395 <tr>
396 <td valign="top">EPT</td>
397 <td valign="top">RW</td>
398 <td valign="top">Adobe Encapsulated PostScript Interchange format with <a href="#TIFF">TIFF</a> preview</td>
399 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
400 </tr>
401
402 <tr>
403 <td valign="top"><a href="http://www.openexr.org">EXR</a></td>
404 <td valign="top">RW</td>
405 <td valign="top">High dynamic-range (HDR) file format developed by Industrial Light &amp; Magic</td>
406 <td valign="top">See <a href="../www/high-dynamic-range.html">High Dynamic-Range Images</a> for details on this image format.</td>
407 </tr>
408
409 <tr>
410 <td valign="top">FAX</td>
411 <td valign="top">RW</td>
412 <td valign="top">Group 3 TIFF</td>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]413 <td valign="top">This format is a fixed width of 1728 as required by the standard. See <a href="#TIFF">TIFF</a> format. Note that FAX machines use non-square pixels which are 1.5 times wider than they are tall but computer displays use square pixels so FAX images may appear to be narrow unless they are explicitly resized using a resize specification of <kbd>100x150%</kbd>.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]414 </tr>
415
416 <tr>
417 <td valign="top"><a href="http://homepage.usask.ca/~ijm451/fig/">FIG</a></td>
418 <td valign="top">R</td>
419 <td valign="top">FIG graphics format</td>
420 <td valign="top">Requires <a href="ftp://ftp.x.org/contrib/applications/drawing_tools/transfig">TransFig</a>.</td>
421 </tr>
422
423 <tr>
424 <td valign="top"><a href="http://www.cv.nrao.edu/fits/">FITS</a></td>
425 <td valign="top">RW</td>
426 <td valign="top">Flexible Image Transport System</td>
427 <td valign="top">To specify a single-precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 64 for a double-precision floating-point format.</td>
428 </tr>
429
430 <tr>
431 <td valign="top">FPX</td>
432 <td valign="top">RW</td>
433 <td valign="top">FlashPix Format</td>
434 <td valign="top">Requires <a href="ftp://ftp.imagemagick.com/pub/ImageMagick/delegates">FlashPix SDK</a>.</td>
435 </tr>
436
437 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]438 <td valign="top"><a href="http://www.fileformat.info/format/gif/egff.htm">GIF</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]439 <td valign="top">RW</td>
440 <td valign="top">CompuServe Graphics Interchange Format</td>
441 <td valign="top">8-bit RGB PseudoColor with up to 256 palette entires. Specify the format <kbd>GIF87</kbd> to write the older version 87a of the format. Use <a href="../www/command-line-options.html#transparent-color">-transparent-color</a> to specify the GIF transparent color (e.g. <kbd>-transparent-color wheat</kbd>).</td>
442 </tr>
443
444 <tr>
445 <td valign="top">GPLT</td>
446 <td valign="top">R</td>
447 <td valign="top">Gnuplot plot files</td>
448 <td valign="top">Requires <a href="http://www.gnuplot.info/">gnuplot4.0.tar.Z</a> or later.</td>
449 </tr>
450
451 <tr>
452 <td valign="top">GRAY</td>
453 <td valign="top">RW</td>
454 <td valign="top">Raw gray samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]455 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth. To specify a single precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]456 </tr>
457
458 <tr>
459 <td valign="top">HALD</td>
460 <td valign="top">R</td>
461 <td valign="top">Identity Hald CLUT Image</td
462 <td valign="top">Select order with filename, e.g. hald:5 for order 5.</td>
463 </tr>
464
465 <tr>
466 <td valign="top">HPGL</td>
467 <td valign="top">R</td>
468 <td valign="top">HP-GL plotter language</td>
469 <td valign="top">Requires <a href="http://ftp.cdrom.com/pub/ImageMagick/delegates/hp2xx-3.2.0.tar.gz">hp2xx-3.2.0.tar.gz</a></td>
470 </tr>
471
472 <tr>
473 <td valign="top">HRZ</td>
474 <td valign="top">RW</td>
475 <td valign="top">Slow Scane TeleVision</td>
476 <td valign="top">&nbsp;</td>
477 </tr>
478
479 <tr>
480 <td valign="top">HTML</td>
481 <td valign="top">RW</td>
482 <td valign="top">Hypertext Markup Language with a client-side image map</td>
483 <td valign="top">Also known as <kbd>HTM</kbd>. Requires <a href="http://www.tdb.uu.se/%7Ejan/">html2ps</a> to read.</td>
484 </tr>
485
486 <tr>
487 <td valign="top">ICO</td>
488 <td valign="top">R</td>
489 <td valign="top">Microsoft icon</td>
490 <td valign="top">Also known as <kbd>ICON</kbd>.</td>
491 </tr>
492
493 <tr>
494 <td valign="top">INFO</td>
495 <td valign="top">W</td>
496 <td valign="top">Format and characteristics of the image</td>
497 <td valign="top"></td>
498 </tr>
499
500 <tr>
501 <td valign="top">INLINE</td>
502 <td valign="top">R</td>
503 <td valign="top">Base64-encoded inline image</td>
504 <td valign="top">The inline image look similar to <kbd>inline:data:;base64,/9j/4AAQSk...knrn//2Q==</kbd>. If the inline image exceeds 5000 characters, it must be referenced from a file (e.g. <kbd>inline:inline.txt</kbd>).</td>
505 </tr>
506
507 <tr>
508 <td valign="top">JBIG</td>
509 <td valign="top">RW</td>
510 <td valign="top">Joint Bi-level Image experts Group file interchange format</td>
511 <td valign="top">Also known as <kbd>BIE</kbd> and <kbd>JBG</kbd>. Requires <a href="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">jbigkit-1.6.tar.gz</a>.</td>
512 </tr>
513
514 <tr>
515 <td valign="top"><a href="http://www.libmng.com/">JNG</a></td>
516 <td valign="top">RW</td>
517 <td valign="top">Multiple-image Network Graphics</td>
518 <td valign="top">JPEG in a PNG-style wrapper with transparency. Requires libjpeg and libpng-1.0.2 or later, <a href="http://www.libpng.org/pub/png/libpng.html">libpng-1.2.5</a> or later recommended.</td>
519 </tr>
520
521 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]522 <td valign="top"><a href="http://www.ece.uvic.ca/%7Emdadams/jasper/">JP2</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]523 <td valign="top">RW</td>
524 <td valign="top">JPEG-2000 JP2 File Format Syntax</td>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]525 <td valign="top">Specify the encoding options with the <a href="../www/command-line-options.html#define">-define</a> option See <a href="../www/jp2.html">JP2 Encoding Options</a> for more details.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]526 </tr>
527
528 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]529 <td valign="top"><a href="http://www.ece.uvic.ca/%7Emdadams/jasper/">JPC</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]530 <td valign="top">RW</td>
531 <td valign="top">JPEG-2000 Code Stream Syntax</td>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]532 <td valign="top">Specify the encoding options with the <a href="../www/command-line-options.html#define">-define</a> option See <a href="../www/jp2.html">JP2 Encoding Options</a> for more details.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]533 </tr>
534
535 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]536 <td valign="top"><a href="http://www.jpeg.org/">JPEG</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]537 <td valign="top">RW</td>
538 <td valign="top">Joint Photographic Experts Group JFIF format</td>
cristyec407392009-11-28 22:42:05 +0000[diff] [blame]539 <td valign="top">Requires <a href="ftp://ftp.uu.net/graphics/jpeg/">jpegsrc.v6b.tar.gz</a>. You can optionally define the DCT method, for example to specify the float method, use <a href="../www/command-line-options.html#define">-define jpeg:dct-method=float</a>. By default we compute optimal Huffman coding tables. Specify <a href="../www/command-line-options.html#define">-define jpeg:optimize-coding=false</a> to use the default Huffman tables. Two other options include <a href="../www/command-line-options.html#define">-define jpeg:block-smoothing</a> and <a href="../www/command-line-options.html#define">-define jpeg:fancy-upsampling</a>. You can size the image with <kbd>jpeg:size</kbd>, for example <a href="../www/command-line-options.html#define">-define jpeg:size=128x128</a>. Finally, to restrict the maximum file size, use <kbd>jpeg:extent</kbd>, for example <a href="../www/command-line-options.html#define">-define jpeg:extent=400kb</a>.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]540 </tr>
541
542 <tr>
543 <td valign="top">MAN</td>
544 <td valign="top">R</td>
545 <td valign="top">Unix reference manual pages</td>
546 <td valign="top">Requires that GNU groff and Ghostcript are installed.</td>
547 </tr>
548
549 <tr>
550 <td valign="top">MAT</td>
551 <td valign="top">R</td>
552 <td valign="top">MATLAB image format</td>
553 <td valign="top">&nbsp;</td>
554 </tr>
555
556 <tr>
557 <td valign="top"><a href="../www/miff.html">MIFF</a></td>
558 <td valign="top">RW</td>
559 <td valign="top">Magick image file format</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]560 <td valign="top">This format persists all image attributes known to ImageMagick. To specify a single precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]561 </tr>
562
563 <tr>
564 <td valign="top">MONO</td>
565 <td valign="top">RW</td>
566 <td valign="top">Bi-level bitmap in least-significant-byte first order</td>
567 <td valign="top">&nbsp;</td>
568 </tr>
569
570 <tr>
571 <td valign="top"><a href="http://www.libpng.org/pub/mng/">MNG</a></td>
572 <td valign="top">RW</td>
573 <td valign="top">Multiple-image Network Graphics</td>
574 <td valign="top">A PNG-like Image Format Supporting Multiple Images, Animation and Transparent JPEG. Requires libpng-1.0.2 or later, <a href="http://www.libpng.org/pub/png/libpng.html">libpng-1.2.5</a> or later recommended. An interframe delay of 0 generates one frame with each additional layer composited on top. For motion, be sure to specify a non-zero delay.</td>
575 </tr>
576
577 <tr>
578 <td valign="top"><a href="http://www.mpeg.org/">MPEG</a></td>
579 <td valign="top">RW</td>
580 <td valign="top">Motion Picture Experts Group file interchange format (version 1)</td>
581 <td valign="top">Requires <a href="ftp://ftp.mpeg.org/pub/mpeg/mssg/">mpeg2vidcodec_v12.tar.gz</a>.</td>
582 </tr>
583
584 <tr>
585 <td valign="top"><a href="http://www.mpeg.org/">M2V</a></td>
586 <td valign="top">RW</td>
587 <td valign="top">Motion Picture Experts Group file interchange format (version 2)</td>
588 <td valign="top">Requires <a href="ftp://ftp.mpeg.org/pub/mpeg/mssg/">mpeg2vidcodec_v12.tar.gz</a>.</td>
589 </tr>
590
591 <tr>
592 <td valign="top">MPC</td>
593 <td valign="top">RW</td>
594 <td valign="top">Magick Persistent Cache image file format</td>
595 <td valign="top"> The native <em>in-memory</em> ImageMagick uncompressed file format. This file format is identical to that used by ImageMagick to represent images in memory and is read by mapping the file directly into memory. The MPC format is not portable and is not suitable as an archive format. It is suitable as an intermediate format for high-performance image processing. The MPC format requires two files to support one image. Image attributes are written to a file with the extension <kbd>.mpc</kbd>, whereas, image pixels are written to a file with the extension <kbd>.cache</kbd>.</td>
596 </tr>
597
598 <tr>
599 <td valign="top">MRW</td>
600 <td valign="top">R</td>
601 <td valign="top">Sony (Minolta) Raw Image File</td>
602 <td valign="top">&nbsp;</td>
603 </tr>
604
605 <tr>
606 <td valign="top">MSL</td>
607 <td valign="top">RW</td>
608 <td valign="top">Magick Scripting Language</td>
609 <td valign="top">MSL is the XML-based scripting language supported by the <a href="../www/conjure.html">conjure</a> utility. MSL requires the <a href="http://xmlsoft.org/">libxml2</a> delegate library.</td>
610 </tr>
611
612 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]613 <td valign="top"><a href="http://www.fileformat.info/format/mtv/egff.htm">MTV</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]614 <td valign="top">RW</td>
615 <td valign="top">MTV Raytracing image format</td>
616 <td valign="top">&nbsp;</td>
617 </tr>
618
619 <tr>
620 <td valign="top"><a href="../www/magick-vector-graphics.html">MVG</a></td>
621 <td valign="top">RW</td>
622 <td valign="top">Magick Vector Graphics.</td>
623 <td valign="top">The native ImageMagick vector metafile format. A text file containing vector drawing commands accepted by <a href="../www/convert.html">convert</a>'s <a href="../www/command-line-options.html#draw">-draw</a> option.</td>
624 </tr>
625
626 <tr>
627 <td valign="top">NEF</td>
628 <td valign="top">R</td>
629 <td valign="top">Nikon Digital SLR Camera Raw Image File</td>
630 <td valign="top">&nbsp;</td>
631 </tr>
632
633 <tr>
634 <td valign="top">ORF</td>
635 <td valign="top">R</td>
636 <td valign="top">Olympus Digital Camera Raw Image File</td>
637 <td valign="top">&nbsp;</td>
638 </tr>
639
640 <tr>
641 <td valign="top">OTB</td>
642 <td valign="top">RW</td>
643 <td valign="top">On-the-air Bitmap</td>
644 <td valign="top">&nbsp;</td>
645 </tr>
646
647 <tr>
648 <td valign="top">P7</td>
649 <td valign="top">RW</td>
650 <td valign="top">Xv's Visual Schnauzer thumbnail format</td>
651 <td valign="top">&nbsp;</td>
652 </tr>
653
654 <tr>
655 <td valign="top">PALM</td>
656 <td valign="top">RW</td>
657 <td valign="top">Palm pixmap</td>
658 <td valign="top">&nbsp;</td>
659 </tr>
660
661 <tr>
662 <td valign="top">PAM</td>
663 <td valign="top">W</td>
664 <td valign="top">Common 2-dimensional bitmap format</td>
665 <td valign="top">&nbsp;</td>
666 </tr>
667
668 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]669 <td valign="top"><a href="http://www.fileformat.info/format/pbm/egff.htm">PBM</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]670 <td valign="top">RW</td>
671 <td valign="top">Portable bitmap format (black and white)</td>
672 <td valign="top">&nbsp;</td>
673 </tr>
674
675 <tr>
676 <td valign="top">PCD</td>
677 <td valign="top">RW</td>
678 <td valign="top">Photo CD</td>
679 <td valign="top">The maximum resolution written is 768x512 pixels since larger images require huffman compression (which is not supported).</td>
680 </tr>
681
682 <tr>
683 <td valign="top">PCDS</td>
684 <td valign="top">RW</td>
685 <td valign="top">Photo CD</td>
686 <td valign="top">Decode with the sRGB color tables.</td>
687 </tr>
688
689 <tr>
690 <td valign="top">PCL</td>
691 <td valign="top">W</td>
692 <td valign="top">HP Page Control Language</td>
cristyc1c61662009-09-30 14:04:37 +0000[diff] [blame]693 <td valign="top">Use <a href="../www/command-line-options.html#define">-define</a> to specify fit to page option (e.g. <kbd>-define pcl:fit-to-page=true</kbd>).</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]694 </tr>
695
696 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]697 <td valign="top"><a href="http://www.fileformat.info/format/pcx/egff.htm">PCX</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]698 <td valign="top">RW</td>
699 <td valign="top">ZSoft IBM PC Paintbrush file</td>
700 <td valign="top">&nbsp;</td>
701 </tr>
702
703 <tr>
704 <td valign="top">PDB</td>
705 <td valign="top">RW</td>
706 <td valign="top">Palm Database ImageViewer Format</td>
707 <td valign="top">&nbsp;</td>
708 </tr>
709
710 <tr>
711 <td valign="top">PDF</td>
712 <td valign="top">RW</td>
713 <td valign="top">Portable Document Format</td>
cristy48dd1af2009-10-02 01:21:56 +0000[diff] [blame]714 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read. By default, ImageMagick sets the page size to the MediaBox. Some PDF files, however, have a CropBox or TrimBox that is smaller than the MediaBox and may include white space, registration or cutting marks outside the CropBox or TrimBox. To force ImageMagick to use the CropBox or TrimBox rather than the MediaBox, use <a href="../www/command-line-options.html#define">-define</a> (e.g. <kbd>-define pdf:use-cropbox=true</kbd> or <kbd>-define pdf:use-trimbox=true</kbd>). Use <a href="../www/command-line-options.html#density">-density</a> to improve the appearance of your PDF rendering (e.g. -density 300x300).</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]715 </tr>
716
717 <tr>
718 <td valign="top">PEF</td>
719 <td valign="top">R</td>
720 <td valign="top">Pentax Electronic File</td>
721 <td valign="top">Requires an explicit image format otherwise the image is interpreted as a TIFF image (e.g. pef:image.pef).</td>
722 </tr>
723
724 <tr>
725 <td valign="top">PFA</td>
726 <td valign="top">R</td>
727 <td valign="top">Postscript Type 1 font (ASCII)</td>
728 <td valign="top">Opening as file returns a preview image.</td>
729 </tr>
730
731 <tr>
732 <td valign="top">PFB</td>
733 <td valign="top">R</td>
734 <td valign="top">Postscript Type 1 font (binary)</td>
735 <td valign="top">Opening as file returns a preview image.</td>
736 </tr>
737
738 <tr>
739 <td valign="top">PFM</td>
740 <td valign="top">RW</td>
741 <td valign="top">Portable float map format</td>
742 <td valign="top">&nbsp;</td>
743 </tr>
744
745 <tr>
746 <td valign="top">PGM</td>
747 <td valign="top">RW</td>
748 <td valign="top">Portable graymap format (gray scale)</td>
749 <td valign="top">&nbsp;</td>
750 </tr>
751
752 <tr>
753 <td valign="top">PICON</td>
754 <td valign="top">RW</td>
755 <td valign="top">Personal Icon</td>
756 <td valign="top">&nbsp;</td>
757 </tr>
758
759 <tr>
760 <td valign="top">PICT</td>
761 <td valign="top">RW</td>
762 <td valign="top">Apple Macintosh QuickDraw/PICT file</td>
763 <td valign="top">&nbsp;</td>
764 </tr>
765
766 <tr>
767 <td valign="top">PIX</td>
768 <td valign="top">R</td>
769 <td valign="top">Alias/Wavefront RLE image format</td>
770 <td valign="top">&nbsp;</td>
771 </tr>
772
773 <tr>
774 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG</a></td>
775 <td valign="top">RW</td>
776 <td valign="top">Portable Network Graphics</td>
cristye6378132009-10-26 20:05:17 +0000[diff] [blame]777 <td valign="top">Requires libpng-1.0.2 or later, <a href="http://www.libpng.org/pub/png/libpng.html">libpng-1.2.5</a> or later recommended. The PNG specification does not support pixels-per-inch units, only pixels-per-centimeters.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]778 </tr>
779
780 <tr>
781 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG8</a></td>
782 <td valign="top">RW</td>
783 <td valign="top">Portable Network Graphics</td>
784 <td valign="top">8-bit indexed with optional binary transparency</td>
785 </tr>
786
787 <tr>
788 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG24</a></td>
789 <td valign="top">RW</td>
790 <td valign="top">Portable Network Graphics</td>
791 <td valign="top">opaque 24-bit RGB</td>
792 </tr>
793
794 <tr>
795 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG32</a></td>
796 <td valign="top">RW</td>
797 <td valign="top">Portable Network Graphics</td>
798 <td valign="top">opaque or transparent 32-bit RGBA</td>
799 </tr>
800
801 <tr>
802 <td valign="top">PNM</td>
803 <td valign="top">RW</td>
804 <td valign="top">Portable anymap</td>
805 <td valign="top">PNM is a family of formats supporting portable bitmaps (PBM) , graymaps (PGM), and pixmaps (PPM). There is no file format associated with pnm itself. If PNM is used as the output format specifier, then ImageMagick automagically selects the most appropriate format to represent the image. The default is to write the binary version of the formats. Use <a href="../www/command-line-options.html#compress">-compress none</a> to write the ASCII version of the formats.</td>
806 </tr>
807
808 <tr>
809 <td valign="top">PPM</td>
810 <td valign="top">RW</td>
811 <td valign="top">Portable pixmap format (color)</td>
812 <td valign="top">&nbsp;</td>
813 </tr>
814
815 <tr>
816 <td valign="top">PS</td>
817 <td valign="top">RW</td>
818 <td valign="top">Adobe PostScript file</td>
cristy48dd1af2009-10-02 01:21:56 +0000[diff] [blame]819 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read. To force ImageMagick to respect the crop box, use <a href="../www/command-line-options.html#define">-define</a> (e.g. <kbd>-define ps:use-cropbox=true</kbd>). Use <a href="../www/command-line-options.html#density">-density</a> to improve the appearance of your Postscript rendering (e.g. -density 300x300).</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]820 </tr>
821
822 <tr>
823 <td valign="top">PS2</td>
824 <td valign="top">RW</td>
825 <td valign="top">Adobe Level II PostScript file</td>
826 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
827 </tr>
828
829 <tr>
830 <td valign="top">PS3</td>
831 <td valign="top">RW</td>
832 <td valign="top">Adobe Level III PostScript file</td>
833 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
834 </tr>
835
836 <tr>
837 <td valign="top">PSD</td>
838 <td valign="top">RW</td>
839 <td valign="top">Adobe Photoshop bitmap file</td>
840 <td valign="top">&nbsp;</td>
841 </tr>
842
843 <tr>
844 <td valign="top">PTIF</td>
845 <td valign="top">RW</td>
846 <td valign="top">Pyramid encoded <a href="#TIFF">TIFF</a></td>
847 <td valign="top">Multi-resolution <a href="#TIFF">TIFF</a> containing successively smaller versions of the image down to the size of an icon.</td>
848 </tr>
849
850 <tr>
851 <td valign="top"><a href="http://www.photoworks.com/">PWP</a></td>
852 <td valign="top">R</td>
853 <td valign="top">Seattle File Works multi-image file</td>
854 <td valign="top">&nbsp;</td>
855 </tr>
856
857 <tr>
858 <td valign="top">RAD</td>
859 <td valign="top">R</td>
860 <td valign="top">Radiance image file</td>
861 <td valign="top">Requires that <i>ra_ppm</i> from the Radiance software package be installed.</td>
862 </tr>
863
864 <tr>
865 <td valign="top">RAF</td>
866 <td valign="top">R</td>
867 <td valign="top">Fuji CCD-RAW Graphic File</td>
868 <td valign="top">&nbsp;</td>
869 </tr>
870
871 <tr>
872 <td valign="top">RGB</td>
873 <td valign="top">RW</td>
874 <td valign="top">Raw red, green, and blue samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]875 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth. To specify a single precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]876 </tr>
877
878 <tr>
879 <td valign="top">RGBA</td>
880 <td valign="top">RW</td>
881 <td valign="top">Raw red, green, blue, and alpha samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]882 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth. To specify a single precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]883 </tr>
884
885 <tr>
886 <td valign="top">RLA</td>
887 <td valign="top">R</td>
888 <td valign="top">Alias/Wavefront image file</td>
889 <td valign="top">&nbsp;</td>
890 </tr>
891
892 <tr>
893 <td valign="top">RLE</td>
894 <td valign="top">R</td>
895 <td valign="top">Utah Run length encoded image file</td>
896 <td valign="top">&nbsp;</td>
897 </tr>
898
899 <tr>
900 <td valign="top"><a href="http://www.oreilly.com/www/centers/gff/formats/scitex/">SCT</a></td>
901 <td valign="top">R</td>
902 <td valign="top">Scitex Continuous Tone Picture</td>
903 <td valign="top">&nbsp;</td>
904 </tr>
905
906 <tr>
907 <td valign="top"><a href="http://www.photoworks.com/">SFW</a></td>
908 <td valign="top">R</td>
909 <td valign="top">Seattle File Works image</td>
910 <td valign="top">&nbsp;</td>
911 </tr>
912
913 <tr>
914 <td valign="top">SGI</td>
915 <td valign="top">RW</td>
916 <td valign="top">Irix RGB image</td>
917 <td valign="top">&nbsp;</td>
918 </tr>
919
920 <tr>
921 <td valign="top">SHTML</td>
922 <td valign="top">W</td>
923 <td valign="top">Hypertext Markup Language client-side image map</td>
924 <td valign="top">Used to write HTML clickable image maps based on a the output of <a href="../www/montage.html">montage</a> or a format which supports tiled images such as <a href="#MIFF">MIFF</a>.</td>
925 </tr>
926
927 <tr>
928 <td valign="top">SUN</td>
929 <td valign="top">RW</td>
930 <td valign="top">SUN Rasterfile</td>
931 <td valign="top">&nbsp;</td>
932 </tr>
933
934 <tr>
935 <td valign="top"><a href="http://www.w3.org/Graphics/SVG">SVG</a></td>
936 <td valign="top">RW</td>
937 <td valign="top">Scalable Vector Graphics</td>
938 <td valign="top">Requires <a href="http://xmlsoft.org/">libxml2</a> and <a href="http://www.freetype.org/">freetype-2</a>. Note that SVG is a complex specification and support for the specification in ImageMagick is not complete.</td>
939 </tr>
940
941 <tr>
942 <td valign="top">TGA</td>
943 <td valign="top">RW</td>
944 <td valign="top">Truevision Targa image</td>
945 <td valign="top">Also known as formats <kbd>ICB</kbd>, <kbd>VDA</kbd>, and <kbd>VST</kbd>.</td>
946 </tr>
947
948 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]949 <td valign="top"><a href="http://www.remotesensing.org/libtiff/">TIFF</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]950 <td valign="top">RW</td>
951 <td valign="top">Tagged Image File Format</td>
952 <td valign="top">Also known as <kbd>TIF</kbd>. Requires <a href="ftp://ftp.remotesensing.org/pub/libtiff/">tiff-v3.6.1.tar.gz</a> or later. Use <a href="../www/command-line-options.html#define">-define</a> to specify the rows per strip (e.g. <kbd>-define tiff:rows-per-strip=8</kbd>). To define the tile geometry, use for example, <kbd>-define tiff:tile-geometry=128x128</kbd>. To specify a <em>signed</em> format, use <kbd>-define quantum:format=signed</kbd>. To specify a single-precision floating-point format, use <kbd>-define quantum:format=floating-point</kbd>. Set the depth to 64 for a double-precision floating-point format. Use <kbd>-define quantum:polarity=min-is-black</kbd> or <kbd>-define quantum:polarity=min-is-white</kbd> toggle the photometric interpretation for a bilevel image. Specify the extra samples as associated or unassociated alpha with, for example, <kbd>-define tiff:alpha=unassociated</kbd>. You can choose to read the EXIF profile with this option: <kbd>-define tiff:exif=true</kbd>.</td>
953 </tr>
954
955 <tr>
956 <td valign="top">TIM</td>
957 <td valign="top">R</td>
958 <td valign="top">PSX TIM file</td>
959 <td valign="top">&nbsp;</td>
960 </tr>
961
962 <tr>
963 <td valign="top"><a href="http://www.freetype.org/">TTF</a></td>
964 <td valign="top">R</td>
965 <td valign="top">TrueType font file</td>
966 <td valign="top">Requires <a href="http://www.freetype.org/">freetype 2</a>. Opening as file returns a preview image. Use <a href="../www/command-line-options.html#set">-set</a> if you do not want to hint glyph outlines after their scaling to device pixels (e.g. <kbd>-set type:hinting off</kbd>).</td>
967 </tr>
968
969 <tr>
970 <td valign="top">TXT</td>
971 <td valign="top">RW</td>
972 <td valign="top">Raw text file</td>
973 <td valign="top">&nbsp;</td>
974 </tr>
975
976 <tr>
977 <td valign="top">UIL</td>
978 <td valign="top">W</td>
979 <td valign="top">X-Motif UIL table</td>
980 <td valign="top">&nbsp;</td>
981 </tr>
982
983 <tr>
984 <td valign="top">UYVY</td>
985 <td valign="top">RW</td>
986 <td valign="top">Interleaved YUV raw image</td>
987 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> command line options to specify width and height. Use <a href="../www/command-line-options.html#sampling-factor">-sampling-factor</a> to set the desired subsampling (e.g. -sampling-factor 4:2:2).</td>
988 </tr>
989
990 <tr>
991 <td valign="top">VICAR</td>
992 <td valign="top">RW</td>
993 <td valign="top">VICAR rasterfile format</td>
994 <td valign="top">&nbsp;</td>
995 </tr>
996
997 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]998 <td valign="top"><a href="http://www.fileformat.info/format/viff/egff.htm">VIFF</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]999 <td valign="top">RW</td>
1000 <td valign="top">Khoros Visualization Image File Format</td>
1001 <td valign="top">&nbsp;</td>
1002 </tr>
1003
1004 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1005 <td valign="top"><a href="http://www.openmobilealliance.org/Technical/wapindex.aspx">WBMP</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1006 <td valign="top">RW</td>
1007 <td valign="top">Wireless bitmap</td>
1008 <td valign="top">Support for uncompressed monochrome only.</td>
1009 </tr>
1010
1011 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1012 <td valign="top"><a href="http://www.fileformat.info/format/wmf/egff.htm">WMF</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1013 <td valign="top">R</td>
1014 <td valign="top">Windows Metafile</td>
1015 <td valign="top">Requires <a href="http://sourceforge.net/projects/wvware/">libwmf</a>. By default, renders WMF files using the dimensions specified by the metafile header. Use the -density option to adjust the output resolution, and thereby adjust the output size. The default output resolution is 72DPI so <kbd>-density 144</kbd> results in an image twice as large as the default. Use <kbd>-background color</kbd> to specify the WMF background color (default white) or <kbd>-texture filename</kbd> to specify a background texture image.</td>
1016 </tr>
1017
1018 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1019 <td valign="top"><a href="http://www.fileformat.info/format/wpg/egff.htm">WPG</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1020 <td valign="top">R</td>
1021 <td valign="top">Word Perfect Graphics File</td>
1022 <td valign="top">&nbsp;</td>
1023 </tr>
1024
1025 <tr>
1026 <td valign="top">X</td>
1027 <td valign="top">RW</td>
1028 <td valign="top">display or import an image to or from an X11 server</td>
1029 <td valign="top">Use <a href="../www/command-line-options.html#define">-define</a> to obtain the image from the root window (e.g. <kbd>-define x:screen=true</kbd>).</td>
1030 </tr>
1031
1032 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1033 <td valign="top"><a href="http://www.fileformat.info/format/xbm/egff.htm">XBM</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1034 <td valign="top">RW</td>
1035 <td valign="top">X Windows system bitmap, black and white only</td>
1036 <td valign="top">Used by the X Windows System to store monochrome icons.</td>
1037 </tr>
1038
1039 <tr>
1040 <td valign="top">XCF</td>
1041 <td valign="top">R</td>
1042 <td valign="top">GIMP image</td>
1043 <td valign="top">&nbsp;</td>
1044 </tr>
1045
1046 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1047 <td valign="top"><a href="http://www.fileformat.info/format/xpm/egff.htm">XPM</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1048 <td valign="top">RW</td>
1049 <td valign="top">X Windows system pixmap</td>
1050 <td valign="top">Also known as <kbd>PM</kbd>. Used by the X Windows System to store color icons.</td>
1051 </tr>
1052
1053 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1054 <td valign="top"><a href="http://www.fileformat.info/format/xwd/egff.htm">XWD</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1055 <td valign="top">RW</td>
1056 <td valign="top">X Windows system window dump</td>
1057 <td valign="top">Used by the X Windows System to save/display screen dumps.</td>
1058 </tr>
1059
1060 <tr>
1061 <td valign="top">X3F</td>
1062 <td valign="top">R</td>
1063 <td valign="top">Sigma Camera RAW Picture File</td>
1064 <td valign="top">&nbsp;</td>
1065 </tr>
1066
1067 <tr>
1068 <td valign="top">YCbCr</td>
1069 <td valign="top">RW</td>
1070 <td valign="top">Raw Y, Cb, and Cr samples</td>
1071 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth.</td>
1072 </tr>
1073
1074 <tr>
1075 <td valign="top">YCbCrA</td>
1076 <td valign="top">RW</td>
1077 <td valign="top">Raw Y, Cb, Cr, and alpha samples</td>
1078 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth.</td>
1079 </tr>
1080
1081 <tr>
1082 <td valign="top">YUV</td>
1083 <td valign="top">RW</td>
1084 <td valign="top">CCIR 601 4:1:1</td>
1085 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> command line options to specify width, height, and depth. Use <a href="../www/command-line-options.html#sampling-factor">-sampling-factor</a> to set the desired subsampling (e.g. -sampling-factor 4:2:2).</td>
1086 </tr>
1087 </tbody>
1088</table>
1089
1090</div>
1091
1092<h2><a name="pseudo"></a>Pseudo-image Formats</h2>
1093<div class="doc-section">
1094
1095<p>ImageMagick supports a number of image format specifications which refer to images prepared via an algorithm, or input/output targets. The following table lists these pseudo-image formats:</p>
1096
1097<table class="doc">
1098 <tr>
1099 <th>Tag</th>
1100 <th>Mode</th>
1101 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1102 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1103 </tr>
1104
1105 <tr>
1106 <td valign="top">CAPTION</td>
1107 <td valign="top">R</td>
1108 <td valign="top">Image caption</td>
1109 <td valign="top">&nbsp;</td>
1110 </tr>
1111
1112 <tr>
1113 <td valign="top">CLIPBOARD</td>
1114 <td valign="top">RW</td>
1115 <td valign="top">Windows Clipboard</td>
1116 <td valign="top">Only available under Microsoft Windows.</td>
1117 </tr>
1118
1119 <tr>
1120 <td valign="top">FRACTAL</td>
1121 <td valign="top">R</td>
1122 <td valign="top">Plasma fractal image</td>
1123 <td valign="top">&nbsp;</td>
1124 </tr>
1125
1126 <tr>
1127 <td valign="top">GRADIENT</td>
1128 <td valign="top">R</td>
1129 <td valign="top">Gradual passing from one shade to another</td>
1130 <td valign="top">Returns a rendered linear top-to-bottom gradient image using the specified image size. Specify the desired shading as part of the filename (e.g. <kbd>gradient:red-blue</kbd> or <kbd>gradient:#F00-#00F</kbd>). If the shading colors are omitted, the default gradient is white-black.</td>
1131 </tr>
1132
1133 <tr>
1134 <td valign="top">HISTOGRAM</td>
1135 <td valign="top">W</td>
1136 <td valign="top">Histogram of the image</td>
1137 <td valign="top">&nbsp;</td>
1138 </tr>
1139
1140 <tr>
1141 <td valign="top">LABEL</td>
1142 <td valign="top">R</td>
1143 <td valign="top">Text image format</td>
1144 <td valign="top">Specify the desired text as the filename (e.g. <kbd>label:"This a label"</kbd>).</td>
1145 </tr>
1146
1147 <tr>
1148 <td valign="top">MAP</td>
1149 <td valign="top">RW</td>
1150 <td valign="top">Colormap intensities and indices</td>
1151 <td valign="top">Set -depth to set the sample size of the intensities; indices are 16-bit if colors &gt; 256.</td>
1152 </tr>
1153
1154 <tr>
1155 <td valign="top">MATTE</td>
1156 <td valign="top">W</td>
1157 <td valign="top">MATTE format</td>
1158 <td valign="top">Write only.</td>
1159 </tr>
1160
1161 <tr>
1162 <td valign="top">NULL</td>
1163 <td valign="top">RW</td>
1164 <td valign="top">NULL image</td>
1165 <td valign="top">Useful for creating blank tiles with <a href="../www/montage.html">montage</a> (use <kbd>NULL:</kbd>). Also useful as an output format when evaluating image read performance.</td>
1166 </tr>
1167
1168 <tr>
1169 <td valign="top">PLASMA</td>
1170 <td valign="top">R</td>
1171 <td valign="top">Plasma fractal image</td>
1172 <td valign="top">&nbsp;</td>
1173 </tr>
1174
1175 <tr>
1176 <td valign="top">PREVIEW</td>
1177 <td valign="top">W</td>
1178 <td valign="top">Show a preview an image enhancement, effect, or f/x</td>
1179 <td valign="top">Creates a preview montage of images prepared over a parameteric range in order to assist with parameter selection. Specify the desired
1180 preview type via the -preview option).</td>
1181 </tr>
1182
1183 <tr>
1184 <td valign="top">PRINT</td>
1185 <td valign="top">W</td>
1186 <td valign="top">Send image to your computer printer</td>
1187 <td valign="top">Unix users may set the PRINTER (for 'lpr') or LPDEST (for 'lp') environment variables to select the desired printer.</td>
1188 </tr>
1189
1190 <tr>
1191 <td valign="top">SCAN</td>
1192 <td valign="top">R</td>
1193 <td valign="top">Import image from a scanner device</td>
1194 <td valign="top">Requires <a href="http://www.sane-project.org/">SANE</a> Specify the device name and path as the filename (e.g. <kbd>scan:'hpaio:/usb/Officejet_6200_series?serial=CN4ATCE3G20453'</kbd>).</td>
1195 </tr>
1196
1197 <tr>
1198 <td valign="top">RADIAL_GRADIENT</td>
1199 <td valign="top">R</td>
1200 <td valign="top">Gradual radial passing from one shade to another</td>
1201 <td valign="top">Returns a rendered radial gradient image using the specified image size. Specify the desired shading as part of the filename (e.g. <kbd>radial-gradient:red-blue</kbd> or <kbd>radial-gradient:#F00-#00F</kbd>).</td>
1202 </tr>
1203
1204 <tr>
1205 <td valign="top">SCANX</td>
1206 <td valign="top">R</td>
1207 <td valign="top">Import image from the default scanner device</td>
1208 <td valign="top">&nbsp;</td>
1209 </tr>
1210
1211 <tr>
1212 <td valign="top">STEGANO</td>
1213 <td valign="top">R</td>
1214 <td valign="top">Steganographic image</td>
1215 <td valign="top">Use <a href="../www/command-line-options.html#size">-size</a> command line option to specify width, height, and offset of the steganographic image</td>
1216 </tr>
1217
1218 <tr>
1219 <td valign="top">TILE</td>
1220 <td valign="top">R</td>
1221 <td valign="top">Tiled image</td>
1222 <td valign="top">Create a tiled version of an image at by tiling a image. Use <a href="../www/command-line-options.html#size">-size</a> to specify the tiled image size. The image is specified similar to
1223 <kbd>TILE:image.miff</kbd>.</td>
1224 </tr>
1225
1226 <tr>
1227 <td valign="top">UNIQUE</td>
1228 <td valign="top">W</td>
1229 <td valign="top">Write only unique pixels to the image file.</td>
1230 <td valign="top">&nbsp;</td>
1231 </tr>
1232
1233 <tr>
1234 <td valign="top">VID</td>
1235 <td valign="top">RW</td>
1236 <td valign="top">Visual Image Directory</td>
1237 <td valign="top">Used to create a thumbnailed directory (tiled thumbnails) of a set of images which may be used to select images to view via the <a href="../www/display.html">display</a> program, or saved to a <a href="#MIFF">MIFF</a> or <a href="#SHTML">SHTML</a> file.</td>
1238 </tr>
1239
1240 <tr>
1241 <td valign="top">WIN</td>
1242 <td valign="top">RW</td>
1243 <td valign="top">Select image from or display image to your computer screen</td>
1244 <td valign="top">Only supported under Microsoft Windows.</td>
1245 </tr>
1246
1247 <tr>
1248 <td valign="top">X</td>
1249 <td valign="top">RW</td>
1250 <td valign="top">Select image from or display image to your X server screen</td>
1251 <td valign="top">Also see the <a href="../www/import.html">import</a> and <a href="../www/display.html">display</a>
1252 programs.</td>
1253 </tr>
1254
1255 <tr>
1256 <td valign="top">XC</td>
1257 <td valign="top">R</td>
1258 <td valign="top">Canvas image of specified color</td>
1259 <td valign="top">Useful to create solid color <em>canvas</em> images. Use <a href="../www/command-line-options.html#size">-size</a> and <a href="../www/command-line-options.html#depth">-depth</a> to specify the image width, height, and depth. Example XC color specifications include <kbd>XC:red</kbd> and <kbd>XC:#FF0000M</kbd>.</td>
1260 </tr>
1261</table>
1262
1263</div>
1264
1265<h2><a name="builtin-images"></a>Built-in Images</h2>
1266<div class="doc-section">
1267
1268<p>ImageMagick includes a number of built-in (embedded) images which may be referenced as if they were an image file. The <kbd>magick:</kbd> format tag may be used via the syntax <kbd>magick:</kbd><em>name</em> to request an embedded image (e.g. <kbd>magick:logo</kbd>). For backwards compatibility, the image specifications <kbd>GRANITE:</kbd>, <kbd>LOGO:</kbd>, <kbd>NETSCAPE:</kbd>, and <kbd>ROSE:</kbd> may also be used to request images with those names.</p>
1269
1270<table class="doc">
1271 <tr>
1272 <th>Tag</th>
1273 <th>Mode</th>
1274 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1275 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1276 </tr>
1277
1278 <tr>
1279 <td valign="top">GRANITE</td>
1280 <td valign="top">R</td>
1281 <td valign="top">128x128 granite texture pattern</td>
1282 <td valign="top"><img src="../images/granite.png" width="100" height="26" alt="GRANITE"/></td>
1283 </tr>
1284
1285 <tr>
1286 <td valign="top"><a href="../images/logo.eps">LOGO</a></td>
1287 <td valign="top">R</td>
1288 <td valign="top">ImageMagick Logo, 640x480</td>
1289 <td valign="top">The ImageMagick <a href="../images/logo.jpg">logo</a>.</td>
1290 </tr>
1291
1292 <tr>
1293 <td valign="top"> NETSCAPE</td>
1294 <td valign="top">R</td>
1295 <td valign="top">image using colors in Netscape 216 (6x6x6 ) color cube, 216x144</td>
1296 <td valign="top">Most commonly used with the <a href="../www/convert.html">convert</a> and <a href="../www/mogrify.html">mogrify</a> programs with the <a href="../www/command-line-options.html#map">-map</a> option to create <em>web safe</em> images.</td>
1297 </tr>
1298
1299 <tr>
1300 <td valign="top">ROSE</td>
1301 <td valign="top">R</td>
1302 <td valign="top">Picture of a rose, 70x46</td>
1303 <td valign="top"><img src="../images/rose.png" width="70" height="46" alt="ROSE"/></td>
1304 </tr>
1305</table>
1306
1307</div>
1308
1309<h2><a name="builtin-patterns"></a>Built-in Patterns</h2>
1310<div class="doc-section">
1311
1312<p>ImageMagick includes a number of built-in (embedded) patterns which may be referenced as if they were an image file. The <kbd>pattern:</kbd> format tag may be used via the syntax <kbd>pattern:</kbd><em>name</em> to request an embedded pattern (e.g. <kbd>pattern:checkerboard</kbd>). The pattern size is controlled with the <a href="../www/command-line-options.html#size">-size</a> command line option.</p>
1313
1314<table class="doc">
1315 <tr>
1316 <th>Tag</th>
1317 <th>Mode</th>
1318 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1319 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1320 </tr>
1321
1322 <tr>
1323 <td valign="top">BRICKS</td>
1324 <td valign="top">R</td>
1325 <td valign="top">brick pattern, 16x16</td>
1326 <td valign="top"><img src="../images/patterns/bricks.png" width="100" height="26" alt="BRICKS" /></td>
1327 </tr>
1328
1329 <tr>
1330 <td valign="top">CHECKERBOARD</td>
1331 <td valign="top">R</td>
1332 <td valign="top">checkerboard pattern, 30x30</td>
1333 <td valign="top"><img src="../images/patterns/checkerboard.png" width="100" height="26" alt="CHECKERBOARD" /></td>
1334 </tr>
1335
1336 <tr>
1337 <td valign="top">CIRCLES</td>
1338 <td valign="top">R</td>
1339 <td valign="top">circles pattern, 16x16</td>
1340 <td valign="top"><img src="../images/patterns/circles.png" width="100" height="26" alt="CIRCLES"/></td>
1341 </tr>
1342
1343 <tr>
1344 <td valign="top">CROSSHATCH</td>
1345 <td valign="top">R</td>
1346 <td valign="top">crosshatch pattern, 8x4</td>
1347 <td valign="top"><img src="../images/patterns/crosshatch.png" width="100" height="26" alt="CROSSHATCH" /></td>
1348 </tr>
1349
1350 <tr>
1351 <td valign="top">CROSSHATCH30</td>
1352 <td valign="top">R</td>
1353 <td valign="top">crosshatch pattern with lines at 30 degrees, 8x4</td>
1354 <td valign="top"><img src="../images/patterns/crosshatch30.png" width="100" height="26" alt="CROSSHATCH30" /></td>
1355 </tr>
1356
1357 <tr>
1358 <td valign="top">CROSSHATCH45</td>
1359 <td valign="top">R</td>
1360 <td valign="top">crosshatch pattern with lines at 45 degrees, 8x4</td>
1361 <td valign="top"><img src="../images/patterns/crosshatch45.png" width="100" height="26" alt="CROSSHATCH45" /></td>
1362 </tr>
1363
1364 <tr>
1365 <td valign="top">FISHSCALES</td>
1366 <td valign="top">R</td>
1367 <td valign="top">fish scales pattern, 16x8</td>
1368 <td valign="top"><img src="../images/patterns/fishscales.png" width="100" height="26" alt="FISHSCALES" /></td>
1369 </tr>
1370
1371 <tr>
1372 <td valign="top">GRAY0</td>
1373 <td valign="top">R</td>
1374 <td valign="top">0% intensity gray, 32x32</td>
1375 <td valign="top"><img src="../images/patterns/gray0.png" width="100" height="32" alt="GRAY0" /></td>
1376 </tr>
1377
1378 <tr>
1379 <td valign="top">GRAY5</td>
1380 <td valign="top">R</td>
1381 <td valign="top">5% intensity gray, 32x32</td>
1382 <td valign="top"><img src="../images/patterns/gray5.png" width="100" height="32" alt="GRAY5" /></td>
1383 </tr>
1384
1385 <tr>
1386 <td valign="top">GRAY10</td>
1387 <td valign="top">R</td>
1388 <td valign="top">10% intensity gray, 32x32</td>
1389 <td valign="top"> <img src="../images/patterns/gray10.png" width="100" height="32" alt="GRAY10" /></td>
1390 </tr>
1391
1392 <tr>
1393 <td valign="top">GRAY15</td>
1394 <td valign="top">R</td>
1395 <td valign="top">15% intensity gray, 32x32</td>
1396 <td valign="top"><img src="../images/patterns/gray15.png" width="100" height="32" alt="GRAY15" /></td>
1397 </tr>
1398
1399 <tr>
1400 <td valign="top">GRAY20</td>
1401 <td valign="top">R</td>
1402 <td valign="top">20% intensity gray, 32x32</td>
1403 <td valign="top"><img src="../images/patterns/gray20.png" width="100" height="32" alt="GRAY20" /></td>
1404 </tr>
1405
1406 <tr>
1407 <td valign="top">GRAY25</td>
1408 <td valign="top">R</td>
1409 <td valign="top">25% intensity gray, 32x32</td>
1410 <td valign="top"><img src="../images/patterns/gray25.png" width="100" height="32" alt="GRAY25" /></td>
1411 </tr>
1412
1413 <tr>
1414 <td valign="top">GRAY30</td>
1415 <td valign="top">R</td>
1416 <td valign="top">30% intensity gray, 32x32</td>
1417 <td valign="top"><img src="../images/patterns/gray30.png" width="100" height="32" alt="GRAY30" /></td>
1418 </tr>
1419
1420 <tr>
1421 <td valign="top">GRAY35</td>
1422 <td valign="top">R</td>
1423 <td valign="top">35% intensity gray, 32x32</td>
1424 <td valign="top"><img src="../images/patterns/gray35.png" width="100" height="32" alt="GRAY35" /></td>
1425 </tr>
1426
1427 <tr>
1428 <td valign="top">GRAY40</td>
1429 <td valign="top">R</td>
1430 <td valign="top">40% intensity gray, 32x32</td>
1431 <td valign="top"><img src="../images/patterns/gray40.png" width="100" height="32" alt="GRAY40" /></td>
1432 </tr>
1433
1434 <tr>
1435 <td valign="top">GRAY45</td>
1436 <td valign="top">R</td>
1437 <td valign="top">45% intensity gray, 32x32</td>
1438 <td valign="top"><img src="../images/patterns/gray45.png" width="100" height="32" alt="GRAY45" /></td>
1439 </tr>
1440
1441 <tr>
1442 <td valign="top">GRAY50</td>
1443 <td valign="top">R</td>
1444 <td valign="top">50% intensity gray, 32x32</td>
1445 <td valign="top"><img src="../images/patterns/gray50.png" width="100" height="32" alt="GRAY50" /></td>
1446 </tr>
1447
1448 <tr>
1449 <td valign="top">GRAY55</td>
1450 <td valign="top">R</td>
1451 <td valign="top">55% intensity gray, 32x32</td>
1452 <td valign="top"><img src="../images/patterns/gray55.png" width="100" height="32" alt="GRAY55" /></td>
1453 </tr>
1454
1455 <tr>
1456 <td valign="top">GRAY60</td>
1457 <td valign="top">R</td>
1458 <td valign="top">60% intensity gray, 32x32</td>
1459 <td valign="top"><img src="../images/patterns/gray60.png" width="100" height="32" alt="GRAY60" /></td>
1460 </tr>
1461
1462 <tr>
1463 <td valign="top">GRAY65</td>
1464 <td valign="top">R</td>
1465 <td valign="top">65% intensity gray, 32x32</td>
1466 <td valign="top"><img src="../images/patterns/gray65.png" width="100" height="32" alt="GRAY65" /></td>
1467 </tr>
1468
1469 <tr>
1470 <td valign="top">GRAY70</td>
1471 <td valign="top">R</td>
1472 <td valign="top">70% intensity gray, 32x32</td>
1473 <td valign="top"><img src="../images/patterns/gray70.png" width="100" height="32" alt="GRAY70" /></td>
1474 </tr>
1475
1476 <tr>
1477 <td valign="top">GRAY75</td>
1478 <td valign="top">R</td>
1479 <td valign="top">75% intensity gray, 32x32</td>
1480 <td valign="top"><img src="../images/patterns/gray75.png" width="100" height="32" alt="GRAY75" /></td>
1481 </tr>
1482
1483 <tr>
1484 <td valign="top">GRAY80</td>
1485 <td valign="top">R</td>
1486 <td valign="top">80% intensity gray, 32x32</td>
1487 <td valign="top"> <img src="../images/patterns/gray80.png" width="100" height="32" alt="GRAY80" /></td>
1488 </tr>
1489
1490 <tr>
1491 <td valign="top">GRAY85</td>
1492 <td valign="top">R</td>
1493 <td valign="top">85% intensity gray, 32x32</td>
1494 <td valign="top"><img src="../images/patterns/gray85.png" width="100" height="32" alt="GRAY85" /></td>
1495 </tr>
1496
1497 <tr>
1498 <td valign="top">GRAY90</td>
1499 <td valign="top">R</td>
1500 <td valign="top">100% intensity gray, 32x32</td>
1501 <td valign="top"><img src="../images/patterns/gray90.png" width="100" height="32" alt="GRAY90" /></td>
1502 </tr>
1503
1504 <tr>
1505 <td valign="top">GRAY95</td>
1506 <td valign="top">R</td>
1507 <td valign="top">100% intensity gray, 32x32</td>
1508 <td valign="top"><img src="../images/patterns/gray95.png" width="100" height="32" alt="GRAY95" /></td>
1509 </tr>
1510
1511 <tr>
1512 <td valign="top">GRAY100</td>
1513 <td valign="top">R</td>
1514 <td valign="top">100% intensity gray, 32x32</td>
1515 <td valign="top"><img src="../images/patterns/gray100.png" width="100" height="32" alt="GRAY100" /></td>
1516 </tr>
1517
1518 <tr>
1519 <td valign="top">HEXAGONS</td>
1520 <td valign="top">R</td>
1521 <td valign="top">hexagon pattern, 30x18</td>
1522 <td valign="top"><img src="../images/patterns/hexagons.png" width="100" height="26" alt="HEXAGONS" /></td>
1523 </tr>
1524
1525 <tr>
1526 <td valign="top">HORIZONTAL</td>
1527 <td valign="top">R</td>
1528 <td valign="top">horizontal line pattern, 8x4</td>
1529 <td valign="top"><img src="../images/patterns/horizontal.png" width="100" height="26" alt="HORIZONTAL" /></td>
1530 </tr>
1531
1532 <tr>
1533 <td valign="top">HORIZONTALSAW</td>
1534 <td valign="top">R</td>
1535 <td valign="top">horizontal saw-tooth pattern, 16x8</td>
1536 <td valign="top"><img src="../images/patterns/horizontalsaw.png" width="100" height="26" alt="HORIZONTALSAW" /></td>
1537 </tr>
1538
1539 <tr>
1540 <td valign="top">HS_BDIAGONAL</td>
1541 <td valign="top">R</td>
1542 <td valign="top">backward diagonal line pattern (45 degrees slope), 8x8</td>
1543 <td valign="top"><img src="../images/patterns/hs_bdiagonal.png" width="100" height="26" alt="HS_BDIAGONAL" /></td>
1544 </tr>
1545
1546 <tr>
1547 <td valign="top">HS_CROSS</td>
1548 <td valign="top">R</td>
1549 <td valign="top">cross line pattern, 8x8</td>
1550 <td valign="top"><img src="../images/patterns/hs_cross.png" width="100" height="26" alt="HS_CROSS" /></td>
1551 </tr>
1552
1553 <tr>
1554 <td valign="top">HS_DIAGCROSS</td>
1555 <td valign="top">R</td>
1556 <td valign="top">diagonal line cross pattern (45 degrees slope), 8x8</td>
1557 <td valign="top"><img src="../images/patterns/hs_diagcross.png" width="100" height="26" alt="HS_DIAGCROSS" /></td>
1558 </tr>
1559
1560 <tr>
1561 <td valign="top">HS_FDIAGONAL</td>
1562 <td valign="top">R</td>
1563 <td valign="top">forward diagonal line pattern (45 degrees slope), 8x8</td>
1564 <td valign="top"><img src="../images/patterns/hs_fdiagonal.png" width="100" height="26" alt="HS_FDIAGONAL" /></td>
1565 </tr>
1566
1567 <tr>
1568 <td valign="top">HS_HORIZONTAL</td>
1569 <td valign="top">R</td>
1570 <td valign="top">horizontal line pattern, 8x8</td>
1571 <td valign="top"><img src="../images/patterns/hs_horizontal.png" width="100" height="26" alt="HS_HORIZONTAL" /></td>
1572 </tr>
1573
1574 <tr>
1575 <td valign="top">HS_VERTICAL</td>
1576 <td valign="top">R</td>
1577 <td valign="top">vertical line pattern, 8x8</td>
1578 <td valign="top"><img src="../images/patterns/hs_vertical.png" width="100" height="26" alt="HS_VERTICAL" /></td>
1579 </tr>
1580
1581 <tr>
1582 <td valign="top">LEFT30</td>
1583 <td valign="top">R</td>
1584 <td valign="top">forward diagonal pattern (30 degrees slope), 8x4</td>
1585 <td valign="top"><img src="../images/patterns/left30.png" width="100" height="26" alt="LEFT0" /></td>
1586 </tr>
1587
1588 <tr>
1589 <td valign="top">LEFT45</td>
1590 <td valign="top">R</td>
1591 <td valign="top">forward diagonal line pattern (45 degrees slope), 8x8</td>
1592 <td valign="top"><img src="../images/patterns/left45.png" width="100" height="26" alt="LEFT45" /></td>
1593 </tr>
1594
1595 <tr>
1596 <td valign="top">LEFTSHINGLE</td>
1597 <td valign="top">R</td>
1598 <td valign="top">left shingle pattern, 24x24</td>
1599 <td valign="top"><img src="../images/patterns/leftshingle.png" width="100" height="26" alt="LEFTSHINGLE" /></td>
1600 </tr>
1601
1602 <tr>
1603 <td valign="top">OCTAGONS</td>
1604 <td valign="top">R</td>
1605 <td valign="top">octagons pattern, 16x16</td>
1606 <td valign="top"><img src="../images/patterns/octagons.png" width="100" height="26" alt="OCTAGONS" /></td>
1607 </tr>
1608
1609 <tr>
1610 <td valign="top">RIGHT30</td>
1611 <td valign="top">R</td>
1612 <td valign="top">backward diagonal line pattern (30 degrees) 8x4</td>
1613 <td valign="top"><img src="../images/patterns/right30.png" width="100" height="26" alt="RIGHT30" /></td>
1614 </tr>
1615
1616 <tr>
1617 <td valign="top">RIGHT45</td>
1618 <td valign="top">R</td>
1619 <td valign="top">backward diagonal line pattern (30 degrees), 8x8</td>
1620 <td valign="top"><img src="../images/patterns/right45.png" width="100" height="26" alt="RIGHT45" /></td>
1621 </tr>
1622
1623 <tr>
1624 <td valign="top">RIGHTSHINGLE</td>
1625 <td valign="top">R</td>
1626 <td valign="top">right shingle pattern, 24x24</td>
1627 <td valign="top"><img src="../images/patterns/rightshingle.png" width="100" height="26" alt="RIGHTSHINGLE" /></td>
1628 </tr>
1629
1630 <tr>
1631 <td valign="top">SMALLFISHSCALES</td>
1632 <td valign="top">R</td>
1633 <td valign="top">small fish scales pattern, 8x8</td>
1634 <td valign="top"><img src="../images/patterns/smallfishscales.png" width="100" height="26" alt="SMALLFISHSCALES" /></td>
1635 </tr>
1636
1637 <tr>
1638 <td valign="top">VERTICAL</td>
1639 <td valign="top">R</td>
1640 <td valign="top">vertical line pattern, 8x8</td>
1641 <td valign="top"><img src="../images/patterns/vertical.png" width="100" height="26" alt="VERTICAL" /></td>
1642 </tr>
1643
1644 <tr>
1645 <td valign="top">VERTICALBRICKS</td>
1646 <td valign="top">R</td>
1647 <td valign="top">vertical brick pattern, 16x16</td>
1648 <td valign="top"><img src="../images/patterns/verticalbricks.png" width="100" height="26" alt="VERTICALBRICKS" /></td>
1649 </tr>
1650
1651 <tr>
1652 <td valign="top">VERTICALLEFTSHINGLE</td>
1653 <td valign="top">R</td>
1654 <td valign="top">vertical left shingle pattern, 24x24</td>
1655 <td valign="top"><img src="../images/patterns/verticalleftshingle.png" width="100" height="26" alt="VERTICALLEFTSHINGLE" /></td>
1656 </tr>
1657
1658 <tr>
1659 <td valign="top">VERTICALRIGHTSHINGLE</td>
1660 <td valign="top">R</td>
1661 <td valign="top">vertical right shingle pattern, 24x24</td>
1662 <td valign="top"><img src="../images/patterns/verticalrightshingle.png" width="100" height="26" alt="VERTICALRIGHTSHINGLE" /></td>
1663 </tr>
1664
1665 <tr>
1666 <td valign="top">VERTICALSAW</td>
1667 <td valign="top">R</td>
1668 <td valign="top">vertical saw-tooth pattern, 8x16</td>
1669 <td valign="top"><img src="../images/patterns/verticalsaw.png" width="100" height="26" alt="VERTICALSAW" /></td>
1670 </tr>
1671</table>
1672
1673</div>
1674
1675<h2><a name="embedded"></a>Embedded Image Profiles</h2>
1676<div class="doc-section">
1677
1678<p>ImageMagick provides a number of format identifiers which are used to add, remove, and save embedded profiles for images which can support embedded profiles. Image types which may contain embedded profiles are TIFF, JPEG, and PDF.</p>
1679
1680<table class="doc">
1681 <tbody>
1682 <tr>
1683 <th>Tag</th>
1684 <th>Mode</th>
1685 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1686 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1687 </tr>
1688
1689 <tr>
1690 <td valign="top">8BIM</td>
1691 <td valign="top">RW</td>
1692 <td valign="top">Photoshop resource format (binary)</td>
1693 <td valign="top">&nbsp;</td>
1694 </tr>
1695
1696 <tr>
1697 <td valign="top">8BIMTEXT</td>
1698 <td valign="top">RW</td>
1699 <td valign="top">Photoshop resource format (ASCII)</td>
1700 <td valign="top">An ASCII representation of the 8BIM format.</td>
1701 </tr>
1702
1703 <tr>
1704 <td valign="top">APP1</td>
1705 <td valign="top">RW</td>
1706 <td valign="top">Raw application information</td>
1707 <td valign="top">&nbsp;</td>
1708 </tr>
1709
1710 <tr>
1711 <td valign="top">APP1JPEG</td>
1712 <td valign="top">RW</td>
1713 <td valign="top">Raw JPEG binary data</td>
1714 <td valign="top">Profile in JPEG wrapper.</td>
1715 </tr>
1716
1717 <tr>
1718 <td valign="top">ICC</td>
1719 <td valign="top">RW</td>
1720 <td valign="top">International Color Consortium color profile</td>
1721 <td valign="top">Also known as <kbd>ICM</kbd>. To read, use <a href="../www/command-line-options.html#profile">-profile</a> with
1722 <a href="../www/convert.html">convert</a>.</td>
1723 </tr>
1724
1725 <tr>
1726 <td valign="top">IPTC</td>
1727 <td valign="top">RW</td>
1728 <td valign="top">IPTC Newsphoto (binary)</td>
1729 <td valign="top">To read, use <a href="../www/command-line-options.html#profile">-profile</a> with <a href="../www/convert.html">convert</a></td>
1730 </tr>
1731
1732 <tr>
1733 <td valign="top">IPTCTEXT</td>
1734 <td valign="top">RW</td>
1735 <td valign="top">IPTC Newsphoto (ASCII)</td>
1736 <td valign="top">An ASCII representation of the IPTC format.</td>
1737 </tr>
1738 </tbody>
1739</table>
1740
1741</div>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]1742
1743</div>
1744
1745<div id="linkbar">
1746 <!-- <span id="linkbar-west">&nbsp;</span> -->
1747 <span id="linkbar-center">
1748 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristyfe776f92010-02-21 02:51:21 +0000[diff] [blame^]1749 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]1750 </span>
1751 <span id="linkbar-east">&nbsp;</span>
1752 </div>
1753 <div class="footer">
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]1754 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]1755 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
1756 </div>
1757 <div style="clear: both; margin: 0; width: 100%; "></div>
1758</body>
1759</html>