After svanima is invoked, two windows will appear on the screen, one a control panel, and the other the window in which the image(s) will appear. These behave like ordinary Sunview windows, e.g. they can be moved.
The display window comes up with a width and height given by S_DEF_WINSERV_WIDTH and S_WIN_WINSERV_HEIGHT in scry/include/scry_limits.h. It will automatically resize to the size of whatever Anima file is entered, up to the default maximum size, given by S_MAX_WINSERV_WIDTH and S_MAX_WINSERV_HEIGHT in scry_limits.h. svanima will exit if images in an Anima file are bigger than the maximum.
Sunview allocates entries for color map segments in powers of 2. svanima will allocate 128 or 256 colors, depending on the number of entries in the color map in the Anima file. The screen will go black outside the display window if 256 entries are allocated and the mouse is moved into the display window, and if the mouse is outside, the colors in the displayed image will not appear correctly.
The usage of the buttons is as follows:
Pushing the "quit" button causes the windows to be destroyed and svanima to exit.
To stop at a particular frame and/or to clear all the text fields, click the "stop" button.
To read a file, type its name in after "File:" followed by a carriage return. If the caret is not in the file field, click the left button with the cursor to the right of "File:". (All control features require the use of the left button.) svanima must be in stopped mode to read in a file.
Entering a number in the "Number Input:" field and then pushing the "go to" button will display the image associated with that number. The current frame number and the total number of frames in the sequence are displayed after the "#:" sign.
"< step" will step to the previous frame if one is not at the beginning of the sequence, and "> step" will step to the next frame if not at the end of the sequence. " > " instructs svanima to move forward through a sequence of images, and " < " instructs it to move backward. If the end of the sequence of frames is reached, svanima will go back to the beginning. If frames are being played back in reverse order and the beginning is reached, svanima will start playing frames backwards from the end of the file.
"full" instructs svanima to display images at full speed. Alternatively, one can click on the slider to control the speed (10 is the same as "full" speed.)
Entering a number in the "gamma" field will adjust the gamma value of the next image displayed. svanima must be in stopped mode for this to have effect. The default value is 1, and the legal range is from 0.1 to 4.
To save a file on disk in Postscript form, first type in the dots per inch in the "Number Input:" field (the default is 60 dpi), and then push the "postscr" button. The file saved will be of the form "Anima_file_name.current_frame.post". Note that it will be grey-scale and not color Postscript format.
To save a file on disk in Sun rasterfile format, push the sunrast button. The file saved will be of the form "Anima_file_name.current_frame.ras".
At full speed, svanima can play back scry/Anima/data/dye2d.iff at 10 frames per second on a Sun 4/110, and 25 frames per second on a Sparcstation 2 with the standard frame buffer. scry/Anima/data/skull.iff can be played back at 3 frames per second on a Sun 4/110, and 9 frames per second on a Sparcstation 2. Note that both these files are the output of the program genonemap.