<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
<meta name="application-name" content="ImageMagick"/>
- <meta name="description" content="A collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats."/>
+ <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
<meta name="application-url" content="http://www.imagemagick.org"/>
<meta name="generator" content="PHP"/>
- <meta name="keywords" content="convert, edit, or, compose, bitmap, images, convert, edit, compose, image, pixel"/>
+ <meta name="keywords" content="convert, edit, or, compose, bitmap, images, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
<meta name="rating" content="GENERAL"/>
<meta name="robots" content="INDEX, FOLLOW"/>
<meta name="generator" content="ImageMagick Studio LLC"/>
<meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
<meta name="distribution" content="Global"/>
<meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
- <link rel="icon" href="wand.png"/>
- <link rel="shortcut icon" href="wand.ico" type="images/x-icon"/>
+ <link rel="icon" href="http://www.imagemagick.org/images/wand.png"/>
+ <link rel="shortcut icon" href="http://www.imagemagick.org/images/wand.ico" type="images/x-icon"/>
<link rel="canonical" href="http://www.imagemagick.org" />
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
</script>
</div>
<a href="discourse-server">
- <img src="logo.jpg"
+ <img src="http://www.imagemagick.org/images/logo.jpg"
alt="ImageMagick Logo" width="123" height="118"
style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
<a href="http://www.imagemagick.org/index.html">
- <img src="sprite.jpg"
+ <img src="http://www.imagemagick.org/images/sprite.jpg"
alt="ImageMagick Sprite" width="114" height="118"
style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
</div>
<a id="intro"></a>
<div class="doc-section">
-<p><a class="fancybox" rel="group" href="wizard.png" title="And Now a Touch of Magick"><img id="logo" alt="And Now a Touch of Magick" class="icon" width="265" height="352" src="wizard.jpg"/></a> ImageMagick<sup><a href="http://tarr.uspto.gov/servlet/tarr?regser=serial&entry=78333969">®</a></sup> is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of <a href="formats.html">formats</a> (over 200) including <a href="motion-picture.html">DPX</a>, <a href="high-dynamic-range.html">EXR</a>, GIF, JPEG, JPEG-2000, PDF, PNG, Postscript, SVG, and TIFF. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.</p>
+<p><a class="fancybox" rel="group" href="http://www.imagemagick.org/images/wizard.png" title="And Now a Touch of Magick"><img id="logo" alt="And Now a Touch of Magick" class="icon" width="265" height="352" src="http://www.imagemagick.org/images/wizard.jpg"/></a> ImageMagick<sup><a href="http://tarr.uspto.gov/servlet/tarr?regser=serial&entry=78333969">®</a></sup> is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of <a href="formats.html">formats</a> (over 200) including PNG, JPEG, JPEG-2000, GIF, TIFF, <a href="motion-picture.html">DPX</a>, <a href="high-dynamic-range.html">EXR</a>, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.</p>
<p>The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite language. Choose from these interfaces: <a href="api.html#ada">G2F</a> (Ada), <a href="api.html#c">MagickCore</a> (C), <a href="api.html#c">MagickWand</a> (C), <a href="api.html#ch">ChMagick</a> (Ch), <a href="api.html#com_">ImageMagickObject</a> (COM+), <a href="api.html#c__">Magick++</a> (C++), <a href="api.html#java">JMagick</a> (Java), <a href="api.html#lisp">L-Magick</a> (Lisp), <a href="api.html#lua">Lua</a>, <a href="api.html#neko">NMagick</a> (Neko/haXe), <a href="api.html#dot-net">Magick.NET</a> (.NET), <a href="api.html#pascal">PascalMagick</a> (Pascal), <a href="api.html#perl">PerlMagick</a> (Perl), <a href="api.html#php">MagickWand for PHP</a> (PHP), <a href="api.html#php">IMagick</a> (PHP), <a href="api.html#python">PythonMagick</a> (Python), <a href="api.html#ruby">RMagick</a> (Ruby), or <a href="api.html#tcl">TclMagick</a> (Tcl/TK). With a language interface, use ImageMagick to modify or create images dynamically and <em>automagically</em>.</p>
<p>The ImageMagick development process ensures a <a href="http://upstream-tracker.org/versions/imagemagick.html">stable API</a> and ABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes <a href="https://code.google.com/p/address-sanitizer/">memory error</a> and <a href="https://code.google.com/p/data-race-test/wiki/ThreadSanitizer">thread data race</a> detection to prevent security vulnerabilities.</p>
-<p>The current release is ImageMagick 6.9.0-
7 available from <a href="download">http://www.imagemagick.org/download</a>. It runs on <a href="http://www.imagemagick.org/download/linux/">Linux</a>, <a href="http://www.imagemagick.org/download/binaries/">Windows</a>, <a href="http://www.imagemagick.org/download/binaries/">Mac Os X</a>, <a href="http://www.imagemagick.org/download/iOS/">iOS</a>, Android OS, and others.</p>
+<p>The current release is ImageMagick 6.9.0-
10 available from <a href="download">http://www.imagemagick.org/download</a>. It runs on <a href="http://www.imagemagick.org/download/linux/">Linux</a>, <a href="http://www.imagemagick.org/download/binaries/">Windows</a>, <a href="http://www.imagemagick.org/download/binaries/">Mac Os X</a>, <a href="http://www.imagemagick.org/download/iOS/">iOS</a>, Android OS, and others.</p>
<p>The authoritative ImageMagick web site is <a href="http://www.imagemagick.org/">http://www.imagemagick.org</a>.</p>
</div>
<div style="clear: both; margin: 0; width: 100%; "></div>
</body>
</html>
-<!-- Magick Cache 28th February 2015 06:32 -->
\ No newline at end of file
+<!-- Magick Cache 8th March 2015 08:23 -->
\ No newline at end of file
-/* The standard CSS for doxygen 1.8.6 */
+/* The standard CSS for doxygen 1.8.9.1 */
body, table, div, p, dl {
font: 400 14px/22px Roboto,sans-serif;
background-color: #C8C8C8;
}
-div.ah {
+div.ah, span.ah {
background-color: black;
font-weight: bold;
color: #ffffff;
background-image: -moz-linear-gradient(center top, #eee 0%, #444 40%, #000);
}
+div.classindex ul {
+ list-style: none;
+ padding-left: 0;
+}
+
+div.classindex span.ai {
+ display: inline-block;
+}
+
div.groupHeader {
margin-left: 16px;
margin-top: 12px;
/* @end */
-/* these are for tree view when not used as main index */
+/* these are for tree view inside a (index) page */
div.directory {
margin: 10px 0px;
- border-top: 1px solid #A8B8D9;
- border-bottom: 1px solid #A8B8D9;
+ border-top: 1px solid #9CAFD4;
+ border-bottom: 1px solid #9CAFD4;
width: 100%;
}
color: #3D578C;
}
+.arrow {
+ color: #9CAFD4;
+ -webkit-user-select: none;
+ -khtml-user-select: none;
+ -moz-user-select: none;
+ -ms-user-select: none;
+ user-select: none;
+ cursor: pointer;
+ font-size: 80%;
+ display: inline-block;
+ width: 16px;
+ height: 22px;
+}
+
+.icon {
+ font-family: Arial, Helvetica;
+ font-weight: bold;
+ font-size: 12px;
+ height: 14px;
+ width: 16px;
+ display: inline-block;
+ background-color: #728DC1;
+ color: white;
+ text-align: center;
+ border-radius: 4px;
+ margin-left: 2px;
+ margin-right: 2px;
+}
+
+.icona {
+ width: 24px;
+ height: 22px;
+ display: inline-block;
+}
+
+.iconfopen {
+ width: 24px;
+ height: 18px;
+ margin-bottom: 4px;
+ background-image:url('folderopen.png');
+ background-position: 0px -4px;
+ background-repeat: repeat-y;
+ vertical-align:top;
+ display: inline-block;
+}
+
+.iconfclosed {
+ width: 24px;
+ height: 18px;
+ margin-bottom: 4px;
+ background-image:url('folderclosed.png');
+ background-position: 0px -4px;
+ background-repeat: repeat-y;
+ vertical-align:top;
+ display: inline-block;
+}
+
+.icondoc {
+ width: 24px;
+ height: 18px;
+ margin-bottom: 4px;
+ background-image:url('doc.png');
+ background-position: 0px -4px;
+ background-repeat: repeat-y;
+ vertical-align:top;
+ display: inline-block;
+}
+
+table.directory {
+ font: 400 14px Roboto,sans-serif;
+}
+
+/* @end */
+
div.dynheader {
margin-top: 8px;
-webkit-touch-callout: none;
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
-<meta name="generator" content="Doxygen 1.8.6"/>
+<meta name="generator" content="Doxygen 1.8.9.1"/>
<title>MagickCore: Main Page</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
+<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</table>
</div>
<!-- end header part -->
-<!-- Generated by Doxygen 1.8.6 -->
+<!-- Generated by Doxygen 1.8.9.1 -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<ul>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6 </li>
+ <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.9.1 </li>
</ul>
</div>
</body>
-/* The standard CSS for doxygen 1.8.6 */
+/* The standard CSS for doxygen 1.8.9.1 */
body, table, div, p, dl {
font: 400 14px/22px Roboto,sans-serif;
background-color: #C8C8C8;
}
-div.ah {
+div.ah, span.ah {
background-color: black;
font-weight: bold;
color: #ffffff;
background-image: -moz-linear-gradient(center top, #eee 0%, #444 40%, #000);
}
+div.classindex ul {
+ list-style: none;
+ padding-left: 0;
+}
+
+div.classindex span.ai {
+ display: inline-block;
+}
+
div.groupHeader {
margin-left: 16px;
margin-top: 12px;
/* @end */
-/* these are for tree view when not used as main index */
+/* these are for tree view inside a (index) page */
div.directory {
margin: 10px 0px;
- border-top: 1px solid #A8B8D9;
- border-bottom: 1px solid #A8B8D9;
+ border-top: 1px solid #9CAFD4;
+ border-bottom: 1px solid #9CAFD4;
width: 100%;
}
color: #3D578C;
}
+.arrow {
+ color: #9CAFD4;
+ -webkit-user-select: none;
+ -khtml-user-select: none;
+ -moz-user-select: none;
+ -ms-user-select: none;
+ user-select: none;
+ cursor: pointer;
+ font-size: 80%;
+ display: inline-block;
+ width: 16px;
+ height: 22px;
+}
+
+.icon {
+ font-family: Arial, Helvetica;
+ font-weight: bold;
+ font-size: 12px;
+ height: 14px;
+ width: 16px;
+ display: inline-block;
+ background-color: #728DC1;
+ color: white;
+ text-align: center;
+ border-radius: 4px;
+ margin-left: 2px;
+ margin-right: 2px;
+}
+
+.icona {
+ width: 24px;
+ height: 22px;
+ display: inline-block;
+}
+
+.iconfopen {
+ width: 24px;
+ height: 18px;
+ margin-bottom: 4px;
+ background-image:url('folderopen.png');
+ background-position: 0px -4px;
+ background-repeat: repeat-y;
+ vertical-align:top;
+ display: inline-block;
+}
+
+.iconfclosed {
+ width: 24px;
+ height: 18px;
+ margin-bottom: 4px;
+ background-image:url('folderclosed.png');
+ background-position: 0px -4px;
+ background-repeat: repeat-y;
+ vertical-align:top;
+ display: inline-block;
+}
+
+.icondoc {
+ width: 24px;
+ height: 18px;
+ margin-bottom: 4px;
+ background-image:url('doc.png');
+ background-position: 0px -4px;
+ background-repeat: repeat-y;
+ vertical-align:top;
+ display: inline-block;
+}
+
+table.directory {
+ font: 400 14px Roboto,sans-serif;
+}
+
+/* @end */
+
div.dynheader {
margin-top: 8px;
-webkit-touch-callout: none;
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
-<meta name="generator" content="Doxygen 1.8.6"/>
+<meta name="generator" content="Doxygen 1.8.9.1"/>
<title>MagickWand: Main Page</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
+<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</table>
</div>
<!-- end header part -->
-<!-- Generated by Doxygen 1.8.6 -->
+<!-- Generated by Doxygen 1.8.9.1 -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<ul>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6 </li>
+ <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.9.1 </li>
</ul>
</div>
</body>
<meta name="resource-type" content="document"></meta>
<meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"></meta>
<meta name="distribution" content="Global"></meta>
- <link rel="icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.png"></link>
- <link rel="shortcut icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.ico" type="images/x-icon"></link>
- <link rel="canonical" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html"></link>
+ <link rel="icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.png"></link>
+ <link rel="shortcut icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.ico" type="images/x-icon"></link>
+ <link rel="canonical" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html"></link>
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"></link>
<!-- Add jQuery library -->
<!-- ImageMagick style -->
<style type="text/css" media="all">
- @import url("../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick.css");
+ @import url("../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick.css");
</style>
</head>
</script>
</div>
-<a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">
- <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/logo.jpg" alt="ImageMagick Logo" style="width: 123px; height: 118px; border: 0px; float: right;"></img></a>
-<a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">
- <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/sprite.jpg" alt="ImageMagick Sprite" style="width: 114px; height: 118px; border: 0px; float: right;"></img></a>
+<a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">
+ <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/logo.jpg" alt="ImageMagick Logo" style="width: 123px; height: 118px; border: 0px; float: right;"></img></a>
+<a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">
+ <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/sprite.jpg" alt="ImageMagick Sprite" style="width: 114px; height: 118px; border: 0px; float: right;"></img></a>
</div>
<div class="westbar">
<div class="menu">
- <a title="About ImageMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">About ImageMagick</a>
+ <a title="About ImageMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">About ImageMagick</a>
</div>
<div class="menu">
- <a title="Binary Releases" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html">Binary Releases</a>
+ <a title="Binary Releases" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html">Binary Releases</a>
</div>
<div class="sub">
- <a title="Binary Release: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#unix">Unix</a>
+ <a title="Binary Release: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#unix">Unix</a>
</div>
<div class="sub">
- <a title="Binary Release: MacOS X" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#macosx">Mac OS X</a>
+ <a title="Binary Release: MacOS X" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#macosx">Mac OS X</a>
</div>
<div class="sub">
- <a title="Binary Release: iOS" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#iOS">iOS</a>
+ <a title="Binary Release: iOS" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#iOS">iOS</a>
</div>
<div class="sub">
- <a title="Binary Release: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#windows">Windows</a>
+ <a title="Binary Release: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#windows">Windows</a>
</div>
<div class="sep"></div>
<div class="menu">
- <a title="Command-line Tools" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-tools.html">Command-line Tools</a>
+ <a title="Command-line Tools" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-tools.html">Command-line Tools</a>
</div>
<div class="sub">
- <a title="Command-line Tools: Processing" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-processing.html">Processing</a>
+ <a title="Command-line Tools: Processing" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-processing.html">Processing</a>
</div>
<div class="sub">
- <a title="Command-line Tools: Options" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-options.html">Options</a>
+ <a title="Command-line Tools: Options" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-options.html">Options</a>
</div>
<div class="sub">
<a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
</div>
<div class="menu">
- <a title="Program Interfaces" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/api.html">Program Interfaces</a>
+ <a title="Program Interfaces" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/api.html">Program Interfaces</a>
</div>
<div class="sub">
- <a title="Program Interface: MagickWand" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-wand.html">MagickWand</a>
+ <a title="Program Interface: MagickWand" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-wand.html">MagickWand</a>
</div>
<div class="sub">
- <a title="Program Interface: MagickCore" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-core.html">MagickCore</a>
+ <a title="Program Interface: MagickCore" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-core.html">MagickCore</a>
</div>
<div class="sub">
- <a title="Program Interface: PerlMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/perl-magick.html">PerlMagick</a>
+ <a title="Program Interface: PerlMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/perl-magick.html">PerlMagick</a>
</div>
<div class="sub">
- <a title="Program Interface: Magick++" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick++.html">Magick++</a>
+ <a title="Program Interface: Magick++" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick++.html">Magick++</a>
</div>
<div class="sep"></div>
<div class="menu">
- <a title="Install from Source" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html">Install from Source</a>
+ <a title="Install from Source" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html">Install from Source</a>
</div>
<div class="sub">
- <a title="Install from Source: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#unix">Unix</a>
+ <a title="Install from Source: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#unix">Unix</a>
</div>
<div class="sub">
- <a title="Install from Source: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#windows">Windows</a>
+ <a title="Install from Source: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#windows">Windows</a>
</div>
<div class="menu">
- <a title="Resources" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/resources.html">Resources</a>
+ <a title="Resources" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/resources.html">Resources</a>
</div>
<div class="menu">
- <a title="Architecture" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/architecture.html">Architecture</a>
+ <a title="Architecture" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/architecture.html">Architecture</a>
</div>
<div class="menu">
- <a title="Download" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/download.html">Download</a>
+ <a title="Download" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/download.html">Download</a>
</div>
<div class="sep"></div>
<div class="menu">
- <a title="Search" href="http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/script/search.php">Search</a>
+ <a title="Search" href="http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/script/search.php">Search</a>
</div>
<div class="sep"></div>
<div class="menu">
- <a title="Site Map" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sitemap.html">Site Map</a>
+ <a title="Site Map" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sitemap.html">Site Map</a>
</div>
<div class="sub">
- <a title="Site Map: Links" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/links.html">Links</a>
+ <a title="Site Map: Links" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/links.html">Links</a>
</div>
<div class="sep"></div>
<div class="menu">
- <a title="Support ImageMagick Development" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/support.html">Support ImageMagick Development</a>
+ <a title="Support ImageMagick Development" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/support.html">Support ImageMagick Development</a>
</div>
</div>
<div class="eastbar">
- <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html"></a></div>
+ <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html"></a></div>
<noscript>
<a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
<img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0"></img></a>
<span id="linkbar-center">
<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
- <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">Discourse Server</a> •
+ <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">Discourse Server</a> •
<a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
<a href="http://jqmagick.imagemagick.org/">JqMagick</a>
</span>
</div>
<div class="footer">
<span id="footer-west">© 1999-2015 ImageMagick Studio LLC</span>
- <span id="footer-east"> <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/contact.html">Contact the Wizards</a></span>
+ <span id="footer-east"> <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/contact.html">Contact the Wizards</a></span>
</div>
<div style="clear: both; margin: 0; width: 100%; "></div>
</body>
<p>See <a href="command-line-processing.html#geometry">Image Geometry</a> for complete details about the <em class="arg">geometry</em> argument.</p><p>The <em class="arg">width</em> and <em class="arg">height</em> of the <emclass="arg">geometry</em> argument give the size of the image that remainsafter cropping, and <em class="arg">x</em> and <em class="arg">y</em> in the<em class="arg">offset</em> (if present) gives the location of the top leftcorner of the cropped image with respect to the original image. To specify theamount to be removed, use <a href="command-line-options.html#shave">-shave</a> instead.</p><p>If the <em class="arg">x</em> and <em class="arg">y</em> offsets arepresent, a single image is generated, consisting of the pixels from thecropping region. The offsets specify the location of the upper left corner ofthe cropping region measured downward and rightward with respect to the upperleft corner of the image. If the <a href="command-line-options.html#gravity">-gravity</a> option ispresent with <code>NorthEast</code>, <code>East</code>, or <code>SouthEast</code>gravity, it gives the distance leftward from the right edge of the image tothe right edge of the cropping region. Similarly, if the <ahref="command-line-options.html#gravity">-gravity</a> option is present with <code>SouthWest</code>,<code>South</code>, or <code>SouthEast</code> gravity, the distance is measuredupward between the bottom edges.</p><p>If the <em class="arg">x</em> and <em class="arg">y</em> offsets areomitted, a set of tiles of the specified geometry, covering the entire inputimage, is generated. The rightmost tiles and the bottom tiles are smaller ifthe specified geometry extends beyond the dimensions of the input image.</p><p>You can add the <em class="arg">@</em> to the geometry argument to equally divide the image into the number of tiles generated.</p><p>By adding a exclamation character flag to the geometry argument, thecropped images virtual canvas page size and offset is set as if thegeometry argument was a viewport or window. This means the canvas page sizeis set to exactly the same size you specified, the image offset setrelative top left corner of the region cropped. </p><p>If the cropped image 'missed' the actual image on its virtual canvas, aspecial single pixel transparent 'missed' image is returned, and a 'cropmissed' warning given. </p><p>It might be necessary to <a href="command-line-options.html#repage" >+repage</a> the image prior tocropping the image to ensure the crop coordinate frame is relocated to theupper-left corner of the visible image.Similarly you may want to use <a href="command-line-options.html#repage" >+repage</a> after cropping toremove the page offset that will be left behind. This is especially true whenyou are going to write to an image format such as PNG that supports an imageoffset.</p><div style="margin: auto;"> <h4><a id="cycle"></a>-cycle <em class="arg">amount</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>displace image colormap by amount.</td><td style='text-align:right;'></td></tr></table>
<p><em class="arg">Amount</em> defines the number of positions eachcolormap entry is shifted.</p><div style="margin: auto;"> <h4><a id="debug"></a>-debug <em class="arg">events</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>enable debug printout.</td><td style='text-align:right;'></td></tr></table>
<p>The <code>events</code> parameter specifies which events are to be logged. Itcan be either <code>None</code>, <code>All</code>, <code>Trace</code>, ora comma-separated list consisting of one or more of the following domains:<code>Accelerate</code>, <code>Annotate</code>, <code>Blob</code>, <code>Cache</code>,<code>Coder</code>, <code>Configure</code>, <code>Deprecate</code>,<code>Exception</code>, <code>Locale</code>, <code>Render</code>,<code>Resource</code>, <code>Security</code>, <code>TemporaryFile</code>,<code>Transform</code>, <code>X11</code>, or <code>User</code>. </p><p>For example, to log cache and blob events, use.</p><p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -debug "Cache,Blob" rose: rose.png</span></p><p>The <code>User</code> domain is normally empty, but developers can log userevents in their private copy of ImageMagick.</p><p>To print the complete list of debug methods, use <a href="command-line-options.html#list">-listdebug</a>.</p><p>Use the <a href="command-line-options.html#log">-log</a> option to specify the format for debuggingoutput.</p><p>Use <a href="command-line-options.html#debug">+debug</a> to turn off all logging.</p><p>Debugging may also be set using the <code>MAGICK_DEBUG</code> <a href="resources.html#environment">environment variable</a>. The allowed values for the <code>MAGICK_DEBUG</code>environment variable are the same as for the <a href="command-line-options.html#debug">-debug</a>option.</p><div style="margin: auto;"> <h4><a id="decipher"></a>-decipher <em class="arg">filename</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Decipher and restore pixels that were previously transformed by<a href="command-line-options.html#encipher">-encipher</a>.</td><td style='text-align:right;'></td></tr></table>
-<p>Get the passphrase from the file specified by <emclass="arg">filename</em>.</p><p>For more information, see the webpage, <ahref="
http://www.imagemagick.org/www/cipher.html">ImageMagick: Encipher orDecipher an Image</a>.</p><div style="margin: auto;"> <h4><a id="deconstruct"></a>-deconstruct</h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>find areas that has changed between images </td><td style='text-align:right;'></td></tr></table>
+<p>Get the passphrase from the file specified by <emclass="arg">filename</em>.</p><p>For more information, see the webpage, <ahref="
../cipher.html">ImageMagick: Encipher orDecipher an Image</a>.</p><div style="margin: auto;"> <h4><a id="deconstruct"></a>-deconstruct</h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>find areas that has changed between images </td><td style='text-align:right;'></td></tr></table>
<p>Given a sequence of images all the same size, such as produced by <ahref="command-line-options.html#coalesce">-coalesce</a>, replace the second and later images, witha smaller image of just the area that changed relative to the previous image.</p><p>The resulting sequence of images can be used to optimize an animationsequence, though will not work correctly for GIF animations when parts of theanimation can go from opaque to transparent. </p><p>This option is actually equivalent to the <a href="command-line-options.html#layers">-layers</a>method '<code>compare-any</code>'. </p><div style="margin: auto;"> <h4><a id="define"></a>-define <em class="arg">key</em>{<em class="arg">=value</em>}<em class="arg">...</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>add specific global settings generally used to controlcoders and image processing operations.</td><td style='text-align:right;'></td></tr></table>
<p>This option creates one or more definitions for coders and decoders to usewhile reading and writing image data. Definitions are generally used tocontrol image file format coder modules, and image processing operations,beyond what is provided by normal means. Defined settings are listed in <ahref="command-line-options.html#verbose" >-verbose</a> information ("<code>info:</code>" output format)as "Artifacts". </p><p>If <em class="arg">value</em> is missing for a definition, an empty-valueddefinition of a flag is created with that name. This used to control on/offoptions. Use <a href="command-line-options.html#define">+define key</a> to remove definitionspreviously created. Use <a href="command-line-options.html#define">+define "*"</a> to remove allexisting definitions.</p><p>The same 'artifact' settings can also be defined using the <ahref="command-line-options.html#set" >-set "option:<em class="arg">key</em>" "<em class="arg">value</em>"</a> option, which also allows the use of <a href="escape.html" >Format and Print ImageProperties</a> in the defined value. </p><p>The <em>option</em> and <em>key</em> are case-independent (they areconverted to lowercase for use within the decoders) while the <em>value</em>is case-dependent.</p><p>Such settings are global in scope, and affect all images and operations. </p><p>The following definitions are just some of the artifacts that areavailable:</p><dl><dt>bmp:format=<em class="arg">value</em></dt> <dd> valid values are <em class="arg">bmp2</em>, <em class="arg">bmp3</em>, and <em class="arg">bmp4</em>. This option can be useful when the method of prepending "BMP2:" to the output filename is inconvenient or is not available, such as when using the <a href="mogrify.html">mogrify</a> utility.</dd><dt>complex:snr=<em class="arg">value</em></dt> <dd>Set the divide SNR constant<a href="command-line-options.html#complex" >-complex</a></dd><dt>compose:args=<em class="arg">arguments</em></dt> <dd>Sets certain compose argument values when using convert ... -compose ... -composite. See <a href="../compose.html" >Image Composition</a></dd><dt>convolve:scale=<em class="arg">{kernel_scale}[!^] [,{origin_addition}] [%]</em></dt> <dd>Defines the kernel scaling. The special flag ! automatically scales to full dynamic range. The ! flag can be used in combination with a factor or percent. The factor or percent is then applied after the automatic scaling. An example is 50%!. This produces a result 50% darker than full dynamic range scaling. The ^ flag assures the kernel is 'zero-summing', for example when some values are positive and some are negative as in edge detection kernels. The origin addition adds that value to the center pixel of the kernel. This produces and effect that is like adding the image that many times to the result of the filtered image. The typical value is 1 so that the original image is added to the result of the convolution. The default is 0.</dd><dt>convolve:showkernel=<em class="arg">1</em></dt> <dd>Outputs (to 'standard error') all the information about a specified <a href="command-line-options.html#morphology" >-morphology convolve</a> kernel.</dd><dt>dcm:display-range=<em class="arg">reset</em></dt> <dd>Sets the display range to the minimum and maximum pixel values for the DCM image format.</dd><dt>dds:cluster-fit=<em class="arg">true|false</em></dt> <dd>Enables the dds cluster-fit.</dd><dt>dds:compression=<em class="arg">dxt1|dxt5|none</em></dt> <dd>Sets the dds compression.</dd><dt>dds:mipmaps=<em class="arg">value</em></dt> <dd>Sets the dds number of mipmaps.</dd><dt>dds:weight-by-alpha=<em class="arg">true|false</em></dt> <dd>Enables the dds alpha weighting.</dd><dt>delegate:bimodal=<em class="arg">true</em></dt> <dd>Specifies direct conversion from Postscript to PDF.</dd><dt>distort:scale=<em class="arg">value</em></dt> <dd>Sets the output scaling factor for use with <a href="command-line-options.html#distort" >-distort</a></dd><dt>distort:viewport=<em class="arg">WxH+X+Y</em></dt> <dd>Sets the viewport for use with <a href="command-line-options.html#distort">-distort</a></dd><dt>dot:layout-engine=<em class="arg">value</em></dt> <dd>Specifies the layout engine for the DOT image format (e.g. <code>neato</code>).</dd><dt>filter:option=<em class="arg">value</em></dt> <dd>Set a filter option for use with <a href="command-line-options.html#resize">-resize</a>. See <a href="command-line-options.html#filter">-filter</a> for details.</dd><dt>fourier:normalize=<em class="arg">inverse</em></dt> <dd>Sets the location for the FFT/IFT normalization as use by <a href="command-line-options.html#fft">+-fft</a> and <a href="command-line-options.html#ift">+-ift</a>. The default is forward.</dd><dt>icon:auto-resize</dt> <dd>Automatically stores multiple sizes when writing an ico image (requires a 256x256 input image).</dd><dt>jp2:layer-number=<em class="arg">value</em></dt> <dd>Sets the maximum number of quality layers to decode. Same for JPT, JC2, and J2K</dd><dt>jp2:number-resolutions=<em class="arg">value</em></dt> <dd>Sets the number of resolutions to encode.Same for JPT, JC2, and J2K</dd><dt>jp2:progression-order=<em class="arg">value</em></dt> <dd>choose from LRCP, RLCP, RPCL, PCRL or CPRL. Same for JPT, JC2, and J2K</dd></dd><dt>jp2:quality=<em class="arg">value,value...</em></dt> <dd>Sets the quality layer PSNR, given in dB. The order is from left to right in ascending order. The default is a single lossless quality layer. Same for JPT, JC2, and J2K</dd></dd><dt>jp2:rate=<em class="arg">value</em></dt> <dd>Specify the compression factor to use while writing JPEG-2000 files. The compression factor is the reciprocal of the compression ratio. The valid range is 0.0 to 1.0, with 1.0 indicating lossless compression. If defined, this value overrides the -quality setting. A quality setting of 75 results in a rate value of 0.06641. Same for JPT, JC2, and J2K</dd></dd><dt>jp2:reduce-factor=<em class="arg">value</em></dt> <dd>Sets the number of highest resolution levels to be discarded.Same for JPT, JC2, and J2K</dd></dd><dt>jpeg:block-smoothing=<em class="arg">on|off</em></dt><dt>jpeg:colors=<em class="arg">value</em></dt> <dd>Set the desired number of colors and let the JPEG encoder do the quantizing.</dd><dt>jpeg:dct-method=<em class="arg">value</em></dt> <dd>Choose from <code>default</code>, <code>fastest</code>, <code>float</code>, <code>ifast</code>, and <code>islow</code>.</dd><dt>jpeg:extent=<em class="arg">value</em></dt> <dd>Restrict the maximum JPEG file size, for example <code>-define jpeg:extent=400KB</code>. The JPEG encoder will search for the highest compression quality level that results in an output file that does not exceed the value. The <code>-quality</code> option is ignored if it is also present.</dd><dt>jpeg:fancy-upsampling=<em class="arg">on|off</em></dt><dt>jpeg:optimize-coding=<em class="arg">on|off</em></dt><dt>jpeg:q-table=<em class="arg">table</em></dt><dt>jpeg:sampling-factor=<em class="arg">sampling-factor-string</em></dt><dt>jpeg:size=<em class="arg">geometry</em></dt> <dd>Set the size hint of a JPEG image, for example, <code>-define jpeg:size=128x128</code>. It is most useful for increasing performance and reducing the memory requirements when reducing the size of a large JPEG image.</dd><dt>json:features</dt> <dd>includes features in verbose information</dd><dt>json:limit</dt><dt>json:locate</dt><dt>json:moments</dt> <dd>includes image moments in verbose information</dd><dt>mng:need-cacheoff</dt> <dd>turn playback caching off for streaming MNG.</dd><dt>morphology:compose=<em class="arg">compose-method</em></dt> <dd>Specifies how to merge results generated by multiple<a href="command-line-options.html#morphology" >-morphology</a> kernel. The default is none. One typical value is 'lighten' as used, for example, with the sobel edge kernels. </dd><dt>morphology:showkernel=<em class="arg">1</em></dt> <dd>Outputs (to 'standard error') all the information about a generated <a href="command-line-options.html#morphology" >-morphology</a> kernel.</dd><dt>pcl:fit-to-page=<em class="arg">true</em></dt><dt>pdf:fit-page=<em class="arg">geometry</em></dt> <dd> geometry specifies the scaling dimensions for resizing when the PDF is being read. The geometry is either WxH{%} or page size. No offsets are allowed. (introduced in IM 6.8.8-8)</dd><dt>pdf:fit-to-page=<em class="arg">true</em></dt><dt>pdf:use-cropbox=<em class="arg">true</em></dt><dt>pdf:use-trimbox=<em class="arg">true</em></dt><dt>png:bit-depth=<em class="arg">value</em></dt><dt>png:color-type=<em class="arg">value</em></dt> <dd>desired bit-depth and color-type for PNG output. You can force the PNG encoder to use a different bit-depth and color-type than it would have normally selected, but only if this does not cause any loss of image quality. Any attempt to reduce image quality is treated as an error and no PNG file is written. E.g., if you have a 1-bit black-and-white image, you can use these "defines" to cause it to be written as an 8-bit grayscale, indexed, or even a 64-bit RGBA. But if you have a 16-million color image, you cannot force it to be written as a grayscale or indexed PNG. If you wish to do this, you must use the appropriate <a href="command-line-options.html#depth">-depth</a>, <a href="command-line-options.html#colors">-colors</a>, or <a href="command-line-options.html#type">-type</a> directives to reduce the image quality prior to using the PNG encoder. Note that in indexed PNG files, "bit-depth" refers to the number of bits per index, which can be 1, 2, 4, or 8. In such files, the color samples always have 8-bit depth.</dd><dt>png:compression-filter=<em class="arg">value</em></dt> <dd> valid values are 0 through 9. 0-4 are the corresponding PNG filters, 5 means adaptive filtering except for images with a colormap, 6 means adaptive filtering for all images, 7 means MNG "loco" compression, 8 means Z_RLE strategy with adaptive filtering, and 9 means Z_RLE strategy with no filtering.</dd><dt>png:compression-level=<em class="arg">value</em></dt> <dd> valid values are 0 through 9, with 0 providing the least but fastest compression and 9 usually providing the best and always the slowest.</dd><dt>png:compression-strategy=<em class="arg">value</em></dt> <dd> valid values are 0 through 4, meaning default, filtered, huffman_only, rle, and fixed ZLIB compression strategy. If you are using an old zlib that does not support Z_RLE (before 1.2.0) or Z_FIXED (before 1.2.2.2), values 3 and 4, respectively, will use the zlib default strategy instead.</dd><dt>png:format=<em class="arg">value</em></dt> <dd> valid values are <em class="arg">png8</em>, <em class="arg">png24</em>, <em class="arg">png32</em>, <em class="arg">png48</em>, <em class="arg">png64</em>, and <em class="arg">png00</em>. This property can be useful for specifying the specific PNG format to be used, when the usual method of prepending the format name to the output filename is inconvenient, such as when writing a PNG-encoded ICO file or when using <a href="mogrify.html">mogrify</a>. Value = <em class="arg">png8</em> reduces the number of colors to 256, only one of which may be fully transparent, if necessary. The other values do not force any reduction of quality; it is an error to request a format that cannot represent the image data without loss (except that it is allowed to reduce the bit-depth from 16 to 8 for all formats). Value = <em class="arg">png24</em> and <em class="arg">png48</em> allow transparency, only if a single color is fully transparent and that color does not also appear in an opaque pixel; such transparency is written in a PNG <code>tRNS</code> chunk. Value = <em class="arg">png00</em> causes the image to inherit its color-type and bit-depth from the input image, if the input was also a PNG.</dd><dt>png:exclude-chunk=<em class="arg">value</em></dt><dt>png:include-chunk=<em class="arg">value</em></dt> <dd>ancillary chunks to be excluded from or included in PNG output. <p>The <em class="arg">value</em> can be the name of a PNG chunk-type such as <em class="arg">bKGD</em>, a comma-separated list of chunk-names (which can include the word <em class="arg">date</em>, the word <em class="arg">all</em>, or the word <em class="arg">none</em>). Although PNG chunk-names are case-dependent, you can use all lowercase names if you prefer.</p> <p>The "include-chunk" and "exclude-chunk" lists only affect the behavior of the PNG encoder and have no effect on the PNG decoder.</p> <p>As a special case, if the <code>sRGB</code> chunk is excluded and the <code>gAMA</code> chunk is included, the <code>gAMA</code> chunk will only be written if gamma is not 1/2.2, since most decoders assume sRGB and gamma=1/2.2 when no colorspace information is included in the PNG file. Because the list is processed from left to right, you can achieve this with a single define:</p><pre class="text"> -define png:include-chunk=none,gAMA</pre> <p>As a special case, if the <code>sRGB</code> chunk is not excluded and the PNG encoder recognizes that the image contains the sRGB ICC profile, the PNG encoder will write the <code>sRGB</code> chunk instead of the entire ICC profile. To force the PNG encoder to write the sRGB profile as an <code>iCCP</code> chunk in the output PNG instead of the <code>sRGB</code> chunk, exclude the <code>sRGB</code> chunk.</p> <p>The critical PNG chunks <code>IHDR</code>, <code>PLTE</code>, <code>IDAT</code>, and <code>IEND</code> cannot be excluded. Any such entries appearing in the list will be ignored.</p> <p>If the ancillary PNG <code>tRNS</code> chunk is excluded and the image has transparency, the PNG colortype is forced to be 4 or 6 (GRAY_ALPHA or RGBA). If the image is not transparent, then the <code>tRNS</code> chunk isn't written anyhow, and there is no effect on the PNG colortype of the output image.</p> <p>The <a href="command-line-options.html#strip">-strip</a> option does the equivalent of the following for PNG output:</p><pre class="text"> -define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date</pre> <p>The default behavior is to include all known PNG ancillary chunks plus ImageMagick's private <code>vpAg</code> ("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> <p>Any chunk names that are not known to ImageMagick are ignored if they appear in either the "include-chunk" or "exclude-chunk" list. The ancillary chunks currently known to ImageMagick are <code>bKGD</code>, <code>cHRM</code>, <code>gAMA</code>, <code>iCCP</code>, <code>oFFs</code>, <code>pHYs</code>, <code>sRGB</code>, <code>tEXt</code>, <code>tRNS</code>, <code>vpAg</code>, and <code>zTXt</code>.</p> <p>You can also put <code>date</code> in the list to include or exclude the "Date:create" and "Date:modify" text chunks that ImageMagick normally inserts in the output PNG.</p></dd><dt>png:preserve-colormap[=<em class="arg">true</em>]</dt> <dd>Use the existing image->colormap. Normally the PNG encoder will try to optimize the palette, eliminating unused entries and putting the transparent colors first. If this flag is set, that behavior is suppressed.</dd><dt>png:preserve-iCCP[=<em class="arg">true</em>]</dt> <dd>By default, the PNG decoder and encoder examine any ICC profile that is present, either from an <code>iCCP</code> chunk in the PNG input or supplied via an option, and if the profile is recognized to be the sRGB profile, converts it to the <code>sRGB</code> chunk. You can use <code>-define png:preserve-iCCP</code> to prevent this from happening; in such cases the <code>iCCP</code> chunk will be read or written and no <code>sRGB</code> chunk will be written. There are some ICC profiles that claim to be sRGB but have various errors that cause them to be rejected by libpng16; such profiles are recognized anyhow and converted to the <code>sRGB</code> chunk, but are rejected if the <code>-define png:preserve-iCCP</code> is present. Note that not all "sRGB" ICC profiles are recognized yet; we will add them to the list as we encounter them.</dd><dt>png:swap-bytes[=<em class="arg">true</em>]</dt> <dd>The PNG specification requires that any multi-byte integers be stored in network byte order (MSB-LSB endian). This option allows you to fix any invalid PNG files that have 16-bit samples stored incorrectly in little-endian order (LSB-MSB). The "-define png:swap-bytes" option must appear before the input filename on the commandline. The swapping is done during the libpng decoding operation.</dd><dt>profile:skip=<em class="arg">name1,name2,...</em></dt> <dd>Skip the named profile[s] when reading the image. Use skip="*" to skip all named profiles in the image. Many named profiles exist, including ICC, EXIF, APP1, IPTC, XMP, and others.</dd><dt>ps:imagemask</dt> <dd>If the ps:imagemask flag is defined, the PS3 and EPS3 coders will create Postscript files that render bilevel images with the Postscript imagemask operator instead of the image operator.</dd><dt>quantum:format=<em class="arg">type</em></dt> <dd>Set the type to <code>floating-point</code> to specify a floating-point format for raw files (e.g. GRAY:) or for MIFF and TIFF images in HDRI mode to preserve negative values. If <a href="command-line-options.html#depth">-depth</a> 16 is included, the result is a single precision floating point format. If <a href="command-line-options.html#depth">-depth</a> 32 is included, the result is double precision floating point format.</dd><dt>quantum:polarity=<em class="arg">photometric-interpretation</em></dt> <dd>Set the photometric-interpretation of an image (typically for TIFF image file format) to either <code>min-is-black</code> (default) or <code>min-is-white</code>.</dd><dt>sample:offset=<em class="arg">geometry</em></dt> <dd>Location of the sampling point within the sub-region being sampled, expressed as percentages (see <a href="command-line-options.html#sample" >-sample</a>).</dd><dt>showkernel=<em class="arg">1</em></dt> <dd>Outputs (to 'standard error') all the information about a generated <a href="command-line-options.html#morphology" >-morphology</a> kernel.</dd><dt>tiff:alpha=<em class="arg">associated|unassociated|unspecified</em></dt> <dd>Specify the alpha extra samples as associated, unassociated or unspecified </dd><dt>tiff:endian=<em class="arg">msb|lsb</em></dt><dt>tiff:exif-properties=<em class="arg">false</em></dt> <dd>Skips reading the EXIF properties.</dd><dt>tiff:fill-order=<em class="arg">msb|lsb</em></dt><dt>tiff:ignore-tags=<em class="arg">comma-separate-list-of-tag-IDs</em></dt> <dd>Allows one or more tag ID values to be ignored.</dd><dt>tiff:rows-per-strip=<em class="arg">value</em></dt> <dd>Sets the number of rows per strip</dd><dt>tiff:tile-geometry=<em class="arg">WxH</em></dt> <dd>Sets the tile size for pyramid tiffs. Requires the suffix PTIF: before the outputname</dd></dl><p>For example, to create a postscript file that will render only the blackpixels of a bilevel image, use:</p><p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert bilevel.tif -define ps:imagemask eps3:stencil.ps</span></p><p>Set attributes of the image registry by prefixing the value with<code>registry:</code>. For example, to set a temporary path to put work files,use:</p><p class="crtsnip">-define registry:temporary-path=/data/tmp</p><div style="margin: auto;"> <h4><a id="delay"></a>-delay <em class="arg">ticks</em> <br />-delay <em class="arg">ticks</em>x<em class="arg">ticks-per-second</em> {<em class="arg"><</em>} {<em class="arg">></em>}</h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>display the next image after pausing.</td><td style='text-align:right;'></td></tr></table>
<p>This option is useful for regulating the animation of image sequences<em>ticks/ticks-per-second</em> seconds must expire before the display of thenext image. The default is no delay between each showing of the imagesequence. The default ticks-per-second is 100.</p><p>Use <code>></code> to change the image delay <em>only</em> if its currentvalue exceeds the given delay. <code><</code> changes the image delay<em>only</em> if current value is less than the given delay. For example, ifyou specify <code>30></code> and the image delay is 20, the image delay doesnot change. However, if the image delay is 40 or 50, the delay it is changedto 30. Enclose the given delay in quotation marks to prevent the<code><</code> or <code>></code> from being interpreted by your shell asa file redirection.</p><div style="margin: auto;"> <h4><a id="delete"></a>-delete <em class="arg">indexes</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>delete the images specified by index, from the image sequence.</td><td style='text-align:right;'></td></tr></table>
<p>Specify the count and the image to duplicate by its index in the sequence.The first image is index 0. Negative indexes are relative to the end of thesequence, for example, -1 represents the last image of the sequence. Specifya range of images with a dash (e.g. 0-4). Separate indexes with a comma (e.g.0,2). Use <code>+duplicate</code> to duplicate the last image in the currentimage sequence.</p><div style="margin: auto;"> <h4><a id="edge"></a>-edge <em class="arg">radius</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>detect edges within an image.</td><td style='text-align:right;'></td></tr></table>
<div style="margin: auto;"> <h4><a id="emboss"></a>-emboss <em class="arg">radius</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>emboss an image.</td><td style='text-align:right;'></td></tr></table>
<div style="margin: auto;"> <h4><a id="encipher"></a>-encipher <em class="arg">filename</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Encipher pixels for later deciphering by <a href="command-line-options.html#decipher">-decipher</a>.</td><td style='text-align:right;'></td></tr></table>
-<p>Get the passphrase from the file specified by <em class="arg">filename</em>.</p><p>For more information, see the webpage, <ahref="
http://www.imagemagick.org/www/cipher.html">ImageMagick: Encipher orDecipher an Image</a>.</p><div style="margin: auto;"> <h4><a id="encoding"></a>-encoding <em class="arg">type</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify the text encoding.</td><td style='text-align:right;'></td></tr></table>
+<p>Get the passphrase from the file specified by <em class="arg">filename</em>.</p><p>For more information, see the webpage, <ahref="
../cipher.html">ImageMagick: Encipher orDecipher an Image</a>.</p><div style="margin: auto;"> <h4><a id="encoding"></a>-encoding <em class="arg">type</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>specify the text encoding.</td><td style='text-align:right;'></td></tr></table>
<p>Choose from <code>AdobeCustom</code>, <code>AdobeExpert</code>,<code>AdobeStandard</code>, <code>AppleRoman</code>, <code>BIG5</code>,<code>GB2312</code>, <code>Latin 2</code>, <code>None</code>, <code>SJIScode</code>,<code>Symbol</code>, <code>Unicode</code>, <code>Wansung</code>.</p><div style="margin: auto;"> <h4><a id="endian"></a>-endian <em class="arg">type</em></h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Specify endianness (<code>MSB</code> or <code>LSB</code>) of the image.</td><td style='text-align:right;'></td></tr></table>
<p>To print a complete list of endian types, use the <a href="command-line-options.html#list">-list endian</a> option.</p><p>Use <a href="command-line-options.html#endian">+endian</a> to revert to unspecified endianness.</p><div style="margin: auto;"> <h4><a id="enhance"></a>-enhance</h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>Apply a digital filter to enhance a noisy image.</td><td style='text-align:right;'></td></tr></table>
<div style="margin: auto;"> <h4><a id="equalize"></a>-equalize</h4></div><table style='background-color:#FFFFE0; margin-left:40px; margin-right:40px; width:88%'><tr><td style='width:75%'>perform histogram equalization on the image channel-by-channel.</td><td style='text-align:right;'></td></tr></table>
</div>
<div class="sep"></div>
<div class="menu">
- <a title="Search" href="http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/script/search.php">Search</a>
+ <a title="Search" href="http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/http://www.imagemagick.org/script/search.php">Search</a>
</div>
<div class="sep"></div>
<div class="menu">
<div class="doc-section">
<p>The design of ImageMagick is an evolutionary process, with the design and implementation efforts serving to influence and guide further progress in the other. With ImageMagick version 7 we aim to improve the design based on lessons learned from the version 6 implementation. ImageMagick was originally designed to display RGB images to an X Windows server. Over time we extended support to RGBA images and then to the CMYK and CMYKA image format. With ImageMagick version 7, we extend support to arbitrary colorspaces with an arbitrary number of pixel channels. Other design changes are in the works and we will document them here so be sure to revisit periodically.</p>
-<p>To support variable pixel channels in the MagickCore API, pixel handling has changed when getting or setting the pixel channels. You can access channels as an array, <em>pixel[i]</em>, or use an accessor such as GetPixelRed() or SetPixelRed(). There are some modest changes to the MagickWand API. Magick++ and PerlMagick should behave exactly as it does for ImageMagick version 6.</p>
+<p>To support variable pixel channels in the MagickCore API, pixel handling has changed when getting or setting the pixel channels. You can access channels as an array, <em>pixel[i]</em>, or use an accessor such as GetPixelRed() or SetPixelRed(). There are some modest changes to the MagickCore and MagickWand API. Magick++ and PerlMagick should behave exactly as it does for ImageMagick version 6.</p>
<p>The shell API (command line) of ImageMagick version 7 is also undergoing
a major overhaul, with specific emphasis on the ability to read 'options' not
<p>Note, how we use GetPixelChannels() to advance to the next set of pixel channels.</p>
-<p>The colormap indexes and black pixel channel (for the CMYK colorspace) are no longer stored in the index channel, previously accessed with GetAuthenticIndexQueue() and GetCacheViewAuthenticIndexQueue(). Instead they are now a pixel channel and accessed with the convenience pixel accessor methods GetPixelIndex(), SetPixelIndex(), GetPixelBlack(), and SetPixelBlack().</p>
+<p>The colormap indexes and black pixel channel (for the CMYK colorspace) are no longer stored in the index channel, previously accessed with GetAuthenticIndexQueue() and GetCacheViewAuthenticIndexQueue(). Instead they are now a first class pixel channel and accessed as a member of the pixel array (e.g. <code>pixel[4]</code>) or with the convenience pixel accessor methods GetPixelIndex(), SetPixelIndex(), GetPixelBlack(), and SetPixelBlack().</p>
<p>As a consequence of using an array structure for variable pixel channels, auto-vectorization compilers have additional opportunities to speed up pixel loops.</p>
<h4>Pixel Accessors</h4>
-<p>Use accessors to get or set pixel channels:</p>
+<p>You can access pixel channel as array elements (e.g. <code>pixel[1]</code>) or use convenience accessors to get or set pixel channels:</p>
<pre class="text">
GetPixela() SetPixela()
<h2><a id="core"></a>MagickCore API</h2>
<div class="doc-section">
<p>Almost all image processing algorithms are now channel aware.</p>
-<p>MagickCore, version 7, adds an ExceptionInfo argument to those methods that lacked it in version 6, e.g. NegateImage(image,MagickTrue,exception);</p>
+<p>MagickCore, version 7, adds an ExceptionInfo argument to those methods that lacked it in version 6, e.g. <code>NegateImage(image,MagickTrue,exception</code>);</p>
<p>All method channel analogs have been removed (e.g. BlurImageChannel()), they are no longer necessary, use pixel traits instead.</p>
<p>Public and private API calls are now declared with the GCC visibility attribute. The MagickCore and MagickWand dynamic libraries now only export public struct and function declarations.</p>
<p>The InterpolatePixelMethod enum is now PixelInterpolateMethod.</p>
</pre>
<p>The FilterImage() method has been removed. Use ConvolveImage() instead.</p>
-<p>The <code>%[min]</code> and <code>%[max]</code> string escapes are no longer supported. Use <code>%[minima]</code> and <code>%[maxima]</code> instead.</p>
-
<p>In addition, all deprecated <a href="http://magick.imagemagick.org/api/deprecate.html">MagickCore</a> and <a href="http://magick.imagemagick.org/api/magick-deprecate.html">MagickWand</a> methods are no longer available in version 7.</p>
</div>
that image is to then accept color the <code>-colorspace</code> setting needs to
be applied to expand the one channel into separate RGB (or other) channels.
</p>
-<p>Previously, command-line arguments were limited to 4096 characters, with ImageMagick version 7, the limit has increased to 8192 characters.</p>
+<p>Previously, command-line arguments were limited to 4096 characters, with ImageMagick version 7 the limit has increased to 32768 characters.</p>
<h3>Command Changes</h3>
<dl>
projects / imagemagick / commitdiff