Click above to get retro games delivered to your door ever month!

                                 fg_save

   Usage
   #include <fg.h>
   fg_handle_t far fg_save(fg_const_pbox_t box);

   Description
   Save  an  area  on  the  screen.  This  area  can  be  restored  using
   fg_restore.  fg_save  and fg_restore are primarily useful  to  support
   pop-in   areas  on  the  screen. Note that areas  saved  can  only  be
   restored  to the  same location (or the same location on another  page
   if the active page  was changed).

   Example

   {
   fg_box_t save_box;
   fg_handle_t save_handle;
   save_box [FG_X1] = save_box [FG_Y1] = 0;
   save_box [FG_X1] = save_box [FG_Y1] = 100;
   save_handle = fg_save(save_box);
   assert(save_handle != NULL);
   fg_restore(save_handle);
   }

   Return Value
   Returns  an  fg_handle_t,  the  handle to  be  used  with  fg_restore,
   otherwise NULL  (<M>Failed, probably out of memory).