define.h

Go to the documentation of this file.

#ifndef HEADER_DEFINE
#define HEADER_DEFINE

/* Start declaration constant of define module */

static const char PRGNAME[] = "SMLabyrinth";

static const char PRGVERS[] = "9.10.26";

static const char PRGAUTH[] = 
                "<private>\n"\
                "Email: <info[AT@]pietris[DOT.]net>\n"\
                "\n"\
                "MrC\n"\
                "Email: <info[AT@]pietris[DOT.]net>";

static const char PRGLICS[] =
                "This program is free software:\n"\
                "you can redistribute it and/or modify it\n"\
                "not until you have contacted and received an authorization"\
                " replies from the authors\nand under the terms of the GNU"\
                " General Public License as published by\n"\
                "the Free Software Foundation, either version 3 of the"\
                " License.\nThis program is distributed in the hope that it"\
                " will be useful,\nbut WITHOUT ANY WARRANTY; without even the"\
                " implied warranty of\nMERCHANTABILITY or FITNESS FOR"\
                " A PARTICULAR PURPOSE. See the\nGNU General Public"\
                " License for more details.\nYou should have received a copy"\
                " of the GNU General Public License\nalong with this program."\
                " If not, see <http://www.gnu.org/licenses/>.";

static const char PRGCPYR[] = "Copyright 2009 © MrC";

static const char PRGAIMS[] =
                "Simple game of labyrinth.\n"\
                "<private>";

static const char PRGWBLK[] = 
                "https://www.pietris.net/software/smlabyrinth/";

static const char PRGLOGO[] = "../img/SMLabyrinth.png";

static const char NULLCHAR = '\0';

// Default setting for number of (r)ows and (c)olumns:
// WARNING: - Values must be between 3 and 255.
//          - A schema must be composed at least by 3 rows and 3 columns.
static const unsigned short int MAXR = 100;
static const unsigned short int MAXC = 100;
static const unsigned short int MINR = 5;
static const unsigned short int MINC = 5;


// Default setting for sche(M)a objects:

//schema descriptors:
static const char FREE = '.';
static const char CLOSE = 'X';
static const char DOOR = 'D';
static const char START = 'S';

//visited cell:
// WARNING: Values must be between 0 and 255.
static const unsigned short int UNVISITED = 0;
static const unsigned short int VISIT1 = 1;
static const unsigned short int VISIT2 = 2;

// Characters controls, used as bit mask
// WARNING: values must be progressive positive 2th degrees that 
//          not exceeds 128 (2^7) or sum of already-established 
//          values beetween 0 and 255.
//          Eg. LETTERS = LOWERCASE + UPPERCASE = 3
//          Eg. ALL = 255 (Sum of all possible values)
//          Eg. NOLETTERS = ALL - LETTERS = 252
static const unsigned short int LOWERCASE = 1; // 2^0
static const unsigned short int UPPERCASE = 2; // 2^1
static const unsigned short int DIGITS = 4;    // 2^2

// Default settings for file(s)
static const char RECORD_FILE_NAME[] = "record.txt";
static const char GAMES_DIR[] = "games";
static const char GAMES_LEVEL_DIR[] = "level";


// Default settings for POINTS and similar:
// WARNING: Values must be between 0 and 255.
static const unsigned short int GIVE_BONUS_PERC = 100;
static const unsigned short int NEW_GAME_ROUND = 10;
static const unsigned short int BONUS_POINTS = 10;
static const unsigned short int NO_BONUS_POINTS = 0;
static const unsigned short int SEC_PER_LEVEL = 9;

// WARNING: value must be between 0 and MAX_DIFFICULT.
static const unsigned short int MIN_DIFFICULT = 1;
static const unsigned short int MAX_DIFFICULT = 10;


// Default setting for special characters
// WARNING if changed by default:
static const char COMMENT = '#';
static const char ENDLINE = '\n';


// Default settings for message(s) lenght:
// WARNING: Values must be between 0 and 65535.
static const unsigned int MAX_ERR_BUFFER_LEN = 1000;
static const unsigned int MAX_OTH_BUFFER_LEN = 250;
// WARNING: this two constant must be '#define'
#define MAX_RECORDNAME_LEN 15  

#define MAX_RECORD_SHOW 20 


// DEBUG (Tracing and assertions):
#ifdef DEBUG

    // See SMLabyrinth.c
    extern unsigned int MASK;
    
    static const unsigned int BITMASK_MAX = 255;

    #define DBG(A, B) { if((A & MASK) != 0){B;} } 

#else

    #define DBG(A, B)   

    #define NDEBUG 

#endif

#define ID1 "Trace execution" 

#define D1(a) DBG(1,  a) 

#define ID2 "High-level info" 

#define D2(a) DBG(2,  a) 

#define ID3 "Main cycles info"

#define D3(a) DBG(4,  a)

#define ID4 "Medium-level info"

#define D4(a) DBG(8,  a)

#define ID5 "Low-level info"

#define D5(a) DBG(16, a)

#define ID6 "Programmers details - 1"

#define D6(a) DBG(32, a)

#define ID7 "Programmers details - 2"

#define D7(a) DBG(64, a)

#define ID8 "Programmers details - 3"

#define D8(a) DBG(128,a)

/* End declaration constant of define module */

#endif

---