Penguin
Recent Changes
Annotated edit history of animate(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 animate
2 !!!animate
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 OPTIONS
8 MOUSE BUTTONS
9 COMMAND WIDGET
10 KEYBOARD ACCELERATORS
11 X RESOURCES
12 ENVIRONMENT
13 ACKNOWLEDGEMENTS
14 SEE ALSO
15 COPYRIGHT
16 AUTHORS
17 ----
18 !!NAME
19
20
21 animate - animate a sequence of images
22 !!SYNOPSIS
23
24
25 __animate [[__ ''options'' __...]__ ''file'' [[ [[
26 ''options'' ...] ''file'' ...]
27 !!DESCRIPTION
28
29
30 __Animate__ displays a sequence of images on any
31 workstation display running an X server. __animate__
32 first determines the hardware capabilities of the
33 workstation. If the number of unique colors in an image is
34 less than or equal to the number the workstation can
35 support, the image is displayed in an X window. Otherwise
36 the number of colors in the image is first reduced to match
37 the color resolution of the workstation before it is
38 displayed.
39
40
41 This means that a continuous-tone 24 bits-per-pixel image
42 can display on a 8 bit pseudo-color device or monochrome
43 device. In most instances the reduced color image closely
44 resembles the original. Alternatively, a monochrome or
45 pseudo-color image sequence can display on a continuous-tone
46 24 bits-per-pixel device.
47
48
49 To help prevent color flashing on X server visuals that have
50 colormaps, __animate__ creates a single colormap from the
51 image sequence. This can be rather time consuming. You can
52 speed this operation up by reducing the colors in the image
53 before you __mogrify__ to
54 color reduce the images to a single colormap. See
55 __mogrify(1)__ for details. Alternatively, you can use a
56 Standard Colormap; or a static, direct, or true color
57 visual. You can define a Standard Colormap with
58 ''xstdcmap''. See __xstdcmap(1)__ for details. This
59 method is recommended for colormapped X server because it
60 eliminates the need to compute a global
61 colormap.
62 !!EXAMPLES
63
64
65 To animate a set of images of a cockatoo, use:
66
67
68 animate cockatoo.*
69
70
71 To animate a cockatoo image sequence while using the
72 Standard Colormap ''best'', use:
73
74
75 xstdcmap -best animate -map best cockatoo.*
76
77
78 To animate an image of a cockatoo without a border centered
79 on a backdrop, use:
80
81
82 animate +borderwidth -backdrop cockatoo.*
83 !!OPTIONS
84
85
86 For a more detailed description of each option, see
2 perry 87 ''!ImageMagick(1)''.
1 perry 88
89
90 __-backdrop__ ''''
91
92
93 display the image centered on a backdrop.
94
95
96 __-background__ ''''
97
98
99 the background color
100
101
102 __-bordercolor__ ''''
103
104
105 the border color
106
107
108 __-borderwidth__ ''''
109
110
111 the border width
112
113
114 __-cache__ ''''
115
116
117 megabytes of memory available to the pixel
118 cache
119
120
121 __-chop__
122 ''''
123
124
125 remove pixels from the interior of an image
126
127
128 __-colormap__ ''''
129
130
131 define the colormap type
132
133
134 __-colors__ ''''
135
136
137 preferred number of colors in the image
138
139
140 __-colorspace__ ''''
141
142
143 the type of colorspace
144
145
146 __-crop__
147 ''''
148
149
150 preferred size and location of the cropped
151 image
152
153
154 __-debug__
155
156
157 enable debug printout
158
159
160 __-delay__ ''
161 ''
162
163
164 display the next image after pausing
165
166
167 __-density__
168 ''''
169
170
171 vertical and horizontal resolution in pixels of the
172 image
173
174
175 __-depth__ ''''
176
177
178 depth of the image
179
180
181 __-display__
182 ''''
183
184
185 specifies the X server to contact
186
187
188 __-dispose__ ''''
189
190
191 GIF disposal method
192
193
194 __-dither__
195
196
197 apply Floyd/Steinberg error diffusion to the
198 image
199
200
201 __-font__ ''''
202
203
204 use this font when annotating the image with
205 text
206
207
208 __-foreground__ ''''
209
210
211 define the foreground color
212
213
214 __-gamma__ ''''
215
216
217 level of gamma correction
218
219
220 __-geometry__
221 ''
222 ''
223
224
225 preferred size and location of the Image
226 window.
227
228
229 __-help__
230
231
232 print usage instructions
233
234
235 __-iconGeometry__ ''''
236
237
238 specify the icon geometry
239
240
241 __-iconic__
242
243
244 iconic animation
245
246
247 __-interlace__ ''''
248
249
250 the type of interlacing scheme
251
252
253 __-map__ ''''
254
255
256 display image using this type.
257
258
259 __-matte__
260
261
262 store matte channel if the image has one
263
264
265 __-mattecolor__ ''''
266
267
268 specify the matte color
269
270
271 __-monochrome__
272
273
274 transform the image to black and white
275
276
277 __-name__
278
279
280 name an image
281
282
283 __-noop__
284
285
286 NOOP (no option)
287
288
289 __-pause__ ''''
290
291
292 pause between animation loops [[animate]
293
294
295 __-remote__
296
297
298 perform a remote operation
299
300
301 __-rotate__
302 ''''
303
304
305 apply Paeth image rotation to the image
306
307
308 __-scenes__ ''''
309
310
311 range of image scene numbers to read
312
313
314 __-shared_memory__
315
316
317 use shared memory
318
319
320 __-size__
321 ''''
322
323
324 width and height of the image
325
326
327 __-text_font__ ''''
328
329
330 font for writing fixed-width text
331
332
333 __-title__ ''''
334
335
336 assign title to displayed image [[''animate, display,
337 montage'']
338
339
340 __-treedepth__ ''''
341
342
343 tree depth for the color reduction algorithm
344
345
346 __-trim__
347
348
349 trim an image
350
351
352 __-verbose__
353
354
355 print detailed information about the image
356
357
358 __-visual__ ''''
359
360
361 animate images using this X visual type
362
363
364 __-window__ ''''
365
366
367 make image the background of a window
368
369
370 For a more detailed description of each option, see
2 perry 371 ''!ImageMagick(1)''.
1 perry 372
373
374 Any option you specify on the command line remains in effect
375 for the group of images following it, until the group is
376 terminated by the appearance of any option or __-noop__.
377 For example, to animate three images, the first with 32
378 colors, the second with an unlimited number of colors, and
379 the third with only 16 colors, use:
380
381
382 animate -colors 32 cockatoo.1 -noop cockatoo.2 -colors 16
383 cockatoo.3
384
385
386 __Animate__ options can appear on the command line or in
387 your X resources file. See ''X(1)''. Options on the
388 command line supersede values specified in your X resources
389 file. Image filenames may appear in any order on the command
390 line if the image format is ''MIFF'' (refer to
391 __miff(5)__ and the __scene__ keyword is specified in
392 the image. Otherwise the images will display in the order
393 they appear on the command line.
394 !!MOUSE BUTTONS
395
396
397 Press any button to map or unmap the Command widget. See the
398 next section for more information about the Command
399 widget.
400 !!COMMAND WIDGET
401
402
403 The Command widget lists a number of sub-menus and commands.
404 They are
405
406
407 __Animate__
408
409
410 Open Play Step Repeat Auto Reverse
411
412
413 __Speed__
414
415
416 Faster Slower
417
418
419 __Direction__
420
421
422 Forward Reverse
423
424
425 __Image Info Help Quit__
426
427
428 Menu items with a indented triangle have a sub-menu. They
429 are represented above as the indented items. To access a
430 sub-menu item, move the pointer to the appropriate menu and
431 press a button and drag. When you find the desired sub-menu
432 item, release the button and the command is executed. Move
433 the pointer away from the sub-menu if you decide not to
434 execute a particular command.
435 !!KEYBOARD ACCELERATORS
436
437
438 __Ctl+O__
439
440
441 Press to load an image from a file.
442
443
444 __space__
445
446
447 Press to display the next image in the
448 sequence.
449
450
451 ____
452
453
454 Press to speed-up the display of the images. Refer to
455 __-delay__ for more information.
456
457
458 ____
459
460
461 Press to slow the display of the images. Refer to
462 __-delay__ for more information.
463
464
465 __?__
466
467
468 Press to display information about the image. Press any key
469 or button to erase the information.
470
471
472 This information is printed: image name; image size; and the
473 total number of unique colors in the image.
474
475
476 __F1__
477
478
479 Press to display helpful information about
480 __animate(1)__.
481
482
483 __Ctl-q__
484
485
486 Press to discard all images and exit program.
487 !!X RESOURCES
488
489
490 __Animate__ options can appear on the command line or in
491 your X resource file. Options on the command line supersede
492 values specified in your X resource file. See __X(1)__
493 for more information on X resources.
494
495
496 All __animate__ options have a corresponding X resource.
497 In addition, the __animate__ program uses the following X
498 resources:
499
500
501 __background (__''class''
502 __Background)__
503
504
505 Specifies the preferred color to use for the Image window
506 background. The default is #ccc.
507
508
509 __borderColor (__''class''
2 perry 510 __!BorderColor)__
1 perry 511
512
513 Specifies the preferred color to use for the Image window
514 border. The default is #ccc.
515
516
517 __borderWidth (__''class''
2 perry 518 __!BorderWidth)__
1 perry 519
520
521 Specifies the width in pixels of the Image window border.
522 The default is 2.
523
524
525 __font (__''class'' __Font or
2 perry 526 !FontList)__
1 perry 527
528
529 Specifies the name of the preferred font to use in normal
530 formatted text. The default is 14 point
531 ''Helvetica''.
532
533
534 __foreground (__''class''
535 __Foreground)__
536
537
538 Specifies the preferred color to use for text within the
539 Image window. The default is black.
540
541
542 __geometry (__''class'' __geometry)__
543
544
545 Specifies the preferred size and position of the image
546 window. It is not necessarily obeyed by all window managers.
547 Offsets, if present, are handled in ''X(1)'' style. A
548 negative x offset is measured from the right edge of the
549 screen to the right edge of the icon, and a negative y
550 offset is measured from the bottom edge of the screen to the
551 bottom edge of the icon.
552
553
554 __iconGeometry (__''class''
2 perry 555 __!IconGeometry)__
1 perry 556
557
558 Specifies the preferred size and position of the application
559 when iconified. It is not necessarily obeyed by all window
560 managers. Offsets, if present, are handled in the same
561 manner as in class Geometry.
562
563
564 __iconic (__''class'' __Iconic)__
565
566
567 This resource indicates that you would prefer that the
568 application's windows initially not be visible as if the
569 windows had be immediately iconified by you. Window managers
570 may choose not to honor the application's
571 request.
572
573
574 __matteColor (__''class''
2 perry 575 __!MatteColor)__
1 perry 576
577
578 Specify the color of windows. It is used for the backgrounds
579 of windows, menus, and notices. A 3D effect is achieved by
580 using highlight and shadow colors derived from this color.
581 Default value: #ddd.
582
583
584 __name (__''class'' __Name)__
585
586
587 This resource specifies the name under which resources for
588 the application should be found. This resource is useful in
589 shell aliases to distinguish between invocations of an
590 application, without resorting to creating links to alter
591 the executable file name. The default is the application
592 name.
593
594
595 __sharedMemory (__''class''
2 perry 596 __!SharedMemory)__
1 perry 597
598
599 This resource specifies whether animate should attempt use
2 perry 600 shared memory for pixmaps. !ImageMagick must be compiled with
1 perry 601 shared memory support, and the display must support the
602 MIT-SHM extension. Otherwise, this resource is ignored. The
603 default is True.
604
605
606 __text_font (__''class'' __textFont)__
607
608
609 Specifies the name of the preferred font to use in fixed
610 (typewriter style) formatted text. The default is 14 point
611 ''Courier''.
612
613
614 __title (__''class'' __Title)__
615
616
617 This resource specifies the title to be used for the Image
618 window. This information is sometimes used by a window
619 manager to provide some sort of header identifying the
620 window. The default is the image file name.
621 !!ENVIRONMENT
622
623
624 __DISPLAY__
625
626
627 To get the default host, display number, and
628 screen.
629 !!ACKNOWLEDGEMENTS
630
631
632 The __MIT X Consortium__ for making network transparent
633 graphics a reality.
634
635
636 ''Michael Halle'', __Spatial Imaging Group at MIT__,
637 for the initial implementation of Alan Paeth's image
638 rotation algorithm.
639
640
641 ''David Pensak'', __duPont__, for providing a
642 computing environment that made this program
643 possible.
644
645
646 ''Paul Raveling''__, USC Information Sciences
647 Institute.__
648
649
650 The spatial subdivision color reduction algorithm is based
651 on his Img software.
652 !!SEE ALSO
653
654
655 display(1), composite(1), conjure(1), convert(1),
2 perry 656 identify(1), !ImageMagick(1), import(1), mogrify(1),
1 perry 657 montage(1)
658 !!COPYRIGHT
659
660
2 perry 661 __Copyright (C) 2002 !ImageMagick Studio__
1 perry 662
663
664 __Permission is hereby granted, free of charge, to any
665 person obtaining a copy of this software and associated
666 documentation files (
667 __
668
669
670 __The above copyright notice and this permission notice
671 shall be included in all copies or substantial portions of
2 perry 672 !ImageMagick.__
1 perry 673
674
675 __The software is provided
676 __
677
678
679 __Except as contained in this notice, the name of the
2 perry 680 !ImageMagick Studio LLC shall not be used in advertising or
1 perry 681 otherwise to promote the sale, use or other dealings in
2 perry 682 !ImageMagick without prior written authorization from the
683 !ImageMagick Studio.__
1 perry 684 !!AUTHORS
685
686
2 perry 687 ''John Cristy, !ImageMagick Studio LLC, Glenn
688 Randers-Pehrson, !ImageMagick Studio LLC.''
1 perry 689 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.