]> granicus.if.org Git - imagemagick/blobdiff - www/compose.html
(no commit message)
[imagemagick] / www / compose.html
index 8e59c48681f581d87cd91aed422f101dbac3d620..7b808315c0ec5daceec5f832defa93a40b2fb01f 100644 (file)
@@ -1,48 +1,77 @@
 \r
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">\r
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" \r
+  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
+<html version="-//W3C//DTD XHTML 1.1//EN"\r
+      xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"\r
+      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\r
+      xsi:schemaLocation="http://www.w3.org/1999/xhtml\r
+                          http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">\r
 <head>\r
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
-  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>\r
-  <title>ImageMagick: Alpha Compositing</title/>
+  <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>\r
+  <title>ImageMagick: Alpha Compositing</title>
   <meta http-equiv="Content-Language" content="en-US"/>
   <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="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
+  <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition resize, rotate, shear, distort and transform images automagically."/>
   <meta name="Application-url" content="http://www.imagemagick.org"/>
   <meta name="Generator" content="PHP"/>
-  <meta name="Keywords" content="alpha, compositing, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
+  <meta name="Keywords" content="alpha, compositing, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Image, Processing, Automagically"/>
   <meta name="Rating" content="GENERAL"/>
   <meta name="Robots" content="INDEX, FOLLOW"/>
   <meta name="Generator" content="ImageMagick Studio LLC"/>
   <meta name="Author" content="ImageMagick Studio LLC"/>
   <meta name="Revisit-after" content="2 DAYS"/>
   <meta name="Resource-type" content="document"/>
-  <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
+  <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
   <meta name="Distribution" content="Global"/>
-  <link rel="icon" href="../images/wand.png"  sizes="32x32"/>
+  <link rel="icon" href="../images/wand.png"/>
   <link rel="shortcut icon" href="../images/wand.ico"  type="images/x-icon"/>
+  <link rel="canonical" href="http://www.imagemagick.org" />\r
   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
+  <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />\r
+  <link rel="stylesheet" type="text/css" href="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.css" media="screen" />\r
   <style type="text/css" media="all">\r
     @import url("../www/magick.css");\r
   </style>\r
+  <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>\r
+  <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.1/jquery.min.js"></script>\r
+  <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.pack.js"></script>\r
+  <script type="text/javascript">\r
+    $(document).ready(function() {\r
+      $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({\r
+        'transitionIn'  : 'elastic',\r
+        'transitionOut' : 'elastic',\r
+        'overlayShow'   : false,\r
+        'opacity'       : true\r
+      });\r
+    });\r
+  </script>\r
 </head>\r
 \r
 <body id="www-imagemagick-org">\r
 <div class="titlebar">\r
-<a href="../index.html">\r
-  <img src="../images/script.png" alt="[ImageMagick]"\r
-  style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
-<a href="http://www.networkredux.com">\r
-  <img src="../images/networkredux.png" alt="[sponsor]"\r
-  style="margin: 45px auto; border: 0px; float: left;" /></a>\r
+<div style="margin: 17px auto; float: left;">\r
+  <script type="text/javascript">\r
+  <!--\r
+    google_ad_client = "pub-3129977114552745";\r
+    google_ad_slot = "5439289906";\r
+    google_ad_width = 728;\r
+    google_ad_height = 90;\r
+  //-->\r
+  </script>\r
+  <script type="text/javascript"\r
+    src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
+  </script>\r
+</div>\r
 <a href="http://www.imagemagick.org/discourse-server/">\r
-  <img src="../images/logo.jpg" alt=""\r
-  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
+  <img src="../images/logo.jpg"\r
+  alt="ImageMagick Logo"\r
+  style="width: 123px; height: 118px; border: 0px; float: right;" /></a>\r
 <a href="../index.html">\r
-  <img src="../images/sprite.jpg" alt=""\r
+  <img src="../images/sprite.jpg"\r
+  alt="ImageMagick Sprite"\r
   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
 </div>\r
 \r
