allegro/examples exconfig.c,NONE,1.1 exconfig.ini,NONE,1.1 examples.txt,1.5,1.6

[<ebo...@us...>]

Update of /cvsroot/alleg/allegro/examples
In directory sc8-pr-cvs1:/tmp/cvs-serv15684/examples

Modified Files:
	examples.txt 
Added Files:
	exconfig.c exconfig.ini 
Log Message:
Lennart Steinke added an 'exconfig' example.

--- NEW FILE: exconfig.c ---
/*
 *    Example program for the Allegro library, by Lennart Steinke.
 *
 *    This is a very simple program showing how to use the allegro config (ini file)
 *    routines.
 */



#include "allegro.h"

/* works lik strcmp, but ignores case */
int strcmp_no_case(const char *lhs, const char *rhs);

int main(void)
{
   int w,h,bpp;
   int windowed;
   int count;
   char **data;

   char *title;
   char *filename;
   int  r,g,b;


   BITMAP *background;
   int     display;
   RGB     pal[256];

   int    x, y;


   /* you should always do this at the start of Allegro programs */
   allegro_init();
   /* set up the keyboard handler */
   install_keyboard(); 


   /* save the current ini file, then set the program specific one */
   push_config_state();
   set_config_file("exconfig.ini");

   /* the gfx mode is stored like this:
    *    640  480 16
    * the get_config_argv() function returns a pointer to a char
    * array, and stores the size of the char array in an int
    */
   data = get_config_argv("graphics", "mode", &count);
   if (count != 3) {
      /* We expect only 3 parameters */
      allegro_message("Found %i parameters in graphics.mode instead of the 3 expected.\n", count);
      w = 320;
      h = 200;
      bpp = 8;
   }
   else {
      w = atoi(data[0]);
      h = atoi(data[1]);
      bpp = atoi(data[2]);       
   }

   /* Should we use a windowed mode? 
    * In the config file this is stored as either FALSE or TRUE.
    * So we need to read a string and see what it contains.
    * If the entry is not found, we use "FALSE" by default
    */
   if (strcmp_no_case(get_config_string("graphics", "windowed", "FALSE"), "FALSE") == 0) 
      windowed = GFX_AUTODETECT_FULLSCREEN;
   else
      windowed = GFX_AUTODETECT_WINDOWED;

   /* the title string 
    * The string returned is stored inside of the config system
    * and would be lost if we call pop_config_state(), so we create
    * a copy of it.
    */
   title = ustrdup(get_config_string("content", "headline", "<no headline>"));

   /* the title color 
    * once again this is stored as three ints in one line
    */
   data = get_config_argv("content", "headercolor", &count);
   if (count != 3) {
      /* We expect only 3 parameters */
      allegro_message("Found %i parameters in content.headercolor instead of the 3 expected.\n", count);
      r = g = b = 255;
   }
   else {
      r = atoi(data[0]);
      g = atoi(data[1]);
      b = atoi(data[2]);       
   }

   /* The image file to read 
    * The string returned is stored inside of the config system
    * and would be lost if we call pop_config_state(), so we create
    * a copy of it.
    */   
   filename= ustrdup(get_config_string("content", "image", "mysha.pcx"));

   /* and it's tiling mode */
   display = get_config_int("content", "display", 0);
   if (display <0 || display > 2) {
      allegro_message("content.display must be within 0..2");
      display = 0; 
   } 

   /* restore the old config file */
   pop_config_state();


   /* set the graphics mode */
   set_color_depth(bpp);
   if (set_gfx_mode(windowed, w, h, 0, 0) != 0) {
      allegro_message("Unable to set mode %ix%i with %ibpp\n", w, h, bpp);
      exit(-1);           
   }         

   /* Clear the screen */
   clear_bitmap(screen);   

   /* load the image */
   background = load_bitmap(filename, pal);
   if (background != NULL) {
      set_palette(pal);

      switch (display) {

         case 0: /* stretch */
             stretch_blit(background, screen, 0, 0, background->w, background->h, 0,0, SCREEN_W, SCREEN_H);
         break;

         case 1: /* center */
             blit(background, screen, 0, 0, (SCREEN_W - background->w)/2,(SCREEN_H - background->h)/2, background->w,background->h);
         break;

         case 2: /* tile */
             for (y = 0; y < SCREEN_H; y+= background->h) 
                for (x = 0; x < SCREEN_W; x+= background->w) 
                   blit(background, screen, 0, 0, x, y, background->w,background->h);
         break; 
      }
   }
   else {
      allegro_message("%s not found", filename); 
   }

   text_mode(-1);
   textout_centre(screen, font, title, SCREEN_W/2, 20, makecol(r,g,b));

   readkey();

   free(filename);
   free(title);

   return 0;
}
END_OF_MAIN()

/* works lik strcmp, but ignores case */
int strcmp_no_case(const char *lhs, const char *rhs)
{
    char v;

    while (*lhs && *rhs) {

        v = utolower(*lhs) - utolower(*rhs);
        if (v) 
           return v;

        ++lhs;
        ++rhs;
    }

    if (*lhs) 
       return 1;

    if (*rhs) 
        return -1;

    return 0;
}

--- NEW FILE: exconfig.ini ---
# The ini file consists of sections
# which are marked by [ NAME OF SECTION ]
[graphics]

# mode:
# width height bits per pixel
mode= 640 480 8

# Whether or not the program should run windowed
windowed= FALSE


# the actual content of the screen
[content]

# the header line
headline= Welcome to Allegro
# and it's color in RGB
headercolor= 255 255 255

# the image to display
image= mysha.pcx

# kind of image display
# - 0 : stretch the image to size of screen 
# - 1 : center the image on screen
# - 2 : tile the image on screen
display= 0

Index: examples.txt
===================================================================
RCS file: /cvsroot/alleg/allegro/examples/examples.txt,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- examples.txt	9 Aug 2001 12:43:27 -0000	1.5
+++ examples.txt	18 Mar 2003 11:50:18 -0000	1.6
@@ -7,6 +7,7 @@
 exblend.c  - truecolor translucency
 excamera.c - viewing a 3d world from an arbitrary camera position
 excolmap.c - color mapping table effects, by Grzegorz Hankiewicz
+exconfig.c - using the config routines, by Lennart Steinke
 excustom.c - creating custom GUI objects
 exdata.c   - accessing the contents of datafiles
 exdbuf.c   - double buffering in VGA mode 13h