grSstControlMode() should be called when switching between the VGA and the Voodoo Graphics display for things like an attract mode, introductory video clips, etc. Use this routine instead of initializing and shutting down Glide.
void grSstControlMode(GrSstControlMode_t mode)
grSstControlMode() determines whether the VGA display or Voodoo Graphics display is visible, depending on the value of mode, which can assumeone of four values: GR_CONTROL_ACTIVATE, GR_CONTROL_DEACTIVATE, GR_CONTROL_RESIZE, or GR_CONTROL_MOVE. The first two values apply to all systems. When GR_CONTROL_ACTIVATE is specified, the Voodoo Graphics frame buffer will be displayed in full screen mode. On SST-96 systems, the video tile is enabled. If mode is GR_CONTROL_DEACTIVATE, the 2D VGA frame buffer is displayed. On SST-96 systems, the video tile is disabled.
GR_CONTROL_RESIZE is ignored under DOS, SST-1, and SST-96 in full screen mode. For windowed Glide applications, this call resizes the back buffers and auxiliary buffers, and is typically made by Win32 applications in response to WM_SIZE messages. The grSstControlMode() call may fail if there is not enough offscreen video memory to accommodate the resized buffers.
GR_CONTROL_MOVE is ignored under DOS, SST-1, and SST-96 in full screen mode. For windowed Glide applications, this call is used to validate the location and clip region associated with the front buffer when the user moves a window, and is typically made by Win32 applications in response to WM_MOVE messages. This call may fail if underlying DirectDraw implementation fails.
On SST-1, since the 2D and 3D graphics exist on different devices (and frame buffers), activating or deactivating pass through does not require you to repaint either the 2D or 3D graphics. On the SST-96, the application is responsible for repainting the 2D graphics or 3D graphics when you use GR_CONTROL_ACTIVATE or GR_CONTROL_DEACTIVATE.