@@ -51,7 +80,6 @@
 <div class="menu">
   <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
 </div>
-<div class="sep"></div>\r
 <div class="menu">
   <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
 </div>
@@ -61,6 +89,9 @@
 <div class="sub">
     <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>
+</div>
 <div class="sub">
     <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
 </div>
     <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
 </div>
 <div class="sub">
-    <a title="Program Interface: Magick++" href="../Magick++/">Magick++</a>
+    <a title="Program Interface: Magick++" href="../www/magick++.html">Magick++</a>
 </div>
 <div class="sep"></div>\r
 <div  class="menu">
 </div>
 <div class="sep"></div>\r
 <div class="menu">
-  <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
+  <a title="Search" href="../www/search.html">Search</a>
 </div>
 <div class="sep"></div>\r
 <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>\r
 <div  class="menu">
-  <a title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
+  <a rel="follow" title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
 
+<a href="http://www.networkredux.com">
+  <img src="../images/networkredux.png" width="140" height="31" alt="[sponsor]"
+  style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
 <div class="sponsbox">
 <div  class="sponsor">
-   <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
+  <a rel="follow" title="Sponsor: Autoteile" href="http://www.q11-shop.de">Autoteile</a><!-- 201205010540s suvalj -->
+</div>
+<div  class="sponsor">
+  <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
+</div>
+<div  class="sponsor">
+  <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201110010090s jen@seo lowprofilelinks -->
 </div>
 <div  class="sponsor">
-  <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
+  <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
 </div>
 <div  class="sponsor">
-  <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
+  <a rel="follow" title="Sponsor: Web Hosting Deals" href="http://www.webhostingdeals.org">Web Hosting Deals</a><!-- 201111010270 chee.hoa darin -->
 </div>
 <div  class="sponsor">
-  <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
+  <a rel="follow" title="Sponsor: Autos part" href="http://www.pkwteile.de/autoteile">Autos part</a><!-- 201112010090s jr@pkwte... -->
 </div>
 <div  class="sponsor">
-  <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
+  <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
 </div>
 <div  class="sponsor">
-  <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
+  <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
 </div>
 <div  class="sponsor">
-  <a title="Sponsor: Diamonds are a Girls Best Friend" href="http://www.schmuck.org">Diamonds are a Girls Best Friend</a><!-- 201101010600 Peterssen-->
+  <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 </div>
 <div  class="sponsor">
-   <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
+  <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
+</div>
+<div  class="sponsor">
+  <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
+</div>
+<div  class="sponsor">
+  <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
+</div>
+<div  class="sponsor">
+  <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
+</div>
+<div  class="sponsor">
+  <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
+</div>
+<div  class="sponsor">
+   <a rel="follow" title="Sponsor: Notebook Reparatur" href="http://www.notebook-reparaturen-berlin.de">Notebook Reparatur</a><!-- 2011120100300 atlas.multimedia-->
 </div>
 </div>
 </div>
 </div>\r
 \r
 <div class="eastbar">\r
-  <script type="text/javascript">\r
-  <!--\r
-    google_ad_client = "pub-3129977114552745";\r
-    google_ad_slot = "0574824969";\r
-    google_ad_width = 160;\r
-    google_ad_height = 600;\r
-  //-->\r
-  </script>\r
-  <script type="text/javascript"\r
-    src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
-  </script>\r
+  <div class="g-plusone" data-size="standard" data-count="false"></div>\r
 </div>\r
 \r
 <div class="main">\r
 \r
-
+<h1>ImageMagick Image Composition</h1>
 <p>This page descibed the Image composition methods that is used to define how
 two images should be merged together in various image operations.  For the
 Command Line API it is typically set using the <A
@@ -298,15 +343,17 @@ For example the default compose method can be specified as just 'Over'.</p>
 
 <p>Many of these compose methods will clear the destination image which was
 not overlaid by the source image.  This is to be expected as part of that
