MadButterfly: include/mb_tools.h annotate

annotate include/mb_tools.h @ 191:18f8c3126cdb

Refine installation instructions and document event dispatching by wycc.

author	Thinker K.F. Li <thinker@branda.to>
date	Tue, 18 Nov 2008 13:55:09 +0800
parents	530bb7728546
children	65cabbdd5284

rev	line source
12 79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	1 #ifndef __TOOLS_H_
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	2 #define __TOOLS_H_
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	3
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	4 typedef struct _elmpool elmpool_t;
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	5
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	6 extern elmpool_t *elmpool_new(int elm_sz, int inc_num);
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	7 extern void elmpool_elm_alloc(elmpool_t pool);
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	8 extern void elmpool_elm_free(elmpool_t pool, void elm);
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	9 extern void elmpool_free(elmpool_t *pool);
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	10
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	11
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	12 #define STAILQ(type) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	13 struct { \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	14 type *head; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	15 type *tail; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	16 }
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	17 #define STAILQ_INIT(q) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	18 do { \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	19 (q).head = (q).tail = NULL; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	20 } while(0)
13 ed55009d96d3 refactory for redrawing Thinker K.F. Li <thinker@branda.to> parents: 12 diff changeset	21 #define STAILQ_CLEAN(q) STAILQ_INIT(q)
12 79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	22 #define STAILQ_HEAD(q) ((q).head)
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	23 #define STAILQ_TAIL(q) ((q).tail)
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	24 #define STAILQ_NEXT(type, field, elm) ((elm)->field)
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	25 #define STAILQ_INS(q, type, field, elm) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	26 do { \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	27 (elm)->field = (q).head; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	28 (q).head = elm; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	29 if((q).tail == NULL) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	30 (q).tail = elm; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	31 } while(0)
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	32 #define STAILQ_INS_TAIL(q, type, field, elm) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	33 do { \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	34 (elm)->field = NULL; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	35 if((q).tail != NULL) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	36 (q).tail->field = elm; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	37 (q).tail = elm; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	38 if((q).head == NULL) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	39 (q).head = elm; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	40 } while(0)
39 db2aa914e14b timer for animation Thinker K.F. Li <thinker@branda.to> parents: 13 diff changeset	41 #define STAILQ_INS_AFTER(type, field, follow, elm) \
db2aa914e14b timer for animation Thinker K.F. Li <thinker@branda.to> parents: 13 diff changeset	42 do { \
db2aa914e14b timer for animation Thinker K.F. Li <thinker@branda.to> parents: 13 diff changeset	43 (follow)->field = (elm)->field; \
db2aa914e14b timer for animation Thinker K.F. Li <thinker@branda.to> parents: 13 diff changeset	44 (elm)->field = follow; \
db2aa914e14b timer for animation Thinker K.F. Li <thinker@branda.to> parents: 13 diff changeset	45 } while(0)
12 79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	46 #define STAILQ_REMOVE(q, type, field, elm) \
96 ca94493b75bb - Thinker K.F. Li <thinker@branda.to> parents: 93 diff changeset	47 do { \
12 79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	48 if((elm) == (q).head) { \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	49 (q).head = (elm)->field; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	50 if((q).head == NULL) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	51 (q).tail = NULL; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	52 } else { \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	53 type *_stailq_cur = (q).head; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	54 while(_stailq_cur != NULL && \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	55 _stailq_cur->field != (elm)) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	56 _stailq_cur = _stailq_cur->field; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	57 if(_stailq_cur != NULL) { \
155 6749f6639924 Fix bug for STAILQ that fail to remove a node. Thinker K.F. Li <thinker@branda.to> parents: 131 diff changeset	58 _stailq_cur->field = (elm)->field; \
12 79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	59 if((q).tail == (elm)) \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	60 (q).tail = _stailq_cur; \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	61 } \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	62 } \
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	63 } while(0)
79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	64
158 c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	65 /*! \defgroup darray Dynamic Array
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	66 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	67 * DARRAY is a dynamic sized array/list, it's length is a variable.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	68 * It is extended, automatically, if it is full and more elemnts are
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	69 * putted in.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	70 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	71 * Users of DARRAY must declare a new type to store data. The way to
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	72 * declear a new type is to invoke DARRAY() with paramters of name of
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	73 * type and type of data to be stored in. The new storage type is named
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	74 * with foo_t where foo is the name you pass in.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	75 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	76 * DARRAY_DEFINE() is inovked to define foo_add() function; foo is name
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	77 * of storage type. You can call foo_add() to add a data element
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	78 * into a storage object.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	79 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	80 * Get ith element in a storage object, use
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	81 * \code
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	82 * obj->ds[i]
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	83 * \endcode
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	84 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	85 * To loop over elements in a storage object, us
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	86 * \code
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	87 * for(i = 0; i < obj->num; i++) {
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	88 * v = obj->ds[i];
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	89 * ......
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	90 * }
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	91 * \endcode
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	92 * @{
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	93 */
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	94 /*! \brief Declare a DARRAY storage type.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	95 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	96 * \param name is name of storage type.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	97 * \param type is type of data elements that will be stored in.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	98 *
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	99 * Type of <name>_t is defined by the macro. It is used to define a
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	100 * storage object to contain data elements.
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	101 */
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	102 #define DARRAY(name, type) \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	103 struct _ ## name { \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	104 int max, num; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	105 type *ds; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	106 }; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	107 typedef struct _ ## name name ## _t
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	108 #define DARRAY_DEFINE(name, type) \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	109 static int name ## _add(name ## _t *da, type v) { \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	110 type *new_ds; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	111 int max; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	112 if(da->num >= (da)->max) { \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	113 max = (da)->max + 32; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	114 new_ds = realloc(da->ds, \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	115 max * sizeof(type)); \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	116 if(new_ds == NULL) return -1; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	117 da->ds = new_ds; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	118 da->max = max; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	119 } \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	120 da->ds[da->num++] = v; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	121 return 0; \
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	122 }
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	123 #define DARRAY_CLEAN(da) do { (da)->num = 0; } while(0)
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	124 #define DARRAY_INIT(da) do { (da)->num = (da)->max = 0; (da)->ds = NULL; }
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	125 #define DARRAY_DESTROY(da) do { if((da)->ds) free((da)->ds); } while(0)
c1cdd3fcd28f Postponing rdman_coord_free() and rdman_remove_shape(). Thinker K.F. Li <thinker@branda.to> parents: 155 diff changeset	126 /* @} */
55 01ed2bc37eed Radial gradient paint Thinker K.F. Li <thinker@branda.to> parents: 39 diff changeset	127
131 6a8588df68af Tank can change direction and navigate on the mud area Thinker K.F. Li <thinker@branda.to> parents: 96 diff changeset	128 #include <stdlib.h>
6a8588df68af Tank can change direction and navigate on the mud area Thinker K.F. Li <thinker@branda.to> parents: 96 diff changeset	129
55 01ed2bc37eed Radial gradient paint Thinker K.F. Li <thinker@branda.to> parents: 39 diff changeset	130 #define O_ALLOC(type) ((type *)malloc(sizeof(type)))
01ed2bc37eed Radial gradient paint Thinker K.F. Li <thinker@branda.to> parents: 39 diff changeset	131
73 9ab15ebc9061 Observer for mouse events Thinker K.F. Li <thinker@branda.to> parents: 55 diff changeset	132 #define OFFSET(type, mem) (((void )&((type )NULL)->mem) - NULL)
9ab15ebc9061 Observer for mouse events Thinker K.F. Li <thinker@branda.to> parents: 55 diff changeset	133 #define MEM2OBJ(var, type, mem) ((type )((void )var - OFFSET(type, mem)))
93 c3c41f88e776 - Thinker K.F. Li <thinker@branda.to> parents: 73 diff changeset	134 #define OFF2TYPE(obj, off, type) ((type )((void *)(obj) + (off)))
73 9ab15ebc9061 Observer for mouse events Thinker K.F. Li <thinker@branda.to> parents: 55 diff changeset	135
12 79e9edf4c00a Add redraw manager Thinker K.F. Li <thinker@branda.to> parents: diff changeset	136 #endif /* __TOOLS_H_ */

Mercurial > MadButterfly

annotate include/mb_tools.h @ 191:18f8c3126cdb