Function:     GgiPlotFrames

Purpose:      Obtain a number of pixmaps e.g. for movie loops.

Category:     USER-INTERFACE, GRAPHICS

File:         ggi.src

Author:       J.P. Terlouw

Use:
              #include "ggi.h"
              ident plotter;
              int   requested, obtained; 

              obtained = GgiPlotFrames(plotter, requested);

                plotter     -  the associated plotfield element.
                requested   -  the desired number of frames.
                obtained    -  the number of frames actually obtained.

Description:  GgiPlotFrames tries to create a number of X11 pixmaps
              ("frames") of the same dimensions as the plotfield element.
              These can then later be used to store and retrieve plots.
              in a fast way, e.g. for implementing a movie loop.
              The pixmaps can only be created after the plotfield element
              has been opened at least once. It need not be open anymore
              when GgiPlotFrames is called.

Related documents:
              GgiPlotRecord.dc2, GgiPlotShow.dc2.

Updates:      Jan 25, 1999: JPT, Document created.
              Mar  8, 2000: JPT, Document changed.