-specific composition methods defintion. Seeing the You can disable this by
-setting the special <A HREF="../www/command-line-options.html#set" >-set</A>
-'option:compose:outside-overlay' to 'false' will turn off this behaviour. </p>
+specific composition methods defintion. You can disable this by setting the
+special <A HREF="../www/command-line-options.html#define"
+>-define</A> 'compose:outside-overlay' to a value of 'false' will turn off
+this behaviour. </p>
 
 <p>On top of the above 12 Duff-Porter Alpha Composition methods, one special
-related method '<kbd>Copy</kbd>' has been provided. This is equivelent to the
-'<kbd>Src</kbd>'  with the special <A HREF="../www/command-line-options.html#set"
->-set</A> option '<kbd>option:compose:outside-overlay</kbd>' set to
-'<kbd>false></kbd>'. </p>
+related method '<kbd>Copy</kbd>' has been provided. This is equivalent to
+using the '<kbd>Src</kbd>'  with the special <A HREF="../www/command-line-options.html#define"
+>-define</A> option '<kbd>compose:outside-overlay</kbd>' set to
+'<kbd>false</kbd>', so as to only modify the overlaid area, without clearing
+the rest of the image outside the overlaid area.  </p>
 
 <br><br>
 
@@ -408,7 +455,7 @@ below. </p>
 <p>As of IM v6.6.1-6, if the special '<kbd>Sync</kbd>' flag is not specified
 (enabled by default) with the <a href="../www/command-line-options.html#channel"
 >-channel</a> setting, then the above mathematical compositions will nolonger
-syncronise its actiosn with the alpha channel.  Instead the math composition
+synchronise its actions with the alpha channel.  Instead the math composition
 will be applied on an individual channel basis as defined by the <a
 href="../www/command-line-options.html#channel"
 >-channel</a>.  This includes the alpha channel. This special usage
@@ -432,7 +479,7 @@ methods.</p>
 
   <tr valign="top">
     <td valign="top">linear-dodge</td>
-    <td valign="top">This is equivelent to 'Plus' in that the color channels
+    <td valign="top">This is equivalent to 'Plus' in that the color channels
         are simply added, however it does not 'Plus' the alpha channel, but
         uses the normal 'Over' alpha blending, which transparencies are
         involved.  Produces a sort of additive multiply-like result. Added
@@ -503,7 +550,7 @@ methods.</p>
 
   <tr valign="top">
     <td valign="top">pegtop-light</td>
-    <td valign="top">Almost equivelent to 'Soft-Light', but using a
+    <td valign="top">Almost equivalent to 'Soft-Light', but using a
         continuious mathematical formula rather than two conditionally
         selected formulae. Added ImageMagick version 6.5.4-3. </td>
   </tr>
@@ -539,8 +586,8 @@ methods.</p>
 
   <tr valign="top">
     <td valign="top">copy</td>
-    <td valign="top">This is equivelent to the Duff-Porter composition method
-        '<kbd>Src,<kbd>' but withotu clearing the parts of the destination
+    <td valign="top">This is equivalent to the Duff-Porter composition method
+        '<kbd>Src,</kbd>' but without clearing the parts of the destination
         image that is not overlaid.  </td>
     </tr>
 
@@ -552,7 +599,7 @@ methods.</p>
         does not exist in the source image, (which can only happen for methods,
         '<kbd>copy-opacity</kbd>' or '<kbd>copy-black</kbd>') then it is
         assumed that the source image is a special grayscale channel image
-        of the values to be copied. </td>
+        of the values that is to be copied. </td>
     </tr>
 
   <tr valign="top">
@@ -580,14 +627,13 @@ setting in the "<code>composite</code>" command.  For example... </p>
 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>composite ... -blend 50x50 ...</span></p>
 <p>As of IM v6.5.3-4 the "<code>convert</code>" command can now also supply
 these extra arguments to its <a href="../www/command-line-options.html#composite"
