libchimara/resource.c

   1 #include "resource.h"
   2
   3 extern GPrivate *glk_data_key;
   4
   5 /**
   6  * giblorb_set_resource_map:
   7  * @file: The file stream to read the resource map from
   8  *
   9  * This function tells the library that the file is indeed the Blorby source
  10  * of all resource goodness. Whenever your program calls an image or sound
  11  * function, such as glk_image_draw(), the library will search this file for
  12  * the resource you request.
  13  *
  14  * Do <emphasis>not</emphasis> close the stream after calling this function.
  15  * The library is responsible for closing the stream at shutdown time.
  16  *
  17  * Returns: a Blorb error code.
  18  */
  19 giblorb_err_t
  20 giblorb_set_resource_map(strid_t file)
  21 {
  22         ChimaraGlkPrivate *glk_data = g_private_get(glk_data_key);
  23         giblorb_map_t *newmap; /* create map allocates memory */
  24         giblorb_err_t error = giblorb_create_map(file, &newmap);
  25
  26         if(error != giblorb_err_None) {
  27                 g_free(newmap);
  28                 return error;
  29         }
  30
  31         /* Check if there was already an existing resource map */
  32         if(glk_data->resource_map != NULL) {
  33                 WARNING("Overwriting existing resource map.\n");
  34                 giblorb_destroy_map(glk_data->resource_map);
  35                 glk_stream_close(glk_data->resource_file, NULL);
  36         }
  37
  38         glk_data->resource_map = newmap;
  39         glk_data->resource_file = file;
  40
  41         //giblorb_print_contents(newmap);
  42         return giblorb_err_None;
  43 }
  44
  45 /**
  46  * giblorb_get_resource_map:
  47  *
  48  * This function returns the current resource map being used. Returns %NULL
  49  * if giblorb_set_resource_map() has not been called yet.
  50  *
  51  * Returns: a resource map, or %NULL.
  52  */
  53 giblorb_map_t*
  54 giblorb_get_resource_map()
  55 {
  56         ChimaraGlkPrivate *glk_data = g_private_get(glk_data_key);
  57
  58         if(glk_data->resource_map == NULL) {
  59                 WARNING("Resource map not set yet.\n");
  60         }
  61
  62         return glk_data->resource_map;
  63 }
  64
  65 /* giblorb_chunkdesc_t: Describes one chunk of the Blorb file. */
  66 typedef struct giblorb_chunkdesc_struct {
  67     glui32 type;
  68     glui32 len;
  69     glui32 startpos; /* start of chunk header */
  70     glui32 datpos; /* start of data (either startpos or startpos+8) */
  71
  72     void *ptr; /* pointer to malloc'd data, if loaded */
  73     int auxdatnum; /* entry in the auxsound/auxpict array; -1 if none.
  74         This only applies to chunks that represent resources;  */
  75
  76 } giblorb_chunkdesc_t;
  77
  78 /* giblorb_resdesc_t: Describes one resource in the Blorb file. */
  79 typedef struct giblorb_resdesc_struct {
  80     glui32 usage;
  81     glui32 resnum;
  82     glui32 chunknum;
  83 } giblorb_resdesc_t;
  84
  85 /* giblorb_map_t: Holds the complete description of an open Blorb file. */
  86 struct giblorb_map_struct {
  87     glui32 inited; /* holds giblorb_Inited_Magic if the map structure is
  88         valid */
  89     strid_t file;
  90
  91     int numchunks;
  92     giblorb_chunkdesc_t *chunks; /* list of chunk descriptors */
  93
  94     int numresources;
  95     giblorb_resdesc_t *resources; /* list of resource descriptors */
  96     giblorb_resdesc_t **ressorted; /* list of pointers to descriptors
  97         in map->resources -- sorted by usage and resource number. */
  98 };
  99
 100 void
 101 giblorb_print_contents(giblorb_map_t *map)
 102 {
 103         int i;
 104         for(i=0; i<map->numresources; i++) {
 105                 giblorb_resdesc_t *resource = map->ressorted[i];
 106                 printf("Resource #%d, chunknum: %d\n", resource->resnum, resource->chunknum);
 107         }
 108
 109         printf("\n-------\n");
 110
 111         for(i=0; i<map->numresources; i++) {
 112                 giblorb_chunkdesc_t chunk = map->chunks[i];
 113                 printf("Chunk #%d, type: %d\n", i, chunk.type);
 114         }
 115 }
 116
 117 gchar*
 118 giblorb_get_error_message(giblorb_err_t err)
 119 {
 120         switch(err)
 121         {
 122                 case giblorb_err_None:
 123                         return "not BLORB's fault";
 124                 case giblorb_err_CompileTime:
 125                         return "BLORB compile time error";
 126                 case giblorb_err_Alloc:
 127                         return "memory allocation failed";
 128                 case giblorb_err_Read:
 129                         return "error during reading of file";
 130                 case giblorb_err_NotAMap:
 131                         return "invalid resource map supplied";
 132                 case giblorb_err_Format:
 133                         return "invalid format of resource";
 134                 case giblorb_err_NotFound:
 135                         return "resource not found";
 136                 default:
 137                         return "Unknown error code";
 138         }
 139 }