]> granicus.if.org Git - imagemagick/blobdiff - www/escape.html
...
[imagemagick] / www / escape.html
index 49534a37695ea0a55d51a3714802d0d1a8f3c230..7e8b74fdbc1c34df710437640adec3175db5f247 100644 (file)
   <meta name="distribution" content="Global" />
   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
-  <link href="https://www.imagemagick.org/script/escape.html" rel="canonical" />
+  <link href="../www/escape.html" rel="canonical" />
   <link href="../images/wand.png" rel="icon" />
   <link href="../images/wand.ico" rel="shortcut icon" />
-  <link href="css/magick.css" rel="stylesheet" />
+  <link href="assets/magick.css" rel="stylesheet" />
 </head>
 <body>
-<div class="magick-masthead">
+  <header>
+  <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
+    <a class="navbar-brand" href="../index.html"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../images/wand.ico"/></a>
+    <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsExampleDefault" aria-controls="navbarsExampleDefault" aria-expanded="false" aria-label="Toggle navigation">
+      <span class="navbar-toggler-icon"></span>
+    </button>
+
+    <div class="navbar-collapse collapse" id="navbarsExampleDefault" style="">
+    <ul class="navbar-nav mr-auto">
+      <li class="nav-item ">
+        <a class="nav-link" href="../index.html">Home <span class="sr-only">(current)</span></a>
+      </li>
+      <li class="nav-item ">
+        <a class="nav-link" href="download.html">Download</a>
+      </li>
+      <li class="nav-item ">
+        <a class="nav-link" href="command-line-tools.html">Tools</a>
+      </li>
+      <li class="nav-item ">
+        <a class="nav-link" href="command-line-processing.html">Command-line</a>
+      </li>
+      <li class="nav-item ">
+        <a class="nav-link" href="resources.html">Resources</a>
+      </li>
+      <li class="nav-item ">
+        <a class="nav-link" href="develop.html">Develop</a>
+      </li>
+      <li class="nav-item">
+        <a class="nav-link" target="_blank" href="https://www.imagemagick.org/discourse-server/">Community</a>
+      </li>
+    </ul>
+    <form class="form-inline my-2 my-lg-0" action="https://www.imagemagick.org/script/search.php">
+      <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search">
+      <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button>
+    </form>
+    </div>
+  </nav>
   <div class="container">
-    <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
+   <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
          style="display:block"
          data-ad-client="ca-pub-3129977114552745"
          data-ad-slot="6345125851"
     <script>
       (adsbygoogle = window.adsbygoogle || []).push({});
     </script>
-    <nav class="nav magick-nav">
-      <a class="nav-link " href="../index.html">Home</a>
-      <a class="nav-link " href="download.html">Download</a>
-      <a class="nav-link " href="command-line-tools.html">Tools</a>
-      <a class="nav-link " href="command-line-processing.html">Command-line</a>
-      <a class="nav-link " href="resources.html">Resources</a>
-      <a class="nav-link " href="develop.html">Develop</a>
-      <a class="nav-link " href="https://www.imagemagick.org/script/search.php">Search</a>
-      <a class="nav-link float-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
-    </nav>
+
   </div>
-</div>
-<div class="container">
+  </header>
+  <main class="container">
+    <div class="magick-template">
 <div class="magick-header">
 <p class="lead magick-description">There are copious amounts of extra data associated with images (metadata), beyond the actual image pixels. This metadata can be useful, either for display, or for various calculations, or in modifying the behavior of later image processing operations.  You can utilize percent escapes in a number of options, for example in <a href="command-line-options.html#format_identify_">-format</a> or in montage <a href="command-line-options.html#label" >-label</a>, to print various properties and other settings associated with an image.</p>
 
@@ -122,8 +150,7 @@ insensitive manner. </p>
 free-form string tables directly, allowing you to override the above sequence,
 and avoid accessing an attribute or property of the same name.</p>
 
-<pre><code>
-%[artifact:<var>setting</var>]
+<pre class="highlight"><code>%[artifact:<var>setting</var>]
 %[option:<var>setting</var>]
 </code></pre>
 
@@ -162,7 +189,7 @@ filename, type, width, height. </p>
   </tr>
   <tr>
     <td>%b</td>
-    <td>file size of image read in</td>
+    <td>file size of image read in (use <a href="escape.html#precision">-precision</a> 16 to force results in B)</td>
   </tr>
   <tr>
     <td>%c</td>
@@ -256,6 +283,10 @@ filename, type, width, height. </p>
     <td>%A</td>
     <td>image transparency channel enabled (true/false)</td>
   </tr>
+  <tr>
+    <td>%B</td>
+    <td>file size of image read in bytes</td>
+  </tr>
   <tr>
     <td>%C</td>
     <td>image compression type</td>
@@ -329,8 +360,7 @@ filename, type, width, height. </p>
 <p>Here is a sample command and its output for an image with filename
 <code>bird.miff</code> and whose width is 512 and height is 480.</p>
 
-<pre><code>
--> identify -format "%m:%f %wx%h" bird.miff
+<pre class="highlight"><code>-> identify -format "%m:%f %wx%h" bird.miff
 MIFF:bird.miff 512x480
 </code></pre>
 
@@ -355,9 +385,13 @@ when enclosed in braces (long form):</p>
 <div class="table-responsive">
 <table class="table table-sm table-striped">
   <tr>
