VDisplaySaveScreenCommand


 
Name
  VDisplaySaveScreenCommand - displays a switch in the button window that
enables programs to save 3DVIEWNIX screens.
 
Synopsis
  VDisplaySaveScreenCommand()
 
Description
  VDisplaySaveScreenCommand displays a switch in the button window that
enables programs to save 3DVIEWNIX screens. VDisplaySaveScreenCommand has
two options to save the screens, either in APPND (append) mode where multiple
screens are saved onto the same file, or OVERWR (overwrite) mode. The APPND
is the default switch value. The option of this command can be changed by
calling VCheckEventsInButtonWindow.
 
Return Value
  0 - work successfully.
  1 - memory allocation error.
 
Parameters
  None.
 
Side Effects
  None.
 
Entry Conditions
  VCreateColormap should be called earlier, else VDisplaySaveScreenCommand
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, VDisplaySaveScreenImage, VOutputSaveScreenImage.