granicus.if.org Git - imagemagick/blob - index.html

   1
   2
   3
   4
   5 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   6   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   7 <html version="-//W3C//DTD XHTML 1.1//EN"
   8       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
   9       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  10       xsi:schemaLocation="http://www.w3.org/1999/xhtml
  11                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
  12 <head>
  13   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
  14   <meta name=viewport content="width=device-width, initial-scale=0.3333334">
  15   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"/>
  16   <title>ImageMagick: Convert, Edit, Or Compose Bitmap Images</title>
  17   <meta http-equiv="content-language" content="en-US"/>
  18   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
  19   <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
  20   <meta name="application-name" content="ImageMagick"/>
  21   <meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition, resize, rotate, shear, distort or transform images automagically."/>
  22   <meta name="application-url" content="http://www.imagemagick.org"/>
  23   <meta name="generator" content="PHP"/>
  24   <meta name="keywords" content="convert, edit, or, compose, bitmap, images, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, Magick++, MagickWand"/>
  25   <meta name="rating" content="GENERAL"/>
  26   <meta name="robots" content="INDEX, FOLLOW"/>
  27   <meta name="generator" content="ImageMagick Studio LLC"/>
  28   <meta name="author" content="ImageMagick Studio LLC"/>
  29   <meta name="revisit-after" content="2 DAYS"/>
  30   <meta name="resource-type" content="document"/>
  31   <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
  32   <meta name="distribution" content="Global"/>
  33   <link rel="icon" href="http://www.imagemagick.org/images/wand.png"/>
  34   <link rel="shortcut icon" href="http://www.imagemagick.org/images/wand.ico" type="images/x-icon"/>
  35   <link rel="canonical" href="http://www.imagemagick.org" />
  36   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
  37
  38   <!-- Add jQuery library -->
  39   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/2.1.0/jquery.min.js"></script>
  40
  41   <!-- Add mousewheel plugin (this is optional) -->
  42   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
  43
  44   <!-- Add fancyBox -->
  45   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.1.5" type="text/css" media="screen" />
  46   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
  47
  48   <!-- Optionally add helpers - button, thumbnail and/or media -->
  49   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.5" type="text/css" media="screen" />
  50   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.5"></script>
  51   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.6"></script>
  52
  53   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=1.0.7" type="text/css" media="screen" />
  54   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=1.0.7"></script>
  55
  56   <script type="text/javascript">
  57         $(document).ready(function() {
  58                 $(".fancybox").fancybox();
  59         });
  60   </script>
  61
  62   <!-- ImageMagick style -->
  63   <style type="text/css" media="all">
  64     @import url("http://www.imagemagick.org/www/magick.css");
  65   </style>
  66 </head>
  67
  68 <body id="www-imagemagick-org">
  69
  70 <script type="text/javascript">
  71   (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  72   (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  73   m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  74   })(window,document,'offline-script','//www.google-analytics.com/analytics.js','ga');
  75
  76   ga('create', 'UA-40133312-1', 'imagemagick.org');
  77   ga('send', 'pageview');
  78 </script>
  79
  80 <div class="titlebar">
  81 <div style="margin: 17px auto; float: left;">
  82   <script type="text/javascript">
  83   <!--
  84     google_ad_client = "pub-3129977114552745";
  85     google_ad_slot = "5439289906";
  86     google_ad_width = 728;
  87     google_ad_height = 90;
  88   //-->
  89   </script>
  90   <script type="text/javascript"
  91     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
  92   </script>
  93 </div>
  94 <a href="discourse-server">
  95   <img src="http://www.imagemagick.org/images/logo.jpg"
  96   alt="ImageMagick Logo" width="123" height="118"
  97   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
  98 <a href="http://www.imagemagick.org/index.html">
  99   <img src="http://www.imagemagick.org/images/sprite.jpg"
 100   alt="ImageMagick Sprite" width="114" height="118"
 101   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
 102 </div>
 103
 104 <div class="westbar">
 105
 106 <div class="menu">
 107   <a title="About ImageMagick" href="http://www.imagemagick.org/index.html">About ImageMagick</a>
 108 </div>
 109 <div class="menu">
 110   <a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
 111 </div>
 112 <div class="sub">
 113     <a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
 114 </div>
 115 <div class="sub">
 116     <a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
 117 </div>
 118 <div class="sub">
 119     <a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
 120 </div>
 121 <div class="sub">
 122     <a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
 123 </div>
 124 <div class="sep"></div>
 125 <div class="menu">
 126   <a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
 127 </div>
 128 <div class="sub">
 129     <a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
 130 </div>
 131 <div class="sub">
 132     <a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
 133 </div>
 134 <div class="sub">
 135     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 136 </div>
 137 <div class="menu">
 138   <a title="Program Interfaces" href="api.html">Program Interfaces</a>
 139 </div>
 140 <div class="sub">
 141     <a title="Program Interface: MagickWand" href="http://www.imagemagick.org/www/magick-wand.html">MagickWand</a>
 142 </div>
 143 <div class="sub">
 144     <a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
 145 </div>
 146 <div class="sub">
 147     <a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
 148 </div>
 149 <div class="sub">
 150     <a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
 151 </div>
 152 <div class="sep"></div>
 153 <div  class="menu">
 154    <a title="Install from Source" href="install-source.html">Install from Source</a>
 155 </div>
 156 <div class="sub">
 157     <a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
 158 </div>
 159 <div class="sub">
 160     <a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
 161  </div>
 162 <div class="menu">
 163   <a title="Resources" href="resources.html">Resources</a>
 164 </div>
 165 <div class="menu">
 166   <a title="Architecture" href="architecture.html">Architecture</a>
 167 </div>
 168 <div class="menu">
 169   <a title="Download" href="download.html">Download</a>
 170 </div>
 171 <div class="sep"></div>
 172 <div class="menu">
 173   <a title="Search" href="search.html">Search</a>
 174 </div>
 175 <div class="sep"></div>
 176 <div class="menu">
 177   <a title="Site Map" href="sitemap.html">Site Map</a>
 178 </div>
 179 <div  class="sub">
 180   <a title="Site Map: Links" href="links.html">Links</a>
 181 </div>
 182 <div class="sep"></div>
 183 <div class="menu">
 184   <a title="Support ImageMagick Development" href="support.html">Support ImageMagick Development</a>
 185 </div>
 186 </div>
 187
 188 <div class="eastbar">
 189   <script type="text/javascript">
 190     /* <![CDATA[ */
 191     window.___gcfg = {
 192       lang: 'en-US'
 193     };
 194
 195     (function() {
 196       var po = document.createElement('offline-script');
 197       po.type = 'text/javascript';
 198       po.async = true;
 199       po.src = 'https://apis.google.com/js/plusone.js';
 200       var script = document.getElementsByTagName('offline-script')[0];
 201       script.parentNode.insertBefore(po, script);
 202     })();
 203     var gplusone = document.getElementById("gplusone");
 204     gplusone.setAttribute("data-size","medium");
 205     gplusone.setAttribute("data-count","true");
 206     /* ]]> */
 207   </script>
 208   <script type="text/javascript">
 209     /* <![CDATA[ */
 210     (function() {
 211         var po = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
 212         po.type = 'text/javascript';
 213         po.async = true;
 214         po.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
 215         var script = document.getElementsByTagName('offline-script')[0];
 216         script.parentNode.insertBefore(po, script);
 217     })();
 218     /* ]]> */
 219   </script>
 220   <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://www.imagemagick.org/"></a></div>
 221   <noscript>
 222     <a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
 223     <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0" /></a>
 224   </noscript>
 225   <div class="g-plusone" data-size="standard" data-count="true"></div>
 226 </div>
 227
 228 <div class="main">
 229
 230 <h1>Convert, Edit, and Compose Images</h1>
 231 <p class="navigation-index">[<a href="index.html#features">Features and Capabilities</a> • <a href="index.html#news">ImageMagick News</a> • <a href="index.html#books">Books About ImageMagick</a> • <a href="index.html#community">User Community</a>]</p>
 232
 233 <a id="intro"></a>
 234 <div class="doc-section">
 235 <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&amp;entry=78333969">&#174;</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 100) 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>
 236
 237 <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>
 238
 239 <p>ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you may use, copy, modify, and distribute in both open and proprietary applications. It is distributed under the Apache 2.0 <a href="license.html" rel="license">license</a>,  approved by the <a href="http://www.opensource.org/">OSI</a> and recommended for use by the <a href="http://www.osscc.net/">OSSCC</a>.</p>
 240
 241 <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>
 242
 243 <p>The current release is ImageMagick 6.8.8-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>
 244
 245 <p>The official ImageMagick web site is <a href="http://www.imagemagick.org/">http://www.imagemagick.org</a>.</p>
 246 </div>
 247
 248 <div class="siz-mod-head">
 249   <span class="siz-mod-title"></span>
 250 </div>
 251
 252 <h2><a id="features"></a>Features and Capabilities</h2>
 253 <div class="doc-section">
 254 <p>Here are just a few <a href="examples.html">examples</a> of what ImageMagick can do:</p>
 255
 256 <ul style="font-size: 90%;">
 257   <li><a href="convert.html">Format conversion</a>: convert an image from one <a href="formats.html">format </a> to another (e.g. PNG to JPEG).</li>
 258   <li><a href="http://www.imagemagick.org/Usage/resize/">Transform</a>: resize, rotate, crop, flip or trim an image.</li>
 259   <li><a href="http://www.imagemagick.org/Usage/masking/">Transparency</a>: render portions of an image invisible.</li>
 260   <li><a href="http://www.imagemagick.org/Usage/draw/">Draw</a>: add shapes or text to an image.</li>
 261   <li><a href="http://www.imagemagick.org/Usage/crop/">Decorate</a>: add a border or frame to an image.</li>
 262   <li><a href="http://www.imagemagick.org/Usage/blur/">Special effects</a>: blur, sharpen, threshold, or tint an image.</li>
 263   <li><a href="http://www.imagemagick.org/Usage/anim_basics/">Animation</a>: create a GIF animation sequence from a group of images.</li>
 264   <li><a href="http://www.imagemagick.org/Usage/text/">Text &amp; comments</a>: insert descriptive or artistic text in an image.</li>
 265   <li><a href="identify.html">Image identification</a>: describe the format and attributes of an image.</li>
 266   <li><a href="http://www.imagemagick.org/www/composite.html">Composite</a>: overlap one image over another.</li>
 267   <li><a href="http://www.imagemagick.org/www/montage.html">Montage</a>: juxtapose image thumbnails on an image canvas.</li>
 268   <li><a href="http://www.imagemagick.org/Usage/distorts/">Generalized pixel distortion</a>: correct for, or induce image distortions including perspective.</li>
 269   <li><a href="http://www.imagemagick.org/Usage/morphology/">Morphology of shapes</a>: extract features, describe shapes and recognize patterns in images.</li>
 270   <li><a href="motion-picture.html">Motion picture support</a>: read and write the common image formats used in digital film work.</li>
 271   <li><a href="http://www.imagemagick.org/www/fx.html">Image calculator</a>: apply a mathematical expression to an image or image channels.</li>
 272   <li><a href="http://www.imagemagick.org/Usage/fourier/">Discrete Fourier transform</a>: implements the forward and inverse <a href="http://en.wikipedia.org/wiki/Discrete_Fourier_transform">DFT</a>.</li>
 273   <li><a href="http://www.fmwconcepts.com/misc_tests/perceptual_hash_test_results_510/index.html">Perceptual hash</a>: map visually identical images to the same or similar hash-- useful in image retrieval, authentication, indexing, or copy detection as well as digital watermarking.</li>
 274   <li><a href="color-management.html">Color management</a>: accurate color management with color profiles or in lieu of-- built-in gamma compression or expansion as demanded by the colorspace.</li>
 275   <li><a href="high-dynamic-range.html">High dynamic-range images</a>: accurately represent the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows.</li>
 276   <li><a href="http://www.imagemagick.org/www/cipher.html">Encipher or decipher an image</a>: convert ordinary images into unintelligible gibberish and back again.</li>
 277   <li><a href="architecture.html#virtual-pixels">Virtual pixel support</a>: convenient access to pixels outside the image region.</li>
 278   <li><a href="architecture.html#tera-pixel">Large image support</a>: read, process, or write mega-, giga-, or tera-pixel image sizes.</li>
 279   <li><a href="architecture.html#threads">Threads of execution support</a>: ImageMagick is thread safe and most internal algorithms execute in <a href="openmp.html">parallel</a> to take advantage of speed-ups offered by multicore processor chips.</li>
 280   <li><a href="distribute-pixel-cache.html">Distributed pixel cache</a>: offload intermediate pixel storage to one or more remote servers.</li>
 281   <li><a href="architecture.html#distributed">Heterogeneous distributed processing</a>: certain algorithms are <a href="http://www.khronos.org/opencl/">OpenCL</a>-enabled to take advantage of speed-ups offered by executing in concert across heterogeneous platforms consisting of CPUs, GPUs, and other processors.</li>
 282   <li><a href="binary-releases.html#iOS">ImageMagick on the iPhone</a>: convert, edit, or compose images on your <a href="http://www.apple.com/ios/">iOS</a> device such as the iPhone or iPad.</li>
 283 </ul>
 284
 285 <p><a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a> shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see <a href="http://www.fmwconcepts.com/imagemagick/">Fred's ImageMagick Scripts</a>:  a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations.</p>
 286 </div>
 287
 288 <h2><a id="news"></a>ImageMagick News</h2>
 289 <div class="doc-section">
 290
 291 <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 <a href="ImageMagick-7.0.0">ImageMagick version 7</a>, we aim to improve the design based on lessons learned from the version 6 implementation.  See the <a href="porting.html">porting</a> guide to track the progress of the version 7 development effort.</p>
 292 </div>
 293
 294 <h2><a id="books"></a>Books About ImageMagick</h2>
 295 <div class="doc-section">
 296 <p><a href="http://www.amazon.com/exec/obidos/redirect?link_code=ur2&amp;camp=1789&amp;tag=imagemagick-20&amp;creative=9325&amp;path=tg/detail/-/1590595904/qid=1123551819/sr=8-1/ref=pd_bbs_sbs_1?v=glance%26s=books%26n=507846"><img alt="Definitive Guide to ImageMagick" class="icon" width="100" height="136" src="definitive-guide.png"/></a> An open source project backed by years of continual development, ImageMagick supports about 100 image formats and can perform impressive operations such as creating images from scratch; changing colors; stretching, rotating, and overlaying images; and overlaying text on images. Whether you use ImageMagick to manage the family photos or to embark on a job involving millions of images, this book provides you with the knowledge to manage your images with ease.<br /><br />The <em>Definitive Guide to ImageMagick</em> explains all of these capabilities and more in a practical, learn-by-example fashion. You'll get comfortable using ImageMagick for any image-processing task. Through the book's coverage of the ImageMagick interfaces for C, Perl, PHP, and Ruby, you'll learn how to incorporate ImageMagick features into a variety of applications.</p><br />
 297
 298 <p><a href="http://www.amazon.com/exec/obidos/redirect?link_code=ur2&amp;camp=1789&amp;tag=imagemagick-20&amp;creative=9325&amp;path=tg/detail/-/1904811868/qid=1123551819/sr=8-1/ref=pd_bbs_sbs_1?v=glance%26s=books%26n=507846"><img alt="ImageMagick Tricks" class="icon" width="100" height="123" src="tricks.png"/></a> <em>ImageMagick Tricks</em> by Sohail Salehi: This fast-paced and practical tutorial is packed with examples of photo manipulations, logo creation, animations, and complete web projects. With this book up your sleeve, you'll be creating spellbinding images from code in no time. The publisher, <a href="http://www.packtpub.com/">Packt</a>, is donating a percentage of every book sold to the ImageMagick project.</p><br />
 299 </div>
 300
 301 <h2><a id="community"></a>User Community</h2>
 302 <div class="doc-section">
 303 <p>To join the ImageMagick user community, try the <a href="discourse-server">discourse server</a>.  You can review questions or comments (with informed responses) posed by ImageMagick users or ask your own questions.</p>
 304 </div>
 305
 306 </div>
 307
 308 <div id="linkbar">
 309     <span id="linkbar-west"> </span>
 310
 311     <span id="linkbar-center">
 312       <a href="discourse-server">Discourse Server</a> •
 313       <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
 314       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
 315       <a href="http://jqmagick.imagemagick.org/">JqMagick</a>
 316     </span>
 317     <span id="linkbar-east"> </span>
 318 </div>
 319 <div class="footer">
 320   <span id="footer-west">©  1999-2014 ImageMagick Studio LLC</span>
 321   <span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
 322 </div>
 323 <div style="clear: both; margin: 0; width: 100%; "></div>
 324 </body>
 325 </html>
 326 <!-- Magick Cache 20th February 2014 07:05 -->