]> granicus.if.org Git - imagemagick/blob - utilities/import.1.in
...
[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. The window to capture is selected by clicking the desired window or a program option.
4 .SH SYNOPSIS
5 .TP
6 \fBimport\fP [\fIoptions\fP] \fIoutput-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   \-colorspace type     alternate image colorspace
16   \-comment string      annotate image with comment
17   \-compress type       type of pixel compression when writing the image
18   \-define format:option
19                        define one or more image format options
20   \-density geometry    horizontal and vertical density of the image
21   \-depth value         image depth
22   \-descend             obtain image by descending window hierarchy
23   \-display server      X server to contact
24   \-dispose method      layer disposal method
25   \-dither method       apply error diffusion to image
26   \-delay value         display the next image after pausing
27   \-encipher filename   convert plain pixels to cipher pixels
28   \-endian type         endianness (MSB or LSB) of the image
29   \-encoding type       text encoding type
30   \-filter type         use this filter when resizing an image
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 seconds       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   \-repage geometry     size and location of an image canvas
47   \-respect-parentheses settings remain in effect until parenthesis boundary
48   \-sampling-factor geometry
49                        horizontal and vertical sampling factor
50   \-scene value         image scene number
51   \-screen              select image from root window
52   \-seed value          seed a new sequence of pseudo-random numbers
53   \-set property value  set an image property
54   \-silent              operate silently, i.e. don't ring any bells 
55   \-snaps value         number of screen snapshots
56   \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
57   \-synchronize         synchronize image to storage device
58   \-taint               declare the image as modified
59   \-transparent-color color
60                        transparent color
61   \-treedepth value     color tree depth
62   \-verbose             print detailed information about the image
63   \-virtual-pixel method
64                        Constant, Edge, Mirror, or Tile
65   \-window id           select window with this id or name
66                         root selects the whole screen
67
68 Image Operators:
69   \-annotate geometry text
70                        annotate the image with text
71   \-channel mask        set the image channel mask
72   \-colors value        preferred number of colors in the image
73   \-crop geometry       preferred size and location of the cropped image
74   \-geometry geometry   preferred size or location of the image
75   \-help                print program options
76   \-monochrome          transform image to black and white
77   \-negate              replace each pixel with its complementary color 
78   \-quantize colorspace reduce colors in this colorspace
79   \-resize geometry     resize the image
80   \-rotate degrees      apply Paeth rotation to the image
81   \-strip               strip image of all profiles and comments
82   \-thumbnail geometry  create a thumbnail of the image
83   \-transparent color   make this color transparent within the image
84   \-trim                trim image edges
85   \-type type           image type
86
87 Miscellaneous Options:
88   \-debug events        display copious debugging information
89   \-help                print program options
90   \-log format          format of debugging information
91   \-list type           print a list of supported option arguments
92   \-version             print version information
93
94 By default, 'file' is written in the Postscript 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.
95 .SH SEE ALSO
96 ImageMagick(1)
97
98 .SH COPYRIGHT
99
100 \fBCopyright (C) 1999-2018 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