commit f7964270f2b6d810576a32f8240fca73a352c51a
author cristy <urban-warrior@git.imagemagick.org> Sun Jan 30 03:49:12 2011 +0000
committer cristy <urban-warrior@git.imagemagick.org> Sun Jan 30 03:49:12 2011 +0000
tree 8255a4fcca13142dba563b6f648b4f1db6a390ca
parent d0083a691be4f20dbc31bc86ee9fda8b9f2b0f40

www/command-line-options.html

diff --git a/www/command-line-options.html b/www/command-line-options.html
index e1afdad..6aef369 100644
--- a/www/command-line-options.html
+++ b/www/command-line-options.html
@@ -160,7 +160,7 @@
   <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
 </div>
 <div  class="sponsor">
-   <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
+   <a title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
 </div>
 </div>
 </div>
@@ -1726,7 +1726,10 @@
 </pre>
 
     <p>The default behavior is to include all known PNG ancillary chunks
-    plus ImageMagick's private <kbd>vpAg</kbd> ("virtual page") chunk.</p>
+    plus ImageMagick's private <kbd>vpAg</kbd> ("virtual page") chunk,
+    and to exclude all PNG chunks that are unknown to ImageMagick,
+    regardless of their PNG "copy-safe" status as described in the
+    PNG specification.</p>
     </dd>
 
 <dt>ps:imagemask</dt>
@@ -4768,6 +4771,25 @@
 CMYK profiles are often very asymmetric since they involve 3&minus;&gt;4 and 4&minus;&gt;3 channel mapping.
 </p>
 
+<p>The <a href="#profile">-profile</a> option can also be used to inject
+previously-formatted ancillary chunks into the output PNG file, using
+the commandline option as shown below or by setting the profile via a
+programming interface:
+
+<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>-profile PNG-chunk-x:<filename></span></p>
+where <em>x</em> is a location flag and
+<em class="arg">filename</em> is a file containing the chunk
+name in the first 4 bytes, then a colon (":"), followed by the chunk data.
+This encoder will compute the chunk length and CRC, so those must not
+be included in the file.
+
+"x" can be "b" (before PLTE), "m" (middle, i.e., between PLTE and IDAT),
+or "e" (end, i.e., after IDAT).  If you want to write multiple chunks
+of the same type, then add a short unique string after the "x" to prevent
+subsequent profiles from overwriting the preceding ones, e.g.,
+
+
+<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>-profile PNG-chunk-b01:file01 -profile PNG-chunk-b02:file02</span></p>
 <div style="margin: auto;">
   <h4><a id="quality"></a>-quality <em class="arg">value</em></h4>
 </div>