\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
<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>
<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
<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>
<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
<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
<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>
<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>
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">
<p class='crt'><span class="crtprompt"> $magick> </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> </span><span class='crtin'>convert ... -compose blend -set option:compose:args 50x50 -composite ...</span></p>
+<p class='crt'><span class="crtprompt"> $magick> </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>
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.
<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),
<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>
<span id="linkbar-east"> </span>\r
</div>\r
<div class="footer">\r
- <span id="footer-west">© 1999-2010 ImageMagick Studio LLC</span>\r
+ <span id="footer-west">© 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