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  (Failed, probably out of memory).