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