qcsrc/lib/spawnfunc.qh

   1 #ifndef SPAWNFUNC_H
   2 #define SPAWNFUNC_H
   3
   4 /** If this global exists, only functions with spawnfunc_ name prefix qualify as spawn functions */
   5 noref bool require_spawnfunc_prefix;
   6 .bool spawnfunc_checked;
   7
   8 // Optional type checking; increases compile time too much to be enabled by default
   9 #if 0
  10         bool entityfieldassignablefromeditor(int i)
  11         {
  12                 switch (entityfieldtype(i))
  13                 {
  14                         case FIELD_STRING:
  15                         case FIELD_FLOAT:
  16                         case FIELD_VECTOR:
  17                                 return true;
  18                 }
  19                 return false;
  20         }
  21
  22         #define _spawnfunc_checktypes(fld) \
  23                 if (fieldname == #fld) \
  24                         if (!entityfieldassignablefromeditor(i)) LOG_FATALF("Entity field '%s' cannot be whitelisted\n", fieldname);
  25 #else
  26         #define _spawnfunc_checktypes(fld)
  27 #endif
  28         #define _spawnfunc_check(fld) \
  29                 if (fieldname == #fld) continue;
  30
  31                 #define spawnfunc_1(id, whitelist) spawnfunc_2(id, whitelist)
  32         #define spawnfunc_2(id, whitelist) \
  33                 void spawnfunc_##id(entity this) \
  34                 { \
  35                         this = self; \
  36                         if (!this.sourceLocFile) \
  37                         { \
  38                                 this.sourceLocFile = __FILE__; \
  39                                 this.sourceLocLine = __LINE__; \
  40                         } \
  41                         if (!this.spawnfunc_checked) \
  42                         { \
  43                                 for (int i = 0, n = numentityfields(); i < n; ++i) \
  44                                 { \
  45                                         string value = getentityfieldstring(i, this); \
  46                                         string fieldname = entityfieldname(i); \
  47                                         whitelist(_spawnfunc_checktypes) \
  48                                         if (value == "") continue; \
  49                                         if (fieldname == "") continue; \
  50                                         FIELDS_COMMON(_spawnfunc_check) \
  51                                         whitelist(_spawnfunc_check) \
  52                                         LOG_WARNINGF(_("Entity field %s.%s (%s) is not whitelisted. If you believe this is an error, please file an issue.\n"), #id, fieldname, value); \
  53                                 } \
  54                                 this.spawnfunc_checked = true; \
  55                         } \
  56                 } \
  57                 [[accumulate]] void spawnfunc_##id(entity this)
  58
  59         #define FIELD_SCALAR(fld, n) \
  60                 fld(n)
  61         #define FIELD_VEC(fld, n) \
  62                 fld(n) \
  63                 fld(n##_x) \
  64                 fld(n##_y) \
  65                 fld(n##_z)
  66
  67         #define FIELDS_NONE(fld)
  68         #define FIELDS_ALL(fld) if (false)
  69
  70         #define FIELDS_COMMON(fld) \
  71                 FIELD_SCALAR(fld, classname) \
  72                 FIELD_SCALAR(fld, spawnfunc_checked) \
  73                 /**/
  74
  75         #define FIELDS_UNION(fld) \
  76                 FIELD_SCALAR(fld, sourceLocFile) \
  77                 FIELD_SCALAR(fld, sourceLocLine) \
  78                 FIELD_SCALAR(fld, Version) \
  79                 FIELD_SCALAR(fld, ammo_cells) \
  80                 FIELD_SCALAR(fld, ammo_nails) \
  81                 FIELD_SCALAR(fld, ammo_rockets) \
  82                 FIELD_SCALAR(fld, armorvalue) \
  83                 FIELD_SCALAR(fld, atten) \
  84                 FIELD_SCALAR(fld, bgmscriptdecay) \
  85                 FIELD_SCALAR(fld, bgmscriptsustain) \
  86                 FIELD_SCALAR(fld, bgmscript) \
  87                 FIELD_SCALAR(fld, button0) \
  88                 FIELD_SCALAR(fld, cnt) \
  89                 FIELD_SCALAR(fld, colormap) \
  90                 FIELD_SCALAR(fld, count) \
  91                 FIELD_SCALAR(fld, curvetarget) \
  92                 FIELD_SCALAR(fld, cvarfilter) \
  93                 FIELD_SCALAR(fld, debrisdamageforcescale) \
  94                 FIELD_SCALAR(fld, debrisfadetime) \
  95                 FIELD_SCALAR(fld, debristimejitter) \
  96                 FIELD_SCALAR(fld, debristime) \
  97                 FIELD_SCALAR(fld, debris) \
  98                 FIELD_SCALAR(fld, delay) \
  99                 FIELD_SCALAR(fld, dmgtime) \
 100                 FIELD_SCALAR(fld, dmg) \
 101                 FIELD_SCALAR(fld, dmg_edge) \
 102                 FIELD_SCALAR(fld, dmg_force) \
 103                 FIELD_SCALAR(fld, dmg_radius) \
 104                 FIELD_SCALAR(fld, effects) \
 105                 FIELD_SCALAR(fld, flags) \
 106                 FIELD_SCALAR(fld, fog) \
 107                 FIELD_SCALAR(fld, frags) \
 108                 FIELD_SCALAR(fld, frame) \
 109                 FIELD_SCALAR(fld, gametypefilter) \
 110                 FIELD_SCALAR(fld, geomtype) \
 111                 FIELD_SCALAR(fld, gravity) \
 112                 FIELD_SCALAR(fld, health) \
 113                 FIELD_SCALAR(fld, height) \
 114                 FIELD_SCALAR(fld, impulse) \
 115                 FIELD_SCALAR(fld, killtarget) \
 116                 FIELD_SCALAR(fld, lerpfrac) \
 117                 FIELD_SCALAR(fld, light_lev) \
 118                 FIELD_SCALAR(fld, lip) \
 119                 FIELD_SCALAR(fld, loddistance1) \
 120                 FIELD_SCALAR(fld, lodmodel1) \
 121                 FIELD_SCALAR(fld, ltime) \
 122                 FIELD_SCALAR(fld, mdl) \
 123                 FIELD_SCALAR(fld, message2) \
 124                 FIELD_SCALAR(fld, message) \
 125                 FIELD_SCALAR(fld, modelindex) \
 126                 FIELD_SCALAR(fld, modelscale) \
 127                 FIELD_SCALAR(fld, model) \
 128                 FIELD_SCALAR(fld, monster_moveflags) \
 129                 FIELD_SCALAR(fld, movetype) \
 130                 FIELD_SCALAR(fld, netname) \
 131                 FIELD_SCALAR(fld, nextthink) \
 132                 FIELD_SCALAR(fld, noalign) \
 133                 FIELD_SCALAR(fld, noise1) \
 134                 FIELD_SCALAR(fld, noise2) \
 135                 FIELD_SCALAR(fld, noise) \
 136                 FIELD_SCALAR(fld, phase) \
 137                 FIELD_SCALAR(fld, platmovetype) \
 138                 FIELD_SCALAR(fld, race_place) \
 139                 FIELD_SCALAR(fld, radius) \
 140                 FIELD_SCALAR(fld, respawntimejitter) \
 141                 FIELD_SCALAR(fld, respawntime) \
 142                 FIELD_SCALAR(fld, restriction) \
 143                 FIELD_SCALAR(fld, scale) \
 144                 FIELD_SCALAR(fld, skin) \
 145                 FIELD_SCALAR(fld, solid) \
 146                 FIELD_SCALAR(fld, sound1) \
 147                 FIELD_SCALAR(fld, sounds) \
 148                 FIELD_SCALAR(fld, spawnflags) \
 149                 FIELD_SCALAR(fld, speed) \
 150                 FIELD_SCALAR(fld, strength) \
 151                 FIELD_SCALAR(fld, target2) \
 152                 FIELD_SCALAR(fld, target3) \
 153                 FIELD_SCALAR(fld, target4) \
 154                 FIELD_SCALAR(fld, targetname) \
 155                 FIELD_SCALAR(fld, target) \
 156                 FIELD_SCALAR(fld, target_random) \
 157                 FIELD_SCALAR(fld, target_range) \
 158                 FIELD_SCALAR(fld, team) \
 159                 FIELD_SCALAR(fld, turret_scale_health) \
 160                 FIELD_SCALAR(fld, turret_scale_range) \
 161                 FIELD_SCALAR(fld, turret_scale_respawn) \
 162                 FIELD_SCALAR(fld, volume) \
 163                 FIELD_SCALAR(fld, wait) \
 164                 FIELD_SCALAR(fld, warpzone_fadeend) \
 165                 FIELD_SCALAR(fld, warpzone_fadestart) \
 166                 FIELD_SCALAR(fld, weapon) \
 167                 FIELD_VEC(fld, absmax) \
 168                 FIELD_VEC(fld, absmin) \
 169                 FIELD_VEC(fld, angles) \
 170                 FIELD_VEC(fld, avelocity) \
 171                 FIELD_VEC(fld, maxs) \
 172                 FIELD_VEC(fld, maxs) \
 173                 FIELD_VEC(fld, mins) \
 174                 FIELD_VEC(fld, modelscale_vec) \
 175                 FIELD_VEC(fld, origin) \
 176                 FIELD_VEC(fld, velocity) \
 177                 /**/
 178
 179         #define spawnfunc(...) EVAL(OVERLOAD(spawnfunc, __VA_ARGS__, FIELDS_UNION))
 180
 181 #endif