root / ImageMagick / trunk / www / montage.html

Revision 12661, 27.4 kB (checked in by cristy, 41 hours 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: Montage</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:, montage, 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="888632925"><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="989176420"><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="956313423" 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="1187139437" 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.onevital.com" class="sponsor" target="sponsor">Niche Blog<br />Network</a><!-- 200812010010 -->
79      <br />
80      <a href="http://meta-preisvergleich.de" class="sponsor" target="sponsor">Preisvergleich</a><!-- 200901010120 -->
81      <br />
82      <a href="http://www.checkcost.co.uk" class="sponsor" target="sponsor">Compare</a><!-- 200902010720 -->
83      <br />
84      <a href="http://www.ecostsoftware.com" class="sponsor" target="sponsor">Software</a><!-- 200902010720 -->
85      <br />
86      <a href="http://www.callerbase.com" class="sponsor" target="sponsor">Phone Number<br />Search</a><!-- 200812010040 -->
87      <br />
88      <a href="http://www.online-kredit-index.de" class="sponsor" target="sponsor">Kredit</a><!-- 200903010120 -->
89      <br />
90      <a href="http://www.posters555.com" class="sponsor" target="sponsor">Poster</a><!-- 200903010800 -->
91      <br />
92      <a href="http://www.iceposter.com" class="sponsor" target="sponsor">Posters</a><!-- 200812010200 -->
93      <br />
94      <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 -->
95      </fieldset>
96      <span>]</span>
97      </font>
98      </td>
99
100      <td id="main" valign="top">
101<p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
102
103<p>Use the <kbd>montage</kbd> program to create a composite image by combining several separate images.  The images are tiled on the composite image optionally adorned with a border, frame, image name, and more. See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>montage</kbd> command or see below for example usages of the command.</p>
104
105<div style="margin: auto;">
106  <h2><a name="usage"></a>Example Usage</h2>
107</div>
108
109<p>We list a few examples of the <kbd>montage</kbd> command here to illustrate its usefulness and ease of use.  To get started, let's montage two images into a single composite:</p>
110
111<pre class="text">
112  montage -background #336699 -geometry +4+4 rose.jpg red-ball.png montage.jpg
113</pre>
114
115<p class="image">
116  <a href="../images/rose.jpg"><img src="../images/rose.jpg" width="70" height="46" align="middle" alt="rose" /></a>
117  <a href="../images/red-ball.png"><img src="../images/red-ball.png" width="70" height="70" align="middle" alt="red ball" /></a>
118  <img src="../images/right.gif" width="20" height="20" align="middle" alt="==>" />
119  <a href="../images/montage.jpg"><img src="../images/montage.jpg" width="148" height="74" align="middle" alt="montage" /></a>
120</p>
121
122<p>Ok, let's add some decorations:</p>
123
124<pre class="text">
125  montage -label %f -frame 5 -background #336699 -geometry +4+4 rose.jpg red-ball.png frame.jpg
126</pre>
127
128<p class="image">
129  <a href="../images/rose.jpg"><img src="../images/rose.jpg" width="70" height="46" align="middle" alt="rose.jpg" /></a>
130  <a href="../images/red-ball.png"><img src="../images/red-ball.png" width="70" height="70" align="middle" alt="red ball" /></a>
131        <img src="../images/right.gif" width="20" height="20" align="middle" alt="==>" />
132  <a href="../images/frame.jpg"><img src="../images/frame.jpg" width="176" height="108" align="middle" alt="frame" /></a>
133</p>
134
135<p>You can find additional examples of using <kbd>montage</kbd> at <a href="http://www.imagemagick.org/Usage/montage/" target="327528770">Examples of ImageMagick Usage</a> and <a href="http://www-106.ibm.com/developerworks/library/l-graf/?ca=dnt-428" target="1118676617">Graphics from the Command Line</a>.  Further discussion is available in  <a href="http://www-106.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLine" target="95725022">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/" target="1957329181">Examples of ImageMagick Usage</a>.</p>
136
137<div style="margin: auto;">
138  <h2><a name="options"></a>Option Summary</h2>
139</div>
140
141<p>The <kbd>montage</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#adjoin">-adjoin</a></td>
152    <td valign="top">join images into a single multi-image file</td>
153  </tr>
154
155  <tr>
156    <td valign="top"><a href="../www/command-line-options.html#affine">-affine <em class="option">matrix</em></a></td>
157    <td valign="top">affine transform matrix</td>
158  </tr>
159
160  <tr>
161    <td valign="top"><a href="../www/command-line-options.html#alpha" target="magick-options">-alpha</a></td>
162    <td valign="top">activate, deactivate, reset, or set the alpha channel</td>
163  </tr>
164
165  <tr>
166    <td valign="top"><a href="../www/command-line-options.html#annotate" target="magick-options">-annotate <em class="option">geometry text</em></a></td>
167    <td valign="top">annotate the image with text</td>
168  </tr>
169
170  <tr>
171    <td valign="top"><a href="../www/command-line-options.html#authenticate">-authenticate <em class="option">value</em></a></td>
172    <td valign="top">decrypt image with this password</td>
173  </tr>
174
175  <tr>
176    <td valign="top"><a href="../www/command-line-options.html#blue-primary">-blue-primary <em class="option">point</em></a></td>
177    <td valign="top">chromaticity blue primary point</td>
178  </tr>
179
180  <tr>
181    <td valign="top"><a href="../www/command-line-options.html#blur">-blur <em class="option">geometry</em></a></td>
182    <td valign="top">reduce image noise and reduce detail levels</td>
183  </tr>
184
185  <tr>
186    <td valign="top"><a href="../www/command-line-options.html#border">-border <em class="option">geometry</em></a></td>
187    <td valign="top">surround image with a border of color</td>
188  </tr>
189
190  <tr>
191    <td valign="top"><a href="../www/command-line-options.html#bordercolor">-bordercolor <em class="option">color</em></a></td>
192    <td valign="top">border color</td>
193  </tr>
194
195  <tr>
196    <td valign="top"><a href="../www/command-line-options.html#caption">-caption <em class="option">string</em></a></td>
197    <td valign="top">assign a caption to an image</td>
198  </tr>
199
200  <tr>
201    <td valign="top"><a href="../www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
202    <td valign="top">apply option to select image channels</td>
203  </tr>
204
205  <tr>
206    <td valign="top"><a href="../www/command-line-options.html#clone">-clone <em class="option">index</em></a></td>
207    <td valign="top">clone an image</td>
208  </tr>
209
210  <tr>
211    <td valign="top"><a href="../www/command-line-options.html#coalesce" target="magick-options">-coalesce</a></td>
212    <td valign="top">merge a sequence of images</td>
213  </tr>
214
215  <tr>
216    <td valign="top"><a href="../www/command-line-options.html#colors">-colors <em class="option">value</em></a></td>
217    <td valign="top">preferred number of colors in the image</td>
218  </tr>
219
220  <tr>
221    <td valign="top"><a href="../www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
222    <td valign="top">set image colorspace</td>
223  </tr>
224
225  <tr>
226    <td valign="top"><a href="../www/command-line-options.html#comment">-comment <em class="option">string</em></a></td>
227    <td valign="top">annotate image with comment</td>
228  </tr>
229
230  <tr>
231    <td valign="top"><a href="../www/command-line-options.html#compose">-compose <em class="option">operator</em></a></td>
232    <td valign="top">set image composite operator</td>
233  </tr>
234
235  <tr>
236    <td valign="top"><a href="../www/command-line-options.html#compress">-compress <em class="option">type</em></a></td>
237    <td valign="top">image compression type</td>
238  </tr>
239
240  <tr>
241    <td valign="top"><a href="../www/command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
242    <td valign="top">preferred size and location of the cropped image</td>
243  </tr>
244
245  <tr>
246    <td valign="top"><a href="../www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
247    <td valign="top">display copious debugging information</td>
248  </tr>
249
250  <tr>
251    <td valign="top"><a href="../www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
252    <td valign="top">define one or more image format options</td>
253  </tr>
254
255  <tr>
256    <td valign="top"><a href="../www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
257    <td valign="top">horizontal and vertical density of the image</td>
258  </tr>
259
260  <tr>
261    <td valign="top"><a href="../www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
262    <td valign="top">image depth</td>
263  </tr>
264
265  <tr>
266    <td valign="top"><a href="../www/command-line-options.html#display">-display <em class="option">server</em></a></td>
267    <td valign="top">get image or font from this X server</td>
268  </tr>
269
270  <tr>
271    <td valign="top"><a href="../www/command-line-options.html#dispose">-dispose <em class="option">method</em></a></td>
272    <td valign="top">layer disposal method</td>
273  </tr>
274
275  <tr>
276    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither  <em class="option">method</em></a></td>
277    <td valign="top">apply error diffusion to image</td>
278  </tr>
279
280  <tr>
281    <td valign="top"><a href="../www/command-line-options.html#draw">-draw <em class="option">string</em></a></td>
282    <td valign="top">annotate the image with a graphic primitive</td>
283  </tr>
284
285  <tr>
286    <td valign="top"><a href="../www/command-line-options.html#endian">-endian <em class="option">type</em></a></td>
287    <td valign="top">endianness (MSB or LSB) of the image</td>
288  </tr>
289
290  <tr>
291    <td valign="top"><a href="../www/command-line-options.html#extract">-extract <em class="option">geometry</em></a></td>
292    <td valign="top">extract area from image</td>
293  </tr>
294
295  <tr>
296    <td valign="top"><a href="../www/command-line-options.html#fill">-fill <em class="option">color</em></a></td>
297    <td valign="top">color to use when filling a graphic primitive</td>
298  </tr>
299
300  <tr>
301    <td valign="top"><a href="../www/command-line-options.html#filter" target="magick-options">-filter <em class="option">type</em></a></td>
302    <td valign="top">use this filter when resizing an image</td>
303  </tr>
304
305  <tr>
306    <td valign="top"><a href="../www/command-line-options.html#flatten" target="magick-options">-flatten</a></td>
307    <td valign="top">flatten a sequence of images</td>
308  </tr>
309
310  <tr>
311    <td valign="top"><a href="../www/command-line-options.html#flip">-flip</a></td>
312    <td valign="top">flip image in the vertical direction</td>
313  </tr>
314
315  <tr>
316    <td valign="top"><a href="../www/command-line-options.html#flop">-flop</a></td>
317    <td valign="top">flop image in the horizontal direction</td>
318  </tr>
319
320  <tr>
321    <td valign="top"><a href="../www/command-line-options.html#font">-font <em class="option">name</em></a></td>
322    <td valign="top">render text with this font</td>
323  </tr>
324
325  <tr>
326    <td valign="top"><a href="../www/command-line-options.html#frame">-frame <em class="option">geometry</em></a></td>
327    <td valign="top">surround image with an ornamental border</td>
328  </tr>
329
330  <tr>
331    <td valign="top"><a href="../www/command-line-options.html#gamma">-gamma <em class="option">value</em></a></td>
332    <td valign="top">level of gamma correction</td>
333  </tr>
334
335  <tr>
336    <td valign="top"><a href="../www/command-line-options.html#geometry">-geometry <em class="option">geometry</em></a></td>
337    <td valign="top">preferred size or location of the image</td>
338  </tr>
339
340  <tr>
341    <td valign="top"><a href="../www/command-line-options.html#gravity">-gravity <em class="option">type</em></a></td>
342    <td valign="top">horizontal and vertical text placement</td>
343  </tr>
344
345  <tr>
346    <td valign="top"><a href="../www/command-line-options.html#green-primary">-green-primary <em class="option">point</em></a></td>
347    <td valign="top">chromaticity green primary point</td>
348  </tr>
349
350  <tr>
351    <td valign="top"><a href="../www/command-line-options.html#help">-help</a></td>
352    <td valign="top">print program options</td>
353  </tr>
354
355  <tr>
356    <td valign="top"><a href="../www/command-line-options.html#identify" target="magick-options">-identify</a></td>
357    <td valign="top">identify the format and characteristics of the image</td>
358  </tr>
359
360  <tr>
361    <td valign="top"><a href="../www/command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
362    <td valign="top">type of image interlacing scheme</td>
363  </tr>
364
365  <tr>
366    <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
367    <td valign="top">pixel color interpolation method</td>
368  </tr>
369
370  <tr>
371    <td valign="top"><a href="../www/command-line-options.html#label">-label <em class="option">string</em></a></td>
372    <td valign="top">assign a label to an image</td>
373  </tr>
374
375  <tr>
376    <td valign="top"><a href="../www/command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
377    <td valign="top">pixel cache resource limit</td>
378  </tr>
379
380  <tr>
381    <td valign="top"><a href="../www/command-line-options.html#log">-log <em class="option">format</em></a></td>
382    <td valign="top">format of debugging information</td>
383  </tr>
384
385  <tr>
386    <td valign="top"><a href="../www/command-line-options.html#mattecolor">-mattecolor <em class="option">color</em></a></td>
387    <td valign="top">frame color</td>
388  </tr>
389
390  <tr>
391    <td valign="top"><a href="../www/command-line-options.html#mode">-mode <em class="option">type</em></a></td>
392    <td valign="top">framing style</td>
393  </tr>
394
395  <tr>
396    <td valign="top"><a href="../www/command-line-options.html#monitor">-monitor</a></td>
397    <td valign="top">monitor progress</td>
398  </tr>
399
400  <tr>
401    <td valign="top"><a href="../www/command-line-options.html#monochrome">-monochrome</a></td>
402    <td valign="top">transform image to black and white</td>
403  </tr>
404
405  <tr>
406    <td valign="top"><a href="../www/command-line-options.html#origin">-origin <em class="option">geometry</em></a></td>
407    <td valign="top">image origin</td>
408  </tr>
409
410  <tr>
411    <td valign="top"><a href="../www/command-line-options.html#page">-page <em class="option">geometry</em></a></td>
412    <td valign="top">size and location of an image canvas (setting)</td>
413  </tr>
414
415  <tr>
416    <td valign="top"><a href="../www/command-line-options.html#pointsize">-pointsize <em class="option">value</em></a></td>
417    <td valign="top">font point size</td>
418  </tr>
419
420  <tr>
421    <td valign="top"><a href="../www/command-line-options.html#polaroid" target="magick-options">-polaroid <em class="option">angle</em></a></td>
422    <td valign="top">simulate a Polaroid picture</td>
423  </tr>
424
425  <tr>
426    <td valign="top"><a href="../www/command-line-options.html#profile">-profile <em class="option">filename</em></a></td>
427    <td valign="top">add, delete, or apply an image profile</td>
428  </tr>
429
430  <tr>
431    <td valign="top"><a href="../www/command-line-options.html#quality">-quality <em class="option">value</em></a></td>
432    <td valign="top">JPEG/MIFF/PNG compression level</td>
433  </tr>
434
435  <tr>
436    <td valign="top"><a href="../www/command-line-options.html#quantize" target="magick-options">-quantize <em class="option">colorspace</em></a></td>
437    <td valign="top">reduce image colors in this colorspace</td>
438  </tr>
439
440  <tr>
441    <td valign="top"><a href="../www/command-line-options.html#quiet">-quiet</a></td>
442    <td valign="top">suppress all warning messages</td>
443  </tr>
444
445  <tr>
446    <td valign="top"><a href="../www/command-line-options.html#red-primary">-red-primary <em class="option">point</em></a></td>
447    <td valign="top">chromaticity red primary point</td>
448  </tr>
449
450  <tr>
451    <td valign="top"><a href="../www/command-line-options.html#regard-warnings" target="magick-options">-regard-warnings</a></td>
452    <td valign="top">pay attention to warning messages.</td>
453  </tr>
454
455  <tr>
456