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(icon_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.