Penguin
Recent Changes
Annotated edit history of import(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 import
2 !!!import
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 OPTIONS
8 ENVIRONMENT
9 SEE ALSO
10 COPYRIGHT
11 AUTHORS
12 ----
13 !!NAME
14
15
16 import - capture some or all of an X server screen and save the image to a file.
17 !!SYNOPSIS
18
19
20 __import [[__ ''options'' __... ]__
21 ''file''
22 !!DESCRIPTION
23
24
25 __Import__ reads an image from any visible window on an X
26 server and outputs it as an image file. You can capture a
27 single window, the entire screen, or any rectangular portion
28 of the screen. Use ''display'' for redisplay, printing,
29 editing, formatting, archiving, image processing, etc. of
30 the captured image.
31
32
33 The target window can be specified by id, name, or may be
34 selected by clicking the mouse in the desired window. If you
35 press a button and then drag, a rectangle will form which
36 expands and contracts as the mouse moves. To save the
37 portion of the screen defined by the rectangle, just release
38 the button. The keyboard bell is rung once at the beginning
39 of the screen capture and twice when it
40 completes.
41 !!EXAMPLES
42
43
44 To select an X window or an area of the screen with the
45 mouse and save it in the MIFF image format to a file
46 entitled window.miff, use:
47
48
49 import window.miff
50
51
52 To select an X window or an area of the screen with the
53 mouse and save it in the Encapsulated Postscript format to
54 include in another document, use:
55
56
57 import figure.eps
58
59
60 To capture the entire X server screen in the JPEG image
61 format in a file entitled root.jpeg, without using the
62 mouse, use:
63
64
65 import -window root root.jpeg
66
67
68 To capture the 512x256 area at the upper right corner of the
69 X server screen in the PNG image format in a well-compressed
70 file entitled corner.png, without using the mouse,
71 use:
72
73
74 import -window root -crop 512x256-0+0 -quality 90
75 corner.png
76 !!OPTIONS
77
78
79 Options are processed in command line order. Any option you
80 specify on the command line remains in effect until it is
81 explicitly changed by specifying the option again with a
82 different effect.
83
84
85 __Import__ options can appear on the command line or in
86 your X resources file. See ''X(1)''. Options on the
87 command line supersede values specified in your X resources
88 file.
89
90
91 For a more detailed description of each option, see
2 perry 92 ''!ImageMagick(1)''.
1 perry 93
94
95 __-bordercolor__ ''''
96
97
98 the border color
99
100
101 __-cache__ ''''
102
103
104 megabytes of memory available to the pixel
105 cache
106
107
108 __-colors__ ''''
109
110
111 preferred number of colors in the image
112
113
114 __-colorspace__ ''''
115
116
117 the type of colorspace
118
119
120 __-comment__ ''''
121
122
123 annotate an image with a comment
124
125
126 __-crop__
127 ''''
128
129
130 preferred size and location of the cropped
131 image
132
133
134 __-debug__
135
136
137 enable debug printout
138
139
140 __-delay__ ''
141 ''
142
143
144 display the next image after pausing
145
146
147 __-density__
148 ''''
149
150
151 vertical and horizontal resolution in pixels of the
152 image
153
154
155 __-depth__ ''''
156
157
158 depth of the image
159
160
161 __-descend__
162
163
164 obtain image by descending window hierarchy
165
166
167 __-display__
168 ''''
169
170
171 specifies the X server to contact
172
173
174 __-dispose__ ''''
175
176
177 GIF disposal method
178
179
180 __-dither__
181
182
183 apply Floyd/Steinberg error diffusion to the
184 image
185
186
187 __-endian__ ''''
188
189
190 specify endianness (MSB or LSB) of output image
191
192
193 __-frame__
194
195
196 include the X window frame in the imported
197 image
198
199
200 __-geometry__
201 ''
202 ''
203
204
205 preferred size and location of the Image
206 window.
207
208
209 __-help__
210
211
212 print usage instructions
213
214
215 __-interlace__ ''''
216
217
218 the type of interlacing scheme
219
220
221 __-label__ ''''
222
223
224 assign a label to an image
225
226
227 __-monochrome__
228
229
230 transform the image to black and white
231
232
233 __-negate__
234
235
236 replace every pixel with its complementary
237 color
238
239
240 __-page__
241 ''''
242
243
244 size and location of an image canvas
245
246
247 __-pause__ ''''
248
249
250 pause between snapshots [[import]
251
252
253 __-ping__
254
255
256 efficiently determine image characteristics
257
258
259 __-pointsize__ ''''
260
261
2 perry 262 pointsize of the Postscript, OPTION1, or !TrueType
1 perry 263 font
264
265
266 __-quality__ ''''
267
268
269 JPEG/MIFF/PNG compression level
270
271
272 __-resize__
273 ''''
274
275
276 resize and locate an image
277
278
279 __-rotate__
280 ''''
281
282
283 apply Paeth image rotation to the image
284
285
286 __-sampling_factor__
287 ''''
288
289
290 sampling factors used by JPEG encoder.
291
292
293 __-scene__ ''''
294
295
296 set scene number
297
298
299 __-screen__
300
301
302 specify the screen to capture
303
304
305 __-silent__
306
307
308 operate silently
309
310
311 __-snaps__ ''''
312
313
314 number of screen snapshots
315
316
317 __-transparent__ ''''
318
319
320 make this color transparent within the image
321
322
323 __-trim__
324
325
326 trim an image
327
328
329 __-verbose__
330
331
332 print detailed information about the image
333
334
335 For a more detailed description of each option, see
2 perry 336 ''!ImageMagick(1)''.
1 perry 337 !!ENVIRONMENT
338
339
340 __DISPLAY__
341 !!SEE ALSO
342
343
344 animate(1), display(1), composite(1), conjure(1),
345 convert(1), identify(1), mogrify(1), montage(1),
2 perry 346 !ImageMagick(1)
1 perry 347 !!COPYRIGHT
348
349
2 perry 350 __Copyright (C) 2002 !ImageMagick Studio__
1 perry 351
352
353 __Permission is hereby granted, free of charge, to any
354 person obtaining a copy of this software and associated
355 documentation files (
356 __
357
358
359 __The above copyright notice and this permission notice
360 shall be included in all copies or substantial portions of
2 perry 361 !ImageMagick.__
1 perry 362
363
364 __The software is provided
365 __
366
367
368 __Except as contained in this notice, the name of the
2 perry 369 !ImageMagick Studio LLC shall not be used in advertising or
1 perry 370 otherwise to promote the sale, use or other dealings in
2 perry 371 !ImageMagick without prior written authorization from the
372 !ImageMagick Studio.__
1 perry 373 !!AUTHORS
374
375
2 perry 376 ''John Cristy, !ImageMagick Studio LLC, Glenn
377 Randers-Pehrson, !ImageMagick Studio LLC.''
1 perry 378 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.