->-composite</a> operator, using the special <a
-href="../www/command-line-options.html#set">-set</a> attribute of '<kbd
-class="arg">option:compose:args</kbd>'.  This means you can now make use of
-these special argumented <a href="../www/command-line-options.html#compose"
+>-composite</a> operator, using the special <a href="../www/command-line-options.html#define">-define</a>
+attribute of '<kbd class="arg">compose:args</kbd>'.  This means you can now
+make use of these special argumented <a href="../www/command-line-options.html#compose"
 >-compose</a> methods, those the argument and the method both need to be set
-separatally.  For example... </p>
+separately.  For example... </p>
 
-<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert ... -compose blend  -set option:compose:args 50x50 -composite ...</span></p>
+<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert ... -compose blend  -define compose:args=50,50 -composite ...</span></p>
 <p>The following is a table of these special 'argumented' compose methods,
 with a brief summary of what they do. For more details see the equivalent
 "composite" command option name.  </p>
@@ -672,12 +718,12 @@ with a brief summary of what they do. For more details see the equivalent
         each point of the overlaid area.  Much like the displacement map is a
         'lens' that distorts the original 'background' image behind it.
     <br><br>
-        The X-scale is modilated by the 'red' channel of the overlay image
+        The X-scale is modulated by the 'red' channel of the overlay image
         while the Y-scale is modulated by the green channel, (the mask image
         if given is rolled into green channel of the overlay image. This
         separation allows you to modulate the X and Y lookup displacement
-        separatally allowing you to di 2 dimentional displacements, rather
-        than 1 dimentional verctored displacements (using grayscale image).
+        separately allowing you to do 2-dimensional displacements, rather
+        than 1-dimensional verctored displacements (using grayscale image).
     <br><br>
         If the overlay image contains transparency this is used as a mask
         of the resulting image to remove 'invalid' pixels.
@@ -715,7 +761,7 @@ with a brief summary of what they do. For more details see the equivalent
     <td valign="top">blur</td>
     <td valign="top">Arguments:
         <em class="arg">Width</em>[x<em class="arg">Height</em
-          >[+<em class="arg">Angle</em>]]
+          >[+<em class="arg">Angle</em>][+<em class="arg">Angle2</em>]]
     <br>Equivalent to "<code>composite</code>" <a href="../www/command-line-options.html#blur-composite">-blur</a>
     <br>A Variable Blur Mapping Composition method, where each pixel in the
         overlaid region is replaced with an Elliptical Weighted Average (EWA),
@@ -724,9 +770,15 @@ with a brief summary of what they do. For more details see the equivalent
     <br><br>
         As per 'Displace' and 'Distort', the red channel will modulate the
         width of the ellipse, while the green channel will modulate the height
-        of the ellipse.  However at this time the ellipse angle is not
-        modulated though this may be a future posibility (perhaps with a
-        special flag to enable use of blur channel for this purpose).
+        of the ellipse. If a single Angle value is given in the arguments,
+        then the ellipse will then be rotated by the angle specifed.
+    <br><br>
+        Normally the blue channel of the mapping overlay image is ignored.
+        However if a second ellipse angle is given, then it is assumed that
+        the blue channel defines a variable angle for the ellipse ranging from
+        the first angle to the second angle given.  This allows to generate
+        radial blurs, or a rough approximation for rotational blur. Or any mix
+        of the two.
     <br><br>
         Added to ImageMagick version 6.5.4-0.
     </td>
@@ -751,7 +803,7 @@ href="../www/command-line-options.html#list">-list compose</a>.</p>
     <span id="linkbar-east">&nbsp;</span>\r
   </div>\r
   <div class="footer">\r
-    <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
+    <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>\r
     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
   </div>\r
   <div style="clear: both; margin: 0; width: 100%; "></div>\r