animate
NAME SYNOPSIS DESCRIPTION EXAMPLES OPTIONS MOUSE BUTTONS COMMAND WIDGET KEYBOARD ACCELERATORS X RESOURCES ENVIRONMENT ACKNOWLEDGEMENTS SEE ALSO COPYRIGHT AUTHORS
animate - animate a sequence of images
animate [__ ''options'' __... file ''options'' ... file ...]
Animate displays a sequence of images on any workstation display running an X server. animate first determines the hardware capabilities of the workstation. If the number of unique colors in an image is less than or equal to the number the workstation can support, the image is displayed in an X window. Otherwise the number of colors in the image is first reduced to match the color resolution of the workstation before it is displayed.
This means that a continuous-tone 24 bits-per-pixel image can display on a 8 bit pseudo-color device or monochrome device. In most instances the reduced color image closely resembles the original. Alternatively, a monochrome or pseudo-color image sequence can display on a continuous-tone 24 bits-per-pixel device.
To help prevent color flashing on X server visuals that have colormaps, animate creates a single colormap from the image sequence. This can be rather time consuming. You can speed this operation up by reducing the colors in the image before you mogrify to color reduce the images to a single colormap. See __mogrify(1) for details. Alternatively, you can use a Standard Colormap; or a static, direct, or true color visual. You can define a Standard Colormap with xstdcmap. See xstdcmap(1)__ for details. This method is recommended for colormapped X server because it eliminates the need to compute a global colormap.
To animate a set of images of a cockatoo, use:
animate cockatoo.*
To animate a cockatoo image sequence while using the Standard Colormap best, use:
xstdcmap -best animate -map best cockatoo.*
To animate an image of a cockatoo without a border centered on a backdrop, use:
animate +borderwidth -backdrop cockatoo.*
For a more detailed description of each option, see !ImageMagick(1).
-backdrop
display the image centered on a backdrop.
-background
the background color
-bordercolor
the border color
-borderwidth
the border width
-cache
megabytes of memory available to the pixel cache
-chop
remove pixels from the interior of an image
-colormap
define the colormap type
-colors
preferred number of colors in the image
-colorspace
the type of colorspace
-crop
preferred size and location of the cropped image
-debug
enable debug printout
-delay
display the next image after pausing
-density
vertical and horizontal resolution in pixels of the image
-depth
depth of the image
-display
specifies the X server to contact
-dispose
GIF disposal method
-dither
apply Floyd/Steinberg error diffusion to the image
-font
use this font when annotating the image with text
-foreground
define the foreground color
-gamma
level of gamma correction
-geometry
preferred size and location of the Image window.
-help
print usage instructions
-iconGeometry
specify the icon geometry
-iconic
iconic animation
-interlace
the type of interlacing scheme
-map
display image using this type.
-matte
store matte channel if the image has one
-mattecolor
specify the matte color
-monochrome
transform the image to black and white
-name
name an image
-noop
NOOP (no option)
-pause
pause between animation loops [animate
-remote
perform a remote operation
-rotate
apply Paeth image rotation to the image
-scenes
range of image scene numbers to read
-shared_memory
use shared memory
-size
width and height of the image
-text_font
font for writing fixed-width text
-title
assign title to displayed image [unrenderable node]
-treedepth
tree depth for the color reduction algorithm
-trim
trim an image
-verbose
print detailed information about the image
-visual
animate images using this X visual type
-window
make image the background of a window
For a more detailed description of each option, see !ImageMagick(1).
Any option you specify on the command line remains in effect for the group of images following it, until the group is terminated by the appearance of any option or -noop. For example, to animate three images, the first with 32 colors, the second with an unlimited number of colors, and the third with only 16 colors, use:
animate -colors 32 cockatoo.1 -noop cockatoo.2 -colors 16 cockatoo.3
Animate 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. Image filenames may appear in any order on the command line if the image format is MIFF (refer to __miff(5) and the scene__ keyword is specified in the image. Otherwise the images will display in the order they appear on the command line.
Press any button to map or unmap the Command widget. See the next section for more information about the Command widget.
The Command widget lists a number of sub-menus and commands. They are
Animate
Open Play Step Repeat Auto Reverse
Speed
Faster Slower
Direction
Forward Reverse
Image Info Help Quit
Menu items with a indented triangle have a sub-menu. They are represented above as the indented items. To access a sub-menu item, move the pointer to the appropriate menu and press a button and drag. When you find the desired sub-menu item, release the button and the command is executed. Move the pointer away from the sub-menu if you decide not to execute a particular command.
Ctl+O
Press to load an image from a file.
space
Press to display the next image in the sequence.
Press to speed-up the display of the images. Refer to -delay for more information.
Press to slow the display of the images. Refer to -delay for more information.
?
Press to display information about the image. Press any key or button to erase the information.
This information is printed: image name; image size; and the total number of unique colors in the image.
F1
Press to display helpful information about __animate(1)__.
Ctl-q
Press to discard all images and exit program.
Animate options can appear on the command line or in your X resource file. Options on the command line supersede values specified in your X resource file. See __X(1)__ for more information on X resources.
All animate options have a corresponding X resource. In addition, the animate program uses the following X resources:
background (class Background)
Specifies the preferred color to use for the Image window background. The default is #ccc.
borderColor (class !BorderColor)
Specifies the preferred color to use for the Image window border. The default is #ccc.
borderWidth (class !BorderWidth)
Specifies the width in pixels of the Image window border. The default is 2.
font (class __Font or
Specifies the name of the preferred font to use in normal formatted text. The default is 14 point Helvetica.
foreground (class Foreground)
Specifies the preferred color to use for text within the Image window. The default is black.
geometry (class geometry)
Specifies the preferred size and position of the image window. It is not necessarily obeyed by all window managers. Offsets, if present, are handled in X(1) style. A negative x offset is measured from the right edge of the screen to the right edge of the icon, and a negative y offset is measured from the bottom edge of the screen to the bottom edge of the icon.
iconGeometry (class !IconGeometry)
Specifies the preferred size and position of the application when iconified. It is not necessarily obeyed by all window managers. Offsets, if present, are handled in the same manner as in class Geometry.
iconic (class Iconic)
This resource indicates that you would prefer that the application's windows initially not be visible as if the windows had be immediately iconified by you. Window managers may choose not to honor the application's request.
matteColor (class !MatteColor)
Specify the color of windows. It is used for the backgrounds of windows, menus, and notices. A 3D effect is achieved by using highlight and shadow colors derived from this color. Default value: #ddd.
name (class Name)
This resource specifies the name under which resources for the application should be found. This resource is useful in shell aliases to distinguish between invocations of an application, without resorting to creating links to alter the executable file name. The default is the application name.
sharedMemory (class !SharedMemory)
This resource specifies whether animate should attempt use shared memory for pixmaps. !ImageMagick must be compiled with shared memory support, and the display must support the MIT-SHM extension. Otherwise, this resource is ignored. The default is True.
text_font (class textFont)
Specifies the name of the preferred font to use in fixed (typewriter style) formatted text. The default is 14 point Courier.
title (class Title)
This resource specifies the title to be used for the Image window. This information is sometimes used by a window manager to provide some sort of header identifying the window. The default is the image file name.
DISPLAY
To get the default host, display number, and screen.
The MIT X Consortium for making network transparent graphics a reality.
Michael Halle, Spatial Imaging Group at MIT, for the initial implementation of Alan Paeth's image rotation algorithm.
David Pensak, duPont, for providing a computing environment that made this program possible.
Paul Raveling, USC Information Sciences Institute.
The spatial subdivision color reduction algorithm is based on his Img software.
display(1), composite(1), conjure(1), convert(1), identify(1), !ImageMagick(1), import(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
otherwise to promote the sale, use or other dealings in
John Cristy, !ImageMagick Studio LLC, Glenn Randers-Pehrson, !ImageMagick Studio LLC.
10 pages link to animate(1):