Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 51853f03e9181eceecbfc5739f7c89613cf29a95 / . / www / formats.html
blob: 91bb9a45fa17245c20361b2e36084e095cc95377 [file] [log] [blame]
cristy3eaa0ef2010-03-06 20:35:26 +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>
6 <meta http-equiv="Content-Type" value="application/xhtml+xml" />
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"/>
cristy3eaa0ef2010-03-06 20:35:26 +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>
cristy3eaa0ef2010-03-06 20:35:26 +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>
cristy3eaa0ef2010-03-06 20:35:26 +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>
cristy3eaa0ef2010-03-06 20:35:26 +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>
cristy3eaa0ef2010-03-06 20:35:26 +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>
cristy3eaa0ef2010-03-06 20:35:26 +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>
cristy3eaa0ef2010-03-06 20:35:26 +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">
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]128 <a href="http://www.abi-stoff.de/abizeitung/" title="Abibuch">Abizeitung</a><!-- 20101101000200 -->
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]129</div>
130<div class="sponsor">
cristy8f900122010-03-05 15:26:31 +0000[diff] [blame]131 <a href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristy2fa94232010-02-21 16:03:23 +0000[diff] [blame]132</div>
133<div class="sponsor">
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]134 <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
cristy5f2356f2009-11-16 00:40:46 +0000[diff] [blame]135</div>
136<div class="sponsor">
cristycdbe2742010-02-07 19:30:44 +0000[diff] [blame]137 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
cristy2744bd92009-11-08 22:57:52 +0000[diff] [blame]138</div>
139<div class="sponsor">
140 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]141</div>
142<div class="sponsor">
143 <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
144</div>
145<div class="sponsor">
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]146 <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
cristyf3bb4782009-09-08 13:10:04 +0000[diff] [blame]147</div>
148<div class="sponsor">
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]149 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]150</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]151</div>
152</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]153
154
155</div>
156
157<div class="main">
158
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]159<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>
160
161<h2><a name="intro"></a>Introducing Image Formats</h2>
162<div class="doc-section">
163
164<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>
165
166<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>
167
168<p>To get a complete listing of which image formats are supported on your system, type</p>
169
170<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -list format</span></p>
171<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>
172
173</div>
174
175<h2><a name="supported"></a>Supported Image Formats</h2>
176<div class="doc-section">
177
178<p>ImageMagick supports reading over 100 major file formats (not
179including sub-formats). The following table provides a summary of
180the supported image formats.</p>
181
182<table class="doc">
183 <tbody>
184 <tr>
185 <th>Tag</th>
186 <th>Mode</th>
187 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]188 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]189 </tr>
190
191 <tr>
192 <td valign="top">ART</td>
193 <td valign="top">R</td>
194 <td valign="top">PFS: 1st Publisher</td>
195 <td valign="top">Format originally used on the Macintosh (MacPaint?) and later used for PFS: 1st Publisher clip art.</td>
196 </tr>
197
198 <tr>
199 <td valign="top">ARW</td>
200 <td valign="top">R</td>
201 <td valign="top">Sony Digital Camera Alpha Raw Image Format</td>
202 <td valign="top">&nbsp;</td>
203 </tr>
204
205 <tr>
206 <td valign="top"><a href="http://www.jmcgowan.com/avi.html">AVI</a></td>
207 <td valign="top">R</td>
208 <td valign="top">Microsoft Audio/Visual Interleaved</td>
209 <td valign="top">&nbsp;</td>
210 </tr>
211
212 <tr>
213 <td valign="top">AVS</td>
214 <td valign="top">RW</td>
215 <td valign="top">AVS X image</td>
216 <td valign="top">&nbsp;</td>
217 </tr>
218
219 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]220 <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]221 <td valign="top">RW</td>
222 <td valign="top">Microsoft Windows bitmap</td>
223 <td valign="top">&nbsp;</td>
224 </tr>
225
226 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]227 <td valign="top"><a href="http://www.fileformat.info/format/cals/egff.htm">CALS</a></td>
228 <td valign="top">R</td>
229 <td valign="top">Continuous Acquisition and Life-cycle Support Type 1 image</td>
230 <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>
231 </tr>
232
233 <tr>
234 <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]235 <td valign="top">R</td>
236 <td valign="top">Computer Graphics Metafile</td>
237 <td valign="top">Requires <a href="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">ralcgm</a> to render CGM files.</td>
238 </tr>
239
240 <tr>
241 <td valign="top"><a href="http://www.cineon.com/ff_draft.html">CIN</a></td>
242 <td valign="top">RW</td>
243 <td valign="top">Kodak Cineon Image Format</td>
244 <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>
245 </tr>
246
247 <tr>
248 <td valign="top">CMYK</td>
249 <td valign="top">RW</td>
250 <td valign="top">Raw cyan, magenta, yellow, and black samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]251 <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]252 </tr>
253
254 <tr>
255 <td valign="top">CMYKA</td>
256 <td valign="top">RW</td>
257 <td valign="top">Raw cyan, magenta, yellow, black, and alpha samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]258 <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]259 </tr>
260
261 <tr>
262 <td valign="top">CR2</td>
263 <td valign="top">R</td>
264 <td valign="top">Canon Digital Camera Raw Image Format</td>
265 <td valign="top">Requires an explicit image format otherwise the image is interpreted as a TIFF image (e.g. cr2:image.cr2).</td>
266 </tr>
267
268 <tr>
269 <td valign="top">CRW</td>
270 <td valign="top">R</td>
271 <td valign="top">Canon Digital Camera Raw Image Format</td>
272 <td valign="top">&nbsp;</td>
273 </tr>
274
275 <tr>
276 <td valign="top">CUR</td>
277 <td valign="top">R</td>
278 <td valign="top">Microsoft Cursor Icon</td>
279 <td valign="top">&nbsp;</td>
280 </tr>
281
282 <tr>
283 <td valign="top">CUT</td>
284 <td valign="top">R</td>
285 <td valign="top">DR Halo</td>
286 <td valign="top">&nbsp;</td>
287 </tr>
288
289 <tr>
290 <td valign="top">DCM</td>
291 <td valign="top">R</td>
292 <td valign="top">Digital Imaging and Communications in Medicine (DICOM) image</td>
293 <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>
294 </tr>
295
296 <tr>
297 <td valign="top">DCR</td>
298 <td valign="top">R</td>
299 <td valign="top">Kodak Digital Camera Raw Image File</td>
300 <td valign="top">&nbsp;</td>
301 </tr>
302
303 <tr>
304 <td valign="top">DCX</td>
305 <td valign="top">RW</td>
306 <td valign="top">ZSoft IBM PC multi-page Paintbrush image</td>
307 <td valign="top">&nbsp;</td>
308 </tr>
309
310 <tr>
311 <td valign="top">DIB</td>
312 <td valign="top">RW</td>
313 <td valign="top">Microsoft Windows Device Independent Bitmap</td>
314 <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>
315 </tr>
316
317 <tr>
318 <td valign="top"><a href="http://www.libdjvu.org/">DJVU</a></td>
319 <td valign="top">R</td>
320 <td valign="top"></td>
321 <td valign="top"></td>
322 </tr>
323
324 <tr>
325 <td valign="top"><a href="http://www.adobe.com/products/dng/main.html">DNG</a></td>
326 <td valign="top">R</td>
327 <td valign="top">Digital Negative</td>
328 <td valign="top">Requires an explicit image format otherwise the image is interpreted as a TIFF image (e.g. dng:image.dng).</td>
329 </tr>
330
331 <tr>
332 <td valign="top"><a href="http://www.graphviz.org">DOT</a></td>
333 <td valign="top">R</td>
334 <td valign="top">Graph Visualization</td>
335 <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>
336 </tr>
337
338 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]339 <td valign="top"><a href="../www/motion-picture.html">DPX</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]340 <td valign="top">RW</td>
341 <td valign="top">SMPTE Digital Moving Picture Exchange 2.0 (SMPTE 268M-2003)</td>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]342 <td valign="top">&nbsp;</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]343 </tr>
344
345 <tr>
346 <td valign="top">EMF</td>
347 <td valign="top">R</td>
348 <td valign="top">Microsoft Enhanced Metafile (32-bit)</td>
349 <td valign="top">Only available under Microsoft Windows.</td>
350 </tr>
351
352 <tr>
353 <td valign="top">EPDF</td>
354 <td valign="top">RW</td>
355 <td valign="top">Encapsulated Portable Document Format</td>
356 <td valign="top">&nbsp;</td>
357 </tr>
358
359 <tr>
360 <td valign="top">EPI</td>
361 <td valign="top">RW</td>
362 <td valign="top">Adobe Encapsulated PostScript Interchange format</td>
363 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
364 </tr>
365
366 <tr>
367 <td valign="top">EPS</td>
368 <td valign="top">RW</td>
369 <td valign="top">Adobe Encapsulated PostScript</td>
370 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
371 </tr>
372
373 <tr>
374 <td valign="top">EPS2</td>
375 <td valign="top">W</td>
376 <td valign="top">Adobe Level II Encapsulated PostScript</td>
377 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
378 </tr>
379
380 <tr>
381 <td valign="top">EPS3</td>
382 <td valign="top">W</td>
383 <td valign="top">Adobe Level III Encapsulated PostScript</td>
384 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
385 </tr>
386
387 <tr>
388 <td valign="top">EPSF</td>
389 <td valign="top">RW</td>
390 <td valign="top">Adobe Encapsulated PostScript</td>
391 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
392 </tr>
393
394 <tr>
395 <td valign="top">EPSI</td>
396 <td valign="top">RW</td>
397 <td valign="top">Adobe Encapsulated PostScript Interchange format</td>
398 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
399 </tr>
400
401 <tr>
402 <td valign="top">EPT</td>
403 <td valign="top">RW</td>
404 <td valign="top">Adobe Encapsulated PostScript Interchange format with <a href="#TIFF">TIFF</a> preview</td>
405 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
406 </tr>
407
408 <tr>
409 <td valign="top"><a href="http://www.openexr.org">EXR</a></td>
410 <td valign="top">RW</td>
411 <td valign="top">High dynamic-range (HDR) file format developed by Industrial Light &amp; Magic</td>
412 <td valign="top">See <a href="../www/high-dynamic-range.html">High Dynamic-Range Images</a> for details on this image format.</td>
413 </tr>
414
415 <tr>
416 <td valign="top">FAX</td>
417 <td valign="top">RW</td>
418 <td valign="top">Group 3 TIFF</td>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]419 <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]420 </tr>
421
422 <tr>
423 <td valign="top"><a href="http://homepage.usask.ca/~ijm451/fig/">FIG</a></td>
424 <td valign="top">R</td>
425 <td valign="top">FIG graphics format</td>
426 <td valign="top">Requires <a href="ftp://ftp.x.org/contrib/applications/drawing_tools/transfig">TransFig</a>.</td>
427 </tr>
428
429 <tr>
430 <td valign="top"><a href="http://www.cv.nrao.edu/fits/">FITS</a></td>
431 <td valign="top">RW</td>
432 <td valign="top">Flexible Image Transport System</td>
433 <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>
434 </tr>
435
436 <tr>
437 <td valign="top">FPX</td>
438 <td valign="top">RW</td>
439 <td valign="top">FlashPix Format</td>
440 <td valign="top">Requires <a href="ftp://ftp.imagemagick.com/pub/ImageMagick/delegates">FlashPix SDK</a>.</td>
441 </tr>
442
443 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]444 <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]445 <td valign="top">RW</td>
446 <td valign="top">CompuServe Graphics Interchange Format</td>
447 <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>
448 </tr>
449
450 <tr>
451 <td valign="top">GPLT</td>
452 <td valign="top">R</td>
453 <td valign="top">Gnuplot plot files</td>
454 <td valign="top">Requires <a href="http://www.gnuplot.info/">gnuplot4.0.tar.Z</a> or later.</td>
455 </tr>
456
457 <tr>
458 <td valign="top">GRAY</td>
459 <td valign="top">RW</td>
460 <td valign="top">Raw gray samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]461 <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]462 </tr>
463
464 <tr>
465 <td valign="top">HALD</td>
466 <td valign="top">R</td>
467 <td valign="top">Identity Hald CLUT Image</td
468 <td valign="top">Select order with filename, e.g. hald:5 for order 5.</td>
469 </tr>
470
471 <tr>
472 <td valign="top">HPGL</td>
473 <td valign="top">R</td>
474 <td valign="top">HP-GL plotter language</td>
475 <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>
476 </tr>
477
478 <tr>
479 <td valign="top">HRZ</td>
480 <td valign="top">RW</td>
481 <td valign="top">Slow Scane TeleVision</td>
482 <td valign="top">&nbsp;</td>
483 </tr>
484
485 <tr>
486 <td valign="top">HTML</td>
487 <td valign="top">RW</td>
488 <td valign="top">Hypertext Markup Language with a client-side image map</td>
489 <td valign="top">Also known as <kbd>HTM</kbd>. Requires <a href="http://www.tdb.uu.se/%7Ejan/">html2ps</a> to read.</td>
490 </tr>
491
492 <tr>
493 <td valign="top">ICO</td>
494 <td valign="top">R</td>
495 <td valign="top">Microsoft icon</td>
496 <td valign="top">Also known as <kbd>ICON</kbd>.</td>
497 </tr>
498
499 <tr>
500 <td valign="top">INFO</td>
501 <td valign="top">W</td>
502 <td valign="top">Format and characteristics of the image</td>
503 <td valign="top"></td>
504 </tr>
505
506 <tr>
507 <td valign="top">INLINE</td>
508 <td valign="top">R</td>
509 <td valign="top">Base64-encoded inline image</td>
510 <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>
511 </tr>
512
513 <tr>
514 <td valign="top">JBIG</td>
515 <td valign="top">RW</td>
516 <td valign="top">Joint Bi-level Image experts Group file interchange format</td>
517 <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>
518 </tr>
519
520 <tr>
521 <td valign="top"><a href="http://www.libmng.com/">JNG</a></td>
522 <td valign="top">RW</td>
523 <td valign="top">Multiple-image Network Graphics</td>
524 <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>
525 </tr>
526
527 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]528 <td valign="top"><a href="http://www.ece.uvic.ca/%7Emdadams/jasper/">JP2</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]529 <td valign="top">RW</td>
530 <td valign="top">JPEG-2000 JP2 File Format Syntax</td>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]531 <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]532 </tr>
533
534 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]535 <td valign="top"><a href="http://www.ece.uvic.ca/%7Emdadams/jasper/">JPC</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]536 <td valign="top">RW</td>
537 <td valign="top">JPEG-2000 Code Stream Syntax</td>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]538 <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]539 </tr>
540
541 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]542 <td valign="top"><a href="http://www.jpeg.org/">JPEG</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]543 <td valign="top">RW</td>
544 <td valign="top">Joint Photographic Experts Group JFIF format</td>
cristyec407392009-11-28 22:42:05 +0000[diff] [blame]545 <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]546 </tr>
547
548 <tr>
549 <td valign="top">MAN</td>
550 <td valign="top">R</td>
551 <td valign="top">Unix reference manual pages</td>
552 <td valign="top">Requires that GNU groff and Ghostcript are installed.</td>
553 </tr>
554
555 <tr>
556 <td valign="top">MAT</td>
557 <td valign="top">R</td>
558 <td valign="top">MATLAB image format</td>
559 <td valign="top">&nbsp;</td>
560 </tr>
561
562 <tr>
563 <td valign="top"><a href="../www/miff.html">MIFF</a></td>
564 <td valign="top">RW</td>
565 <td valign="top">Magick image file format</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]566 <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]567 </tr>
568
569 <tr>
570 <td valign="top">MONO</td>
571 <td valign="top">RW</td>
572 <td valign="top">Bi-level bitmap in least-significant-byte first order</td>
573 <td valign="top">&nbsp;</td>
574 </tr>
575
576 <tr>
577 <td valign="top"><a href="http://www.libpng.org/pub/mng/">MNG</a></td>
578 <td valign="top">RW</td>
579 <td valign="top">Multiple-image Network Graphics</td>
580 <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>
581 </tr>
582
583 <tr>
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]584 <td valign="top"><a href="http://www.mpeg.org/">M2V</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]585 <td valign="top">RW</td>
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]586 <td valign="top">Motion Picture Experts Group file interchange format (version 2)</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]587 <td valign="top">Requires <a href="ftp://ftp.mpeg.org/pub/mpeg/mssg/">mpeg2vidcodec_v12.tar.gz</a>.</td>
588 </tr>
589
590 <tr>
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]591 <td valign="top"><a href="http://www.mpeg.org/">MPEG</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]592 <td valign="top">RW</td>
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]593 <td valign="top">Motion Picture Experts Group file interchange format (version 1)</td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]594 <td valign="top">Requires <a href="ftp://ftp.mpeg.org/pub/mpeg/mssg/">mpeg2vidcodec_v12.tar.gz</a>.</td>
595 </tr>
596
597 <tr>
598 <td valign="top">MPC</td>
599 <td valign="top">RW</td>
600 <td valign="top">Magick Persistent Cache image file format</td>
601 <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>
602 </tr>
603
604 <tr>
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]605 <td valign="top">MPR</td>
606 <td valign="top">RW</td>
607 <td valign="top">Magick Persistent Registry</td>
608 <td valign="top">This format permits you to write to and read images from memory. The image persists until the program exits. For example, let's use the MPR to create a checkerboard:
609<pre class="text">
610convert \( -size 15x15 xc:black xc:white -append \) \
611 \( +clone -flip \) +append -write mpr:checkers +delete \
612 -size 240x240 tile:mpr:checkers board.png
613</pre></td>
614 </tr>
615
616 <tr>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]617 <td valign="top">MRW</td>
618 <td valign="top">R</td>
619 <td valign="top">Sony (Minolta) Raw Image File</td>
620 <td valign="top">&nbsp;</td>
621 </tr>
622
623 <tr>
624 <td valign="top">MSL</td>
625 <td valign="top">RW</td>
626 <td valign="top">Magick Scripting Language</td>
627 <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>
628 </tr>
629
630 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]631 <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]632 <td valign="top">RW</td>
633 <td valign="top">MTV Raytracing image format</td>
634 <td valign="top">&nbsp;</td>
635 </tr>
636
637 <tr>
638 <td valign="top"><a href="../www/magick-vector-graphics.html">MVG</a></td>
639 <td valign="top">RW</td>
640 <td valign="top">Magick Vector Graphics.</td>
641 <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>
642 </tr>
643
644 <tr>
645 <td valign="top">NEF</td>
646 <td valign="top">R</td>
647 <td valign="top">Nikon Digital SLR Camera Raw Image File</td>
648 <td valign="top">&nbsp;</td>
649 </tr>
650
651 <tr>
652 <td valign="top">ORF</td>
653 <td valign="top">R</td>
654 <td valign="top">Olympus Digital Camera Raw Image File</td>
655 <td valign="top">&nbsp;</td>
656 </tr>
657
658 <tr>
659 <td valign="top">OTB</td>
660 <td valign="top">RW</td>
661 <td valign="top">On-the-air Bitmap</td>
662 <td valign="top">&nbsp;</td>
663 </tr>
664
665 <tr>
666 <td valign="top">P7</td>
667 <td valign="top">RW</td>
668 <td valign="top">Xv's Visual Schnauzer thumbnail format</td>
669 <td valign="top">&nbsp;</td>
670 </tr>
671
672 <tr>
673 <td valign="top">PALM</td>
674 <td valign="top">RW</td>
675 <td valign="top">Palm pixmap</td>
676 <td valign="top">&nbsp;</td>
677 </tr>
678
679 <tr>
680 <td valign="top">PAM</td>
681 <td valign="top">W</td>
682 <td valign="top">Common 2-dimensional bitmap format</td>
683 <td valign="top">&nbsp;</td>
684 </tr>
685
686 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]687 <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]688 <td valign="top">RW</td>
689 <td valign="top">Portable bitmap format (black and white)</td>
690 <td valign="top">&nbsp;</td>
691 </tr>
692
693 <tr>
694 <td valign="top">PCD</td>
695 <td valign="top">RW</td>
696 <td valign="top">Photo CD</td>
697 <td valign="top">The maximum resolution written is 768x512 pixels since larger images require huffman compression (which is not supported).</td>
698 </tr>
699
700 <tr>
701 <td valign="top">PCDS</td>
702 <td valign="top">RW</td>
703 <td valign="top">Photo CD</td>
704 <td valign="top">Decode with the sRGB color tables.</td>
705 </tr>
706
707 <tr>
708 <td valign="top">PCL</td>
709 <td valign="top">W</td>
710 <td valign="top">HP Page Control Language</td>
cristyc1c61662009-09-30 14:04:37 +0000[diff] [blame]711 <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]712 </tr>
713
714 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]715 <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]716 <td valign="top">RW</td>
717 <td valign="top">ZSoft IBM PC Paintbrush file</td>
718 <td valign="top">&nbsp;</td>
719 </tr>
720
721 <tr>
722 <td valign="top">PDB</td>
723 <td valign="top">RW</td>
724 <td valign="top">Palm Database ImageViewer Format</td>
725 <td valign="top">&nbsp;</td>
726 </tr>
727
728 <tr>
729 <td valign="top">PDF</td>
730 <td valign="top">RW</td>
731 <td valign="top">Portable Document Format</td>
cristy48dd1af2009-10-02 01:21:56 +0000[diff] [blame]732 <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]733 </tr>
734
735 <tr>
736 <td valign="top">PEF</td>
737 <td valign="top">R</td>
738 <td valign="top">Pentax Electronic File</td>
739 <td valign="top">Requires an explicit image format otherwise the image is interpreted as a TIFF image (e.g. pef:image.pef).</td>
740 </tr>
741
742 <tr>
743 <td valign="top">PFA</td>
744 <td valign="top">R</td>
745 <td valign="top">Postscript Type 1 font (ASCII)</td>
746 <td valign="top">Opening as file returns a preview image.</td>
747 </tr>
748
749 <tr>
750 <td valign="top">PFB</td>
751 <td valign="top">R</td>
752 <td valign="top">Postscript Type 1 font (binary)</td>
753 <td valign="top">Opening as file returns a preview image.</td>
754 </tr>
755
756 <tr>
757 <td valign="top">PFM</td>
758 <td valign="top">RW</td>
759 <td valign="top">Portable float map format</td>
760 <td valign="top">&nbsp;</td>
761 </tr>
762
763 <tr>
764 <td valign="top">PGM</td>
765 <td valign="top">RW</td>
766 <td valign="top">Portable graymap format (gray scale)</td>
767 <td valign="top">&nbsp;</td>
768 </tr>
769
770 <tr>
771 <td valign="top">PICON</td>
772 <td valign="top">RW</td>
773 <td valign="top">Personal Icon</td>
774 <td valign="top">&nbsp;</td>
775 </tr>
776
777 <tr>
778 <td valign="top">PICT</td>
779 <td valign="top">RW</td>
780 <td valign="top">Apple Macintosh QuickDraw/PICT file</td>
781 <td valign="top">&nbsp;</td>
782 </tr>
783
784 <tr>
785 <td valign="top">PIX</td>
786 <td valign="top">R</td>
787 <td valign="top">Alias/Wavefront RLE image format</td>
788 <td valign="top">&nbsp;</td>
789 </tr>
790
791 <tr>
792 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG</a></td>
793 <td valign="top">RW</td>
794 <td valign="top">Portable Network Graphics</td>
cristye6378132009-10-26 20:05:17 +0000[diff] [blame]795 <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]796 </tr>
797
798 <tr>
799 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG8</a></td>
800 <td valign="top">RW</td>
801 <td valign="top">Portable Network Graphics</td>
802 <td valign="top">8-bit indexed with optional binary transparency</td>
803 </tr>
804
805 <tr>
806 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG24</a></td>
807 <td valign="top">RW</td>
808 <td valign="top">Portable Network Graphics</td>
809 <td valign="top">opaque 24-bit RGB</td>
810 </tr>
811
812 <tr>
813 <td valign="top"><a href="http://www.libpng.org/pub/png/">PNG32</a></td>
814 <td valign="top">RW</td>
815 <td valign="top">Portable Network Graphics</td>
816 <td valign="top">opaque or transparent 32-bit RGBA</td>
817 </tr>
818
819 <tr>
820 <td valign="top">PNM</td>
821 <td valign="top">RW</td>
822 <td valign="top">Portable anymap</td>
823 <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>
824 </tr>
825
826 <tr>
827 <td valign="top">PPM</td>
828 <td valign="top">RW</td>
829 <td valign="top">Portable pixmap format (color)</td>
830 <td valign="top">&nbsp;</td>
831 </tr>
832
833 <tr>
834 <td valign="top">PS</td>
835 <td valign="top">RW</td>
836 <td valign="top">Adobe PostScript file</td>
cristy48dd1af2009-10-02 01:21:56 +0000[diff] [blame]837 <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]838 </tr>
839
840 <tr>
841 <td valign="top">PS2</td>
842 <td valign="top">RW</td>
843 <td valign="top">Adobe Level II PostScript file</td>
844 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
845 </tr>
846
847 <tr>
848 <td valign="top">PS3</td>
849 <td valign="top">RW</td>
850 <td valign="top">Adobe Level III PostScript file</td>
851 <td valign="top">Requires <a href="http://www.cs.wisc.edu/%7Eghost">Ghostscript</a> to read.</td>
852 </tr>
853
854 <tr>
855 <td valign="top">PSD</td>
856 <td valign="top">RW</td>
857 <td valign="top">Adobe Photoshop bitmap file</td>
858 <td valign="top">&nbsp;</td>
859 </tr>
860
861 <tr>
862 <td valign="top">PTIF</td>
863 <td valign="top">RW</td>
864 <td valign="top">Pyramid encoded <a href="#TIFF">TIFF</a></td>
865 <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>
866 </tr>
867
868 <tr>
869 <td valign="top"><a href="http://www.photoworks.com/">PWP</a></td>
870 <td valign="top">R</td>
871 <td valign="top">Seattle File Works multi-image file</td>
872 <td valign="top">&nbsp;</td>
873 </tr>
874
875 <tr>
876 <td valign="top">RAD</td>
877 <td valign="top">R</td>
878 <td valign="top">Radiance image file</td>
879 <td valign="top">Requires that <i>ra_ppm</i> from the Radiance software package be installed.</td>
880 </tr>
881
882 <tr>
883 <td valign="top">RAF</td>
884 <td valign="top">R</td>
885 <td valign="top">Fuji CCD-RAW Graphic File</td>
886 <td valign="top">&nbsp;</td>
887 </tr>
888
889 <tr>
890 <td valign="top">RGB</td>
891 <td valign="top">RW</td>
892 <td valign="top">Raw red, green, and blue samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]893 <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]894 </tr>
895
896 <tr>
897 <td valign="top">RGBA</td>
898 <td valign="top">RW</td>
899 <td valign="top">Raw red, green, blue, and alpha samples</td>
cristy16ff93c2010-01-13 23:18:07 +0000[diff] [blame]900 <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]901 </tr>
902
903 <tr>
904 <td valign="top">RLA</td>
905 <td valign="top">R</td>
906 <td valign="top">Alias/Wavefront image file</td>
907 <td valign="top">&nbsp;</td>
908 </tr>
909
910 <tr>
911 <td valign="top">RLE</td>
912 <td valign="top">R</td>
913 <td valign="top">Utah Run length encoded image file</td>
914 <td valign="top">&nbsp;</td>
915 </tr>
916
917 <tr>
918 <td valign="top"><a href="http://www.oreilly.com/www/centers/gff/formats/scitex/">SCT</a></td>
919 <td valign="top">R</td>
920 <td valign="top">Scitex Continuous Tone Picture</td>
921 <td valign="top">&nbsp;</td>
922 </tr>
923
924 <tr>
925 <td valign="top"><a href="http://www.photoworks.com/">SFW</a></td>
926 <td valign="top">R</td>
927 <td valign="top">Seattle File Works image</td>
928 <td valign="top">&nbsp;</td>
929 </tr>
930
931 <tr>
932 <td valign="top">SGI</td>
933 <td valign="top">RW</td>
934 <td valign="top">Irix RGB image</td>
935 <td valign="top">&nbsp;</td>
936 </tr>
937
938 <tr>
939 <td valign="top">SHTML</td>
940 <td valign="top">W</td>
941 <td valign="top">Hypertext Markup Language client-side image map</td>
942 <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>
943 </tr>
944
945 <tr>
946 <td valign="top">SUN</td>
947 <td valign="top">RW</td>
948 <td valign="top">SUN Rasterfile</td>
949 <td valign="top">&nbsp;</td>
950 </tr>
951
952 <tr>
953 <td valign="top"><a href="http://www.w3.org/Graphics/SVG">SVG</a></td>
954 <td valign="top">RW</td>
955 <td valign="top">Scalable Vector Graphics</td>
956 <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>
957 </tr>
958
959 <tr>
960 <td valign="top">TGA</td>
961 <td valign="top">RW</td>
962 <td valign="top">Truevision Targa image</td>
963 <td valign="top">Also known as formats <kbd>ICB</kbd>, <kbd>VDA</kbd>, and <kbd>VST</kbd>.</td>
964 </tr>
965
966 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]967 <td valign="top"><a href="http://www.remotesensing.org/libtiff/">TIFF</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]968 <td valign="top">RW</td>
969 <td valign="top">Tagged Image File Format</td>
970 <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>
971 </tr>
972
973 <tr>
974 <td valign="top">TIM</td>
975 <td valign="top">R</td>
976 <td valign="top">PSX TIM file</td>
977 <td valign="top">&nbsp;</td>
978 </tr>
979
980 <tr>
981 <td valign="top"><a href="http://www.freetype.org/">TTF</a></td>
982 <td valign="top">R</td>
983 <td valign="top">TrueType font file</td>
984 <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>
985 </tr>
986
987 <tr>
988 <td valign="top">TXT</td>
989 <td valign="top">RW</td>
990 <td valign="top">Raw text file</td>
991 <td valign="top">&nbsp;</td>
992 </tr>
993
994 <tr>
995 <td valign="top">UIL</td>
996 <td valign="top">W</td>
997 <td valign="top">X-Motif UIL table</td>
998 <td valign="top">&nbsp;</td>
999 </tr>
1000
1001 <tr>
1002 <td valign="top">UYVY</td>
1003 <td valign="top">RW</td>
1004 <td valign="top">Interleaved YUV raw image</td>
1005 <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>
1006 </tr>
1007
1008 <tr>
1009 <td valign="top">VICAR</td>
1010 <td valign="top">RW</td>
1011 <td valign="top">VICAR rasterfile format</td>
1012 <td valign="top">&nbsp;</td>
1013 </tr>
1014
1015 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1016 <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]1017 <td valign="top">RW</td>
1018 <td valign="top">Khoros Visualization Image File Format</td>
1019 <td valign="top">&nbsp;</td>
1020 </tr>
1021
1022 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1023 <td valign="top"><a href="http://www.openmobilealliance.org/Technical/wapindex.aspx">WBMP</a></td>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1024 <td valign="top">RW</td>
1025 <td valign="top">Wireless bitmap</td>
1026 <td valign="top">Support for uncompressed monochrome only.</td>
1027 </tr>
1028
1029 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1030 <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]1031 <td valign="top">R</td>
1032 <td valign="top">Windows Metafile</td>
1033 <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>
1034 </tr>
1035
1036 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1037 <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]1038 <td valign="top">R</td>
1039 <td valign="top">Word Perfect Graphics File</td>
1040 <td valign="top">&nbsp;</td>
1041 </tr>
1042
1043 <tr>
1044 <td valign="top">X</td>
1045 <td valign="top">RW</td>
1046 <td valign="top">display or import an image to or from an X11 server</td>
1047 <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>
1048 </tr>
1049
1050 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1051 <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]1052 <td valign="top">RW</td>
1053 <td valign="top">X Windows system bitmap, black and white only</td>
1054 <td valign="top">Used by the X Windows System to store monochrome icons.</td>
1055 </tr>
1056
1057 <tr>
1058 <td valign="top">XCF</td>
1059 <td valign="top">R</td>
1060 <td valign="top">GIMP image</td>
1061 <td valign="top">&nbsp;</td>
1062 </tr>
1063
1064 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1065 <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]1066 <td valign="top">RW</td>
1067 <td valign="top">X Windows system pixmap</td>
1068 <td valign="top">Also known as <kbd>PM</kbd>. Used by the X Windows System to store color icons.</td>
1069 </tr>
1070
1071 <tr>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1072 <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]1073 <td valign="top">RW</td>
1074 <td valign="top">X Windows system window dump</td>
1075 <td valign="top">Used by the X Windows System to save/display screen dumps.</td>
1076 </tr>
1077
1078 <tr>
1079 <td valign="top">X3F</td>
1080 <td valign="top">R</td>
1081 <td valign="top">Sigma Camera RAW Picture File</td>
1082 <td valign="top">&nbsp;</td>
1083 </tr>
1084
1085 <tr>
1086 <td valign="top">YCbCr</td>
1087 <td valign="top">RW</td>
1088 <td valign="top">Raw Y, Cb, and Cr samples</td>
1089 <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>
1090 </tr>
1091
1092 <tr>
1093 <td valign="top">YCbCrA</td>
1094 <td valign="top">RW</td>
1095 <td valign="top">Raw Y, Cb, Cr, and alpha samples</td>
1096 <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>
1097 </tr>
1098
1099 <tr>
1100 <td valign="top">YUV</td>
1101 <td valign="top">RW</td>
1102 <td valign="top">CCIR 601 4:1:1</td>
1103 <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>
1104 </tr>
1105 </tbody>
1106</table>
1107
1108</div>
1109
1110<h2><a name="pseudo"></a>Pseudo-image Formats</h2>
1111<div class="doc-section">
1112
1113<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>
1114
1115<table class="doc">
1116 <tr>
1117 <th>Tag</th>
1118 <th>Mode</th>
1119 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1120 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1121 </tr>
1122
1123 <tr>
1124 <td valign="top">CAPTION</td>
1125 <td valign="top">R</td>
1126 <td valign="top">Image caption</td>
1127 <td valign="top">&nbsp;</td>
1128 </tr>
1129
1130 <tr>
1131 <td valign="top">CLIPBOARD</td>
1132 <td valign="top">RW</td>
1133 <td valign="top">Windows Clipboard</td>
1134 <td valign="top">Only available under Microsoft Windows.</td>
1135 </tr>
1136
1137 <tr>
1138 <td valign="top">FRACTAL</td>
1139 <td valign="top">R</td>
1140 <td valign="top">Plasma fractal image</td>
1141 <td valign="top">&nbsp;</td>
1142 </tr>
1143
1144 <tr>
1145 <td valign="top">GRADIENT</td>
1146 <td valign="top">R</td>
1147 <td valign="top">Gradual passing from one shade to another</td>
1148 <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>
1149 </tr>
1150
1151 <tr>
1152 <td valign="top">HISTOGRAM</td>
1153 <td valign="top">W</td>
1154 <td valign="top">Histogram of the image</td>
1155 <td valign="top">&nbsp;</td>
1156 </tr>
1157
1158 <tr>
1159 <td valign="top">LABEL</td>
1160 <td valign="top">R</td>
1161 <td valign="top">Text image format</td>
1162 <td valign="top">Specify the desired text as the filename (e.g. <kbd>label:"This a label"</kbd>).</td>
1163 </tr>
1164
1165 <tr>
1166 <td valign="top">MAP</td>
1167 <td valign="top">RW</td>
1168 <td valign="top">Colormap intensities and indices</td>
1169 <td valign="top">Set -depth to set the sample size of the intensities; indices are 16-bit if colors &gt; 256.</td>
1170 </tr>
1171
1172 <tr>
1173 <td valign="top">MATTE</td>
1174 <td valign="top">W</td>
1175 <td valign="top">MATTE format</td>
1176 <td valign="top">Write only.</td>
1177 </tr>
1178
1179 <tr>
1180 <td valign="top">NULL</td>
1181 <td valign="top">RW</td>
1182 <td valign="top">NULL image</td>
1183 <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>
1184 </tr>
1185
1186 <tr>
1187 <td valign="top">PLASMA</td>
1188 <td valign="top">R</td>
1189 <td valign="top">Plasma fractal image</td>
1190 <td valign="top">&nbsp;</td>
1191 </tr>
1192
1193 <tr>
1194 <td valign="top">PREVIEW</td>
1195 <td valign="top">W</td>
1196 <td valign="top">Show a preview an image enhancement, effect, or f/x</td>
1197 <td valign="top">Creates a preview montage of images prepared over a parameteric range in order to assist with parameter selection. Specify the desired
1198 preview type via the -preview option).</td>
1199 </tr>
1200
1201 <tr>
1202 <td valign="top">PRINT</td>
1203 <td valign="top">W</td>
1204 <td valign="top">Send image to your computer printer</td>
1205 <td valign="top">Unix users may set the PRINTER (for 'lpr') or LPDEST (for 'lp') environment variables to select the desired printer.</td>
1206 </tr>
1207
1208 <tr>
1209 <td valign="top">SCAN</td>
1210 <td valign="top">R</td>
1211 <td valign="top">Import image from a scanner device</td>
1212 <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>
1213 </tr>
1214
1215 <tr>
1216 <td valign="top">RADIAL_GRADIENT</td>
1217 <td valign="top">R</td>
1218 <td valign="top">Gradual radial passing from one shade to another</td>
1219 <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>
1220 </tr>
1221
1222 <tr>
1223 <td valign="top">SCANX</td>
1224 <td valign="top">R</td>
1225 <td valign="top">Import image from the default scanner device</td>
1226 <td valign="top">&nbsp;</td>
1227 </tr>
1228
1229 <tr>
1230 <td valign="top">STEGANO</td>
1231 <td valign="top">R</td>
1232 <td valign="top">Steganographic image</td>
1233 <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>
1234 </tr>
1235
1236 <tr>
1237 <td valign="top">TILE</td>
1238 <td valign="top">R</td>
1239 <td valign="top">Tiled image</td>
1240 <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
1241 <kbd>TILE:image.miff</kbd>.</td>
1242 </tr>
1243
1244 <tr>
1245 <td valign="top">UNIQUE</td>
1246 <td valign="top">W</td>
1247 <td valign="top">Write only unique pixels to the image file.</td>
1248 <td valign="top">&nbsp;</td>
1249 </tr>
1250
1251 <tr>
1252 <td valign="top">VID</td>
1253 <td valign="top">RW</td>
1254 <td valign="top">Visual Image Directory</td>
1255 <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>
1256 </tr>
1257
1258 <tr>
1259 <td valign="top">WIN</td>
1260 <td valign="top">RW</td>
1261 <td valign="top">Select image from or display image to your computer screen</td>
1262 <td valign="top">Only supported under Microsoft Windows.</td>
1263 </tr>
1264
1265 <tr>
1266 <td valign="top">X</td>
1267 <td valign="top">RW</td>
1268 <td valign="top">Select image from or display image to your X server screen</td>
1269 <td valign="top">Also see the <a href="../www/import.html">import</a> and <a href="../www/display.html">display</a>
1270 programs.</td>
1271 </tr>
1272
1273 <tr>
1274 <td valign="top">XC</td>
1275 <td valign="top">R</td>
1276 <td valign="top">Canvas image of specified color</td>
1277 <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>
1278 </tr>
1279</table>
1280
1281</div>
1282
1283<h2><a name="builtin-images"></a>Built-in Images</h2>
1284<div class="doc-section">
1285
1286<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>
1287
1288<table class="doc">
1289 <tr>
1290 <th>Tag</th>
1291 <th>Mode</th>
1292 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1293 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1294 </tr>
1295
1296 <tr>
1297 <td valign="top">GRANITE</td>
1298 <td valign="top">R</td>
1299 <td valign="top">128x128 granite texture pattern</td>
1300 <td valign="top"><img src="../images/granite.png" width="100" height="26" alt="GRANITE"/></td>
1301 </tr>
1302
1303 <tr>
1304 <td valign="top"><a href="../images/logo.eps">LOGO</a></td>
1305 <td valign="top">R</td>
1306 <td valign="top">ImageMagick Logo, 640x480</td>
1307 <td valign="top">The ImageMagick <a href="../images/logo.jpg">logo</a>.</td>
1308 </tr>
1309
1310 <tr>
1311 <td valign="top"> NETSCAPE</td>
1312 <td valign="top">R</td>
1313 <td valign="top">image using colors in Netscape 216 (6x6x6 ) color cube, 216x144</td>
1314 <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>
1315 </tr>
1316
1317 <tr>
1318 <td valign="top">ROSE</td>
1319 <td valign="top">R</td>
1320 <td valign="top">Picture of a rose, 70x46</td>
1321 <td valign="top"><img src="../images/rose.png" width="70" height="46" alt="ROSE"/></td>
1322 </tr>
1323</table>
1324
1325</div>
1326
1327<h2><a name="builtin-patterns"></a>Built-in Patterns</h2>
1328<div class="doc-section">
1329
1330<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>
1331
1332<table class="doc">
1333 <tr>
1334 <th>Tag</th>
1335 <th>Mode</th>
1336 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1337 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1338 </tr>
1339
1340 <tr>
1341 <td valign="top">BRICKS</td>
1342 <td valign="top">R</td>
1343 <td valign="top">brick pattern, 16x16</td>
1344 <td valign="top"><img src="../images/patterns/bricks.png" width="100" height="26" alt="BRICKS" /></td>
1345 </tr>
1346
1347 <tr>
1348 <td valign="top">CHECKERBOARD</td>
1349 <td valign="top">R</td>
1350 <td valign="top">checkerboard pattern, 30x30</td>
1351 <td valign="top"><img src="../images/patterns/checkerboard.png" width="100" height="26" alt="CHECKERBOARD" /></td>
1352 </tr>
1353
1354 <tr>
1355 <td valign="top">CIRCLES</td>
1356 <td valign="top">R</td>
1357 <td valign="top">circles pattern, 16x16</td>
1358 <td valign="top"><img src="../images/patterns/circles.png" width="100" height="26" alt="CIRCLES"/></td>
1359 </tr>
1360
1361 <tr>
1362 <td valign="top">CROSSHATCH</td>
1363 <td valign="top">R</td>
1364 <td valign="top">crosshatch pattern, 8x4</td>
1365 <td valign="top"><img src="../images/patterns/crosshatch.png" width="100" height="26" alt="CROSSHATCH" /></td>
1366 </tr>
1367
1368 <tr>
1369 <td valign="top">CROSSHATCH30</td>
1370 <td valign="top">R</td>
1371 <td valign="top">crosshatch pattern with lines at 30 degrees, 8x4</td>
1372 <td valign="top"><img src="../images/patterns/crosshatch30.png" width="100" height="26" alt="CROSSHATCH30" /></td>
1373 </tr>
1374
1375 <tr>
1376 <td valign="top">CROSSHATCH45</td>
1377 <td valign="top">R</td>
1378 <td valign="top">crosshatch pattern with lines at 45 degrees, 8x4</td>
1379 <td valign="top"><img src="../images/patterns/crosshatch45.png" width="100" height="26" alt="CROSSHATCH45" /></td>
1380 </tr>
1381
1382 <tr>
1383 <td valign="top">FISHSCALES</td>
1384 <td valign="top">R</td>
1385 <td valign="top">fish scales pattern, 16x8</td>
1386 <td valign="top"><img src="../images/patterns/fishscales.png" width="100" height="26" alt="FISHSCALES" /></td>
1387 </tr>
1388
1389 <tr>
1390 <td valign="top">GRAY0</td>
1391 <td valign="top">R</td>
1392 <td valign="top">0% intensity gray, 32x32</td>
1393 <td valign="top"><img src="../images/patterns/gray0.png" width="100" height="32" alt="GRAY0" /></td>
1394 </tr>
1395
1396 <tr>
1397 <td valign="top">GRAY5</td>
1398 <td valign="top">R</td>
1399 <td valign="top">5% intensity gray, 32x32</td>
1400 <td valign="top"><img src="../images/patterns/gray5.png" width="100" height="32" alt="GRAY5" /></td>
1401 </tr>
1402
1403 <tr>
1404 <td valign="top">GRAY10</td>
1405 <td valign="top">R</td>
1406 <td valign="top">10% intensity gray, 32x32</td>
1407 <td valign="top"> <img src="../images/patterns/gray10.png" width="100" height="32" alt="GRAY10" /></td>
1408 </tr>
1409
1410 <tr>
1411 <td valign="top">GRAY15</td>
1412 <td valign="top">R</td>
1413 <td valign="top">15% intensity gray, 32x32</td>
1414 <td valign="top"><img src="../images/patterns/gray15.png" width="100" height="32" alt="GRAY15" /></td>
1415 </tr>
1416
1417 <tr>
1418 <td valign="top">GRAY20</td>
1419 <td valign="top">R</td>
1420 <td valign="top">20% intensity gray, 32x32</td>
1421 <td valign="top"><img src="../images/patterns/gray20.png" width="100" height="32" alt="GRAY20" /></td>
1422 </tr>
1423
1424 <tr>
1425 <td valign="top">GRAY25</td>
1426 <td valign="top">R</td>
1427 <td valign="top">25% intensity gray, 32x32</td>
1428 <td valign="top"><img src="../images/patterns/gray25.png" width="100" height="32" alt="GRAY25" /></td>
1429 </tr>
1430
1431 <tr>
1432 <td valign="top">GRAY30</td>
1433 <td valign="top">R</td>
1434 <td valign="top">30% intensity gray, 32x32</td>
1435 <td valign="top"><img src="../images/patterns/gray30.png" width="100" height="32" alt="GRAY30" /></td>
1436 </tr>
1437
1438 <tr>
1439 <td valign="top">GRAY35</td>
1440 <td valign="top">R</td>
1441 <td valign="top">35% intensity gray, 32x32</td>
1442 <td valign="top"><img src="../images/patterns/gray35.png" width="100" height="32" alt="GRAY35" /></td>
1443 </tr>
1444
1445 <tr>
1446 <td valign="top">GRAY40</td>
1447 <td valign="top">R</td>
1448 <td valign="top">40% intensity gray, 32x32</td>
1449 <td valign="top"><img src="../images/patterns/gray40.png" width="100" height="32" alt="GRAY40" /></td>
1450 </tr>
1451
1452 <tr>
1453 <td valign="top">GRAY45</td>
1454 <td valign="top">R</td>
1455 <td valign="top">45% intensity gray, 32x32</td>
1456 <td valign="top"><img src="../images/patterns/gray45.png" width="100" height="32" alt="GRAY45" /></td>
1457 </tr>
1458
1459 <tr>
1460 <td valign="top">GRAY50</td>
1461 <td valign="top">R</td>
1462 <td valign="top">50% intensity gray, 32x32</td>
1463 <td valign="top"><img src="../images/patterns/gray50.png" width="100" height="32" alt="GRAY50" /></td>
1464 </tr>
1465
1466 <tr>
1467 <td valign="top">GRAY55</td>
1468 <td valign="top">R</td>
1469 <td valign="top">55% intensity gray, 32x32</td>
1470 <td valign="top"><img src="../images/patterns/gray55.png" width="100" height="32" alt="GRAY55" /></td>
1471 </tr>
1472
1473 <tr>
1474 <td valign="top">GRAY60</td>
1475 <td valign="top">R</td>
1476 <td valign="top">60% intensity gray, 32x32</td>
1477 <td valign="top"><img src="../images/patterns/gray60.png" width="100" height="32" alt="GRAY60" /></td>
1478 </tr>
1479
1480 <tr>
1481 <td valign="top">GRAY65</td>
1482 <td valign="top">R</td>
1483 <td valign="top">65% intensity gray, 32x32</td>
1484 <td valign="top"><img src="../images/patterns/gray65.png" width="100" height="32" alt="GRAY65" /></td>
1485 </tr>
1486
1487 <tr>
1488 <td valign="top">GRAY70</td>
1489 <td valign="top">R</td>
1490 <td valign="top">70% intensity gray, 32x32</td>
1491 <td valign="top"><img src="../images/patterns/gray70.png" width="100" height="32" alt="GRAY70" /></td>
1492 </tr>
1493
1494 <tr>
1495 <td valign="top">GRAY75</td>
1496 <td valign="top">R</td>
1497 <td valign="top">75% intensity gray, 32x32</td>
1498 <td valign="top"><img src="../images/patterns/gray75.png" width="100" height="32" alt="GRAY75" /></td>
1499 </tr>
1500
1501 <tr>
1502 <td valign="top">GRAY80</td>
1503 <td valign="top">R</td>
1504 <td valign="top">80% intensity gray, 32x32</td>
1505 <td valign="top"> <img src="../images/patterns/gray80.png" width="100" height="32" alt="GRAY80" /></td>
1506 </tr>
1507
1508 <tr>
1509 <td valign="top">GRAY85</td>
1510 <td valign="top">R</td>
1511 <td valign="top">85% intensity gray, 32x32</td>
1512 <td valign="top"><img src="../images/patterns/gray85.png" width="100" height="32" alt="GRAY85" /></td>
1513 </tr>
1514
1515 <tr>
1516 <td valign="top">GRAY90</td>
1517 <td valign="top">R</td>
1518 <td valign="top">100% intensity gray, 32x32</td>
1519 <td valign="top"><img src="../images/patterns/gray90.png" width="100" height="32" alt="GRAY90" /></td>
1520 </tr>
1521
1522 <tr>
1523 <td valign="top">GRAY95</td>
1524 <td valign="top">R</td>
1525 <td valign="top">100% intensity gray, 32x32</td>
1526 <td valign="top"><img src="../images/patterns/gray95.png" width="100" height="32" alt="GRAY95" /></td>
1527 </tr>
1528
1529 <tr>
1530 <td valign="top">GRAY100</td>
1531 <td valign="top">R</td>
1532 <td valign="top">100% intensity gray, 32x32</td>
1533 <td valign="top"><img src="../images/patterns/gray100.png" width="100" height="32" alt="GRAY100" /></td>
1534 </tr>
1535
1536 <tr>
1537 <td valign="top">HEXAGONS</td>
1538 <td valign="top">R</td>
1539 <td valign="top">hexagon pattern, 30x18</td>
1540 <td valign="top"><img src="../images/patterns/hexagons.png" width="100" height="26" alt="HEXAGONS" /></td>
1541 </tr>
1542
1543 <tr>
1544 <td valign="top">HORIZONTAL</td>
1545 <td valign="top">R</td>
1546 <td valign="top">horizontal line pattern, 8x4</td>
1547 <td valign="top"><img src="../images/patterns/horizontal.png" width="100" height="26" alt="HORIZONTAL" /></td>
1548 </tr>
1549
1550 <tr>
1551 <td valign="top">HORIZONTALSAW</td>
1552 <td valign="top">R</td>
1553 <td valign="top">horizontal saw-tooth pattern, 16x8</td>
1554 <td valign="top"><img src="../images/patterns/horizontalsaw.png" width="100" height="26" alt="HORIZONTALSAW" /></td>
1555 </tr>
1556
1557 <tr>
1558 <td valign="top">HS_BDIAGONAL</td>
1559 <td valign="top">R</td>
1560 <td valign="top">backward diagonal line pattern (45 degrees slope), 8x8</td>
1561 <td valign="top"><img src="../images/patterns/hs_bdiagonal.png" width="100" height="26" alt="HS_BDIAGONAL" /></td>
1562 </tr>
1563
1564 <tr>
1565 <td valign="top">HS_CROSS</td>
1566 <td valign="top">R</td>
1567 <td valign="top">cross line pattern, 8x8</td>
1568 <td valign="top"><img src="../images/patterns/hs_cross.png" width="100" height="26" alt="HS_CROSS" /></td>
1569 </tr>
1570
1571 <tr>
1572 <td valign="top">HS_DIAGCROSS</td>
1573 <td valign="top">R</td>
1574 <td valign="top">diagonal line cross pattern (45 degrees slope), 8x8</td>
1575 <td valign="top"><img src="../images/patterns/hs_diagcross.png" width="100" height="26" alt="HS_DIAGCROSS" /></td>
1576 </tr>
1577
1578 <tr>
1579 <td valign="top">HS_FDIAGONAL</td>
1580 <td valign="top">R</td>
1581 <td valign="top">forward diagonal line pattern (45 degrees slope), 8x8</td>
1582 <td valign="top"><img src="../images/patterns/hs_fdiagonal.png" width="100" height="26" alt="HS_FDIAGONAL" /></td>
1583 </tr>
1584
1585 <tr>
1586 <td valign="top">HS_HORIZONTAL</td>
1587 <td valign="top">R</td>
1588 <td valign="top">horizontal line pattern, 8x8</td>
1589 <td valign="top"><img src="../images/patterns/hs_horizontal.png" width="100" height="26" alt="HS_HORIZONTAL" /></td>
1590 </tr>
1591
1592 <tr>
1593 <td valign="top">HS_VERTICAL</td>
1594 <td valign="top">R</td>
1595 <td valign="top">vertical line pattern, 8x8</td>
1596 <td valign="top"><img src="../images/patterns/hs_vertical.png" width="100" height="26" alt="HS_VERTICAL" /></td>
1597 </tr>
1598
1599 <tr>
1600 <td valign="top">LEFT30</td>
1601 <td valign="top">R</td>
1602 <td valign="top">forward diagonal pattern (30 degrees slope), 8x4</td>
1603 <td valign="top"><img src="../images/patterns/left30.png" width="100" height="26" alt="LEFT0" /></td>
1604 </tr>
1605
1606 <tr>
1607 <td valign="top">LEFT45</td>
1608 <td valign="top">R</td>
1609 <td valign="top">forward diagonal line pattern (45 degrees slope), 8x8</td>
1610 <td valign="top"><img src="../images/patterns/left45.png" width="100" height="26" alt="LEFT45" /></td>
1611 </tr>
1612
1613 <tr>
1614 <td valign="top">LEFTSHINGLE</td>
1615 <td valign="top">R</td>
1616 <td valign="top">left shingle pattern, 24x24</td>
1617 <td valign="top"><img src="../images/patterns/leftshingle.png" width="100" height="26" alt="LEFTSHINGLE" /></td>
1618 </tr>
1619
1620 <tr>
1621 <td valign="top">OCTAGONS</td>
1622 <td valign="top">R</td>
1623 <td valign="top">octagons pattern, 16x16</td>
1624 <td valign="top"><img src="../images/patterns/octagons.png" width="100" height="26" alt="OCTAGONS" /></td>
1625 </tr>
1626
1627 <tr>
1628 <td valign="top">RIGHT30</td>
1629 <td valign="top">R</td>
1630 <td valign="top">backward diagonal line pattern (30 degrees) 8x4</td>
1631 <td valign="top"><img src="../images/patterns/right30.png" width="100" height="26" alt="RIGHT30" /></td>
1632 </tr>
1633
1634 <tr>
1635 <td valign="top">RIGHT45</td>
1636 <td valign="top">R</td>
1637 <td valign="top">backward diagonal line pattern (30 degrees), 8x8</td>
1638 <td valign="top"><img src="../images/patterns/right45.png" width="100" height="26" alt="RIGHT45" /></td>
1639 </tr>
1640
1641 <tr>
1642 <td valign="top">RIGHTSHINGLE</td>
1643 <td valign="top">R</td>
1644 <td valign="top">right shingle pattern, 24x24</td>
1645 <td valign="top"><img src="../images/patterns/rightshingle.png" width="100" height="26" alt="RIGHTSHINGLE" /></td>
1646 </tr>
1647
1648 <tr>
1649 <td valign="top">SMALLFISHSCALES</td>
1650 <td valign="top">R</td>
1651 <td valign="top">small fish scales pattern, 8x8</td>
1652 <td valign="top"><img src="../images/patterns/smallfishscales.png" width="100" height="26" alt="SMALLFISHSCALES" /></td>
1653 </tr>
1654
1655 <tr>
1656 <td valign="top">VERTICAL</td>
1657 <td valign="top">R</td>
1658 <td valign="top">vertical line pattern, 8x8</td>
1659 <td valign="top"><img src="../images/patterns/vertical.png" width="100" height="26" alt="VERTICAL" /></td>
1660 </tr>
1661
1662 <tr>
1663 <td valign="top">VERTICALBRICKS</td>
1664 <td valign="top">R</td>
1665 <td valign="top">vertical brick pattern, 16x16</td>
1666 <td valign="top"><img src="../images/patterns/verticalbricks.png" width="100" height="26" alt="VERTICALBRICKS" /></td>
1667 </tr>
1668
1669 <tr>
1670 <td valign="top">VERTICALLEFTSHINGLE</td>
1671 <td valign="top">R</td>
1672 <td valign="top">vertical left shingle pattern, 24x24</td>
1673 <td valign="top"><img src="../images/patterns/verticalleftshingle.png" width="100" height="26" alt="VERTICALLEFTSHINGLE" /></td>
1674 </tr>
1675
1676 <tr>
1677 <td valign="top">VERTICALRIGHTSHINGLE</td>
1678 <td valign="top">R</td>
1679 <td valign="top">vertical right shingle pattern, 24x24</td>
1680 <td valign="top"><img src="../images/patterns/verticalrightshingle.png" width="100" height="26" alt="VERTICALRIGHTSHINGLE" /></td>
1681 </tr>
1682
1683 <tr>
1684 <td valign="top">VERTICALSAW</td>
1685 <td valign="top">R</td>
1686 <td valign="top">vertical saw-tooth pattern, 8x16</td>
1687 <td valign="top"><img src="../images/patterns/verticalsaw.png" width="100" height="26" alt="VERTICALSAW" /></td>
1688 </tr>
1689</table>
1690
1691</div>
1692
1693<h2><a name="embedded"></a>Embedded Image Profiles</h2>
1694<div class="doc-section">
1695
1696<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>
1697
1698<table class="doc">
1699 <tbody>
1700 <tr>
1701 <th>Tag</th>
1702 <th>Mode</th>
1703 <th>Description</th>
cristy6b636652009-12-05 17:16:11 +0000[diff] [blame]1704 <th>Notes</th>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]1705 </tr>
1706
1707 <tr>
1708 <td valign="top">8BIM</td>
1709 <td valign="top">RW</td>
1710 <td valign="top">Photoshop resource format (binary)</td>
1711 <td valign="top">&nbsp;</td>
1712 </tr>
1713
1714 <tr>
1715 <td valign="top">8BIMTEXT</td>
1716 <td valign="top">RW</td>
1717 <td valign="top">Photoshop resource format (ASCII)</td>
1718 <td valign="top">An ASCII representation of the 8BIM format.</td>
1719 </tr>
1720
1721 <tr>
1722 <td valign="top">APP1</td>
1723 <td valign="top">RW</td>
1724 <td valign="top">Raw application information</td>
1725 <td valign="top">&nbsp;</td>
1726 </tr>
1727
1728 <tr>
1729 <td valign="top">APP1JPEG</td>
1730 <td valign="top">RW</td>
1731 <td valign="top">Raw JPEG binary data</td>
1732 <td valign="top">Profile in JPEG wrapper.</td>
1733 </tr>
1734
1735 <tr>
1736 <td valign="top">ICC</td>
1737 <td valign="top">RW</td>
1738 <td valign="top">International Color Consortium color profile</td>
1739 <td valign="top">Also known as <kbd>ICM</kbd>. To read, use <a href="../www/command-line-options.html#profile">-profile</a> with
1740 <a href="../www/convert.html">convert</a>.</td>
1741 </tr>
1742
1743 <tr>
1744 <td valign="top">IPTC</td>
1745 <td valign="top">RW</td>
1746 <td valign="top">IPTC Newsphoto (binary)</td>
1747 <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>
1748 </tr>
1749
1750 <tr>
1751 <td valign="top">IPTCTEXT</td>
1752 <td valign="top">RW</td>
1753 <td valign="top">IPTC Newsphoto (ASCII)</td>
1754 <td valign="top">An ASCII representation of the IPTC format.</td>
1755 </tr>
1756 </tbody>
1757</table>
1758
1759</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]1760
1761</div>
1762
1763<div id="linkbar">
1764 <!-- <span id="linkbar-west">&nbsp;</span> -->
1765 <span id="linkbar-center">
1766 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristy51853f02010-03-18 20:03:12 +0000[diff] [blame^]1767 <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]1768 </span>
1769 <span id="linkbar-east">&nbsp;</span>
1770 </div>
1771 <div class="footer">
1772 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
1773 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
1774 </div>
1775 <div style="clear: both; margin: 0; width: 100%; "></div>
1776</body>
1777</html>