]> granicus.if.org Git - imagemagick/blob - utilities/import.1.in
(no commit message)
[imagemagick] / utilities / import.1.in
1 .TH import 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
2 .SH NAME
3 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.
4 .SH SYNOPSIS
5 .TP
6 \fBimport\fP [\fIoptions\fP] \fIinput-file\fP
7 .SH OVERVIEW
8 The \fBimport\fP 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.
9
10 For more information about the import command, point your browser to file://@DOCUMENTATION_PATH@/www/import.html or http://www.imagemagick.org/script/import.php.
11 .SH DESCRIPTION
12 Image Settings:
13   \-adjoin              join images into a single multi-image file
14   \-border              include window border in the output image
15   \-channel type        apply option to select image channels
16   \-colorspace type     alternate image colorspace
17   \-comment string      annotate image with comment
18   \-compress type       type of pixel compression when writing the image
19   \-define format:option
20                        define one or more image format options
21   \-density geometry    horizontal and vertical density of the image
22   \-depth value         image depth
23   \-descend             obtain image by descending window hierarchy
24   \-display server      X server to contact
25   \-dispose method      layer disposal method
26   \-dither method       apply error diffusion to image
27   \-delay value         display the next image after pausing
28   \-encipher filename   convert plain pixels to cipher pixels
29   \-endian type         endianness (MSB or LSB) of the image
30   \-encoding type       text encoding type
31   \-format "string"     output formatted image characteristics
32   \-frame               include window manager frame
33   \-gravity direction   which direction to gravitate towards
34   \-identify            identify the format and characteristics of the image
35   \-interlace type      None, Line, Plane, or Partition
36   \-interpolate method  pixel color interpolation method
37   \-label string        assign a label to an image
38   \-limit type value    Area, Disk, Map, or Memory resource limit
39   \-monitor             monitor progress
40   \-page geometry       size and location of an image canvas
41   \-pause value         seconds delay between snapshots
42   \-pointsize value     font point size
43   \-quality value       JPEG/MIFF/PNG compression level
44   \-quiet               suppress all warning messages
45   \-regard-warnings     pay attention to warning messages
46   \-sampling-factor geometry
47                        horizontal and vertical sampling factor
48   \-scene value         image scene number
49   \-screen              select image from root window
50   \-seed value          seed a new sequence of pseudo-random numbers
51   \-set property value  set an image property
52   \-silent              operate silently, i.e. don't ring any bells 
53   \-snaps value         number of screen snapshots
54   \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
55   \-synchronize         synchronize image to storage device
56   \-taint               declare the image as modified
57   \-transparent-color color
58                        transparent color
59   \-treedepth value     color tree depth
60   \-verbose             print detailed information about the image
61   \-virtual-pixel method
62                        Constant, Edge, Mirror, or Tile
63   \-window id           select window with this id or name
64
65 Image Operators:
66   \-annotate geometry text
67                        annotate the image with text
68   \-colors value        preferred number of colors in the image
69   \-crop geometry       preferred size and location of the cropped image
70   \-geometry geometry   preferred size or location of the image
71   \-help                print program options
72   \-monochrome          transform image to black and white
73   \-negate              replace each pixel with its complementary color 
74   \-repage geometry     size and location of an image canvas
75   \-quantize colorspace reduce colors in this colorspace
76   \-resize geometry     resize the image
77   \-rotate degrees      apply Paeth rotation to the image
78   \-strip               strip image of all profiles and comments
79   \-thumbnail geometry  create a thumbnail of the image
80   \-transparent color   make this color transparent within the image
81   \-trim                trim image edges
82   \-type type           image type
83
84 Miscellaneous Options:
85   \-debug events        display copious debugging information
86   \-help                print program options
87   \-log format          format of debugging information
88   \-list type           print a list of supported option arguments
89   \-version             print version information
90
91 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. image.ps).  Specify 'file' as '-' for standard input or output.
92 .SH SEE ALSO
93 ImageMagick(1)
94
95 .SH COPYRIGHT
96
97 \fBCopyright (C) 1999-2012 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file://@DOCUMENTATION_PATH@/www/license.html or http://www.imagemagick.org/script/license.php\fP