root / ImageMagick / trunk / www / display.html

Revision 12661, 27.5 kB (checked in by cristy, 34 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: Display</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:, display, 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="1012583908"><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="1203198918"><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="500673218" 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="332979019" 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.neue.autoteile-info.de/auspuff.html" class="sponsor" target="sponsor">Auspuff</a><!-- 200811010100 -->
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>display</kbd> program to display an image or image sequence on any X server.  See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>display</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>display</kbd> command here to illustrate its usefulness and ease of use.  To get started, lets display an image in the JPEG format:</p>
110
111<pre class="text">
112  display rose.jpg
113</pre>
114
115<p>To tile a slate texture onto the root window, use:</p>
116
117<pre class="text">
118  display -size 1280x1024 -window root slate.png
119</pre>
120
121<p>To display a visual image directory of all your JPEG images, use:</p>
122
123<pre class="text">
124  display ’vid:*.jpg’
125</pre>
126
127<p>You can find additional examples of using <kbd>display</kbd> in <a href="http://www-106.ibm.com/developerworks/library/l-graf/?ca=dnt-428" target="1972316565">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="1990252337">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/" target="950110088">Examples of ImageMagick Usage</a>.</p>
128
129<div style="margin: auto;">
130  <h2><a name="options"></a>Option Summary</h2>
131</div>
132
133<p>The <kbd>display</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
134
135<table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
136  <tbody>
137  <tr>
138    <th align="left">Option</th>
139    <th align="left">Description</th>
140  </tr>
141
142  <tr>
143    <td valign="top"><a href="../www/command-line-options.html#alpha" target="magick-options">-alpha</a></td>
144    <td valign="top">activate, deactivate, reset, or set the alpha channel</td>
145  </tr>
146
147  <tr>
148    <td valign="top"><a href="../www/command-line-options.html#antialias" target="magick-options">-antialias</a></td>
149    <td valign="top">remove pixel-aliasing</td>
150  </tr>
151
152  <tr>
153    <td valign="top"><a href="../www/command-line-options.html#authenticate" target="magick-options">-authenticate <em class="option">value</em></a></td>
154    <td valign="top">decrypt image with this password</td>
155  </tr>
156
157  <tr>
158    <td valign="top"><a href="../www/command-line-options.html#backdrop" target="magick-options">-backdrop</a></td>
159    <td valign="top">background color</td>
160  </tr>
161
162  <tr>
163    <td valign="top"><a href="../www/command-line-options.html#background" target="magick-options">-background <em class="option">color</em></a></td>
164    <td valign="top">background color</td>
165  </tr>
166
167  <tr>
168    <td valign="top"><a href="../www/command-line-options.html#border" target="magick-options">-border <em class="option">geometry</em></a></td>
169    <td valign="top">surround image with a border of color</td>
170  </tr>
171
172  <tr>
173    <td valign="top"><a href="../www/command-line-options.html#bordercolor" target="magick-options">-bordercolor <em class="option">color</em></a></td>
174    <td valign="top">border color</td>
175  </tr>
176
177  <tr>
178    <td valign="top"><a href="../www/command-line-options.html#channel" target="magick-options">-channel <em class="option">type</em></a></td>
179    <td valign="top">apply option to select image channels</td>
180  </tr>
181
182  <tr>
183    <td valign="top"><a href="../www/command-line-options.html#clip" target="magick-options">-clip</a></td>
184    <td valign="top">clip along the first path from the 8BIM profile</td>
185  </tr>
186
187  <tr>
188    <td valign="top"><a href="../www/command-line-options.html#clip-path" target="magick-options">-clip-path <em class="option">id</em></a></td>
189    <td valign="top">clip along a named path from the 8BIM profile</td>
190  </tr>
191
192  <tr>
193    <td valign="top"><a href="../www/command-line-options.html#coalesce" target="magick-options">-coalesce</a></td>
194    <td valign="top">merge a sequence of images</td>
195  </tr>
196
197  <tr>
198    <td valign="top"><a href="../www/command-line-options.html#colormap" target="magick-options">-colormap <em class="option">type</em></a></td>
199    <td valign="top">Shared or Private</td>
200  </tr>
201
202  <tr>
203    <td valign="top"><a href="../www/command-line-options.html#colors" target="magick-options">-colors <em class="option">value</em></a></td>
204    <td valign="top">preferred number of colors in the image</td>
205  </tr>
206
207  <tr>
208    <td valign="top"><a href="../www/command-line-options.html#colorspace" target="magick-options">-colorspace <em class="option">type</em></a></td>
209    <td valign="top">set image colorspace</td>
210  </tr>
211
212  <tr>
213    <td valign="top"><a href="../www/command-line-options.html#comment" target="magick-options">-comment <em class="option">string</em></a></td>
214    <td valign="top">annotate image with comment</td>
215  </tr>
216
217  <tr>
218    <td valign="top"><a href="../www/command-line-options.html#compress" target="magick-options">-compress <em class="option">type</em></a></td>
219    <td valign="top">image compression type</td>
220  </tr>
221
222  <tr>
223    <td valign="top"><a href="../www/command-line-options.html#contrast" target="magick-options">-contrast</a></td>
224    <td valign="top">enhance or reduce the image contrast</td>
225  </tr>
226
227  <tr>
228    <td valign="top"><a href="../www/command-line-options.html#crop" target="magick-options">-crop <em class="option">geometry</em></a></td>
229    <td valign="top">preferred size and location of the cropped image</td>
230  </tr>
231
232  <tr>
233    <td valign="top"><a href="../www/command-line-options.html#debug" target="magick-options">-debug <em class="option">events</em></a></td>
234    <td valign="top">display copious debugging information</td>
235  </tr>
236
237  <tr>
238    <td valign="top"><a href="../www/command-line-options.html#decipher" target="magick-options">-decipher <em class="option">filename</em></a></td>
239    <td valign="top">convert cipher pixels to plain</td>
240  </tr>
241
242  <tr>
243    <td valign="top"><a href="../www/command-line-options.html#define" target="magick-options">-define <em class="option">format:option</em></a></td>
244    <td valign="top">define one or more image format options</td>
245  </tr>
246
247  <tr>
248    <td valign="top"><a href="../www/command-line-options.html#delay" target="magick-options">-delay <em class="option">value</em></a></td>
249    <td valign="top">display the next image after pausing</td>
250  </tr>
251
252  <tr>
253    <td valign="top"><a href="../www/command-line-options.html#density" target="magick-options">-density <em class="option">geometry</em></a></td>
254    <td valign="top">horizontal and vertical density of the image</td>
255  </tr>
256
257  <tr>
258    <td valign="top"><a href="../www/command-line-options.html#depth" target="magick-options">-depth <em class="option">value</em></a></td>
259    <td valign="top">image depth</td>
260  </tr>
261
262  <tr>
263    <td valign="top"><a href="../www/command-line-options.html#despeckle" target="magick-options">-despeckle</a></td>
264    <td valign="top">reduce the speckles within an image</td>
265  </tr>
266
267  <tr>
268    <td valign="top"><a href="../www/command-line-options.html#display" target="magick-options">-display <em class="option">server</em></a></td>
269    <td valign="top">get image or font from this X server</td>
270  </tr>
271
272  <tr>
273    <td valign="top"><a href="../www/command-line-options.html#dispose" target="magick-options">-dispose <em class="option">method</em></a></td>
274    <td valign="top">layer disposal method</td>
275  </tr>
276
277  <tr>
278    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither  <em class="option">method</em></a></td>
279    <td valign="top">apply error diffusion to image</td>
280  </tr>
281
282  <tr>
283    <td valign="top"><a href="../www/command-line-options.html#edge" target="magick-options">-edge <em class="option">radius</em></a></td>
284    <td valign="top">apply a filter to detect edges in the image</td>
285  </tr>
286
287  <tr>
288    <td valign="top"><a href="../www/command-line-options.html#endian" target="magick-options">-endian <em class="option">type</em></a></td>
289    <td valign="top">endianness (MSB or LSB) of the image</td>
290  </tr>
291
292  <tr>
293    <td valign="top"><a href="../www/command-line-options.html#enhance" target="magick-options">-enhance</a></td>
294    <td valign="top">apply a digital filter to enhance a noisy image</td>
295  </tr>
296
297  <tr>
298    <td valign="top"><a href="../www/command-line-options.html#extract" target="magick-options">-extract <em class="option">geometry</em></a></td>
299    <td valign="top">extract area from image</td>
300  </tr>
301
302  <tr>
303    <td valign="top"><a href="../www/command-line-options.html#filter" target="magick-options">-filter <em class="option">type</em></a></td>
304    <td valign="top">use this filter when resizing an image</td>
305  </tr>
306
307  <tr>
308    <td valign="top"><a href="../www/command-line-options.html#flatten" target="magick-options">-flatten</a></td>
309    <td valign="top">flatten a sequence of images</td>
310  </tr>
311
312  <tr>
313    <td valign="top"><a href="../www/command-line-options.html#flip" target="magick-options">-flip</a></td>
314    <td valign="top">flip image in the vertical direction</td>
315  </tr>
316
317  <tr>
318    <td valign="top"><a href="../www/command-line-options.html#flop" target="magick-options">-flop</a></td>
319    <td valign="top">flop image in the horizontal direction</td>
320  </tr>
321
322  <tr>
323    <td valign="top"><a href="../www/command-line-options.html#frame" target="magick-options">-frame <em class="option">geometry</em></a></td>
324    <td valign="top">surround image with an ornamental border</td>
325  </tr>
326
327  <tr>
328    <td valign="top"><a href="../www/command-line-options.html#fuzz" target="magick-options">-fuzz <em class="option">distance</em></a></td>
329    <td valign="top">colors within this distance are considered equal</td>
330  </tr>
331
332  <tr>
333    <td valign="top"><a href="../www/command-line-options.html#gamma" target="magick-options">-gamma <em class="option">value</em></a></td>
334    <td valign="top">level of gamma correction</td>
335  </tr>
336
337  <tr>
338    <td valign="top"><a href="../www/command-line-options.html#geometry" target="magick-options">-geometry <em class="option">geometry</em></a></td>
339    <td valign="top">preferred size or location of the image</td>
340  </tr>
341
342  <tr>
343    <td valign="top"><a href="../www/command-line-options.html#help" target="magick-options">-help</a></td>
344    <td valign="top">print program options</td>
345  </tr>
346
347  <tr>
348    <td valign="top"><a href="../www/command-line-options.html#identify" target="magick-options">-identify</a></td>
349    <td valign="top">identify the format and characteristics of the image</td>
350  </tr>
351
352  <tr>
353    <td valign="top"><a href="../www/command-line-options.html#immutable" target="magick-options">-immutable <em class="option">type</em></a></td>
354    <td valign="top">prohibit image edits</td>
355  </tr>
356
357  <tr>
358    <td valign="top"><a href="../www/command-line-options.html#interlace" target="magick-options">-interlace <em class="option">type</em></a></td>
359    <td valign="top">type of image interlacing scheme</td>
360  </tr>
361
362  <tr>
363    <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
364    <td valign="top">pixel color interpolation method</td>
365  </tr>
366
367  <tr>
368    <td valign="top"><a href="../www/command-line-options.html#label" target="magick-options">-label <em class="option">name</em></a></td>
369    <td valign="top">assign a label to an image</td>
370  </tr>
371
372  <tr>
373    <td valign="top"><a href="../www/command-line-options.html#limit" target="magick-options">-limit <em class="option">type value</em></a></td>
374    <td valign="top">pixel cache resource limit</td>
375  </tr>
376
377  <tr>
378    <td valign="top"><a href="../www/command-line-options.html#log" target="magick-options">-log <em class="option">format</em></a></td>
379    <td valign="top">format of debugging information</td>
380  </tr>
381
382  <tr>
383    <td valign="top"><a href="../www/command-line-options.html#map" target="magick-options">-map <em class="option">filename</em></a></td>
384    <td valign="top">transform image colors to match this set of colors</td>
385  </tr>
386
387  <tr>
388    <td valign="top"><a href="../www/command-line-options.html#mattecolor" target="magick-options">-mattecolor <em class="option">color</em></a></td>
389    <td valign="top">frame color</td>
390  </tr>
391
392  <tr>
393    <td valign="top"><a href="../www/command-line-options.html#monitor" target="magick-options">-monitor</a></td>
394    <td valign="top">monitor progress</td>
395  </tr>
396
397  <tr>
398    <td valign="top"><a href="../www/command-line-options.html#monochrome" target="magick-options">-monochrome</a></td>
399    <td valign="top">transform image to black and white</td>
400  </tr>
401
402  <tr>
403    <td valign="top"><a href="../www/command-line-options.html#negate" target="magick-options">-negate</a></td>
404    <td valign="top">replace every pixel with its complementary color </td>
405  </tr>
406
407  <tr>
408    <td valign="top"><a href="../www/command-line-options.html#page" target="magick-options">-page <em class="option">geometry</em></a></td>
409    <td valign="top">size and location of an image canvas (setting)</td>
410  </tr>
411
412  <tr>
413    <td valign="top"><a href="../www/command-line-options.html#profile" target="magick-options">-profile <em class="option">filename</em></a></td>
414    <td valign="top">add, delete, or apply an image profile</td>
415  </tr>
416
417  <tr>
418    <td valign="top"><a href="../www/command-line-options.html#quantize" target="magick-options">-quantize <em class="option">colorspace</em></a></td>
419    <td valign="top">reduce image colors in this colorspace</td>
420  </tr>
421
422  <tr>
423    <td valign="top"><a href="../www/command-line-options.html#quiet" target="magick-options">-quiet</a></td>
424    <td valign="top">suppress all warning messages</td>
425  </tr>
426
427  <tr>
428    <td valign="top"><a href="../www/command-line-options.html#raise" target="magick-options">-raise <em class="option">value</em></a></td>
429    <td valign="top">lighten/darken image edges to create a 3-D effect</td>
430  </tr>
431
432  <tr>
433    <td valign="top"><a href="../www/command-line-options.html#regard-warnings" target="magick-options">-regard-warnings</a></td>
434    <td valign="top">pay attention to warning messages.</td>
435  </tr>
436
437  <tr>
438    <td valign="top"><a href="../www/command-line-options.html#remote" target="magick-options">-remote <em class="option">command</em></a></td>
439    <td valign="top">execute a command in an remote display process</td>
440  </tr>
441
442  <tr>
443    <td valign="top"><a href="../www/command-line-options.html#resample" target="magick-options">-resample <em class="option">geometry</em></a></td>
444    <td valign="top">change the resolution of an image</td>
445  </tr>
446
447  <tr>
448    <td valign="top"><a href="../www/command-line-options.html#resize" target="magick-options">-resize <em class="option">geometry</em></a></td>
449    <td valign="top">resize the image</td>
450  </tr>
451
452  <tr>
453    <td valign="top"><a href="../www/command-line-options.html#respect-parenthesis" target="magick-options">-respect-parenthesis</a></td>
454    <td valign="top">settings remain in effect until parenthesis boundary.</td>
455  </tr>
456
457