root / ImageMagick / trunk / www / import.html

Revision 11927, 22.0 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: Import</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:, import, 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="1989728717"><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="1886936491"><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="116520182" 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="1610533666" 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://merchantwarehouse.com" class="sponsor" target="sponsor">Credit Card<br />Processing</a><!-- 200811010250 -->
79      <br />
80      <a href="http://www.brothersoft.com" class="sponsor" target="sponsor">Software Download</a><!-- 200809010200 -->
81      <br />
82      <a href="http://www.posters555.com" class="sponsor" target="sponsor">Poster</a><!-- 200903010800 -->
83      <br />
84      <a href="http://www.iceposter.com" class="sponsor" target="sponsor">Posters</a><!-- 200812010200 -->
85      <br />
86      <a href="http://meta-preisvergleich.de" class="sponsor" target="sponsor">Preisvergleich</a><!-- 200810010120 -->
87      <br />
88      <a href="http://www.hotel-erb.de"><img src="../images/bw_erb.gif" alt="[Munich Hotel]" width="110" height="40" border="0" name="Munich Hotel"/></a> <!-- 200809010160 -->
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>import</kbd> program to capture some or all of an X server screen and save the image to a file. See <a href="../www/command-line-processing.html">Command Line Processing</a> for advice on how to structure your <kbd>import</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>import</kbd> command here to illustrate its usefulness and ease of use.  To get started, lets import an image in the JPEG format:</p>
106
107<pre class="text">
108  import rose.jpg
109</pre>
110
111<p>To capture the entire X server screen in the Postscript image format:</p>
112
113<pre class="text">
114  import -window root screen.ps
115</pre>
116
117<p>You can find additional examples of using <kbd>import</kbd> in <a href="http://www-106.ibm.com/developerworks/library/l-graf/?ca=dnt-428" target="1716388404">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="685059030">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/" target="1390523133">Examples of ImageMagick Usage</a>.</p>
118
119<div style="margin: auto;">
120  <h2><a name="options"></a>Option Summary</h2>
121</div>
122
123<p>The <kbd>import</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
124
125<table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
126  <tbody>
127  <tr>
128    <th align="left">Option</th>
129    <th align="left">Description</th>
130  </tr>
131
132  <tr>
133    <td valign="top"><a href="../www/command-line-options.html#adjoin" target="magick-options">-adjoin</a></td>
134    <td valign="top">join images into a single multi-image file</td>
135  </tr> 
136
137  <tr>
138    <td valign="top"><a href="../www/command-line-options.html#annotate" target="magick-options">-annotate <em class="option">geometry text</em></a></td>
139    <td valign="top">annotate the image with text</td> 
140  </tr>
141
142  <tr>
143    <td valign="top"><a href="../www/command-line-options.html#border" target="magick-options">-border</a></td>
144    <td valign="top">include image borders in the output image</td>
145  </tr>
146
147  <tr>
148    <td valign="top"><a href="../www/command-line-options.html#channel" target="magick-options">-channel <em class="option">type</em></a></td>
149    <td valign="top">apply option to select image channels</td>
150  </tr>
151
152  <tr>
153    <td valign="top"><a href="../www/command-line-options.html#colors" target="magick-options">-colors <em class="option">value</em></a></td>
154    <td valign="top">preferred number of colors in the image</td>
155  </tr>
156
157  <tr>
158    <td valign="top"><a href="../www/command-line-options.html#colorspace" target="magick-options">-colorspace <em class="option">type</em></a></td>
159    <td valign="top">set image colorspace</td>
160  </tr>
161
162  <tr>
163    <td valign="top"><a href="../www/command-line-options.html#comment" target="magick-options">-comment <em class="option">string</em></a></td>
164    <td valign="top">annotate image with comment</td>
165  </tr>
166
167  <tr>
168    <td valign="top"><a href="../www/command-line-options.html#compress" target="magick-options">-compress <em class="option">type</em></a></td>
169    <td valign="top">image compression type</td>
170  </tr>
171
172  <tr>
173    <td valign="top"><a href="../www/command-line-options.html#contrast" target="magick-options">-contrast</a></td>
174    <td valign="top">enhance or reduce the image contrast</td>
175  </tr>
176
177  <tr>
178    <td valign="top"><a href="../www/command-line-options.html#crop" target="magick-options">-crop <em class="option">geometry</em></a></td>
179    <td valign="top">preferred size and location of the cropped image</td>
180  </tr>
181
182  <tr>
183    <td valign="top"><a href="../www/command-line-options.html#debug" target="magick-options">-debug <em class="option">events</em></a></td>
184    <td valign="top">import copious debugging information</td>
185  </tr>
186
187  <tr>
188    <td valign="top"><a href="../www/command-line-options.html#define" target="magick-options">-define <em class="option">format:option</em></a></td>
189    <td valign="top">define one or more image format options</td>
190  </tr>
191
192  <tr>
193    <td valign="top"><a href="../www/command-line-options.html#delay" target="magick-options">-delay <em class="option">value</em></a></td>
194    <td valign="top">import the next image after pausing</td>
195  </tr>
196
197  <tr>
198    <td valign="top"><a href="../www/command-line-options.html#density" target="magick-options">-density <em class="option">geometry</em></a></td>
199    <td valign="top">horizontal and vertical density of the image</td>
200  </tr>
201
202  <tr>
203    <td valign="top"><a href="../www/command-line-options.html#depth" target="magick-options">-depth <em class="option">value</em></a></td>
204    <td valign="top">image depth</td>
205  </tr>
206
207  <tr>
208    <td valign="top"><a href="../www/command-line-options.html#despeckle" target="magick-options">-descend</a></td>
209    <td valign="top">obtain image by descending window hierarchy</td>
210  </tr>
211
212  <tr>
213    <td valign="top"><a href="../www/command-line-options.html#display" target="magick-options">-display <em class="option">server</em></a></td>
214    <td valign="top">get image or font from this X server</td>
215  </tr>
216
217  <tr>
218    <td valign="top"><a href="../www/command-line-options.html#dispose" target="magick-options">-dispose <em class="option">method</em></a></td>
219    <td valign="top">layer disposal method</td>
220  </tr>
221
222  <tr>
223    <td valign="top"><a href="../www/command-line-options.html#dither" target="magick-options">-dither  <em class="option">method</em></a></td>
224    <td valign="top">apply error diffusion to image</td>
225  </tr>
226
227  <tr>
228    <td valign="top"><a href="../www/command-line-options.html#encipher" target="magick-options">-encipher <em class="option">filename</em></a></td>
229    <td valign="top">convert plain pixels to cipher pixels</td>
230  </tr>
231
232  <tr>
233    <td valign="top"><a href="../www/command-line-options.html#encoding" target="magick-options">-encoding <em class="option">type</em></a></td>
234    <td valign="top">text encoding type</td>
235  </tr>
236
237  <tr>
238    <td valign="top"><a href="../www/command-line-options.html#endian" target="magick-options">-endian <em class="option">type</em></a></td>
239    <td valign="top">endianness (MSB or LSB) of the image</td>
240  </tr>
241
242  <tr>
243    <td valign="top"><a href="../www/command-line-options.html#filter" target="magick-options">-filter <em class="option">type</em></a></td>
244    <td valign="top">use this filter when resizing an image</td>
245  </tr>
246
247  <tr>
248    <td valign="top"><a href="../www/command-line-options.html#frame" target="magick-options">-frame</a></td>
249    <td valign="top">include window manager frame</td>
250  </tr>
251
252  <tr>
253    <td valign="top"><a href="../www/command-line-options.html#geometry" target="magick-options">-geometry <em class="option">geometry</em></a></td>
254    <td valign="top">preferred size or location of the image</td>
255  </tr>
256
257  <tr>
258    <td valign="top"><a href="../www/command-line-options.html#gravity" target="magick-options">-gravity <em class="option">type</em></a></td>
259    <td valign="top">horizontal and vertical text placement</td>
260  </tr>
261
262  <tr>
263    <td valign="top"><a href="../www/command-line-options.html#help" target="magick-options">-help</a></td>
264    <td valign="top">print program options</td>
265  </tr>
266
267  <tr>
268    <td valign="top"><a href="../www/command-line-options.html#identify" target="magick-options">-identify</a></td>
269    <td valign="top">identify the format and characteristics of the image</td>
270  </tr>
271
272  <tr>
273    <td valign="top"><a href="../www/command-line-options.html#interlace" target="magick-options">-interlace <em class="option">type</em></a></td>
274    <td valign="top">type of image interlacing scheme</td>
275  </tr>
276
277  <tr>
278    <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
279    <td valign="top">pixel color interpolation method</td>
280  </tr>
281
282  <tr>
283    <td valign="top"><a href="../www/command-line-options.html#label" target="magick-options">-label <em class="option">name</em></a></td>
284    <td valign="top">assign a label to an image</td>
285  </tr>
286
287  <tr>
288    <td valign="top"><a href="../www/command-line-options.html#limit" target="magick-options">-limit <em class="option">type value</em></a></td>
289    <td valign="top">pixel cache resource limit</td>
290  </tr>
291
292  <tr>
293    <td valign="top"><a href="../www/command-line-options.html#log" target="magick-options">-log <em class="option">format</em></a></td>
294    <td valign="top">format of debugging information</td>
295  </tr>
296
297  <tr>
298    <td valign="top"><a href="../www/command-line-options.html#monitor" target="magick-options">-monitor</a></td>
299    <td valign="top">monitor progress</td>
300  </tr>
301
302  <tr>
303    <td valign="top"><a href="../www/command-line-options.html#monochrome" target="magick-options">-monochrome</a></td>
304    <td valign="top">transform image to black and white</td>
305  </tr>
306
307  <tr>
308    <td valign="top"><a href="../www/command-line-options.html#negate" target="magick-options">-negate</a></td>
309    <td valign="top">replace every pixel with its complementary color </td>
310  </tr>
311
312  <tr>
313    <td valign="top"><a href="../www/command-line-options.html#page" target="magick-options">-page <em class="option">geometry</em></a></td>
314    <td valign="top">size and location of an image canvas (setting)</td>
315  </tr>
316
317  <tr>
318    <td valign="top"><a href="../www/command-line-options.html#quality" target="magick-options">-quality <em class="option">value</em></a></td>
319    <td valign="top">JPEG/MIFF/PNG compression level</td>
320  </tr>
321
322  <tr>
323    <td valign="top"><a href="../www/command-line-options.html#quantize" target="magick-options">-quantize <em class="option">colorspace</em></a></td>
324    <td valign="top">reduce image colors in this colorspace</td>
325  </tr>
326
327  <tr>
328    <td valign="top"><a href="../www/command-line-options.html#quiet" target="magick-options">-quiet</a></td>
329    <td valign="top">suppress all warning messages</td>
330  </tr>
331
332  <tr>
333    <td valign="top"><a href="../www/command-line-options.html#quiet" target="magick-options">-quiet</a></td>
334    <td valign="top">suppress all warning messages</td>
335  </tr>
336
337  <tr>
338    <td valign="top"><a href="../www/command-line-options.html#regard-warnings" target="magick-options">-regard-warnings</a></td>
339    <td valign="top">pay attention to warning messages.</td>
340  </tr>
341
342  <tr>
343    <td valign="top"><a href="../www/command-line-options.html#repage" target="magick-options">-repage <em class="option">geometry</em></a></td>
344    <td valign="top">size and location of an image canvas</td>
345  </tr>
346
347  <tr>
348    <td valign="top"><a href="../www/command-line-options.html#resize" target="magick-options">-resize <em class="option">geometry</em></a></td>
349    <td valign="top">resize the image</td>
350  </tr>
351
352  <tr>
353    <td valign="top"><a href="../www/command-line-options.html#respect-parenthesis" target="magick-options">-respect-parenthesis</a></td>
354    <td valign="top">settings remain in effect until parenthesis boundary.</td>
355  </tr>
356
357  <tr>
358    <td valign="top"><a href="../www/command-line-options.html#rotate" target="magick-options">-rotate <em class="option">degrees</em></a></td>
359    <td valign="top">apply Paeth rotation to the image</td>
360  </tr>
361
362  <tr>
363    <td valign="top"><a href="../www/command-line-options.html#sampling-factor" target="magick-options">-sampling-factor <em class="option">geometry</em></a></td>
364    <td valign="top">horizontal and vertical sampling factor</td>
365  </tr>
366
367  <tr>
368    <td valign="top"><a href="../www/command-line-options.html#scene" target="magick-options">-scene <em class="option">value</em></a></td>
369    <td valign="top">image scene number</td>
370  </tr>
371
372  <tr>
373    <td valign="top"><a href="../www/command-line-options.html#screen" target="magick-options">-screen</a></td>
374    <td valign="top">select image from root window</td>
375  </tr>
376
377  <tr>
378    <td valign="top"><a href="../www/command-line-options.html#seed" target="magick-options">-seed <em class="option">value</em></a></td>
379    <td valign="top">seed a new sequence of pseudo-random numbers</td>
380  </tr>
381
382  <tr>
383    <td valign="top"><a href="../www/command-line-options.html#set" target="magick-options">-set <em class="option">attribute value</em></a></td>
384    <td valign="top">set an image attribute</td>
385  </tr>
386
387  <tr>
388    <td valign="top"><a href="../www/command-line-options.html#sharpen" target="magick-options">-silent</a></td>
389    <td valign="top">operate silently, i.e. don't ring any bells</td>
390  </tr>
391
392  <tr>
393    <td valign="top"><a href="../www/command-line-options.html#strip" target="magick-options">-strip</a></td>
394    <td valign="top">strip image of all profiles and comments</td>
395  </tr>
396
397  <tr>
398    <td valign="top"><a href="../www/command-line-options.html#transparent-color" target="magick-options">-transparent-color <em class="option">color</em></a></td>
399    <td valign="top">transparent color</td>
400  </tr>
401
402  <tr>
403    <td valign="top"><a href="../www/command-line-options.html#trim" target="magick-options">-trim</a></td>
404    <td valign="top">trim image edges</td>
405  </tr>
406
407  <tr>
408    <td valign="top"><a href="../www/command-line-options.html#update" target="magick-options">-type <em class="option">type</em></a></td>
409    <td valign="top">image type</td>
410  </tr>
411
412  <tr>
413    <td valign="top"><a href="../www/command-line-options.html#verbose" target="magick-options">-verbose</a></td>
414    <td valign="top">print detailed information about the image</td>
415  </tr>
416
417  <tr>
418    <td valign="top"><a href="../www/command-line-options.html#version" target="magick-options">-version</a></td>
419    <td valign="top">print version information</td>
420  </tr>
421
422  <tr>
423    <td valign="top"><a href="../www/command-line-options.html#virtual-pixel" target="magick-options">-virtual-pixel <em class="option">method</em></a></td>
424    <td valign="top">access method for pixels outside the boundaries of the image</td>
425  </tr>
426
427  <tr>
428    <td valign="top"><a href="../www/command-line-options.html#write" target="magick-options">-window <em class="option">id</em></a></td>
429    <td valign="top">select window with this id or name</td>
430  </tr>
431
432  </tbody>
433</table>
434      </td>
435      <td id="margin" width="1%" height="100%" valign="top" align="right">&nbsp;</td>
436    </tr>
437  </tbody>
438  </table>
439  <div id="linkbar">
440    <span id="linkbar-west">
441      <font size="-1">
442      <a href="http://www.downloadroute.com/" target="1933055849">Downloads and Opinions</a><!-- 200810010100 -->
443      </font>
444    </span>
445    <span id="linkbar-center">
446      <a href="http://www.imagemagick.org/discourse-server/" target="584855898">Discourse Server</a> &bull;
447      <a href="../www/mailing-list.html">Mailing Lists</a> &bull;
448      <a href="http://cafe.imagemagick.org" target="453903353">Cafe</a> &bull;
449    <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi" target="1375392148">Studio</a>
450    </span>
451  </div>
452  <div id="footer">
453    <span id="footer-west">&copy; 1999-2008 ImageMagick Studio LLC</span>
454  </div>
455  <div style="clear: both; margin: 0; width: 100%; "></div>
456</body>
457</html>