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

                              fg_matrix_size

   Usage
   #include <fg.h>
   size_t far fg_matrix_size(fg_const_pbox_t box);

   Description
   Determines  the  number  of bytes that will be  required  to  store  a
   matrix. This value can then be used to allocate suficient memory.

   Example
   char *make_user_icon(fg_pbox_t icon_box)
   {
   char *icon_matrix;

   get_user_icon_box(icon_box);
   icon_matrix = calloc(fg_matrix_size(box), 1);

   if(icon_matrix)
   get_user_icon(icon_matrix, icon_box);

   /* Caller must free storage used for icon_matrix. */
   return icon_matrix;
   }
   Return Value
   Returns the number of bytes to allocate for the matrix.