man pages section 1: User Commands

Exit Print View

Updated: July 2014

import (1)


import - saves any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.


import [options] output-file


User Commands                                           import(1)

     import - saves any visible window on an X server and outputs
     it as an image file. You can capture a  single  window,  the
     entire screen, or any rectangular portion of the screen.

     import [options] output-file

     The  import  program is a member of the ImageMagick(1) suite
     of tools.  Use it to capture some or  all  of  an  X  server
     screen and save the image to a file.

     For  more  information  about the import command, point your
     browser          to          file:///usr/share/doc/ImageMag-
     ick-6.8.3/www/import.html       or      http://www.imagemag-

     Image Settings:
       -adjoin              join images into a single multi-image
       -border               include  window border in the output
       -channel type        apply option to select image channels
       -colorspace type     alternate image colorspace
       -comment string      annotate image with comment
       -compress  type       type of pixel compression when writ-
     ing the image
       -define format:option
                            define  one  or  more  image   format
       -density  geometry     horizontal  and vertical density of
     the image
       -depth value         image depth
       -descend             obtain  image  by  descending  window
       -display server      X server to contact
       -dispose method      layer disposal method
       -dither method       apply error diffusion to image
       -delay value         display the next image after pausing
       -encipher filename   convert plain pixels to cipher pixels
       -endian type         endianness (MSB or LSB) of the image
       -encoding type       text encoding type
       -format "string"     output formatted  image  characteris-
       -frame               include window manager frame
       -gravity direction   which direction to gravitate towards
       -identify             identify the format and characteris-
     tics of the image
       -interlace type      None, Line, Plane, or Partition
       -interpolate method  pixel color interpolation method

ImageMagick   Last change: Date: 2009/01/10 01:00:00            1

User Commands                                           import(1)

       -label string        assign a label to an image
       -limit type value    Area, Disk, Map, or  Memory  resource
       -monitor             monitor progress
       -page geometry       size and location of an image canvas
       -pause value         seconds delay between snapshots
       -pointsize value     font point size
       -quality value       JPEG/MIFF/PNG compression level
       -quiet               suppress all warning messages
       -regard-warnings     pay attention to warning messages
       -sampling-factor geometry
                            horizontal and vertical sampling fac-
       -scene value         image scene number
       -screen              select image from root window
       -seed value          seed a new sequence of  pseudo-random
       -set property value  set an image property
       -silent              operate silently, i.e. don't ring any
       -snaps value         number of screen snapshots
       -support factor      resize support: > 1.0  is  blurry,  <
     1.0 is sharp
       -synchronize         synchronize image to storage device
       -taint               declare the image as modified
       -transparent-color color
                            transparent color
       -treedepth value     color tree depth
       -verbose              print detailed information about the
       -virtual-pixel method
                            Constant, Edge, Mirror, or Tile
       -window id           select window with this id or name

     Image Operators:
       -annotate geometry text
                            annotate the image with text
       -colors value        preferred number  of  colors  in  the
       -crop  geometry        preferred  size and location of the
     cropped image
       -geometry geometry   preferred size  or  location  of  the
       -help                print program options
       -monochrome          transform image to black and white
       -negate               replace  each pixel with its comple-
     mentary color
       -repage geometry     size and location of an image canvas
       -quantize colorspace reduce colors in this colorspace
       -resize geometry     resize the image
       -rotate degrees      apply Paeth rotation to the image
       -strip                strip  image  of  all  profiles  and

ImageMagick   Last change: Date: 2009/01/10 01:00:00            2

User Commands                                           import(1)

       -thumbnail geometry  create a thumbnail of the image
       -transparent  color    make  this color transparent within
     the image
       -trim                trim image edges
       -type type           image type

     Miscellaneous Options:
       -debug events        display copious debugging information
       -help                print program options
       -log format          format of debugging information
       -list  type            print  a  list  of supported option
       -version             print version information

     By default, 'file' is written in the MIFF image format.   To
     specify a particular image format, precede the filename with
     an image format name and a colon (i.e. ps:image) or  specify
     the  image  type  as  the  filename  suffix (i.e.
     Specify 'file' as '-' for standard input or output.

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | image/imagemagick |
     |Stability      | Volatile          |

     Copyright  (C)  1999-2013 ImageMagick Studio LLC. Additional
     copyrights  and  licenses  apply  to  this   software,   see
     file:///usr/share/doc/ImageMagick-6.8.3/www/license.html  or

     This  software  was   built   from   source   available   at    The  original
     community  source  was  downloaded  from   http://image_mag-

     Further  information about this software can be found on the

ImageMagick   Last change: Date: 2009/01/10 01:00:00            3

User Commands                                           import(1)

     open  source  community  website   at   http://www.imagemag-

ImageMagick   Last change: Date: 2009/01/10 01:00:00            4