Function:     GgiPlotDest

Purpose:      Change the default drawing destination.

Category:     USER-INTERFACE, GRAPHICS

File:         ggi.src

Author:       J.P. Terlouw

Use:
              #include "ggi.h"
              ident plotter;
              int   frame

              GgiPlotDest(plotter, frame);

                plotter   -  the plotfield element.
                frame     -  the frame number, starting with 0 (zero).
                             If -1 is given, drawing will revert to the
                             visible window.

Description:  GgiPlotDest specifies the frame into which will be drawn.
              This can e.g. be used when making an animation when it is
              necessary to prepare new frames without disturbing the
              display.

Related documents:
              GgiPlotCopy.dc2, GgiPlotFrames.dc2, GgiPlotRecord.dc2,
              GgiPlotShow.dc2.

Updates:      Mar  9, 2005: JPT, Document created.