import - capture some or all of an X server screen and save the image to a file.


import [__ ''options'' __...? file


Import reads an image from 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. Use display for redisplay, printing, editing, formatting, archiving, image processing, etc. of the captured image.

The target window can be specified by id, name, or may be selected by clicking the mouse in the desired window. If you press a button and then drag, a rectangle will form which expands and contracts as the mouse moves. To save the portion of the screen defined by the rectangle, just release the button. The keyboard bell is rung once at the beginning of the screen capture and twice when it completes.


To select an X window or an area of the screen with the mouse and save it in the MIFF image format to a file entitled window.miff, use:

import window.miff

To select an X window or an area of the screen with the mouse and save it in the Encapsulated Postscript format to include in another document, use:

import figure.eps

To capture the entire X server screen in the JPEG image format in a file entitled root.jpeg, without using the mouse, use:

import -window root root.jpeg

To capture the 512x256 area at the upper right corner of the X server screen in the PNG image format in a well-compressed file entitled corner.png, without using the mouse, use:

import -window root -crop 512x256-0+0 -quality 90 corner.png


Options are processed in command line order. Any option you specify on the command line remains in effect until it is explicitly changed by specifying the option again with a different effect.

Import options can appear on the command line or in your X resources file. See X(1). Options on the command line supersede values specified in your X resources file.

For a more detailed description of each option, see !ImageMagick(1).


the border color


megabytes of memory available to the pixel cache


preferred number of colors in the image


the type of colorspace


annotate an image with a comment


preferred size and location of the cropped image


enable debug printout


display the next image after pausing


vertical and horizontal resolution in pixels of the image


depth of the image


obtain image by descending window hierarchy


specifies the X server to contact


GIF disposal method


apply Floyd/Steinberg error diffusion to the image


specify endianness (MSB or LSB) of output image


include the X window frame in the imported image


preferred size and location of the Image window.


print usage instructions


the type of interlacing scheme


assign a label to an image


transform the image to black and white


replace every pixel with its complementary color


size and location of an image canvas


pause between snapshots [import?


efficiently determine image characteristics


pointsize of the Postscript, OPTION1, or !TrueType font


JPEG/MIFF/PNG compression level


resize and locate an image


apply Paeth image rotation to the image


sampling factors used by JPEG encoder.


set scene number


specify the screen to capture


operate silently


number of screen snapshots


make this color transparent within the image


trim an image


print detailed information about the image

For a more detailed description of each option, see !ImageMagick(1).




animate(1), display(1), composite(1), conjure(1), convert(1), identify(1), mogrify(1), montage(1),



Copyright (C) 2002 !ImageMagick Studio

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (

__The above copyright notice and this permission notice shall be included in all copies or substantial portions of


The software is provided

__Except as contained in this notice, the name of the

ImageMagick Studio LLC shall not be used in advertising or

otherwise to promote the sale, use or other dealings in

ImageMagick without prior written authorization from the

ImageMagick Studio.__


John Cristy, !ImageMagick Studio LLC, Glenn Randers-Pehrson, !ImageMagick Studio LLC.

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

lib/main.php:944: Notice: PageInfo: Cannot find action page

lib/main.php:839: Notice: PageInfo: Unknown action