root / ImageMagick / trunk / www / composite.html

Revision 12206, 26.6 kB (checked in by cristy, 3 days ago)
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
4<head>
5  <style type="text/css" media="screen,projection"><!--
6    @import url("../www/magick.css");
7  //--></style>
8  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
9  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
10  <title>ImageMagick: Command-line Tools: Composite</title>
11  <meta http-equiv="Content-Language" content="en-US"/>
12  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
13  <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
14  <meta name="Generator" content="PHP"/>
15  <meta name="Keywords" content="command-line, tools:, composite, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject"/>
16  <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."/>
17  <meta name="Rating" content="GENERAL"/>
18  <meta name="Robots" content="INDEX, FOLLOW"/>
19  <meta name="Generator" content="ImageMagick Studio LLC"/>
20  <meta name="Author" content="ImageMagick Studio LLC"/>
21  <meta name="Revisit-after" content="2 DAYS"/>
22  <meta name="Resource-type" content="document"/>
23  <meta name="Copyright" content="Copyright (c) 1999-2008 ImageMagick Studio LLC"/>
24  <meta name="Distribution" content="Global"/>
25  <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
26</head>
27
28<body id="www-imagemagick-org">
29  <table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="ImageMagick">
30    <tbody>
31      <tr valign="top">
32        <td align="left"><a href="../index.html"><img id="titlebar-west" src="../images/script.png" alt="[ImageMagick]" width="350" height="60" vspace="28" name="titlebar-west"/></a></td>
33        <td align="left"><a href="https://secure.networkredux.com/affiliate/idevaffiliate.html?id=146" target="594972902"><img id="titlebar-west" src="../images/networkredux.png" alt="[sponsor]" border="0" vspace="45" name="titlebar-west"/></a></td>
34        <td width="99%"><br /> </td>
35        <td style="background-color: white" align="right"><a href="../index.html"><img src="../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
36        <td style="background-color: white" align="right"><a href="http://www.imagemagick.org/discourse-server/" target="1806833170"><img id="titlebar-east" src="../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
37      </tr>
38    </tbody>
39  </table>
40
41  <table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary="">
42  <tbody>
43
44    <tr valign="top" style="height: 100%;">
45      <td id="menu" width="1%" height="100%">
46      <p><a href="#main">Skip to page contents</a></p>
47      <font size="-1">
48      <span>[</span>
49      <a href="../index.html">About ImageMagick</a>
50  <span>]</span><br /><span>[</span>
51      <a href="../www/command-line-tools.html">Command-line Tools</a>
52      <a href="../www/command-line-processing.html" class="sub">Processing</a>
53      <a href="../www/command-line-options.html" class="sub">Options</a>
54      <a href="http://www.imagemagick.org/Usage/" target="902357157" class="sub">Usage</a>
55      <a href="../www/api.html">Program Interfaces</a>
56      <a href="../www/magick-wand.html" class="sub">MagickWand</a>
57      <a href="../www/magick-core.html" class="sub">MagickCore</a>
58      <a href="../www/perl-magick.html" class="sub">PerlMagick</a>
59      <a href="../www/Magick++/" target="106032573" class="sub">Magick++</a>
60      <a href="../www/architecture.html">Architecture</a>
61  <span>]</span><br /><span>[</span>
62      <a href="../www/install-source.html">Install from Source</a>
63      <a href="../www/install-source.html#unix" class="sub">Unix</a>
64      <a href="../www/install-source.html#windows" class="sub">Windows</a>
65      <a href="../www/binary-releases.html">Binary Releases</a>
66      <a href="../www/binary-releases.html#unix" class="sub">Unix</a>
67      <a href="../www/binary-releases.html#macosx" class="sub">Mac OS X</a>
68      <a href="../www/binary-releases.html#windows" class="sub">Windows</a>
69      <a href="../www/resources.html">Resources</a>
70  <span>]</span><br /><span>[</span>
71      <a href="../www/download.html">Download</a>
72  <span>]</span><br /><span>[</span>
73      <a href="../www/sitemap.html">Site Map</a>
74                        <a href="../www/links.html" class="sub">Links</a>
75  <span>]</span><br /><span>[</span>
76      <a href="../www/sponsors.html">Sponsors:</a>
77      <fieldset>
78  <a href="http://www.ausgefallene-geschenke-shop.de/" class="sponsor" target="sponsor">Geschenke</a><!-- 200901010200 -->
79      <br />
80      <a href="http://www.callerbase.com" class="sponsor" target="sponsor">Phone Number<br />Search</a><!-- 200812010040 -->
81      <br />
82      <a href="http://www.online-kredit-index.de" class="sponsor" target="sponsor">Kredit</a><!-- 200812010120 -->
83      <br />
84      <a href="http://www.posters555.com" class="sponsor" target="sponsor">Poster</a><!-- 200903010800 -->
85      <br />
86      <a href="http://www.iceposter.com" class="sponsor" target="sponsor">Posters</a><!-- 200812010200 -->
87      <br />
88      <a href="http://meta-preisvergleich.de" class="sponsor" target="sponsor">Preisvergleich</a><!-- 200810010120 -->
89      <br />
90      <a href="http://www.imade-art.de"><img src="../images/imade_art2.jpg" alt="[Kunst bei imade-art]" width="116" height="28" border="0" name="Kunst bei imade-art"/></a> <!-- 200811010160 -->
91      </fieldset>
92      <span>]</span>
93      </font>
94      </td>
95
96      <td id="main" valign="top">
97<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
98
99<p>Use the <kbd>composite</kbd> program to overlap one image over another.  See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>composite</kbd> command or see below for example usages of the command.</p>
100
101<div style="margin: auto;">
102  <h2><a name="usage"></a>Example Usage</h2>
103</div>
104
105<p>We list a few examples of the <kbd>composite</kbd> command here to illustrate its usefulness and ease of use.  To get started, lets overlay a letter over a rose:</p>
106
107<pre class="text">
108composite -gravity center smile.gif  rose: rose-over.png
109</pre>
110
111<p class="image">
112  <a href="../images/smile.gif"><img src="../images/smile.gif" width="48" height="48" align="middle" alt="smile" /></a>
113&nbsp <em>over</em> &nbsp
114  <a href="../images/rose.jpg"><img src="../images/rose.jpg" width="70" height="46" align="middle" alt="rose" /></a>
115  <img src="../images/right.gif" width="20" height="20" align="middle" alt="==>" />
116  <a href="../images/rose-over.png"><img src="../images/rose-over.png" width="70" height="46" align="middle" alt="rose" /></a>
117</p>
118
119<p>You can create three-dimensional effect with the <em>Atop</em>:</p>
120
121<pre class="text">
122  convert -size 70x70 xc:none -fill red -draw 'circle 35,35 10,30' red-circle.png
123  convert -size 70x70 xc:none -draw 'circle 35,35 35,20' -negate -channel A -gaussian 0x8 white-highlight.png
124  composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
125</pre>
126
127<p class="image">
128  <a href="../images/white-highlight.png"><img src="../images/white-highlight.png" width="70" height="70" align="middle" alt="white highlight" /></a>
129&nbsp <em>atop</em> &nbsp
130  <a href="../images/red-circle.png"><img src="../images/red-circle.png" width="70" height="70" align="middle" alt="red circle" /></a>
131  <img src="../images/right.gif" width="20" height="20" align="middle" alt="==>" />
132  <a href="../images/red-ball.png"><img src="../images/red-ball.png" width="70" height="70" align="middle" alt="red ball" /></a>
133</p>
134
135<p>You can find additional examples of using <kbd>composite</kbd> in <a href="http://www.imagemagick.org/Usage/" target="1908465939">Examples of ImageMagick Usage</a>.  You can find out more about them and the mathematics by looking at <a href="http://www.w3.org/TR/SVG12/rendering.html" target="1909472315">SVG Alpha Compositing</a></p>
136
137<div style="margin: auto;">
138  <h2><a name="options"></a>Option Summary</h2>
139</div>
140
141<p>The <kbd>composite</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
142
143<table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
144  <tbody>
145  <tr>
146    <th align="left">Option</th>
147    <th align="left">Description</th>
148  </tr>
149
150  <tr>
151    <td valign="top"><a href="../www/command-line-options.html#affine" target="magick-options">-affine <em class="option">matrix</em></a></td>
152    <td valign="top">affine transform matrix</td>
153  </tr>
154
155  <tr>
156    <td valign="top"><a href="../www/command-line-options.html#alpha" target="magick-options">-alpha</a></td>
157    <td valign="top">activate, deactivate, reset, or set the alpha channel</td>
158  </tr>
159
160  <tr>
161    <td valign="top"><a href="../www/command-line-options.html#authenticate" target="magick-options">-authenticate <em class="option">value</em></a></td>
162    <td valign="top">decrypt image with this password</td>
163  </tr>
164
165  <tr>
166    <td valign="top"><a href="../www/command-line-options.html#blend" target="magick-options">-blend <em class="option">geometry</em></a></td>
167    <td valign="top">blend images</td>
168  </tr>
169
170  <tr>
171    <td valign="top"><a href="../www/command-line-options.html#blue-primary" target="magick-options">-blue-primary <em class="option">point</em></a></td>
172    <td valign="top">chromaticity blue primary point</td>
173  </tr>
174
175
176  <tr>
177    <td valign="top"><a href="../www/command-line-options.html#border" target="magick-options">-border <em class="option">geometry</em></a></td>
178    <td valign="top">surround image with a border of color</td>
179  </tr>
180
181  <tr>
182    <td valign="top"><a href="../www/command-line-options.html#bordercolor" target="magick-options">-bordercolor <em class="option">color</em></a></td>
183    <td valign="top">border color</td>
184  </tr>
185
186  <tr>
187    <td valign="top"><a href="../www/command-line-options.html#channel" target="magick-options">-channel <em class="option">type</em></a></td>
188    <td valign="top">apply option to select image channels</td>
189  </tr>
190
191  <tr>
192    <td valign="top"><a href="../www/command-line-options.html#colors" target="magick-options">-colors <em class="option">value</em></a></td>
193    <td valign="top">preferred number of colors in the image</td>
194  </tr>
195
196  <tr>
197    <td valign="top"><a href="../www/command-line-options.html#colorspace" target="magick-options">-colorspace <em class="option">type</em></a></td>
198    <td valign="top">set image colorspace</td>
199  </tr>
200
201  <tr>
202    <td valign="top"><a href="../www/command-line-options.html#comment" target="magick-options">-comment <em class="option">string</em></a></td>
203    <td valign="top">annotate image with comment</td>
204  </tr>
205
206  <tr>
207    <td valign="top"><a href="../www/command-line-options.html#compose" target="magick-options">-compose <em class="option">operator</em></a></td>
208    <td valign="top">set image composite operator</td>
209  </tr>
210
211  <tr>
212    <td valign="top"><a href="../www/command-line-options.html#compress" target="magick-options">-compress <em class="option">type</em></a></td>
213    <td valign="top">image compression type</td>
214  </tr>
215
216  <tr>
217    <td valign="top"><a href="../www/command-line-options.html#debug" target="magick-options">-debug <em class="option">events</em></a></td>
218    <td valign="top">display copious debugging information</td>
219  </tr>
220
221  <tr>
222    <td valign="top"><a href="../www/command-line-options.html#decipher" target="magick-options">-decipher <em class="option">filename</em></a></td>
223    <td valign="top">convert cipher pixels to plain</td>
224  </tr>
225
226  <tr>
227    <td valign="top"><a href="../www/command-line-options.html#define" target="magick-options">-define <em class="option">format:option</em></a></td>
228    <td valign="top">define one or more image format options</td>
229  </tr>
230
231  <tr>
232    <td valign="top"><a href="../www/command-line-options.html#density" target="magick-options">-density <em class="option">geometry</em></a></td>
233    <td valign="top">horizontal and vertical density of the image</td>
234  </tr>
235
236  <tr>
237    <td valign="top"><a href="../www/command-line-options.html#depth" target="magick-options">-depth <em class="option">value</em></a></td>
238    <td valign="top">image depth</td>
239  </tr>
240
241  <tr>
242    <td valign="top"><a href="../www/command-line-options.html#displace" target="magick-options">-displace <em class="option">geometry</em></a></td>
243    <td valign="top">shift image pixels defined by a displacement map</td>
244  </tr>
245
246  <tr>
247    <td valign="top"><a href="../www/command-line-options.html#dissolve" target="magick-options">-dissolve <em class="option">value</em></a></td>
248    <td valign="top">dissolve the two images a given percent</td>
249  </tr>
250
251  <tr>
252    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither  <em class="option">method</em></a></td>
253    <td valign="top">apply error diffusion to image</td>
254  </tr>
255
256  <tr>
257    <td valign="top"><a href="../www/command-line-options.html#encipher" target="magick-options">-encipher <em class="option">filename</em></a></td>
258    <td valign="top">convert plain pixels to cipher pixels</td>
259  </tr>
260
261  <tr>
262    <td valign="top"><a href="../www/command-line-options.html#encoding" target="magick-options">-encoding <em class="option">type</em></a></td>
263    <td valign="top">text encoding type</td>
264  </tr>
265
266  <tr>
267    <td valign="top"><a href="../www/command-line-options.html#endian" target="magick-options">-endian <em class="option">type</em></a></td>
268    <td valign="top">endianness (MSB or LSB) of the image</td>
269  </tr>
270
271  <tr>
272    <td valign="top"><a href="../www/command-line-options.html#extract" target="magick-options">-extract <em class="option">geometry</em></a></td>
273    <td valign="top">extract area from image</td>
274  </tr>
275
276  <tr>
277    <td valign="top"><a href="../www/command-line-options.html#filter" target="magick-options">-filter <em class="option">type</em></a></td>
278    <td valign="top">use this filter when resizing an image</td>
279  </tr>
280
281  <tr>
282    <td valign="top"><a href="../www/command-line-options.html#font" target="magick-options">-font <em class="option">name</em></a></td>
283    <td valign="top">render text with this font</td>
284  </tr>
285
286  <tr>
287    <td valign="top"><a href="../www/command-line-options.html#geometry" target="magick-options">-geometry <em class="option">geometry</em></a></td>
288    <td valign="top">preferred size or location of the image</td>
289  </tr>
290
291  <tr>
292    <td valign="top"><a href="../www/command-line-options.html#gravity" target="magick-options">-gravity <em class="option">type</em></a></td>
293    <td valign="top">horizontal and vertical text placement</td>
294  </tr>
295
296  <tr>
297    <td valign="top"><a href="../www/command-line-options.html#green-primary" target="magick-options">-green-primary <em class="option">point</em></a></td>
298    <td valign="top">chromaticity green primary point</td>
299  </tr>
300
301  <tr>
302    <td valign="top"><a href="../www/command-line-options.html#help" target="magick-options">-help</a></td>
303    <td valign="top">print program options</td>
304  </tr>
305
306  <tr>
307    <td valign="top"><a href="../www/command-line-options.html#identify" target="magick-options">-identify</a></td>
308    <td valign="top">identify the format and characteristics of the image</td>
309  </tr>
310
311  <tr>
312    <td valign="top"><a href="../www/command-line-options.html#interlace" target="magick-options">-interlace <em class="option">type</em></a></td>
313    <td valign="top">type of image interlacing scheme</td>
314  </tr>
315
316  <tr>
317    <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
318    <td valign="top">pixel color interpolation method</td>
319  </tr>
320
321  <tr>
322    <td valign="top"><a href="../www/command-line-options.html#label" target="magick-options">-label <em class="option">string</em></a></td>
323    <td valign="top">assign a label to an image</td>
324  </tr>
325
326  <tr>
327    <td valign="top"><a href="../www/command-line-options.html#level" target="magick-options">-level <em class="option">value</em></a></td>
328    <td valign="top">adjust the level of image contrast</td>
329  </tr>
330
331  <tr>
332    <td valign="top"><a href="../www/command-line-options.html#limit" target="magick-options">-limit <em class="option">type value</em></a></td>
333    <td valign="top">pixel cache resource limit</td>
334  </tr>
335
336  <tr>
337    <td valign="top"><a href="../www/command-line-options.html#log" target="magick-options">-log <em class="option">format</em></a></td>
338    <td valign="top">format of debugging information</td>
339  </tr>
340
341  <tr>
342    <td valign="top"><a href="../www/command-line-options.html#monitor" target="magick-options">-monitor</a></td>
343    <td valign="top">monitor progress</td>
344  </tr>
345
346  <tr>
347    <td valign="top"><a href="../www/command-line-options.html#monochrome" target="magick-options">-monochrome</a></td>
348    <td valign="top">transform image to black and white</td>
349  </tr>
350
351  <tr>
352    <td valign="top"><a href="../www/command-line-options.html#negate" target="magick-options">-negate</a></td>
353    <td valign="top">replace every pixel with its complementary color </td>
354  </tr>
355
356  <tr>
357    <td valign="top"><a href="../www/command-line-options.html#page" target="magick-options">-page <em class="option">geometry</em></a></td>
358    <td valign="top">size and location of an image canvas (setting)</td>
359  </tr>
360
361  <tr>
362    <td valign="top"><a href="../www/command-line-options.html#pointsize" target="magick-options">-pointsize <em class="option">value</em></a></td>
363    <td valign="top">font point size</td>
364  </tr>
365
366  <tr>
367    <td valign="top"><a href="../www/command-line-options.html#profile" target="magick-options">-profile <em class="option">filename</em></a></td>
368    <td valign="top">add, delete, or apply an image profile</td>
369  </tr>
370
371  <tr>
372    <td valign="top"><a href="../www/command-line-options.html#quality" target="magick-options">-quality <em class="option">value</em></a></td>
373    <td valign="top">JPEG/MIFF/PNG compression level</td>
374  </tr>
375
376  <tr>
377    <td valign="top"><a href="../www/command-line-options.html#quantize" target="magick-options">-quantize <em class="option">colorspace</em></a></td>
378    <td valign="top">reduce image colors in this colorspace</td>
379  </tr>
380
381  <tr>
382    <td valign="top"><a href="../www/command-line-options.html#quiet" target="magick-options">-quiet</a></td>
383    <td valign="top">suppress all warning messages</td>
384  </tr>
385
386  <tr>
387    <td valign="top"><a href="../www/command-line-options.html#red-primary" target="magick-options">-red-primary <em class="option">point</em></a></td>
388    <td valign="top">chromaticity red primary point</td>
389  </tr>
390
391  <tr>
392    <td valign="top"><a href="../www/command-line-options.html#regard-warnings" target="magick-options">-regard-warnings</a></td>
393    <td valign="top">pay attention to warning messages.</td>
394  </tr>
395
396  <tr>
397    <td valign="top"><a href="../www/command-line-options.html#respect-parenthesis" target="magick-options">-respect-parenthesis</a></td>
398    <td valign="top">settings remain in effect until parenthesis boundary.</td>
399  </tr>
400
401  <tr>
402    <td valign="top"><a href="../www/command-line-options.html#rotate" target="magick-options">-rotate <em class="option">degrees</em></a></td>
403    <td valign="top">apply Paeth rotation to the image</td>
404  </tr>
405
406  <tr>
407    <td valign="top"><a href="../www/command-line-options.html#sampling-factor" target="magick-options">-sampling-factor <em class="option">geometry</em></a></td>
408    <td valign="top">horizontal and vertical sampling factor</td>
409  </tr>
410
411  <tr>
412    <td valign="top"><a href="../www/command-line-options.html#scene" target="magick-options">-scene <em class="option">value</em></a></td>
413    <td valign="top">image scene number</td>
414  </tr>
415
416  <tr>
417    <td valign="top"><a href="../www/command-line-options.html#seed" target="magick-options">-seed <em class="option">value</em></a></td>
418    <td valign="top">seed a new sequence of pseudo-random numbers</td>
419  </tr>
420
421  <tr>
422    <td valign="top"><a href="../www/command-line-options.html#set" target="magick-options">-set <em class="option">attribute value</em></a></td>
423    <td valign="top">set an image attribute</td>
424  </tr>
425
426  <tr>
427    <td valign="top"><a href="../www/command-line-options.html#sharpen" target="magick-options">-sharpen <em class="option">geometry</em></a></td>
428    <td valign="top">sharpen the image</td>
429  </tr>
430
431  <tr>
432    <td valign="top"><a href="../www/command-line-options.html#shave" target="magick-options">-shave <em class="option">geometry</em></a></td>
433    <td valign="top">shave pixels from the image edges</td>
434  </tr>
435
436  <tr>
437    <td valign="top"><a href="../www/command-line-options.html#size" target="magick-options">-size <em class="option">geometry</em></a></td>
438    <td valign="top">width and height of image</td>
439  </tr>
440
441  <tr>
442    <td valign="top"><a href="../www/command-line-options.html#stegano" target="magick-options">-stegano <em>offset</em></a></td>
443    <td valign="top">hide watermark within an image</td>
444  </tr>
445
446  <tr>
447    <td valign="top"><a href="../www/command-line-options.html#strip" target="magick-options">-strip</a></td>
448    <td valign="top">strip image of all profiles and comments</td>
449  </tr>
450
451  <tr>
452    <td valign="top"><a href="../www/command-line-options.html#swap" target="magick-options">-swap <em class="option">indexes</em></a></td>
453    <td valign="top">swap two images in the image sequence</td>
454  </tr>
455
456  <tr>
457    <td valign=