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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   2 <html lang="en">
   3 <head>
   4   <meta charset="utf-8">
   5   <meta http-equiv="X-UA-Compatible" content="IE=edge">
   6   <meta name="viewport" content="width=device-width, initial-scale=1">
   7   <title>ImageMagick: Command-line Tools: Import</title>
   8   <meta http-equiv="content-language" content="en-US">
   9   <meta http-equiv="content-type" content="text/html; charset=utf-8">
  10   <meta http-equiv="reply-to" content="magick-users@imagemagick.org">
  11   <meta name="application-name" content="ImageMagick">
  12   <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.">
  13   <meta name="application-url" content="http://www.imagemagick.org">
  14   <meta name="generator" content="PHP">
  15   <meta name="keywords" content="command-line, tools:, import, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert">
  16   <meta name="rating" content="GENERAL">
  17   <meta name="robots" content="INDEX, FOLLOW">
  18   <meta name="generator" content="ImageMagick Studio LLC">
  19   <meta name="author" content="ImageMagick Studio LLC">
  20   <meta name="revisit-after" content="2 DAYS">
  21   <meta name="resource-type" content="document">
  22   <meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC">
  23   <meta name="distribution" content="Global">
  24   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1">
  25   <link rel="icon" href="../images/wand.png">
  26   <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon">
  27   <link rel="stylesheet" href="css/bootstrap.min.css">
  28   <link rel="stylesheet" href="css/magick.css">
  29 </head>
  30
  31 <body>
  32 <div class="main">
  33 <div class="magick-masthead">
  34   <div class="container">
  35     <script type="text/javascript">
  36     <!--
  37       google_ad_client = "pub-3129977114552745";
  38       google_ad_slot = "5439289906";
  39       google_ad_width = 728;
  40       google_ad_height = 90;
  41     //-->
  42     </script>
  43     <center><script type="text/javascript" src="http://localhost/pagead/show_ads.js">
  44     </script></center>
  45     <nav class="magick-nav">
  46       <a class="magick-nav-item " href="../index.html">Home</a>
  47       <a class="magick-nav-item " href="binary-releases.html">Downloads</a>
  48       <a class="magick-nav-item " href="command-line-tools.html">Tools</a>
  49       <a class="magick-nav-item " href="command-line-options.html">Options</a>
  50       <a class="magick-nav-item " href="api.html">Development</a>
  51       <a class="magick-nav-item" href="http://www.imagemagick.org/discourse-server/">Community</a>
  52       <a class="magick-nav-item navbar-right " href="http://www.imagemagick.org/script/search.php">Search</a>
  53     </nav>
  54   </div>
  55 </div>
  56 <div class="container">
  57 <div class="magick-header">
  58 <p class="text-center"><a href="import.html#usage">Example Usage</a> • <a href="import.html#options">Option Summary</a></p>
  59
  60 <p class="lead magick-description">Use the <code>import</code> program to capture some or all of an X server screen and save the image to a file. See <a href="command-line-processing.html">Command Line Processing</a> for advice on how to structure your <code>import</code> command or see below for example usages of the command.</p>
  61
  62 <h2 class="magick-header"><a id="usage"></a>Example Usage</h2>
  63
  64 <p>We list a few examples of the <code>import</code> command here to illustrate its usefulness and ease of use.  To get started, lets import an image in the JPEG format:</p>
  65
  66 <pre>
  67 import rose.jpg
  68 </pre>
  69
  70 <p>To capture the entire X server screen in the Postscript image format:</p>
  71
  72 <pre>
  73 import -window root screen.ps
  74 </pre>
  75
  76 <p>You can find additional examples of using <code>import</code> in <a href="http://www.ibm.com/developerworks/library/l-graf/?ca=dnt-428">Graphics from the Command Line</a>.  Further discussion is available in  <a href="http://www.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>
  77
  78
  79 <h2 class="magick-header"><a id="options"></a>Option Summary</h2>
  80
  81 <p>The <code>import</code> command recognizes these options.  Click on an option to get more details about how that option works.</p>
  82
  83 <table class="table table-condensed table-striped">
  84   <tbody>
  85   <tr>
  86     <th align="left">Option</th>
  87     <th align="left">Description</th>
  88   </tr>
  89
  90   <tr>
  91     <td><a href="command-line-options.html#adjoin">-adjoin</a></td>
  92     <td>join images into a single multi-image file</td>
  93   </tr>
  94
  95   <tr>
  96     <td><a href="command-line-options.html#annotate">-annotate <var>geometry text</var></a></td>
  97     <td>annotate the image with text</td>
  98   </tr>
  99
 100   <tr>
 101     <td><a href="command-line-options.html#border">-border</a></td>
 102     <td>include window border in the output image</td>
 103   </tr>
 104
 105   <tr>
 106     <td><a href="command-line-options.html#channel">-channel <var>type</var></a></td>
 107     <td>apply option to select image channels</td>
 108   </tr>
 109
 110   <tr>
 111     <td><a href="command-line-options.html#colors">-colors <var>value</var></a></td>
 112     <td>preferred number of colors in the image</td>
 113   </tr>
 114
 115   <tr>
 116     <td><a href="command-line-options.html#colorspace">-colorspace <var>type</var></a></td>
 117     <td>set image colorspace</td>
 118   </tr>
 119
 120   <tr>
 121     <td><a href="command-line-options.html#comment">-comment <var>string</var></a></td>
 122     <td>annotate image with comment</td>
 123   </tr>
 124
 125   <tr>
 126     <td><a href="command-line-options.html#compress">-compress <var>type</var></a></td>
 127     <td>image compression type</td>
 128   </tr>
 129
 130   <tr>
 131     <td><a href="command-line-options.html#contrast">-contrast</a></td>
 132     <td>enhance or reduce the image contrast</td>
 133   </tr>
 134
 135   <tr>
 136     <td><a href="command-line-options.html#crop">-crop <var>geometry</var></a></td>
 137     <td>preferred size and location of the cropped image</td>
 138   </tr>
 139
 140   <tr>
 141     <td><a href="command-line-options.html#debug">-debug <var>events</var></a></td>
 142     <td>import copious debugging information</td>
 143   </tr>
 144
 145   <tr>
 146     <td><a href="command-line-options.html#define">-define <var>format:option</var></a></td>
 147     <td>define one or more image format options</td>
 148   </tr>
 149
 150   <tr>
 151     <td><a href="command-line-options.html#delay">-delay <var>value</var></a></td>
 152     <td>import the next image after pausing</td>
 153   </tr>
 154
 155   <tr>
 156     <td><a href="command-line-options.html#density">-density <var>geometry</var></a></td>
 157     <td>horizontal and vertical density of the image</td>
 158   </tr>
 159
 160   <tr>
 161     <td><a href="command-line-options.html#depth">-depth <var>value</var></a></td>
 162     <td>image depth</td>
 163   </tr>
 164
 165   <tr>
 166     <td><a href="command-line-options.html#despeckle">-descend</a></td>
 167     <td>obtain image by descending window hierarchy</td>
 168   </tr>
 169
 170   <tr>
 171     <td><a href="command-line-options.html#display">-display <var>server</var></a></td>
 172     <td>get image or font from this X server</td>
 173   </tr>
 174
 175   <tr>
 176     <td><a href="command-line-options.html#dispose">-dispose <var>method</var></a></td>
 177     <td>layer disposal method</td>
 178   </tr>
 179
 180   <tr>
 181     <td><a href="command-line-options.html#dither">-dither  <var>method</var></a></td>
 182     <td>apply error diffusion to image</td>
 183   </tr>
 184
 185   <tr>
 186     <td><a href="command-line-options.html#encipher">-encipher <var>filename</var></a></td>
 187     <td>convert plain pixels to cipher pixels</td>
 188   </tr>
 189
 190   <tr>
 191     <td><a href="command-line-options.html#encoding">-encoding <var>type</var></a></td>
 192     <td>text encoding type</td>
 193   </tr>
 194
 195   <tr>
 196     <td><a href="command-line-options.html#endian">-endian <var>type</var></a></td>
 197     <td>endianness (MSB or LSB) of the image</td>
 198   </tr>
 199
 200   <tr>
 201     <td><a href="command-line-options.html#filter">-filter <var>type</var></a></td>
 202     <td>use this filter when resizing an image</td>
 203   </tr>
 204
 205   <tr>
 206     <td><a href="command-line-options.html#frame">-frame</a></td>
 207     <td>include window manager frame</td>
 208   </tr>
 209
 210   <tr>
 211     <td><a href="command-line-options.html#geometry">-geometry <var>geometry</var></a></td>
 212     <td>preferred size or location of the image</td>
 213   </tr>
 214
 215   <tr>
 216     <td><a href="command-line-options.html#gravity">-gravity <var>type</var></a></td>
 217     <td>horizontal and vertical text placement</td>
 218   </tr>
 219
 220   <tr>
 221     <td><a href="command-line-options.html#help">-help</a></td>
 222     <td>print program options</td>
 223   </tr>
 224
 225   <tr>
 226     <td><a href="command-line-options.html#identify">-identify</a></td>
 227     <td>identify the format and characteristics of the image</td>
 228   </tr>
 229
 230   <tr>
 231     <td><a href="command-line-options.html#interlace">-interlace <var>type</var></a></td>
 232     <td>type of image interlacing scheme</td>
 233   </tr>
 234
 235   <tr>
 236     <td><a href="command-line-options.html#interpolate">-interpolate <var>method</var></a></td>
 237     <td>pixel color interpolation method</td>
 238   </tr>
 239
 240   <tr>
 241     <td><a href="command-line-options.html#label">-label <var>name</var></a></td>
 242     <td>assign a label to an image</td>
 243   </tr>
 244
 245   <tr>
 246     <td><a href="command-line-options.html#limit">-limit <var>type value</var></a></td>
 247     <td>pixel cache resource limit</td>
 248   </tr>
 249
 250   <tr>
 251     <td><a href="command-line-options.html#log">-log <var>format</var></a></td>
 252     <td>format of debugging information</td>
 253   </tr>
 254
 255   <tr>
 256     <td><a href="command-line-options.html#monitor">-monitor</a></td>
 257     <td>monitor progress</td>
 258   </tr>
 259
 260   <tr>
 261     <td><a href="command-line-options.html#monochrome">-monochrome</a></td>
 262     <td>transform image to black and white</td>
 263   </tr>
 264
 265   <tr>
 266     <td><a href="command-line-options.html#negate">-negate</a></td>
 267     <td>replace each pixel with its complementary color </td>
 268   </tr>
 269
 270   <tr>
 271     <td><a href="command-line-options.html#page">-page <var>geometry</var></a></td>
 272     <td>size and location of an image canvas (setting)</td>
 273   </tr>
 274
 275   <tr>
 276     <td><a href="command-line-options.html#pause">-pause <var>seconds</var></a></td>
 277     <td>seconds delay between snapshots</td>
 278   </tr>
 279
 280   <tr>
 281     <td><a href="command-line-options.html#quality">-quality <var>value</var></a></td>
 282     <td>JPEG/MIFF/PNG compression level</td>
 283   </tr>
 284
 285   <tr>
 286     <td><a href="command-line-options.html#quantize">-quantize <var>colorspace</var></a></td>
 287     <td>reduce image colors in this colorspace</td>
 288   </tr>
 289
 290   <tr>
 291     <td><a href="command-line-options.html#quiet">-quiet</a></td>
 292     <td>suppress all warning messages</td>
 293   </tr>
 294
 295   <tr>
 296     <td><a href="command-line-options.html#quiet">-quiet</a></td>
 297     <td>suppress all warning messages</td>
 298   </tr>
 299
 300   <tr>
 301     <td><a href="command-line-options.html#regard-warnings">-regard-warnings</a></td>
 302     <td>pay attention to warning messages.</td>
 303   </tr>
 304
 305   <tr>
 306     <td><a href="command-line-options.html#repage">-repage <var>geometry</var></a></td>
 307     <td>size and location of an image canvas</td>
 308   </tr>
 309
 310   <tr>
 311     <td><a href="command-line-options.html#resize">-resize <var>geometry</var></a></td>
 312     <td>resize the image</td>
 313   </tr>
 314
 315   <tr>
 316     <td><a href="command-line-options.html#respect-parentheses">-respect-parentheses</a></td>
 317     <td>settings remain in effect until parenthesis boundary.</td>
 318   </tr>
 319
 320   <tr>
 321     <td><a href="command-line-options.html#rotate">-rotate <var>degrees</var></a></td>
 322     <td>apply Paeth rotation to the image</td>
 323   </tr>
 324
 325   <tr>
 326     <td><a href="command-line-options.html#sampling-factor">-sampling-factor <var>geometry</var></a></td>
 327     <td>horizontal and vertical sampling factor</td>
 328   </tr>
 329
 330   <tr>
 331     <td><a href="command-line-options.html#scene">-scene <var>value</var></a></td>
 332     <td>image scene number</td>
 333   </tr>
 334
 335   <tr>
 336     <td><a href="command-line-options.html#screen">-screen</a></td>
 337     <td>select image from root window</td>
 338   </tr>
 339
 340   <tr>
 341     <td><a href="command-line-options.html#seed">-seed <var>value</var></a></td>
 342     <td>seed a new sequence of pseudo-random numbers</td>
 343   </tr>
 344
 345   <tr>
 346     <td><a href="command-line-options.html#set">-set <var>attribute value</var></a></td>
 347     <td>set an image attribute</td>
 348   </tr>
 349
 350   <tr>
 351     <td><a href="command-line-options.html#sharpen">-silent</a></td>
 352     <td>operate silently, i.e. don't ring any bells</td>
 353   </tr>
 354
 355   <tr>
 356     <td><a href="command-line-options.html#strip">-strip</a></td>
 357     <td>strip image of all profiles and comments</td>
 358   </tr>
 359
 360   <tr>
 361     <td><a href="command-line-options.html#synchronize">-synchronize</a></td>
 362     <td>synchronize image to storage device</td>
 363   </tr>
 364
 365   <tr>
 366     <td><a href="command-line-options.html#taint">-taint</a></td>
 367     <td>mark the image as modified</td>
 368   </tr>
 369
 370   <tr>
 371     <td><a href="command-line-options.html#transparent-color">-transparent-color <var>color</var></a></td>
 372     <td>transparent color</td>
 373   </tr>
 374
 375   <tr>
 376     <td><a href="command-line-options.html#trim">-trim</a></td>
 377     <td>trim image edges</td>
 378   </tr>
 379
 380   <tr>
 381     <td><a href="command-line-options.html#update">-type <var>type</var></a></td>
 382     <td>image type</td>
 383   </tr>
 384
 385   <tr>
 386     <td><a href="command-line-options.html#verbose">-verbose</a></td>
 387     <td>print detailed information about the image</td>
 388   </tr>
 389
 390   <tr>
 391     <td><a href="command-line-options.html#version">-version</a></td>
 392     <td>print version information</td>
 393   </tr>
 394
 395   <tr>
 396     <td><a href="command-line-options.html#virtual-pixel">-virtual-pixel <var>method</var></a></td>
 397     <td>access method for pixels outside the boundaries of the image</td>
 398   </tr>
 399
 400   <tr>
 401     <td><a href="command-line-options.html#write">-window <var>id</var></a></td>
 402     <td>select window with this id or name</td>
 403   </tr>
 404
 405   </tbody>
 406 </table>
 407
 408 </div>
 409   <footer class="magick-footer">
 410     <div class="magick-nav-item navbar-left">
 411       <a href="support.html">Donate</a>
 412     </div>
 413     <p><a href="sitemap.html">Sitemap</a> •
 414     <a href="links.html">Related</a> •
 415     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Image Studio</a> •
 416     <a href="http://jqmagick.imagemagick.org/">JqMagick</a> •
 417     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a>
 418 </p>
 419     <p><a href="import.html#">Back to top</a> •
 420     <a href="http://www.imagemagick.org/script/contact.php">Contact Us</a></p>
 421     <p class="small">©  1999-2015 ImageMagick Studio LLC</p>
 422   </footer>
 423 </div><!-- /.container -->
 424
 425   <script src="https://localhost/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
 426   <script src="../js/bootstrap.min.js"></script>
 427   <script type="text/javascript">
 428     /*  */
 429     (function() {
 430         var s = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
 431         s.type = 'text/javascript';
 432         s.async = true;
 433         s.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
 434         t.parentNode.insertBefore(s, t);
 435     })();
 436     /*  */
 437   </script>
 438 </div>
 439 </body>
 440 </html>