granicus.if.org Git - imagemagick/blob - www/import.html

   1 \r
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
   5 <head>\r
   6   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   7   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   8   <style type="text/css" media="screen,projection"><!--\r
   9     @import url("../www/magick.css");\r
  10   --></style>\r
  11   <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  12   <title>ImageMagick: Command-line Tools: Import</title>
  13   <meta http-equiv="Content-Language" content="en-US"/>
  14   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  15   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  16   <meta name="Generator" content="PHP"/>
  17   <meta name="Keywords" content="command-line, tools:, import, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  18   <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."/>
  19   <meta name="Rating" content="GENERAL"/>
  20   <meta name="Robots" content="INDEX, FOLLOW"/>
  21   <meta name="Generator" content="ImageMagick Studio LLC"/>
  22   <meta name="Author" content="ImageMagick Studio LLC"/>
  23   <meta name="Revisit-after" content="2 DAYS"/>
  24   <meta name="Resource-type" content="document"/>
  25   <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
  26   <meta name="Distribution" content="Global"/>
  27 </head>\r
  28 \r
  29 <body id="www-imagemagick-org">\r
  30 <div class="titlebar">\r
  31 <a href="../index.html">\r
  32   <img src="../images/script.png" alt="[ImageMagick]"\r
  33   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  34 <a href="http://www.networkredux.com">\r
  35   <img src="../images/networkredux.png" alt="[sponsor]"\r
  36   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  37 <a href="http://www.imagemagick.org/discourse-server/">\r
  38   <img src="../images/logo.jpg" alt=""\r
  39   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  40 <a href="../index.html">\r
  41   <img src="../images/sprite.jpg" alt=""\r
  42   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  43 </div>\r
  44 \r
  45 <div class="eastbar">\r
  46 \r
  47 <div class="menu">
  48   <a href="../index.html">About ImageMagick</a>
  49 </div>
  50 <div class="sep"></div>\r
  51 <div class="menu">
  52   <a href="../www/command-line-tools.html">Command-line Tools</a>
  53 </div>
  54 <div class="sub">
  55     <a href="../www/command-line-processing.html">Processing</a>
  56 </div>
  57 <div class="sub">
  58     <a href="../www/command-line-options.html">Options</a>
  59 </div>
  60 <div class="sub">
  61     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  62 </div>
  63 <div class="menu">
  64   <a href="../www/api.html">Program Interfaces</a>
  65 </div>
  66 <div class="sub">
  67     <a href="../www/magick-wand.html">MagickWand</a>
  68 </div>
  69 <div class="sub">
  70     <a href="../www/magick-core.html">MagickCore</a>
  71 </div>
  72 <div class="sub">
  73     <a href="../www/perl-magick.html">PerlMagick</a>
  74 </div>
  75 <div class="sub">
  76     <a href="../Magick++/">Magick++</a>
  77 </div>
  78 <div class="menu">
  79   <a href="../www/architecture.html">Architecture</a>
  80 </div>
  81 <div class="sep"></div>\r
  82 <div  class="menu">
  83    <a href="../www/install-source.html">Install from Source</a>
  84 </div>
  85 <div class="sub">
  86     <a href="../www/install-source.html#unix">Unix</a>
  87 </div>
  88 <div class="sub">
  89     <a href="../www/install-source.html#windows">Windows</a>
  90  </div>
  91 <div class="menu">
  92   <a href="../www/binary-releases.html">Binary Releases</a>
  93 </div>
  94 <div class="sub">
  95     <a href="../www/binary-releases.html#unix">Unix</a>
  96 </div>
  97 <div class="sub">
  98     <a href="../www/binary-releases.html#macosx">Mac OS X</a>
  99 </div>
 100 <div class="sub">
 101     <a href="../www/binary-releases.html#windows">Windows</a>
 102 </div>
 103 <div class="menu">
 104   <a href="../www/resources.html">Resources</a>
 105 </div>
 106 <div class="sep"></div>\r
 107 <div class="menu">
 108   <a href="../www/download.html">Download</a>
 109 </div>
 110 <div class="sep"></div>\r
 111 <div class="menu">
 112   <a href="http://www.imagemagick.org/script/search.php">Search</a>
 113 </div>
 114 <div class="sep"></div>\r
 115 <div class="menu">
 116   <a href="../www/sitemap.html">Site Map</a>
 117 </div>
 118 <div  class="sub">
 119     <a href="../www/links.html">Links</a>
 120 </div>
 121 <div class="sep"></div>\r
 122 <div  class="menu">
 123   <a href="../www/sponsors.html">Sponsors:</a>
 124
 125 <div class="sponsbox">
 126 <div  class="sponsor">
 127    <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 128 </div>
 129 <div  class="sponsor">
 130    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 131 </div>
 132 <div  class="sponsor">
 133   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 134 </div>
 135 <div  class="sponsor">
 136   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 137 </div>
 138 <div  class="sponsor">
 139   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 140 </div>
 141 <div  class="sponsor">
 142   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
 143 </div>
 144 </div>
 145 </div>
 146 \r
 147 \r
 148 </div>\r
 149 \r
 150 <div class="main">\r
 151 \r
 152 <p class="navigation-index">[<a href="#usage">Example Usage</a> &bull; <a href="#options">Option Summary</a>]</p>
 153
 154 <div class="doc-section">
 155 <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>
 156 </div>
 157
 158 <h2><a name="usage"></a>Example Usage</h2>
 159 <div class="doc-section">
 160
 161 <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>
 162
 163 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>import rose.jpg</span></p>
 164 <p>To capture the entire X server screen in the Postscript image format:</p>
 165
 166 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>import -window root screen.ps</span></p>
 167 <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">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">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a>.</p>
 168
 169 </div>
 170
 171 <h2><a name="options"></a>Option Summary</h2>
 172 <div class="doc-section">
 173
 174 <p>The <kbd>import</kbd> command recognizes these options.  Click on an option to get more details about how that option works.</p>
 175
 176 <table class="doc">
 177   <tbody>
 178   <tr>
 179     <th align="left">Option</th>
 180     <th align="left">Description</th>
 181   </tr>
 182
 183   <tr>
 184     <td valign="top"><a href="../www/command-line-options.html#adjoin">-adjoin</a></td>
 185     <td valign="top">join images into a single multi-image file</td>
 186   </tr>
 187
 188   <tr>
 189     <td valign="top"><a href="../www/command-line-options.html#annotate">-annotate <em class="option">geometry text</em></a></td>
 190     <td valign="top">annotate the image with text</td>
 191   </tr>
 192
 193   <tr>
 194     <td valign="top"><a href="../www/command-line-options.html#border">-border</a></td>
 195     <td valign="top">include image borders in the output image</td>
 196   </tr>
 197
 198   <tr>
 199     <td valign="top"><a href="../www/command-line-options.html#channel">-channel <em class="option">type</em></a></td>
 200     <td valign="top">apply option to select image channels</td>
 201   </tr>
 202
 203   <tr>
 204     <td valign="top"><a href="../www/command-line-options.html#colors">-colors <em class="option">value</em></a></td>
 205     <td valign="top">preferred number of colors in the image</td>
 206   </tr>
 207
 208   <tr>
 209     <td valign="top"><a href="../www/command-line-options.html#colorspace">-colorspace <em class="option">type</em></a></td>
 210     <td valign="top">set image colorspace</td>
 211   </tr>
 212
 213   <tr>
 214     <td valign="top"><a href="../www/command-line-options.html#comment">-comment <em class="option">string</em></a></td>
 215     <td valign="top">annotate image with comment</td>
 216   </tr>
 217
 218   <tr>
 219     <td valign="top"><a href="../www/command-line-options.html#compress">-compress <em class="option">type</em></a></td>
 220     <td valign="top">image compression type</td>
 221   </tr>
 222
 223   <tr>
 224     <td valign="top"><a href="../www/command-line-options.html#contrast">-contrast</a></td>
 225     <td valign="top">enhance or reduce the image contrast</td>
 226   </tr>
 227
 228   <tr>
 229     <td valign="top"><a href="../www/command-line-options.html#crop">-crop <em class="option">geometry</em></a></td>
 230     <td valign="top">preferred size and location of the cropped image</td>
 231   </tr>
 232
 233   <tr>
 234     <td valign="top"><a href="../www/command-line-options.html#debug">-debug <em class="option">events</em></a></td>
 235     <td valign="top">import copious debugging information</td>
 236   </tr>
 237
 238   <tr>
 239     <td valign="top"><a href="../www/command-line-options.html#define">-define <em class="option">format:option</em></a></td>
 240     <td valign="top">define one or more image format options</td>
 241   </tr>
 242
 243   <tr>
 244     <td valign="top"><a href="../www/command-line-options.html#delay">-delay <em class="option">value</em></a></td>
 245     <td valign="top">import the next image after pausing</td>
 246   </tr>
 247
 248   <tr>
 249     <td valign="top"><a href="../www/command-line-options.html#density">-density <em class="option">geometry</em></a></td>
 250     <td valign="top">horizontal and vertical density of the image</td>
 251   </tr>
 252
 253   <tr>
 254     <td valign="top"><a href="../www/command-line-options.html#depth">-depth <em class="option">value</em></a></td>
 255     <td valign="top">image depth</td>
 256   </tr>
 257
 258   <tr>
 259     <td valign="top"><a href="../www/command-line-options.html#despeckle">-descend</a></td>
 260     <td valign="top">obtain image by descending window hierarchy</td>
 261   </tr>
 262
 263   <tr>
 264     <td valign="top"><a href="../www/command-line-options.html#display">-display <em class="option">server</em></a></td>
 265     <td valign="top">get image or font from this X server</td>
 266   </tr>
 267
 268   <tr>
 269     <td valign="top"><a href="../www/command-line-options.html#dispose">-dispose <em class="option">method</em></a></td>
 270     <td valign="top">layer disposal method</td>
 271   </tr>
 272
 273   <tr>
 274     <td valign="top"><a href="../www/command-line-options.html#dither">-dither  <em class="option">method</em></a></td>
 275     <td valign="top">apply error diffusion to image</td>
 276   </tr>
 277
 278   <tr>
 279     <td valign="top"><a href="../www/command-line-options.html#encipher">-encipher <em class="option">filename</em></a></td>
 280     <td valign="top">convert plain pixels to cipher pixels</td>
 281   </tr>
 282
 283   <tr>
 284     <td valign="top"><a href="../www/command-line-options.html#encoding">-encoding <em class="option">type</em></a></td>
 285     <td valign="top">text encoding type</td>
 286   </tr>
 287
 288   <tr>
 289     <td valign="top"><a href="../www/command-line-options.html#endian">-endian <em class="option">type</em></a></td>
 290     <td valign="top">endianness (MSB or LSB) of the image</td>
 291   </tr>
 292
 293   <tr>
 294     <td valign="top"><a href="../www/command-line-options.html#filter">-filter <em class="option">type</em></a></td>
 295     <td valign="top">use this filter when resizing an image</td>
 296   </tr>
 297
 298   <tr>
 299     <td valign="top"><a href="../www/command-line-options.html#frame">-frame</a></td>
 300     <td valign="top">include window manager frame</td>
 301   </tr>
 302
 303   <tr>
 304     <td valign="top"><a href="../www/command-line-options.html#geometry">-geometry <em class="option">geometry</em></a></td>
 305     <td valign="top">preferred size or location of the image</td>
 306   </tr>
 307
 308   <tr>
 309     <td valign="top"><a href="../www/command-line-options.html#gravity">-gravity <em class="option">type</em></a></td>
 310     <td valign="top">horizontal and vertical text placement</td>
 311   </tr>
 312
 313   <tr>
 314     <td valign="top"><a href="../www/command-line-options.html#help">-help</a></td>
 315     <td valign="top">print program options</td>
 316   </tr>
 317
 318   <tr>
 319     <td valign="top"><a href="../www/command-line-options.html#identify">-identify</a></td>
 320     <td valign="top">identify the format and characteristics of the image</td>
 321   </tr>
 322
 323   <tr>
 324     <td valign="top"><a href="../www/command-line-options.html#interlace">-interlace <em class="option">type</em></a></td>
 325     <td valign="top">type of image interlacing scheme</td>
 326   </tr>
 327
 328   <tr>
 329     <td valign="top"><a href="../www/command-line-options.html#interpolate">-interpolate <em class="option">method</em></a></td>
 330     <td valign="top">pixel color interpolation method</td>
 331   </tr>
 332
 333   <tr>
 334     <td valign="top"><a href="../www/command-line-options.html#label">-label <em class="option">name</em></a></td>
 335     <td valign="top">assign a label to an image</td>
 336   </tr>
 337
 338   <tr>
 339     <td valign="top"><a href="../www/command-line-options.html#limit">-limit <em class="option">type value</em></a></td>
 340     <td valign="top">pixel cache resource limit</td>
 341   </tr>
 342
 343   <tr>
 344     <td valign="top"><a href="../www/command-line-options.html#log">-log <em class="option">format</em></a></td>
 345     <td valign="top">format of debugging information</td>
 346   </tr>
 347
 348   <tr>
 349     <td valign="top"><a href="../www/command-line-options.html#monitor">-monitor</a></td>
 350     <td valign="top">monitor progress</td>
 351   </tr>
 352
 353   <tr>
 354     <td valign="top"><a href="../www/command-line-options.html#monochrome">-monochrome</a></td>
 355     <td valign="top">transform image to black and white</td>
 356   </tr>
 357
 358   <tr>
 359     <td valign="top"><a href="../www/command-line-options.html#negate">-negate</a></td>
 360     <td valign="top">replace every pixel with its complementary color </td>
 361   </tr>
 362
 363   <tr>
 364     <td valign="top"><a href="../www/command-line-options.html#page">-page <em class="option">geometry</em></a></td>
 365     <td valign="top">size and location of an image canvas (setting)</td>
 366   </tr>
 367
 368   <tr>
 369     <td valign="top"><a href="../www/command-line-options.html#quality">-quality <em class="option">value</em></a></td>
 370     <td valign="top">JPEG/MIFF/PNG compression level</td>
 371   </tr>
 372
 373   <tr>
 374     <td valign="top"><a href="../www/command-line-options.html#quantize">-quantize <em class="option">colorspace</em></a></td>
 375     <td valign="top">reduce image colors in this colorspace</td>
 376   </tr>
 377
 378   <tr>
 379     <td valign="top"><a href="../www/command-line-options.html#quiet">-quiet</a></td>
 380     <td valign="top">suppress all warning messages</td>
 381   </tr>
 382
 383   <tr>
 384     <td valign="top"><a href="../www/command-line-options.html#quiet">-quiet</a></td>
 385     <td valign="top">suppress all warning messages</td>
 386   </tr>
 387
 388   <tr>
 389     <td valign="top"><a href="../www/command-line-options.html#regard-warnings">-regard-warnings</a></td>
 390     <td valign="top">pay attention to warning messages.</td>
 391   </tr>
 392
 393   <tr>
 394     <td valign="top"><a href="../www/command-line-options.html#repage">-repage <em class="option">geometry</em></a></td>
 395     <td valign="top">size and location of an image canvas</td>
 396   </tr>
 397
 398   <tr>
 399     <td valign="top"><a href="../www/command-line-options.html#resize">-resize <em class="option">geometry</em></a></td>
 400     <td valign="top">resize the image</td>
 401   </tr>
 402
 403   <tr>
 404     <td valign="top"><a href="../www/command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
 405     <td valign="top">settings remain in effect until parenthesis boundary.</td>
 406   </tr>
 407
 408   <tr>
 409     <td valign="top"><a href="../www/command-line-options.html#rotate">-rotate <em class="option">degrees</em></a></td>
 410     <td valign="top">apply Paeth rotation to the image</td>
 411   </tr>
 412
 413   <tr>
 414     <td valign="top"><a href="../www/command-line-options.html#sampling-factor">-sampling-factor <em class="option">geometry</em></a></td>
 415     <td valign="top">horizontal and vertical sampling factor</td>
 416   </tr>
 417
 418   <tr>
 419     <td valign="top"><a href="../www/command-line-options.html#scene">-scene <em class="option">value</em></a></td>
 420     <td valign="top">image scene number</td>
 421   </tr>
 422
 423   <tr>
 424     <td valign="top"><a href="../www/command-line-options.html#screen">-screen</a></td>
 425     <td valign="top">select image from root window</td>
 426   </tr>
 427
 428   <tr>
 429     <td valign="top"><a href="../www/command-line-options.html#seed">-seed <em class="option">value</em></a></td>
 430     <td valign="top">seed a new sequence of pseudo-random numbers</td>
 431   </tr>
 432
 433   <tr>
 434     <td valign="top"><a href="../www/command-line-options.html#set">-set <em class="option">attribute value</em></a></td>
 435     <td valign="top">set an image attribute</td>
 436   </tr>
 437
 438   <tr>
 439     <td valign="top"><a href="../www/command-line-options.html#sharpen">-silent</a></td>
 440     <td valign="top">operate silently, i.e. don't ring any bells</td>
 441   </tr>
 442
 443   <tr>
 444     <td valign="top"><a href="../www/command-line-options.html#strip">-strip</a></td>
 445     <td valign="top">strip image of all profiles and comments</td>
 446   </tr>
 447
 448   <tr>
 449     <td valign="top"><a href="../www/command-line-options.html#transparent-color">-transparent-color <em class="option">color</em></a></td>
 450     <td valign="top">transparent color</td>
 451   </tr>
 452
 453   <tr>
 454     <td valign="top"><a href="../www/command-line-options.html#trim">-trim</a></td>
 455     <td valign="top">trim image edges</td>
 456   </tr>
 457
 458   <tr>
 459     <td valign="top"><a href="../www/command-line-options.html#update">-type <em class="option">type</em></a></td>
 460     <td valign="top">image type</td>
 461   </tr>
 462
 463   <tr>
 464     <td valign="top"><a href="../www/command-line-options.html#verbose">-verbose</a></td>
 465     <td valign="top">print detailed information about the image</td>
 466   </tr>
 467
 468   <tr>
 469     <td valign="top"><a href="../www/command-line-options.html#version">-version</a></td>
 470     <td valign="top">print version information</td>
 471   </tr>
 472
 473   <tr>
 474     <td valign="top"><a href="../www/command-line-options.html#virtual-pixel">-virtual-pixel <em class="option">method</em></a></td>
 475     <td valign="top">access method for pixels outside the boundaries of the image</td>
 476   </tr>
 477
 478   <tr>
 479     <td valign="top"><a href="../www/command-line-options.html#write">-window <em class="option">id</em></a></td>
 480     <td valign="top">select window with this id or name</td>
 481   </tr>
 482
 483   </tbody>
 484 </table>
 485
 486 </div>
 487 \r
 488 </div>\r
 489 \r
 490 <div id="linkbar">\r
 491  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 492     <span id="linkbar-center">\r
 493       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 494       <a href="../www/mailing-list.html">Mailing Lists</a> &bull;\r
 495     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 496     </span>\r
 497     <span id="linkbar-east">&nbsp;</span>\r
 498   </div>\r
 499   <div class="footer">\r
 500     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
 501     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 502   </div>\r
 503   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 504 </body>\r
 505 </html>\r