Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / ef25b755b80636d8259c7c60ef07dbf821613813 / . / www / escape.html
blob: 518828df8ff94c5fdfa5717f2eb72e8c838b9280 [file] [log] [blame]
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
3 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4<html version="-//W3C//DTD XHTML 1.1//EN"
5 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
6 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
7 xsi:schemaLocation="http://www.w3.org/1999/xhtml
8 http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
9<head>
10 <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
11 <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]12 <title>ImageMagick: Format and Print Image Properties</title>
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]13 <meta http-equiv="content-language" content="en-US"/>
14 <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
15 <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
16 <meta name="application-name" content="ImageMagick"/>
17 <meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition resize, rotate, shear, distort and transform images automagically."/>
18 <meta name="application-url" content="http://www.imagemagick.org"/>
19 <meta name="generator" content="PHP"/>
20 <meta name="keywords" content="format, print, image, properties, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"/>
21 <meta name="rating" content="GENERAL"/>
22 <meta name="robots" content="INDEX, FOLLOW"/>
23 <meta name="generator" content="ImageMagick Studio LLC"/>
24 <meta name="author" content="ImageMagick Studio LLC"/>
25 <meta name="revisit-after" content="2 DAYS"/>
26 <meta name="resource-type" content="document"/>
cristy45ef08f2012-12-07 13:13:34 +0000[diff] [blame]27 <meta name="copyright" content="Copyright (c) 1999-2013 ImageMagick Studio LLC"/>
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]28 <meta name="distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]29 <link rel="icon" href="../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]30 <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]31 <link rel="canonical" href="http://www.imagemagick.org" />
32 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
33 <!-- Add jQuery library -->
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]34 <script type="text/javascript" src="http://localhost/ajax/libs/jquery/1.7/jquery.min.js"></script>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]35
36 <!-- Optionaly include easing and/or mousewheel plugins -->
37 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.easing-1.3.pack.js"></script>
38 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.mousewheel-3.0.6.pack.js"></script>
39
40 <!-- Add fancyBox -->
41 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/jquery.fancybox.css?v=2.0.4" type="text/css" media="screen" />
42 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.4"></script>
43
44 <!-- Optionaly include button and/or thumbnail helpers -->
45 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.css?v=2.0.4" type="text/css" media="screen" />
46 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.4"></script>
47
48 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.4" type="text/css" media="screen" />
49 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.4"></script>
50 <script type="text/javascript">
51 $(document).ready(function() {
52 $(".fancybox").fancybox();
53 });
54 </script>
55 <!-- ImageMagick style -->
cristy6ad765e2013-02-24 22:14:01 +0000[diff] [blame]56 <link rel="stylesheet" href="http://www.localhost/cse/style/look/default.css" type="text/css" />
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]57 <style type="text/css" media="all">
58 @import url("../www/magick.css");
59 </style>
60</head>
61
62<body id="www-imagemagick-org">
63<div class="titlebar">
64<div style="margin: 17px auto; float: left;">
65 <script type="text/javascript">
66 <!--
67 google_ad_client = "pub-3129977114552745";
68 google_ad_slot = "5439289906";
69 google_ad_width = 728;
70 google_ad_height = 90;
71 //-->
72 </script>
73 <script type="text/javascript"
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]74 src="http://localhost/pagead/show_ads.js">
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]75 </script>
76</div>
77<a href="../discourse-server">
78 <img src="../images/logo.jpg"
79 alt="ImageMagick Logo"
80 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
81<a href="../index.html">
82 <img src="../images/sprite.jpg"
83 alt="ImageMagick Sprite"
84 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
85</div>
86
87<div class="westbar">
88
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]89<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]90 <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]91</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]92<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]93 <a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]94</div>
95<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]96 <a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]97</div>
98<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]99 <a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]100</div>
101<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]102 <a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
cristyda16f162011-02-19 23:52:17 +0000[diff] [blame]103</div>
104<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]105 <a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]106</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]107<div class="sep"></div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]108<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]109 <a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]110</div>
111<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]112 <a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]113</div>
114<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]115 <a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]116</div>
117<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]118 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]119</div>
120<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]121 <a title="Program Interfaces" href="api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122</div>
123<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]124 <a title="Program Interface: MagickWand" href="magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]125</div>
126<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]127 <a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]128</div>
129<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]130 <a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]131</div>
132<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]133 <a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]135<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]136<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]137 <a title="Install from Source" href="install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]138</div>
139<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]140 <a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141</div>
142<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]143 <a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]144 </div>
145<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]146 <a title="Resources" href="resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]148<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]149 <a title="Architecture" href="architecture.html">Architecture</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]150</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]151<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]152 <a title="Download" href="download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]153</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]154<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]155<div class="menu">
cristy3dfa2192013-02-24 22:46:05 +0000[diff] [blame]156 <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]157</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]158<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]159<div class="menu">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]160 <a title="Site Map" href="sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]161</div>
162<div class="sub">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]163 <a title="Site Map: Links" href="links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]164</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]165<div class="sep"></div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]166<div class="menu">
cristyef25b752013-05-12 18:06:02 +0000[diff] [blame^]167 <a rel="follow" title="Sponsors" href="support.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]168
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]169 <a href="http://www.networkredux.com"> <img src="../images/networkredux.png" width="140" height="31" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]170 <a href="http://www.dinodirect.com/ipads-tablets/"> <img src="../images/dino-direct.jpg" width="140" height="90" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a><!-- 201208010120 mickey@163... -->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]171<div class="sponsbox">
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]172<div class="sponsor">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]173 <a rel="follow" title="Sponsor: The Fastest &amp; Easiest Way to Find Images" href="http://www.graphicsfactory.com">The Fastest &amp; Easiest Way to Find Images</a><!-- 201210010270 graphicsfac... -->
cristy81492d62011-06-07 16:41:42 +0000[diff] [blame]174</div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]175<div class="sponsor">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]176 <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201209010090 barsh@inter... -->
cristy1efc1ab2011-08-01 14:47:02 +0000[diff] [blame]177</div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]178<div class="sponsor">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]179 <a rel="follow" title="Werbebanner Werbeplane" href="http://www.allesbanner.de">Werbebanner Werbeplane</a><!-- 201212010450 info@druck... -->
180</div>
181<div class="sponsor">
182 <a rel="follow" title="Entertainment News &amp; Photos" href="http://www.zimbio.com">Entertainment News &amp; Photos</a><!-- 201211010540 bd@zimb... -->
183</div>
184<div class="sponsor">
185 <a rel="follow" title="Sponsor: LED24" href="http://led24.de/">LED24</a><!-- 201207010270 info@led24... -->
186</div>
187<div class="sponsor">
188 <a rel="follow" title="Sponsor: Best Website Hosting" href="http://www.top-cheap-web-hosting.com">Best Website Hosting</a><!-- 201304010090 eunge.liu-->
189</div>
190<div class="sponsor">
191 <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201208010120 mickey@163... -->
cristy84134182011-06-15 22:59:00 +0000[diff] [blame]192</div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]193<div class="sponsor">
194 <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
cristy81492d62011-06-07 16:41:42 +0000[diff] [blame]195</div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]196<div class="sponsor">
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]197 <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
198</div>
199<div class="sponsor">
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]200 <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
201</div>
202<div class="sponsor">
203 <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
204</div>
205<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]206 <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]207</div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]208<div class="sponsor">
209 <a rel="follow" title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
cristy4bf6e232011-05-21 01:43:33 +0000[diff] [blame]210</div>
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]211<div class="sponsor">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]212 <a rel="follow" title="Sponsor: Web Hosting" href="http://www.hostucan.com">Web Hosting</a><!-- 2012120100150 racent marketing@webhosting...-->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]213</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]214</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]215</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]216</div>
217
218<div class="eastbar">
219 <div class="g-plusone" id="gplusone"></div>
220 <script type="text/javascript">
221 window.___gcfg = {
222 lang: 'en-US'
223 };
224
225 (function() {
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]226 var po = document.createElement('offline-script');
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]227 po.type = 'text/javascript'; po.async = true;
cristy6ad765e2013-02-24 22:14:01 +0000[diff] [blame]228 po.src = 'https://apis.localhost/js/plusone.js';
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]229 var script = document.getElementsByTagName('offline-script')[0];
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]230 script.parentNode.insertBefore(po, script);
231 })();
232 var gplusone = document.getElementById("gplusone");
233 gplusone.setAttribute("data-size","medium");
234 gplusone.setAttribute("data-count","false");
235 </script>
236</div>
237
238<div class="main">
239
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]240<h1>ImageMagick Escapes</h1>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]241<p class="navigation-index"></p>
242
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]243<div class="doc-section">
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]244<p>Use the <a href="command-line-options.html#format_identify_"
245>-format</a> option to print properties associated with an image in a format
246of your choosing. You can include the image filename, type, width, height,
247EXIF data, or other image attributes by embedding special format
248characters:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]249
250<pre class="text">
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]251 %b file size of image read in
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]252 %c comment meta-data property
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]253 %d directory component of path
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]254 %e filename extension or suffix
255 %f filename (including suffix)
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]256 %g layer canvas page geometry ( = %Wx%H%X%Y )
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]257 %h current image height in pixels
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]258 %i image filename (note: becomes output filename for "info:")
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]259 %k CALCULATED: number of unique colors
260 %l label meta-data property
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]261 %m image file format (file magic)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]262 %n number of images in current image sequence
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]263 %o output filename (used for delegates)
264 %p index of image in current image list
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]265 %q quantum depth (compile-time constant)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]266 %r image class and colorspace
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]267 %s scene number (from input unless re-assigned)
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]268 %t filename without directory or extension (suffix)
269 %u unique temporary filename (used for delegates)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]270 %w current width in pixels
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]271 %x x resolution (density)
272 %y y resolution (density)
273 %z image depth (as read in unless modified, image save depth)
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]274 %A image transparency channel enabled (true/false)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]275 %C image compression type
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]276 %D image GIF dispose method
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]277 %G image size ( = %wx%h )
278 %H page (canvas) height
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]279 %M Magick filename (original file exactly as given, including read mods)
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]280 %O page (canvas) offset ( = %X%Y )
281 %P page (canvas) size ( = %Wx%H )
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]282 %Q image compression quality ( 0 = default )
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]283 %S ?? scenes ??
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]284 %T image time delay (in centi-seconds)
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]285 %W page (canvas) width
286 %X page (canvas) x offset (including sign)
287 %Y page (canvas) y offset (including sign)
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]288 %Z unique filename (used for delegates)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]289 %@ CALCULATED: trim bounding box (without actually trimming)
290 %# CALCULATED: 'signature' hash of image values
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]291 %% a percent sign
292 \n newline
293 \r carriage return
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]294 &lt; less-than character.
295 &gt; greater-than character.
296 &amp; ampersand character.
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]297</pre>
298
299<p>Here is a sample command and its output
300for an image with filename <kbd>bird.miff</kbd> and whose width is 512 and height is 480.</p>
301
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]302<p class='crt'><span class="crtprompt"> $ </span><span class='crtin'>identify -format "%m:%f %wx%h" bird.miff</span><span class='crtout'>MIFF:bird.miff 512x480</span></p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]303<p>Additional properties are recognized when enclosed in braces:</p>
304
305<pre class="text">
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]306 %[base] base filename, no suffixes (as %t)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]307 %[channels] ??? channels in use - colorspace ???
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]308 %[colorspace] Colorspace of Image Data (excluding transparency)
309 %[copyright] ImageMagick Copyright String
310 %[depth] depth of image for write (as input unless changed)
311 %[directory] directory part of filename (as %d)
312 %[extension] extention part of filename (as %e)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]313 %[group] ??? window group ???
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]314 %[height] original height of image (when it was read in)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]315 %[kurtosis] CALCULATED: kurtosis statistic of image
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]316 %[magick] coder used to read image (not the file suffix)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]317 %[max] CALCULATED: maximum value statistic of image
318 %[mean] CALCULATED: average value statistic of image
319 %[min] CALCULATED: minimum value statistic of image
320 %[name] The original name of the image
321 %[opaque] CALCULATED: is image fully-opaque?
322 %[page] Virtual canvas (page) geometry
323 %[resolution.y] X density (resolution) without units
324 %[resolution.x] Y density (resolution) without units
325 %[zero] zero (unique filename for delegates
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]326 %[scene] original scene number of image in input file
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]327 %[size] original size of image (when it was read in)
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]328 %[skewness] CALCULATED: skewness statistic of image
329 %[standard-deviation] CALCULATED: standard-deviation statistic of image
cristy1b80ae32011-03-26 23:38:55 +0000[diff] [blame]330 %[unique] unique temporary filename ???
331 %[version] Version Information of this running ImageMagick
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]332 %[width] original width of image (when it was read in)
cristy323f35b2011-03-24 23:05:13 +0000[diff] [blame]333 %[*] list of image property strings
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]334</pre>
335
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]336<p>Use <kbd>%[fx:...]</kbd> to evaluate <a href="fx.html">FX</a> expressions:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]337
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]338<pre class="text">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]339 %[fx:<em class="arg">expression</em>]
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]340</pre>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]341
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]342<p>Use <kbd>pixel:</kbd> to evaluate a pixel color as defined by the <a href="fx.html">FX</a> expression:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]343
344<pre class="text">
345 %[pixel:<em class="arg">expression</em>]
346</pre>
347
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]348<p>You can also use the following special formatting syntax to print EXIF
349information contained in the file:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]350
351<pre class="text">
352 %[EXIF:<em class="arg">tag</em>]
353</pre>
354
355<p>Choose <em class="arg">tag</em> from the following:</p>
356
357<pre class="text">
358 * (print all EXIF tags, in keyword=data format)
359 ! (print all EXIF tags, in tag_number data format)
360 #hhhh (print data for EXIF tag #hhhh)
361 ImageWidth
362 ImageLength
363 BitsPerSample
364 Compression
365 PhotometricInterpretation
366 FillOrder
367 DocumentName
368 ImageDescription
369 Make
370 Model
371 StripOffsets
372 Orientation
373 SamplesPerPixel
374 RowsPerStrip
375 StripByteCounts
376 XResolution
377 YResolution
378 PlanarConfiguration
379 ResolutionUnit
380 TransferFunction
381 Software
382 DateTime
383 Artist
384 WhitePoint
385 PrimaryChromaticities
386 TransferRange
387 JPEGProc
388 JPEGInterchangeFormat
389 JPEGInterchangeFormatLength
390 YCbCrCoefficients
391 YCbCrSubSampling
392 YCbCrPositioning
393 ReferenceBlackWhite
394 CFARepeatPatternDim
395 CFAPattern
396 BatteryLevel
397 Copyright
398 ExposureTime
399 FNumber
400 IPTC/NAA
401 EXIFOffset
402 InterColorProfile
403 ExposureProgram
404 SpectralSensitivity
405 GPSInfo
406 ISOSpeedRatings
407 OECF
408 EXIFVersion
409 DateTimeOriginal
410 DateTimeDigitized
411 ComponentsConfiguration
412 CompressedBitsPerPixel
413 ShutterSpeedValue
414 ApertureValue
415 BrightnessValue
416 ExposureBiasValue
417 MaxApertureValue
418 SubjectDistance
419 MeteringMode
420 LightSource
421 Flash
422 FocalLength
423 MakerNote
424 UserComment
425 SubSecTime
426 SubSecTimeOriginal
427 SubSecTimeDigitized
428 FlashPixVersion
429 ColorSpace
430 EXIFImageWidth
431 EXIFImageLength
432 InteroperabilityOffset
433 FlashEnergy
434 SpatialFrequencyResponse
435 FocalPlaneXResolution
436 FocalPlaneYResolution
437 FocalPlaneResolutionUnit
438 SubjectLocation
439 ExposureIndex
440 SensingMethod
441 FileSource
442 SceneType
443</pre>
444
445<p>Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.</p>
446
447<p>The following special formatting syntax can be used to print IPTC information contained in the file:</p>
448
449<pre class="text">
450 %[IPTC:<em class="arg">dataset</em>:<em class="arg">record</em>]
451</pre>
452
453<p>Select <em class="arg">dataset</em> and <em class="arg">record</em> from the following:</p>
454
455<pre class="text">
456 Envelope Record
457 1:00 Model Version
458 1:05 Destination
459 1:20 File Format
460 1:22 File Format Version
461 1:30 Service Identifier
462 1:40 Envelope Number
463 1:50 Product ID
464 1:60 Envelope Priority
465 1:70 Date Sent
466 1:80 Time Sent
467 1:90 Coded Character Set
468 1:100 UNO (Unique Name of Object)
469 1:120 ARM Identifier
470 1:122 ARM Version
471
472 Application Record
473 2:00 Record Version
474 2:03 Object Type Reference
475 2:05 Object Name (Title)
476 2:07 Edit Status
477 2:08 Editorial Update
478 2:10 Urgency
479 2:12 Subject Reference
480 2:15 Category
481 2:20 Supplemental Category
482 2:22 Fixture Identifier
483 2:25 Keywords
484 2:26 Content Location Code
485 2:27 Content Location Name
486 2:30 Release Date
487 2:35 Release Time
488 2:37 Expiration Date
489 2:35 Expiration Time
490 2:40 Special Instructions
491 2:42 Action Advised
492 2:45 Reference Service
493 2:47 Reference Date
494 2:50 Reference Number
495 2:55 Date Created
496 2:60 Time Created
497 2:62 Digital Creation Date
498 2:63 Digital Creation Time
499 2:65 Originating Program
500 2:70 Program Version
501 2:75 Object Cycle
502 2:80 By-Line (Author)
503 2:85 By-Line Title (Author Position) [Not used in Photoshop 7]
504 2:90 City
505 2:92 Sub-Location
506 2:95 Province/State
507 2:100 Country/Primary Location Code
508 2:101 Country/Primary Location Name
509 2:103 Original Transmission Reference
510 2:105 Headline
511 2:110 Credit
512 2:115 Source
513 2:116 Copyright Notice
514 2:118 Contact
515 2:120 Caption/Abstract
516 2:122 Caption Writer/Editor
517 2:125 Rasterized Caption
518 2:130 Image Type
519 2:131 Image Orientation
520 2:135 Language Identifier
521 2:150 Audio Type
522 2:151 Audio Sampling Rate
523 2:152 Audio Sampling Resolution
524 2:153 Audio Duration
525 2:154 Audio Outcue
526 2:200 ObjectData Preview File Format
527 2:201 ObjectData Preview File Format Version
528 2:202 ObjectData Preview Data
529
530 Pre-ObjectData Descriptor Record
531 7:10 Size Mode
532 7:20 Max Subfile Size
533 7:90 ObjectData Size Announced
534 7:95 Maximum ObjectData Size
535
536 ObjectData Record
537 8:10 Subfile
538
539 Post ObjectData Descriptor Record
540 9:10 Confirmed ObjectData Size
541</pre>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]542</div>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]543
544</div>
545
546<div id="linkbar">
547 <span id="linkbar-west">&nbsp;</span>
548 <span id="linkbar-center">
549 <a href="../discourse-server">Discourse Server</a> &bull;
550 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
551 </span>
552 <span id="linkbar-east">&nbsp;</span>
553 </div>
554 <div class="footer">
cristy45ef08f2012-12-07 13:13:34 +0000[diff] [blame]555 <span id="footer-west">&copy; 1999-2013 ImageMagick Studio LLC</span>
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]556 <span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
557 </div>
558 <div style="clear: both; margin: 0; width: 100%; "></div>
559 <script type="text/javascript">
560 var _gaq = _gaq || [];
561 _gaq.push(['_setAccount', 'UA-17690367-1']);
562 _gaq.push(['_trackPageview']);
563
564 (function() {
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]565 var ga = document.createElement('offline-script'); ga.type = 'text/javascript'; ga.async = true;
cristy6ad765e2013-02-24 22:14:01 +0000[diff] [blame]566 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.localhost/ga.js';
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]567 var s = document.getElementsByTagName('offline-script')[0]; s.parentNode.insertBefore(ga, s);
cristyad41c0c2012-10-31 00:49:28 +0000[diff] [blame]568 })();
569 </script>
570</body>
571</html>