GU__SaveEnvironment (ul_pbar_graphics)

 *  Synopsis:
 *    #include <ul_pbar_graphics:gu.h>
 *
 *    void GU__SaveEnvironment( TGraphicEnvPtr theStore )
 *
 *  Function intent:
 *    GU__SetupEnvironment() saves away the existing graphic environment for
 *    future recall with GU__RestoreEnvironment().
 *  Function parameters:
 *    TGraphicEnvPtr  theStore  where to store the current graphic state
 *  Function return value:
 *    void