-    <td>%[base]</td>
+    <td>%[basename]</td>
     <td>base filename, no suffixes (as %t)</td>
   </tr>
+  <tr>
+    <td>%[bit-depth]</td>
+    <td>Actual bit-depth of the pixel data</td>
+  </tr>
   <tr>
     <td>%[caption]</td>
     <td>caption meta-data property</td>
@@ -376,11 +410,15 @@ when enclosed in braces (long form):</p>
   </tr>
   <tr>
     <td>%[colorspace]</td>
-    <td>Colorspace of Image Data (excluding transparency)</td>
+    <td>colorspace of Image Data (excluding transparency)</td>
+  </tr>
+  <tr>
+    <td>%[compose]</td>
+    <td> </td>
   </tr>
   <tr>
     <td>%[compression]</td>
-    <td>Image compression type (as of IM 7.0.3.8)</td>
+    <td>image compression type (as of IM 6.9.6-6)</td>
   </tr>
   <tr>
     <td>%[copyright]</td>
@@ -422,6 +460,10 @@ when enclosed in braces (long form):</p>
     <td>%[height]</td>
     <td>original height of image (when it was read in)</td>
   </tr>
+  <tr>
+    <td>%[input]</td>
+    <td> </td>
+  </tr>
   <tr>
     <td>%[interlace]</td>
     <td>Image interlace mode (as of IM 7.0.3.8)</td>
@@ -454,10 +496,6 @@ when enclosed in braces (long form):</p>
     <td>%[min]</td>
     <td>CALCULATED: minimum value statistic of image</td>
   </tr>
-  <tr>
-    <td>%[name]</td>
-    <td>The original name of the image</td>
-  </tr>
   <tr>
     <td>%[opaque]</td>
     <td>CALCULATED: is image fully-opaque?</td>
@@ -633,8 +671,7 @@ Artifact. </p>
 now list all free-form string properties, artifacts, and options, (but not
 specific image attributes) using...</p>
 
-<pre><code>
-convert ... \
+<pre class="highlight"><code>convert ... \
    -print "__Properties__\n%[*]" \
    -print "__Artifacts__\n%[artifact:*]" \
    -print "__Options__\n%[option:*]" \
@@ -653,16 +690,14 @@ calculations based on the user provided string that follows that prefix.  For
 example you can do a numerical calculation use <code>%[fx:...]</code> to
 evaluate the given <a href="fx.html">FX</a> expressions:</p>
 
-<pre><code>
-%[fx:<var>expression</var>]
+<pre class="highlight"><code>%[fx:<var>expression</var>]
 </code></pre>
 
 <p>Use <code>pixel:</code> or <code>hex:</code> to evaluate a pixel color as defined by the <a
 href="fx.html">FX</a>
 expression:</p>
 
-<pre><code>
-%[pixel:<var>expression</var>]
+<pre class="highlight"><code>%[pixel:<var>expression</var>]
 </code></pre>
 
 <h3>Specific Profile Percent Escape Prefixes</h3>
@@ -670,8 +705,7 @@ expression:</p>
 <p>You can also use the following special formatting syntax to print EXIF
 mage meta-data that was included in the image read in:</p>
 
-<pre><code>
-%[EXIF:<var>tag</var>]
+<pre class="highlight"><code>%[EXIF:<var>tag</var>]
 </code></pre>
 
 <p>Choose <var>tag</var> from the following:</p>
@@ -770,8 +804,7 @@ shell from misinterpreting any spaces and square brackets.</p>
 <p>The following special formatting syntax can be used to print IPTC
 information contained in the file:</p>
 
-<pre><code>
-%[IPTC:<var>dataset</var>:<var>record</var>]
+<pre class="highlight"><code>%[IPTC:<var>dataset</var>:<var>record</var>]
 </code></pre>
 
 <p>Select <var>dataset</var> and <var>record</var> from the following:</p>
@@ -864,22 +897,26 @@ Post ObjectData Descriptor Record
   9:10   Confirmed ObjectData Size
 </code></pre>
 </div>
+    </div>
+  </main><!-- /.container -->
   <footer class="magick-footer">
-    <p><a href="support.html">Donate</a> •
-     <a href="sitemap.html">Sitemap</a> •
+    <p><a href="security-policy.html">Security</a> •
+    <a href="architecture.html">Architecture</a> •
     <a href="links.html">Related</a> •
-    <a href="security-policy.html">Security</a> •
-    <a href="architecture.html">Architecture</a>
-</p>
-    <p><a href="escape.html#">Back to top</a> •
-    <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
-    <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
-        <p><small>© 1999-2017 ImageMagick Studio LLC</small></p>
+     <a href="sitemap.html">Sitemap</a>
+       
+    <a href="escape.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico"/></a>
+       
+    <a href="http://pgp.mit.edu/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
+    <a href="support.html">Donate</a> •
+    <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a>
+    <br/>
+        <small>© 1999-2018 ImageMagick Studio LLC</small></p>
   </footer>
-</div><!-- /.container -->
 
-  <script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
-  <script src="../js/magick.html"></script>
+  <!-- Javascript assets -->
+  <script src="assets/magick.js" crossorigin="anonymous"></script>
+  <script>window.jQuery || document.write('<script src="assets/jquery.min.js"><\/script>')</script>
 </body>
 </html>
-<!-- Magick Cache 30th July 2017 18:17 -->
\ No newline at end of file
+<!-- Magick Cache 8th July 2018 08:37 -->
\ No newline at end of file