VDisplaySaveScreenImage
Name
VDisplaySaveScreenImage - displays the 3DVIEWNIX screen image.
Synopsis
VDisplaySaveScreenImage(scrn_file, frame, xloc, yloc)
char *scrn_file;
int frame;
int xloc, yloc;
Description
VDisplaySaveScreenImage displays a 3DVIEWNIX screen image.
VDisplaySaveScreenImage reads the specified frames of the screen image and
displays it in the image window at the location specified.
VDisplaySaveScreenImage also installs the colormap and updates the COLOR.COM
file with the values associated with the frame to be displayed. The screen
file contains the number of frames in the first four bytes, followed by the
image frame, the number of colormap entries, and the colormap contents.
Retrun Value
0 - work successfully.
1 - memory allocation error.
2 - read error.
4 - file open error.
209 - invalid frame number in the screen file.
240 - frame outside the image window boundary.
Parameters
scrn_file - specifies the name of the file to be displayed.
frame - specifies the frame number to be displayed.
xloc, yloc - specifies x and y coordinates of the upper left corner of the
rectangle, relative to the origin of the image window.
Side Effects
None.
Entry Conditions
If xloc, or yloc is not valid, or scrn_file is NULL, or VCreateColormap
not called earlier, VDisplaySaveScreenImage prints an error message to the
standard error stream. produces a core dump file and exits from the current
process.
Related Functions
VEraseSaveScreenCommand,
VGetSaveScreenSwitchValue,
VGetSaveScreenFilename,
VCheckEventsInButtonWindow,
VDisplaySaveScreenCommand,
VOutputSaveScreenImage.