From: TimePath Date: Wed, 6 May 2015 06:12:05 +0000 (+1000) Subject: Use stock dpdefs X-Git-Tag: xonotic-v0.8.1~61^2~4 X-Git-Url: https://git.rm.cloudns.org/?a=commitdiff_plain;h=b272480aa87f05e4118dd91a9434f13c8984f594;p=xonotic%2Fxonotic-data.pk3dir.git Use stock dpdefs --- diff --git a/qcsrc/common/stats.qh b/qcsrc/common/stats.qh index 481713cc9..f888e1b2c 100644 --- a/qcsrc/common/stats.qh +++ b/qcsrc/common/stats.qh @@ -5,23 +5,38 @@ // 255 is the current limit (MAX_CL_STATS - 1), engine will need to be modified if you wish to add more stats const int MAX_CL_STATS = 256; -const int STAT_HEALTH = 0; +// -Wdouble-declaration +// const int STAT_HEALTH = 0; // 1 empty? const int STAT_WEAPON = 2; -const int STAT_AMMO = 3; -const int STAT_ARMOR = 4; -const int STAT_WEAPONFRAME = 5; -const int STAT_SHELLS = 6; -const int STAT_NAILS = 7; -const int STAT_ROCKETS = 8; -const int STAT_CELLS = 9; -const int STAT_ACTIVEWEAPON = 10; -const int STAT_TOTALSECRETS = 11; -const int STAT_TOTALMONSTERS = 12; -const int STAT_SECRETS = 13; -const int STAT_MONSTERS = 14; -const int STAT_ITEMS = 15; -const int STAT_VIEWHEIGHT = 16; +// -Wdouble-declaration +// const int STAT_AMMO = 3; +// -Wdouble-declaration +// const int STAT_ARMOR = 4; +// -Wdouble-declaration +// const int STAT_WEAPONFRAME = 5; +// -Wdouble-declaration +// const int STAT_SHELLS = 6; +// -Wdouble-declaration +// const int STAT_NAILS = 7; +// -Wdouble-declaration +// const int STAT_ROCKETS = 8; +// -Wdouble-declaration +// const int STAT_CELLS = 9; +// -Wdouble-declaration +// const int STAT_ACTIVEWEAPON = 10; +// -Wdouble-declaration +// const int STAT_TOTALSECRETS = 11; +// -Wdouble-declaration +// const int STAT_TOTALMONSTERS = 12; +// -Wdouble-declaration +// const int STAT_SECRETS = 13; +// -Wdouble-declaration +// const int STAT_MONSTERS = 14; +// -Wdouble-declaration +// const int STAT_ITEMS = 15; +// -Wdouble-declaration +// const int STAT_VIEWHEIGHT = 16; // 17 empty? // 18 empty? // 19 empty? @@ -270,14 +285,19 @@ const int STAT_MOVEVARS_AIRSTOPACCELERATE = 231; const int STAT_MOVEVARS_AIRSTRAFEACCELERATE = 232; const int STAT_MOVEVARS_MAXAIRSTRAFESPEED = 233; const int STAT_MOVEVARS_AIRCONTROL = 234; -const int STAT_FRAGLIMIT = 235; -const int STAT_TIMELIMIT = 236; +// -Wdouble-declaration +// const int STAT_FRAGLIMIT = 235; +// -Wdouble-declaration +// const int STAT_TIMELIMIT = 236; const int STAT_MOVEVARS_WALLFRICTION = 237; const int STAT_MOVEVARS_FRICTION = 238; const int STAT_MOVEVARS_WATERFRICTION = 239; -const int STAT_MOVEVARS_TICRATE = 240; -const int STAT_MOVEVARS_TIMESCALE = 241; -const int STAT_MOVEVARS_GRAVITY = 242; +// -Wdouble-declaration +// const int STAT_MOVEVARS_TICRATE = 240; +// -Wdouble-declaration +// const int STAT_MOVEVARS_TIMESCALE = 241; +// -Wdouble-declaration +// const int STAT_MOVEVARS_GRAVITY = 242; const int STAT_MOVEVARS_STOPSPEED = 243; const int STAT_MOVEVARS_MAXSPEED = 244; const int STAT_MOVEVARS_SPECTATORMAXSPEED = 245; diff --git a/qcsrc/dpdefs/csprogsdefs.qh b/qcsrc/dpdefs/csprogsdefs.qh index 136d7ca1d..c4d8c54ce 100644 --- a/qcsrc/dpdefs/csprogsdefs.qh +++ b/qcsrc/dpdefs/csprogsdefs.qh @@ -3,1456 +3,17 @@ #pragma noref 1 -/* -============================================================================== +#define true _true +#define false _false +#define TRUE _TRUE +#define FALSE _FALSE - SOURCE FOR GLOBALVARS_T C STRUCTURE - MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR +#include "upstream/csprogsdefs.qc" -============================================================================== -*/ - -// -// system globals -// -entity self; -entity other; -entity world; -float time; -float frametime; - -int player_localentnum; //the entnum -int player_localnum; //the playernum -float maxclients; //a constant filled in by the engine. gah, portability eh? - -float clientcommandframe; //player movement -float servercommandframe; //clientframe echoed off the server - -string mapname; - -// -// global variables set by built in functions -// -vector v_forward, v_up, v_right; // set by makevectors() - -// set by traceline / tracebox -float trace_allsolid; -float trace_startsolid; -float trace_fraction; -vector trace_endpos; -vector trace_plane_normal; -float trace_plane_dist; -entity trace_ent; -float trace_inopen; -float trace_inwater; - -// -// required prog functions -// -void() CSQC_Init; -void() CSQC_Shutdown; -float(float f, float t, float n) CSQC_InputEvent; -void(float w, float h) CSQC_UpdateView; -bool(string s) CSQC_ConsoleCommand; - -//these fields are read and set by the default player physics -vector pmove_org; -vector pmove_vel; -vector pmove_mins; -vector pmove_maxs; -//retrieved from the current movement commands (read by player physics) -float input_timelength; -vector input_angles; -vector input_movevalues; //forwards, right, up. -int input_buttons; //attack, use, jump (default physics only uses jump) - -float movevar_gravity; -float movevar_stopspeed; -float movevar_maxspeed; -float movevar_spectatormaxspeed; //used by NOCLIP movetypes. -float movevar_accelerate; -float movevar_airaccelerate; -float movevar_wateraccelerate; -float movevar_friction; -float movevar_waterfriction; -float movevar_entgravity; //the local player's gravity field. Is a multiple (1 is the normal value) - -//================================================ -void end_sys_globals; // flag for structure dumping -//================================================ - -/* -============================================================================== - - SOURCE FOR ENTVARS_T C STRUCTURE - MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR - -============================================================================== -*/ - -// -// system fields (*** = do not set in prog code, maintained by C code) -// -.int modelindex; // *** model index in the precached list -.vector absmin, absmax; // *** origin + mins / maxs - -.int entnum; // *** the ent number as on the server -.float drawmask; -.void() predraw; - -.float movetype; -.float solid; - -.vector origin; // *** -.vector oldorigin; // *** -.vector velocity; -.vector angles; -.vector avelocity; - -.string classname; // spawn function -.string model; -.int frame; -.int skin; -.int effects; - -.vector mins, maxs; // bounding box extents reletive to origin -.vector size; // maxs - mins - -.void() touch; -.void() use; -.void() think; -.void() blocked; // for doors or plats, called when can't push other - -.float nextthink; - -.entity chain; - -.string netname; - -.entity enemy; - -.int flags; - -.int colormap; - -.entity owner; // who launched a missile - -//================================================ -void end_sys_fields; // flag for structure dumping -//================================================ - -/* -============================================================================== - - OPTIONAL FIELDS AND GLOBALS - -============================================================================== -*/ - -// Additional OPTIONAL Fields and Globals -float intermission; // indicates intermission state (0 = normal, 1 = scores, 2 = finale text) - -vector view_angles; // same as input_angles -vector view_punchangle; // from server -vector view_punchvector; // from server - -/* -============================================================================== - - CONSTANT DEFINITIONS - -============================================================================== -*/ - -const int MASK_ENGINE = 1; -const int MASK_ENGINEVIEWMODELS = 2; -const int MASK_NORMAL = 4; - -const int RF_VIEWMODEL = 1; -const int RF_EXTERNALMODEL = 2; -const int RF_DEPTHHACK = 4; -const int RF_ADDITIVE = 8; -const int RF_USEAXIS = 16; - -const int VF_MIN = 1; //(vector) -const int VF_MIN_X = 2; //(float) -const int VF_MIN_Y = 3; //(float) -const int VF_SIZE = 4; //(vector) (viewport size) -const int VF_SIZE_Y = 5; //(float) -const int VF_SIZE_X = 6; //(float) -const int VF_VIEWPORT = 7; //(vector, vector) -const int VF_FOV = 8; //(vector) -const int VF_FOVX = 9; //(float) -const int VF_FOVY = 10; //(float) -const int VF_ORIGIN = 11; //(vector) -const int VF_ORIGIN_X = 12; //(float) -const int VF_ORIGIN_Y = 13; //(float) -const int VF_ORIGIN_Z = 14; //(float) -const int VF_ANGLES = 15; //(vector) -const int VF_ANGLES_X = 16; //(float) -const int VF_ANGLES_Y = 17; //(float) -const int VF_ANGLES_Z = 18; //(float) -const int VF_DRAWWORLD = 19; //(float) -const int VF_DRAWENGINESBAR = 20; //(float) -const int VF_DRAWCROSSHAIR = 21; //(float) - -const int VF_CL_VIEWANGLES = 33; //(vector) -const int VF_CL_VIEWANGLES_X = 34; //(float) -const int VF_CL_VIEWANGLES_Y = 35; //(float) -const int VF_CL_VIEWANGLES_Z = 36; //(float) - -const int VF_PERSPECTIVE = 200; - -//const int STAT_HEALTH = 0; -//const int STAT_WEAPONMODEL = 2; -//const int STAT_AMMO = 3; -//const int STAT_ARMOR = 4; -//const int STAT_WEAPONFRAME = 5; -//const int STAT_SHELLS = 6; -//const int STAT_NAILS = 7; -//const int STAT_ROCKETS = 8; -//const int STAT_CELLS = 9; -//const int STAT_ACTIVEWEAPON = 10; -//const int STAT_TOTALSECRETS = 11; -//const int STAT_TOTALMONSTERS = 12; -//const int STAT_SECRETS = 13; -//const int STAT_MONSTERS = 14; -//const int STAT_ITEMS = 15; -//const int STAT_VIEWHEIGHT = 16; - -// Quake Sound Constants -const int CHAN_AUTO = 0; -const int CHAN_WEAPON = 1; -const int CHAN_VOICE = 2; -const int CHAN_ITEM = 3; -const int CHAN_BODY = 4; - -const int ATTN_NONE = 0; -const int ATTN_NORM = 1; -const int ATTN_IDLE = 2; -const int ATTN_STATIC = 3; - -// Frik File Constants -const int FILE_READ = 0; -const int FILE_APPEND = 1; -const int FILE_WRITE = 2; - -// Quake Point Contents -const int CONTENT_EMPTY = -1; -const int CONTENT_SOLID = -2; -const int CONTENT_WATER = -3; -const int CONTENT_SLIME = -4; -const int CONTENT_LAVA = -5; -const int CONTENT_SKY = -6; - -// Quake Solid Constants -const int SOLID_NOT = 0; -const int SOLID_TRIGGER = 1; -const int SOLID_BBOX = 2; -const int SOLID_SLIDEBOX = 3; -const int SOLID_BSP = 4; -const int SOLID_CORPSE = 5; - -// Quake Move Constants -const int MOVE_NORMAL = 0; -const int MOVE_NOMONSTERS = 1; -const int MOVE_MISSILE = 2; - -const float EXTRA_LOW = -99999999; -const float EXTRA_HIGH = 99999999; - -const vector VEC_1 = '1 1 1'; -const vector VEC_0 = '0 0 0'; -const vector VEC_M1 = '-1 -1 -1'; - -//const float M_PI = 3.14159265358979323846; - -const vector VEC_HULL_MIN = '-16 -16 -24'; -const vector VEC_HULL_MAX = '16 16 32'; - -// Quake Temporary Entity Constants -const int TE_SPIKE = 0; -const int TE_SUPERSPIKE = 1; -const int TE_GUNSHOT = 2; -const int TE_EXPLOSION = 3; -const int TE_TAREXPLOSION = 4; -const int TE_LIGHTNING1 = 5; -const int TE_LIGHTNING2 = 6; -const int TE_WIZSPIKE = 7; -const int TE_KNIGHTSPIKE = 8; -const int TE_LIGHTNING3 = 9; -const int TE_LAVASPLASH = 10; -const int TE_TELEPORT = 11; -const int TE_EXPLOSION2 = 12; - -// Darkplaces Additions -const int TE_EXPLOSIONRGB = 53; -const int TE_GUNSHOTQUAD = 57; -const int TE_EXPLOSIONQUAD = 70; -const int TE_SPIKEQUAD = 58; -const int TE_SUPERSPIKEQUAD = 59; - -// PFlags for Dynamic Lights -const int PFLAGS_NOSHADOW = 1; -const int PFLAGS_CORONA = 2; -const int PFLAGS_FULLDYNAMIC = 128; - -const int EF_ADDITIVE = 32; -const int EF_BLUE = 64; -const int EF_FLAME = 1024; -const int EF_FULLBRIGHT = 512; -const int EF_NODEPTHTEST = 8192; -const int EF_NODRAW = 16; -const int EF_NOSHADOW = 4096; -const int EF_RED = 128; -const int EF_STARDUST = 2048; -const int EF_SELECTABLE = 16384; - -const int PFL_ONGROUND = 1; -const int PFL_CROUCH = 2; -const int PFL_DEAD = 4; -const int PFL_GIBBED = 8; - -// draw flags -const int DRAWFLAG_NORMAL = 0; -const int DRAWFLAG_ADDITIVE = 1; -const int DRAWFLAG_MODULATE = 2; -const int DRAWFLAG_2XMODULATE = 3; -const int DRAWFLAG_SCREEN = 4; -const int DRAWFLAG_MIPMAP = 0x100; // only for R_BeginPolygon - -/* -============================================================================== - - BUILTIN DEFINITIONS - EXTENSIONS ARE NOT ADDED HERE, BUT BELOW! - -============================================================================== -*/ - -void(vector ang) makevectors = #1; -void(entity e, vector o) setorigin = #2; -void(entity e, string m) setmodel = #3; -void(entity e, vector min, vector max) setsize = #4; - -void() break_to_debugger = #6; -float() random = #7; -void(entity e, float chan, string samp) sound = #8; -vector(vector v) normalize = #9; -void(string e) error = #10; -void(string e) objerror = #11; -float(vector v) vlen = #12; -float(vector v) vectoyaw = #13; -entity() spawn = #14; -void(entity e) remove = #15; -float(vector v1, vector v2, float tryents, entity ignoreentity) traceline = #16; - -entity(entity start, .string fld, string match) find = #18; -void(string s) precache_sound = #19; -void(string s) precache_model = #20; - -entity(vector org, float rad) findradius = #22; - -void(string s, ...) dprint = #25; -string(float f) ftos = #26; -string(vector v) vtos = #27; -void() coredump = #28; -void() traceon = #29; -void() traceoff = #30; -void(entity e) eprint = #31; -// settrace optional -float(float yaw, float dist, float settrace) walkmove = #32; - -float() droptofloor = #34; -void(float style, string value) lightstyle = #35; -int(float v) rint = #36; -int(float v) floor = #37; -int(float v) ceil = #38; - -float(entity e) checkbottom = #40; -float(vector v) pointcontents = #41; - -float(float f) fabs = #43; - -float(string s) cvar = #45; -void(string s, ...) localcmd = #46; -entity(entity e) nextent = #47; -void(vector o, vector d, float color, float count) particle = #48; -void() ChangeYaw = #49; - -vector(vector v) vectoangles = #51; -vector(vector v, vector w) vectoangles2 = #51; - -float(float f) sin = #60; -float(float f) cos = #61; -float(float f) sqrt = #62; -void(entity ent) changepitch = #63; -void(entity e, entity ignore) tracetoss = #64; -string(entity ent) etos = #65; - -string(string s) precache_file = #68; -void(entity e) makestatic = #69; - -void(string name, string value) cvar_set = #72; - -void(vector pos, string samp, float vol, float atten) ambientsound = #74; -string(string s) precache_model2 = #75; -string(string s) precache_sound2 = #76; -string(string s) precache_file2 = #77; - -float(string s) stof = #81; - - -void(vector v1, vector min, vector max, vector v2, float nomonsters, entity forent) tracebox = #90; -vector() randomvec = #91; -vector(vector org) getlight = #92; -vector(vector org, float lpflags) getlight2 = #92; -vector getlight_dir; -vector getlight_ambient; -vector getlight_diffuse; -const float LP_LIGHTMAP = 1; -const float LP_RTWORLD = 2; -const float LP_DYNLIGHT = 4; -const float LP_COMPLETE = 7; - -float(string name, string value) registercvar = #93; -float( float a, ... ) min = #94; -float( float b, ... ) max = #95; -float(float minimum, float val, float maximum) bound = #96; -float(float f, float f) pow = #97; -entity(entity start, .float fld, float match) findfloat = #98; -float(string s) checkextension = #99; -// FrikaC and Telejano range #100-#199 - -int(string filename, int mode) fopen = #110; -void(float fhandle) fclose = #111; -string(float fhandle) fgets = #112; -void(float fhandle, string s) fputs = #113; -float(string s) strlen = #114; -string(...) strcat = #115; -string(string s, float start, float length) substring = #116; -vector(string) stov = #117; -string(string s) strzone = #118; -void(string s) strunzone = #119; - -// FTEQW range #200-#299 - -float(float number, float quantity) bitshift = #218; - -//float(string str, string sub[, float startpos]) strstrofs = #221; -int(string str, string sub, float startpos) strstrofs = #221; -int(string str, float ofs) str2chr = #222; -string(int c, ...) chr2str = #223; -string(float ccase, float calpha, float cnum, string s, ...) strconv = #224; -string(float chars, string s, ...) strpad = #225; -string(string info, string key, string value, ...) infoadd = #226; -string(string info, string key) infoget = #227; -int(string s1, string s2) strcmp = #228; -int(string s1, string s2, float len) strncmp = #228; -int(string s1, string s2) strcasecmp = #229; -int(string s1, string s2, float len) strncasecmp = #230; - -// CSQC range #300-#399 -void() clearscene = #300; -void(float mask) addentities = #301; -void(entity ent) addentity = #302; -float(float property, ...) setproperty = #303; -float(float property) getproperty = #309; -vector(float property) getpropertyvec = #309; -void() renderscene = #304; -void(vector org, float radius, vector lightcolours) adddynamiclight = #305; -void(vector org, float radius, vector lightcolours, float style, string cubemapname, float pflags) adddynamiclight2 = #305; -//void(string texturename, float flag[, float is2d, float lines]) R_BeginPolygon = #306; -void(string texturename, float flag, ...) R_BeginPolygon = #306; -void(vector org, vector texcoords, vector rgb, float alpha) R_PolygonVertex = #307; -void() R_EndPolygon = #308; -vector (vector v) cs_unproject = #310; -vector (vector v) cs_project = #311; - -void(float width, vector pos1, vector pos2, float flag) drawline = #315; -float(string name) iscachedpic = #316; -string(string name, ...) precache_pic = #317; -string(string name) precache_cubemap = #317; -vector(string picname) draw_getimagesize = #318; -void(string name) freepic = #319; -float(vector position, float character, vector scale, vector rgb, float alpha, float flag) drawcharacter = #320; -float(vector position, string text, vector scale, vector rgb, float alpha, float flag) drawstring = #321; -float(vector position, string pic, vector size, vector rgb, float alpha, float flag) drawpic = #322; -float(vector position, vector size, vector rgb, float alpha, float flag) drawfill = #323; -void(float x, float y, float width, float height) drawsetcliparea = #324; -void(void) drawresetcliparea = #325; -float(vector position, string text, vector scale, float alpha, float flag) drawcolorcodedstring = #326; -vector(vector position, string text, vector scale, vector rgb, float alpha, float flag) drawcolorcodedstring2 = #326; - -float(int stnum) getstatf = #330; -int(int stnum, ...) getstati = #331; // can optionally take first bit and count -string(float firststnum) getstats = #332; -void(entity e, float mdlindex) setmodelindex = #333; -string(float mdlindex) modelnameforindex = #334; -int(string effectname) particleeffectnum = #335; -void(entity ent, float effectnum, vector start, vector end) trailparticles = #336; -//void(float effectnum, vector origin [, vector dir, float count]) pointparticles = #337; -void(float effectnum, vector origin , vector dir, float count) pointparticles = #337; -void(string s, ...) centerprint = #338; -void(string s, ...) print = #339; -string(float keynum) keynumtostring = #340; -float(string keyname) stringtokeynum = #341; -string(float keynum) getkeybind = #342; -void(float usecursor) setcursormode = #343; -vector() getmousepos = #344; -float(float framenum) getinputstate = #345; -void(float sens) setsensitivityscale = #346; -void(...) runstandardplayerphysics = #347; // this may or may not take a player ent -string(float playernum, string keyname) getplayerkeyvalue = #348; -float() isdemo = #349; -float() isserver = #350; -void(vector origin, vector forward, vector right, vector up) SetListener = #351; -void(string cmdname) registercommand = #352; -float(entity ent) wasfreed = #353; -string(string key) serverkey = #354; - -// Use proper case; refer to the id1 Write* functions! -int() ReadByte = #360; -int() ReadChar = #361; -int() ReadShort = #362; -int() ReadLong = #363; -float() ReadCoord = #364; -float() ReadAngle = #365; -string() ReadString = #366; -float() ReadFloat = #367; - -// LordHavoc's range #400-#499 -void(entity from, entity to) copyentity = #400; - -entity(.string fld, string match) findchain = #402; -entity(.float fld, float match) findchainfloat = #403; -void(vector org, string modelname, float startframe, float endframe, float framerate) effect = #404; -void(vector org, vector velocity, float howmany) te_blood = #405; -void(vector mincorner, vector maxcorner, float explosionspeed, float howmany) te_bloodshower = #406; -void(vector org, vector color) te_explosionrgb = #407; -void(vector mincorner, vector maxcorner, vector vel, float howmany, float color, float gravityflag, float randomveljitter) te_particlecube = #408; -void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlerain = #409; -void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlesnow = #410; -void(vector org, vector vel, float howmany) te_spark = #411; -void(vector org) te_gunshotquad = #412; -void(vector org) te_spikequad = #413; -void(vector org) te_superspikequad = #414; -void(vector org) te_explosionquad = #415; -void(vector org) te_smallflash = #416; -void(vector org, float radius, float lifetime, vector color) te_customflash = #417; -void(vector org) te_gunshot = #418; -void(vector org) te_spike = #419; -void(vector org) te_superspike = #420; -void(vector org) te_explosion = #421; -void(vector org) te_tarexplosion = #422; -void(vector org) te_wizspike = #423; -void(vector org) te_knightspike = #424; -void(vector org) te_lavasplash = #425; -void(vector org) te_teleport = #426; -void(vector org, float colorstart, float colorlength) te_explosion2 = #427; -void(entity own, vector start, vector end) te_lightning1 = #428; -void(entity own, vector start, vector end) te_lightning2 = #429; -void(entity own, vector start, vector end) te_lightning3 = #430; -void(entity own, vector start, vector end) te_beam = #431; -void(vector dir) vectorvectors = #432; -void(vector org) te_plasmaburn = #433; -//float(entity e, float s) getsurfacenumpoints = #434; -//vector(entity e, float s, float n) getsurfacepoint = #435; -//vector(entity e, float s) getsurfacenormal = #436; -//string(entity e, float s) getsurfacetexture = #437; -//float(entity e, vector p) getsurfacenearpoint = #438; -//vector(entity e, float s, vector p) getsurfaceclippedpoint = #439; - -int(string s) tokenize = #441; -string(float n) argv = #442; -void(entity e, entity tagentity, string tagname) setattachment = #443; -float(string pattern, float caseinsensitive, float quiet) search_begin = #444; -void(float handle) search_end = #445; -float(float handle) search_getsize = #446; -string(float handle, float num) search_getfilename = #447; -string(string s) cvar_string = #448; -entity(entity start, .float fld, float match) findflags = #449; -entity(.float fld, float match) findchainflags = #450; -int(entity ent, string tagname) gettagindex = #451; -vector(entity ent, float tagindex) gettaginfo = #452; - -void(vector org, vector vel, float howmany) te_flamejet = #457; - -entity(float num) entitybyindex = #459; -int() buf_create = #460; -void(float bufhandle) buf_del = #461; -float(float bufhandle) buf_getsize = #462; -void(float bufhandle_from, float bufhandle_to) buf_copy = #463; -void(float bufhandle, float sortpower, float backward) buf_sort = #464; -string(float bufhandle, string glue) buf_implode = #465; -string(float bufhandle, float string_index) bufstr_get = #466; -void(float bufhandle, float string_index, string str) bufstr_set = #467; -float(float bufhandle, string str, float order) bufstr_add = #468; -void(float bufhandle, float string_index) bufstr_free = #469; - -//float(float s) asin = #471; -//float(float c) acos = #472; -//float(float t) atan = #473; -//float(float c, float s) atan2 = #474; -//float(float a) tan = #475; -float(string s) strippedstringlen = #476; -float(string s) strlennocol = #476; // This is the correct name for the function, but not removing the decolorizedstring mapping. -string(string s) decolorizedstring = #477; -string(string s) strdecolorize = #477; // This is the correct name for the function, but not removing the decolorizedstring mapping. -string(float uselocaltime, string format, ...) strftime = #478; -string(string s) strtolower = #480; -string(string s) strtoupper = #481; -string(string s) cvar_defstring = #482; -void(vector origin, string sample, float volume, float attenuation) pointsound = #483; -string(string search, string replace, string subject) strreplace = #484; -string(string search, string replace, string subject) strireplace = #485; -//vector(entity e, float s, float n, float a) getsurfacepointattribute = #486; -#ifdef SUPPORT_GECKO -float gecko_create( string name ) = #487; -void gecko_destroy( string name ) = #488; -void gecko_navigate( string name, string URI ) = #489; -float gecko_keyevent( string name, float key, float eventtype ) = #490; -void gecko_mousemove( string name, float x, float y ) = #491; -void gecko_resize( string name, float w, float h ) = #492; -vector gecko_get_texture_extent( string name ) = #493; -#else - -#endif - -/* -============================================================================== - - EXTENSION DEFINITIONS - -============================================================================== -*/ - -// DP_CSQC_SPAWNPARTICLE -// idea: VorteX -// darkplaces implementation: VorteX -// constant definitions: -// particle base behavior: -float PT_ALPHASTATIC = 1; -float PT_STATIC = 2; -float PT_SPARK = 3; -float PT_BEAM = 4; -float PT_RAIN = 5; -float PT_RAINDECAL = 6; -float PT_SNOW = 7; -float PT_BUBBLE = 8; -float PT_BLOOD = 9; -float PT_SMOKE = 10; -float PT_DECAL = 11; -float PT_ENTITYPARTICLE = 12; -// particle blendtypes: -float PBLEND_ALPHA = 0; -float PBLEND_ADD = 1; -float PBLEND_INVMOD = 2; -// particle orientation: -float PARTICLE_BILLBOARD = 0; -float PARTICLE_SPARK = 1; -float PARTICLE_ORIENTED_DOUBLESIDED = 2; -float PARTICLE_BEAM = 3; -// global definitions: -float particle_type; // one of PT_ -float particle_blendmode; // one of PBLEND_ values -float particle_orientation; // one of PARTICLE_ values -vector particle_color1; -vector particle_color2; -float particle_tex; // number of chunk in particlefont -float particle_size; -float particle_sizeincrease; -float particle_alpha; -float particle_alphafade; -float particle_time; -float particle_gravity; -float particle_bounce; -float particle_airfriction; -float particle_liquidfriction; -float particle_originjitter; -float particle_velocityjitter; -float particle_qualityreduction; // enable culling of this particle when FPS is low -float particle_stretch; -vector particle_staincolor1; -vector particle_staincolor2; -float particle_staintex; -float particle_stainalpha; -float particle_stainsize; -float particle_delayspawn; -float particle_delaycollision; -float particle_angle; -float particle_spin; -// builtin definitions: -float(float max_themes) initparticlespawner = #522; // check fields/globals for integration and enable particle spawner, return 1 is succeded, otherwise returns 0 -void() resetparticle = #523; // reset p_ globals to default theme #0 -void(float theme) particletheme = #524; // restore p_ globals from saved theme -float() particlethemesave = #525; // save p_ globals to new particletheme and return it's index -void(float theme) particlethemeupdate = #525; // save p_ globals to new particletheme and return it's index -void(float theme) particlethemefree = #526; // delete a particle theme -float(vector org, vector vel) spawnparticle = #527; // returns 0 when failed, 1 when spawned -float(vector org, vector vel, float theme) quickparticle = #527; // not reading globals, just theme, returns 0 when failed, 1 when spawned -float(vector org, vector vel, float delay, float collisiondelay) delayedparticle = #528; -float(vector org, vector vel, float delay, float collisiondelay, float theme) quickdelayedparticle = #528; -// description: this builtin provides an easy and flexible way to spawn particles, -// it is not created as replace for DP_SV_POINTPARTICLES but as an addition to it. -// With this extension you can create a specific particles like rain particles, or entity particles -// notes: -// 1) 0 is default particle template, it could be changed -// 2) color vectors could have value 0-255 of each component -// restrictions: max themes could be between 4 and 2048 -// warning: you should call initparticlespawner() at very beginning BEFORE all other particle spawner functions -// function to query particle info -// don't remove this function as it protects all particle_ globals from FTEQCC/FRIKQCC non-referenced removal optimisation -void() printparticle = -{ - // vortex: this also protects from 'non-referenced' optimisation on some compilers - print("PARTICLE:\n"); - print(strcat(" type: ", ftos(particle_type), "\n")); - print(strcat(" blendmode: ", ftos(particle_blendmode), "\n")); - print(strcat(" orientation: ", ftos(particle_orientation), "\n")); - print(strcat(" color1: ", vtos(particle_color1), "\n")); - print(strcat(" color2: ", vtos(particle_color2), "\n")); - print(strcat(" tex: ", ftos(particle_tex), "\n")); - print(strcat(" size: ", ftos(particle_size), "\n")); - print(strcat(" sizeincrease: ", ftos(particle_sizeincrease), "\n")); - print(strcat(" alpha: ", ftos(particle_alpha), "\n")); - print(strcat(" alphafade: ", ftos(particle_alphafade), "\n")); - print(strcat(" time: ", ftos(particle_time), "\n")); - print(strcat(" gravity: ", ftos(particle_gravity), "\n")); - print(strcat(" bounce: ", ftos(particle_bounce), "\n")); - print(strcat(" airfriction: ", ftos(particle_airfriction), "\n")); - print(strcat(" liquidfriction: ", ftos(particle_liquidfriction), "\n")); - print(strcat(" originjitter: ", ftos(particle_originjitter), "\n")); - print(strcat(" velocityjitter: ", ftos(particle_velocityjitter), "\n")); - print(strcat(" qualityreduction: ", ftos(particle_qualityreduction), "\n")); - print(strcat(" stretch: ", ftos(particle_stretch), "\n")); - print(strcat(" staincolor1: ", vtos(particle_staincolor1), "\n")); - print(strcat(" staincolor2: ", vtos(particle_staincolor2), "\n")); - print(strcat(" staintex: ", ftos(particle_staintex), "\n")); - print(strcat(" stainalpha: ", ftos(particle_stainalpha), "\n")); - print(strcat(" stainsize: ", ftos(particle_stainsize), "\n")); - print(strcat(" delayspawn: ", ftos(particle_delayspawn), "\n")); - print(strcat(" delaycollision: ", ftos(particle_delaycollision), "\n")); - print(strcat(" angle: ", ftos(particle_angle), "\n")); - print(strcat(" spin: ", ftos(particle_spin), "\n")); -} - -// DP_CSQC_ENTITYTRANSPARENTSORTING_OFFSET -// idea: VorteX -// darkplaces implementation: VorteX -float RF_USETRANSPARENTOFFSET = 64; // enables transparent origin offsetting -// global definitions -float transparent_offset; // should be set before entity is added -// description: offset a model's meshes origin used for transparent sorting. Could be used to tweak sorting bugs on very large transparent entities or hacking transparent sorting order for certain objects -// example: transparent_offset = 1000000; // entity always appear on background of other transparents -// note: offset is done in view forward axis - -// DP_CSQC_ENTITYWORLDOBJECT -// idea: VorteX -// darkplaces implementation: VorteX -const float RF_WORLDOBJECT = 128; -// description: when renderflag is set, engine will not use culling methods for this entity, e.g. it will always be drawn -// useful for large outdoor objects (like asteroids on sky horizon or sky models) - -// DP_CSQC_ENTITYMODELLIGHT -// idea: VorteX -// darkplaces implementation: VorteX -const float RF_MODELLIGHT = 4096; -.vector modellight_ambient; -.vector modellight_diffuse; -.vector modellight_dir; -// description: allows CSQC to override directional model lightning on entity - -// DP_CSQC_SETPAUSE -// idea: VorteX -// darkplaces implementation: VorteX -// builtin definitions: -void(float ispaused) setpause = #531; -// description: provides ability to set pause in local games (similar to one set once console is activated) -// not stopping sound/cd track, useful for inventory screens, ingame menus with input etc. - -// DP_CSQC_QUERYRENDERENTITY -// idea: VorteX -// darkplaces implementation: VorteX -// constant definitions: -// render entity fields: -float E_ACTIVE = 0; // float 0/1 -float E_ORIGIN = 1; // vector -float E_FORWARD = 2; // vector -float E_RIGHT = 3; // vector -float E_UP = 4; // vector -float E_SCALE = 5; // float -float E_ORIGINANDVECTORS = 6; // returns origin, + sets v_* vectors to orientation -float E_ALPHA = 7; // float -float E_COLORMOD = 8; // vector -float E_PANTSCOLOR = 9; // vector -float E_SHIRTCOLOR = 10; // vector -float E_SKIN = 11; // float -float E_MINS = 12; // vector -float E_MAXS = 13; // vector -float E_ABSMIN = 14; // vector -float E_ABSMAX = 15; // vector -float E_LIGHT = 16; // vector - modellight -// builtin definitions: -float(float entitynum, float fldnum) getentity = #504; -vector(float entitynum, float fldnum) getentityvec = #504; -// description: allows to query parms from render entities, especially useful with attaching CSQC ents to -// server entities networked and interpolated by engine (monsters, players), number of entity is it's SVQC number -// you can send it via tempentity/CSQC entity message. Note that this builtin doesnt know about entity removing/reallocating -// so it's meaning to work for short period of time, dont use it on missiles/grenades whatever will be removed next five seconds - -//DP_GFX_FONTS -//idea: Blub\0, divVerent -//darkplaces implementation: Blub\0 -//console commands: -// loadfont fontname fontmaps size1 size2 ... -// A font can simply be gfx/tgafile (freetype fonts doent need extension), -// or alternatively you can specify multiple fonts and faces -// Like this: gfx/vera-sans:2,gfx/fallback:1 -// to load face 2 of the font gfx/vera-sans and use face 1 -// of gfx/fallback as fallback font -// You can also specify a list of font sizes to load, like this: -// loadfont console gfx/conchars,gfx/fallback 8 12 16 24 32 -// In many cases, 8 12 16 24 32 should be a good choice. -// for slots see: -//constant definitions: -float drawfont; // set it before drawstring()/drawchar() calls -float FONT_DEFAULT = 0; // 'default' -float FONT_CONSOLE = 1; // 'console', REALLY should be fixed width (ls!) -float FONT_SBAR = 2; // 'sbar', used on hud, must be fixed width -float FONT_NOTIFY = 3; // 'notify', used on sprint/bprint -float FONT_CHAT = 4; // 'chat' -float FONT_CENTERPRINT = 5;// 'centerprint' -float FONT_INFOBAR = 6; // 'infobar' -float FONT_MENU = 7; // 'menu', should be fixed width -float FONT_USER0 = 8; // 'user0', userdefined fonts -float FONT_USER1 = 9; // 'user1', userdefined fonts -float FONT_USER2 = 10; // 'user2', userdefined fonts -float FONT_USER3 = 11; // 'user3', userdefined fonts -float FONT_USER4 = 12; // 'user4', userdefined fonts -float FONT_USER5 = 13; // 'user5', userdefined fonts -float FONT_USER6 = 14; // 'user6', userdefined fonts -float FONT_USER7 = 15; // 'user7' slot, userdefined fonts -//builtin definitions: -float findfont(string s) = #356; // find font by fontname and return it's index -float loadfont(string fontname, string fontmaps, string sizes, float slot, float fix_scale, float fix_voffset) = #357; -// loads font immediately so stringwidth() function can be used just after builtin call -// returns a font slotnum (which is used to set drawfont to) -// first 3 parms are identical to "loadfont" console command ones -// slot could be one of FONT_ constants or result of findfont() or -1 to not use it -// if slot is given, font will be loaded to this slotnum and fontname become new title for it -// this way you can rename user* fonts to something more usable -// fix_* parms let you fix badly made fonts by applying some transformations to them -// fix_scale : per-character center-oriented scale (doesn't change line height at all) -// fix_voffset : vertical offset for each character, it's a multiplier to character height -float stringwidth(string text, float allowColorCodes, vector size) = #327; // get a width of string with given font and char size -float stringwidth_menu(string text, float allowColorCodes, vector size) = #468; // in menu.dat it has different builtin # -//description: engine support for custom fonts in console, hud, qc etc. -// limits: -// max 128 chars for font name -// max 3 font fallbacks -// max 8 sizes per font - -//DP_GFX_FONTS_FREETYPE -//idea: Blub\0, divVerent -//darkplaces implementation: Blub\0 -//cvar definitions: -// r_font_disable_freetype 0/1 : disable freetype fonts loading (uttetly disables freetype library initialization) -// r_font_antialias 0/1 : antialiasing when loading font -// r_font_hint 0/1/2/3 : hinting when loading font, 0 is no hinting, 1 light autohinting , 2 full autohinting, 3 full hinting -// r_font_postprocess_blur X : font outline blur amount -// r_font_postprocess_outline X : font outline width -// r_font_postprocess_shadow_x X : font outline shadow x shift amount, applied during outlining -// r_font_postprocess_shadow_y X : font outline shadow y shift amount, applied during outlining -// r_font_postprocess_shadow_z X : font outline shadow z shift amount, applied during blurring -//description: engine support for truetype/freetype fonts -//so .AFM+.PFB/.OTF/.TTF files could be stuffed as fontmaps in loadfont() -//(console command version will support them as well) - -//DP_CSQC_BINDMAPS -//idea: daemon, motorsep -//darkplaces implementation: divVerent -//builtin definitions: -string(float key, float bindmap) getkeybind_bindmap = #342; -float(float key, string bind, float bindmap) setkeybind_bindmap = #630; -vector(void) getbindmaps = #631; -float(vector bm) setbindmaps = #632; -string(string command, float bindmap) findkeysforcommand = #610; -// float(string key) stringtokeynum = #341; -// string(float keynum) keynumtostring = #340; -//description: key bind setting/getting including support for switchable -//bindmaps. - -//DP_CRYPTO -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: (CSQC) -float(string url, float id, string content_type, string delim, float buf, float keyid) crypto_uri_postbuf = #513; -//description: -//use -1 as buffer handle to justs end delim as postdata - -//DP_CSQC_MAINVIEW -//idea: divVerent -//darkplaces implementation: divVerent -//constant definitions: -const int VF_MAINVIEW = 400; -//use setproperty(VF_MAINVIEW, 1); before calling R_RenderView for the render -//that shall become the "main" view, which is e.g. used by PRYDON_CLIENTCURSOR -//this flag is set for the first scene, and not cleared by R_ClearScene -//this flag is automatically cleared by R_RenderView -//so when not using this extension, the first view rendered is the main view - -//DP_CSQC_MINFPS_QUALITY -//idea: divVerent -//darkplaces implementation: divVerent -//constant definitions: -const int VF_MINFPS_QUALITY = 401; -//use getproperty(VF_MINFPS_QUALITY); to do CSQC based LOD based on cl_minfps -//1 should lead to an unmodified view - -//DP_CSQC_V_CALCREFDEF_WIP1 -//DP_CSQC_V_CALCREFDEF_WIP2 -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -void(entity e, float refdefflags) V_CalcRefdef = #640; -//constant definitions: -const int PMF_DUCKED = 4; -const int PMF_ONGROUND = 8; -const int REFDEFFLAG_TELEPORTED = 1; -const int REFDEFFLAG_JUMPING = 2; -const int REFDEFFLAG_DEAD = 4; -const int REFDEFFLAG_INTERMISSION = 8; -//- use this on the player entity after performing prediction -//- pass REFDEFFLAG_TELEPORTED if the player teleported since last frame -//- pass REFDEFFLAG_JUMPING if jump button is pressed -//- pass REFDEFFLAG_DEAD if dead (DP_CSQC_V_CALCREFDEF_WIP2) -//- pass REFDEFFLAG_INTERMISSION if in intermission (DP_CSQC_V_CALCREFDEF_WIP2) -//- the player entity needs to have origin, velocity, pmove_flags set according -// to prediction (the above two PMF_ flags are used in the player's pmove_flags) -//- NOTE: to check for this, ALSO OR a check with DP_CSQC_V_CALCREFDEF to also support -// the finished extension once done - -// assorted builtins -float drawsubpic(vector position, vector size, string pic, vector srcPosition, vector srcSize, vector rgb, float alpha, float flag) = #328; -vector drawgetimagesize(string pic) = #318; -const float SPA_POSITION = 0; -const float SPA_S_AXIS = 1; -const float SPA_T_AXIS = 2; -const float SPA_R_AXIS = 3; -const float SPA_TEXCOORDS0 = 4; -const float SPA_LIGHTMAP0_TEXCOORDS = 5; -const float SPA_LIGHTMAP_COLOR = 6; -float (entity e, float s) getsurfacenumpoints = #434; -vector (entity e, float s, float n) getsurfacepoint = #435; -vector (entity e, float s) getsurfacenormal = #436; -string (entity e, float s) getsurfacetexture = #437; -float (entity e, vector p) getsurfacenearpoint = #438; -vector (entity e, float s, vector p) getsurfaceclippedpoint = #439; -vector(entity e, float s, float n, float a) getsurfacepointattribute = #486; -float(entity e, float s) getsurfacenumtriangles = #628; -vector(entity e, float s, float n) getsurfacetriangle = #629; - -//DP_QC_ASINACOSATANATAN2TAN -//idea: Urre -//darkplaces implementation: LordHavoc -//constant definitions: -float DEG2RAD = 0.0174532925199432957692369076848861271344287188854172545609719144; -float RAD2DEG = 57.2957795130823208767981548141051703324054724665643215491602438612; -float PI = 3.1415926535897932384626433832795028841971693993751058209749445923; -//builtin definitions: -float(float s) asin = #471; // returns angle in radians for a given sin() value, the result is in the range -PI*0.5 to PI*0.5 -float(float c) acos = #472; // returns angle in radians for a given cos() value, the result is in the range 0 to PI -float(float t) atan = #473; // returns angle in radians for a given tan() value, the result is in the range -PI*0.5 to PI*0.5 -float(float c, float s) atan2 = #474; // returns angle in radians for a given cos() and sin() value pair, the result is in the range -PI to PI (this is identical to vectoyaw except it returns radians rather than degrees) -float(float a) tan = #475; // returns tangent value (which is simply sin(a)/cos(a)) for the given angle in radians, the result is in the range -infinity to +infinity -//description: -//useful math functions for analyzing vectors, note that these all use angles in radians (just like the cos/sin functions) not degrees unlike makevectors/vectoyaw/vectoangles, so be sure to do the appropriate conversions (multiply by DEG2RAD or RAD2DEG as needed). -//note: atan2 can take unnormalized vectors (just like vectoyaw), and the function was included only for completeness (more often you want vectoyaw or vectoangles), atan2(v_x,v_y) * RAD2DEG gives the same result as vectoyaw(v) - -//DP_QC_SPRINTF -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -string(string format, ...) sprintf = #627; -//description: -//you know sprintf :P -//supported stuff: -// % -// optional: $ for the argument to format -// flags: #0- + -// optional: , *, or *$ for the field width -// optional: ., .*, or .*$ for the precision -// length modifiers: h for forcing a float, l for forcing an int/entity (by default, %d etc. cast a float to int) -// conversions: -// d takes a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an int -// i takes an int/entity if no length is specified or i is, and a float if h is specified as length, and cast it to an int -// ouxXc take a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an unsigned int -// eEfFgG take a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to a double -// s takes a string -// vV takes a vector, and processes the three components as if it were a gG for all three components, separated by space -// For conversions s and c, the flag # makes precision and width interpreted -// as byte count, by default it is interpreted as character count in UTF-8 -// enabled engines. No other conversions can create wide characters, and # -// has another meaning in these. - -//DP_QC_GETTIME -//idea: tZork -//darkplaces implementation: tZork, divVerent -//constant definitions: -float GETTIME_FRAMESTART = 0; // time of start of frame -float GETTIME_REALTIME = 1; // current time (may be OS specific) -float GETTIME_HIRES = 2; // like REALTIME, but may reset between QC invocations and thus can be higher precision -float GETTIME_UPTIME = 3; // time since start of the engine -//builtin definitions: -float(float tmr) gettime = #519; -//description: -//some timers to query... - -//DP_QC_GETTIME_CDTRACK -//idea: divVerent -//darkplaces implementation: divVerent -//constant definitions: -float GETTIME_CDTRACK = 4; -//description: -//returns the playing time of the current cdtrack when passed to gettime() -//see DP_END_GETSOUNDTIME for similar functionality but for entity sound channels - -//DP_QC_TOKENIZEBYSEPARATOR -//idea: Electro, SavageX, LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -int(string s, string separator1, ...) tokenizebyseparator = #479; -//description: -//this function returns tokens separated by any of the supplied separator strings, example: -//numnumbers = tokenizebyseparator("10.2.3.4", "."); -//returns 4 and the tokens are "10" "2" "3" "4" -//possibly useful for parsing IPv4 addresses (such as "1.2.3.4") and IPv6 addresses (such as "[1234:5678:9abc:def0:1234:5678:9abc:def0]:26000") - -//DP_QC_TOKENIZE_CONSOLE -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -int(string s) tokenize_console = #514; -int(float i) argv_start_index = #515; -int(float i) argv_end_index = #516; -//description: -//this function returns tokens separated just like the console does -//also, functions are provided to get the index of the first and last character of each token in the original string -//Passing negative values to them, or to argv, will be treated as indexes from the LAST token (like lists work in Perl). So argv(-1) will return the LAST token. - -//DP_SND_SOUND7_WIP1 -//DP_SND_SOUND7_WIP2 -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -void(entity e, float chan, string samp, float vol, float atten, float speed, float flags) sound7 = #8; -float SOUNDFLAG_RELIABLE = 1; -//description: -//plays a sound, with some more flags -//extensions to sound(): -//- channel may be in the range from -128 to 127; channels -128 to 0 are "auto", -// i.e. support multiple sounds at once, but cannot be stopped/restarted -//- a value 0 in the speed parameter means no change; otherwise, it is a -// percentage of playback speed ("pitch shifting"). 100 is normal pitch, 50 is -// half speed, 200 is double speed, etc. (DP_SND_SOUND7_WIP2) -//- the flag SOUNDFLAG_RELIABLE can be specified, which makes the sound send -// to MSG_ALL (reliable) instead of MSG_BROADCAST (unreliable, default); -// similarily, SOUNDFLAG_RELIABLE_TO_ONE sends to MSG_ONE -//- channel 0 is controlled by snd_channel0volume; channel 1 and -1 by -// snd_channel1volume, etc. (so, a channel shares the cvar with its respective -// auto-channel); however, the mod MUST define snd_channel8volume and upwards -// in default.cfg if they are to be used, as the engine does not create them -// to not litter the cvar list -//- this extension applies to CSQC as well; CSQC_Event_Sound will get speed and -// flags as extra 7th and 8th argument -//- WIP2 ideas: SOUNDFLAG_RELIABLE_TO_ONE, SOUNDFLAG_NOPHS, SOUNDFLAG_FORCELOOP -//- NOTE: to check for this, ALSO OR a check with DP_SND_SOUND7 to also support -// the finished extension once done - -//DP_PRECACHE_PIC_FLAGS -//idea: divVerent -//darkplaces implementation: divVerent -//constant definitions: -float PRECACHE_PIC_FROMWAD = 1; // this one actually is part of EXT_CSQC -float PRECACHE_PIC_NOTPERSISTENT = 2; // picture may get deallocated when unused -float PRECACHE_PIC_MIPMAP = 8; // mipmap the texture for possibly better downscaling at memory expense -//notes: these constants are given as optional second argument to precache_pic() - -//DP_QC_TRACE_MOVETYPE_WORLDONLY -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//constant definitions: -const float MOVE_WORLDONLY = 3; -//description: -//allows traces to hit only world (ignoring all entities, unlike MOVE_NOMONSTERS which hits all bmodels), use as the nomonsters parameter to trace functions - -//DP_SND_GETSOUNDTIME -//idea: VorteX -//darkplaces implementation: VorteX -//constant definitions: -float(entity e, float channel) getsoundtime = #533; // get currently sound playing position on entity channel, -1 if not playing or error -float(string sample) soundlength = #534; // returns length of sound sample in seconds, -1 on error (sound not precached, sound system not initialized etc.) -//description: provides opportunity to query length of sound samples and realtime tracking of sound playing on entities (similar to DP_GETTIME_CDTRACK) -//note: beware dedicated server not running sound engine at all, so in dedicated mode this builtins will not work in server progs -//note also: menu progs not supporting getsoundtime() (will give a warning) since it has no sound playing on entities -//examples of use: -// - QC-driven looped sounds -// - QC events when sound playing is finished -// - toggleable ambientsounds -// - subtitles - -//DP_QC_NUM_FOR_EDICT -//idea: Blub\0 -//darkplaces implementation: Blub\0 -//Function to get the number of an entity - a clean way. -float(entity num) num_for_edict = #512; - -//DP_TRACE_HITCONTENTSMASK_SURFACEINFO -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//globals: -.int dphitcontentsmask; // if non-zero on the entity passed to traceline/tracebox/tracetoss this will override the normal collidable contents rules and instead hit these contents values (for example AI can use tracelines that hit DONOTENTER if it wants to, by simply changing this field on the entity passed to traceline), this affects normal movement as well as trace calls -float trace_dpstartcontents; // DPCONTENTS_ value at start position of trace -int trace_dphitcontents; // DPCONTENTS_ value of impacted surface (not contents at impact point, just contents of the surface that was hit) -int trace_dphitq3surfaceflags; // Q3SURFACEFLAG_ value of impacted surface -string trace_dphittexturename; // texture name of impacted surface -//constants: -const int DPCONTENTS_SOLID = 1; // hit a bmodel, not a bounding box -const int DPCONTENTS_WATER = 2; -const int DPCONTENTS_SLIME = 4; -const int DPCONTENTS_LAVA = 8; -const int DPCONTENTS_SKY = 16; -const int DPCONTENTS_BODY = 32; // hit a bounding box, not a bmodel -const int DPCONTENTS_CORPSE = 64; // hit a SOLID_CORPSE entity -const int DPCONTENTS_NODROP = 128; // an area where backpacks should not spawn -const int DPCONTENTS_PLAYERCLIP = 256; // blocks player movement -const int DPCONTENTS_MONSTERCLIP = 512; // blocks monster movement -const int DPCONTENTS_DONOTENTER = 1024; // AI hint brush -const int DPCONTENTS_LIQUIDSMASK = 14; // WATER | SLIME | LAVA -const int DPCONTENTS_BOTCLIP = 2048; // AI hint brush -const int DPCONTENTS_OPAQUE = 4096; // only fully opaque brushes get this (may be useful for line of sight checks) -const int Q3SURFACEFLAG_NODAMAGE = 1; -const int Q3SURFACEFLAG_SLICK = 2; // low friction surface -const int Q3SURFACEFLAG_SKY = 4; // sky surface (also has NOIMPACT and NOMARKS set) -const int Q3SURFACEFLAG_LADDER = 8; // climbable surface -const int Q3SURFACEFLAG_NOIMPACT = 16; // projectiles should remove themselves on impact (this is set on sky) -const int Q3SURFACEFLAG_NOMARKS = 32; // projectiles should not leave marks, such as decals (this is set on sky) -const int Q3SURFACEFLAG_FLESH = 64; // projectiles should do a fleshy effect (blood?) on impact -const int Q3SURFACEFLAG_NODRAW = 128; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_HINT = 256; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_SKIP = 512; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_NOLIGHTMAP = 1024; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_POINTLIGHT = 2048; // compiler hint (not important to qc) -const int Q3SURFACEFLAG_METALSTEPS = 4096; // walking on this surface should make metal step sounds -const int Q3SURFACEFLAG_NOSTEPS = 8192; // walking on this surface should not make footstep sounds -const int Q3SURFACEFLAG_NONSOLID = 16384; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_LIGHTFILTER = 32768; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_ALPHASHADOW = 65536; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_NODLIGHT = 131072; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_DUST = 262144; // translucent 'light beam' effect (not important to qc) -//description: -//adds additional information after a traceline/tracebox/tracetoss call. -//also (very important) sets trace_* globals before calling .touch functions, -//this allows them to inspect the nature of the collision (for example -//determining if a projectile hit sky), clears trace_* variables for the other -//object in a touch event (that is to say, a projectile moving will see the -//trace results in its .touch function, but the player it hit will see very -//little information in the trace_ variables as it was not moving at the time) - -//DP_QC_CVAR_TYPE -//idea: divVerent -//DarkPlaces implementation: divVerent -//builtin definitions: -float(string name) cvar_type = #495; -const int CVAR_TYPEFLAG_EXISTS = 1; -const int CVAR_TYPEFLAG_SAVED = 2; -const int CVAR_TYPEFLAG_PRIVATE = 4; -const int CVAR_TYPEFLAG_ENGINE = 8; -const int CVAR_TYPEFLAG_HASDESCRIPTION = 16; -const int CVAR_TYPEFLAG_READONLY = 32; - -//DP_QC_CRC16 -//idea: divVerent -//darkplaces implementation: divVerent -//Some hash function to build hash tables with. This has to be be the CRC-16-CCITT that is also required for the QuakeWorld download protocol. -//When caseinsensitive is set, the CRC is calculated of the lower cased string. -int(bool caseinsensitive, string s, ...) crc16 = #494; - -//DP_QC_URI_ESCAPE -//idea: divVerent -//darkplaces implementation: divVerent -//URI::Escape's functionality -string(string in) uri_escape = #510; -string(string in) uri_unescape = #511; - -//DP_QC_DIGEST -//idea: motorsep, Spike -//DarkPlaces implementation: divVerent -//builtin definitions: -string(string digest, string data, ...) digest_hex = #639; -//description: -//returns a given hex digest of given data -//the returned digest is always encoded in hexadecimal -//only the "MD4" digest is always supported! -//if the given digest is not supported, string_null is returned -//the digest string is matched case sensitively, use "MD4", not "md4"! - -//DP_QC_DIGEST_SHA256 -//idea: motorsep, Spike -//DarkPlaces implementation: divVerent -//description: -//"SHA256" is also an allowed digest type - -//DP_QC_LOG -//darkplaces implementation: divVerent -//builtin definitions: -float log(float f) = #532; -//description: -//logarithm - -//FTE_CSQC_SKELETONOBJECTS -//idea: Spike, LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -// all skeleton numbers are 1-based (0 being no skeleton) -// all bone numbers are 1-based (0 being invalid) -float(float modlindex) skel_create = #263; // create a skeleton (be sure to assign this value into .skeletonindex for use), returns skeleton index (1 or higher) on success, returns 0 on failure (for example if the modelindex is not skeletal), it is recommended that you create a new skeleton if you change modelindex, as the skeleton uses the hierarchy from the model. -float(float skel, entity ent, float modlindex, float retainfrac, float firstbone, float lastbone) skel_build = #264; // blend in a percentage of standard animation, 0 replaces entirely, 1 does nothing, 0.5 blends half, etc, and this only alters the bones in the specified range for which out of bounds values like 0,100000 are safe (uses .frame, .frame2, .frame3, .frame4, .lerpfrac, .lerpfrac3, .lerpfrac4, .frame1time, .frame2time, .frame3time, .frame4time), returns skel on success, 0 on failure -float(float skel) skel_get_numbones = #265; // returns how many bones exist in the created skeleton, 0 if skeleton does not exist -string(float skel, float bonenum) skel_get_bonename = #266; // returns name of bone (as a tempstring), "" if invalid bonenum (< 1 for example) or skeleton does not exist -int(float skel, float bonenum) skel_get_boneparent = #267; // returns parent num for supplied bonenum, 0 if bonenum has no parent or bone does not exist (returned value is always less than bonenum, you can loop on this) -int(float skel, string tagname) skel_find_bone = #268; // get number of bone with specified name, 0 on failure, bonenum (1-based) on success, same as using gettagindex but takes modelindex instead of entity -vector(float skel, float bonenum) skel_get_bonerel = #269; // get matrix of bone in skeleton relative to its parent - sets v_forward, v_right, v_up, returns origin (relative to parent bone) -vector(float skel, float bonenum) skel_get_boneabs = #270; // get matrix of bone in skeleton in model space - sets v_forward, v_right, v_up, returns origin (relative to entity) -void(float skel, float bonenum, vector org) skel_set_bone = #271; // set matrix of bone relative to its parent, reads v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) -void(float skel, float bonenum, vector org) skel_mul_bone = #272; // transform bone matrix (relative to its parent) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) -void(float skel, float startbone, float endbone, vector org) skel_mul_bones = #273; // transform bone matrices (relative to their parents) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bones) -void(float skeldst, float skelsrc, float startbone, float endbone) skel_copybones = #274; // copy bone matrices (relative to their parents) from one skeleton to another, useful for copying a skeleton to a corpse -void(float skel) skel_delete = #275; // deletes skeleton at the beginning of the next frame (you can add the entity, delete the skeleton, renderscene, and it will still work) -float(float modlindex, string framename) frameforname = #276; // finds number of a specified frame in the animation, returns -1 if no match found -float(float modlindex, float framenum) frameduration = #277; // returns the intended play time (in seconds) of the specified framegroup, if it does not exist the result is 0, if it is a single frame it may be a small value around 0.1 or 0. -//fields: -.float skeletonindex; // active skeleton overriding standard animation on model -.int frame; // primary framegroup animation (strength = 1 - lerpfrac - lerpfrac3 - lerpfrac4) -.int frame2; // secondary framegroup animation (strength = lerpfrac) -.int frame3; // tertiary framegroup animation (strength = lerpfrac3) -.int frame4; // quaternary framegroup animation (strength = lerpfrac4) -.float lerpfrac; // strength of framegroup blend -.float lerpfrac3; // strength of framegroup blend -.float lerpfrac4; // strength of framegroup blend -.float frame1time; // start time of framegroup animation -.float frame2time; // start time of framegroup animation -.float frame3time; // start time of framegroup animation -.float frame4time; // start time of framegroup animation -//description: -//this extension provides a way to do complex skeletal animation on an entity. -// -//see also DP_SKELETONOBJECTS (this extension implemented on server as well as client) -// -//notes: -//each model contains its own skeleton, reusing a skeleton with incompatible models will yield garbage (or not render). -//each model contains its own animation data, you can use animations from other model files (for example saving out all character animations as separate model files). -//if an engine supports loading an animation-only file format such as .md5anim in FTEQW, it can be used to animate any model with a compatible skeleton. -//proper use of this extension may require understanding matrix transforms (v_forward, v_right, v_up, origin), and you must keep in mind that v_right is negative for this purpose. -// -//features include: -//multiple animations blended together. -//animating a model with animations from another model with a compatible skeleton. -//restricting animation blends to certain bones of a model - for example independent animation of legs, torso, head. -//custom bone controllers - for example making eyes track a target location. -// -// -// -//example code follows... -// -//this helper function lets you identify (by parentage) what group a bone -//belongs to - for example "torso", "leftarm", would return 1 ("torso") for -//all children of the bone named "torso", unless they are children of -//"leftarm" (which is a child of "torso") which would return 2 instead... -float(float skel, float bonenum, string g1, string g2, string g3, string g4, string g5, string g6) example_skel_findbonegroup = -{ - string bonename; - while (bonenum >= 0) - { - bonename = skel_get_bonename(skel, bonenum); - if (bonename == g1) return 1; - if (bonename == g2) return 2; - if (bonename == g3) return 3; - if (bonename == g4) return 4; - if (bonename == g5) return 5; - if (bonename == g6) return 6; - bonenum = skel_get_boneparent(skel, bonenum); - } - return 0; -}; -// create a skeletonindex for our player using current modelindex -void() example_skel_player_setup = -{ - self.skeletonindex = skel_create(self.modelindex); -}; -// setup bones of skeleton based on an animation -// note: animmodelindex can be a different model than self.modelindex -void(float animmodelindex, float framegroup, float framegroupstarttime) example_skel_player_update_begin = -{ - // start with our standard animation - self.frame = framegroup; - self.frame2 = 0; - self.frame3 = 0; - self.frame4 = 0; - self.frame1time = framegroupstarttime; - self.frame2time = 0; - self.frame3time = 0; - self.frame4time = 0; - self.lerpfrac = 0; - self.lerpfrac3 = 0; - self.lerpfrac4 = 0; - skel_build(self.skeletonindex, self, animmodelindex, 0, 0, 100000); -}; -// apply a different framegroup animation to bones with a specified parent -void(float animmodelindex, float framegroup, float framegroupstarttime, float blendalpha, string groupbonename, string excludegroupname1, string excludegroupname2) example_skel_player_update_applyoverride = -{ - self.frame = framegroup; - self.frame2 = 0; - self.frame3 = 0; - self.frame4 = 0; - self.frame1time = framegroupstarttime; - self.frame2time = 0; - self.frame3time = 0; - self.frame4time = 0; - self.lerpfrac = 0; - self.lerpfrac3 = 0; - self.lerpfrac4 = 0; - float bonenum = 0; - float numbones = skel_get_numbones(self.skeletonindex); - while (bonenum < numbones) - { - if (example_skel_findbonegroup(self.skeletonindex, bonenum, groupbonename, excludegroupname1, excludegroupname2, "", "", "") == 1) - skel_build(self.skeletonindex, self, animmodelindex, 1 - blendalpha, bonenum, bonenum + 1); - bonenum = bonenum + 1; - } -}; -// make eyes point at a target location, be sure v_forward, v_right, v_up are set correctly before calling -void(vector eyetarget, string bonename) example_skel_player_update_eyetarget = -{ - float bonenum = skel_find_bone(self.skeletonindex, bonename) - 1; - if (bonenum < 0) - return; - vector oldforward = v_forward; - vector oldright = v_right; - vector oldup = v_up; - vector v = eyetarget - self.origin; - vector modeleyetarget; - modeleyetarget.x = v * v_forward; - modeleyetarget.y = 0-v * v_right; - modeleyetarget.z = v * v_up; - // this is an eyeball, make it point at the target location - // first get all the data we can... - vector relorg = skel_get_bonerel(self.skeletonindex, bonenum); - vector relforward = v_forward; - vector relright = v_right; - vector relup = v_up; - vector boneorg = skel_get_boneabs(self.skeletonindex, bonenum); - vector boneforward = v_forward; - vector boneright = v_right; - vector boneup = v_up; - vector parentorg = skel_get_boneabs(self.skeletonindex, skel_get_boneparent(self.skeletonindex, bonenum)); - vector parentforward = v_forward; - vector parentright = v_right; - vector parentup = v_up; - // get the vector from the eyeball to the target - vector u = modeleyetarget - boneorg; - // now transform it inversely by the parent matrix to produce new rel vectors - v.x = u * parentforward; - v.y = u * parentright; - v.z = u * parentup; - vector ang = vectoangles2(v, relup); - ang.x = 0 - ang.x; - makevectors(ang); - // set the relative bone matrix - skel_set_bone(self.skeletonindex, bonenum, relorg); - // restore caller's v_ vectors - v_forward = oldforward; - v_right = oldright; - v_up = oldup; -}; -// delete skeleton when we're done with it -// note: skeleton remains valid until next frame when it is really deleted -void() example_skel_player_delete = -{ - skel_delete(self.skeletonindex); - self.skeletonindex = 0; -}; -// -// END OF EXAMPLES FOR FTE_CSQC_SKELETONOBJECTS -// - -//DP_QC_ENTITYDATA -//idea: KrimZon -//darkplaces implementation: KrimZon -//builtin definitions: -float() numentityfields = #496; -string(float fieldnum) entityfieldname = #497; -float(float fieldnum) entityfieldtype = #498; -string(float fieldnum, entity ent) getentityfieldstring = #499; -float(float fieldnum, entity ent, string s) putentityfieldstring = #500; -//constants: -//Returned by entityfieldtype -float FIELD_STRING = 1; -float FIELD_FLOAT = 2; -float FIELD_VECTOR = 3; -float FIELD_ENTITY = 4; -float FIELD_FUNCTION = 6; -//description: -//Versatile functions intended for storing data from specific entities between level changes, but can be customized for some kind of partial savegame. -//WARNING: .entity fields cannot be saved and restored between map loads as they will leave dangling pointers. -//numentityfields returns the number of entity fields. NOT offsets. Vectors comprise 4 fields: v, v_x, v_y and v_z. -//entityfieldname returns the name as a string, eg. "origin" or "classname" or whatever. -//entityfieldtype returns a value that the constants represent, but the field may be of another type in more exotic progs.dat formats or compilers. -//getentityfieldstring returns data as would be written to a savegame, eg... "0.05" (float), "0 0 1" (vector), or "Hello World!" (string). Function names can also be returned. -//putentityfieldstring puts the data returned by getentityfieldstring back into the entity. - -//DP_QC_ENTITYSTRING -void(string s) loadfromdata = #529; -void(string s) loadfromfile = #530; -void(string s) callfunction = #605; -void(float fh, entity e) writetofile = #606; -float(string s) isfunction = #607; -void(entity e, string s) parseentitydata = #608; - -//DP_COVERAGE -//idea: divVerent -//darkplaces implementation: divVerent -//function definitions: -void coverage() = #642; // Reports a coverage event. The engine counts for each of the calls to this builtin whether it has been called. - -// assorted builtins -//const int STAT_MOVEVARS_TICRATE = 240; -//const int STAT_MOVEVARS_TIMESCALE = 241; -//const int STAT_FRAGLIMIT = 235; -//const int STAT_TIMELIMIT = 236; -//const int STAT_MOVEVARS_GRAVITY = 242; -string(void) ReadPicture = #501; -const int PARTICLES_USEALPHA = 1; -float particles_alphamin, particles_alphamax; -const int PARTICLES_USECOLOR = 2; -vector particles_colormin, particles_colormax; -const int PARTICLES_USEFADE = 4; // fades the COUNT (fade alpha using alphamin/alphamax) -float particles_fade; -const int PARTICLES_DRAWASTRAIL = 128; -void(float effectindex, entity own, vector org_from, vector org_to, vector dir_from, vector dir_to, float countmultiplier, float flags) boxparticles = #502; -float trace_networkentity; -const int RF_FULLBRIGHT = 256; -const int RF_NOSHADOW = 512; -const int RF_DYNAMICMODELLIGHT = 8192; - -float gettaginfo_parent; -string gettaginfo_name; -vector gettaginfo_offset; -vector gettaginfo_forward; -vector gettaginfo_right; -vector gettaginfo_up; -float checkpvs(vector viewpos, entity viewee) = #240; +#undef true +#undef false +#undef TRUE +#undef FALSE #pragma noref 0 diff --git a/qcsrc/dpdefs/dpextensions.qh b/qcsrc/dpdefs/dpextensions.qh index 47fdcc180..2487da4ff 100644 --- a/qcsrc/dpdefs/dpextensions.qh +++ b/qcsrc/dpdefs/dpextensions.qh @@ -1,2563 +1,61 @@ #ifndef DPEXTENSIONS_H #define DPEXTENSIONS_H -//DarkPlaces supported extension list, draft version 1.04 -//things that don't have extensions yet: -.float disableclientprediction; +#pragma noref 1 -//definitions that id Software left out: -//these are passed as the 'nomonsters' parameter to traceline/tracebox (yes really this was supported in all quake engines, nomonsters is misnamed) -float MOVE_NORMAL = 0; // same as false -float MOVE_NOMONSTERS = 1; // same as true -float MOVE_MISSILE = 2; // save as movement with .movetype == MOVETYPE_FLYMISSILE +#include "upstream/dpextensions.qc" -//checkextension function -//idea: expected by almost everyone -//darkplaces implementation: LordHavoc -float(string s) checkextension = #99; -//description: -//check if (cvar("pr_checkextension")) before calling this, this is the only -//guaranteed extension to be present in the extension system, it allows you -//to check if an extension is available, by name, to check for an extension -//use code like this: -//// (it is recommended this code be placed in worldspawn or a worldspawn called function somewhere) -//if (cvar("pr_checkextension")) -//if (checkextension("DP_SV_SETCOLOR")) -// ext_setcolor = true; -//from then on you can check ext_setcolor to know if that extension is available +int(entity ent, string tagname) _gettagindex = #451; +#define gettagindex _gettagindex -//BX_WAL_SUPPORT -//idea: id Software -//darkplaces implementation: LordHavoc -//description: -//indicates the engine supports .wal textures for filenames in the textures/ directory -//(note: DarkPlaces has supported this since 2001 or 2002, but did not advertise it as an extension, then I noticed Betwix was advertising it and added the extension accordingly) +int(string effectname) _particleeffectnum = #335; +#define particleeffectnum _particleeffectnum -//DP_BUTTONCHAT -//idea: Vermeulen -//darkplaces implementation: LordHavoc -//field definitions: -.float buttonchat; -//description: -//true if the player is currently chatting (in messagemode, menus or console) +int(string s, string separator1, ...) _tokenizebyseparator = #479; +#define tokenizebyseparator _tokenizebyseparator -//DP_BUTTONUSE -//idea: id Software -//darkplaces implementation: LordHavoc -//field definitions: -.float buttonuse; -//client console commands: -//+use -//-use -//description: -//made +use and -use commands work, they now control the .buttonuse field (.button1 was used by many mods for other purposes). +int(string s) _tokenize_console = #514; +#define tokenize_console _tokenize_console -//DP_CL_LOADSKY -//idea: Nehahra, LordHavoc -//darkplaces implementation: LordHavoc -//client console commands: -//"loadsky" (parameters: "basename", example: "mtnsun_" would load "mtnsun_up.tga" and "mtnsun_rt.tga" and similar names, use "" to revert to quake sky, note: this is the same as Quake2 skybox naming) -//description: -//sets global skybox for the map for this client (can be stuffed to a client by QC), does not hurt much to repeatedly execute this command, please don't use this in mods if it can be avoided (only if changing skybox is REALLY needed, otherwise please use DP_GFX_SKYBOX). +int(int i) _argv_start_index = #515; +#define argv_start_index _argv_start_index -//DP_CON_SET -//idea: id Software -//darkplaces implementation: LordHavoc -//description: -//indicates this engine supports the "set" console command which creates or sets a non-archived cvar (not saved to config.cfg on exit), it is recommended that set and seta commands be placed in default.cfg for mod-specific cvars. +int(int i) _argv_end_index = #516; +#define argv_end_index _argv_end_index -//DP_CON_SETA -//idea: id Software -//darkplaces implementation: LordHavoc -//description: -//indicates this engine supports the "seta" console command which creates or sets an archived cvar (saved to config.cfg on exit), it is recommended that set and seta commands be placed in default.cfg for mod-specific cvars. +int(string s) _strlen = #114; +#define strlen _strlen -//DP_CON_ALIASPARAMETERS -//idea: many -//darkplaces implementation: Black -//description: -//indicates this engine supports aliases containing $1 through $9 parameter macros (which when called will expand to the parameters passed to the alias, for example alias test "say $2 $1", then you can type test hi there and it will execute say there hi), as well as $0 (name of the alias) and $* (all parameters $1 onward). +float(float skel, float bonenum) _skel_get_boneparent = #267; +#define skel_get_boneparent _skel_get_boneparent -//DP_CON_EXPANDCVAR -//idea: many, PHP -//darkplaces implementation: Black -//description: -//indicates this engine supports console commandlines containing $cvarname which will expand to the contents of that cvar as a parameter, for instance say my fov is $fov, will say "my fov is 90", or similar. +float(float skel, string tagname) _skel_find_bone = #268; +#define skel_find_bone _skel_find_bone -//DP_CON_STARTMAP -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//adds two engine-called aliases named startmap_sp and startmap_dm which are called when the engine tries to start a singleplayer game from the menu (startmap_sp) or the -listen or -dedicated options are used or the engine is a dedicated server (uses startmap_dm), these allow a mod or game to specify their own map instead of start, and also distinguish between singleplayer and -listen/-dedicated, also these need not be a simple "map start" command, they can do other things if desired, startmap_sp and startmap_dm both default to "map start". +float(string str, string sub, float startpos) _strstrofs = #221; +#define strstrofs _strstrofs -//DP_EF_ADDITIVE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_ADDITIVE = 32; -//description: -//additive blending when this object is rendered +float(string str, float ofs) _str2chr = #222; +#define str2chr _str2chr -//DP_EF_BLUE -//idea: id Software -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_BLUE = 64; -//description: -//entity emits blue light (used for quad) +string(int c, ...) _chr2str = #223; +#define chr2str _chr2str -//DP_EF_DOUBLESIDED -//idea: LordHavoc -//darkplaces implementation: [515] and LordHavoc -//effects bit: -const int EF_DOUBLESIDED = 32768; -//description: -//render entity as double sided (backfaces are visible, I.E. you see the 'interior' of the model, rather than just the front), can be occasionally useful on transparent stuff. +int(string s1, string s2) _strcmp = #228; +#define strcmp _strcmp -//DP_EF_DYNAMICMODELLIGHT -//idea: C.Brutail, divVerent, maikmerten -//darkplaces implementation: divVerent -//effects bit: -const int EF_DYNAMICMODELLIGHT = 131072; -//description: -//force dynamic model light on the entity, even if it's a BSP model (or anything else with lightmaps or light colors) +int(string s1, string s2, int len) _strncmp = #228; +#define strncmp _strncmp -//DP_EF_FLAME -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_FLAME = 1024; -//description: -//entity is on fire +int(string s1, string s2) _strcasecmp = #229; +#define strcasecmp _strcasecmp -//DP_EF_FULLBRIGHT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_FULLBRIGHT = 512; -//description: -//entity is always brightly lit +int(string s1, string s2, int len) _strncasecmp = #230; +#define strncasecmp _strncasecmp -//DP_EF_NODEPTHTEST -//idea: Supa -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_NODEPTHTEST = 8192; -//description: -//makes entity show up to client even through walls, useful with EF_ADDITIVE for special indicators like where team bases are in a map, so that people don't get lost +int() _buf_create = #460; +#define buf_create _buf_create -//DP_EF_NODRAW -//idea: id Software -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_NODRAW = 16; -//description: -//prevents server from sending entity to client (forced invisible, even if it would have been a light source or other such things) +#pragma noref 0 -//DP_EF_NOGUNBOB -//idea: Chris Page, Dresk -//darkplaces implementation: LordHAvoc -//effects bit: -const int EF_NOGUNBOB = 256; -//description: -//this has different meanings depending on the entity it is used on: -//player entity - prevents gun bobbing on player.viewmodel -//viewmodelforclient entity - prevents gun bobbing on an entity attached to the player's view -//other entities - no effect -//uses: -//disabling gun bobbing on a diving mask or other model used as a .viewmodel. -//disabling gun bobbing on view-relative models meant to be part of the heads up display. (note: if fov is changed these entities may be off-screen, or too near the center of the screen, so use fov 90 in this case) - -//DP_EF_NOSHADOW -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_NOSHADOW = 4096; -//description: -//realtime lights will not cast shadows from this entity (but can still illuminate it) - -//DP_EF_RED -//idea: id Software -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_RED = 128; -//description: -//entity emits red light (used for invulnerability) - -//DP_EF_RESTARTANIM_BIT -//idea: id software -//darkplaces implementation: divVerent -//effects bit: -const int EF_RESTARTANIM_BIT = 1048576; -//description: -//when toggled, the current animation is restarted. Useful for weapon animation. -//to toggle this bit in QC, you can do: -// self.effects += (EF_RESTARTANIM_BIT - 2 * (self.effects & EF_RESTARTANIM_BIT)); - -//DP_EF_STARDUST -//idea: MythWorks Inc -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_STARDUST = 2048; -//description: -//entity emits bouncing sparkles in every direction - -//DP_EF_TELEPORT_BIT -//idea: id software -//darkplaces implementation: divVerent -//effects bit: -const int EF_TELEPORT_BIT = 2097152; -//description: -//when toggled, interpolation of the entity is skipped for one frame. Useful for teleporting. -//to toggle this bit in QC, you can do: -// self.effects += (EF_TELEPORT_BIT - 2 * (self.effects & EF_TELEPORT_BIT)); - -//DP_ENT_ALPHA -//idea: Nehahra -//darkplaces implementation: LordHavoc -//fields: -.float alpha; -//description: -//controls opacity of the entity, 0.0 is forced to be 1.0 (otherwise everything would be invisible), use -1 if you want to make something invisible, 1.0 is solid (like normal). - -//DP_ENT_COLORMOD -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definition: -.vector colormod; -//description: -//controls color of the entity, '0 0 0', is forced to be '1 1 1' (otherwise everything would be black), used for tinting objects, for instance using '1 0.6 0.4' on an ogre would give you an orange ogre (order is red green blue), note the colors can go up to '8 8 8' (8x as bright as normal). - -//DP_ENT_CUSTOMCOLORMAP -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//if .colormap is set to 1024 + pants + shirt * 16, those colors will be used for colormapping the entity, rather than looking up a colormap by player number. - -/* -//NOTE: no longer supported by darkplaces because all entities are delta compressed now -//DP_ENT_DELTACOMPRESS // no longer supported -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//effects bit: -float EF_DELTA = 8388608; -//description: -//(obsolete) applies delta compression to the network updates of the entity, making updates smaller, this might cause some unreliable behavior in packet loss situations, so it should only be used on numerous (nails/plasma shots/etc) or unimportant objects (gibs/shell casings/bullet holes/etc). -*/ - -//DP_ENT_EXTERIORMODELTOCLIENT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//fields: -.entity exteriormodeltoclient; -//description: -//the entity is visible to all clients with one exception: if the specified client is using first person view (not using chase_active) the entity will not be shown. Also if tag attachments are supported any entities attached to the player entity will not be drawn in first person. - -//DP_ENT_GLOW -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float glow_color; -.float glow_size; -.float glow_trail; -//description: -//customizable glowing light effect on the entity, glow_color is a paletted (8bit) color in the range 0-255 (note: 0 and 254 are white), glow_size is 0 or higher (up to the engine what limit to cap it to, darkplaces imposes a 1020 limit), if glow_trail is true it will leave a trail of particles of the same color as the light. - -//DP_ENT_GLOWMOD -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definition: -.vector glowmod; -//description: -//controls color of the entity's glow texture (fullbrights), '0 0 0', is forced to be '1 1 1' (otherwise everything would be black), used for tinting objects, see colormod (same color restrictions apply). - -//DP_ENT_LOWPRECISION -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_LOWPRECISION = 4194304; -//description: -//uses low quality origin coordinates, reducing network traffic compared to the default high precision, intended for numerous objects (projectiles/gibs/bullet holes/etc). - -//DP_ENT_SCALE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float scale; -//description: -//controls rendering scale of the object, 0 is forced to be 1, darkplaces uses 1/16th accuracy and a limit of 15.9375, can be used to make an object larger or smaller. - -//DP_ENT_TRAILEFFECTNUM -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float traileffectnum; -//description: -//use a custom effectinfo.txt effect on this entity, assign it like this: -//self.traileffectnum = particleeffectnum("mycustomeffect"); -//this will do both the dlight and particle trail as described in the effect, basically equivalent to trailparticles() in CSQC but performed on a server entity. - -//DP_ENT_VIEWMODEL -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.entity viewmodelforclient; -//description: -//this is a very special capability, attachs the entity to the view of the client specified, origin and angles become relative to the view of that client, all effects can be used (multiple skins on a weapon model etc)... the entity is not visible to any other client. - -//DP_GFX_EXTERNALTEXTURES -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//loads external textures found in various directories (tenebrae compatible)... -/* -in all examples .tga is merely the base texture, it can be any of these: -.tga (base texture) -_glow.tga (fullbrights or other glowing overlay stuff, NOTE: this is done using additive blend, not alpha) -_pants.tga (pants overlay for colormapping on models, this should be shades of grey (it is tinted by pants color) and black wherever the base texture is not black, as this is an additive blend) -_shirt.tga (same idea as pants, but for shirt color) -_diffuse.tga (this may be used instead of base texture for per pixel lighting) -_gloss.tga (specular texture for per pixel lighting, note this can be in color (tenebrae only supports greyscale)) -_norm.tga (normalmap texture for per pixel lighting) -_bump.tga (bumpmap, converted to normalmap at load time, supported only for reasons of tenebrae compatibility) -_luma.tga (same as _glow but supported only for reasons of tenebrae compatibility) - -due to glquake's incomplete Targa(r) loader, this section describes -required Targa(r) features support: -types: -type 1 (uncompressed 8bit paletted with 24bit/32bit palette) -type 2 (uncompressed 24bit/32bit true color, glquake supported this) -type 3 (uncompressed 8bit greyscale) -type 9 (RLE compressed 8bit paletted with 24bit/32bit palette) -type 10 (RLE compressed 24bit/32bit true color, glquake supported this) -type 11 (RLE compressed 8bit greyscale) -attribute bit 0x20 (Origin At Top Left, top to bottom, left to right) - -image formats guaranteed to be supported: tga, pcx, lmp -image formats that are optional: png, jpg - -mdl/spr/spr32 examples: -skins are named _A (A being a number) and skingroups are named like _A_B -these act as suffixes on the model name... -example names for skin _2_1 of model "progs/armor.mdl": -game/override/progs/armor.mdl_2_1.tga -game/textures/progs/armor.mdl_2_1.tga -game/progs/armor.mdl_2_1.tga -example names for skin _0 of the model "progs/armor.mdl": -game/override/progs/armor.mdl_0.tga -game/textures/progs/armor.mdl_0.tga -game/progs/armor.mdl_0.tga -note that there can be more skins files (of the _0 naming) than the mdl -contains, this is only useful to save space in the .mdl file if classic quake -compatibility is not a concern. - -bsp/md2/md3 examples: -example names for the texture "quake" of model "maps/start.bsp": -game/override/quake.tga -game/textures/quake.tga -game/quake.tga - -sbar/menu/console textures: for example the texture "conchars" (console font) in gfx.wad -game/override/gfx/conchars.tga -game/textures/gfx/conchars.tga -game/gfx/conchars.tga -*/ - -//DP_GFX_EXTERNALTEXTURES_PERMAPTEXTURES -//idea: Fuh? -//darkplaces implementation: LordHavoc -//description: -//Q1BSP and HLBSP map loading loads external textures found in textures// as well as textures/. -//Where mapname is the bsp filename minus the extension (typically .bsp) and minus maps/ if it is in maps/ (any other path is not removed) -//example: -//maps/e1m1.bsp uses textures in the directory textures/e1m1/ and falls back to textures/ -//maps/b_batt0.bsp uses textures in the directory textures/b_batt0.bsp and falls back to textures/ -//as a more extreme example: -//progs/something/blah.bsp uses textures in the directory textures/progs/something/blah/ and falls back to textures/ - -//DP_GFX_FOG -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//worldspawn fields: -//"fog" (parameters: "density red green blue", example: "0.1 0.3 0.3 0.3") -//description: -//global fog for the map, can not be changed by QC - -//DP_GFX_QUAKE3MODELTAGS -//idea: id Software -//darkplaces implementation: LordHavoc -//field definitions: -.entity tag_entity; // entity this is attached to (call setattachment to set this) -.float tag_index; // which tag on that entity (0 is relative to the entity, > 0 is an index into the tags on the model if it has any) (call setattachment to set this) -//builtin definitions: -void(entity e, entity tagentity, string tagname) setattachment = #443; // attachs e to a tag on tagentity (note: use "" to attach to entity origin/angles instead of a tag) -//description: -//allows entities to be visually attached to model tags (which follow animations perfectly) on other entities, for example attaching a weapon to a player's hand, or upper body attached to lower body, allowing it to change angles and frame separately (note: origin and angles are relative to the tag, use '0 0 0' for both if you want it to follow exactly, this is similar to viewmodelforclient's behavior). -//note 2: if the tag is not found, it defaults to "" (attach to origin/angles of entity) -//note 3: attaching to world turns off attachment -//note 4: the entity that this is attached to must be visible for this to work -//note 5: if an entity is attached to the player entity it will not be drawn in first person. - -//DP_GFX_SKINFILES -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//alias models (mdl, md2, md3) can have .skin files to replace conventional texture naming, these have a naming format such as: -//progs/test.md3_0.skin -//progs/test.md3_1.skin -//... -// -//these files contain replace commands (replace meshname shadername), example: -//replace "helmet" "progs/test/helmet1.tga" // this is a mesh shader replacement -//replace "teamstripes" "progs/test/redstripes.tga" -//replace "visor" "common/nodraw" // this makes the visor mesh invisible -////it is not possible to rename tags using this format -// -//Or the Quake3 syntax (100% compatible with Quake3's .skin files): -//helmet,progs/test/helmet1.tga // this is a mesh shader replacement -//teamstripes,progs/test/redstripes.tga -//visor,common/nodraw // this makes the visor mesh invisible -//tag_camera, // this defines that the first tag in the model is called tag_camera -//tag_test, // this defines that the second tag in the model is called tag_test -// -//any names that are not replaced are automatically show up as a grey checkerboard to indicate the error status, and "common/nodraw" is a special case that is invisible. -//this feature is intended to allow multiple skin sets on md3 models (which otherwise only have one skin set). -//other commands might be added someday but it is not expected. - -//DP_GFX_SKYBOX -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//worldspawn fields: -//"sky" (parameters: "basename", example: "mtnsun_" would load "mtnsun_up.tga" and "mtnsun_rt.tga" and similar names, note: "sky" is also used the same way by Quake2) -//description: -//global skybox for the map, can not be changed by QC - -//DP_UTF8 -//idea: Blub\0, divVerent -//darkplaces implementation: Blub\0 -//cvar definitions: -// utf8_enable: enable utf8 encoding -//description: utf8 characters are allowed inside cvars, protocol strings, files, progs strings, etc., -//and count as 1 char for string functions like strlen, substring, etc. -// note: utf8_enable is run-time cvar, could be changed during execution -// note: beware that str2chr() could return value bigger than 255 once utf8 is enabled - -//DP_HALFLIFE_MAP -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//simply indicates that the engine supports HalfLife maps (BSP version 30, NOT the QER RGBA ones which are also version 30). - -//DP_HALFLIFE_MAP_CVAR -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//cvars: -//halflifebsp 0/1 -//description: -//engine sets this cvar when loading a map to indicate if it is halflife format or not. - -//DP_HALFLIFE_SPRITE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//simply indicates that the engine supports HalfLife sprites. - -//DP_INPUTBUTTONS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float button3; -.float button4; -.float button5; -.float button6; -.float button7; -.float button8; -.float button9; -.float button10; -.float button11; -.float button12; -.float button13; -.float button14; -.float button15; -.float button16; -//description: -//set to the state of the +button3, +button4, +button5, +button6, +button7, and +button8 buttons from the client, this does not involve protocol changes (the extra 6 button bits were simply not used). -//the exact mapping of protocol button bits on the server is: -//self.button0 = (bits & 1) != 0; -///* button1 is skipped because mods abuse it as a variable, and accordingly it has no bit */ -//self.button2 = (bits & 2) != 0; -//self.button3 = (bits & 4) != 0; -//self.button4 = (bits & 8) != 0; -//self.button5 = (bits & 16) != 0; -//self.button6 = (bits & 32) != 0; -//self.button7 = (bits & 64) != 0; -//self.button8 = (bits & 128) != 0; - -// DP_LIGHTSTYLE_STATICVALUE -// idea: VorteX -// darkplaces implementation: VorteX -// description: allows alternative 'static' lightstyle syntax : "=value" -// examples: "=0.5", "=2.0", "=2.75" -// could be used to control switchable lights or making styled lights with brightness > 2 -// Warning: this extension is experimental. It safely works in CSQC, but SVQC use is limited by the fact -// that other engines (which do not support this extension) could connect to a game and misunderstand this kind of lightstyle syntax - -//DP_LITSPRITES -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//indicates this engine supports lighting on sprites, any sprite with ! in its filename (both on disk and in the qc) will be lit rather than having forced EF_FULLBRIGHT (EF_FULLBRIGHT on the entity can still force these sprites to not be lit). - -//DP_LITSUPPORT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//indicates this engine loads .lit files for any quake1 format .bsp files it loads to enhance maps with colored lighting. -//implementation description: these files begin with the header QLIT followed by version number 1 (as little endian 32bit), the rest of the file is a replacement lightmaps lump, except being 3x as large as the lightmaps lump of the map it matches up with (and yes the between-lightmap padding is expanded 3x to keep this consistent), so the lightmap offset in each surface is simply multiplied by 3 during loading to properly index the lit data, and the lit file is loaded instead of the lightmap lump, other renderer changes are needed to display these of course... see the litsupport.zip sample code (almost a tutorial) at http://icculus.org/twilight/darkplaces for more information. - -//DP_MONSTERWALK -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//MOVETYPE_WALK is permitted on non-clients, so bots can move smoothly, run off ledges, etc, just like a real player. - -//DP_MOVETYPEBOUNCEMISSILE -//idea: id Software -//darkplaces implementation: id Software -//movetype definitions: -//float MOVETYPE_BOUNCEMISSILE = 11; // already in defs.qc -//description: -//MOVETYPE_BOUNCE but without gravity, and with full reflection (no speed loss like grenades have), in other words - bouncing laser bolts. - -//DP_MOVETYPEFLYWORLDONLY -//idea: Samual -//darkplaces implementation: Samual -//movetype definitions: -float MOVETYPE_FLY_WORLDONLY = 33; -//description: -//like MOVETYPE_FLY, but does all traces with MOVE_WORLDONLY, and is ignored by MOVETYPE_PUSH. Should only be combined with SOLID_NOT and SOLID_TRIGGER. - -//DP_NULL_MODEL -//idea: Chris -//darkplaces implementation: divVerent -//definitions: -//string dp_null_model = "null"; -//description: -//setmodel(e, "null"); makes an entity invisible, have a zero bbox, but -//networked. useful for shared CSQC entities. - -//DP_MOVETYPEFOLLOW -//idea: id Software, LordHavoc (redesigned) -//darkplaces implementation: LordHavoc -//movetype definitions: -float MOVETYPE_FOLLOW = 12; -//description: -//MOVETYPE_FOLLOW implemented, this uses existing entity fields in unusual ways: -//aiment - the entity this is attached to. -//punchangle - the original angles when the follow began. -//view_ofs - the relative origin (note that this is un-rotated by punchangle, and that is actually the only purpose of punchangle). -//v_angle - the relative angles. -//here's an example of how you would set a bullet hole sprite to follow a bmodel it was created on, even if the bmodel rotates: -//hole.movetype = MOVETYPE_FOLLOW; // make the hole follow -//hole.solid = SOLID_NOT; // MOVETYPE_FOLLOW is always non-solid -//hole.aiment = bmodel; // make the hole follow bmodel -//hole.punchangle = bmodel.angles; // the original angles of bmodel -//hole.view_ofs = hole.origin - bmodel.origin; // relative origin -//hole.v_angle = hole.angles - bmodel.angles; // relative angles - -//DP_QC_ASINACOSATANATAN2TAN -//idea: Urre -//darkplaces implementation: LordHavoc -//constant definitions: -float DEG2RAD = 0.0174532925199432957692369076848861271344287188854172545609719144; -float RAD2DEG = 57.2957795130823208767981548141051703324054724665643215491602438612; -float PI = 3.1415926535897932384626433832795028841971693993751058209749445923; -//builtin definitions: -float(float s) asin = #471; // returns angle in radians for a given sin() value, the result is in the range -PI*0.5 to PI*0.5 -float(float c) acos = #472; // returns angle in radians for a given cos() value, the result is in the range 0 to PI -float(float t) atan = #473; // returns angle in radians for a given tan() value, the result is in the range -PI*0.5 to PI*0.5 -float(float c, float s) atan2 = #474; // returns angle in radians for a given cos() and sin() value pair, the result is in the range -PI to PI (this is identical to vectoyaw except it returns radians rather than degrees) -float(float a) tan = #475; // returns tangent value (which is simply sin(a)/cos(a)) for the given angle in radians, the result is in the range -infinity to +infinity -//description: -//useful math functions for analyzing vectors, note that these all use angles in radians (just like the cos/sin functions) not degrees unlike makevectors/vectoyaw/vectoangles, so be sure to do the appropriate conversions (multiply by DEG2RAD or RAD2DEG as needed). -//note: atan2 can take unnormalized vectors (just like vectoyaw), and the function was included only for completeness (more often you want vectoyaw or vectoangles), atan2(v_x,v_y) * RAD2DEG gives the same result as vectoyaw(v) - -//DP_QC_AUTOCVARS -//idea: divVerent -//darkplaces implementation: divVerent -//description: -//allows QC variables to be bound to cvars -//(works for float, string, vector types) -//example: -// float autocvar_developer; -// float autocvar_registered; -// string autocvar__cl_name; -//NOTE: copying a string-typed autocvar to another variable/field, and then -//changing the cvar or returning from progs is UNDEFINED. Writing to autocvar -//globals is UNDEFINED. Accessing autocvar globals after changing that cvar in -//the same frame by any means other than cvar_set() from the same QC VM is -//IMPLEMENTATION DEFINED (an implementation may either yield the previous, or -//the current, value). Changing them via cvar_set() in the same QC VM -//immediately must reflect on the autocvar globals. Whether autocvar globals, -//after restoring a savegame, have the cvar's current value, or the original -//value at time of saving, is UNDEFINED. Restoring a savegame however must not -//restore the cvar values themselves. -//In case the cvar does NOT exist, then it is automatically created with the -//value of the autocvar initializer, if given. This is possible with e.g. -//frikqcc and fteqcc the following way: -// var float autocvar_whatever = 42; -//If no initializer is given, the cvar will be initialized to a string -//equivalent to the NULL value of the given data type, that is, the empty -//string, 0, or '0 0 0'. However, when automatic cvar creation took place, a -//warning is printed to the game console. -//NOTE: to prevent an ambiguity with float names for vector types, autocvar -//names MUST NOT end with _x, _y or _z! - -//DP_QC_CHANGEPITCH -//idea: id Software -//darkplaces implementation: id Software -//field definitions: -.float idealpitch; -.float pitch_speed; -//builtin definitions: -void(entity ent) changepitch = #63; -//description: -//equivalent to changeyaw, ent is normally self. (this was a Q2 builtin) - -//DP_QC_COPYENTITY -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(entity from, entity to) copyentity = #400; -//description: -//copies all data in the entity to another entity. - -//DP_QC_CRC16 -//idea: divVerent -//darkplaces implementation: divVerent -//Some hash function to build hash tables with. This has to be be the CRC-16-CCITT that is also required for the QuakeWorld download protocol. -//When caseinsensitive is set, the CRC is calculated of the lower cased string. -float(float caseinsensitive, string s, ...) crc16 = #494; - -//DP_QC_CVAR_DEFSTRING -//idea: id Software (Doom3), LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -string(string s) cvar_defstring = #482; -//description: -//returns the default value of a cvar, as a tempstring. - -//DP_QC_CVAR_DESCRIPTION -//idea: divVerent -//DarkPlaces implementation: divVerent -//builtin definitions: -string(string name) cvar_description = #518; -//description: -//returns the description of a cvar - -//DP_QC_CVAR_STRING -//idea: VorteX -//DarkPlaces implementation: VorteX, LordHavoc -//builtin definitions: -string(string s) cvar_string = #448; -//description: -//returns the value of a cvar, as a tempstring. - -//DP_QC_CVAR_TYPE -//idea: divVerent -//DarkPlaces implementation: divVerent -//builtin definitions: -float(string name) cvar_type = #495; -float CVAR_TYPEFLAG_EXISTS = 1; -float CVAR_TYPEFLAG_SAVED = 2; -float CVAR_TYPEFLAG_PRIVATE = 4; -float CVAR_TYPEFLAG_ENGINE = 8; -float CVAR_TYPEFLAG_HASDESCRIPTION = 16; -float CVAR_TYPEFLAG_READONLY = 32; - -//DP_QC_DIGEST -//idea: motorsep, Spike -//DarkPlaces implementation: divVerent -//builtin definitions: -string(string digest, string data, ...) digest_hex = #639; -//description: -//returns a given hex digest of given data -//the returned digest is always encoded in hexadecimal -//only the "MD4" digest is always supported! -//if the given digest is not supported, string_null is returned -//the digest string is matched case sensitively, use "MD4", not "md4"! - -//DP_QC_DIGEST_SHA256 -//idea: motorsep, Spike -//DarkPlaces implementation: divVerent -//description: -//"SHA256" is also an allowed digest type - -//DP_QC_EDICT_NUM -//idea: 515 -//DarkPlaces implementation: LordHavoc -//builtin definitions: -entity(float entnum) edict_num = #459; -float(entity ent) wasfreed = #353; // same as in EXT_CSQC extension -//description: -//edict_num returns the entity corresponding to a given number, this works even for freed entities, but you should call wasfreed(ent) to see if is currently active. -//wasfreed returns whether an entity slot is currently free (entities that have never spawned are free, entities that have had remove called on them are also free). - -//DP_QC_ENTITYDATA -//idea: KrimZon -//darkplaces implementation: KrimZon -//builtin definitions: -float() numentityfields = #496; -string(float fieldnum) entityfieldname = #497; -float(float fieldnum) entityfieldtype = #498; -string(float fieldnum, entity ent) getentityfieldstring = #499; -float(float fieldnum, entity ent, string s) putentityfieldstring = #500; -//constants: -//Returned by entityfieldtype -float FIELD_STRING = 1; -float FIELD_FLOAT = 2; -float FIELD_VECTOR = 3; -float FIELD_ENTITY = 4; -float FIELD_FUNCTION = 6; -//description: -//Versatile functions intended for storing data from specific entities between level changes, but can be customized for some kind of partial savegame. -//WARNING: .entity fields cannot be saved and restored between map loads as they will leave dangling pointers. -//numentityfields returns the number of entity fields. NOT offsets. Vectors comprise 4 fields: v, v_x, v_y and v_z. -//entityfieldname returns the name as a string, eg. "origin" or "classname" or whatever. -//entityfieldtype returns a value that the constants represent, but the field may be of another type in more exotic progs.dat formats or compilers. -//getentityfieldstring returns data as would be written to a savegame, eg... "0.05" (float), "0 0 1" (vector), or "Hello World!" (string). Function names can also be returned. -//putentityfieldstring puts the data returned by getentityfieldstring back into the entity. - -//DP_QC_ENTITYSTRING -void(string s) loadfromdata = #529; -void(string s) loadfromfile = #530; -void(string s) callfunction = #605; -void(float fh, entity e) writetofile = #606; -float(string s) isfunction = #607; -void(entity e, string s) parseentitydata = #608; - -//DP_QC_ETOS -//idea: id Software -//darkplaces implementation: id Software -//builtin definitions: -string(entity ent) etos = #65; -//description: -//prints "entity 1" or similar into a string. (this was a Q2 builtin) - -//DP_QC_EXTRESPONSEPACKET -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -string(void) getextresponse = #624; -//description: -//returns a string of the form "\"ipaddress:port\" data...", or the NULL string -//if no packet was found. Packets can be queued into the client/server by -//sending a packet starting with "\xFF\xFF\xFF\xFFextResponse " to the -//listening port. - -//DP_QC_FINDCHAIN -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -entity(.string fld, string match) findchain = #402; -//description: -//similar to find() but returns a chain of entities like findradius. - -//DP_QC_FINDCHAIN_TOFIELD -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -entity(.string fld, float match, .entity tofield) findradius_tofield = #22; -entity(.string fld, string match, .entity tofield) findchain_tofield = #402; -entity(.string fld, float match, .entity tofield) findchainflags_tofield = #450; -entity(.string fld, float match, .entity tofield) findchainfloat_tofield = #403; -//description: -//similar to findchain() etc, but stores the chain into .tofield instead of .chain -//actually, the .entity tofield is an optional field of the the existing findchain* functions - -//DP_QC_FINDCHAINFLAGS -//idea: Sajt -//darkplaces implementation: LordHavoc -//builtin definitions: -entity(.float fld, float match) findchainflags = #450; -//description: -//similar to findflags() but returns a chain of entities like findradius. - -//DP_QC_FINDCHAINFLOAT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -entity(.entity fld, entity match) findchainentity = #403; -entity(.float fld, float match) findchainfloat = #403; -//description: -//similar to findentity()/findfloat() but returns a chain of entities like findradius. - -//DP_QC_FINDFLAGS -//idea: Sajt -//darkplaces implementation: LordHavoc -//builtin definitions: -entity(entity start, .float fld, float match) findflags = #449; -//description: -//finds an entity with the specified flag set in the field, similar to find() - -//DP_QC_FINDFLOAT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -entity(entity start, .entity fld, entity match) findentity = #98; -entity(entity start, .float fld, float match) findfloat = #98; -//description: -//finds an entity or float field value, similar to find(), but for entity and float fields. - -//DP_QC_FS_SEARCH -//idea: Black -//darkplaces implementation: Black -//builtin definitions: -float(string pattern, float caseinsensitive, float quiet) search_begin = #444; -void(float handle) search_end = #445; -float(float handle) search_getsize = #446; -string(float handle, float num) search_getfilename = #447; -//description: -//search_begin performs a filename search with the specified pattern (for example "maps/*.bsp") and stores the results in a search slot (minimum of 128 supported by any engine with this extension), the other functions take this returned search slot number, be sure to search_free when done (they are also freed on progs reload). -//search_end frees a search slot (also done at progs reload). -//search_getsize returns how many filenames were found. -//search_getfilename returns a filename from the search. - -//DP_QC_GETLIGHT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -vector(vector org) getlight = #92; -//description: -//returns the lighting at the requested location (in color), 0-255 range (can exceed 255). - -//DP_QC_GETSURFACE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -float(entity e, float s) getsurfacenumpoints = #434; -vector(entity e, float s, float n) getsurfacepoint = #435; -vector(entity e, float s) getsurfacenormal = #436; -string(entity e, float s) getsurfacetexture = #437; -float(entity e, vector p) getsurfacenearpoint = #438; -vector(entity e, float s, vector p) getsurfaceclippedpoint = #439; -//description: -//functions to query surface information. - -//DP_QC_GETSURFACEPOINTATTRIBUTE -//idea: BlackHC -//darkplaces implementation: BlackHC -// constants -float SPA_POSITION = 0; -float SPA_S_AXIS = 1; -float SPA_T_AXIS = 2; -float SPA_R_AXIS = 3; // same as SPA_NORMAL -float SPA_TEXCOORDS0 = 4; -float SPA_LIGHTMAP0_TEXCOORDS = 5; -float SPA_LIGHTMAP0_COLOR = 6; -//builtin definitions: -vector(entity e, float s, float n, float a) getsurfacepointattribute = #486; - -//description: -//function to query extended information about a point on a certain surface - -//DP_QC_GETSURFACETRIANGLE -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -float(entity e, float s) getsurfacenumtriangles = #628; -vector(entity e, float s, float n) getsurfacetriangle = #629; -//description: -//function to query triangles of a surface - -//DP_QC_GETTAGINFO -//idea: VorteX, LordHavoc -//DarkPlaces implementation: VorteX -//builtin definitions: -int(entity ent, string tagname) gettagindex = #451; -vector(entity ent, float tagindex) gettaginfo = #452; -//description: -//gettagindex returns the number of a tag on an entity, this number is the same as set by setattachment (in the .tag_index field), allowing the qc to save a little cpu time by keeping the number around if it wishes (this could already be done by calling setattachment and saving off the tag_index). -//gettaginfo returns the origin of the tag in worldspace and sets v_forward, v_right, and v_up to the current orientation of the tag in worldspace, this automatically resolves all dependencies (attachments, including viewmodelforclient), this means you could fire a shot from a tag on a gun entity attached to the view for example. - -//DP_QC_GETTAGINFO_BONEPROPERTIES -//idea: daemon -//DarkPlaces implementation: divVerent -//global definitions: -float gettaginfo_parent; -string gettaginfo_name; -vector gettaginfo_offset; -vector gettaginfo_forward; -vector gettaginfo_right; -vector gettaginfo_up; -//description: -//when this extension is present, gettaginfo fills in some globals with info about the bone that had been queried -//gettaginfo_parent is set to the number of the parent bone, or 0 if it is a root bone -//gettaginfo_name is set to the name of the bone whose index had been specified in gettaginfo -//gettaginfo_offset, gettaginfo_forward, gettaginfo_right, gettaginfo_up contain the transformation matrix of the bone relative to its parent. Note that the matrix may contain a scaling component. - -//DP_QC_GETTIME -//idea: tZork -//darkplaces implementation: tZork, divVerent -//constant definitions: -float GETTIME_FRAMESTART = 0; // time of start of frame -float GETTIME_REALTIME = 1; // current time (may be OS specific) -float GETTIME_HIRES = 2; // like REALTIME, but may reset between QC invocations and thus can be higher precision -float GETTIME_UPTIME = 3; // time since start of the engine -//builtin definitions: -float(float tmr) gettime = #519; -//description: -//some timers to query... - -//DP_QC_GETTIME_CDTRACK -//idea: divVerent -//darkplaces implementation: divVerent -//constant definitions: -float GETTIME_CDTRACK = 4; -//description: -//returns the playing time of the current cdtrack when passed to gettime() -//see DP_END_GETSOUNDTIME for similar functionality but for entity sound channels - -//DP_QC_I18N -//idea: divVerent -//darkplaces implementation: divVerent -//description: -// -//The engine supports translating by gettext compatible .po files. -//progs.dat uses progs.dat..po -//menu.dat uses menu.dat..po -//csprogs.dat uses csprogs.dat..po -// -//To create a string that can be translated, define it as -// string dotranslate_FILENOTFOUND = "File not found"; -//Note: if the compiler does constant folding, this will only work if there is -//no other "File not found" string in the progs! -// -//Alternatively, if using the Xonotic patched fteqcc compiler, you can simplify -//this by using _("File not found") directly in the source code. -// -//The language is set by the "prvm_language" cvar: if prvm_language is set to -//"de", it will read progs.dat.de.po for translating strings in progs.dat. -// -//If prvm_language is set to the special name "dump", progs.dat.pot will be -//written, which is a translation template to be edited by filling out the -//msgstr entries. - -//DP_QC_LOG -//darkplaces implementation: divVerent -//builtin definitions: -float log(float f) = #532; -//description: -//logarithm - -//DP_QC_MINMAXBOUND -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -float(float a, float b, ...) min = #94; -float(float a, float b, float c) min3 = #94; -float(float a, float b, float c, float d) min4 = #94; -float(float a, float b, float c, float d, float e) min5 = #94; -float(float a, float b, float c, float d, float e, float f) min6 = #94; -float(float a, float b, float c, float d, float e, float f, float g) min7 = #94; -float(float a, float b, float c, float d, float e, float f, float g, float h) min8 = #94; -float(float a, float b, ...) max = #95; -float(float a, float b, float c) max3 = #95; -float(float a, float b, float c, float d) max4 = #95; -float(float a, float b, float c, float d, float e) max5 = #95; -float(float a, float b, float c, float d, float e, float f) max6 = #95; -float(float a, float b, float c, float d, float e, float f, float g) max7 = #95; -float(float a, float b, float c, float d, float e, float f, float g, float h) max8 = #95; -float(float minimum, float val, float maximum) bound = #96; -//description: -//min returns the lowest of all the supplied numbers. -//max returns the highest of all the supplied numbers. -//bound clamps the value to the range and returns it. - -//DP_QC_MULTIPLETEMPSTRINGS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//this extension makes all builtins returning tempstrings (ftos for example) -//cycle through a pool of multiple tempstrings (at least 16), allowing -//multiple ftos results to be gathered before putting them to use, normal -//quake only had 1 tempstring, causing many headaches. -// -//Note that for longer term storage (or compatibility on engines having -//FRIK_FILE but not this extension) the FRIK_FILE extension's -//strzone/strunzone builtins provide similar functionality (slower though). -// -//NOTE: this extension is superseded by DP_QC_UNLIMITEDTEMPSTRINGS - -//DP_QC_NUM_FOR_EDICT -//idea: Blub\0 -//darkplaces implementation: Blub\0 -//Function to get the number of an entity - a clean way. -float(entity num) num_for_edict = #512; - -//DP_QC_RANDOMVEC -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -vector() randomvec = #91; -//description: -//returns a vector of length < 1, much quicker version of this QC: do {v_x = random()*2-1;v_y = random()*2-1;v_z = random()*2-1;} while(vlen(v) > 1) - -//DP_QC_SINCOSSQRTPOW -//idea: id Software, LordHavoc -//darkplaces implementation: id Software, LordHavoc -//builtin definitions: -float(float val) sin = #60; -float(float val) cos = #61; -float(float val) sqrt = #62; -float(float a, float b) pow = #97; -//description: -//useful math functions, sine of val, cosine of val, square root of val, and raise a to power b, respectively. - -//DP_QC_SPRINTF -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -string(string format, ...) sprintf = #627; -//description: -//you know sprintf :P -//supported stuff: -// % -// optional: $ for the argument to format -// flags: #0- + -// optional: , *, or *$ for the field width -// optional: ., .*, or .*$ for the precision -// length modifiers: h for forcing a float, l for forcing an int/entity (by default, %d etc. cast a float to int) -// conversions: -// d takes a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an int -// i takes an int/entity if no length is specified or i is, and a float if h is specified as length, and cast it to an int -// ouxXc take a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an unsigned int -// eEfFgG take a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to a double -// s takes a string -// vV takes a vector, and processes the three components as if it were a gG for all three components, separated by space -// For conversions s and c, the flag # makes precision and width interpreted -// as byte count, by default it is interpreted as character count in UTF-8 -// enabled engines. No other conversions can create wide characters, and # -// has another meaning in these. When in character count mode, color codes -// are ignored. To get UTF-8 semantics WITHOUT color code parsing, use -// the + flag. - -//DP_QC_STRFTIME -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -string(float uselocaltime, string format, ...) strftime = #478; -//description: -//provides the ability to get the local (in your timezone) or world (Universal Coordinated Time) time as a string using the formatting of your choice: -//example: "%Y-%m-%d %H:%M:%S" (result looks like: 2007-02-08 01:03:15) -//note: "%F %T" gives the same result as "%Y-%m-%d %H:%M:%S" (ISO 8601 date format and 24-hour time) -//for more format codes please do a web search for strftime 3 and you should find the man(3) pages for this standard C function. -// -//practical uses: -//changing day/night cycle (shops closing, monsters going on the prowl) in an RPG, for this you probably want to use s = strftime(true, "%H");hour = stof(s); -//printing current date/time for competitive multiplayer games, such as the beginning/end of each round in real world time. -//activating eastereggs in singleplayer games on certain dates. -// -//note: some codes such as %x and %X use your locale settings and thus may not make sense to international users, it is not advisable to use these as the server and clients may be in different countries. -//note: if you display local time to a player, it would be a good idea to note whether it is local time using a string like "%F %T (local)", and otherwise use "%F %T (UTC)". -//note: be aware that if the game is saved and reloaded a week later the date and time will be different, so if activating eastereggs in a singleplayer game or something you may want to only check when a level is loaded and then keep the same easteregg state throughout the level so that the easteregg does not deactivate when reloading from a savegame (also be aware that precaches should not depend on such date/time code because reloading a savegame often scrambles the precaches if so!). -//note: this function can return a NULL string (you can check for it with if (!s)) if the localtime/gmtime functions returned NULL in the engine code, such as if those functions don't work on this platform (consoles perhaps?), so be aware that this may return nothing. - -//DP_QC_STRINGCOLORFUNCTIONS -//idea: Dresk -//darkplaces implementation: Dresk -//builtin definitions: -float(string s) strlennocol = #476; // returns how many characters are in a string, minus color codes -string(string s) strdecolorize = #477; // returns a string minus the color codes of the string provided -//description: -//provides additional functionality to strings by supporting functions that isolate and identify strings with color codes - -//DP_QC_STRING_CASE_FUNCTIONS -//idea: Dresk -//darkplaces implementation: LordHavoc / Dresk -//builtin definitions: -string(string s) strtolower = #480; // returns the passed in string in pure lowercase form -string(string s) strtoupper = #481; // returns the passed in string in pure uppercase form -//description: -//provides simple string uppercase and lowercase functions - -//DP_QC_TOKENIZEBYSEPARATOR -//idea: Electro, SavageX, LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -int(string s, string separator1, ...) tokenizebyseparator = #479; -//description: -//this function returns tokens separated by any of the supplied separator strings, example: -//numnumbers = tokenizebyseparator("10.2.3.4", "."); -//returns 4 and the tokens are "10" "2" "3" "4" -//possibly useful for parsing IPv4 addresses (such as "1.2.3.4") and IPv6 addresses (such as "[1234:5678:9abc:def0:1234:5678:9abc:def0]:26000") - -//DP_QC_TOKENIZE_CONSOLE -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -int(string s) tokenize_console = #514; -int(float i) argv_start_index = #515; -int(float i) argv_end_index = #516; -//description: -//this function returns tokens separated just like the console does -//also, functions are provided to get the index of the first and last character of each token in the original string -//Passing negative values to them, or to argv, will be treated as indexes from the LAST token (like lists work in Perl). So argv(-1) will return the LAST token. - -//DP_QC_TRACEBOX -//idea: id Software -//darkplaces implementation: id Software -//builtin definitions: -void(vector v1, vector min, vector max, vector v2, float nomonsters, entity forent) tracebox = #90; -//description: -//similar to traceline but much more useful, traces a box of the size specified (technical note: in quake1 and halflife bsp maps the mins and maxs will be rounded up to one of the hull sizes, quake3 bsp does not have this problem, this is the case with normal moving entities as well). - -//DP_QC_TRACETOSS -//idea: id Software -//darkplaces implementation: id Software -//builtin definitions: -void(entity ent, entity ignore) tracetoss = #64; -//description: -//simulates movement of the entity as if it is MOVETYPE_TOSS and starting with it's current state (location, velocity, etc), returns relevant trace_ variables (trace_fraction is always 0, all other values are supported - trace_ent, trace_endpos, trace_plane_normal), does not actually alter the entity. - -//DP_QC_TRACE_MOVETYPE_HITMODEL -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//constant definitions: -float MOVE_HITMODEL = 4; -//description: -//allows traces to hit alias models (not sprites!) instead of entity boxes, use as the nomonsters parameter to trace functions, note that you can hit invisible model entities (alpha < 0 or EF_NODRAW or model "", it only checks modelindex) - -//DP_QC_TRACE_MOVETYPE_WORLDONLY -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//constant definitions: -const float MOVE_WORLDONLY = 3; -//description: -//allows traces to hit only world (ignoring all entities, unlike MOVE_NOMONSTERS which hits all bmodels), use as the nomonsters parameter to trace functions - -//DP_QC_UNLIMITEDTEMPSTRINGS -//idea: divVerent -//darkplaces implementation: LordHavoc -//description: -//this extension alters Quake behavior such that instead of reusing a single -//tempstring (or multiple) there are an unlimited number of tempstrings, which -//are removed only when a QC function invoked by the engine returns, -//eliminating almost all imaginable concerns with string handling in QuakeC. -// -//in short: -//you can now use and abuse tempstrings as much as you like, you still have to -//use strzone (FRIK_FILE) for permanent storage however. -// -// -// -//implementation notes for other engine coders: -//these tempstrings are expected to be stored in a contiguous buffer in memory -//which may be fixed size or controlled by a cvar, or automatically grown on -//demand (in the case of DarkPlaces). -// -//this concept is similar to quake's Zone system, however these are all freed -//when the QC interpreter returns. -// -//this is basically a poor man's garbage collection system for strings. - -//DP_QC_VECTOANGLES_WITH_ROLL -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -vector(vector forward, vector up) vectoangles2 = #51; // same number as vectoangles -//description: -//variant of vectoangles that takes an up vector to calculate roll angle (also uses this to calculate yaw correctly if the forward is straight up or straight down) -//note: just like normal vectoangles you need to negate the pitch of the returned angles if you want to feed them to makevectors or assign to self.v_angle - -//DP_QC_VECTORVECTORS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector dir) vectorvectors = #432; -//description: -//creates v_forward, v_right, and v_up vectors given a forward vector, similar to makevectors except it takes a forward direction vector instead of angles. - -//DP_QC_WHICHPACK -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -string(string filename) whichpack = #503; -//description: -//returns the name of the pak/pk3/whatever containing the given file, in the same path space as FRIK_FILE functions use (that is, possibly with a path name prefix) - -//DP_QC_URI_ESCAPE -//idea: divVerent -//darkplaces implementation: divVerent -//URI::Escape's functionality -string(string in) uri_escape = #510; -string(string in) uri_unescape = #511; - -//DP_QC_URI_GET -//idea: divVerent -//darkplaces implementation: divVerent -//loads text from an URL into a string -//returns 1 on success of initiation, 0 if there are too many concurrent -//connections already or if the URL is invalid -//the following callback will receive the data and MUST exist! -// void(float id, float status, string data) URI_Get_Callback; -//status is either -// negative for an internal error, -// 0 for success, or -// the HTTP response code on server error (e.g. 404) -//if 1 is returned by uri_get, the callback will be called in the future -float(string url, float id) uri_get = #513; - -//DP_QC_URI_POST -//idea: divVerent -//darkplaces implementation: divVerent -//loads text from an URL into a string after POSTing via HTTP -//works like uri_get, but uri_post sends data with Content-Type: content_type to the server -//and uri_post sends the string buffer buf, joined using the delimiter delim -float(string url, float id, string content_type, string data) uri_post = #513; -float(string url, float id, string content_type, string delim, float buf) uri_postbuf = #513; - -//DP_SKELETONOBJECTS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//this extension indicates that FTE_CSQC_SKELETONOBJECTS functionality is available in server QC (as well as CSQC). - -//DP_SV_SPAWNFUNC_PREFIX -//idea: divVerent -//darkplaces implementation: divVerent -//Make functions whose name start with spawnfunc_ take precedence as spawn function for loading entities. -//Useful if you have a field ammo_shells (required in any Quake mod) but want to support spawn functions called ammo_shells (like in Q3A). -//Optionally, you can declare a global "float require_spawnfunc_prefix;" which will require ANY spawn function to start with that prefix. - - -//DP_QUAKE2_MODEL -//idea: quake community -//darkplaces implementation: LordHavoc -//description: -//shows that the engine supports Quake2 .md2 files. - -//DP_QUAKE2_SPRITE -//idea: LordHavoc -//darkplaces implementation: Elric -//description: -//shows that the engine supports Quake2 .sp2 files. - -//DP_QUAKE3_MAP -//idea: quake community -//darkplaces implementation: LordHavoc -//description: -//shows that the engine supports Quake3 .bsp files. - -//DP_QUAKE3_MODEL -//idea: quake community -//darkplaces implementation: LordHavoc -//description: -//shows that the engine supports Quake3 .md3 files. - -//DP_REGISTERCVAR -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -float(string name, string value) registercvar = #93; -//description: -//adds a new console cvar to the server console (in singleplayer this is the player's console), the cvar exists until the mod is unloaded or the game quits. -//NOTE: DP_CON_SET is much better. - -//DP_SND_DIRECTIONLESSATTNNONE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//make sounds with ATTN_NONE have no spatialization (enabling easy use as music sources). - -//DP_SND_FAKETRACKS -//idea: requested - -//darkplaces implementation: Elric -//description: -//the engine plays sound/cdtracks/track001.wav instead of cd track 1 and so on if found, this allows games and mods to have music tracks without using ambientsound. -//Note: also plays .ogg with DP_SND_OGGVORBIS extension. - -//DP_SND_SOUND7_WIP1 -//DP_SND_SOUND7_WIP2 -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -void(entity e, float chan, string samp, float vol, float atten, float speed, float flags) sound7 = #8; -float SOUNDFLAG_RELIABLE = 1; -//description: -//plays a sound, with some more flags -//extensions to sound(): -//- channel may be in the range from -128 to 127; channels -128 to 0 are "auto", -// i.e. support multiple sounds at once, but cannot be stopped/restarted -//- a value 0 in the speed parameter means no change; otherwise, it is a -// percentage of playback speed ("pitch shifting"). 100 is normal pitch, 50 is -// half speed, 200 is double speed, etc. (DP_SND_SOUND7_WIP2) -//- the flag SOUNDFLAG_RELIABLE can be specified, which makes the sound send -// to MSG_ALL (reliable) instead of MSG_BROADCAST (unreliable, default); -// similarily, SOUNDFLAG_RELIABLE_TO_ONE sends to MSG_ONE -//- channel 0 is controlled by snd_channel0volume; channel 1 and -1 by -// snd_channel1volume, etc. (so, a channel shares the cvar with its respective -// auto-channel); however, the mod MUST define snd_channel8volume and upwards -// in default.cfg if they are to be used, as the engine does not create them -// to not litter the cvar list -//- this extension applies to CSQC as well; CSQC_Event_Sound will get speed and -// flags as extra 7th and 8th argument -//- WIP2 ideas: SOUNDFLAG_RELIABLE_TO_ONE, SOUNDFLAG_NOPHS, SOUNDFLAG_FORCELOOP -//- NOTE: to check for this, ALSO OR a check with DP_SND_SOUND7 to also support -// the finished extension once done - -//DP_SND_OGGVORBIS -//idea: Transfusion -//darkplaces implementation: Elric -//description: -//the engine supports loading Ogg Vorbis sound files. Use either the .ogg filename directly, or a .wav of the same name (will try to load the .wav first and then .ogg). - -//DP_SND_STEREOWAV -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//the engine supports stereo WAV files. (useful with DP_SND_DIRECTIONLESSATTNNONE for music) - -//DP_SND_GETSOUNDTIME -//idea: VorteX -//darkplaces implementation: VorteX -//constant definitions: -float(entity e, float channel) getsoundtime = #533; // get currently sound playing position on entity channel, -1 if not playing or error -float(string sample) soundlength = #534; // returns length of sound sample in seconds, -1 on error (sound not precached, sound system not initialized etc.) -//description: provides opportunity to query length of sound samples and realtime tracking of sound playing on entities (similar to DP_GETTIME_CDTRACK) -//note: beware dedicated server not running sound engine at all, so in dedicated mode this builtins will not work in server progs -//note also: menu progs not supporting getsoundtime() (will give a warning) since it has no sound playing on entities -//examples of use: -// - QC-driven looped sounds -// - QC events when sound playing is finished -// - toggleable ambientsounds -// - subtitles - -//DP_VIDEO_DPV -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//console commands: -// playvideo - start playing video -// stopvideo - stops current video -//description: indicated that engine support playing videos in DPV format - -//DP_VIDEO_SUBTITLES -//idea: VorteX -//darkplaces implementation: VorteX -//cvars: -// cl_video_subtitles - toggles subtitles showing -// cl_video_subtitles_lines - how many lines to reserve for subtitles -// cl_video_subtitles_textsize - font size -//console commands: -// playvideo - start playing video -// stopvideo - stops current video -//description: indicates that engine support subtitles on videos -//subtitles stored in external text files, each video file has it's default subtitles file ( .dpsubs ) -//example: for video/act1.dpv default subtitles file will be video/act1.dpsubs -//also video could be played with custom subtitles file by utilizing second parm of playvideo command -//syntax of .dpsubs files: each line in .dpsubs file defines 1 subtitle, there are three tokens: -// "string" -// start: subtitle start time in seconds -// end: subtitle time-to-show in seconds, if 0 - subtitle will be showed until next subtitle is started, -// if below 0 - show until next subtitles minus this number of seconds -// text: subtitle text, color codes (Q3-style and ^xRGB) are allowed -//example of subtitle file: -// 3 0 "Vengeance! Vengeance for my eternity of suffering!" -// 9 0 "Whelp! As if you knew what eternity was!" -// 13 0 "Grovel before your true master." -// 17 0 "Never!" -// 18 7 "I'll hack you from crotch to gizzard and feed what's left of you to your brides..." - -//DP_SOLIDCORPSE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//solid definitions: -float SOLID_CORPSE = 5; -//description: -//the entity will not collide with SOLID_CORPSE and SOLID_SLIDEBOX entities (and likewise they will not collide with it), this is useful if you want dead bodies that are shootable but do not obstruct movement by players and monsters, note that if you traceline with a SOLID_SLIDEBOX entity as the ignoreent, it will ignore SOLID_CORPSE entities, this is desirable for visibility and movement traces, but not for bullets, for the traceline to hit SOLID_CORPSE you must temporarily force the player (or whatever) to SOLID_BBOX and then restore to SOLID_SLIDEBOX after the traceline. - -//DP_SPRITE32 -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//the engine supports .spr32 sprites. - -//DP_SV_BOTCLIENT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//constants: -float CLIENTTYPE_DISCONNECTED = 0; -float CLIENTTYPE_REAL = 1; -float CLIENTTYPE_BOT = 2; -float CLIENTTYPE_NOTACLIENT = 3; -//builtin definitions: -entity() spawnclient = #454; // like spawn but for client slots (also calls relevant connect/spawn functions), returns world if no clients available -float(entity clent) clienttype = #455; // returns one of the CLIENTTYPE_* constants -//description: -//spawns a client with no network connection, to allow bots to use client slots with no hacks. -//How to use: -/* - // to spawn a bot - local entity oldself; - oldself = self; - self = spawnclient(); - if (!self) - { - bprint("Can not add bot, server full.\n"); - self = oldself; - return; - } - self.netname = "Yoyobot"; - self.clientcolors = 12 * 16 + 4; // yellow (12) shirt and red (4) pants - ClientConnect(); - PutClientInServer(); - self = oldself; - - // to remove all bots - local entity head; - head = find(world, classname, "player"); - while (head) - { - if (clienttype(head) == CLIENTTYPE_BOT) - dropclient(head); - head = find(head, classname, "player"); - } - - // to identify if a client is a bot (for example in PlayerPreThink) - if (clienttype(self) == CLIENTTYPE_BOT) - botthink(); -*/ -//see also DP_SV_CLIENTCOLORS DP_SV_CLIENTNAME DP_SV_DROPCLIENT -//How it works: -//creates a new client, calls SetNewParms and stores the parms, and returns the client. -//this intentionally does not call SV_SendServerinfo to allow the QuakeC a chance to set the netname and clientcolors fields before actually spawning the bot by calling ClientConnect and PutClientInServer manually -//on level change ClientConnect and PutClientInServer are called by the engine to spawn in the bot (this is why clienttype() exists to tell you on the next level what type of client this is). -//parms work the same on bot clients as they do on real clients, and do carry from level to level - -//DP_SV_BOUNCEFACTOR -//idea: divVerent -//darkplaces implementation: divVerent -//field definitions: -.float bouncefactor; // velocity multiplier after a bounce -.float bouncestop; // bounce stops if velocity to bounce plane is < bouncestop * gravity AFTER the bounce -//description: -//allows qc to customize MOVETYPE_BOUNCE a bit - -//DP_SV_CLIENTCAMERA -//idea: LordHavoc, others -//darkplaces implementation: Black -//field definitions: -.entity clientcamera; // override camera entity -//description: -//allows another entity to be the camera for a client, for example a remote camera, this is similar to sending svc_setview manually except that it also changes the network culling appropriately. - -//DP_SV_CLIENTCOLORS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float clientcolors; // colors of the client (format: pants + shirt * 16) -//description: -//allows qc to read and modify the client colors associated with a client entity (not particularly useful on other entities), and automatically sends out any appropriate network updates if changed - -//DP_SV_CLIENTNAME -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//description: -//allows qc to modify the client's .netname, and automatically sends out any appropriate network updates if changed - -//DP_SV_CUSTOMIZEENTITYFORCLIENT -//idea: LordHavoc -//darkplaces implementation: [515] and LordHavoc -//field definitions: -.float() customizeentityforclient; // self = this entity, other = client entity -//description: -//allows qc to modify an entity before it is sent to each client, the function returns true if it should send, false if it should not, and is fully capable of editing the entity's fields, this allows cloaked players to appear less transparent to their teammates, navigation markers to only show to their team, etc -//tips on writing customize functions: -//it is a good idea to return false early in the function if possible to reduce cpu usage, because this function may be called many thousands of times per frame if there are many customized entities on a 64+ player server. -//you are free to change anything in self, but please do not change any other entities (the results may be very inconsistent). -//example ideas for use of this extension: -//making icons over teammates' heads which are only visible to teammates. for exasmple: float() playericon_customizeentityforclient = {return self.owner.team == other.team;}; -//making cloaked players more visible to their teammates than their enemies. for example: float() player_customizeentityforclient = {if (self.items & IT_CLOAKING) {if (self.team == other.team) self.alpha = 0.6;else self.alpha = 0.1;} return true;}; -//making explosion models that face the viewer (does not work well with chase_active). for example: float() explosion_customizeentityforclient = {self.angles = vectoangles(other.origin + other.view_ofs - self.origin);self.angles_x = 0 - self.angles_x;}; -//implementation notes: -//entity customization is done before per-client culling (visibility for instance) because the entity may be doing setorigin to display itself in different locations on different clients, may be altering its .modelindex, .effects and other fields important to culling, so customized entities increase cpu usage (non-customized entities can use all the early culling they want however, as they are not changing on a per client basis). - -//DP_SV_DISCARDABLEDEMO -//idea: parasti -//darkplaces implementation: parasti -//field definitions: -.float discardabledemo; -//description: -//when this field is set to a non-zero value on a player entity, a possibly recorded server-side demo for the player is discarded -//Note that this extension only works if: -// auto demos are enabled (the cvar sv_autodemo_perclient is set) -// discarding demos is enabled (the cvar sv_autodemo_perclient_discardable is set) - -//DP_SV_DRAWONLYTOCLIENT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.entity drawonlytoclient; -//description: -//the entity is only visible to the specified client. - -//DP_SV_DROPCLIENT -//idea: FrikaC -//darkplaces implementation: LordHavoc -//builtin definitions: -void(entity clent) dropclient = #453; -//description: -//causes the server to immediately drop the client, more reliable than stuffcmd(clent, "disconnect\n"); which could be intentionally ignored by the client engine - -//DP_SV_EFFECT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org, string modelname, float startframe, float endframe, float framerate) effect = #404; -//SVC definitions: -//float svc_effect = #52; // [vector] org [byte] modelindex [byte] startframe [byte] framecount [byte] framerate -//float svc_effect2 = #53; // [vector] org [short] modelindex [byte] startframe [byte] framecount [byte] framerate -//description: -//clientside playback of simple custom sprite effects (explosion sprites, etc). - -//DP_SV_ENTITYCONTENTSTRANSITION -//idea: Dresk -//darkplaces implementation: Dresk -//field definitions: -.void(float nOriginalContents, float nNewContents) contentstransition; -//description: -//This field function, when provided, is triggered on an entity when the contents (ie. liquid / water / etc) is changed. -//The first parameter provides the entities original contents, prior to the transition. The second parameter provides the new contents. -//NOTE: If this field function is provided on an entity, the standard watersplash sound IS SUPPRESSED to allow for authors to create their own transition sounds. - -//DP_SV_MOVETYPESTEP_LANDEVENT -//idea: Dresk -//darkplaces implementation: Dresk -//field definitions: -.void(vector vImpactVelocity) movetypesteplandevent; -//description: -//This field function, when provided, is triggered on a MOVETYPE_STEP entity when it experiences "land event". -// The standard engine behavior for this event is to play the sv_sound_land CVar sound. -//The parameter provides the velocity of the entity at the time of the impact. The z value may therefore be used to calculate how "hard" the entity struck the surface. -//NOTE: If this field function is provided on a MOVETYPE_STEP entity, the standard sv_sound_land sound IS SUPPRESSED to allow for authors to create their own feedback. - -//DP_SV_POINTSOUND -//idea: Dresk -//darkplaces implementation: Dresk -//builtin definitions: -void(vector origin, string sample, float volume, float attenuation) pointsound = #483; -//description: -//Similar to the standard QC sound function, this function takes an origin instead of an entity and omits the channel parameter. -// This allows sounds to be played at arbitrary origins without spawning entities. - -//DP_SV_ONENTITYNOSPAWNFUNCTION -//idea: Dresk -//darkplaces implementation: Dresk -//engine-called QC prototypes: -//void() SV_OnEntityNoSpawnFunction; -//description: -// This function is called whenever an entity on the server has no spawn function, and therefore has no defined QC behavior. -// You may as such dictate the behavior as to what happens to the entity. -// To mimic the engine's default behavior, simply call remove(self). - -//DP_SV_ONENTITYPREPOSTSPAWNFUNCTION -//idea: divVerent -//darkplaces implementation: divVerent -//engine-called QC prototypes: -//void() SV_OnEntityPreSpawnFunction; -//void() SV_OnEntityPostSpawnFunction; -//description: -// These functions are called BEFORE or AFTER an entity is spawned the regular way. -// You may as such dictate the behavior as to what happens to the entity. -// SV_OnEntityPreSpawnFunction is called before even looking for the spawn function, so you can even change its classname in there. If it remove()s the entity, the spawn function will not be looked for. -// SV_OnEntityPostSpawnFunction is called ONLY after its spawn function or SV_OnEntityNoSpawnFunction was called, and skipped if the entity got removed by either. - -//DP_SV_MODELFLAGS_AS_EFFECTS -//idea: LordHavoc, Dresk -//darkplaces implementation: LordHavoc -//field definitions: -.int modelflags; -//constant definitions: -float EF_NOMODELFLAGS = 8388608; // ignore any effects in a model file and substitute your own -float MF_ROCKET = 1; // leave a trail -float MF_GRENADE = 2; // leave a trail -float MF_GIB = 4; // leave a trail -float MF_ROTATE = 8; // rotate (bonus items) -float MF_TRACER = 16; // green split trail -float MF_ZOMGIB = 32; // small blood trail -float MF_TRACER2 = 64; // orange split trail -float MF_TRACER3 = 128; // purple trail -//description: -//this extension allows model flags to be specified on entities so you can add a rocket trail and glow to any entity, etc. -//setting any of these will override the flags the model already has, to disable the model's flags without supplying any of your own you must use EF_NOMODELFLAGS. -// -//silly example modification #1 to W_FireRocket in weapons.qc: -//missile.effects = EF_NOMODELFLAGS; // rocket without a glow/fire trail -//silly example modification #2 to W_FireRocket in weapons.qc: -//missile.modelflags = MF_GIB; // leave a blood trail instead of glow/fire trail -// -//note: you can not combine multiple kinds of trail, only one of them will be active, you can combine MF_ROTATE and the other MF_ flags however, and using EF_NOMODELFLAGS along with these does no harm. -// -//note to engine coders: they are internally encoded in the protocol as extra EF_ flags (shift the values left 24 bits and send them in the protocol that way), so no protocol change was required (however 32bit effects is a protocol extension itself), within the engine they are referred to as EF_ for the 24bit shifted values. - -//DP_SV_NETADDRESS -//idea: Dresk -//darkplaces implementation: Dresk -//field definitions: -.string netaddress; -//description: -// provides the netaddress of the associated entity (ie. 127.0.0.1) and "null/botclient" if the netconnection of the entity is invalid - -//DP_SV_NODRAWTOCLIENT -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.entity nodrawtoclient; -//description: -//the entity is not visible to the specified client. - -//DP_SV_PING -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float ping; -//description: -//continuously updated field indicating client's ping (based on average of last 16 packet time differences). - -//DP_SV_PING_PACKETLOSS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float ping_packetloss; -.float ping_movementloss; -//description: -//continuously updated field indicating client's packet loss, and movement loss (i.e. packet loss affecting player movement). - -//DP_SV_POINTPARTICLES -//idea: Spike -//darkplaces implementation: LordHavoc -//function definitions: -int(string effectname) particleeffectnum = #335; // same as in CSQC -void(entity ent, float effectnum, vector start, vector end) trailparticles = #336; // same as in CSQC -void(float effectnum, vector org, vector vel, float howmany) pointparticles = #337; // same as in CSQC -//SVC definitions: -//float svc_trailparticles = 60; // [short] entnum [short] effectnum [vector] start [vector] end -//float svc_pointparticles = 61; // [short] effectnum [vector] start [vector] velocity [short] count -//float svc_pointparticles1 = 62; // [short] effectnum [vector] start, same as svc_pointparticles except velocity is zero and count is 1 -//description: -//provides the ability to spawn non-standard particle effects, typically these are defined in a particle effect information file such as effectinfo.txt in darkplaces. -//this is a port of particle effect features from clientside QC (EXT_CSQC) to server QC, as these effects are potentially useful to all games even if they do not make use of EXT_CSQC. -//warning: server must have same order of effects in effectinfo.txt as client does or the numbers would not match up, except for standard quake effects which are always the same numbers. - -//DP_SV_PUNCHVECTOR -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.vector punchvector; -//description: -//offsets client view in worldspace, similar to view_ofs but all 3 components are used and are sent with at least 8 bits of fraction, this allows the view to be kicked around by damage or hard landings or whatever else, note that unlike punchangle this is not faded over time, it is up to the mod to fade it (see also DP_SV_PLAYERPHYSICS). - -//DP_SV_PLAYERPHYSICS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.vector movement; -//cvar definitions: -//"sv_playerphysicsqc" (0/1, default 1, allows user to disable qc player physics) -//engine-called QC prototypes: -//void() SV_PlayerPhysics; -//description: -//.movement vector contains the movement input from the player, allowing QC to do as it wishs with the input, and SV_PlayerPhysics will completely replace the player physics if present (works for all MOVETYPE's), see darkplaces mod source for example of this function (in playermovement.qc, adds HalfLife ladders support, as well as acceleration/deceleration while airborn (rather than the quake sudden-stop while airborn), and simplifies the physics a bit) - -//DP_PHYSICS_ODE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//globals: -//new movetypes: -const float MOVETYPE_PHYSICS = 32; // need to be set before any physics_* builtins applied -//new solid types (deprecated): -const float SOLID_PHYSICS_BOX = 32; -const float SOLID_PHYSICS_SPHERE = 33; -const float SOLID_PHYSICS_CAPSULE = 34; -const float SOLID_PHYSICS_TRIMESH = 35; -const float SOLID_PHYSICS_CYLINDER = 36; -//geometry types: -const float GEOMTYPE_NONE = -1; // entity will be entirely skipped by ODE -const float GEOMTYPE_SOLID = 0; // geometry type will be set based on .solid field -const float GEOMTYPE_BOX = 1; // entity bound box -const float GEOMTYPE_SPHERE = 2; // sphere with radius picked from x axis of entity bound box -const float GEOMTYPE_CAPSULE = 3; // with leading axis automatically determined from longest one, radius is picked as minimal of the rest 2 axes -const float GEOMTYPE_TRIMESH = 4; // triangle mesh -const float GEOMTYPE_CYLINDER = 5; // like capsule but not capped - // note that ODE's builtin cylinder support is experimental, somewhat bugged and unfinished (no cylinder-cylinder collision) - // to use properly working cylinder should build ODE with LIBCCD extension -const float GEOMTYPE_CAPSULE_X = 6; // capsule with fixed leading axis -const float GEOMTYPE_CAPSULE_Y = 7; -const float GEOMTYPE_CAPSULE_Z = 8; -const float GEOMTYPE_CYLINDER_X = 9; // cylinder with fixed leading axis -const float GEOMTYPE_CYLINDER_Y = 10; -const float GEOMTYPE_CYLINDER_Z = 11; -//joint types: -const float JOINTTYPE_NONE = 0; -const float JOINTTYPE_POINT = 1; -const float JOINTTYPE_HINGE = 2; -const float JOINTTYPE_SLIDER = 3; -const float JOINTTYPE_UNIVERSAL = 4; -const float JOINTTYPE_HINGE2 = 5; -const float JOINTTYPE_FIXED = -1; -//force types: -const float FORCETYPE_NONE = 0; -const float FORCETYPE_FORCE = 1; // applied at center of mass -const float FORCETYPE_FORCEATPOS = 2; -const float FORCETYPE_TORQUE = 3; -// common joint properties: -// .entity aiment; // connected objects -// .entity enemy; // connected objects, forces -// .vector movedir; -// for a spring: -// movedir_x = spring constant (force multiplier, must be > 0) -// movedir_y = spring dampening constant to prevent oscillation (must be > 0) -// movedir_z = spring stop position (+/-) -// for a motor: -// movedir_x = desired motor velocity -// movedir_y = -1 * max motor force to use -// movedir_z = stop position (+/-), set to 0 for no stop -// note that ODE does not support both in one anyway -// for a force: -// force vector to apply -//field definitions: -.float geomtype; // see GEOMTYPE_*, a more correct way to set collision shape, allows to set SOLID_CORPSE and trimesh collisions -.float maxcontacts; // maximum number of contacts to make for this object, lesser = faster (but setting it too low will could make object pass though walls), default is 16, maximum is 32 -.float mass; // ODE mass, standart value is 1 -.vector massofs; // offsets a mass center out of object center, if not set a center of model bounds is used -.float friction; // a friction of object, get multiplied by second objects's friction on contact -.float bouncefactor; -.float bouncestop; -.float jointtype; // type of joint -.float forcetype; // type of force -.float erp; // error restitution parameter, makes ODE solver attempt to fix errors in contacts, - // bringing together 2 joints or fixing object being stuch in other object, - // a value of 0.1 will fix slightly, a value of 1.0 attempts to fix whole error in one frame - // use with care as high values makes system unstable and likely to explode -//builtin definitions: -void(entity e, float physics_enabled) physics_enable = #540; // enable or disable physics on object -void(entity e, vector force, vector force_pos) physics_addforce = #541; // deprecated, apply a force from certain origin, length of force vector is power of force -void(entity e, vector torque) physics_addtorque = #542; // deprecated, add relative torque -//description: provides Open Dynamics Engine support, requires extenal dll to be present or engine compiled with statical link option -//be sure to checkextension for it to know if library is loaded and ready, also to enable physics set "physics_ode" cvar to 1 -//note: this extension is highly experimental and may be unstable - -//DP_SV_PRINT -//idea: id Software (QuakeWorld Server) -//darkplaces implementation: Black, LordHavoc -void(string s, ...) print = #339; // same number as in EXT_CSQC -//description: -//this is identical to dprint except that it always prints regardless of the developer cvar. - -//DP_SV_PRECACHEANYTIME -//idea: id Software (Quake2) -//darkplaces implementation: LordHavoc -//description: -//this extension allows precache_model and precache_sound (and any variants) to be used during the game (with automatic messages to clients to precache the new model/sound indices), also setmodel/sound/ambientsound can be called without precaching first (they will cause an automatic precache). - -//DP_SV_QCSTATUS -//idea: divVerent -//darkplaces implementation: divVerent -//1. A global variable -string worldstatus; -//Its content is set as "qcstatus" field in the rules. -//It may be at most 255 characters, and must not contain newlines or backslashes. -//2. A per-client field -.string clientstatus; -//It is sent instead of the "frags" in status responses. -//It should always be set in a way so that stof(player.clientstatus) is a meaningful score value. Other info may be appended. If used this way, the cvar sv_status_use_qcstatus may be set to 1, and then this value will replace the frags in "status". -//Currently, qstat does not support this and will not show player info if used and set to anything other than ftos(some integer). - -//DP_SV_ROTATINGBMODEL -//idea: id Software -//darkplaces implementation: LordHavoc -//description: -//this extension merely indicates that MOVETYPE_PUSH supports avelocity, allowing rotating brush models to be created, they rotate around their origin (needs rotation supporting qbsp/light utilities because id ones expected bmodel entity origins to be '0 0 0', recommend setting "origin" key in the entity fields in the map before compiling, there may be other methods depending on your qbsp, most are more complicated however). -//tip: level designers can create a func_wall with an origin, and avelocity (for example "avelocity" "0 90 0"), and "nextthink" "99999999" to make a rotating bmodel without any qc modifications, such entities will be solid in stock quake but will not rotate) - -//DP_SV_SETCOLOR -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(entity ent, float colors) setcolor = #401; -//engine called QC functions (optional): -//void(float color) SV_ChangeTeam; -//description: -//setcolor sets the color on a client and updates internal color information accordingly (equivalent to stuffing a "color" command but immediate) -//SV_ChangeTeam is called by the engine whenever a "color" command is recieved, it may decide to do anything it pleases with the color passed by the client, including rejecting it (by doing nothing), or calling setcolor to apply it, preventing team changes is one use for this. -//the color format is pants + shirt * 16 (0-255 potentially) - -//DP_SV_SLOWMO -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//cvars: -//"slowmo" (0+, default 1) -//description: -//sets the time scale of the server, mainly intended for use in singleplayer by the player, however potentially useful for mods, so here's an extension for it. -//range is 0 to infinite, recommended values to try are 0.1 (very slow, 10% speed), 1 (normal speed), 5 (500% speed). - -//DP_SV_WRITEPICTURE -//idea: divVerent -//darkplaces implementation: divVerent -//builtin definitions: -void(float to, string s, float sz) WritePicture = #501; -//description: -//writes a picture to the data stream so CSQC can read it using ReadPicture, which has the definition -// string(void) ReadPicture = #501; -//The picture data is sent as at most sz bytes, by compressing to low quality -//JPEG. The data being sent will be equivalent to: -// WriteString(to, s); -// WriteShort(to, imagesize); -// for(i = 0; i < imagesize; ++i) -// WriteByte(to, [the i-th byte of the compressed JPEG image]); - -//DP_SV_WRITEUNTERMINATEDSTRING -//idea: FrikaC -//darkplaces implementation: Sajt -//builtin definitions: -void(float to, string s) WriteUnterminatedString = #456; -//description: -//like WriteString, but does not write a terminating 0 after the string. This means you can include things like a player's netname in the middle of a string sent over the network. Just be sure to end it up with either a call to WriteString (which includes the trailing 0) or WriteByte(0) to terminate it yourself. -//A historical note: this extension was suggested by FrikaC years ago, more recently Shadowalker has been badmouthing LordHavoc and Spike for stealing 'his' extension writestring2 which does exactly the same thing but uses a different builtin number and name and extension string, this argument hinges on the idea that it was his idea in the first place, which is incorrect as FrikaC first suggested it and used a rough equivalent of it in his FrikBot mod years ago involving WriteByte calls on each character. - -//DP_TE_BLOOD -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org, vector velocity, float howmany) te_blood = #405; -//temp entity definitions: -float TE_BLOOD = 50; -//protocol: -//vector origin -//byte xvelocity (-128 to +127) -//byte yvelocity (-128 to +127) -//byte zvelocity (-128 to +127) -//byte count (0 to 255, how much blood) -//description: -//creates a blood effect. - -//DP_TE_BLOODSHOWER -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector mincorner, vector maxcorner, float explosionspeed, float howmany) te_bloodshower = #406; -//temp entity definitions: -//float TE_BLOODSHOWER = 52; -//protocol: -//vector mins (minimum corner of the cube) -//vector maxs (maximum corner of the cube) -//coord explosionspeed (velocity of blood particles flying out of the center) -//short count (number of blood particles) -//description: -//creates an exploding shower of blood, for making gibbings more convincing. - -//DP_TE_CUSTOMFLASH -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org, float radius, float lifetime, vector color) te_customflash = #417; -//temp entity definitions: -//float TE_CUSTOMFLASH = 73; -//protocol: -//vector origin -//byte radius ((MSG_ReadByte() + 1) * 8, meaning 8-2048 unit radius) -//byte lifetime ((MSG_ReadByte() + 1) / 256.0, meaning approximately 0-1 second lifetime) -//byte red (0.0 to 1.0 converted to 0-255) -//byte green (0.0 to 1.0 converted to 0-255) -//byte blue (0.0 to 1.0 converted to 0-255) -//description: -//creates a customized light flash. - -//DP_TE_EXPLOSIONRGB -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org, vector color) te_explosionrgb = #407; -//temp entity definitions: -//float TE_EXPLOSIONRGB = 53; -//protocol: -//vector origin -//byte red (0.0 to 1.0 converted to 0 to 255) -//byte green (0.0 to 1.0 converted to 0 to 255) -//byte blue (0.0 to 1.0 converted to 0 to 255) -//description: -//creates a colored explosion effect. - -//DP_TE_FLAMEJET -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org, vector vel, float howmany) te_flamejet = #457; -//temp entity definitions: -//float TE_FLAMEJET = 74; -//protocol: -//vector origin -//vector velocity -//byte count (0 to 255, how many flame particles) -//description: -//creates a single puff of flame particles. (not very useful really) - -//DP_TE_PARTICLECUBE -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector mincorner, vector maxcorner, vector vel, float howmany, float color, float gravityflag, float randomveljitter) te_particlecube = #408; -//temp entity definitions: -//float TE_PARTICLECUBE = 54; -//protocol: -//vector mins (minimum corner of the cube) -//vector maxs (maximum corner of the cube) -//vector velocity -//short count -//byte color (palette color) -//byte gravity (true or false, FIXME should this be a scaler instead?) -//coord randomvel (how much to jitter the velocity) -//description: -//creates a cloud of particles, useful for forcefields but quite customizable. - -//DP_TE_PARTICLERAIN -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlerain = #409; -//temp entity definitions: -//float TE_PARTICLERAIN = 55; -//protocol: -//vector mins (minimum corner of the cube) -//vector maxs (maximum corner of the cube) -//vector velocity (velocity of particles) -//short count (number of particles) -//byte color (8bit palette color) -//description: -//creates a shower of rain, the rain will appear either at the top (if falling down) or bottom (if falling up) of the cube. - -//DP_TE_PARTICLESNOW -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlesnow = #410; -//temp entity definitions: -//float TE_PARTICLERAIN = 56; -//protocol: -//vector mins (minimum corner of the cube) -//vector maxs (maximum corner of the cube) -//vector velocity (velocity of particles) -//short count (number of particles) -//byte color (8bit palette color) -//description: -//creates a shower of snow, the snow will appear either at the top (if falling down) or bottom (if falling up) of the cube, low velocities are advisable for convincing snow. - -//DP_TE_PLASMABURN -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org) te_plasmaburn = #433; -//temp entity definitions: -//float TE_PLASMABURN = 75; -//protocol: -//vector origin -//description: -//creates a small light flash (radius 200, time 0.2) and marks the walls. - -//DP_TE_QUADEFFECTS1 -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org) te_gunshotquad = #412; -void(vector org) te_spikequad = #413; -void(vector org) te_superspikequad = #414; -void(vector org) te_explosionquad = #415; -//temp entity definitions: -//float TE_GUNSHOTQUAD = 57; // [vector] origin -//float TE_SPIKEQUAD = 58; // [vector] origin -//float TE_SUPERSPIKEQUAD = 59; // [vector] origin -//float TE_EXPLOSIONQUAD = 70; // [vector] origin -//protocol: -//vector origin -//description: -//all of these just take a location, and are equivalent in function (but not appearance :) to the original TE_GUNSHOT, etc. - -//DP_TE_SMALLFLASH -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org) te_smallflash = #416; -//temp entity definitions: -//float TE_SMALLFLASH = 72; -//protocol: -//vector origin -//description: -//creates a small light flash (radius 200, time 0.2). - -//DP_TE_SPARK -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org, vector vel, float howmany) te_spark = #411; -//temp entity definitions: -//float TE_SPARK = 51; -//protocol: -//vector origin -//byte xvelocity (-128 to 127) -//byte yvelocity (-128 to 127) -//byte zvelocity (-128 to 127) -//byte count (number of sparks) -//description: -//creates a shower of sparks and a smoke puff. - -//DP_TE_STANDARDEFFECTBUILTINS -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -void(vector org) te_gunshot = #418; -void(vector org) te_spike = #419; -void(vector org) te_superspike = #420; -void(vector org) te_explosion = #421; -void(vector org) te_tarexplosion = #422; -void(vector org) te_wizspike = #423; -void(vector org) te_knightspike = #424; -void(vector org) te_lavasplash = #425; -void(vector org) te_teleport = #426; -void(vector org, float color, float colorlength) te_explosion2 = #427; -void(entity own, vector start, vector end) te_lightning1 = #428; -void(entity own, vector start, vector end) te_lightning2 = #429; -void(entity own, vector start, vector end) te_lightning3 = #430; -void(entity own, vector start, vector end) te_beam = #431; -//description: -//to make life easier on mod coders. - -//DP_TRACE_HITCONTENTSMASK_SURFACEINFO -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//globals: -.int dphitcontentsmask; // if non-zero on the entity passed to traceline/tracebox/tracetoss this will override the normal collidable contents rules and instead hit these contents values (for example AI can use tracelines that hit DONOTENTER if it wants to, by simply changing this field on the entity passed to traceline), this affects normal movement as well as trace calls -int trace_dpstartcontents; // DPCONTENTS_ value at start position of trace -int trace_dphitcontents; // DPCONTENTS_ value of impacted surface (not contents at impact point, just contents of the surface that was hit) -int trace_dphitq3surfaceflags; // Q3SURFACEFLAG_ value of impacted surface -string trace_dphittexturename; // texture name of impacted surface -//constants: -const int DPCONTENTS_SOLID = 1; // hit a bmodel, not a bounding box -const int DPCONTENTS_WATER = 2; -const int DPCONTENTS_SLIME = 4; -const int DPCONTENTS_LAVA = 8; -const int DPCONTENTS_SKY = 16; -const int DPCONTENTS_BODY = 32; // hit a bounding box, not a bmodel -const int DPCONTENTS_CORPSE = 64; // hit a SOLID_CORPSE entity -const int DPCONTENTS_NODROP = 128; // an area where backpacks should not spawn -const int DPCONTENTS_PLAYERCLIP = 256; // blocks player movement -const int DPCONTENTS_MONSTERCLIP = 512; // blocks monster movement -const int DPCONTENTS_DONOTENTER = 1024; // AI hint brush -const int DPCONTENTS_LIQUIDSMASK = 14; // WATER | SLIME | LAVA -const int DPCONTENTS_BOTCLIP = 2048; // AI hint brush -const int DPCONTENTS_OPAQUE = 4096; // only fully opaque brushes get this (may be useful for line of sight checks) -const int Q3SURFACEFLAG_NODAMAGE = 1; -const int Q3SURFACEFLAG_SLICK = 2; // low friction surface -const int Q3SURFACEFLAG_SKY = 4; // sky surface (also has NOIMPACT and NOMARKS set) -const int Q3SURFACEFLAG_LADDER = 8; // climbable surface -const int Q3SURFACEFLAG_NOIMPACT = 16; // projectiles should remove themselves on impact (this is set on sky) -const int Q3SURFACEFLAG_NOMARKS = 32; // projectiles should not leave marks, such as decals (this is set on sky) -const int Q3SURFACEFLAG_FLESH = 64; // projectiles should do a fleshy effect (blood?) on impact -const int Q3SURFACEFLAG_NODRAW = 128; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_HINT = 256; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_SKIP = 512; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_NOLIGHTMAP = 1024; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_POINTLIGHT = 2048; // compiler hint (not important to qc) -const int Q3SURFACEFLAG_METALSTEPS = 4096; // walking on this surface should make metal step sounds -const int Q3SURFACEFLAG_NOSTEPS = 8192; // walking on this surface should not make footstep sounds -const int Q3SURFACEFLAG_NONSOLID = 16384; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_LIGHTFILTER = 32768; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_ALPHASHADOW = 65536; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_NODLIGHT = 131072; // compiler hint (not important to qc) -//float Q3SURFACEFLAG_DUST = 262144; // translucent 'light beam' effect (not important to qc) -//description: -//adds additional information after a traceline/tracebox/tracetoss call. -//also (very important) sets trace_* globals before calling .touch functions, -//this allows them to inspect the nature of the collision (for example -//determining if a projectile hit sky), clears trace_* variables for the other -//object in a touch event (that is to say, a projectile moving will see the -//trace results in its .touch function, but the player it hit will see very -//little information in the trace_ variables as it was not moving at the time) - -//DP_VIEWZOOM -//idea: LordHavoc -//darkplaces implementation: LordHavoc -//field definitions: -.float viewzoom; -//description: -//scales fov and sensitivity of player, valid range is 0 to 1 (intended for sniper rifle zooming, and such) - -//EXT_BITSHIFT -//idea: Spike -//darkplaces implementation: [515] -//builtin definitions: -float(float number, float quantity) bitshift = #218; -//description: -//multiplies number by a power of 2 corresponding to quantity (0 = *1, 1 = *2, 2 = *4, 3 = *8, -1 = /2, -2 = /4x, etc), and rounds down (due to integer math) like other bit operations do (& and | and the like). -//note: it is faster to use multiply if you are shifting by a constant, avoiding the quakec function call cost, however that does not do a floor for you. - -//FRIK_FILE -//idea: FrikaC -//darkplaces implementation: LordHavoc -//builtin definitions: -float(string s) stof = #81; // get numerical value from a string -float(string filename, float mode) fopen = #110; // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE), returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason -void(float fhandle) fclose = #111; // closes a file -string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring -void(float fhandle, string s, ...) fputs = #113; // writes a line of text to the end of the file -int(string s) strlen = #114; // returns how many characters are in a string -string(string s1, string s2, ...) strcat = #115; // concatenates two or more strings (for example "abc", "def" would return "abcdef") and returns as a tempstring -string(string s, float start, float length) substring = #116; // returns a section of a string as a tempstring - see FTE_STRINGS for enhanced version -vector(string s) stov = #117; // returns vector value from a string -string(string s, ...) strzone = #118; // makes a copy of a string into the string zone and returns it, this is often used to keep around a tempstring for longer periods of time (tempstrings are replaced often) -void(string s) strunzone = #119; // removes a copy of a string from the string zone (you can not use that string again or it may crash!!!) -//constants: -float FILE_READ = 0; -float FILE_APPEND = 1; -float FILE_WRITE = 2; -//cvars: -//pr_zone_min_strings : default 64 (64k), min 64 (64k), max 8192 (8mb) -//description: -//provides text file access functions and string manipulation functions, note that you may want to set pr_zone_min_strings in the worldspawn function if 64k is not enough string zone space. -// -//NOTE: strzone functionality is partially superseded by -//DP_QC_UNLIMITEDTEMPSTRINGS when longterm storage is not needed -//NOTE: substring is upgraded by FTE_STRINGS extension with negative start/length handling identical to php 5.2.0 - -//FTE_CSQC_SKELETONOBJECTS -//idea: Spike, LordHavoc -//darkplaces implementation: LordHavoc -//builtin definitions: -// all skeleton numbers are 1-based (0 being no skeleton) -// all bone numbers are 1-based (0 being invalid) -float(float modlindex) skel_create = #263; // create a skeleton (be sure to assign this value into .skeletonindex for use), returns skeleton index (1 or higher) on success, returns 0 on failure (for example if the modelindex is not skeletal), it is recommended that you create a new skeleton if you change modelindex, as the skeleton uses the hierarchy from the model. -float(float skel, entity ent, float modlindex, float retainfrac, float firstbone, float lastbone) skel_build = #264; // blend in a percentage of standard animation, 0 replaces entirely, 1 does nothing, 0.5 blends half, etc, and this only alters the bones in the specified range for which out of bounds values like 0,100000 are safe (uses .frame, .frame2, .frame3, .frame4, .lerpfrac, .lerpfrac3, .lerpfrac4, .frame1time, .frame2time, .frame3time, .frame4time), returns skel on success, 0 on failure -float(float skel) skel_get_numbones = #265; // returns how many bones exist in the created skeleton, 0 if skeleton does not exist -string(float skel, float bonenum) skel_get_bonename = #266; // returns name of bone (as a tempstring), "" if invalid bonenum (< 1 for example) or skeleton does not exist -int(float skel, float bonenum) skel_get_boneparent = #267; // returns parent num for supplied bonenum, 0 if bonenum has no parent or bone does not exist (returned value is always less than bonenum, you can loop on this) -int(float skel, string tagname) skel_find_bone = #268; // get number of bone with specified name, 0 on failure, bonenum (1-based) on success, same as using gettagindex but takes modelindex instead of entity -vector(float skel, float bonenum) skel_get_bonerel = #269; // get matrix of bone in skeleton relative to its parent - sets v_forward, v_right, v_up, returns origin (relative to parent bone) -vector(float skel, float bonenum) skel_get_boneabs = #270; // get matrix of bone in skeleton in model space - sets v_forward, v_right, v_up, returns origin (relative to entity) -void(float skel, float bonenum, vector org) skel_set_bone = #271; // set matrix of bone relative to its parent, reads v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) -void(float skel, float bonenum, vector org) skel_mul_bone = #272; // transform bone matrix (relative to its parent) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) -void(float skel, float startbone, float endbone, vector org) skel_mul_bones = #273; // transform bone matrices (relative to their parents) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bones) -void(float skeldst, float skelsrc, float startbone, float endbone) skel_copybones = #274; // copy bone matrices (relative to their parents) from one skeleton to another, useful for copying a skeleton to a corpse -void(float skel) skel_delete = #275; // deletes skeleton at the beginning of the next frame (you can add the entity, delete the skeleton, renderscene, and it will still work) -float(float modlindex, string framename) frameforname = #276; // finds number of a specified frame in the animation, returns -1 if no match found -float(float modlindex, float framenum) frameduration = #277; // returns the intended play time (in seconds) of the specified framegroup, if it does not exist the result is 0, if it is a single frame it may be a small value around 0.1 or 0. -//fields: -.int skeletonindex; // active skeleton overriding standard animation on model -.int frame; // primary framegroup animation (strength = 1 - lerpfrac - lerpfrac3 - lerpfrac4) -.int frame2; // secondary framegroup animation (strength = lerpfrac) -.float frame3; // tertiary framegroup animation (strength = lerpfrac3) -.float frame4; // quaternary framegroup animation (strength = lerpfrac4) -.float lerpfrac; // strength of framegroup blend -.float lerpfrac3; // strength of framegroup blend -.float lerpfrac4; // strength of framegroup blend -.float frame1time; // start time of framegroup animation -.float frame2time; // start time of framegroup animation -.float frame3time; // start time of framegroup animation -.float frame4time; // start time of framegroup animation -//description: -//this extension provides a way to do complex skeletal animation on an entity. -// -//see also DP_SKELETONOBJECTS (this extension implemented on server as well as client) -// -//notes: -//each model contains its own skeleton, reusing a skeleton with incompatible models will yield garbage (or not render). -//each model contains its own animation data, you can use animations from other model files (for example saving out all character animations as separate model files). -//if an engine supports loading an animation-only file format such as .md5anim in FTEQW, it can be used to animate any model with a compatible skeleton. -//proper use of this extension may require understanding matrix transforms (v_forward, v_right, v_up, origin), and you must keep in mind that v_right is negative for this purpose. -// -//features include: -//multiple animations blended together. -//animating a model with animations from another model with a compatible skeleton. -//restricting animation blends to certain bones of a model - for example independent animation of legs, torso, head. -//custom bone controllers - for example making eyes track a target location. -// -// -// -//example code follows... -// -//this helper function lets you identify (by parentage) what group a bone -//belongs to - for example "torso", "leftarm", would return 1 ("torso") for -//all children of the bone named "torso", unless they are children of -//"leftarm" (which is a child of "torso") which would return 2 instead... -float(float skel, float bonenum, string g1, string g2, string g3, string g4, string g5, string g6) example_skel_findbonegroup = -{ - while (bonenum >= 0) - { - string bonename = skel_get_bonename(skel, bonenum); - if (bonename == g1) return 1; - if (bonename == g2) return 2; - if (bonename == g3) return 3; - if (bonename == g4) return 4; - if (bonename == g5) return 5; - if (bonename == g6) return 6; - bonenum = skel_get_boneparent(skel, bonenum); - } - return 0; -}; -// create a skeletonindex for our player using current modelindex -void() example_skel_player_setup = -{ - self.skeletonindex = skel_create(self.modelindex); -}; -// setup bones of skeleton based on an animation -// note: animmodelindex can be a different model than self.modelindex -void(float animmodelindex, float framegroup, float framegroupstarttime) example_skel_player_update_begin = -{ - // start with our standard animation - self.frame = framegroup; - self.frame2 = 0; - self.frame3 = 0; - self.frame4 = 0; - self.frame1time = framegroupstarttime; - self.frame2time = 0; - self.frame3time = 0; - self.frame4time = 0; - self.lerpfrac = 0; - self.lerpfrac3 = 0; - self.lerpfrac4 = 0; - skel_build(self.skeletonindex, self, animmodelindex, 0, 0, 100000); -}; -// apply a different framegroup animation to bones with a specified parent -void(float animmodelindex, float framegroup, float framegroupstarttime, float blendalpha, string groupbonename, string excludegroupname1, string excludegroupname2) example_skel_player_update_applyoverride = -{ - self.frame = framegroup; - self.frame2 = 0; - self.frame3 = 0; - self.frame4 = 0; - self.frame1time = framegroupstarttime; - self.frame2time = 0; - self.frame3time = 0; - self.frame4time = 0; - self.lerpfrac = 0; - self.lerpfrac3 = 0; - self.lerpfrac4 = 0; - float bonenum = 0; - float numbones = skel_get_numbones(self.skeletonindex); - while (bonenum < numbones) - { - if (example_skel_findbonegroup(self.skeletonindex, bonenum, groupbonename, excludegroupname1, excludegroupname2, "", "", "") == 1) - skel_build(self.skeletonindex, self, animmodelindex, 1 - blendalpha, bonenum, bonenum + 1); - bonenum = bonenum + 1; - } -}; -// make eyes point at a target location, be sure v_forward, v_right, v_up are set correctly before calling -void(vector eyetarget, string bonename) example_skel_player_update_eyetarget = -{ - float bonenum = skel_find_bone(self.skeletonindex, bonename) - 1; - if (bonenum < 0) - return; - vector oldforward = v_forward; - vector oldright = v_right; - vector oldup = v_up; - vector v = eyetarget - self.origin; - vector modeleyetarget; - modeleyetarget.x = v * v_forward; - modeleyetarget.y = 0-v * v_right; - modeleyetarget.z = v * v_up; - // this is an eyeball, make it point at the target location - // first get all the data we can... - vector relorg = skel_get_bonerel(self.skeletonindex, bonenum); - vector relforward = v_forward; - vector relright = v_right; - vector relup = v_up; - vector boneorg = skel_get_boneabs(self.skeletonindex, bonenum); - vector boneforward = v_forward; - vector boneright = v_right; - vector boneup = v_up; - vector parentorg = skel_get_boneabs(self.skeletonindex, skel_get_boneparent(self.skeletonindex, bonenum)); - vector parentforward = v_forward; - vector parentright = v_right; - vector parentup = v_up; - // get the vector from the eyeball to the target - vector u = modeleyetarget - boneorg; - // now transform it inversely by the parent matrix to produce new rel vectors - v.x = u * parentforward; - v.y = u * parentright; - v.z = u * parentup; - vector ang = vectoangles2(v, relup); - ang.x = 0 - ang.x; - makevectors(ang); - // set the relative bone matrix - skel_set_bone(self.skeletonindex, bonenum, relorg); - // restore caller's v_ vectors - v_forward = oldforward; - v_right = oldright; - v_up = oldup; -}; -// delete skeleton when we're done with it -// note: skeleton remains valid until next frame when it is really deleted -void() example_skel_player_delete = -{ - skel_delete(self.skeletonindex); - self.skeletonindex = 0; -}; -// -// END OF EXAMPLES FOR FTE_CSQC_SKELETONOBJECTS -// - -//KRIMZON_SV_PARSECLIENTCOMMAND -//idea: KrimZon -//darkplaces implementation: KrimZon, LordHavoc -//engine-called QC prototypes: -//void(string s) SV_ParseClientCommand; -//builtin definitions: -void(entity e, string s) clientcommand = #440; -int(string s) tokenize = #441; -string(float n) argv = #442; -//description: -//provides QC the ability to completely control server interpretation of client commands ("say" and "color" for example, clientcommand is necessary for this and substring (FRIK_FILE) is useful) as well as adding new commands (tokenize, argv, and stof (FRIK_FILE) are useful for this)), whenever a clc_stringcmd is received the QC function is called, and it is up to the QC to decide what (if anything) to do with it - -//NEH_CMD_PLAY2 -//idea: Nehahra -//darkplaces implementation: LordHavoc -//description: -//shows that the engine supports the "play2" console command (plays a sound without spatialization). - -//NEH_RESTOREGAME -//idea: Nehahra -//darkplaces implementation: LordHavoc -//engine-called QC prototypes: -//void() RestoreGame; -//description: -//when a savegame is loaded, this function is called - -//NEXUIZ_PLAYERMODEL -//idea: Nexuiz -//darkplaces implementation: Black -//console commands: -//playermodel - FIXME: EXAMPLE NEEDED -//playerskin - FIXME: EXAMPLE NEEDED -//field definitions: -.string playermodel; // name of player model sent by client -.string playerskin; // name of player skin sent by client -//description: -//these client properties are used by Nexuiz. - -//NXQ_GFX_LETTERBOX -//idea: nxQuake -//darkplaces implementation: LordHavoc -//description: -//shows that the engine supports the "r_letterbox" console variable, set to values in the range 0-100 this restricts the view vertically (and turns off sbar and crosshair), value is a 0-100 percentage of how much to constrict the view, <=0 = normal view height, 25 = 75% of normal view height, 50 = 50%, 75 = 25%, >=100 = no view - -//PRYDON_CLIENTCURSOR -//idea: FrikaC -//darkplaces implementation: LordHavoc -//effects bit: -const int EF_SELECTABLE = 16384; // allows cursor to highlight entity (brighten) -//field definitions: -.float cursor_active; // true if cl_prydoncursor mode is on -.vector cursor_screen; // screen position of cursor as -1 to +1 in _x and _y (_z unused) -.vector cursor_trace_start; // position of camera -.vector cursor_trace_endpos; // position of cursor in world (as traced from camera) -.entity cursor_trace_ent; // entity the cursor is pointing at (server forces this to world if the entity is currently free at time of receipt) -//cvar definitions: -//cl_prydoncursor (0/1+, default 0, 1 and above use cursors named gfx/prydoncursor%03i.lmp - or .tga and such if DP_GFX_EXTERNALTEXTURES is implemented) -//description: -//shows that the engine supports the cl_prydoncursor cvar, this puts a clientside mouse pointer on the screen and feeds input to the server for the QuakeC to use as it sees fit. -//the mouse pointer triggers button4 if cursor is at left edge of screen, button5 if at right edge of screen, button6 if at top edge of screen, button7 if at bottom edge of screen. -//the clientside trace skips transparent entities (except those marked EF_SELECTABLE). -//the selected entity highlights only if EF_SELECTABLE is set, a typical selection method would be doubling the brightness of the entity by some means (such as colormod[] *= 2). -//intended to be used by Prydon Gate. - -//TENEBRAE_GFX_DLIGHTS -//idea: Tenebrae -//darkplaces implementation: LordHavoc -//fields: -.float light_lev; // radius (does not affect brightness), typical value 350 -.vector color; // color (does not affect radius), typical value '1 1 1' (bright white), can be up to '255 255 255' (nuclear blast) -.float style; // light style (like normal light entities, flickering torches or switchable, etc) -.float pflags; // flags (see PFLAGS_ constants) -.vector angles; // orientation of the light -.int skin; // cubemap filter number, can be 1-255 (0 is assumed to be none, and tenebrae only allows 16-255), this selects a projective light filter, a value of 1 loads cubemaps/1posx.tga and cubemaps/1negx.tga and posy, negy, posz, and negz, similar to skybox but some sides need to be rotated or flipped -//constants: -float PFLAGS_NOSHADOW = 1; // light does not cast shadows -float PFLAGS_CORONA = 2; // light has a corona flare -float PFLAGS_FULLDYNAMIC = 128; // light enable (without this set no light is produced!) -//description: -//more powerful dynamic light settings -//warning: it is best not to use cubemaps on a light entity that has a model, as using a skin number that a model does not have will cause issues in glquake, and produce warnings in darkplaces (use developer 1 to see them) -//changes compared to tenebrae (because they're too 'leet' for standards): -//note: networking should send entities with PFLAGS_FULLDYNAMIC set even if they have no model (lights in general do not have a model, nor should they) -//EF_FULLDYNAMIC effects flag replaced by PFLAGS_FULLDYNAMIC flag (EF_FULLDYNAMIC conflicts with EF_NODRAW) - -//TW_SV_STEPCONTROL -//idea: Transfusion -//darkplaces implementation: LordHavoc -//cvars: -//sv_jumpstep (0/1, default 1) -//sv_stepheight (default 18) -//description: -//sv_jumpstep allows stepping up onto stairs while airborn, sv_stepheight controls how high a single step can be. - -//FTE_QC_CHECKPVS -//idea: Urre -//darkplaces implementation: divVerent -//builtin definitions: -float checkpvs(vector viewpos, entity viewee) = #240; -//description: -//returns true if viewee can be seen from viewpos according to PVS data - -//FTE_STRINGS -//idea: many -//darkplaces implementation: KrimZon -//builtin definitions: -int(string str, string sub, float startpos) strstrofs = #221; // returns the offset into a string of the matching text, or -1 if not found, case sensitive -int(string str, float ofs) str2chr = #222; // returns the character at the specified offset as an integer, or 0 if an invalid index, or byte value - 256 if the engine supports UTF8 and the byte is part of an extended character -string(int c, ...) chr2str = #223; // returns a string representing the character given, if the engine supports UTF8 this may be a multi-byte sequence (length may be more than 1) for characters over 127. -string(float ccase, float calpha, float cnum, string s, ...) strconv = #224; // reformat a string with special color characters in the font, DO NOT USE THIS ON UTF8 ENGINES (if you are lucky they will emit ^4 and such color codes instead), the parameter values are 0=same/1=lower/2=upper for ccase, 0=same/1=white/2=red/5=alternate/6=alternate-alternate for redalpha, 0=same/1=white/2=red/3=redspecial/4=whitespecial/5=alternate/6=alternate-alternate for rednum. -string(float chars, string s, ...) strpad = #225; // pad string with spaces to a specified length, < 0 = left padding, > 0 = right padding -string(string info, string key, string value, ...) infoadd = #226; // sets or adds a key/value pair to an infostring - note: forbidden characters are \ and " -string(string info, string key) infoget = #227; // gets a key/value pair in an infostring, returns value or null if not found -int(string s1, string s2) strcmp = #228; // compare two strings -int(string s1, string s2, float len) strncmp = #228; // compare two strings up to the specified number of characters, if their length differs and is within the specified limit the result will be negative, otherwise it is the difference in value of their first non-matching character. -int(string s1, string s2) strcasecmp = #229; // compare two strings with case-insensitive matching, characters a-z are considered equivalent to the matching A-Z character, no other differences, and this does not consider special characters equal even if they look similar -int(string s1, string s2, float len) strncasecmp = #230; // same as strcasecmp but with a length limit, see strncmp -//string(string s, float start, float length) substring = #116; // see note below -//description: -//various string manipulation functions -//note: substring also exists in FRIK_FILE but this extension adds negative start and length as valid cases (see note above), substring is consistent with the php 5.2.0 substr function (not 5.2.3 behavior) -//substring returns a section of a string as a tempstring, if given negative -// start the start is measured back from the end of the string, if given a -// negative length the length is the offset back from the end of the string to -// stop at, rather than being relative to start, if start is negative and -// larger than length it is treated as 0. -// examples of substring: -// substring("blah", -3, 3) returns "lah" -// substring("blah", 3, 3) returns "h" -// substring("blah", -10, 3) returns "bla" -// substring("blah", -10, -3) returns "b" - -//DP_CON_BESTWEAPON -//idea: many -//darkplaces implementation: divVerent -//description: -//allows QC to register weapon properties for use by the bestweapon command, for mods that change required ammo count or type for the weapons -//it is done using console commands sent via stuffcmd: -// register_bestweapon quake -// register_bestweapon clear -// register_bestweapon -//for example, this is what Quake uses: -// register_bestweapon 1 1 4096 4096 6 0 // STAT_SHELLS is 6 -// register_bestweapon 2 2 1 1 6 1 -// register_bestweapon 3 3 2 2 6 1 -// register_bestweapon 4 4 4 4 7 1 // STAT_NAILS is 7 -// register_bestweapon 5 5 8 8 7 1 -// register_bestweapon 6 6 16 16 8 1 // STAT_ROCKETS is 8 -// register_bestweapon 7 7 32 32 8 1 -// register_bestweapon 8 8 64 64 9 1 // STAT_CELLS is 9 -//after each map client initialization, this is reset back to Quake settings. So you should send these data in ClientConnect. -//also, this extension introduces a new "cycleweapon" command to the user. - -//DP_QC_STRINGBUFFERS -//idea: ?? -//darkplaces implementation: LordHavoc -//functions to manage string buffer objects - that is, arbitrary length string arrays that are handled by the engine -int() buf_create = #460; -void(float bufhandle) buf_del = #461; -float(float bufhandle) buf_getsize = #462; -void(float bufhandle_from, float bufhandle_to) buf_copy = #463; -void(float bufhandle, float sortpower, float backward) buf_sort = #464; -string(float bufhandle, string glue) buf_implode = #465; -string(float bufhandle, float string_index) bufstr_get = #466; -void(float bufhandle, float string_index, string str) bufstr_set = #467; -float(float bufhandle, string str, float order) bufstr_add = #468; -void(float bufhandle, float string_index) bufstr_free = #469; - -//DP_QC_STRINGBUFFERS_CVARLIST -//idea: divVerent -//darkplaces implementation: divVerent -//functions to list cvars and store their names into a stringbuffer -//cvars that start with pattern but not with antipattern will be stored into the buffer -void(float bufhandle, string pattern, string antipattern) buf_cvarlist = #517; - -//DP_QC_STRINGBUFFERS_EXT_WIP -//idea: VorteX -//darkplaces implementation: VorteX -//constant definitions: -const float MATCH_AUTO = 0; -const float MATCH_WHOLE = 1; -const float MATCH_LEFT = 2; -const float MATCH_RIGHT = 3; -const float MATCH_MIDDLE = 4; -const float MATCH_PATTERN = 5; -//builtin definitions: -float(string filename, float bufhandle) buf_loadfile = #535; // append each line of file as new buffer string, return 1 if succesful -float(float filehandle, float bufhandle, float startpos, float numstrings) buf_writefile = #536; // writes buffer strings as lines, returns 1 if succesful -float(float bufhandle, string match, float matchrule, float startpos, float step) bufstr_find = #537; // returns string index -float(string s, string pattern, float matchrule) matchpattern = #538; // returns 0/1 -float(string s, string pattern, float matchrule, float pos) matchpatternofs = #538; -//description: -//provides a set of functions to manipulate with string buffers -//pattern wildcards: * - any character (or no characters), ? - any 1 character -//Warning: This extension is work-in-progress, it may be changed/revamped/removed at any time, dont use it if you dont want any trouble -//wip note: UTF8 is not supported yet - -//DP_QC_STRREPLACE -//idea: Sajt -//darkplaces implementation: Sajt -//builtin definitions: -string(string search, string replace, string subject) strreplace = #484; -string(string search, string replace, string subject) strireplace = #485; -//description: -//strreplace replaces all occurrences of 'search' with 'replace' in the string 'subject', and returns the result as a tempstring. -//strireplace does the same but uses case-insensitive matching of the 'search' term - -//DP_SV_SHUTDOWN -//idea: divVerent -//darkplaces implementation: divVerent -//A function that gets called just before progs exit. To save persistent data from. -//It is not called on a crash or error. -//void SV_Shutdown(); - -//EXT_CSQC -// #232 void(float index, float type, .void field) SV_AddStat (EXT_CSQC) -void(float index, float type, ...) addstat = #232; - -//ZQ_PAUSE -//idea: ZQuake -//darkplaces implementation: GreEn`mArine -//builtin definitions: -void(float pause) setpause = #531; -//function definitions: -//void(float elapsedtime) SV_PausedTic; -//description: -//during pause the world is not updated (time does not advance), SV_PausedTic is the only function you can be sure will be called at regular intervals during the pause, elapsedtime is the current system time in seconds since the pause started (not affected by slowmo or anything else). -// -//calling setpause(0) will end a pause immediately. -// -//Note: it is worth considering that network-related functions may be called during the pause (including customizeentityforclient for example), and it is also important to consider the continued use of the KRIMZON_SV_PARSECLIENTCOMMAND extension while paused (chatting players, etc), players may also join/leave during the pause. In other words, the only things that are not called are think and other time-related functions. - -//DP_COVERAGE -//idea: divVerent -//darkplaces implementation: divVerent -//function definitions: -void coverage() = #642; // Reports a coverage event. The engine counts for each of the calls to this builtin whether it has been called. - - -// EXPERIMENTAL (not finalized) EXTENSIONS: - -//DP_CRYPTO -//idea: divVerent -//darkplaces implementation: divVerent -//field definitions: (SVQC) -.string crypto_keyfp; // fingerprint of CA key the player used to authenticate -.string crypto_mykeyfp; // fingerprint of CA key the server used to authenticate to the player -.string crypto_idfp; // fingerprint of ID used by the player entity, or string_null if not identified -.float crypto_idfp_signed; // set if the player's ID has been signed -.string crypto_encryptmethod; // the string "AES128" if encrypting, and string_null if plaintext -.string crypto_signmethod; // the string "HMAC-SHA256" if signing, and string_null if plaintext -// there is no field crypto_myidfp, as that info contains no additional information the QC may have a use for -//builtin definitions: (SVQC) -float(string url, float id, string content_type, string delim, float buf, float keyid) crypto_uri_postbuf = #513; -//description: -//use -1 as buffer handle to justs end delim as postdata #endif diff --git a/qcsrc/dpdefs/keycodes.qh b/qcsrc/dpdefs/keycodes.qh index d7423083f..f4c49f143 100644 --- a/qcsrc/dpdefs/keycodes.qh +++ b/qcsrc/dpdefs/keycodes.qh @@ -3,152 +3,11 @@ #pragma noref 1 -/////////////////////////// -// key constants +//#define float const int -// -// these are the key numbers that should be passed to Key_Event -// -int K_TAB = 9; -int K_ENTER = 13; -int K_ESCAPE = 27; -int K_SPACE = 32; +#include "upstream/keycodes.qc" -// normal keys should be passed as lowercased ascii - -int K_BACKSPACE = 127; -int K_UPARROW = 128; -int K_DOWNARROW = 129; -int K_LEFTARROW = 130; -int K_RIGHTARROW = 131; - -int K_ALT = 132; -int K_CTRL = 133; -int K_SHIFT = 134; - -int K_F1 = 135; -int K_F2 = 136; -int K_F3 = 137; -int K_F4 = 138; -int K_F5 = 139; -int K_F6 = 140; -int K_F7 = 141; -int K_F8 = 142; -int K_F9 = 143; -int K_F10 = 144; -int K_F11 = 145; -int K_F12 = 146; - -int K_INS = 147; -int K_DEL = 148; -int K_PGDN = 149; -int K_PGUP = 150; -int K_HOME = 151; -int K_END = 152; - -int K_NUMLOCK = 154; -int K_CAPSLOCK = 155; -int K_SCROLLLOCK = 156; - -int K_KP_0 = 157; -int K_KP_INS = 157; // same as K_KP_0 -int K_KP_1 = 158; -int K_KP_END = 158; // same as K_KP_1 -int K_KP_2 = 159; -int K_KP_DOWNARROW = 159; // same as K_KP_2 -int K_KP_3 = 160; -int K_KP_PGDN = 160; // same as K_KP_3 -int K_KP_4 = 161; -int K_KP_LEFTARROW = 161; // same as K_KP_4 -int K_KP_5 = 162; -int K_KP_6 = 163; -int K_KP_RIGHTARROW = 163; // same as K_KP_6 -int K_KP_7 = 164; -int K_KP_HOME = 164; // same as K_KP_7 -int K_KP_8 = 165; -int K_KP_UPARROW = 165; // same as K_KP_8 -int K_KP_9 = 166; -int K_KP_PGUP = 166; // same as K_KP_9 -int K_KP_PERIOD = 167; -int K_KP_DEL = 167; // same as K_KP_PERIOD -int K_KP_DIVIDE = 168; -int K_KP_SLASH = 168; // same as K_KP_DIVIDE -int K_KP_MULTIPLY = 169; -int K_KP_MINUS = 170; -int K_KP_PLUS = 171; -int K_KP_ENTER = 172; -int K_KP_EQUALS = 173; - -// mouse buttons generate virtual keys -int K_PAUSE = 153; - -// -// joystick buttons -// -int K_JOY1 = 768; -int K_JOY2 = 769; -int K_JOY3 = 770; -int K_JOY4 = 771; - -// -// -// aux keys are for multi-buttoned joysticks to generate so they can use -// the normal binding process -// -int K_AUX1 = 772; -int K_AUX2 = 773; -int K_AUX3 = 774; -int K_AUX4 = 775; -int K_AUX5 = 776; -int K_AUX6 = 777; -int K_AUX7 = 778; -int K_AUX8 = 779; -int K_AUX9 = 780; -int K_AUX10 = 781; -int K_AUX11 = 782; -int K_AUX12 = 783; -int K_AUX13 = 784; -int K_AUX14 = 785; -int K_AUX15 = 786; -int K_AUX16 = 787; -int K_AUX17 = 788; -int K_AUX18 = 789; -int K_AUX19 = 790; -int K_AUX20 = 791; -int K_AUX21 = 792; -int K_AUX22 = 793; -int K_AUX23 = 794; -int K_AUX24 = 795; -int K_AUX25 = 796; -int K_AUX26 = 797; -int K_AUX27 = 798; -int K_AUX28 = 799; -int K_AUX29 = 800; -int K_AUX30 = 801; -int K_AUX31 = 802; -int K_AUX32 = 803; - -// -// mouse buttons generate virtual keys -// -int K_MOUSE1 = 512; -int K_MOUSE2 = 513; -int K_MOUSE3 = 514; -int K_MWHEELUP = 515; -int K_MWHEELDOWN = 516; -int K_MOUSE4 = 517; -int K_MOUSE5 = 518; -int K_MOUSE6 = 519; -int K_MOUSE7 = 520; -int K_MOUSE8 = 521; -int K_MOUSE9 = 522; -int K_MOUSE10 = 523; -int K_MOUSE11 = 524; -int K_MOUSE12 = 525; -int K_MOUSE13 = 526; -int K_MOUSE14 = 527; -int K_MOUSE15 = 528; -int K_MOUSE16 = 529; +//#undef float #pragma noref 0 diff --git a/qcsrc/dpdefs/menudefs.qh b/qcsrc/dpdefs/menudefs.qh index 853fa25f2..dce99cde5 100644 --- a/qcsrc/dpdefs/menudefs.qh +++ b/qcsrc/dpdefs/menudefs.qh @@ -3,578 +3,36 @@ #pragma noref 1 -////////////////////////////////////////////////////////// -// sys globals - -entity self; - -///////////////////////////////////////////////////////// -void end_sys_globals; -///////////////////////////////////////////////////////// -// sys fields - -///////////////////////////////////////////////////////// -void end_sys_fields; -///////////////////////////////////////////////////////// -// sys functions - -void() m_init; -void(float keynr, float ascii) m_keydown; -void(float width, float height) m_draw; -void(float mode) m_toggle; -void() m_shutdown; -// optional: float(float) m_gethostcachecategory; - -///////////////////////////////////////////////////////// -// sys constants -/////////////////////////// -// key dest constants - -float KEY_UNKNOWN = -1; -float KEY_GAME = 0; -float KEY_MENU = 2; -float KEY_MENU_GRABBED = 3; - -/////////////////////////// -// file constants - -float FILE_READ = 0; -float FILE_APPEND = 1; -float FILE_WRITE = 2; - -/////////////////////////// -// msg constants - -float MSG_BROADCAST = 0; // unreliable to all -float MSG_ONE = 1; // reliable to one (msg_entity) -float MSG_ALL = 2; // reliable to all -float MSG_INIT = 3; // write to the init string - -///////////////////////////// -// mouse target constants - -float MT_MENU = 1; -float MT_CLIENT = 2; - -///////////////////////// -// client state constants - -float CS_DEDICATED = 0; -float CS_DISCONNECTED = 1; -float CS_CONNECTED = 2; - -/////////////////////////// -// blend flags - -float DRAWFLAG_NORMAL = 0; -float DRAWFLAG_ADDITIVE = 1; -float DRAWFLAG_MODULATE = 2; -float DRAWFLAG_2XMODULATE = 3; - -/////////////////////////// -// null entity (actually it is the same like the world entity) - -entity null_entity; - -/////////////////////////// -// error constants - -// file handling -float ERR_CANNOTOPEN = -1; // fopen -float ERR_NOTENOUGHFILEHANDLES = -2; // fopen -float ERR_INVALIDMODE = -3; // fopen -float ERR_BADFILENAME = -4; // fopen - -// drawing functions - -float ERR_NULLSTRING = -1; -float ERR_BADDRAWFLAG = -2; -float ERR_BADSCALE = -3; -float ERR_BADSIZE = -3; // same as ERR_BADSCALE -float ERR_NOTCACHED = -4; - -// server list stuff -float SLIST_HOSTCACHEVIEWCOUNT = 0; -float SLIST_HOSTCACHETOTALCOUNT = 1; -float SLIST_MASTERQUERYCOUNT = 2; -float SLIST_MASTERREPLYCOUNT = 3; -float SLIST_SERVERQUERYCOUNT = 4; -float SLIST_SERVERREPLYCOUNT = 5; -float SLIST_SORTFIELD = 6; -float SLIST_SORTDESCENDING = 7; -float SLIST_LEGACY_LINE1 = 1024; -float SLIST_LEGACY_LINE2 = 1025; -float SLIST_TEST_CONTAINS = 0; -float SLIST_TEST_NOTCONTAIN = 1; -float SLIST_TEST_LESSEQUAL = 2; -float SLIST_TEST_LESS = 3; -float SLIST_TEST_EQUAL = 4; -float SLIST_TEST_GREATER = 5; -float SLIST_TEST_GREATEREQUAL = 6; -float SLIST_TEST_NOTEQUAL = 7; -float SLIST_TEST_STARTSWITH = 8; -float SLIST_TEST_NOTSTARTSWITH = 9; -float SLIST_MASK_AND = 0; -float SLIST_MASK_OR = 512; - -// font stuff -float FONT_DEFAULT = 0; -float FONT_CONSOLE = 1; -float FONT_SBAR = 2; -float FONT_NOTIFY = 3; -float FONT_CHAT = 4; -float FONT_CENTERPRINT = 5; -float FONT_INFOBAR = 6; -float FONT_MENU = 7; -float FONT_USER = 8; // add to this the index, like FONT_USER+3 = user3. At least 8 of them are supported. -float drawfont; - -/* not supported at the moment -/////////////////////////// -// os constants - -float OS_WINDOWS = 0; -float OS_LINUX = 1; -float OS_MAC = 2; -*/ - - - - - - - - - - -////////////////////////////////////////////////// -// common cmd -////////////////////////////////////////////////// -// AK FIXME: Create perhaps a special builtin file for the common cmds - -void checkextension(string ext) = #1; - -// error cmds -void error(string err,...) = #2; -void objerror(string err,...) = #3; - -// print - -void print(string text,...) = #4; -void bprint(string text,...) = #5; -void sprint(float clientnum, string text,...) = #6; -void centerprint(string text,...) = #7; - -// vector stuff - -vector normalize(vector v) = #8; -float vlen(vector v) = #9; -float vectoyaw(vector v) = #10; -vector vectoangles(vector v) = #11; - -float random(void) = #12; - -void cmd(string command, ...) = #13; - -// cvar cmds - -float cvar(string name) = #14; -const string str_cvar(string name) = #71; -void cvar_set(string name, string value) = #15; - -void dprint(string text,...) = #16; - -// conversion functions - -string ftos(float f) = #17; -float fabs(float f) = #18; -string vtos(vector v) = #19; -string etos(entity e) = #20; - -float stof(string val,...) = #21; - -entity spawn(void) = #22; -void remove(entity e) = #23; - -entity find(entity start, .string field, string match) = #24; -entity findfloat(entity start, .float field, float match) = #25; -entity findentity(entity start, .entity field, entity match) = #25; - -entity findchainstring(.string field, string match) = #26; -entity findchainfloat(.float field, float match) = #27; -entity findchainentity(.entity field, entity match) = #27; - -string precache_file(string file) = #28; -string precache_sound(string sample) = #29; - -void crash(void) = #72; -void coredump(void) = #30; -void stackdump(void) = #73; -void traceon(void) = #31; -void traceoff(void) = #32; - -void eprint(entity e) = #33; -float rint(float f) = #34; -float floor(float f) = #35; -float ceil(float f) = #36; -entity nextent(entity e) = #37; -float sin(float f) = #38; -float cos(float f) = #39; -float sqrt(float f) = #40; -vector randomvec(void) = #41; - -float registercvar(string name, string value, float flags) = #42; // returns 1 if success - -float min(float f,...) = #43; -float max(float f,...) = #44; - -float bound(float min,float value, float max) = #45; -float pow(float a, float b) = #46; - -void copyentity(entity src, entity dst) = #47; - -float fopen(string filename, float mode) = #48; -void fclose(float fhandle) = #49; -string fgets(float fhandle) = #50; -void fputs(float fhandle, string s) = #51; - -float strlen(string s) = #52; -string strcat(string s1,string s2,...) = #53; -string substring(string s, float start, float length) = #54; - -vector stov(string s) = #55; - -string strzone(string s) = #56; -void strunzone(string s) = #57; - -float tokenize(string s) = #58; -string argv(float n) = #59; - -float isserver(void) = #60; -float clientcount(void) = #61; -float clientstate(void) = #62; -void clientcommand(float client, string s) = #63; -void changelevel(string map) = #64; -void localsound(string sample) = #65; -vector getmousepos(void) = #66; -float gettime(void) = #67; -void loadfromdata(string data) = #68; -void loadfromfile(string file) = #69; - -float mod(float val, float m) = #70; - -float search_begin(string pattern, float caseinsensitive, float quiet) = #74; -void search_end(float handle) = #75; -float search_getsize(float handle) = #76; -string search_getfilename(float handle, float num) = #77; - -string chr(float ascii) = #78; - -///////////////////////////////////////////////// -// Write* Functions -///////////////////////////////////////////////// -void WriteByte(float data, float dest, float desto) = #401; -void WriteChar(float data, float dest, float desto) = #402; -void WriteShort(float data, float dest, float desto) = #403; -void WriteLong(float data, float dest, float desto) = #404; -void WriteAngle(float data, float dest, float desto) = #405; -void WriteCoord(float data, float dest, float desto) = #406; -void WriteString(string data, float dest, float desto)= #407; -void WriteEntity(entity data, float dest, float desto) = #408; - -////////////////////////////////////////////////// -// Draw funtions -////////////////////////////////////////////////// - -float iscachedpic(string name) = #451; -string precache_pic(string name, ...) = #452; -void freepic(string name) = #453; - -float drawcharacter(vector position, float character, vector scale, vector rgb, float alpha, float flag) = #454; - -float drawstring(vector position, string text, vector scale, vector rgb, float alpha, float flag) = #455; - -float drawcolorcodedstring(vector position, string text, vector scale, float alpha, float flag) = #467; - -vector drawcolorcodedstring2(vector position, string text, vector scale, vector rgb, float alpha, float flag) = #467; - -float drawpic(vector position, string pic, vector size, vector rgb, float alpha, float flag) = #456; - -float drawfill(vector position, vector size, vector rgb, float alpha, float flag) = #457; - -void drawsetcliparea(float x, float y, float width, float height) = #458; - -void drawresetcliparea(void) = #459; - -vector drawgetimagesize(string pic) = #460; - -//////////////////////////////////////////////// -// Menu functions -//////////////////////////////////////////////// - -void setkeydest(float dest) = #601; -float getkeydest(void) = #602; - -void setmousetarget(float trg) = #603; -float getmousetarget(void) = #604; - -float isfunction(string function_name) = #607; -void callfunction(...) = #605; -void writetofile(float fhandle, entity ent) = #606; -vector getresolution(float number) = #608; -string keynumtostring(float keynum) = #609; - -float gethostcachevalue(float type) = #611; -string gethostcachestring(float type, float hostnr) = #612; - -//DP_CSQC_BINDMAPS -//idea: daemon, motorsep -//darkplaces implementation: divVerent -//builtin definitions: -string(float key, float bindmap) getkeybind_bindmap = #342; -float(float key, string bind, float bindmap) setkeybind_bindmap = #630; -vector(void) getbindmaps = #631; -float(vector bm) setbindmaps = #632; -string(string command, float bindmap) findkeysforcommand = #610; -float(string key) stringtokeynum = #341; -// string(float keynum) keynumtostring = #340; -//description: key bind setting/getting including support for switchable -//bindmaps. - -//DP_CRYPTO -//idea: divVerent -//darkplaces implementation: divVerent -//field definitions: (MENUQC) -string(string serveraddress) crypto_getkeyfp = #633; // retrieves the cached host key's CA fingerprint of a server given by IP address -string(string serveraddress) crypto_getidfp = #634; // retrieves the cached host key fingerprint of a server given by IP address -float(string serveraddress) crypto_getidstatus = #643; // retrieves the cached host key's key status. See below for CRYPTO_IDSTATUS_ defines. -string(string serveraddress) crypto_getencryptlevel = #635; // 0 if never encrypting, 1 supported, 2 requested, 3 required, appended by list of allowed methods in order of preference ("AES128"), preceded by a space each -string(float i) crypto_getmykeyfp = #636; // retrieves the CA key fingerprint of a given CA slot, or "" if slot is unused but more to come, or string_null if end of list -string(float i) crypto_getmyidfp = #637; // retrieves the ID fingerprint of a given CA slot, or "" if slot is unused but more to come, or string_null if end of list -float CRYPTO_IDSTATUS_OUTOFRANGE = -1; -float CRYPTO_IDSTATUS_EMPTY = 0; -float CRYPTO_IDSTATUS_UNSIGNED = 1; -float CRYPTO_IDSTATUS_SIGNED = 2; -float(float i) crypto_getmyidstatus = #641; // retrieves the ID's status of a given CA slot, or 0 if slot is unused but more to come, or -1 if end of list -float(string url, float id, string content_type, string delim, float buf, float keyid) crypto_uri_postbuf = #513; -//description: -//use -1 as buffer handle to justs end delim as postdata - -//DP_GECKO_SUPPORT -//idea: Res2k, BlackHC -//darkplaces implementation: Res2k, BlackHC -//constant definitions: -float GECKO_BUTTON_DOWN = 0; -float GECKO_BUTTON_UP = 1; -// either use down and up or just press but not all of them! -float GECKO_BUTTON_PRESS = 2; -// use this for mouse events if needed? -float GECKO_BUTTON_DOUBLECLICK = 3; -//builtin definitions: -float gecko_create( string name ) = #487; -void gecko_destroy( string name ) = #488; -void gecko_navigate( string name, string URI ) = #489; -float gecko_keyevent( string name, float key, float eventtype ) = #490; -void gecko_mousemove( string name, float x, float y ) = #491; -void gecko_resize( string name, float w, float h ) = #492; -vector gecko_get_texture_extent( string name ) = #493; -//engine-called QC prototypes: -//string(string name, string query) Qecko_Query; -//description: -//provides an interface to the offscreengecko library and allows for internet browsing in games - -//FTE_STRINGS -//idea: many -//darkplaces implementation: KrimZon -//description: -//various string manipulation functions -int(string str, string sub, float startpos) strstrofs = #221; -int(string str, float ofs) str2chr = #222; -string(int c, ...) chr2str = #223; -string(float ccase, float calpha, float cnum, string s, ...) strconv = #224; -string(float chars, string s, ...) strpad = #225; -string(string info, string key, string value, ...) infoadd = #226; -string(string info, string key) infoget = #227; -int(string s1, string s2) strcmp = #228; -int(string s1, string s2, float len) strncmp = #228; -int(string s1, string s2) strcasecmp = #229; -int(string s1, string s2, float len) strncasecmp = #230; - -//DP_PRECACHE_PIC_FLAGS -//idea: divVerent -//darkplaces implementation: divVerent -//constant definitions: -float PRECACHE_PIC_FROMWAD = 1; // this one actually is part of EXT_CSQC -float PRECACHE_PIC_NOTPERSISTENT = 2; // picture may get deallocated when unused -float PRECACHE_PIC_MIPMAP = 8; // mipmap the texture for possibly better downscaling at memory expense -//notes: these constants are given as optional second argument to precache_pic() - -//DP_QC_CRC16 -//idea: div0 -//darkplaces implementation: div0 -//Some hash function to build hash tables with. This has to be be the CRC-16-CCITT that is also required for the QuakeWorld download protocol. -//When caseinsensitive is set, the CRC is calculated of the lower cased string. -float(float caseinsensitive, string s, ...) crc16 = #494; - -//DP_QC_CVAR_TYPE -float(string name) cvar_type = #495; -float CVAR_TYPEFLAG_EXISTS = 1; -float CVAR_TYPEFLAG_SAVED = 2; -float CVAR_TYPEFLAG_PRIVATE = 4; -float CVAR_TYPEFLAG_ENGINE = 8; -float CVAR_TYPEFLAG_HASDESCRIPTION = 16; -float CVAR_TYPEFLAG_READONLY = 32; - -//DP_QC_STRINGBUFFERS -//idea: ?? -//darkplaces implementation: LordHavoc -//functions to manage string buffer objects - that is, arbitrary length string arrays that are handled by the engine -int() buf_create = #440; -void(float bufhandle) buf_del = #441; -float(float bufhandle) buf_getsize = #442; -void(float bufhandle_from, float bufhandle_to) buf_copy = #443; -void(float bufhandle, float sortpower, float backward) buf_sort = #444; -string(float bufhandle, string glue) buf_implode = #445; -string(float bufhandle, float string_index) bufstr_get = #446; -void(float bufhandle, float string_index, string str) bufstr_set = #447; -float(float bufhandle, string str, float order) bufstr_add = #448; -void(float bufhandle, float string_index) bufstr_free = #449; -void(float bufhandle, string pattern, string antipattern) buf_cvarlist = #517; - -//DP_QC_STRING_CASE_FUNCTIONS -//idea: Dresk -//darkplaces implementation: LordHavoc / Dresk -//builtin definitions: -string(string s) strtolower = #480; // returns the passed in string in pure lowercase form -string(string s) strtoupper = #481; // returns the passed in string in pure uppercase form -//description: -//provides simple string uppercase and lowercase functions - -//DP_QC_CVAR_DESCRIPTION -//idea: divVerent -//DarkPlaces implementation: divVerent -//builtin definitions: -string(string name) cvar_description = #518; -//description: -//returns the description of a cvar - -//DP_QC_DIGEST -//idea: motorsep, Spike -//DarkPlaces implementation: divVerent -//builtin definitions: -string(string digest, string data, ...) digest_hex = #639; -//description: -//returns a given hex digest of given data -//the returned digest is always encoded in hexadecimal -//only the "MD4" digest is always supported! -//if the given digest is not supported, string_null is returned -//the digest string is matched case sensitively, use "MD4", not "md4"! - -//DP_QC_URI_ESCAPE -//idea: div0 -//darkplaces implementation: div0 -//URI::Escape's functionality -string(string in) uri_escape = #510; -string(string in) uri_unescape = #511; - -//DP_QC_URI_GET -//idea: divVerent -//darkplaces implementation: divVerent -//loads text from an URL into a string -//returns 1 on success of initiation, 0 if there are too many concurrent -//connections already or if the URL is invalid -//the following callback will receive the data and MUST exist! -// void(float id, float status, string data) URI_Get_Callback; -//status is either -// negative for an internal error, -// 0 for success, or -// the HTTP response code on server error (e.g. 404) -//if 1 is returned by uri_get, the callback will be called in the future -float(string url, float id) uri_get = #513; -//DP_QC_URI_POST -//idea: divVerent -//darkplaces implementation: divVerent -//loads text from an URL into a string after POSTing via HTTP -//works like uri_get, but uri_post sends data with Content-Type: content_type to the server -//and uri_post sends the string buffer buf, joined using the delimiter delim -float(string url, float id, string content_type, string data) uri_post = #513; -float(string url, float id, string content_type, string delim, float buf) uri_postbuf = #513; - -//DP_QC_ENTITYDATA -//idea: KrimZon -//darkplaces implementation: KrimZon -//builtin definitions: -float() numentityfields = #496; -string(float fieldnum) entityfieldname = #497; -float(float fieldnum) entityfieldtype = #498; -string(float fieldnum, entity ent) getentityfieldstring = #499; -float(float fieldnum, entity ent, string s) putentityfieldstring = #500; -//constants: -//Returned by entityfieldtype -float FIELD_STRING = 1; -float FIELD_FLOAT = 2; -float FIELD_VECTOR = 3; -float FIELD_ENTITY = 4; -float FIELD_FUNCTION = 6; -//description: -//Versatile functions intended for storing data from specific entities between level changes, but can be customized for some kind of partial savegame. -//WARNING: .entity fields cannot be saved and restored between map loads as they will leave dangling pointers. -//numentityfields returns the number of entity fields. NOT offsets. Vectors comprise 4 fields: v, v_x, v_y and v_z. -//entityfieldname returns the name as a string, eg. "origin" or "classname" or whatever. -//entityfieldtype returns a value that the constants represent, but the field may be of another type in more exotic progs.dat formats or compilers. -//getentityfieldstring returns data as would be written to a savegame, eg... "0.05" (float), "0 0 1" (vector), or "Hello World!" (string). Function names can also be returned. -//putentityfieldstring puts the data returned by getentityfieldstring back into the entity. - -//DP_COVERAGE -//idea: divVerent -//darkplaces implementation: divVerent -//function definitions: -void coverage() = #642; // Reports a coverage event. The engine counts for each of the calls to this builtin whether it has been called. - -// assorted undocumented extensions -string(string, float) netaddress_resolve = #625; -string(string search, string replace, string subject) strreplace = #484; -string(float uselocaltime, string format, ...) strftime = #478; -float(string s) tokenize_console = #514; -float(float i) argv_start_index = #515; -float(float i) argv_end_index = #516; -string(float, float) getgamedirinfo = #626; -const float GETGAMEDIRINFO_NAME = 0; -const float GETGAMEDIRINFO_DESCRIPTION = 1; -float log(float f) = #532; -string(string format, ...) sprintf = #627; -string(string s) strdecolorize = #477; -entity findflags(entity start, .float field, float match) = #87; -entity findchainflags(.float field, float match) = #88; -float(string s, string separator1, ...) tokenizebyseparator = #479; -float etof(entity ent) = #79; -entity ftoe(float num) = #80; -float validstring(string str) = #81; -float altstr_count(string str) = #82; -string altstr_prepare(string str) = #83; -string altstr_get(string str, float num) = #84; -string altstr_set(string str, float num, string set) = #85; -string altstr_ins(string str, float num, string set) = #86; -float isdemo() = #349; -float drawsubpic(vector position, vector size, string pic, vector srcPosition, vector srcSize, vector rgb, float alpha, float flag) = #469; -//vector getresolution(float number, ...) = #608; // optional argument "isfullscreen" -void parseentitydata(entity ent, string data) = #613; -void resethostcachemasks(void) = #615; -void sethostcachemaskstring(float mask, float fld, string str, float op) = #616; -void sethostcachemasknumber(float mask, float fld, float num, float op) = #617; -void resorthostcache(void) = #618; -float SLSF_DESCENDING = 1; -float SLSF_FAVORITES = 2; -float SLSF_CATEGORIES = 4; -void sethostcachesort(float fld, float slsf) = #619; -void refreshhostcache(...) = #620; // optional boolean argument "clear_list" -float gethostcachenumber(float fld, float hostnr) = #621; -float gethostcacheindexforkey(string key) = #622; -void addwantedhostcachekey(string key) = #623; -string getextresponse(void) = #624; -const string cvar_string(string name) = #71; -const string cvar_defstring(string name) = #89; -float stringwidth(string text, float handleColors, vector size) = #468; +#define true _true +#define false _false +#define TRUE _TRUE +#define FALSE _FALSE + +#include "upstream/menudefs.qc" + +#undef true +#undef false +#undef TRUE +#undef FALSE + +int(string str, string sub, int startpos) _strstrofs = #221; +#define strstrofs _strstrofs +int(string str, int ofs) _str2chr = #222; +#define str2chr _str2chr +string(int c, ...) _chr2str = #223; +#define chr2str _chr2str + +int(string s1, string s2) _strcmp = #228; +#define strcmp _strcmp +int(string s1, string s2, int len) _strncmp = #228; +#define strncmp _strncmp +int(string s1, string s2) _strcasecmp = #229; +#define strcasecmp _strcasecmp +int(string s1, string s2, int len) _strncasecmp = #230; +#define strncasecmp _strncasecmp + +int() _buf_create = #440; +#define buf_create _buf_create #pragma noref 0 diff --git a/qcsrc/dpdefs/progsdefs.qh b/qcsrc/dpdefs/progsdefs.qh index fe632ce8d..bffacafdd 100644 --- a/qcsrc/dpdefs/progsdefs.qh +++ b/qcsrc/dpdefs/progsdefs.qh @@ -1,511 +1,20 @@ #ifndef PROGSDEFS_H #define PROGSDEFS_H -/* -============================================================================== +#pragma noref 1 - SOURCE FOR GLOBALVARS_T C STRUCTURE - MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR +#define true _true +#define false _false +#define TRUE _TRUE +#define FALSE _FALSE -============================================================================== -*/ +#include "upstream/progsdefs.qc" -// -// system globals -// -entity self; -entity other; -entity world; -float time; -float frametime; +#undef true +#undef false +#undef TRUE +#undef FALSE -float force_retouch; // force all entities to touch triggers - // next frame. this is needed because - // non-moving things don't normally scan - // for triggers, and when a trigger is - // created (like a teleport trigger), it - // needs to catch everything. - // decremented each frame, so set to 2 - // to guarantee everything is touched -string mapname; +#pragma noref 0 -float deathmatch; -float coop; -float teamplay; - -int serverflags; // propagated from level to level, used to - // keep track of completed episodes - -float total_secrets; -float total_monsters; - -float found_secrets; // number of secrets found -float killed_monsters; // number of monsters killed - - -// spawnparms are used to encode information about clients across server -// level changes -float parm1, parm2, parm3, parm4, parm5, parm6, parm7, parm8, parm9, parm10, parm11, parm12, parm13, parm14, parm15, parm16; - -// -// global variables set by built in functions -// -vector v_forward, v_up, v_right; // set by makevectors() - -// set by traceline / tracebox -float trace_allsolid; -float trace_startsolid; -float trace_fraction; -vector trace_endpos; -vector trace_plane_normal; -float trace_plane_dist; -entity trace_ent; -float trace_inopen; -float trace_inwater; - -entity msg_entity; // destination of single entity writes - -// -// required prog functions -// -void() main; // only for testing - -void() StartFrame; - -void() PlayerPreThink; -void() PlayerPostThink; - -void() ClientKill; -#ifdef DP_EXT_PRECONNECT -void() ClientPreConnect; -#endif -void() ClientConnect; -void() PutClientInServer; // call after setting the parm1... parms -void() ClientDisconnect; - -void() SetNewParms; // called when a client first connects to - // a server. sets parms so they can be - // saved off for restarts - -void() SetChangeParms; // call to set parms for self so they can - // be saved for a level transition - - -//================================================ -void end_sys_globals; // flag for structure dumping -//================================================ - -/* -============================================================================== - - SOURCE FOR ENTVARS_T C STRUCTURE - MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR - -============================================================================== -*/ - -// -// system fields (*** = do not set in prog code, maintained by C code) -// -.int modelindex; // *** model index in the precached list -.vector absmin, absmax; // *** origin + mins / maxs - -.float ltime; // local time for entity -.float movetype; -.float solid; - -.vector origin; // *** -.vector oldorigin; // *** -.vector velocity; -.vector angles; -.vector avelocity; - -.vector punchangle; // temp angle adjust from damage or recoil - -.string classname; // spawn function -.string model; -.int frame; -.int skin; -.int effects; - -.vector mins, maxs; // bounding box extents reletive to origin -.vector size; // maxs - mins - -.void() touch; -.void() use; -.void() think; -.void() blocked; // for doors or plats, called when can't push other - -.float nextthink; -.entity groundentity; - -// stats -.float health; -.float frags; -.int weapon; // one of the IT_SHOTGUN, etc flags -.string weaponmodel; -.float weaponframe; -.float currentammo; -.float ammo_shells, ammo_nails, ammo_rockets, ammo_cells; - -.int items; // bit flags - -.float takedamage; -.entity chain; -.float deadflag; - -.vector view_ofs; // add to origin to get eye point - - -.float button0; // fire -.float button1; // use -.float button2; // jump - -.float impulse; // weapon changes - -.float fixangle; -.vector v_angle; // view / targeting angle for players -.float idealpitch; // calculated pitch angle for lookup up slopes - - -.string netname; - -.entity enemy; - -.int flags; - -.int colormap; -.float team; - -.float max_health; // players maximum health is stored here - -.float teleport_time; // don't back up - -.float armortype; // save this fraction of incoming damage -.float armorvalue; - -.float waterlevel; // 0 = not in, 1 = feet, 2 = wast, 3 = eyes -.float watertype; // a contents value - -.float ideal_yaw; -.float yaw_speed; - -.entity aiment; - -.entity goalentity; // a movetarget or an enemy - -.int spawnflags; - -.string target; -.string targetname; - -// damage is accumulated through a frame. and sent as one single -// message, so the super shotgun doesn't generate huge messages -.float dmg_take; -.float dmg_save; -.entity dmg_inflictor; - -.entity owner; // who launched a missile -.vector movedir; // mostly for doors, but also used for waterjump - -.string message; // trigger messages - -.float sounds; // either a cd track number or sound number - -.string noise, noise1, noise2, noise3; // contains names of wavs to play - -//================================================ -void end_sys_fields; // flag for structure dumping -//================================================ - -/* -============================================================================== - - CONSTANT DEFINITIONS - -============================================================================== -*/ - - -// -// constants -// - -// edict.flags -const int FL_FLY = 1; -const int FL_SWIM = 2; -const int FL_CLIENT = 8; // set for all client edicts -const int FL_INWATER = 16; // for enter / leave water splash -const int FL_MONSTER = 32; -const int FL_GODMODE = 64; // player cheat -const int FL_NOTARGET = 128; // player cheat -const int FL_ITEM = 256; // extra wide size for bonus items -const int FL_ONGROUND = 512; // standing on something -const int FL_PARTIALGROUND = 1024; // not all corners are valid -const int FL_WATERJUMP = 2048; // player jumping out of water -const int FL_JUMPRELEASED = 4096; // for jump debouncing - -// edict.movetype values -const int MOVETYPE_NONE = 0; // never moves -//const int MOVETYPE_ANGLENOCLIP= 1; -//const int MOVETYPE_ANGLECLIP = 2; -const int MOVETYPE_WALK = 3; // players only -const int MOVETYPE_STEP = 4; // discrete, not real time unless fall -const int MOVETYPE_FLY = 5; -const int MOVETYPE_TOSS = 6; // gravity -const int MOVETYPE_PUSH = 7; // no clip to world, push and crush -const int MOVETYPE_NOCLIP = 8; -const int MOVETYPE_FLYMISSILE = 9; // fly with extra size against monsters -const int MOVETYPE_BOUNCE = 10; -const int MOVETYPE_BOUNCEMISSILE= 11; // bounce with extra size - -// edict.solid values -const int SOLID_NOT = 0; // no interaction with other objects -const int SOLID_TRIGGER = 1; // touch on edge, but not blocking -const int SOLID_BBOX = 2; // touch on edge, block -const int SOLID_SLIDEBOX = 3; // touch on edge, but not an onground -const int SOLID_BSP = 4; // bsp clip, touch on edge, block - -// range values -const int RANGE_MELEE = 0; -const int RANGE_NEAR = 1; -const int RANGE_MID = 2; -const int RANGE_FAR = 3; - -// deadflag values - -const int DEAD_NO = 0; -const int DEAD_DYING = 1; -const int DEAD_DEAD = 2; -const int DEAD_RESPAWNABLE = 3; -const int DEAD_RESPAWNING = 4; // dead, waiting for buttons to be released - -// takedamage values - -const int DAMAGE_NO = 0; -const int DAMAGE_YES = 1; -const int DAMAGE_AIM = 2; - -// items -const int IT_AXE = 4096; -const int IT_SHOTGUN = 1; -const int IT_SUPER_SHOTGUN = 2; -const int IT_NAILGUN = 4; -const int IT_SUPER_NAILGUN = 8; -const int IT_GRENADE_LAUNCHER = 16; -const int IT_ROCKET_LAUNCHER = 32; -const int IT_LIGHTNING = 64; -const int IT_EXTRA_WEAPON = 128; - -//const int IT_SHELLS = 256; -//const int IT_NAILS = 512; -//const int IT_ROCKETS = 1024; -//const int IT_CELLS = 2048; - -const int IT_ARMOR1 = 8192; -const int IT_ARMOR2 = 16384; -const int IT_ARMOR3 = 32768; -const int IT_SUPERHEALTH = 65536; - -//const int IT_KEY1 = 131072; -//const int IT_KEY2 = 262144; - -const int IT_INVISIBILITY = 524288; -const int IT_INVULNERABILITY = 1048576; -const int IT_SUIT = 2097152; -const int IT_QUAD = 4194304; - -// point content values - -const int CONTENT_EMPTY = -1; -const int CONTENT_SOLID = -2; -const int CONTENT_WATER = -3; -const int CONTENT_SLIME = -4; -const int CONTENT_LAVA = -5; -const int CONTENT_SKY = -6; - -const int STATE_TOP = 0; -const int STATE_BOTTOM = 1; -const int STATE_UP = 2; -const int STATE_DOWN = 3; - -const vector VEC_ORIGIN = '0 0 0'; -const vector VEC_HULL_MIN = '-16 -16 -24'; -const vector VEC_HULL_MAX = '16 16 32'; - -const vector VEC_HULL2_MIN = '-32 -32 -24'; -const vector VEC_HULL2_MAX = '32 32 64'; - -// protocol bytes -const int SVC_TEMPENTITY = 23; -const int SVC_KILLEDMONSTER = 27; -const int SVC_FOUNDSECRET = 28; -const int SVC_INTERMISSION = 30; -const int SVC_FINALE = 31; -const int SVC_CDTRACK = 32; -const int SVC_SELLSCREEN = 33; - - -const int TE_SPIKE = 0; -const int TE_SUPERSPIKE = 1; -const int TE_GUNSHOT = 2; -const int TE_EXPLOSION = 3; -const int TE_TAREXPLOSION = 4; -const int TE_LIGHTNING1 = 5; -const int TE_LIGHTNING2 = 6; -const int TE_WIZSPIKE = 7; -const int TE_KNIGHTSPIKE = 8; -const int TE_LIGHTNING3 = 9; -const int TE_LAVASPLASH = 10; -const int TE_TELEPORT = 11; - -// sound channels -// channel 0 never willingly overrides -// other channels (1-7) allways override a playing sound on that channel -const int CHAN_AUTO = 0; -const int CHAN_WEAPON = 1; -const int CHAN_VOICE = 2; -const int CHAN_ITEM = 3; -const int CHAN_BODY = 4; - -const int ATTN_NONE = 0; -const int ATTN_NORM = 1; -const int ATTN_IDLE = 2; -const int ATTN_STATIC = 3; - -// update types - -const int UPDATE_GENERAL = 0; -const int UPDATE_STATIC = 1; -const int UPDATE_BINARY = 2; -const int UPDATE_TEMP = 3; - -// entity effects - -const int EF_BRIGHTFIELD = 1; -const int EF_MUZZLEFLASH = 2; -const int EF_BRIGHTLIGHT = 4; -const int EF_DIMLIGHT = 8; - - -// messages -const int MSG_BROADCAST = 0; // unreliable to all -const int MSG_ONE = 1; // reliable to one (msg_entity) -const int MSG_ALL = 2; // reliable to all -const int MSG_INIT = 3; // write to the init string - -//=========================================================================== - -// -// builtin functions -// - -void(vector ang) makevectors = #1; // sets v_forward, etc globals -void(entity e, vector o) setorigin = #2; -void(entity e, string m) setmodel = #3; // set movetype and solid first -void(entity e, vector min, vector max) setsize = #4; -// #5 was removed -void() break_to_debugger = #6; -float() random = #7; // returns 0 - 1 -void(entity e, float chan, string samp, float vol, float atten) sound = #8; -vector(vector v) normalize = #9; -void(string e, ...) error = #10; -void(string e, ...) objerror = #11; -float(vector v) vlen = #12; -float(vector v) vectoyaw = #13; -entity() spawn = #14; -void(entity e) remove = #15; - -// sets trace_* globals -// nomonsters can be: -// An entity will also be ignored for testing if forent == test, -// forent->owner == test, or test->owner == forent -// a forent of world is ignored -void(vector v1, vector v2, float nomonsters, entity forent) traceline = #16; - -entity() checkclient = #17; // returns a client to look for -entity(entity start, .string fld, string match) find = #18; -string(string s) precache_sound = #19; -string(string s) precache_model = #20; -void(entity client, string s, ...)stuffcmd = #21; -entity(vector org, float rad) findradius = #22; -void(string s, ...) bprint = #23; -void(entity client, string s, ...) sprint = #24; -void(string s, ...) dprint = #25; -string(float f) ftos = #26; -string(vector v) vtos = #27; -void() coredump = #28; // prints all edicts -void() traceon = #29; // turns statment trace on -void() traceoff = #30; -void(entity e) eprint = #31; // prints an entire edict -float(float yaw, float dist) walkmove = #32; // returns true or false -// #33 was removed -float() droptofloor= #34; // true if landed on floor -void(float style, string value) lightstyle = #35; -float(float v) rint = #36; // round to nearest int -float(float v) floor = #37; // largest integer <= v -float(float v) ceil = #38; // smallest integer >= v -// #39 was removed -float(entity e) checkbottom = #40; // true if self is on ground -float(vector v) pointcontents = #41; // returns a CONTENT_* -// #42 was removed -float(float f) fabs = #43; -vector(entity e, float speed) aim = #44; // returns the shooting vector -float(string s) cvar = #45; // return cvar.value -void(string s, ...) localcmd = #46; // put string into local que -entity(entity e) nextent = #47; // for looping through all ents -void(vector o, vector d, float color, float count) particle = #48;// start a particle effect -void() ChangeYaw = #49; // turn towards self.ideal_yaw - // at self.yaw_speed -// #50 was removed -vector(vector v) vectoangles = #51; - -// -// direct client message generation -// -void(float to, float f) WriteByte = #52; -void(float to, float f) WriteChar = #53; -void(float to, float f) WriteShort = #54; -void(float to, float f) WriteLong = #55; -void(float to, float f) WriteCoord = #56; -void(float to, float f) WriteAngle = #57; -void(float to, string s, ...) WriteString = #58; -void(float to, entity s) WriteEntity = #59; - -// -// broadcast client message generation -// - -// void(float f) bWriteByte = #59; -// void(float f) bWriteChar = #60; -// void(float f) bWriteShort = #61; -// void(float f) bWriteLong = #62; -// void(float f) bWriteCoord = #63; -// void(float f) bWriteAngle = #64; -// void(string s) bWriteString = #65; -// void(entity e) bWriteEntity = #66; - -void(float step) movetogoal = #67; - -string(string s) precache_file = #68; // no effect except for -copy -void(entity e) makestatic = #69; -void(string s) changelevel = #70; - -//#71 was removed - -void(string name, string value) cvar_set = #72; // sets cvar.value - -void(entity client, string s, ...) centerprint = #73; // sprint, but in middle - -void(vector pos, string samp, float vol, float atten) ambientsound = #74; - -string(string s) precache_model2 = #75; // registered version only -string(string s) precache_sound2 = #76; // registered version only -string(string s) precache_file2 = #77; // registered version only - -void(entity e) setspawnparms = #78; // set parm1... to the - // values at level start - // for coop respawn - -//============================================================================ #endif diff --git a/qcsrc/dpdefs/upstream/csprogsdefs.qc b/qcsrc/dpdefs/upstream/csprogsdefs.qc new file mode 100644 index 000000000..202b840e0 --- /dev/null +++ b/qcsrc/dpdefs/upstream/csprogsdefs.qc @@ -0,0 +1,1466 @@ +/* +============================================================================== + + SOURCE FOR GLOBALVARS_T C STRUCTURE + MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR + +============================================================================== +*/ + +// +// system globals +// +entity self; +entity other; +entity world; +float time; +float frametime; + +float player_localentnum; //the entnum +float player_localnum; //the playernum +float maxclients; //a constant filled in by the engine. gah, portability eh? + +float clientcommandframe; //player movement +float servercommandframe; //clientframe echoed off the server + +string mapname; + +// +// global variables set by built in functions +// +vector v_forward, v_up, v_right; // set by makevectors() + +// set by traceline / tracebox +float trace_allsolid; +float trace_startsolid; +float trace_fraction; +vector trace_endpos; +vector trace_plane_normal; +float trace_plane_dist; +entity trace_ent; +float trace_inopen; +float trace_inwater; + +// +// required prog functions +// +void() CSQC_Init; +void() CSQC_Shutdown; +float(float f, float t, float n) CSQC_InputEvent; +void(float w, float h) CSQC_UpdateView; +float(string s) CSQC_ConsoleCommand; + +//these fields are read and set by the default player physics +vector pmove_org; +vector pmove_vel; +vector pmove_mins; +vector pmove_maxs; +//retrieved from the current movement commands (read by player physics) +float input_timelength; +vector input_angles; +vector input_movevalues; //forwards, right, up. +float input_buttons; //attack, use, jump (default physics only uses jump) + +float movevar_gravity; +float movevar_stopspeed; +float movevar_maxspeed; +float movevar_spectatormaxspeed; //used by NOCLIP movetypes. +float movevar_accelerate; +float movevar_airaccelerate; +float movevar_wateraccelerate; +float movevar_friction; +float movevar_waterfriction; +float movevar_entgravity; //the local player's gravity field. Is a multiple (1 is the normal value) + +//================================================ +void end_sys_globals; // flag for structure dumping +//================================================ + +/* +============================================================================== + + SOURCE FOR ENTVARS_T C STRUCTURE + MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR + +============================================================================== +*/ + +// +// system fields (*** = do not set in prog code, maintained by C code) +// +.float modelindex; // *** model index in the precached list +.vector absmin, absmax; // *** origin + mins / maxs + +.float entnum; // *** the ent number as on the server +.float drawmask; +.void() predraw; + +.float movetype; +.float solid; + +.vector origin; // *** +.vector oldorigin; // *** +.vector velocity; +.vector angles; +.vector avelocity; + +.string classname; // spawn function +.string model; +.float frame; +.float skin; +.float effects; + +.vector mins, maxs; // bounding box extents reletive to origin +.vector size; // maxs - mins + +.void() touch; +.void() use; +.void() think; +.void() blocked; // for doors or plats, called when can't push other + +.float nextthink; + +.entity chain; + +.string netname; + +.entity enemy; + +.float flags; + +.float colormap; + +.entity owner; // who launched a missile + +//================================================ +void end_sys_fields; // flag for structure dumping +//================================================ + +/* +============================================================================== + + OPTIONAL FIELDS AND GLOBALS + +============================================================================== +*/ + +// Additional OPTIONAL Fields and Globals +float intermission; // indicates intermission state (0 = normal, 1 = scores, 2 = finale text) + +vector view_angles; // same as input_angles +vector view_punchangle; // from server +vector view_punchvector; // from server + +/* +============================================================================== + + CONSTANT DEFINITIONS + +============================================================================== +*/ + +const float MASK_ENGINE = 1; +const float MASK_ENGINEVIEWMODELS = 2; +const float MASK_NORMAL = 4; + +const float RF_VIEWMODEL = 1; +const float RF_EXTERNALMODEL = 2; +const float RF_DEPTHHACK = 4; +const float RF_ADDITIVE = 8; +const float RF_USEAXIS = 16; + +const float VF_MIN = 1; //(vector) +const float VF_MIN_X = 2; //(float) +const float VF_MIN_Y = 3; //(float) +const float VF_SIZE = 4; //(vector) (viewport size) +const float VF_SIZE_Y = 5; //(float) +const float VF_SIZE_X = 6; //(float) +const float VF_VIEWPORT = 7; //(vector, vector) +const float VF_FOV = 8; //(vector) +const float VF_FOVX = 9; //(float) +const float VF_FOVY = 10; //(float) +const float VF_ORIGIN = 11; //(vector) +const float VF_ORIGIN_X = 12; //(float) +const float VF_ORIGIN_Y = 13; //(float) +const float VF_ORIGIN_Z = 14; //(float) +const float VF_ANGLES = 15; //(vector) +const float VF_ANGLES_X = 16; //(float) +const float VF_ANGLES_Y = 17; //(float) +const float VF_ANGLES_Z = 18; //(float) +const float VF_DRAWWORLD = 19; //(float) +const float VF_DRAWENGINESBAR = 20; //(float) +const float VF_DRAWCROSSHAIR = 21; //(float) + +const float VF_CL_VIEWANGLES = 33; //(vector) +const float VF_CL_VIEWANGLES_X = 34; //(float) +const float VF_CL_VIEWANGLES_Y = 35; //(float) +const float VF_CL_VIEWANGLES_Z = 36; //(float) + +const float VF_PERSPECTIVE = 200; + +const float STAT_HEALTH = 0; +const float STAT_WEAPONMODEL = 2; +const float STAT_AMMO = 3; +const float STAT_ARMOR = 4; +const float STAT_WEAPONFRAME = 5; +const float STAT_SHELLS = 6; +const float STAT_NAILS = 7; +const float STAT_ROCKETS = 8; +const float STAT_CELLS = 9; +const float STAT_ACTIVEWEAPON = 10; +const float STAT_TOTALSECRETS = 11; +const float STAT_TOTALMONSTERS = 12; +const float STAT_SECRETS = 13; +const float STAT_MONSTERS = 14; +const float STAT_ITEMS = 15; +const float STAT_VIEWHEIGHT = 16; + +// Quake Sound Constants +const float CHAN_AUTO = 0; +const float CHAN_WEAPON = 1; +const float CHAN_VOICE = 2; +const float CHAN_ITEM = 3; +const float CHAN_BODY = 4; + +const float ATTN_NONE = 0; +const float ATTN_NORM = 1; +const float ATTN_IDLE = 2; +const float ATTN_STATIC = 3; + +// Frik File Constants +const float FILE_READ = 0; +const float FILE_APPEND = 1; +const float FILE_WRITE = 2; + +// Quake Point Contents +const float CONTENT_EMPTY = -1; +const float CONTENT_SOLID = -2; +const float CONTENT_WATER = -3; +const float CONTENT_SLIME = -4; +const float CONTENT_LAVA = -5; +const float CONTENT_SKY = -6; + +// Quake Solid Constants +const float SOLID_NOT = 0; +const float SOLID_TRIGGER = 1; +const float SOLID_BBOX = 2; +const float SOLID_SLIDEBOX = 3; +const float SOLID_BSP = 4; +const float SOLID_CORPSE = 5; + +// Quake Move Constants +const float MOVE_NORMAL = 0; +const float MOVE_NOMONSTERS = 1; +const float MOVE_MISSILE = 2; + +// Boolean Constants +const float true = 1; +const float false = 0; +const float TRUE = 1; +const float FALSE = 0; + +const float EXTRA_LOW = -99999999; +const float EXTRA_HIGH = 99999999; + +const vector VEC_1 = '1 1 1'; +const vector VEC_0 = '0 0 0'; +const vector VEC_M1 = '-1 -1 -1'; + +const float M_PI = 3.14159265358979323846; + +vector VEC_HULL_MIN = '-16 -16 -24'; +vector VEC_HULL_MAX = '16 16 32'; + +// Quake Temporary Entity Constants +const float TE_SPIKE = 0; +const float TE_SUPERSPIKE = 1; +const float TE_GUNSHOT = 2; +const float TE_EXPLOSION = 3; +const float TE_TAREXPLOSION = 4; +const float TE_LIGHTNING1 = 5; +const float TE_LIGHTNING2 = 6; +const float TE_WIZSPIKE = 7; +const float TE_KNIGHTSPIKE = 8; +const float TE_LIGHTNING3 = 9; +const float TE_LAVASPLASH = 10; +const float TE_TELEPORT = 11; +const float TE_EXPLOSION2 = 12; + // Darkplaces Additions + const float TE_EXPLOSIONRGB = 53; + const float TE_GUNSHOTQUAD = 57; + const float TE_EXPLOSIONQUAD = 70; + const float TE_SPIKEQUAD = 58; + const float TE_SUPERSPIKEQUAD = 59; + +// PFlags for Dynamic Lights +const float PFLAGS_NOSHADOW = 1; +const float PFLAGS_CORONA = 2; +const float PFLAGS_FULLDYNAMIC = 128; + +const float EF_ADDITIVE = 32; +const float EF_BLUE = 64; +const float EF_FLAME = 1024; +const float EF_FULLBRIGHT = 512; +const float EF_NODEPTHTEST = 8192; +const float EF_NODRAW = 16; +const float EF_NOSHADOW = 4096; +const float EF_RED = 128; +const float EF_STARDUST = 2048; +const float EF_SELECTABLE = 16384; + +const float PFL_ONGROUND = 1; +const float PFL_CROUCH = 2; +const float PFL_DEAD = 4; +const float PFL_GIBBED = 8; + +// draw flags +const float DRAWFLAG_NORMAL = 0; +const float DRAWFLAG_ADDITIVE = 1; +const float DRAWFLAG_MODULATE = 2; +const float DRAWFLAG_2XMODULATE = 3; +const float DRAWFLAG_SCREEN = 4; +const float DRAWFLAG_MIPMAP = 0x100; // only for R_BeginPolygon + +/* +============================================================================== + + BUILTIN DEFINITIONS + EXTENSIONS ARE NOT ADDED HERE, BUT BELOW! + +============================================================================== +*/ + +void(vector ang) makevectors = #1; +void(entity e, vector o) setorigin = #2; +void(entity e, string m) setmodel = #3; +void(entity e, vector min, vector max) setsize = #4; + +void() break_to_debugger = #6; +float() random = #7; +void(entity e, float chan, string samp) sound = #8; +vector(vector v) normalize = #9; +void(string e) error = #10; +void(string e) objerror = #11; +float(vector v) vlen = #12; +float(vector v) vectoyaw = #13; +entity() spawn = #14; +void(entity e) remove = #15; +float(vector v1, vector v2, float tryents, entity ignoreentity) traceline = #16; + +entity(entity start, .string fld, string match) find = #18; +void(string s) precache_sound = #19; +void(string s) precache_model = #20; + +entity(vector org, float rad) findradius = #22; + +void(string s, ...) dprint = #25; +string(float f) ftos = #26; +string(vector v) vtos = #27; +void() coredump = #28; +void() traceon = #29; +void() traceoff = #30; +void(entity e) eprint = #31; +// settrace optional +float(float yaw, float dist, float settrace) walkmove = #32; + +float() droptofloor = #34; +void(float style, string value) lightstyle = #35; +float(float v) rint = #36; +float(float v) floor = #37; +float(float v) ceil = #38; + +float(entity e) checkbottom = #40; +float(vector v) pointcontents = #41; + +float(float f) fabs = #43; + +float(string s) cvar = #45; +void(string s, ...) localcmd = #46; +entity(entity e) nextent = #47; +void(vector o, vector d, float color, float count) particle = #48; +void() ChangeYaw = #49; + +vector(vector v) vectoangles = #51; +vector(vector v, vector w) vectoangles2 = #51; + +float(float f) sin = #60; +float(float f) cos = #61; +float(float f) sqrt = #62; +void(entity ent) changepitch = #63; +void(entity e, entity ignore) tracetoss = #64; +string(entity ent) etos = #65; + +string(string s) precache_file = #68; +void(entity e) makestatic = #69; + +void(string var, string val) cvar_set = #72; + +void(vector pos, string samp, float vol, float atten) ambientsound = #74; +string(string s) precache_model2 = #75; +string(string s) precache_sound2 = #76; +string(string s) precache_file2 = #77; + +float(string s) stof = #81; + + +void(vector v1, vector min, vector max, vector v2, float nomonsters, entity forent) tracebox = #90; +vector() randomvec = #91; +vector(vector org) getlight = #92; +vector(vector org, float lpflags) getlight2 = #92; +vector getlight_dir; +vector getlight_ambient; +vector getlight_diffuse; +const float LP_LIGHTMAP = 1; +const float LP_RTWORLD = 2; +const float LP_DYNLIGHT = 4; +const float LP_COMPLETE = 7; + +float(string name, string value) registercvar = #93; +float( float a, ... ) min = #94; +float( float b, ... ) max = #95; +float(float minimum, float val, float maximum) bound = #96; +float(float f, float f) pow = #97; +entity(entity start, .float fld, float match) findfloat = #98; +float(string s) checkextension = #99; +// FrikaC and Telejano range #100-#199 + +float(string filename, float mode) fopen = #110; +void(float fhandle) fclose = #111; +string(float fhandle) fgets = #112; +void(float fhandle, string s) fputs = #113; +float(string s) strlen = #114; +string(...) strcat = #115; +string(string s, float start, float length) substring = #116; +vector(string) stov = #117; +string(string s) strzone = #118; +void(string s) strunzone = #119; + +// FTEQW range #200-#299 + +float(float number, float quantity) bitshift = #218; + +//float(string str, string sub[, float startpos]) strstrofs = #221; +float(string str, string sub, float startpos) strstrofs = #221; +float(string str, float ofs) str2chr = #222; +string(float c, ...) chr2str = #223; +string(float ccase, float calpha, float cnum, string s, ...) strconv = #224; +string(float chars, string s, ...) strpad = #225; +string(string info, string key, string value, ...) infoadd = #226; +string(string info, string key) infoget = #227; +float(string s1, string s2) strcmp = #228; +float(string s1, string s2, float len) strncmp = #228; +float(string s1, string s2) strcasecmp = #229; +float(string s1, string s2, float len) strncasecmp = #230; + +// CSQC range #300-#399 +void() clearscene = #300; +void(float mask) addentities = #301; +void(entity ent) addentity = #302; +float(float property, ...) setproperty = #303; +float(float property) getproperty = #309; +vector(float property) getpropertyvec = #309; +void() renderscene = #304; +void(vector org, float radius, vector lightcolours) adddynamiclight = #305; +void(vector org, float radius, vector lightcolours, float style, string cubemapname, float pflags) adddynamiclight2 = #305; +//void(string texturename, float flag[, float is2d, float lines]) R_BeginPolygon = #306; +void(string texturename, float flag, ...) R_BeginPolygon = #306; +void(vector org, vector texcoords, vector rgb, float alpha) R_PolygonVertex = #307; +void() R_EndPolygon = #308; +vector (vector v) cs_unproject = #310; +vector (vector v) cs_project = #311; + +void(float width, vector pos1, vector pos2, float flag) drawline = #315; +float(string name) iscachedpic = #316; +string(string name, ...) precache_pic = #317; +string(string name) precache_cubemap = #317; +vector(string picname) draw_getimagesize = #318; +void(string name) freepic = #319; +float(vector position, float character, vector scale, vector rgb, float alpha, float flag) drawcharacter = #320; +float(vector position, string text, vector scale, vector rgb, float alpha, float flag) drawstring = #321; +float(vector position, string pic, vector size, vector rgb, float alpha, float flag) drawpic = #322; +float(vector position, vector size, vector rgb, float alpha, float flag) drawfill = #323; +void(float x, float y, float width, float height) drawsetcliparea = #324; +void(void) drawresetcliparea = #325; +float(vector position, string text, vector scale, float alpha, float flag) drawcolorcodedstring = #326; +vector(vector position, string text, vector scale, vector rgb, float alpha, float flag) drawcolorcodedstring2 = #326; + +float(float stnum) getstatf = #330; +float(float stnum, ...) getstati = #331; // can optionally take first bit and count +string(float firststnum) getstats = #332; +void(entity e, float mdlindex) setmodelindex = #333; +string(float mdlindex) modelnameforindex = #334; +float(string effectname) particleeffectnum = #335; +void(entity ent, float effectnum, vector start, vector end) trailparticles = #336; +//void(float effectnum, vector origin [, vector dir, float count]) pointparticles = #337; +void(float effectnum, vector origin , vector dir, float count) pointparticles = #337; +void(string s, ...) centerprint = #338; +void(string s, ...) print = #339; +string(float keynum) keynumtostring = #340; +float(string keyname) stringtokeynum = #341; +string(float keynum) getkeybind = #342; +void(float usecursor) setcursormode = #343; +vector() getmousepos = #344; +float(float framenum) getinputstate = #345; +void(float sens) setsensitivityscale = #346; +void(...) runstandardplayerphysics = #347; // this may or may not take a player ent +string(float playernum, string keyname) getplayerkeyvalue = #348; +float() isdemo = #349; +float() isserver = #350; +void(vector origin, vector forward, vector right, vector up) SetListener = #351; +void(string cmdname) registercommand = #352; +float(entity ent) wasfreed = #353; +string(string key) serverkey = #354; + +// Use proper case; refer to the id1 Write* functions! +float() ReadByte = #360; +float() ReadChar = #361; +float() ReadShort = #362; +float() ReadLong = #363; +float() ReadCoord = #364; +float() ReadAngle = #365; +string() ReadString = #366; +float() ReadFloat = #367; + +// LordHavoc's range #400-#499 +void(entity from, entity to) copyentity = #400; + +entity(.string fld, string match) findchain = #402; +entity(.float fld, float match) findchainfloat = #403; +void(vector org, string modelname, float startframe, float endframe, float framerate) effect = #404; +void(vector org, vector velocity, float howmany) te_blood = #405; +void(vector mincorner, vector maxcorner, float explosionspeed, float howmany) te_bloodshower = #406; +void(vector org, vector color) te_explosionrgb = #407; +void(vector mincorner, vector maxcorner, vector vel, float howmany, float color, float gravityflag, float randomveljitter) te_particlecube = #408; +void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlerain = #409; +void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlesnow = #410; +void(vector org, vector vel, float howmany) te_spark = #411; +void(vector org) te_gunshotquad = #412; +void(vector org) te_spikequad = #413; +void(vector org) te_superspikequad = #414; +void(vector org) te_explosionquad = #415; +void(vector org) te_smallflash = #416; +void(vector org, float radius, float lifetime, vector color) te_customflash = #417; +void(vector org) te_gunshot = #418; +void(vector org) te_spike = #419; +void(vector org) te_superspike = #420; +void(vector org) te_explosion = #421; +void(vector org) te_tarexplosion = #422; +void(vector org) te_wizspike = #423; +void(vector org) te_knightspike = #424; +void(vector org) te_lavasplash = #425; +void(vector org) te_teleport = #426; +void(vector org, float colorstart, float colorlength) te_explosion2 = #427; +void(entity own, vector start, vector end) te_lightning1 = #428; +void(entity own, vector start, vector end) te_lightning2 = #429; +void(entity own, vector start, vector end) te_lightning3 = #430; +void(entity own, vector start, vector end) te_beam = #431; +void(vector dir) vectorvectors = #432; +void(vector org) te_plasmaburn = #433; +float(entity e, float s) getsurfacenumpoints = #434; +vector(entity e, float s, float n) getsurfacepoint = #435; +vector(entity e, float s) getsurfacenormal = #436; +string(entity e, float s) getsurfacetexture = #437; +float(entity e, vector p) getsurfacenearpoint = #438; +vector(entity e, float s, vector p) getsurfaceclippedpoint = #439; + +float(string s) tokenize = #441; +string(float n) argv = #442; +void(entity e, entity tagentity, string tagname) setattachment = #443; +float(string pattern, float caseinsensitive, float quiet) search_begin = #444; +void(float handle) search_end = #445; +float(float handle) search_getsize = #446; +string(float handle, float num) search_getfilename = #447; +string(string s) cvar_string = #448; +entity(entity start, .float fld, float match) findflags = #449; +entity(.float fld, float match) findchainflags = #450; +float(entity ent, string tagname) gettagindex = #451; +vector(entity ent, float tagindex) gettaginfo = #452; + +void(vector org, vector vel, float howmany) te_flamejet = #457; + +entity(float num) entitybyindex = #459; +float() buf_create = #460; +void(float bufhandle) buf_del = #461; +float(float bufhandle) buf_getsize = #462; +void(float bufhandle_from, float bufhandle_to) buf_copy = #463; +void(float bufhandle, float sortpower, float backward) buf_sort = #464; +string(float bufhandle, string glue) buf_implode = #465; +string(float bufhandle, float string_index) bufstr_get = #466; +void(float bufhandle, float string_index, string str) bufstr_set = #467; +float(float bufhandle, string str, float order) bufstr_add = #468; +void(float bufhandle, float string_index) bufstr_free = #469; + +float(float s) asin = #471; +float(float c) acos = #472; +float(float t) atan = #473; +float(float c, float s) atan2 = #474; +float(float a) tan = #475; +float(string s) strippedstringlen = #476; +float(string s) strlennocol = #476; // This is the correct name for the function, but not removing the decolorizedstring mapping. +string(string s) decolorizedstring = #477; +string(string s) strdecolorize = #477; // This is the correct name for the function, but not removing the decolorizedstring mapping. +string(float uselocaltime, string format, ...) strftime = #478; +string(string s) strtolower = #480; +string(string s) strtoupper = #481; +string(string s) cvar_defstring = #482; +void(vector origin, string sample, float volume, float attenuation) pointsound = #483; +string(string search, string replace, string subject) strreplace = #484; +string(string search, string replace, string subject) strireplace = #485; +vector(entity e, float s, float n, float a) getsurfacepointattribute = #486; +#ifdef SUPPORT_GECKO +float gecko_create( string name ) = #487; +void gecko_destroy( string name ) = #488; +void gecko_navigate( string name, string URI ) = #489; +float gecko_keyevent( string name, float key, float eventtype ) = #490; +void gecko_mousemove( string name, float x, float y ) = #491; +void gecko_resize( string name, float w, float h ) = #492; +vector gecko_get_texture_extent( string name ) = #493; +#else + +#endif + +/* +============================================================================== + + EXTENSION DEFINITIONS + +============================================================================== +*/ + +// DP_CSQC_SPAWNPARTICLE +// idea: VorteX +// darkplaces implementation: VorteX +// constant definitions: +// particle base behavior: +float PT_ALPHASTATIC = 1; +float PT_STATIC = 2; +float PT_SPARK = 3; +float PT_BEAM = 4; +float PT_RAIN = 5; +float PT_RAINDECAL = 6; +float PT_SNOW = 7; +float PT_BUBBLE = 8; +float PT_BLOOD = 9; +float PT_SMOKE = 10; +float PT_DECAL = 11; +float PT_ENTITYPARTICLE = 12; +// particle blendtypes: +float PBLEND_ALPHA = 0; +float PBLEND_ADD = 1; +float PBLEND_INVMOD = 2; +// particle orientation: +float PARTICLE_BILLBOARD = 0; +float PARTICLE_SPARK = 1; +float PARTICLE_ORIENTED_DOUBLESIDED = 2; +float PARTICLE_BEAM = 3; +// global definitions: +float particle_type; // one of PT_ +float particle_blendmode; // one of PBLEND_ values +float particle_orientation; // one of PARTICLE_ values +vector particle_color1; +vector particle_color2; +float particle_tex; // number of chunk in particlefont +float particle_size; +float particle_sizeincrease; +float particle_alpha; +float particle_alphafade; +float particle_time; +float particle_gravity; +float particle_bounce; +float particle_airfriction; +float particle_liquidfriction; +float particle_originjitter; +float particle_velocityjitter; +float particle_qualityreduction; // enable culling of this particle when FPS is low +float particle_stretch; +vector particle_staincolor1; +vector particle_staincolor2; +float particle_staintex; +float particle_stainalpha; +float particle_stainsize; +float particle_delayspawn; +float particle_delaycollision; +float particle_angle; +float particle_spin; +// builtin definitions: +float(float max_themes) initparticlespawner = #522; // check fields/globals for integration and enable particle spawner, return 1 is succeded, otherwise returns 0 +void() resetparticle = #523; // reset p_ globals to default theme #0 +void(float theme) particletheme = #524; // restore p_ globals from saved theme +float() particlethemesave = #525; // save p_ globals to new particletheme and return it's index +void(float theme) particlethemeupdate = #525; // save p_ globals to new particletheme and return it's index +void(float theme) particlethemefree = #526; // delete a particle theme +float(vector org, vector vel) spawnparticle = #527; // returns 0 when failed, 1 when spawned +float(vector org, vector vel, float theme) quickparticle = #527; // not reading globals, just theme, returns 0 when failed, 1 when spawned +float(vector org, vector vel, float delay, float collisiondelay) delayedparticle = #528; +float(vector org, vector vel, float delay, float collisiondelay, float theme) quickdelayedparticle = #528; +// description: this builtin provides an easy and flexible way to spawn particles, +// it is not created as replace for DP_SV_POINTPARTICLES but as an addition to it. +// With this extension you can create a specific particles like rain particles, or entity particles +// notes: +// 1) 0 is default particle template, it could be changed +// 2) color vectors could have value 0-255 of each component +// restrictions: max themes could be between 4 and 2048 +// warning: you should call initparticlespawner() at very beginning BEFORE all other particle spawner functions +// function to query particle info +// don't remove this function as it protects all particle_ globals from FTEQCC/FRIKQCC non-referenced removal optimisation +void() printparticle = +{ + // vortex: this also protects from 'non-referenced' optimisation on some compilers + print("PARTICLE:\n"); + print(strcat(" type: ", ftos(particle_type), "\n")); + print(strcat(" blendmode: ", ftos(particle_blendmode), "\n")); + print(strcat(" orientation: ", ftos(particle_orientation), "\n")); + print(strcat(" color1: ", vtos(particle_color1), "\n")); + print(strcat(" color2: ", vtos(particle_color2), "\n")); + print(strcat(" tex: ", ftos(particle_tex), "\n")); + print(strcat(" size: ", ftos(particle_size), "\n")); + print(strcat(" sizeincrease: ", ftos(particle_sizeincrease), "\n")); + print(strcat(" alpha: ", ftos(particle_alpha), "\n")); + print(strcat(" alphafade: ", ftos(particle_alphafade), "\n")); + print(strcat(" time: ", ftos(particle_time), "\n")); + print(strcat(" gravity: ", ftos(particle_gravity), "\n")); + print(strcat(" bounce: ", ftos(particle_bounce), "\n")); + print(strcat(" airfriction: ", ftos(particle_airfriction), "\n")); + print(strcat(" liquidfriction: ", ftos(particle_liquidfriction), "\n")); + print(strcat(" originjitter: ", ftos(particle_originjitter), "\n")); + print(strcat(" velocityjitter: ", ftos(particle_velocityjitter), "\n")); + print(strcat(" qualityreduction: ", ftos(particle_qualityreduction), "\n")); + print(strcat(" stretch: ", ftos(particle_stretch), "\n")); + print(strcat(" staincolor1: ", vtos(particle_staincolor1), "\n")); + print(strcat(" staincolor2: ", vtos(particle_staincolor2), "\n")); + print(strcat(" staintex: ", ftos(particle_staintex), "\n")); + print(strcat(" stainalpha: ", ftos(particle_stainalpha), "\n")); + print(strcat(" stainsize: ", ftos(particle_stainsize), "\n")); + print(strcat(" delayspawn: ", ftos(particle_delayspawn), "\n")); + print(strcat(" delaycollision: ", ftos(particle_delaycollision), "\n")); + print(strcat(" angle: ", ftos(particle_angle), "\n")); + print(strcat(" spin: ", ftos(particle_spin), "\n")); +} + +// DP_CSQC_ENTITYTRANSPARENTSORTING_OFFSET +// idea: VorteX +// darkplaces implementation: VorteX +float RF_USETRANSPARENTOFFSET = 64; // enables transparent origin offsetting +// global definitions +float transparent_offset; // should be set before entity is added +// description: offset a model's meshes origin used for transparent sorting. Could be used to tweak sorting bugs on very large transparent entities or hacking transparent sorting order for certain objects +// example: transparent_offset = 1000000; // entity always appear on background of other transparents +// note: offset is done in view forward axis + +// DP_CSQC_ENTITYWORLDOBJECT +// idea: VorteX +// darkplaces implementation: VorteX +const float RF_WORLDOBJECT = 128; +// description: when renderflag is set, engine will not use culling methods for this entity, e.g. it will always be drawn +// useful for large outdoor objects (like asteroids on sky horizon or sky models) + +// DP_CSQC_ENTITYMODELLIGHT +// idea: VorteX +// darkplaces implementation: VorteX +const float RF_MODELLIGHT = 4096; +.vector modellight_ambient; +.vector modellight_diffuse; +.vector modellight_dir; +// description: allows CSQC to override directional model lightning on entity + +// DP_CSQC_SETPAUSE +// idea: VorteX +// darkplaces implementation: VorteX +// builtin definitions: +void(float ispaused) setpause = #531; +// description: provides ability to set pause in local games (similar to one set once console is activated) +// not stopping sound/cd track, useful for inventory screens, ingame menus with input etc. + +// DP_CSQC_QUERYRENDERENTITY +// idea: VorteX +// darkplaces implementation: VorteX +// constant definitions: +// render entity fields: +float E_ACTIVE = 0; // float 0/1 +float E_ORIGIN = 1; // vector +float E_FORWARD = 2; // vector +float E_RIGHT = 3; // vector +float E_UP = 4; // vector +float E_SCALE = 5; // float +float E_ORIGINANDVECTORS = 6; // returns origin, + sets v_* vectors to orientation +float E_ALPHA = 7; // float +float E_COLORMOD = 8; // vector +float E_PANTSCOLOR = 9; // vector +float E_SHIRTCOLOR = 10; // vector +float E_SKIN = 11; // float +float E_MINS = 12; // vector +float E_MAXS = 13; // vector +float E_ABSMIN = 14; // vector +float E_ABSMAX = 15; // vector +float E_LIGHT = 16; // vector - modellight +// builtin definitions: +float(float entitynum, float fldnum) getentity = #504; +vector(float entitynum, float fldnum) getentityvec = #504; +// description: allows to query parms from render entities, especially useful with attaching CSQC ents to +// server entities networked and interpolated by engine (monsters, players), number of entity is it's SVQC number +// you can send it via tempentity/CSQC entity message. Note that this builtin doesnt know about entity removing/reallocating +// so it's meaning to work for short period of time, dont use it on missiles/grenades whatever will be removed next five seconds + +//DP_GFX_FONTS +//idea: Blub\0, divVerent +//darkplaces implementation: Blub\0 +//console commands: +// loadfont fontname fontmaps size1 size2 ... +// A font can simply be gfx/tgafile (freetype fonts doent need extension), +// or alternatively you can specify multiple fonts and faces +// Like this: gfx/vera-sans:2,gfx/fallback:1 +// to load face 2 of the font gfx/vera-sans and use face 1 +// of gfx/fallback as fallback font +// You can also specify a list of font sizes to load, like this: +// loadfont console gfx/conchars,gfx/fallback 8 12 16 24 32 +// In many cases, 8 12 16 24 32 should be a good choice. +// for slots see: +//constant definitions: +float drawfont; // set it before drawstring()/drawchar() calls +float FONT_DEFAULT = 0; // 'default' +float FONT_CONSOLE = 1; // 'console', REALLY should be fixed width (ls!) +float FONT_SBAR = 2; // 'sbar', used on hud, must be fixed width +float FONT_NOTIFY = 3; // 'notify', used on sprint/bprint +float FONT_CHAT = 4; // 'chat' +float FONT_CENTERPRINT = 5;// 'centerprint' +float FONT_INFOBAR = 6; // 'infobar' +float FONT_MENU = 7; // 'menu', should be fixed width +float FONT_USER0 = 8; // 'user0', userdefined fonts +float FONT_USER1 = 9; // 'user1', userdefined fonts +float FONT_USER2 = 10; // 'user2', userdefined fonts +float FONT_USER3 = 11; // 'user3', userdefined fonts +float FONT_USER4 = 12; // 'user4', userdefined fonts +float FONT_USER5 = 13; // 'user5', userdefined fonts +float FONT_USER6 = 14; // 'user6', userdefined fonts +float FONT_USER7 = 15; // 'user7' slot, userdefined fonts +//builtin definitions: +float findfont(string s) = #356; // find font by fontname and return it's index +float loadfont(string fontname, string fontmaps, string sizes, float slot, float fix_scale, float fix_voffset) = #357; +// loads font immediately so stringwidth() function can be used just after builtin call +// returns a font slotnum (which is used to set drawfont to) +// first 3 parms are identical to "loadfont" console command ones +// slot could be one of FONT_ constants or result of findfont() or -1 to not use it +// if slot is given, font will be loaded to this slotnum and fontname become new title for it +// this way you can rename user* fonts to something more usable +// fix_* parms let you fix badly made fonts by applying some transformations to them +// fix_scale : per-character center-oriented scale (doesn't change line height at all) +// fix_voffset : vertical offset for each character, it's a multiplier to character height +float stringwidth(string text, float allowColorCodes, vector size) = #327; // get a width of string with given font and char size +float stringwidth_menu(string text, float allowColorCodes, vector size) = #468; // in menu.dat it has different builtin # +//description: engine support for custom fonts in console, hud, qc etc. +// limits: +// max 128 chars for font name +// max 3 font fallbacks +// max 8 sizes per font + +//DP_GFX_FONTS_FREETYPE +//idea: Blub\0, divVerent +//darkplaces implementation: Blub\0 +//cvar definitions: +// r_font_disable_freetype 0/1 : disable freetype fonts loading (uttetly disables freetype library initialization) +// r_font_antialias 0/1 : antialiasing when loading font +// r_font_hint 0/1/2/3 : hinting when loading font, 0 is no hinting, 1 light autohinting , 2 full autohinting, 3 full hinting +// r_font_postprocess_blur X : font outline blur amount +// r_font_postprocess_outline X : font outline width +// r_font_postprocess_shadow_x X : font outline shadow x shift amount, applied during outlining +// r_font_postprocess_shadow_y X : font outline shadow y shift amount, applied during outlining +// r_font_postprocess_shadow_z X : font outline shadow z shift amount, applied during blurring +//description: engine support for truetype/freetype fonts +//so .AFM+.PFB/.OTF/.TTF files could be stuffed as fontmaps in loadfont() +//(console command version will support them as well) + +//DP_CSQC_BINDMAPS +//idea: daemon, motorsep +//darkplaces implementation: divVerent +//builtin definitions: +string(float key, float bindmap) getkeybind_bindmap = #342; +float(float key, string bind, float bindmap) setkeybind_bindmap = #630; +vector(void) getbindmaps = #631; +float(vector bm) setbindmaps = #632; +string(string command, float bindmap) findkeysforcommand = #610; +// float(string key) stringtokeynum = #341; +// string(float keynum) keynumtostring = #340; +//description: key bind setting/getting including support for switchable +//bindmaps. + +//DP_CRYPTO +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: (CSQC) +float(string url, float id, string content_type, string delim, float buf, float keyid) crypto_uri_postbuf = #513; +//description: +//use -1 as buffer handle to justs end delim as postdata + +//DP_CSQC_MAINVIEW +//idea: divVerent +//darkplaces implementation: divVerent +//constant definitions: +const float VF_MAINVIEW = 400; +//use setproperty(VF_MAINVIEW, 1); before calling R_RenderView for the render +//that shall become the "main" view, which is e.g. used by PRYDON_CLIENTCURSOR +//this flag is set for the first scene, and not cleared by R_ClearScene +//this flag is automatically cleared by R_RenderView +//so when not using this extension, the first view rendered is the main view + +//DP_CSQC_MINFPS_QUALITY +//idea: divVerent +//darkplaces implementation: divVerent +//constant definitions: +const float VF_MINFPS_QUALITY = 401; +//use getproperty(VF_MINFPS_QUALITY); to do CSQC based LOD based on cl_minfps +//1 should lead to an unmodified view + +//DP_CSQC_V_CALCREFDEF_WIP1 +//DP_CSQC_V_CALCREFDEF_WIP2 +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +void(entity e, float refdefflags) V_CalcRefdef = #640; +//constant definitions: +float PMF_DUCKED = 4; +float PMF_ONGROUND = 8; +float REFDEFFLAG_TELEPORTED = 1; +float REFDEFFLAG_JUMPING = 2; +float REFDEFFLAG_DEAD = 4; +float REFDEFFLAG_INTERMISSION = 8; +//- use this on the player entity after performing prediction +//- pass REFDEFFLAG_TELEPORTED if the player teleported since last frame +//- pass REFDEFFLAG_JUMPING if jump button is pressed +//- pass REFDEFFLAG_DEAD if dead (DP_CSQC_V_CALCREFDEF_WIP2) +//- pass REFDEFFLAG_INTERMISSION if in intermission (DP_CSQC_V_CALCREFDEF_WIP2) +//- the player entity needs to have origin, velocity, pmove_flags set according +// to prediction (the above two PMF_ flags are used in the player's pmove_flags) +//- NOTE: to check for this, ALSO OR a check with DP_CSQC_V_CALCREFDEF to also support +// the finished extension once done + +// assorted builtins +float drawsubpic(vector position, vector size, string pic, vector srcPosition, vector srcSize, vector rgb, float alpha, float flag) = #328; +vector drawgetimagesize(string pic) = #318; +#define SPA_POSITION 0 +#define SPA_S_AXIS 1 +#define SPA_T_AXIS 2 +#define SPA_R_AXIS 3 +#define SPA_TEXCOORDS0 4 +#define SPA_LIGHTMAP0_TEXCOORDS 5 +#define SPA_LIGHTMAP_COLOR 6 +// float (entity e, float s) getsurfacenumpoints = #434; +// vector (entity e, float s, float n) getsurfacepoint = #435; +// vector (entity e, float s) getsurfacenormal = #436; +// string (entity e, float s) getsurfacetexture = #437; +// float (entity e, vector p) getsurfacenearpoint = #438; +// vector (entity e, float s, vector p) getsurfaceclippedpoint = #439; +// vector(entity e, float s, float n, float a) getsurfacepointattribute = #486; +float(entity e, float s) getsurfacenumtriangles = #628; +vector(entity e, float s, float n) getsurfacetriangle = #629; + +//DP_QC_ASINACOSATANATAN2TAN +//idea: Urre +//darkplaces implementation: LordHavoc +//constant definitions: +float DEG2RAD = 0.0174532925199432957692369076848861271344287188854172545609719144; +float RAD2DEG = 57.2957795130823208767981548141051703324054724665643215491602438612; +float PI = 3.1415926535897932384626433832795028841971693993751058209749445923; +//builtin definitions: +/* -Wdouble-declaration +float(float s) asin = #471; // returns angle in radians for a given sin() value, the result is in the range -PI*0.5 to PI*0.5 +float(float c) acos = #472; // returns angle in radians for a given cos() value, the result is in the range 0 to PI +float(float t) atan = #473; // returns angle in radians for a given tan() value, the result is in the range -PI*0.5 to PI*0.5 +float(float c, float s) atan2 = #474; // returns angle in radians for a given cos() and sin() value pair, the result is in the range -PI to PI (this is identical to vectoyaw except it returns radians rather than degrees) +float(float a) tan = #475; // returns tangent value (which is simply sin(a)/cos(a)) for the given angle in radians, the result is in the range -infinity to +infinity +*/ +//description: +//useful math functions for analyzing vectors, note that these all use angles in radians (just like the cos/sin functions) not degrees unlike makevectors/vectoyaw/vectoangles, so be sure to do the appropriate conversions (multiply by DEG2RAD or RAD2DEG as needed). +//note: atan2 can take unnormalized vectors (just like vectoyaw), and the function was included only for completeness (more often you want vectoyaw or vectoangles), atan2(v_x,v_y) * RAD2DEG gives the same result as vectoyaw(v) + +//DP_QC_SPRINTF +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +string(string format, ...) sprintf = #627; +//description: +//you know sprintf :P +//supported stuff: +// % +// optional: $ for the argument to format (the arg counter then is not increased) +// flags: #0- + +// optional: , *, or *$ for the field width (width is read before value and precision) +// optional: ., .*, or .*$ for the precision (precision is read before value) +// length modifiers: h for forcing a float, l for forcing an int/entity (by default, %d etc. cast a float to int) +// conversions: +// d takes a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an int +// i takes an int/entity if no length is specified or i is, and a float if h is specified as length, and cast it to an int +// ouxXc take a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an unsigned int +// eEfFgG take a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to a double +// s takes a string +// vV takes a vector, and processes the three components as if it were a gG for all three components, separated by space +// For conversions s and c, the flag # makes precision and width interpreted +// as byte count, by default it is interpreted as character count in UTF-8 +// enabled engines. No other conversions can create wide characters, and # +// has another meaning in these. + +//DP_QC_GETTIME +//idea: tZork +//darkplaces implementation: tZork, divVerent +//constant definitions: +float GETTIME_FRAMESTART = 0; // time of start of frame +float GETTIME_REALTIME = 1; // current time (may be OS specific) +float GETTIME_HIRES = 2; // like REALTIME, but may reset between QC invocations and thus can be higher precision +float GETTIME_UPTIME = 3; // time since start of the engine +//builtin definitions: +float(float tmr) gettime = #519; +//description: +//some timers to query... + +//DP_QC_GETTIME_CDTRACK +//idea: divVerent +//darkplaces implementation: divVerent +//constant definitions: +float GETTIME_CDTRACK = 4; +//description: +//returns the playing time of the current cdtrack when passed to gettime() +//see DP_END_GETSOUNDTIME for similar functionality but for entity sound channels + +//DP_QC_TOKENIZEBYSEPARATOR +//idea: Electro, SavageX, LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +float(string s, string separator1, ...) tokenizebyseparator = #479; +//description: +//this function returns tokens separated by any of the supplied separator strings, example: +//numnumbers = tokenizebyseparator("10.2.3.4", "."); +//returns 4 and the tokens are "10" "2" "3" "4" +//possibly useful for parsing IPv4 addresses (such as "1.2.3.4") and IPv6 addresses (such as "[1234:5678:9abc:def0:1234:5678:9abc:def0]:26000") + +//DP_QC_TOKENIZE_CONSOLE +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +float(string s) tokenize_console = #514; +float(float i) argv_start_index = #515; +float(float i) argv_end_index = #516; +//description: +//this function returns tokens separated just like the console does +//also, functions are provided to get the index of the first and last character of each token in the original string +//Passing negative values to them, or to argv, will be treated as indexes from the LAST token (like lists work in Perl). So argv(-1) will return the LAST token. + +//DP_SND_SOUND7_WIP1 +//DP_SND_SOUND7_WIP2 +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +void(entity e, float chan, string samp, float vol, float atten, float speed, float flags) sound7 = #8; +float SOUNDFLAG_RELIABLE = 1; +//description: +//plays a sound, with some more flags +//extensions to sound(): +//- channel may be in the range from -128 to 127; channels -128 to 0 are "auto", +// i.e. support multiple sounds at once, but cannot be stopped/restarted +//- a value 0 in the speed parameter means no change; otherwise, it is a +// percentage of playback speed ("pitch shifting"). 100 is normal pitch, 50 is +// half speed, 200 is double speed, etc. (DP_SND_SOUND7_WIP2) +//- the flag SOUNDFLAG_RELIABLE can be specified, which makes the sound send +// to MSG_ALL (reliable) instead of MSG_BROADCAST (unreliable, default); +// similarily, SOUNDFLAG_RELIABLE_TO_ONE sends to MSG_ONE +//- channel 0 is controlled by snd_channel0volume; channel 1 and -1 by +// snd_channel1volume, etc. (so, a channel shares the cvar with its respective +// auto-channel); however, the mod MUST define snd_channel8volume and upwards +// in default.cfg if they are to be used, as the engine does not create them +// to not litter the cvar list +//- this extension applies to CSQC as well; CSQC_Event_Sound will get speed and +// flags as extra 7th and 8th argument +//- WIP2 ideas: SOUNDFLAG_RELIABLE_TO_ONE, SOUNDFLAG_NOPHS, SOUNDFLAG_FORCELOOP +//- NOTE: to check for this, ALSO OR a check with DP_SND_SOUND7 to also support +// the finished extension once done + +//DP_PRECACHE_PIC_FLAGS +//idea: divVerent +//darkplaces implementation: divVerent +//constant definitions: +float PRECACHE_PIC_FROMWAD = 1; // this one actually is part of EXT_CSQC +float PRECACHE_PIC_NOTPERSISTENT = 2; // picture may get deallocated when unused +float PRECACHE_PIC_MIPMAP = 8; // mipmap the texture for possibly better downscaling at memory expense +//notes: these constants are given as optional second argument to precache_pic() + +//DP_QC_TRACE_MOVETYPE_WORLDONLY +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//constant definitions: +float MOVE_WORLDONLY = 3; +//description: +//allows traces to hit only world (ignoring all entities, unlike MOVE_NOMONSTERS which hits all bmodels), use as the nomonsters parameter to trace functions + +//DP_SND_GETSOUNDTIME +//idea: VorteX +//darkplaces implementation: VorteX +//constant definitions: +float(entity e, float channel) getsoundtime = #533; // get currently sound playing position on entity channel, -1 if not playing or error +float(string sample) soundlength = #534; // returns length of sound sample in seconds, -1 on error (sound not precached, sound system not initialized etc.) +//description: provides opportunity to query length of sound samples and realtime tracking of sound playing on entities (similar to DP_GETTIME_CDTRACK) +//note: beware dedicated server not running sound engine at all, so in dedicated mode this builtins will not work in server progs +//note also: menu progs not supporting getsoundtime() (will give a warning) since it has no sound playing on entities +//examples of use: +// - QC-driven looped sounds +// - QC events when sound playing is finished +// - toggleable ambientsounds +// - subtitles + +//DP_QC_NUM_FOR_EDICT +//idea: Blub\0 +//darkplaces implementation: Blub\0 +//Function to get the number of an entity - a clean way. +float(entity num) num_for_edict = #512; + +//DP_TRACE_HITCONTENTSMASK_SURFACEINFO +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//globals: +.float dphitcontentsmask; // if non-zero on the entity passed to traceline/tracebox/tracetoss this will override the normal collidable contents rules and instead hit these contents values (for example AI can use tracelines that hit DONOTENTER if it wants to, by simply changing this field on the entity passed to traceline), this affects normal movement as well as trace calls +float trace_dpstartcontents; // DPCONTENTS_ value at start position of trace +float trace_dphitcontents; // DPCONTENTS_ value of impacted surface (not contents at impact point, just contents of the surface that was hit) +float trace_dphitq3surfaceflags; // Q3SURFACEFLAG_ value of impacted surface +string trace_dphittexturename; // texture name of impacted surface +//constants: +float DPCONTENTS_SOLID = 1; // hit a bmodel, not a bounding box +float DPCONTENTS_WATER = 2; +float DPCONTENTS_SLIME = 4; +float DPCONTENTS_LAVA = 8; +float DPCONTENTS_SKY = 16; +float DPCONTENTS_BODY = 32; // hit a bounding box, not a bmodel +float DPCONTENTS_CORPSE = 64; // hit a SOLID_CORPSE entity +float DPCONTENTS_NODROP = 128; // an area where backpacks should not spawn +float DPCONTENTS_PLAYERCLIP = 256; // blocks player movement +float DPCONTENTS_MONSTERCLIP = 512; // blocks monster movement +float DPCONTENTS_DONOTENTER = 1024; // AI hint brush +float DPCONTENTS_LIQUIDSMASK = 14; // WATER | SLIME | LAVA +float DPCONTENTS_BOTCLIP = 2048; // AI hint brush +float DPCONTENTS_OPAQUE = 4096; // only fully opaque brushes get this (may be useful for line of sight checks) +float Q3SURFACEFLAG_NODAMAGE = 1; +float Q3SURFACEFLAG_SLICK = 2; // low friction surface +float Q3SURFACEFLAG_SKY = 4; // sky surface (also has NOIMPACT and NOMARKS set) +float Q3SURFACEFLAG_LADDER = 8; // climbable surface +float Q3SURFACEFLAG_NOIMPACT = 16; // projectiles should remove themselves on impact (this is set on sky) +float Q3SURFACEFLAG_NOMARKS = 32; // projectiles should not leave marks, such as decals (this is set on sky) +float Q3SURFACEFLAG_FLESH = 64; // projectiles should do a fleshy effect (blood?) on impact +float Q3SURFACEFLAG_NODRAW = 128; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_HINT = 256; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_SKIP = 512; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_NOLIGHTMAP = 1024; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_POINTLIGHT = 2048; // compiler hint (not important to qc) +float Q3SURFACEFLAG_METALSTEPS = 4096; // walking on this surface should make metal step sounds +float Q3SURFACEFLAG_NOSTEPS = 8192; // walking on this surface should not make footstep sounds +float Q3SURFACEFLAG_NONSOLID = 16384; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_LIGHTFILTER = 32768; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_ALPHASHADOW = 65536; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_NODLIGHT = 131072; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_DUST = 262144; // translucent 'light beam' effect (not important to qc) +//description: +//adds additional information after a traceline/tracebox/tracetoss call. +//also (very important) sets trace_* globals before calling .touch functions, +//this allows them to inspect the nature of the collision (for example +//determining if a projectile hit sky), clears trace_* variables for the other +//object in a touch event (that is to say, a projectile moving will see the +//trace results in its .touch function, but the player it hit will see very +//little information in the trace_ variables as it was not moving at the time) + +//DP_QC_CVAR_TYPE +//idea: divVerent +//DarkPlaces implementation: divVerent +//builtin definitions: +float(string name) cvar_type = #495; +float CVAR_TYPEFLAG_EXISTS = 1; +float CVAR_TYPEFLAG_SAVED = 2; +float CVAR_TYPEFLAG_PRIVATE = 4; +float CVAR_TYPEFLAG_ENGINE = 8; +float CVAR_TYPEFLAG_HASDESCRIPTION = 16; +float CVAR_TYPEFLAG_READONLY = 32; + +//DP_QC_CRC16 +//idea: divVerent +//darkplaces implementation: divVerent +//Some hash function to build hash tables with. This has to be be the CRC-16-CCITT that is also required for the QuakeWorld download protocol. +//When caseinsensitive is set, the CRC is calculated of the lower cased string. +float(float caseinsensitive, string s, ...) crc16 = #494; + +//DP_QC_URI_ESCAPE +//idea: divVerent +//darkplaces implementation: divVerent +//URI::Escape's functionality +string(string in) uri_escape = #510; +string(string in) uri_unescape = #511; + +//DP_QC_DIGEST +//idea: motorsep, Spike +//DarkPlaces implementation: divVerent +//builtin definitions: +string(string digest, string data, ...) digest_hex = #639; +//description: +//returns a given hex digest of given data +//the returned digest is always encoded in hexadecimal +//only the "MD4" digest is always supported! +//if the given digest is not supported, string_null is returned +//the digest string is matched case sensitively, use "MD4", not "md4"! + +//DP_QC_DIGEST_SHA256 +//idea: motorsep, Spike +//DarkPlaces implementation: divVerent +//description: +//"SHA256" is also an allowed digest type + +//DP_QC_LOG +//darkplaces implementation: divVerent +//builtin definitions: +float log(float f) = #532; +//description: +//logarithm + +//FTE_CSQC_SKELETONOBJECTS +//idea: Spike, LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +// all skeleton numbers are 1-based (0 being no skeleton) +// all bone numbers are 1-based (0 being invalid) +float(float modlindex) skel_create = #263; // create a skeleton (be sure to assign this value into .skeletonindex for use), returns skeleton index (1 or higher) on success, returns 0 on failure (for example if the modelindex is not skeletal), it is recommended that you create a new skeleton if you change modelindex, as the skeleton uses the hierarchy from the model. +float(float skel, entity ent, float modlindex, float retainfrac, float firstbone, float lastbone) skel_build = #264; // blend in a percentage of standard animation, 0 replaces entirely, 1 does nothing, 0.5 blends half, etc, and this only alters the bones in the specified range for which out of bounds values like 0,100000 are safe (uses .frame, .frame2, .frame3, .frame4, .lerpfrac, .lerpfrac3, .lerpfrac4, .frame1time, .frame2time, .frame3time, .frame4time), returns skel on success, 0 on failure +float(float skel) skel_get_numbones = #265; // returns how many bones exist in the created skeleton, 0 if skeleton does not exist +string(float skel, float bonenum) skel_get_bonename = #266; // returns name of bone (as a tempstring), "" if invalid bonenum (< 1 for example) or skeleton does not exist +float(float skel, float bonenum) skel_get_boneparent = #267; // returns parent num for supplied bonenum, 0 if bonenum has no parent or bone does not exist (returned value is always less than bonenum, you can loop on this) +float(float skel, string tagname) skel_find_bone = #268; // get number of bone with specified name, 0 on failure, bonenum (1-based) on success, same as using gettagindex but takes modelindex instead of entity +vector(float skel, float bonenum) skel_get_bonerel = #269; // get matrix of bone in skeleton relative to its parent - sets v_forward, v_right, v_up, returns origin (relative to parent bone) +vector(float skel, float bonenum) skel_get_boneabs = #270; // get matrix of bone in skeleton in model space - sets v_forward, v_right, v_up, returns origin (relative to entity) +void(float skel, float bonenum, vector org) skel_set_bone = #271; // set matrix of bone relative to its parent, reads v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) +void(float skel, float bonenum, vector org) skel_mul_bone = #272; // transform bone matrix (relative to its parent) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) +void(float skel, float startbone, float endbone, vector org) skel_mul_bones = #273; // transform bone matrices (relative to their parents) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bones) +void(float skeldst, float skelsrc, float startbone, float endbone) skel_copybones = #274; // copy bone matrices (relative to their parents) from one skeleton to another, useful for copying a skeleton to a corpse +void(float skel) skel_delete = #275; // deletes skeleton at the beginning of the next frame (you can add the entity, delete the skeleton, renderscene, and it will still work) +float(float modlindex, string framename) frameforname = #276; // finds number of a specified frame in the animation, returns -1 if no match found +float(float modlindex, float framenum) frameduration = #277; // returns the intended play time (in seconds) of the specified framegroup, if it does not exist the result is 0, if it is a single frame it may be a small value around 0.1 or 0. +//fields: +.float skeletonindex; // active skeleton overriding standard animation on model +.float frame; // primary framegroup animation (strength = 1 - lerpfrac - lerpfrac3 - lerpfrac4) +.float frame2; // secondary framegroup animation (strength = lerpfrac) +.float frame3; // tertiary framegroup animation (strength = lerpfrac3) +.float frame4; // quaternary framegroup animation (strength = lerpfrac4) +.float lerpfrac; // strength of framegroup blend +.float lerpfrac3; // strength of framegroup blend +.float lerpfrac4; // strength of framegroup blend +.float frame1time; // start time of framegroup animation +.float frame2time; // start time of framegroup animation +.float frame3time; // start time of framegroup animation +.float frame4time; // start time of framegroup animation +//description: +//this extension provides a way to do complex skeletal animation on an entity. +// +//see also DP_SKELETONOBJECTS (this extension implemented on server as well as client) +// +//notes: +//each model contains its own skeleton, reusing a skeleton with incompatible models will yield garbage (or not render). +//each model contains its own animation data, you can use animations from other model files (for example saving out all character animations as separate model files). +//if an engine supports loading an animation-only file format such as .md5anim in FTEQW, it can be used to animate any model with a compatible skeleton. +//proper use of this extension may require understanding matrix transforms (v_forward, v_right, v_up, origin), and you must keep in mind that v_right is negative for this purpose. +// +//features include: +//multiple animations blended together. +//animating a model with animations from another model with a compatible skeleton. +//restricting animation blends to certain bones of a model - for example independent animation of legs, torso, head. +//custom bone controllers - for example making eyes track a target location. +// +// +// +//example code follows... +// +//this helper function lets you identify (by parentage) what group a bone +//belongs to - for example "torso", "leftarm", would return 1 ("torso") for +//all children of the bone named "torso", unless they are children of +//"leftarm" (which is a child of "torso") which would return 2 instead... +float(float skel, float bonenum, string g1, string g2, string g3, string g4, string g5, string g6) example_skel_findbonegroup = +{ + local string bonename; + while (bonenum >= 0) + { + bonename = skel_get_bonename(skel, bonenum); + if (bonename == g1) return 1; + if (bonename == g2) return 2; + if (bonename == g3) return 3; + if (bonename == g4) return 4; + if (bonename == g5) return 5; + if (bonename == g6) return 6; + bonenum = skel_get_boneparent(skel, bonenum); + } + return 0; +}; +// create a skeletonindex for our player using current modelindex +void() example_skel_player_setup = +{ + self.skeletonindex = skel_create(self.modelindex); +}; +// setup bones of skeleton based on an animation +// note: animmodelindex can be a different model than self.modelindex +void(float animmodelindex, float framegroup, float framegroupstarttime) example_skel_player_update_begin = +{ + // start with our standard animation + self.frame = framegroup; + self.frame2 = 0; + self.frame3 = 0; + self.frame4 = 0; + self.frame1time = framegroupstarttime; + self.frame2time = 0; + self.frame3time = 0; + self.frame4time = 0; + self.lerpfrac = 0; + self.lerpfrac3 = 0; + self.lerpfrac4 = 0; + skel_build(self.skeletonindex, self, animmodelindex, 0, 0, 100000); +}; +// apply a different framegroup animation to bones with a specified parent +void(float animmodelindex, float framegroup, float framegroupstarttime, float blendalpha, string groupbonename, string excludegroupname1, string excludegroupname2) example_skel_player_update_applyoverride = +{ + local float bonenum; + local float numbones; + self.frame = framegroup; + self.frame2 = 0; + self.frame3 = 0; + self.frame4 = 0; + self.frame1time = framegroupstarttime; + self.frame2time = 0; + self.frame3time = 0; + self.frame4time = 0; + self.lerpfrac = 0; + self.lerpfrac3 = 0; + self.lerpfrac4 = 0; + bonenum = 0; + numbones = skel_get_numbones(self.skeletonindex); + while (bonenum < numbones) + { + if (example_skel_findbonegroup(self.skeletonindex, bonenum, groupbonename, excludegroupname1, excludegroupname2, "", "", "") == 1) + skel_build(self.skeletonindex, self, animmodelindex, 1 - blendalpha, bonenum, bonenum + 1); + bonenum = bonenum + 1; + } +}; +// make eyes point at a target location, be sure v_forward, v_right, v_up are set correctly before calling +void(vector eyetarget, string bonename) example_skel_player_update_eyetarget = +{ + local float bonenum; + local vector ang; + local vector oldforward, oldright, oldup; + local vector relforward, relright, relup, relorg; + local vector boneforward, boneright, boneup, boneorg; + local vector parentforward, parentright, parentup, parentorg; + local vector u, v; + local vector modeleyetarget; + bonenum = skel_find_bone(self.skeletonindex, bonename) - 1; + if (bonenum < 0) + return; + oldforward = v_forward; + oldright = v_right; + oldup = v_up; + v = eyetarget - self.origin; + modeleyetarget_x = v * v_forward; + modeleyetarget_y = 0-v * v_right; + modeleyetarget_z = v * v_up; + // this is an eyeball, make it point at the target location + // first get all the data we can... + relorg = skel_get_bonerel(self.skeletonindex, bonenum); + relforward = v_forward; + relright = v_right; + relup = v_up; + boneorg = skel_get_boneabs(self.skeletonindex, bonenum); + boneforward = v_forward; + boneright = v_right; + boneup = v_up; + parentorg = skel_get_boneabs(self.skeletonindex, skel_get_boneparent(self.skeletonindex, bonenum)); + parentforward = v_forward; + parentright = v_right; + parentup = v_up; + // get the vector from the eyeball to the target + u = modeleyetarget - boneorg; + // now transform it inversely by the parent matrix to produce new rel vectors + v_x = u * parentforward; + v_y = u * parentright; + v_z = u * parentup; + ang = vectoangles2(v, relup); + ang_x = 0 - ang_x; + makevectors(ang); + // set the relative bone matrix + skel_set_bone(self.skeletonindex, bonenum, relorg); + // restore caller's v_ vectors + v_forward = oldforward; + v_right = oldright; + v_up = oldup; +}; +// delete skeleton when we're done with it +// note: skeleton remains valid until next frame when it is really deleted +void() example_skel_player_delete = +{ + skel_delete(self.skeletonindex); + self.skeletonindex = 0; +}; +// +// END OF EXAMPLES FOR FTE_CSQC_SKELETONOBJECTS +// + +//DP_QC_ENTITYDATA +//idea: KrimZon +//darkplaces implementation: KrimZon +//builtin definitions: +float() numentityfields = #496; +string(float fieldnum) entityfieldname = #497; +float(float fieldnum) entityfieldtype = #498; +string(float fieldnum, entity ent) getentityfieldstring = #499; +float(float fieldnum, entity ent, string s) putentityfieldstring = #500; +//constants: +//Returned by entityfieldtype +float FIELD_STRING = 1; +float FIELD_FLOAT = 2; +float FIELD_VECTOR = 3; +float FIELD_ENTITY = 4; +float FIELD_FUNCTION = 6; +//description: +//Versatile functions intended for storing data from specific entities between level changes, but can be customized for some kind of partial savegame. +//WARNING: .entity fields cannot be saved and restored between map loads as they will leave dangling pointers. +//numentityfields returns the number of entity fields. NOT offsets. Vectors comprise 4 fields: v, v_x, v_y and v_z. +//entityfieldname returns the name as a string, eg. "origin" or "classname" or whatever. +//entityfieldtype returns a value that the constants represent, but the field may be of another type in more exotic progs.dat formats or compilers. +//getentityfieldstring returns data as would be written to a savegame, eg... "0.05" (float), "0 0 1" (vector), or "Hello World!" (string). Function names can also be returned. +//putentityfieldstring puts the data returned by getentityfieldstring back into the entity. + +//DP_QC_ENTITYSTRING +void(string s) loadfromdata = #529; +void(string s) loadfromfile = #530; +void(string s) callfunction = #605; +void(float fh, entity e) writetofile = #606; +float(string s) isfunction = #607; +void(entity e, string s) parseentitydata = #608; + +//DP_COVERAGE +//idea: divVerent +//darkplaces implementation: divVerent +//function definitions: +void coverage() = #642; // Reports a coverage event. The engine counts for each of the calls to this builtin whether it has been called. + +// assorted builtins +const float STAT_MOVEVARS_TICRATE = 240; +const float STAT_MOVEVARS_TIMESCALE = 241; +const float STAT_FRAGLIMIT = 235; +const float STAT_TIMELIMIT = 236; +const float STAT_MOVEVARS_GRAVITY = 242; +string(void) ReadPicture = #501; +float PARTICLES_USEALPHA = 1; +float particles_alphamin, particles_alphamax; +float PARTICLES_USECOLOR = 2; +vector particles_colormin, particles_colormax; +float PARTICLES_USEFADE = 4; // fades the COUNT (fade alpha using alphamin/alphamax) +float particles_fade; +float PARTICLES_DRAWASTRAIL = 128; +void(float effectindex, entity own, vector org_from, vector org_to, vector dir_from, vector dir_to, float countmultiplier, float flags) boxparticles = #502; +float trace_networkentity; +const float RF_FULLBRIGHT = 256; +const float RF_NOSHADOW = 512; +float RF_DYNAMICMODELLIGHT = 8192; + +float gettaginfo_parent; +string gettaginfo_name; +vector gettaginfo_offset; +vector gettaginfo_forward; +vector gettaginfo_right; +vector gettaginfo_up; +float checkpvs(vector viewpos, entity viewee) = #240; diff --git a/qcsrc/dpdefs/upstream/dpextensions.qc b/qcsrc/dpdefs/upstream/dpextensions.qc new file mode 100644 index 000000000..07142e943 --- /dev/null +++ b/qcsrc/dpdefs/upstream/dpextensions.qc @@ -0,0 +1,2573 @@ + +//DarkPlaces supported extension list, draft version 1.04 + +//things that don't have extensions yet: +.float disableclientprediction; + +//definitions that id Software left out: +//these are passed as the 'nomonsters' parameter to traceline/tracebox (yes really this was supported in all quake engines, nomonsters is misnamed) +float MOVE_NORMAL = 0; // same as FALSE +float MOVE_NOMONSTERS = 1; // same as TRUE +float MOVE_MISSILE = 2; // save as movement with .movetype == MOVETYPE_FLYMISSILE + +//checkextension function +//idea: expected by almost everyone +//darkplaces implementation: LordHavoc +float(string s) checkextension = #99; +//description: +//check if (cvar("pr_checkextension")) before calling this, this is the only +//guaranteed extension to be present in the extension system, it allows you +//to check if an extension is available, by name, to check for an extension +//use code like this: +//// (it is recommended this code be placed in worldspawn or a worldspawn called function somewhere) +//if (cvar("pr_checkextension")) +//if (checkextension("DP_SV_SETCOLOR")) +// ext_setcolor = TRUE; +//from then on you can check ext_setcolor to know if that extension is available + +//BX_WAL_SUPPORT +//idea: id Software +//darkplaces implementation: LordHavoc +//description: +//indicates the engine supports .wal textures for filenames in the textures/ directory +//(note: DarkPlaces has supported this since 2001 or 2002, but did not advertise it as an extension, then I noticed Betwix was advertising it and added the extension accordingly) + +//DP_BUTTONCHAT +//idea: Vermeulen +//darkplaces implementation: LordHavoc +//field definitions: +.float buttonchat; +//description: +//true if the player is currently chatting (in messagemode, menus or console) + +//DP_BUTTONUSE +//idea: id Software +//darkplaces implementation: LordHavoc +//field definitions: +.float buttonuse; +//client console commands: +//+use +//-use +//description: +//made +use and -use commands work, they now control the .buttonuse field (.button1 was used by many mods for other purposes). + +//DP_CL_LOADSKY +//idea: Nehahra, LordHavoc +//darkplaces implementation: LordHavoc +//client console commands: +//"loadsky" (parameters: "basename", example: "mtnsun_" would load "mtnsun_up.tga" and "mtnsun_rt.tga" and similar names, use "" to revert to quake sky, note: this is the same as Quake2 skybox naming) +//description: +//sets global skybox for the map for this client (can be stuffed to a client by QC), does not hurt much to repeatedly execute this command, please don't use this in mods if it can be avoided (only if changing skybox is REALLY needed, otherwise please use DP_GFX_SKYBOX). + +//DP_CON_SET +//idea: id Software +//darkplaces implementation: LordHavoc +//description: +//indicates this engine supports the "set" console command which creates or sets a non-archived cvar (not saved to config.cfg on exit), it is recommended that set and seta commands be placed in default.cfg for mod-specific cvars. + +//DP_CON_SETA +//idea: id Software +//darkplaces implementation: LordHavoc +//description: +//indicates this engine supports the "seta" console command which creates or sets an archived cvar (saved to config.cfg on exit), it is recommended that set and seta commands be placed in default.cfg for mod-specific cvars. + +//DP_CON_ALIASPARAMETERS +//idea: many +//darkplaces implementation: Black +//description: +//indicates this engine supports aliases containing $1 through $9 parameter macros (which when called will expand to the parameters passed to the alias, for example alias test "say $2 $1", then you can type test hi there and it will execute say there hi), as well as $0 (name of the alias) and $* (all parameters $1 onward). + +//DP_CON_EXPANDCVAR +//idea: many, PHP +//darkplaces implementation: Black +//description: +//indicates this engine supports console commandlines containing $cvarname which will expand to the contents of that cvar as a parameter, for instance say my fov is $fov, will say "my fov is 90", or similar. + +//DP_CON_STARTMAP +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//adds two engine-called aliases named startmap_sp and startmap_dm which are called when the engine tries to start a singleplayer game from the menu (startmap_sp) or the -listen or -dedicated options are used or the engine is a dedicated server (uses startmap_dm), these allow a mod or game to specify their own map instead of start, and also distinguish between singleplayer and -listen/-dedicated, also these need not be a simple "map start" command, they can do other things if desired, startmap_sp and startmap_dm both default to "map start". + +//DP_EF_ADDITIVE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_ADDITIVE = 32; +//description: +//additive blending when this object is rendered + +//DP_EF_BLUE +//idea: id Software +//darkplaces implementation: LordHavoc +//effects bit: +float EF_BLUE = 64; +//description: +//entity emits blue light (used for quad) + +//DP_EF_DOUBLESIDED +//idea: LordHavoc +//darkplaces implementation: [515] and LordHavoc +//effects bit: +float EF_DOUBLESIDED = 32768; +//description: +//render entity as double sided (backfaces are visible, I.E. you see the 'interior' of the model, rather than just the front), can be occasionally useful on transparent stuff. + +//DP_EF_DYNAMICMODELLIGHT +//idea: C.Brutail, divVerent, maikmerten +//darkplaces implementation: divVerent +//effects bit: +float EF_DYNAMICMODELLIGHT = 131072; +//description: +//force dynamic model light on the entity, even if it's a BSP model (or anything else with lightmaps or light colors) + +//DP_EF_FLAME +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_FLAME = 1024; +//description: +//entity is on fire + +//DP_EF_FULLBRIGHT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_FULLBRIGHT = 512; +//description: +//entity is always brightly lit + +//DP_EF_NODEPTHTEST +//idea: Supa +//darkplaces implementation: LordHavoc +//effects bit: +float EF_NODEPTHTEST = 8192; +//description: +//makes entity show up to client even through walls, useful with EF_ADDITIVE for special indicators like where team bases are in a map, so that people don't get lost + +//DP_EF_NODRAW +//idea: id Software +//darkplaces implementation: LordHavoc +//effects bit: +float EF_NODRAW = 16; +//description: +//prevents server from sending entity to client (forced invisible, even if it would have been a light source or other such things) + +//DP_EF_NOGUNBOB +//idea: Chris Page, Dresk +//darkplaces implementation: LordHAvoc +//effects bit: +float EF_NOGUNBOB = 256; +//description: +//this has different meanings depending on the entity it is used on: +//player entity - prevents gun bobbing on player.viewmodel +//viewmodelforclient entity - prevents gun bobbing on an entity attached to the player's view +//other entities - no effect +//uses: +//disabling gun bobbing on a diving mask or other model used as a .viewmodel. +//disabling gun bobbing on view-relative models meant to be part of the heads up display. (note: if fov is changed these entities may be off-screen, or too near the center of the screen, so use fov 90 in this case) + +//DP_EF_NOSHADOW +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_NOSHADOW = 4096; +//description: +//realtime lights will not cast shadows from this entity (but can still illuminate it) + +//DP_EF_RED +//idea: id Software +//darkplaces implementation: LordHavoc +//effects bit: +float EF_RED = 128; +//description: +//entity emits red light (used for invulnerability) + +//DP_EF_RESTARTANIM_BIT +//idea: id software +//darkplaces implementation: divVerent +//effects bit: +float EF_RESTARTANIM_BIT = 1048576; +//description: +//when toggled, the current animation is restarted. Useful for weapon animation. +//to toggle this bit in QC, you can do: +// self.effects += (EF_RESTARTANIM_BIT - 2 * (self.effects & EF_RESTARTANIM_BIT)); + +//DP_EF_STARDUST +//idea: MythWorks Inc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_STARDUST = 2048; +//description: +//entity emits bouncing sparkles in every direction + +//DP_EF_TELEPORT_BIT +//idea: id software +//darkplaces implementation: divVerent +//effects bit: +float EF_TELEPORT_BIT = 2097152; +//description: +//when toggled, interpolation of the entity is skipped for one frame. Useful for teleporting. +//to toggle this bit in QC, you can do: +// self.effects += (EF_TELEPORT_BIT - 2 * (self.effects & EF_TELEPORT_BIT)); + +//DP_ENT_ALPHA +//idea: Nehahra +//darkplaces implementation: LordHavoc +//fields: +.float alpha; +//description: +//controls opacity of the entity, 0.0 is forced to be 1.0 (otherwise everything would be invisible), use -1 if you want to make something invisible, 1.0 is solid (like normal). + +//DP_ENT_COLORMOD +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definition: +.vector colormod; +//description: +//controls color of the entity, '0 0 0', is forced to be '1 1 1' (otherwise everything would be black), used for tinting objects, for instance using '1 0.6 0.4' on an ogre would give you an orange ogre (order is red green blue), note the colors can go up to '8 8 8' (8x as bright as normal). + +//DP_ENT_CUSTOMCOLORMAP +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//if .colormap is set to 1024 + pants + shirt * 16, those colors will be used for colormapping the entity, rather than looking up a colormap by player number. + +/* +//NOTE: no longer supported by darkplaces because all entities are delta compressed now +//DP_ENT_DELTACOMPRESS // no longer supported +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_DELTA = 8388608; +//description: +//(obsolete) applies delta compression to the network updates of the entity, making updates smaller, this might cause some unreliable behavior in packet loss situations, so it should only be used on numerous (nails/plasma shots/etc) or unimportant objects (gibs/shell casings/bullet holes/etc). +*/ + +//DP_ENT_EXTERIORMODELTOCLIENT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//fields: +.entity exteriormodeltoclient; +//description: +//the entity is visible to all clients with one exception: if the specified client is using first person view (not using chase_active) the entity will not be shown. Also if tag attachments are supported any entities attached to the player entity will not be drawn in first person. + +//DP_ENT_GLOW +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float glow_color; +.float glow_size; +.float glow_trail; +//description: +//customizable glowing light effect on the entity, glow_color is a paletted (8bit) color in the range 0-255 (note: 0 and 254 are white), glow_size is 0 or higher (up to the engine what limit to cap it to, darkplaces imposes a 1020 limit), if glow_trail is true it will leave a trail of particles of the same color as the light. + +//DP_ENT_GLOWMOD +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definition: +.vector glowmod; +//description: +//controls color of the entity's glow texture (fullbrights), '0 0 0', is forced to be '1 1 1' (otherwise everything would be black), used for tinting objects, see colormod (same color restrictions apply). + +//DP_ENT_LOWPRECISION +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//effects bit: +float EF_LOWPRECISION = 4194304; +//description: +//uses low quality origin coordinates, reducing network traffic compared to the default high precision, intended for numerous objects (projectiles/gibs/bullet holes/etc). + +//DP_ENT_SCALE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float scale; +//description: +//controls rendering scale of the object, 0 is forced to be 1, darkplaces uses 1/16th accuracy and a limit of 15.9375, can be used to make an object larger or smaller. + +//DP_ENT_TRAILEFFECTNUM +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float traileffectnum; +//description: +//use a custom effectinfo.txt effect on this entity, assign it like this: +//self.traileffectnum = particleeffectnum("mycustomeffect"); +//this will do both the dlight and particle trail as described in the effect, basically equivalent to trailparticles() in CSQC but performed on a server entity. + +//DP_ENT_VIEWMODEL +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.entity viewmodelforclient; +//description: +//this is a very special capability, attachs the entity to the view of the client specified, origin and angles become relative to the view of that client, all effects can be used (multiple skins on a weapon model etc)... the entity is not visible to any other client. + +//DP_GFX_EXTERNALTEXTURES +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//loads external textures found in various directories (tenebrae compatible)... +/* +in all examples .tga is merely the base texture, it can be any of these: +.tga (base texture) +_glow.tga (fullbrights or other glowing overlay stuff, NOTE: this is done using additive blend, not alpha) +_pants.tga (pants overlay for colormapping on models, this should be shades of grey (it is tinted by pants color) and black wherever the base texture is not black, as this is an additive blend) +_shirt.tga (same idea as pants, but for shirt color) +_diffuse.tga (this may be used instead of base texture for per pixel lighting) +_gloss.tga (specular texture for per pixel lighting, note this can be in color (tenebrae only supports greyscale)) +_norm.tga (normalmap texture for per pixel lighting) +_bump.tga (bumpmap, converted to normalmap at load time, supported only for reasons of tenebrae compatibility) +_luma.tga (same as _glow but supported only for reasons of tenebrae compatibility) + +due to glquake's incomplete Targa(r) loader, this section describes +required Targa(r) features support: +types: +type 1 (uncompressed 8bit paletted with 24bit/32bit palette) +type 2 (uncompressed 24bit/32bit true color, glquake supported this) +type 3 (uncompressed 8bit greyscale) +type 9 (RLE compressed 8bit paletted with 24bit/32bit palette) +type 10 (RLE compressed 24bit/32bit true color, glquake supported this) +type 11 (RLE compressed 8bit greyscale) +attribute bit 0x20 (Origin At Top Left, top to bottom, left to right) + +image formats guaranteed to be supported: tga, pcx, lmp +image formats that are optional: png, jpg + +mdl/spr/spr32 examples: +skins are named _A (A being a number) and skingroups are named like _A_B +these act as suffixes on the model name... +example names for skin _2_1 of model "progs/armor.mdl": +game/override/progs/armor.mdl_2_1.tga +game/textures/progs/armor.mdl_2_1.tga +game/progs/armor.mdl_2_1.tga +example names for skin _0 of the model "progs/armor.mdl": +game/override/progs/armor.mdl_0.tga +game/textures/progs/armor.mdl_0.tga +game/progs/armor.mdl_0.tga +note that there can be more skins files (of the _0 naming) than the mdl +contains, this is only useful to save space in the .mdl file if classic quake +compatibility is not a concern. + +bsp/md2/md3 examples: +example names for the texture "quake" of model "maps/start.bsp": +game/override/quake.tga +game/textures/quake.tga +game/quake.tga + +sbar/menu/console textures: for example the texture "conchars" (console font) in gfx.wad +game/override/gfx/conchars.tga +game/textures/gfx/conchars.tga +game/gfx/conchars.tga +*/ + +//DP_GFX_EXTERNALTEXTURES_PERMAPTEXTURES +//idea: Fuh? +//darkplaces implementation: LordHavoc +//description: +//Q1BSP and HLBSP map loading loads external textures found in textures// as well as textures/. +//Where mapname is the bsp filename minus the extension (typically .bsp) and minus maps/ if it is in maps/ (any other path is not removed) +//example: +//maps/e1m1.bsp uses textures in the directory textures/e1m1/ and falls back to textures/ +//maps/b_batt0.bsp uses textures in the directory textures/b_batt0.bsp and falls back to textures/ +//as a more extreme example: +//progs/something/blah.bsp uses textures in the directory textures/progs/something/blah/ and falls back to textures/ + +//DP_GFX_FOG +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//worldspawn fields: +//"fog" (parameters: "density red green blue", example: "0.1 0.3 0.3 0.3") +//description: +//global fog for the map, can not be changed by QC + +//DP_GFX_QUAKE3MODELTAGS +//idea: id Software +//darkplaces implementation: LordHavoc +//field definitions: +.entity tag_entity; // entity this is attached to (call setattachment to set this) +.float tag_index; // which tag on that entity (0 is relative to the entity, > 0 is an index into the tags on the model if it has any) (call setattachment to set this) +//builtin definitions: +void(entity e, entity tagentity, string tagname) setattachment = #443; // attachs e to a tag on tagentity (note: use "" to attach to entity origin/angles instead of a tag) +//description: +//allows entities to be visually attached to model tags (which follow animations perfectly) on other entities, for example attaching a weapon to a player's hand, or upper body attached to lower body, allowing it to change angles and frame separately (note: origin and angles are relative to the tag, use '0 0 0' for both if you want it to follow exactly, this is similar to viewmodelforclient's behavior). +//note 2: if the tag is not found, it defaults to "" (attach to origin/angles of entity) +//note 3: attaching to world turns off attachment +//note 4: the entity that this is attached to must be visible for this to work +//note 5: if an entity is attached to the player entity it will not be drawn in first person. + +//DP_GFX_SKINFILES +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//alias models (mdl, md2, md3) can have .skin files to replace conventional texture naming, these have a naming format such as: +//progs/test.md3_0.skin +//progs/test.md3_1.skin +//... +// +//these files contain replace commands (replace meshname shadername), example: +//replace "helmet" "progs/test/helmet1.tga" // this is a mesh shader replacement +//replace "teamstripes" "progs/test/redstripes.tga" +//replace "visor" "common/nodraw" // this makes the visor mesh invisible +////it is not possible to rename tags using this format +// +//Or the Quake3 syntax (100% compatible with Quake3's .skin files): +//helmet,progs/test/helmet1.tga // this is a mesh shader replacement +//teamstripes,progs/test/redstripes.tga +//visor,common/nodraw // this makes the visor mesh invisible +//tag_camera, // this defines that the first tag in the model is called tag_camera +//tag_test, // this defines that the second tag in the model is called tag_test +// +//any names that are not replaced are automatically show up as a grey checkerboard to indicate the error status, and "common/nodraw" is a special case that is invisible. +//this feature is intended to allow multiple skin sets on md3 models (which otherwise only have one skin set). +//other commands might be added someday but it is not expected. + +//DP_GFX_SKYBOX +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//worldspawn fields: +//"sky" (parameters: "basename", example: "mtnsun_" would load "mtnsun_up.tga" and "mtnsun_rt.tga" and similar names, note: "sky" is also used the same way by Quake2) +//description: +//global skybox for the map, can not be changed by QC + +//DP_UTF8 +//idea: Blub\0, divVerent +//darkplaces implementation: Blub\0 +//cvar definitions: +// utf8_enable: enable utf8 encoding +//description: utf8 characters are allowed inside cvars, protocol strings, files, progs strings, etc., +//and count as 1 char for string functions like strlen, substring, etc. +// note: utf8_enable is run-time cvar, could be changed during execution +// note: beware that str2chr() could return value bigger than 255 once utf8 is enabled + +//DP_HALFLIFE_MAP +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//simply indicates that the engine supports HalfLife maps (BSP version 30, NOT the QER RGBA ones which are also version 30). + +//DP_HALFLIFE_MAP_CVAR +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//cvars: +//halflifebsp 0/1 +//description: +//engine sets this cvar when loading a map to indicate if it is halflife format or not. + +//DP_HALFLIFE_SPRITE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//simply indicates that the engine supports HalfLife sprites. + +//DP_INPUTBUTTONS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float button3; +.float button4; +.float button5; +.float button6; +.float button7; +.float button8; +.float button9; +.float button10; +.float button11; +.float button12; +.float button13; +.float button14; +.float button15; +.float button16; +//description: +//set to the state of the +button3, +button4, +button5, +button6, +button7, and +button8 buttons from the client, this does not involve protocol changes (the extra 6 button bits were simply not used). +//the exact mapping of protocol button bits on the server is: +//self.button0 = (bits & 1) != 0; +///* button1 is skipped because mods abuse it as a variable, and accordingly it has no bit */ +//self.button2 = (bits & 2) != 0; +//self.button3 = (bits & 4) != 0; +//self.button4 = (bits & 8) != 0; +//self.button5 = (bits & 16) != 0; +//self.button6 = (bits & 32) != 0; +//self.button7 = (bits & 64) != 0; +//self.button8 = (bits & 128) != 0; + +// DP_LIGHTSTYLE_STATICVALUE +// idea: VorteX +// darkplaces implementation: VorteX +// description: allows alternative 'static' lightstyle syntax : "=value" +// examples: "=0.5", "=2.0", "=2.75" +// could be used to control switchable lights or making styled lights with brightness > 2 +// Warning: this extension is experimental. It safely works in CSQC, but SVQC use is limited by the fact +// that other engines (which do not support this extension) could connect to a game and misunderstand this kind of lightstyle syntax + +//DP_LITSPRITES +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//indicates this engine supports lighting on sprites, any sprite with ! in its filename (both on disk and in the qc) will be lit rather than having forced EF_FULLBRIGHT (EF_FULLBRIGHT on the entity can still force these sprites to not be lit). + +//DP_LITSUPPORT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//indicates this engine loads .lit files for any quake1 format .bsp files it loads to enhance maps with colored lighting. +//implementation description: these files begin with the header QLIT followed by version number 1 (as little endian 32bit), the rest of the file is a replacement lightmaps lump, except being 3x as large as the lightmaps lump of the map it matches up with (and yes the between-lightmap padding is expanded 3x to keep this consistent), so the lightmap offset in each surface is simply multiplied by 3 during loading to properly index the lit data, and the lit file is loaded instead of the lightmap lump, other renderer changes are needed to display these of course... see the litsupport.zip sample code (almost a tutorial) at http://icculus.org/twilight/darkplaces for more information. + +//DP_MONSTERWALK +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//MOVETYPE_WALK is permitted on non-clients, so bots can move smoothly, run off ledges, etc, just like a real player. + +//DP_MOVETYPEBOUNCEMISSILE +//idea: id Software +//darkplaces implementation: id Software +//movetype definitions: +//float MOVETYPE_BOUNCEMISSILE = 11; // already in defs.qc +//description: +//MOVETYPE_BOUNCE but without gravity, and with full reflection (no speed loss like grenades have), in other words - bouncing laser bolts. + +//DP_MOVETYPEFLYWORLDONLY +//idea: Samual +//darkplaces implementation: Samual +//movetype definitions: +float MOVETYPE_FLY_WORLDONLY = 33; +//description: +//like MOVETYPE_FLY, but does all traces with MOVE_WORLDONLY, and is ignored by MOVETYPE_PUSH. Should only be combined with SOLID_NOT and SOLID_TRIGGER. + +//DP_NULL_MODEL +//idea: Chris +//darkplaces implementation: divVerent +//definitions: +//string dp_null_model = "null"; +//description: +//setmodel(e, "null"); makes an entity invisible, have a zero bbox, but +//networked. useful for shared CSQC entities. + +//DP_MOVETYPEFOLLOW +//idea: id Software, LordHavoc (redesigned) +//darkplaces implementation: LordHavoc +//movetype definitions: +float MOVETYPE_FOLLOW = 12; +//description: +//MOVETYPE_FOLLOW implemented, this uses existing entity fields in unusual ways: +//aiment - the entity this is attached to. +//punchangle - the original angles when the follow began. +//view_ofs - the relative origin (note that this is un-rotated by punchangle, and that is actually the only purpose of punchangle). +//v_angle - the relative angles. +//here's an example of how you would set a bullet hole sprite to follow a bmodel it was created on, even if the bmodel rotates: +//hole.movetype = MOVETYPE_FOLLOW; // make the hole follow +//hole.solid = SOLID_NOT; // MOVETYPE_FOLLOW is always non-solid +//hole.aiment = bmodel; // make the hole follow bmodel +//hole.punchangle = bmodel.angles; // the original angles of bmodel +//hole.view_ofs = hole.origin - bmodel.origin; // relative origin +//hole.v_angle = hole.angles - bmodel.angles; // relative angles + +//DP_QC_ASINACOSATANATAN2TAN +//idea: Urre +//darkplaces implementation: LordHavoc +//constant definitions: +float DEG2RAD = 0.0174532925199432957692369076848861271344287188854172545609719144; +float RAD2DEG = 57.2957795130823208767981548141051703324054724665643215491602438612; +float PI = 3.1415926535897932384626433832795028841971693993751058209749445923; +//builtin definitions: +float(float s) asin = #471; // returns angle in radians for a given sin() value, the result is in the range -PI*0.5 to PI*0.5 +float(float c) acos = #472; // returns angle in radians for a given cos() value, the result is in the range 0 to PI +float(float t) atan = #473; // returns angle in radians for a given tan() value, the result is in the range -PI*0.5 to PI*0.5 +float(float c, float s) atan2 = #474; // returns angle in radians for a given cos() and sin() value pair, the result is in the range -PI to PI (this is identical to vectoyaw except it returns radians rather than degrees) +float(float a) tan = #475; // returns tangent value (which is simply sin(a)/cos(a)) for the given angle in radians, the result is in the range -infinity to +infinity +//description: +//useful math functions for analyzing vectors, note that these all use angles in radians (just like the cos/sin functions) not degrees unlike makevectors/vectoyaw/vectoangles, so be sure to do the appropriate conversions (multiply by DEG2RAD or RAD2DEG as needed). +//note: atan2 can take unnormalized vectors (just like vectoyaw), and the function was included only for completeness (more often you want vectoyaw or vectoangles), atan2(v_x,v_y) * RAD2DEG gives the same result as vectoyaw(v) + +//DP_QC_AUTOCVARS +//idea: divVerent +//darkplaces implementation: divVerent +//description: +//allows QC variables to be bound to cvars +//(works for float, string, vector types) +//example: +// float autocvar_developer; +// float autocvar_registered; +// string autocvar__cl_name; +//NOTE: copying a string-typed autocvar to another variable/field, and then +//changing the cvar or returning from progs is UNDEFINED. Writing to autocvar +//globals is UNDEFINED. Accessing autocvar globals after changing that cvar in +//the same frame by any means other than cvar_set() from the same QC VM is +//IMPLEMENTATION DEFINED (an implementation may either yield the previous, or +//the current, value). Changing them via cvar_set() in the same QC VM +//immediately must reflect on the autocvar globals. Whether autocvar globals, +//after restoring a savegame, have the cvar's current value, or the original +//value at time of saving, is UNDEFINED. Restoring a savegame however must not +//restore the cvar values themselves. +//In case the cvar does NOT exist, then it is automatically created with the +//value of the autocvar initializer, if given. This is possible with e.g. +//frikqcc and fteqcc the following way: +// var float autocvar_whatever = 42; +//If no initializer is given, the cvar will be initialized to a string +//equivalent to the NULL value of the given data type, that is, the empty +//string, 0, or '0 0 0'. However, when automatic cvar creation took place, a +//warning is printed to the game console. +//NOTE: to prevent an ambiguity with float names for vector types, autocvar +//names MUST NOT end with _x, _y or _z! + +//DP_QC_CHANGEPITCH +//idea: id Software +//darkplaces implementation: id Software +//field definitions: +.float idealpitch; +.float pitch_speed; +//builtin definitions: +void(entity ent) changepitch = #63; +//description: +//equivalent to changeyaw, ent is normally self. (this was a Q2 builtin) + +//DP_QC_COPYENTITY +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(entity from, entity to) copyentity = #400; +//description: +//copies all data in the entity to another entity. + +//DP_QC_CRC16 +//idea: divVerent +//darkplaces implementation: divVerent +//Some hash function to build hash tables with. This has to be be the CRC-16-CCITT that is also required for the QuakeWorld download protocol. +//When caseinsensitive is set, the CRC is calculated of the lower cased string. +float(float caseinsensitive, string s, ...) crc16 = #494; + +//DP_QC_CVAR_DEFSTRING +//idea: id Software (Doom3), LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +string(string s) cvar_defstring = #482; +//description: +//returns the default value of a cvar, as a tempstring. + +//DP_QC_CVAR_DESCRIPTION +//idea: divVerent +//DarkPlaces implementation: divVerent +//builtin definitions: +string(string name) cvar_description = #518; +//description: +//returns the description of a cvar + +//DP_QC_CVAR_STRING +//idea: VorteX +//DarkPlaces implementation: VorteX, LordHavoc +//builtin definitions: +string(string s) cvar_string = #448; +//description: +//returns the value of a cvar, as a tempstring. + +//DP_QC_CVAR_TYPE +//idea: divVerent +//DarkPlaces implementation: divVerent +//builtin definitions: +float(string name) cvar_type = #495; +float CVAR_TYPEFLAG_EXISTS = 1; +float CVAR_TYPEFLAG_SAVED = 2; +float CVAR_TYPEFLAG_PRIVATE = 4; +float CVAR_TYPEFLAG_ENGINE = 8; +float CVAR_TYPEFLAG_HASDESCRIPTION = 16; +float CVAR_TYPEFLAG_READONLY = 32; + +//DP_QC_DIGEST +//idea: motorsep, Spike +//DarkPlaces implementation: divVerent +//builtin definitions: +string(string digest, string data, ...) digest_hex = #639; +//description: +//returns a given hex digest of given data +//the returned digest is always encoded in hexadecimal +//only the "MD4" digest is always supported! +//if the given digest is not supported, string_null is returned +//the digest string is matched case sensitively, use "MD4", not "md4"! + +//DP_QC_DIGEST_SHA256 +//idea: motorsep, Spike +//DarkPlaces implementation: divVerent +//description: +//"SHA256" is also an allowed digest type + +//DP_QC_EDICT_NUM +//idea: 515 +//DarkPlaces implementation: LordHavoc +//builtin definitions: +entity(float entnum) edict_num = #459; +float(entity ent) wasfreed = #353; // same as in EXT_CSQC extension +//description: +//edict_num returns the entity corresponding to a given number, this works even for freed entities, but you should call wasfreed(ent) to see if is currently active. +//wasfreed returns whether an entity slot is currently free (entities that have never spawned are free, entities that have had remove called on them are also free). + +//DP_QC_ENTITYDATA +//idea: KrimZon +//darkplaces implementation: KrimZon +//builtin definitions: +float() numentityfields = #496; +string(float fieldnum) entityfieldname = #497; +float(float fieldnum) entityfieldtype = #498; +string(float fieldnum, entity ent) getentityfieldstring = #499; +float(float fieldnum, entity ent, string s) putentityfieldstring = #500; +//constants: +//Returned by entityfieldtype +float FIELD_STRING = 1; +float FIELD_FLOAT = 2; +float FIELD_VECTOR = 3; +float FIELD_ENTITY = 4; +float FIELD_FUNCTION = 6; +//description: +//Versatile functions intended for storing data from specific entities between level changes, but can be customized for some kind of partial savegame. +//WARNING: .entity fields cannot be saved and restored between map loads as they will leave dangling pointers. +//numentityfields returns the number of entity fields. NOT offsets. Vectors comprise 4 fields: v, v_x, v_y and v_z. +//entityfieldname returns the name as a string, eg. "origin" or "classname" or whatever. +//entityfieldtype returns a value that the constants represent, but the field may be of another type in more exotic progs.dat formats or compilers. +//getentityfieldstring returns data as would be written to a savegame, eg... "0.05" (float), "0 0 1" (vector), or "Hello World!" (string). Function names can also be returned. +//putentityfieldstring puts the data returned by getentityfieldstring back into the entity. + +//DP_QC_ENTITYSTRING +void(string s) loadfromdata = #529; +void(string s) loadfromfile = #530; +void(string s) callfunction = #605; +void(float fh, entity e) writetofile = #606; +float(string s) isfunction = #607; +void(entity e, string s) parseentitydata = #608; + +//DP_QC_ETOS +//idea: id Software +//darkplaces implementation: id Software +//builtin definitions: +string(entity ent) etos = #65; +//description: +//prints "entity 1" or similar into a string. (this was a Q2 builtin) + +//DP_QC_EXTRESPONSEPACKET +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +string(void) getextresponse = #624; +//description: +//returns a string of the form "\"ipaddress:port\" data...", or the NULL string +//if no packet was found. Packets can be queued into the client/server by +//sending a packet starting with "\xFF\xFF\xFF\xFFextResponse " to the +//listening port. + +//DP_QC_FINDCHAIN +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +entity(.string fld, string match) findchain = #402; +//description: +//similar to find() but returns a chain of entities like findradius. + +//DP_QC_FINDCHAIN_TOFIELD +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +entity(.string fld, float match, .entity tofield) findradius_tofield = #22; +entity(.string fld, string match, .entity tofield) findchain_tofield = #402; +entity(.string fld, float match, .entity tofield) findchainflags_tofield = #450; +entity(.string fld, float match, .entity tofield) findchainfloat_tofield = #403; +//description: +//similar to findchain() etc, but stores the chain into .tofield instead of .chain +//actually, the .entity tofield is an optional field of the the existing findchain* functions + +//DP_QC_FINDCHAINFLAGS +//idea: Sajt +//darkplaces implementation: LordHavoc +//builtin definitions: +entity(.float fld, float match) findchainflags = #450; +//description: +//similar to findflags() but returns a chain of entities like findradius. + +//DP_QC_FINDCHAINFLOAT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +entity(.entity fld, entity match) findchainentity = #403; +entity(.float fld, float match) findchainfloat = #403; +//description: +//similar to findentity()/findfloat() but returns a chain of entities like findradius. + +//DP_QC_FINDFLAGS +//idea: Sajt +//darkplaces implementation: LordHavoc +//builtin definitions: +entity(entity start, .float fld, float match) findflags = #449; +//description: +//finds an entity with the specified flag set in the field, similar to find() + +//DP_QC_FINDFLOAT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +entity(entity start, .entity fld, entity match) findentity = #98; +entity(entity start, .float fld, float match) findfloat = #98; +//description: +//finds an entity or float field value, similar to find(), but for entity and float fields. + +//DP_QC_FS_SEARCH +//idea: Black +//darkplaces implementation: Black +//builtin definitions: +float(string pattern, float caseinsensitive, float quiet) search_begin = #444; +void(float handle) search_end = #445; +float(float handle) search_getsize = #446; +string(float handle, float num) search_getfilename = #447; +//description: +//search_begin performs a filename search with the specified pattern (for example "maps/*.bsp") and stores the results in a search slot (minimum of 128 supported by any engine with this extension), the other functions take this returned search slot number, be sure to search_free when done (they are also freed on progs reload). +//search_end frees a search slot (also done at progs reload). +//search_getsize returns how many filenames were found. +//search_getfilename returns a filename from the search. + +//DP_QC_GETLIGHT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +vector(vector org) getlight = #92; +//description: +//returns the lighting at the requested location (in color), 0-255 range (can exceed 255). + +//DP_QC_GETSURFACE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +float(entity e, float s) getsurfacenumpoints = #434; +vector(entity e, float s, float n) getsurfacepoint = #435; +vector(entity e, float s) getsurfacenormal = #436; +string(entity e, float s) getsurfacetexture = #437; +float(entity e, vector p) getsurfacenearpoint = #438; +vector(entity e, float s, vector p) getsurfaceclippedpoint = #439; +//description: +//functions to query surface information. + +//DP_QC_GETSURFACEPOINTATTRIBUTE +//idea: BlackHC +//darkplaces implementation: BlackHC +// constants +float SPA_POSITION = 0; +float SPA_S_AXIS = 1; +float SPA_T_AXIS = 2; +float SPA_R_AXIS = 3; // same as SPA_NORMAL +float SPA_TEXCOORDS0 = 4; +float SPA_LIGHTMAP0_TEXCOORDS = 5; +float SPA_LIGHTMAP0_COLOR = 6; +//builtin definitions: +vector(entity e, float s, float n, float a) getsurfacepointattribute = #486; + +//description: +//function to query extended information about a point on a certain surface + +//DP_QC_GETSURFACETRIANGLE +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +float(entity e, float s) getsurfacenumtriangles = #628; +vector(entity e, float s, float n) getsurfacetriangle = #629; +//description: +//function to query triangles of a surface + +//DP_QC_GETTAGINFO +//idea: VorteX, LordHavoc +//DarkPlaces implementation: VorteX +//builtin definitions: +float(entity ent, string tagname) gettagindex = #451; +vector(entity ent, float tagindex) gettaginfo = #452; +//description: +//gettagindex returns the number of a tag on an entity, this number is the same as set by setattachment (in the .tag_index field), allowing the qc to save a little cpu time by keeping the number around if it wishes (this could already be done by calling setattachment and saving off the tag_index). +//gettaginfo returns the origin of the tag in worldspace and sets v_forward, v_right, and v_up to the current orientation of the tag in worldspace, this automatically resolves all dependencies (attachments, including viewmodelforclient), this means you could fire a shot from a tag on a gun entity attached to the view for example. + +//DP_QC_GETTAGINFO_BONEPROPERTIES +//idea: daemon +//DarkPlaces implementation: divVerent +//global definitions: +float gettaginfo_parent; +string gettaginfo_name; +vector gettaginfo_offset; +vector gettaginfo_forward; +vector gettaginfo_right; +vector gettaginfo_up; +//description: +//when this extension is present, gettaginfo fills in some globals with info about the bone that had been queried +//gettaginfo_parent is set to the number of the parent bone, or 0 if it is a root bone +//gettaginfo_name is set to the name of the bone whose index had been specified in gettaginfo +//gettaginfo_offset, gettaginfo_forward, gettaginfo_right, gettaginfo_up contain the transformation matrix of the bone relative to its parent. Note that the matrix may contain a scaling component. + +//DP_QC_GETTIME +//idea: tZork +//darkplaces implementation: tZork, divVerent +//constant definitions: +float GETTIME_FRAMESTART = 0; // time of start of frame relative to an arbitrary point in time +float GETTIME_REALTIME = 1; // current absolute time (OS specific) +float GETTIME_HIRES = 2; // like REALTIME, but may reset between QC invocations and thus can be higher precision +float GETTIME_UPTIME = 3; // time of start of frame since start of the engine +//builtin definitions: +float(float tmr) gettime = #519; +//description: +//some timers to query... + +//DP_QC_GETTIME_CDTRACK +//idea: divVerent +//darkplaces implementation: divVerent +//constant definitions: +float GETTIME_CDTRACK = 4; +//description: +//returns the playing time of the current cdtrack when passed to gettime() +//see DP_END_GETSOUNDTIME for similar functionality but for entity sound channels + +//DP_QC_I18N +//idea: divVerent +//darkplaces implementation: divVerent +//description: +// +//The engine supports translating by gettext compatible .po files. +//progs.dat uses progs.dat..po +//menu.dat uses menu.dat..po +//csprogs.dat uses csprogs.dat..po +// +//To create a string that can be translated, define it as +// string dotranslate_FILENOTFOUND = "File not found"; +//Note: if the compiler does constant folding, this will only work if there is +//no other "File not found" string in the progs! +// +//Alternatively, if using the Xonotic patched fteqcc compiler, you can simplify +//this by using _("File not found") directly in the source code. +// +//The language is set by the "prvm_language" cvar: if prvm_language is set to +//"de", it will read progs.dat.de.po for translating strings in progs.dat. +// +//If prvm_language is set to the special name "dump", progs.dat.pot will be +//written, which is a translation template to be edited by filling out the +//msgstr entries. + +//DP_QC_LOG +//darkplaces implementation: divVerent +//builtin definitions: +float log(float f) = #532; +//description: +//logarithm + +//DP_QC_MINMAXBOUND +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +float(float a, float b, ...) min = #94; +float(float a, float b, float c) min3 = #94; +float(float a, float b, float c, float d) min4 = #94; +float(float a, float b, float c, float d, float e) min5 = #94; +float(float a, float b, float c, float d, float e, float f) min6 = #94; +float(float a, float b, float c, float d, float e, float f, float g) min7 = #94; +float(float a, float b, float c, float d, float e, float f, float g, float h) min8 = #94; +float(float a, float b, ...) max = #95; +float(float a, float b, float c) max3 = #95; +float(float a, float b, float c, float d) max4 = #95; +float(float a, float b, float c, float d, float e) max5 = #95; +float(float a, float b, float c, float d, float e, float f) max6 = #95; +float(float a, float b, float c, float d, float e, float f, float g) max7 = #95; +float(float a, float b, float c, float d, float e, float f, float g, float h) max8 = #95; +float(float minimum, float val, float maximum) bound = #96; +//description: +//min returns the lowest of all the supplied numbers. +//max returns the highest of all the supplied numbers. +//bound clamps the value to the range and returns it. + +//DP_QC_MULTIPLETEMPSTRINGS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//this extension makes all builtins returning tempstrings (ftos for example) +//cycle through a pool of multiple tempstrings (at least 16), allowing +//multiple ftos results to be gathered before putting them to use, normal +//quake only had 1 tempstring, causing many headaches. +// +//Note that for longer term storage (or compatibility on engines having +//FRIK_FILE but not this extension) the FRIK_FILE extension's +//strzone/strunzone builtins provide similar functionality (slower though). +// +//NOTE: this extension is superseded by DP_QC_UNLIMITEDTEMPSTRINGS + +//DP_QC_NUM_FOR_EDICT +//idea: Blub\0 +//darkplaces implementation: Blub\0 +//Function to get the number of an entity - a clean way. +float(entity num) num_for_edict = #512; + +//DP_QC_RANDOMVEC +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +vector() randomvec = #91; +//description: +//returns a vector of length < 1, much quicker version of this QC: do {v_x = random()*2-1;v_y = random()*2-1;v_z = random()*2-1;} while(vlen(v) > 1) + +//DP_QC_SINCOSSQRTPOW +//idea: id Software, LordHavoc +//darkplaces implementation: id Software, LordHavoc +//builtin definitions: +float(float val) sin = #60; +float(float val) cos = #61; +float(float val) sqrt = #62; +float(float a, float b) pow = #97; +//description: +//useful math functions, sine of val, cosine of val, square root of val, and raise a to power b, respectively. + +//DP_QC_SPRINTF +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +string(string format, ...) sprintf = #627; +//description: +//you know sprintf :P +//supported stuff: +// % +// optional: $ for the argument to format (the arg counter then is not increased) +// flags: #0- + +// optional: , *, or *$ for the field width (width is read before value and precision) +// optional: ., .*, or .*$ for the precision (precision is read before value) +// length modifiers: h for forcing a float, l for forcing an entity (by default, %d etc. cast a float to int), ll for forcing an int +// conversions: +// d takes a float if no length is specified or h is, and an entity if l is specified as length, and an int if ll is specified as length, and cast it to an int +// i takes an entity if no length is specified or l is, and a float if h is specified as length, and an int if ll is specified as length, and cast it to an int +// ouxXc take a float if no length is specified or h is, and an entity if l is specified as length, and an int if ll is specified as length, and cast it to an unsigned int +// eEfFgG take a float if no length is specified or h is, and an entity if l is specified as length, and an int if ll is specified as length, and cast it to a double +// s takes a string +// vV takes a vector, and processes the three components as if it were a gG for all three components, separated by space +// For conversions s and c, the flag # makes precision and width interpreted +// as byte count, by default it is interpreted as character count in UTF-8 +// enabled engines. No other conversions can create wide characters, and # +// has another meaning in these. When in character count mode, color codes +// are ignored. To get UTF-8 semantics WITHOUT color code parsing, use +// the + flag. + +//DP_QC_STRFTIME +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +string(float uselocaltime, string format, ...) strftime = #478; +//description: +//provides the ability to get the local (in your timezone) or world (Universal Coordinated Time) time as a string using the formatting of your choice: +//example: "%Y-%m-%d %H:%M:%S" (result looks like: 2007-02-08 01:03:15) +//note: "%F %T" gives the same result as "%Y-%m-%d %H:%M:%S" (ISO 8601 date format and 24-hour time) +//for more format codes please do a web search for strftime 3 and you should find the man(3) pages for this standard C function. +// +//practical uses: +//changing day/night cycle (shops closing, monsters going on the prowl) in an RPG, for this you probably want to use s = strftime(TRUE, "%H");hour = stof(s); +//printing current date/time for competitive multiplayer games, such as the beginning/end of each round in real world time. +//activating eastereggs in singleplayer games on certain dates. +// +//note: some codes such as %x and %X use your locale settings and thus may not make sense to international users, it is not advisable to use these as the server and clients may be in different countries. +//note: if you display local time to a player, it would be a good idea to note whether it is local time using a string like "%F %T (local)", and otherwise use "%F %T (UTC)". +//note: be aware that if the game is saved and reloaded a week later the date and time will be different, so if activating eastereggs in a singleplayer game or something you may want to only check when a level is loaded and then keep the same easteregg state throughout the level so that the easteregg does not deactivate when reloading from a savegame (also be aware that precaches should not depend on such date/time code because reloading a savegame often scrambles the precaches if so!). +//note: this function can return a NULL string (you can check for it with if (!s)) if the localtime/gmtime functions returned NULL in the engine code, such as if those functions don't work on this platform (consoles perhaps?), so be aware that this may return nothing. + +//DP_QC_STRINGCOLORFUNCTIONS +//idea: Dresk +//darkplaces implementation: Dresk +//builtin definitions: +float(string s) strlennocol = #476; // returns how many characters are in a string, minus color codes +string(string s) strdecolorize = #477; // returns a string minus the color codes of the string provided +//description: +//provides additional functionality to strings by supporting functions that isolate and identify strings with color codes + +//DP_QC_STRING_CASE_FUNCTIONS +//idea: Dresk +//darkplaces implementation: LordHavoc / Dresk +//builtin definitions: +string(string s) strtolower = #480; // returns the passed in string in pure lowercase form +string(string s) strtoupper = #481; // returns the passed in string in pure uppercase form +//description: +//provides simple string uppercase and lowercase functions + +//DP_QC_TOKENIZEBYSEPARATOR +//idea: Electro, SavageX, LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +float(string s, string separator1, ...) tokenizebyseparator = #479; +//description: +//this function returns tokens separated by any of the supplied separator strings, example: +//numnumbers = tokenizebyseparator("10.2.3.4", "."); +//returns 4 and the tokens are "10" "2" "3" "4" +//possibly useful for parsing IPv4 addresses (such as "1.2.3.4") and IPv6 addresses (such as "[1234:5678:9abc:def0:1234:5678:9abc:def0]:26000") + +//DP_QC_TOKENIZE_CONSOLE +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +float(string s) tokenize_console = #514; +float(float i) argv_start_index = #515; +float(float i) argv_end_index = #516; +//description: +//this function returns tokens separated just like the console does +//also, functions are provided to get the index of the first and last character of each token in the original string +//Passing negative values to them, or to argv, will be treated as indexes from the LAST token (like lists work in Perl). So argv(-1) will return the LAST token. + +//DP_QC_TRACEBOX +//idea: id Software +//darkplaces implementation: id Software +//builtin definitions: +void(vector v1, vector min, vector max, vector v2, float nomonsters, entity forent) tracebox = #90; +//description: +//similar to traceline but much more useful, traces a box of the size specified (technical note: in quake1 and halflife bsp maps the mins and maxs will be rounded up to one of the hull sizes, quake3 bsp does not have this problem, this is the case with normal moving entities as well). + +//DP_QC_TRACETOSS +//idea: id Software +//darkplaces implementation: id Software +//builtin definitions: +void(entity ent, entity ignore) tracetoss = #64; +//description: +//simulates movement of the entity as if it is MOVETYPE_TOSS and starting with it's current state (location, velocity, etc), returns relevant trace_ variables (trace_fraction is always 0, all other values are supported - trace_ent, trace_endpos, trace_plane_normal), does not actually alter the entity. + +//DP_QC_TRACE_MOVETYPE_HITMODEL +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//constant definitions: +float MOVE_HITMODEL = 4; +//description: +//allows traces to hit alias models (not sprites!) instead of entity boxes, use as the nomonsters parameter to trace functions, note that you can hit invisible model entities (alpha < 0 or EF_NODRAW or model "", it only checks modelindex) + +//DP_QC_TRACE_MOVETYPE_WORLDONLY +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//constant definitions: +float MOVE_WORLDONLY = 3; +//description: +//allows traces to hit only world (ignoring all entities, unlike MOVE_NOMONSTERS which hits all bmodels), use as the nomonsters parameter to trace functions + +//DP_QC_UNLIMITEDTEMPSTRINGS +//idea: divVerent +//darkplaces implementation: LordHavoc +//description: +//this extension alters Quake behavior such that instead of reusing a single +//tempstring (or multiple) there are an unlimited number of tempstrings, which +//are removed only when a QC function invoked by the engine returns, +//eliminating almost all imaginable concerns with string handling in QuakeC. +// +//in short: +//you can now use and abuse tempstrings as much as you like, you still have to +//use strzone (FRIK_FILE) for permanent storage however. +// +// +// +//implementation notes for other engine coders: +//these tempstrings are expected to be stored in a contiguous buffer in memory +//which may be fixed size or controlled by a cvar, or automatically grown on +//demand (in the case of DarkPlaces). +// +//this concept is similar to quake's Zone system, however these are all freed +//when the QC interpreter returns. +// +//this is basically a poor man's garbage collection system for strings. + +//DP_QC_VECTOANGLES_WITH_ROLL +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +vector(vector forward, vector up) vectoangles2 = #51; // same number as vectoangles +//description: +//variant of vectoangles that takes an up vector to calculate roll angle (also uses this to calculate yaw correctly if the forward is straight up or straight down) +//note: just like normal vectoangles you need to negate the pitch of the returned angles if you want to feed them to makevectors or assign to self.v_angle + +//DP_QC_VECTORVECTORS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector dir) vectorvectors = #432; +//description: +//creates v_forward, v_right, and v_up vectors given a forward vector, similar to makevectors except it takes a forward direction vector instead of angles. + +//DP_QC_WHICHPACK +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +string(string filename) whichpack = #503; +//description: +//for files in a pak/pk3/whatever, returns the pack's file name in FRIK_FILE name space. +//for physical files, returns "". +//in case of error, returns string_null. + +//DP_QC_URI_ESCAPE +//idea: divVerent +//darkplaces implementation: divVerent +//URI::Escape's functionality +string(string in) uri_escape = #510; +string(string in) uri_unescape = #511; + +//DP_QC_URI_GET +//idea: divVerent +//darkplaces implementation: divVerent +//loads text from an URL into a string +//returns 1 on success of initiation, 0 if there are too many concurrent +//connections already or if the URL is invalid +//the following callback will receive the data and MUST exist! +// void(float id, float status, string data) URI_Get_Callback; +//status is either +// negative for an internal error, +// 0 for success, or +// the HTTP response code on server error (e.g. 404) +//if 1 is returned by uri_get, the callback will be called in the future +float(string url, float id) uri_get = #513; + +//DP_QC_URI_POST +//idea: divVerent +//darkplaces implementation: divVerent +//loads text from an URL into a string after POSTing via HTTP +//works like uri_get, but uri_post sends data with Content-Type: content_type to the server +//and uri_post sends the string buffer buf, joined using the delimiter delim +float(string url, float id, string content_type, string data) uri_post = #513; +float(string url, float id, string content_type, string delim, float buf) uri_postbuf = #513; + +//DP_SKELETONOBJECTS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//this extension indicates that FTE_CSQC_SKELETONOBJECTS functionality is available in server QC (as well as CSQC). + +//DP_SV_SPAWNFUNC_PREFIX +//idea: divVerent +//darkplaces implementation: divVerent +//Make functions whose name start with spawnfunc_ take precedence as spawn function for loading entities. +//Useful if you have a field ammo_shells (required in any Quake mod) but want to support spawn functions called ammo_shells (like in Q3A). +//Optionally, you can declare a global "float require_spawnfunc_prefix;" which will require ANY spawn function to start with that prefix. + + +//DP_QUAKE2_MODEL +//idea: quake community +//darkplaces implementation: LordHavoc +//description: +//shows that the engine supports Quake2 .md2 files. + +//DP_QUAKE2_SPRITE +//idea: LordHavoc +//darkplaces implementation: Elric +//description: +//shows that the engine supports Quake2 .sp2 files. + +//DP_QUAKE3_MAP +//idea: quake community +//darkplaces implementation: LordHavoc +//description: +//shows that the engine supports Quake3 .bsp files. + +//DP_QUAKE3_MODEL +//idea: quake community +//darkplaces implementation: LordHavoc +//description: +//shows that the engine supports Quake3 .md3 files. + +//DP_REGISTERCVAR +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +float(string name, string value) registercvar = #93; +//description: +//adds a new console cvar to the server console (in singleplayer this is the player's console), the cvar exists until the mod is unloaded or the game quits. +//NOTE: DP_CON_SET is much better. + +//DP_SND_DIRECTIONLESSATTNNONE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//make sounds with ATTN_NONE have no spatialization (enabling easy use as music sources). + +//DP_SND_FAKETRACKS +//idea: requested + +//darkplaces implementation: Elric +//description: +//the engine plays sound/cdtracks/track001.wav instead of cd track 1 and so on if found, this allows games and mods to have music tracks without using ambientsound. +//Note: also plays .ogg with DP_SND_OGGVORBIS extension. + +//DP_SND_SOUND7_WIP1 +//DP_SND_SOUND7_WIP2 +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +void(entity e, float chan, string samp, float vol, float atten, float speed, float flags) sound7 = #8; +float SOUNDFLAG_RELIABLE = 1; +//description: +//plays a sound, with some more flags +//extensions to sound(): +//- channel may be in the range from -128 to 127; channels -128 to 0 are "auto", +// i.e. support multiple sounds at once, but cannot be stopped/restarted +//- a value 0 in the speed parameter means no change; otherwise, it is a +// percentage of playback speed ("pitch shifting"). 100 is normal pitch, 50 is +// half speed, 200 is double speed, etc. (DP_SND_SOUND7_WIP2) +//- the flag SOUNDFLAG_RELIABLE can be specified, which makes the sound send +// to MSG_ALL (reliable) instead of MSG_BROADCAST (unreliable, default); +// similarily, SOUNDFLAG_RELIABLE_TO_ONE sends to MSG_ONE +//- channel 0 is controlled by snd_channel0volume; channel 1 and -1 by +// snd_channel1volume, etc. (so, a channel shares the cvar with its respective +// auto-channel); however, the mod MUST define snd_channel8volume and upwards +// in default.cfg if they are to be used, as the engine does not create them +// to not litter the cvar list +//- this extension applies to CSQC as well; CSQC_Event_Sound will get speed and +// flags as extra 7th and 8th argument +//- WIP2 ideas: SOUNDFLAG_RELIABLE_TO_ONE, SOUNDFLAG_NOPHS, SOUNDFLAG_FORCELOOP +//- NOTE: to check for this, ALSO OR a check with DP_SND_SOUND7 to also support +// the finished extension once done + +//DP_SND_OGGVORBIS +//idea: Transfusion +//darkplaces implementation: Elric +//description: +//the engine supports loading Ogg Vorbis sound files. Use either the .ogg filename directly, or a .wav of the same name (will try to load the .wav first and then .ogg). + +//DP_SND_STEREOWAV +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//the engine supports stereo WAV files. (useful with DP_SND_DIRECTIONLESSATTNNONE for music) + +//DP_SND_GETSOUNDTIME +//idea: VorteX +//darkplaces implementation: VorteX +//constant definitions: +float(entity e, float channel) getsoundtime = #533; // get currently sound playing position on entity channel, -1 if not playing or error +float(string sample) soundlength = #534; // returns length of sound sample in seconds, -1 on error (sound not precached, sound system not initialized etc.) +//description: provides opportunity to query length of sound samples and realtime tracking of sound playing on entities (similar to DP_GETTIME_CDTRACK) +//note: beware dedicated server not running sound engine at all, so in dedicated mode this builtins will not work in server progs +//note also: menu progs not supporting getsoundtime() (will give a warning) since it has no sound playing on entities +//examples of use: +// - QC-driven looped sounds +// - QC events when sound playing is finished +// - toggleable ambientsounds +// - subtitles + +//DP_VIDEO_DPV +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//console commands: +// playvideo - start playing video +// stopvideo - stops current video +//description: indicated that engine support playing videos in DPV format + +//DP_VIDEO_SUBTITLES +//idea: VorteX +//darkplaces implementation: VorteX +//cvars: +// cl_video_subtitles - toggles subtitles showing +// cl_video_subtitles_lines - how many lines to reserve for subtitles +// cl_video_subtitles_textsize - font size +//console commands: +// playvideo - start playing video +// stopvideo - stops current video +//description: indicates that engine support subtitles on videos +//subtitles stored in external text files, each video file has it's default subtitles file ( .dpsubs ) +//example: for video/act1.dpv default subtitles file will be video/act1.dpsubs +//also video could be played with custom subtitles file by utilizing second parm of playvideo command +//syntax of .dpsubs files: each line in .dpsubs file defines 1 subtitle, there are three tokens: +// "string" +// start: subtitle start time in seconds +// end: subtitle time-to-show in seconds, if 0 - subtitle will be showed until next subtitle is started, +// if below 0 - show until next subtitles minus this number of seconds +// text: subtitle text, color codes (Q3-style and ^xRGB) are allowed +//example of subtitle file: +// 3 0 "Vengeance! Vengeance for my eternity of suffering!" +// 9 0 "Whelp! As if you knew what eternity was!" +// 13 0 "Grovel before your true master." +// 17 0 "Never!" +// 18 7 "I'll hack you from crotch to gizzard and feed what's left of you to your brides..." + +//DP_SOLIDCORPSE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//solid definitions: +float SOLID_CORPSE = 5; +//description: +//the entity will not collide with SOLID_CORPSE and SOLID_SLIDEBOX entities (and likewise they will not collide with it), this is useful if you want dead bodies that are shootable but do not obstruct movement by players and monsters, note that if you traceline with a SOLID_SLIDEBOX entity as the ignoreent, it will ignore SOLID_CORPSE entities, this is desirable for visibility and movement traces, but not for bullets, for the traceline to hit SOLID_CORPSE you must temporarily force the player (or whatever) to SOLID_BBOX and then restore to SOLID_SLIDEBOX after the traceline. + +//DP_SPRITE32 +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//the engine supports .spr32 sprites. + +//DP_SV_BOTCLIENT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//constants: +float CLIENTTYPE_DISCONNECTED = 0; +float CLIENTTYPE_REAL = 1; +float CLIENTTYPE_BOT = 2; +float CLIENTTYPE_NOTACLIENT = 3; +//builtin definitions: +entity() spawnclient = #454; // like spawn but for client slots (also calls relevant connect/spawn functions), returns world if no clients available +float(entity clent) clienttype = #455; // returns one of the CLIENTTYPE_* constants +//description: +//spawns a client with no network connection, to allow bots to use client slots with no hacks. +//How to use: +/* + // to spawn a bot + local entity oldself; + oldself = self; + self = spawnclient(); + if (!self) + { + bprint("Can not add bot, server full.\n"); + self = oldself; + return; + } + self.netname = "Yoyobot"; + self.clientcolors = 12 * 16 + 4; // yellow (12) shirt and red (4) pants + ClientConnect(); + PutClientInServer(); + self = oldself; + + // to remove all bots + local entity head; + head = find(world, classname, "player"); + while (head) + { + if (clienttype(head) == CLIENTTYPE_BOT) + dropclient(head); + head = find(head, classname, "player"); + } + + // to identify if a client is a bot (for example in PlayerPreThink) + if (clienttype(self) == CLIENTTYPE_BOT) + botthink(); +*/ +//see also DP_SV_CLIENTCOLORS DP_SV_CLIENTNAME DP_SV_DROPCLIENT +//How it works: +//creates a new client, calls SetNewParms and stores the parms, and returns the client. +//this intentionally does not call SV_SendServerinfo to allow the QuakeC a chance to set the netname and clientcolors fields before actually spawning the bot by calling ClientConnect and PutClientInServer manually +//on level change ClientConnect and PutClientInServer are called by the engine to spawn in the bot (this is why clienttype() exists to tell you on the next level what type of client this is). +//parms work the same on bot clients as they do on real clients, and do carry from level to level + +//DP_SV_BOUNCEFACTOR +//idea: divVerent +//darkplaces implementation: divVerent +//field definitions: +.float bouncefactor; // velocity multiplier after a bounce +.float bouncestop; // bounce stops if velocity to bounce plane is < bouncestop * gravity AFTER the bounce +//description: +//allows qc to customize MOVETYPE_BOUNCE a bit + +//DP_SV_CLIENTCAMERA +//idea: LordHavoc, others +//darkplaces implementation: Black +//field definitions: +.entity clientcamera; // override camera entity +//description: +//allows another entity to be the camera for a client, for example a remote camera, this is similar to sending svc_setview manually except that it also changes the network culling appropriately. + +//DP_SV_CLIENTCOLORS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float clientcolors; // colors of the client (format: pants + shirt * 16) +//description: +//allows qc to read and modify the client colors associated with a client entity (not particularly useful on other entities), and automatically sends out any appropriate network updates if changed + +//DP_SV_CLIENTNAME +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//description: +//allows qc to modify the client's .netname, and automatically sends out any appropriate network updates if changed + +//DP_SV_CUSTOMIZEENTITYFORCLIENT +//idea: LordHavoc +//darkplaces implementation: [515] and LordHavoc +//field definitions: +.float() customizeentityforclient; // self = this entity, other = client entity +//description: +//allows qc to modify an entity before it is sent to each client, the function returns TRUE if it should send, FALSE if it should not, and is fully capable of editing the entity's fields, this allows cloaked players to appear less transparent to their teammates, navigation markers to only show to their team, etc +//tips on writing customize functions: +//it is a good idea to return FALSE early in the function if possible to reduce cpu usage, because this function may be called many thousands of times per frame if there are many customized entities on a 64+ player server. +//you are free to change anything in self, but please do not change any other entities (the results may be very inconsistent). +//example ideas for use of this extension: +//making icons over teammates' heads which are only visible to teammates. for exasmple: float() playericon_customizeentityforclient = {return self.owner.team == other.team;}; +//making cloaked players more visible to their teammates than their enemies. for example: float() player_customizeentityforclient = {if (self.items & IT_CLOAKING) {if (self.team == other.team) self.alpha = 0.6;else self.alpha = 0.1;} return TRUE;}; +//making explosion models that face the viewer (does not work well with chase_active). for example: float() explosion_customizeentityforclient = {self.angles = vectoangles(other.origin + other.view_ofs - self.origin);self.angles_x = 0 - self.angles_x;}; +//implementation notes: +//entity customization is done before per-client culling (visibility for instance) because the entity may be doing setorigin to display itself in different locations on different clients, may be altering its .modelindex, .effects and other fields important to culling, so customized entities increase cpu usage (non-customized entities can use all the early culling they want however, as they are not changing on a per client basis). + +//DP_SV_DISCARDABLEDEMO +//idea: parasti +//darkplaces implementation: parasti +//field definitions: +.float discardabledemo; +//description: +//when this field is set to a non-zero value on a player entity, a possibly recorded server-side demo for the player is discarded +//Note that this extension only works if: +// auto demos are enabled (the cvar sv_autodemo_perclient is set) +// discarding demos is enabled (the cvar sv_autodemo_perclient_discardable is set) + +//DP_SV_DRAWONLYTOCLIENT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.entity drawonlytoclient; +//description: +//the entity is only visible to the specified client. + +//DP_SV_DROPCLIENT +//idea: FrikaC +//darkplaces implementation: LordHavoc +//builtin definitions: +void(entity clent) dropclient = #453; +//description: +//causes the server to immediately drop the client, more reliable than stuffcmd(clent, "disconnect\n"); which could be intentionally ignored by the client engine + +//DP_SV_EFFECT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org, string modelname, float startframe, float endframe, float framerate) effect = #404; +//SVC definitions: +//float svc_effect = #52; // [vector] org [byte] modelindex [byte] startframe [byte] framecount [byte] framerate +//float svc_effect2 = #53; // [vector] org [short] modelindex [byte] startframe [byte] framecount [byte] framerate +//description: +//clientside playback of simple custom sprite effects (explosion sprites, etc). + +//DP_SV_ENTITYCONTENTSTRANSITION +//idea: Dresk +//darkplaces implementation: Dresk +//field definitions: +.void(float nOriginalContents, float nNewContents) contentstransition; +//description: +//This field function, when provided, is triggered on an entity when the contents (ie. liquid / water / etc) is changed. +//The first parameter provides the entities original contents, prior to the transition. The second parameter provides the new contents. +//NOTE: If this field function is provided on an entity, the standard watersplash sound IS SUPPRESSED to allow for authors to create their own transition sounds. + +//DP_SV_MOVETYPESTEP_LANDEVENT +//idea: Dresk +//darkplaces implementation: Dresk +//field definitions: +.void(vector vImpactVelocity) movetypesteplandevent; +//description: +//This field function, when provided, is triggered on a MOVETYPE_STEP entity when it experiences "land event". +// The standard engine behavior for this event is to play the sv_sound_land CVar sound. +//The parameter provides the velocity of the entity at the time of the impact. The z value may therefore be used to calculate how "hard" the entity struck the surface. +//NOTE: If this field function is provided on a MOVETYPE_STEP entity, the standard sv_sound_land sound IS SUPPRESSED to allow for authors to create their own feedback. + +//DP_SV_POINTSOUND +//idea: Dresk +//darkplaces implementation: Dresk +//builtin definitions: +void(vector origin, string sample, float volume, float attenuation) pointsound = #483; +//description: +//Similar to the standard QC sound function, this function takes an origin instead of an entity and omits the channel parameter. +// This allows sounds to be played at arbitrary origins without spawning entities. + +//DP_SV_ONENTITYNOSPAWNFUNCTION +//idea: Dresk +//darkplaces implementation: Dresk +//engine-called QC prototypes: +//void() SV_OnEntityNoSpawnFunction; +//description: +// This function is called whenever an entity on the server has no spawn function, and therefore has no defined QC behavior. +// You may as such dictate the behavior as to what happens to the entity. +// To mimic the engine's default behavior, simply call remove(self). + +//DP_SV_ONENTITYPREPOSTSPAWNFUNCTION +//idea: divVerent +//darkplaces implementation: divVerent +//engine-called QC prototypes: +//void() SV_OnEntityPreSpawnFunction; +//void() SV_OnEntityPostSpawnFunction; +//description: +// These functions are called BEFORE or AFTER an entity is spawned the regular way. +// You may as such dictate the behavior as to what happens to the entity. +// SV_OnEntityPreSpawnFunction is called before even looking for the spawn function, so you can even change its classname in there. If it remove()s the entity, the spawn function will not be looked for. +// SV_OnEntityPostSpawnFunction is called ONLY after its spawn function or SV_OnEntityNoSpawnFunction was called, and skipped if the entity got removed by either. + +//DP_SV_MODELFLAGS_AS_EFFECTS +//idea: LordHavoc, Dresk +//darkplaces implementation: LordHavoc +//field definitions: +.float modelflags; +//constant definitions: +float EF_NOMODELFLAGS = 8388608; // ignore any effects in a model file and substitute your own +float MF_ROCKET = 1; // leave a trail +float MF_GRENADE = 2; // leave a trail +float MF_GIB = 4; // leave a trail +float MF_ROTATE = 8; // rotate (bonus items) +float MF_TRACER = 16; // green split trail +float MF_ZOMGIB = 32; // small blood trail +float MF_TRACER2 = 64; // orange split trail +float MF_TRACER3 = 128; // purple trail +//description: +//this extension allows model flags to be specified on entities so you can add a rocket trail and glow to any entity, etc. +//setting any of these will override the flags the model already has, to disable the model's flags without supplying any of your own you must use EF_NOMODELFLAGS. +// +//silly example modification #1 to W_FireRocket in weapons.qc: +//missile.effects = EF_NOMODELFLAGS; // rocket without a glow/fire trail +//silly example modification #2 to W_FireRocket in weapons.qc: +//missile.modelflags = MF_GIB; // leave a blood trail instead of glow/fire trail +// +//note: you can not combine multiple kinds of trail, only one of them will be active, you can combine MF_ROTATE and the other MF_ flags however, and using EF_NOMODELFLAGS along with these does no harm. +// +//note to engine coders: they are internally encoded in the protocol as extra EF_ flags (shift the values left 24 bits and send them in the protocol that way), so no protocol change was required (however 32bit effects is a protocol extension itself), within the engine they are referred to as EF_ for the 24bit shifted values. + +//DP_SV_NETADDRESS +//idea: Dresk +//darkplaces implementation: Dresk +//field definitions: +.string netaddress; +//description: +// provides the netaddress of the associated entity (ie. 127.0.0.1) and "null/botclient" if the netconnection of the entity is invalid + +//DP_SV_NODRAWTOCLIENT +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.entity nodrawtoclient; +//description: +//the entity is not visible to the specified client. + +//DP_SV_PING +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float ping; +//description: +//continuously updated field indicating client's ping (based on average of last 16 packet time differences). + +//DP_SV_PING_PACKETLOSS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float ping_packetloss; +.float ping_movementloss; +//description: +//continuously updated field indicating client's packet loss, and movement loss (i.e. packet loss affecting player movement). + +//DP_SV_POINTPARTICLES +//idea: Spike +//darkplaces implementation: LordHavoc +//function definitions: +float(string effectname) particleeffectnum = #335; // same as in CSQC +void(entity ent, float effectnum, vector start, vector end) trailparticles = #336; // same as in CSQC +void(float effectnum, vector org, vector vel, float howmany) pointparticles = #337; // same as in CSQC +//SVC definitions: +//float svc_trailparticles = 60; // [short] entnum [short] effectnum [vector] start [vector] end +//float svc_pointparticles = 61; // [short] effectnum [vector] start [vector] velocity [short] count +//float svc_pointparticles1 = 62; // [short] effectnum [vector] start, same as svc_pointparticles except velocity is zero and count is 1 +//description: +//provides the ability to spawn non-standard particle effects, typically these are defined in a particle effect information file such as effectinfo.txt in darkplaces. +//this is a port of particle effect features from clientside QC (EXT_CSQC) to server QC, as these effects are potentially useful to all games even if they do not make use of EXT_CSQC. +//warning: server must have same order of effects in effectinfo.txt as client does or the numbers would not match up, except for standard quake effects which are always the same numbers. + +//DP_SV_PUNCHVECTOR +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.vector punchvector; +//description: +//offsets client view in worldspace, similar to view_ofs but all 3 components are used and are sent with at least 8 bits of fraction, this allows the view to be kicked around by damage or hard landings or whatever else, note that unlike punchangle this is not faded over time, it is up to the mod to fade it (see also DP_SV_PLAYERPHYSICS). + +//DP_SV_PLAYERPHYSICS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.vector movement; +//cvar definitions: +//"sv_playerphysicsqc" (0/1, default 1, allows user to disable qc player physics) +//engine-called QC prototypes: +//void() SV_PlayerPhysics; +//description: +//.movement vector contains the movement input from the player, allowing QC to do as it wishs with the input, and SV_PlayerPhysics will completely replace the player physics if present (works for all MOVETYPE's), see darkplaces mod source for example of this function (in playermovement.qc, adds HalfLife ladders support, as well as acceleration/deceleration while airborn (rather than the quake sudden-stop while airborn), and simplifies the physics a bit) + +//DP_PHYSICS_ODE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//globals: +//new movetypes: +const float MOVETYPE_PHYSICS = 32; // need to be set before any physics_* builtins applied +//new solid types (deprecated): +const float SOLID_PHYSICS_BOX = 32; +const float SOLID_PHYSICS_SPHERE = 33; +const float SOLID_PHYSICS_CAPSULE = 34; +const float SOLID_PHYSICS_TRIMESH = 35; +const float SOLID_PHYSICS_CYLINDER = 36; +//geometry types: +const float GEOMTYPE_NONE = -1; // entity will be entirely skipped by ODE +const float GEOMTYPE_SOLID = 0; // geometry type will be set based on .solid field +const float GEOMTYPE_BOX = 1; // entity bound box +const float GEOMTYPE_SPHERE = 2; // sphere with radius picked from x axis of entity bound box +const float GEOMTYPE_CAPSULE = 3; // with leading axis automatically determined from longest one, radius is picked as minimal of the rest 2 axes +const float GEOMTYPE_TRIMESH = 4; // triangle mesh +const float GEOMTYPE_CYLINDER = 5; // like capsule but not capped + // note that ODE's builtin cylinder support is experimental, somewhat bugged and unfinished (no cylinder-cylinder collision) + // to use properly working cylinder should build ODE with LIBCCD extension +const float GEOMTYPE_CAPSULE_X = 6; // capsule with fixed leading axis +const float GEOMTYPE_CAPSULE_Y = 7; +const float GEOMTYPE_CAPSULE_Z = 8; +const float GEOMTYPE_CYLINDER_X = 9; // cylinder with fixed leading axis +const float GEOMTYPE_CYLINDER_Y = 10; +const float GEOMTYPE_CYLINDER_Z = 11; +//joint types: +const float JOINTTYPE_NONE = 0; +const float JOINTTYPE_POINT = 1; +const float JOINTTYPE_HINGE = 2; +const float JOINTTYPE_SLIDER = 3; +const float JOINTTYPE_UNIVERSAL = 4; +const float JOINTTYPE_HINGE2 = 5; +const float JOINTTYPE_FIXED = -1; +//force types: +const float FORCETYPE_NONE = 0; +const float FORCETYPE_FORCE = 1; // applied at center of mass +const float FORCETYPE_FORCEATPOS = 2; +const float FORCETYPE_TORQUE = 3; +// common joint properties: +// .entity aiment; // connected objects +// .entity enemy; // connected objects, forces +// .vector movedir; +// for a spring: +// movedir_x = spring constant (force multiplier, must be > 0) +// movedir_y = spring dampening constant to prevent oscillation (must be > 0) +// movedir_z = spring stop position (+/-) +// for a motor: +// movedir_x = desired motor velocity +// movedir_y = -1 * max motor force to use +// movedir_z = stop position (+/-), set to 0 for no stop +// note that ODE does not support both in one anyway +// for a force: +// force vector to apply +//field definitions: +.float geomtype; // see GEOMTYPE_*, a more correct way to set collision shape, allows to set SOLID_CORPSE and trimesh collisions +.float maxcontacts; // maximum number of contacts to make for this object, lesser = faster (but setting it too low will could make object pass though walls), default is 16, maximum is 32 +.float mass; // ODE mass, standart value is 1 +.vector massofs; // offsets a mass center out of object center, if not set a center of model bounds is used +.float friction; // a friction of object, get multiplied by second objects's friction on contact +.float bouncefactor; +.float bouncestop; +.float jointtype; // type of joint +.float forcetype; // type of force +.float erp; // error restitution parameter, makes ODE solver attempt to fix errors in contacts, + // bringing together 2 joints or fixing object being stuch in other object, + // a value of 0.1 will fix slightly, a value of 1.0 attempts to fix whole error in one frame + // use with care as high values makes system unstable and likely to explode +//builtin definitions: +void(entity e, float physics_enabled) physics_enable = #540; // enable or disable physics on object +void(entity e, vector force, vector force_pos) physics_addforce = #541; // deprecated, apply a force from certain origin, length of force vector is power of force +void(entity e, vector torque) physics_addtorque = #542; // deprecated, add relative torque +//description: provides Open Dynamics Engine support, requires extenal dll to be present or engine compiled with statical link option +//be sure to checkextension for it to know if library is loaded and ready, also to enable physics set "physics_ode" cvar to 1 +//note: this extension is highly experimental and may be unstable + +//DP_SV_PRINT +//idea: id Software (QuakeWorld Server) +//darkplaces implementation: Black, LordHavoc +void(string s, ...) print = #339; // same number as in EXT_CSQC +//description: +//this is identical to dprint except that it always prints regardless of the developer cvar. + +//DP_SV_PRECACHEANYTIME +//idea: id Software (Quake2) +//darkplaces implementation: LordHavoc +//description: +//this extension allows precache_model and precache_sound (and any variants) to be used during the game (with automatic messages to clients to precache the new model/sound indices), also setmodel/sound/ambientsound can be called without precaching first (they will cause an automatic precache). + +//DP_SV_QCSTATUS +//idea: divVerent +//darkplaces implementation: divVerent +//1. A global variable +string worldstatus; +//Its content is set as "qcstatus" field in the rules. +//It may be at most 255 characters, and must not contain newlines or backslashes. +//2. A per-client field +.string clientstatus; +//It is sent instead of the "frags" in status responses. +//It should always be set in a way so that stof(player.clientstatus) is a meaningful score value. Other info may be appended. If used this way, the cvar sv_status_use_qcstatus may be set to 1, and then this value will replace the frags in "status". +//Currently, qstat does not support this and will not show player info if used and set to anything other than ftos(some integer). + +//DP_SV_ROTATINGBMODEL +//idea: id Software +//darkplaces implementation: LordHavoc +//description: +//this extension merely indicates that MOVETYPE_PUSH supports avelocity, allowing rotating brush models to be created, they rotate around their origin (needs rotation supporting qbsp/light utilities because id ones expected bmodel entity origins to be '0 0 0', recommend setting "origin" key in the entity fields in the map before compiling, there may be other methods depending on your qbsp, most are more complicated however). +//tip: level designers can create a func_wall with an origin, and avelocity (for example "avelocity" "0 90 0"), and "nextthink" "99999999" to make a rotating bmodel without any qc modifications, such entities will be solid in stock quake but will not rotate) + +//DP_SV_SETCOLOR +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(entity ent, float colors) setcolor = #401; +//engine called QC functions (optional): +//void(float color) SV_ChangeTeam; +//description: +//setcolor sets the color on a client and updates internal color information accordingly (equivalent to stuffing a "color" command but immediate) +//SV_ChangeTeam is called by the engine whenever a "color" command is recieved, it may decide to do anything it pleases with the color passed by the client, including rejecting it (by doing nothing), or calling setcolor to apply it, preventing team changes is one use for this. +//the color format is pants + shirt * 16 (0-255 potentially) + +//DP_SV_SLOWMO +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//cvars: +//"slowmo" (0+, default 1) +//description: +//sets the time scale of the server, mainly intended for use in singleplayer by the player, however potentially useful for mods, so here's an extension for it. +//range is 0 to infinite, recommended values to try are 0.1 (very slow, 10% speed), 1 (normal speed), 5 (500% speed). + +//DP_SV_WRITEPICTURE +//idea: divVerent +//darkplaces implementation: divVerent +//builtin definitions: +void(float to, string s, float sz) WritePicture = #501; +//description: +//writes a picture to the data stream so CSQC can read it using ReadPicture, which has the definition +// string(void) ReadPicture = #501; +//The picture data is sent as at most sz bytes, by compressing to low quality +//JPEG. The data being sent will be equivalent to: +// WriteString(to, s); +// WriteShort(to, imagesize); +// for(i = 0; i < imagesize; ++i) +// WriteByte(to, [the i-th byte of the compressed JPEG image]); + +//DP_SV_WRITEUNTERMINATEDSTRING +//idea: FrikaC +//darkplaces implementation: Sajt +//builtin definitions: +void(float to, string s) WriteUnterminatedString = #456; +//description: +//like WriteString, but does not write a terminating 0 after the string. This means you can include things like a player's netname in the middle of a string sent over the network. Just be sure to end it up with either a call to WriteString (which includes the trailing 0) or WriteByte(0) to terminate it yourself. +//A historical note: this extension was suggested by FrikaC years ago, more recently Shadowalker has been badmouthing LordHavoc and Spike for stealing 'his' extension writestring2 which does exactly the same thing but uses a different builtin number and name and extension string, this argument hinges on the idea that it was his idea in the first place, which is incorrect as FrikaC first suggested it and used a rough equivalent of it in his FrikBot mod years ago involving WriteByte calls on each character. + +//DP_TE_BLOOD +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org, vector velocity, float howmany) te_blood = #405; +//temp entity definitions: +float TE_BLOOD = 50; +//protocol: +//vector origin +//byte xvelocity (-128 to +127) +//byte yvelocity (-128 to +127) +//byte zvelocity (-128 to +127) +//byte count (0 to 255, how much blood) +//description: +//creates a blood effect. + +//DP_TE_BLOODSHOWER +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector mincorner, vector maxcorner, float explosionspeed, float howmany) te_bloodshower = #406; +//temp entity definitions: +//float TE_BLOODSHOWER = 52; +//protocol: +//vector mins (minimum corner of the cube) +//vector maxs (maximum corner of the cube) +//coord explosionspeed (velocity of blood particles flying out of the center) +//short count (number of blood particles) +//description: +//creates an exploding shower of blood, for making gibbings more convincing. + +//DP_TE_CUSTOMFLASH +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org, float radius, float lifetime, vector color) te_customflash = #417; +//temp entity definitions: +//float TE_CUSTOMFLASH = 73; +//protocol: +//vector origin +//byte radius ((MSG_ReadByte() + 1) * 8, meaning 8-2048 unit radius) +//byte lifetime ((MSG_ReadByte() + 1) / 256.0, meaning approximately 0-1 second lifetime) +//byte red (0.0 to 1.0 converted to 0-255) +//byte green (0.0 to 1.0 converted to 0-255) +//byte blue (0.0 to 1.0 converted to 0-255) +//description: +//creates a customized light flash. + +//DP_TE_EXPLOSIONRGB +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org, vector color) te_explosionrgb = #407; +//temp entity definitions: +//float TE_EXPLOSIONRGB = 53; +//protocol: +//vector origin +//byte red (0.0 to 1.0 converted to 0 to 255) +//byte green (0.0 to 1.0 converted to 0 to 255) +//byte blue (0.0 to 1.0 converted to 0 to 255) +//description: +//creates a colored explosion effect. + +//DP_TE_FLAMEJET +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org, vector vel, float howmany) te_flamejet = #457; +//temp entity definitions: +//float TE_FLAMEJET = 74; +//protocol: +//vector origin +//vector velocity +//byte count (0 to 255, how many flame particles) +//description: +//creates a single puff of flame particles. (not very useful really) + +//DP_TE_PARTICLECUBE +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector mincorner, vector maxcorner, vector vel, float howmany, float color, float gravityflag, float randomveljitter) te_particlecube = #408; +//temp entity definitions: +//float TE_PARTICLECUBE = 54; +//protocol: +//vector mins (minimum corner of the cube) +//vector maxs (maximum corner of the cube) +//vector velocity +//short count +//byte color (palette color) +//byte gravity (TRUE or FALSE, FIXME should this be a scaler instead?) +//coord randomvel (how much to jitter the velocity) +//description: +//creates a cloud of particles, useful for forcefields but quite customizable. + +//DP_TE_PARTICLERAIN +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlerain = #409; +//temp entity definitions: +//float TE_PARTICLERAIN = 55; +//protocol: +//vector mins (minimum corner of the cube) +//vector maxs (maximum corner of the cube) +//vector velocity (velocity of particles) +//short count (number of particles) +//byte color (8bit palette color) +//description: +//creates a shower of rain, the rain will appear either at the top (if falling down) or bottom (if falling up) of the cube. + +//DP_TE_PARTICLESNOW +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector mincorner, vector maxcorner, vector vel, float howmany, float color) te_particlesnow = #410; +//temp entity definitions: +//float TE_PARTICLERAIN = 56; +//protocol: +//vector mins (minimum corner of the cube) +//vector maxs (maximum corner of the cube) +//vector velocity (velocity of particles) +//short count (number of particles) +//byte color (8bit palette color) +//description: +//creates a shower of snow, the snow will appear either at the top (if falling down) or bottom (if falling up) of the cube, low velocities are advisable for convincing snow. + +//DP_TE_PLASMABURN +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org) te_plasmaburn = #433; +//temp entity definitions: +//float TE_PLASMABURN = 75; +//protocol: +//vector origin +//description: +//creates a small light flash (radius 200, time 0.2) and marks the walls. + +//DP_TE_QUADEFFECTS1 +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org) te_gunshotquad = #412; +void(vector org) te_spikequad = #413; +void(vector org) te_superspikequad = #414; +void(vector org) te_explosionquad = #415; +//temp entity definitions: +//float TE_GUNSHOTQUAD = 57; // [vector] origin +//float TE_SPIKEQUAD = 58; // [vector] origin +//float TE_SUPERSPIKEQUAD = 59; // [vector] origin +//float TE_EXPLOSIONQUAD = 70; // [vector] origin +//protocol: +//vector origin +//description: +//all of these just take a location, and are equivalent in function (but not appearance :) to the original TE_GUNSHOT, etc. + +//DP_TE_SMALLFLASH +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org) te_smallflash = #416; +//temp entity definitions: +//float TE_SMALLFLASH = 72; +//protocol: +//vector origin +//description: +//creates a small light flash (radius 200, time 0.2). + +//DP_TE_SPARK +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org, vector vel, float howmany) te_spark = #411; +//temp entity definitions: +//float TE_SPARK = 51; +//protocol: +//vector origin +//byte xvelocity (-128 to 127) +//byte yvelocity (-128 to 127) +//byte zvelocity (-128 to 127) +//byte count (number of sparks) +//description: +//creates a shower of sparks and a smoke puff. + +//DP_TE_STANDARDEFFECTBUILTINS +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +void(vector org) te_gunshot = #418; +void(vector org) te_spike = #419; +void(vector org) te_superspike = #420; +void(vector org) te_explosion = #421; +void(vector org) te_tarexplosion = #422; +void(vector org) te_wizspike = #423; +void(vector org) te_knightspike = #424; +void(vector org) te_lavasplash = #425; +void(vector org) te_teleport = #426; +void(vector org, float color, float colorlength) te_explosion2 = #427; +void(entity own, vector start, vector end) te_lightning1 = #428; +void(entity own, vector start, vector end) te_lightning2 = #429; +void(entity own, vector start, vector end) te_lightning3 = #430; +void(entity own, vector start, vector end) te_beam = #431; +//description: +//to make life easier on mod coders. + +//DP_TRACE_HITCONTENTSMASK_SURFACEINFO +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//globals: +.float dphitcontentsmask; // if non-zero on the entity passed to traceline/tracebox/tracetoss this will override the normal collidable contents rules and instead hit these contents values (for example AI can use tracelines that hit DONOTENTER if it wants to, by simply changing this field on the entity passed to traceline), this affects normal movement as well as trace calls +float trace_dpstartcontents; // DPCONTENTS_ value at start position of trace +float trace_dphitcontents; // DPCONTENTS_ value of impacted surface (not contents at impact point, just contents of the surface that was hit) +float trace_dphitq3surfaceflags; // Q3SURFACEFLAG_ value of impacted surface +string trace_dphittexturename; // texture name of impacted surface +//constants: +float DPCONTENTS_SOLID = 1; // hit a bmodel, not a bounding box +float DPCONTENTS_WATER = 2; +float DPCONTENTS_SLIME = 4; +float DPCONTENTS_LAVA = 8; +float DPCONTENTS_SKY = 16; +float DPCONTENTS_BODY = 32; // hit a bounding box, not a bmodel +float DPCONTENTS_CORPSE = 64; // hit a SOLID_CORPSE entity +float DPCONTENTS_NODROP = 128; // an area where backpacks should not spawn +float DPCONTENTS_PLAYERCLIP = 256; // blocks player movement +float DPCONTENTS_MONSTERCLIP = 512; // blocks monster movement +float DPCONTENTS_DONOTENTER = 1024; // AI hint brush +float DPCONTENTS_LIQUIDSMASK = 14; // WATER | SLIME | LAVA +float DPCONTENTS_BOTCLIP = 2048; // AI hint brush +float DPCONTENTS_OPAQUE = 4096; // only fully opaque brushes get this (may be useful for line of sight checks) +float Q3SURFACEFLAG_NODAMAGE = 1; +float Q3SURFACEFLAG_SLICK = 2; // low friction surface +float Q3SURFACEFLAG_SKY = 4; // sky surface (also has NOIMPACT and NOMARKS set) +float Q3SURFACEFLAG_LADDER = 8; // climbable surface +float Q3SURFACEFLAG_NOIMPACT = 16; // projectiles should remove themselves on impact (this is set on sky) +float Q3SURFACEFLAG_NOMARKS = 32; // projectiles should not leave marks, such as decals (this is set on sky) +float Q3SURFACEFLAG_FLESH = 64; // projectiles should do a fleshy effect (blood?) on impact +float Q3SURFACEFLAG_NODRAW = 128; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_HINT = 256; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_SKIP = 512; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_NOLIGHTMAP = 1024; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_POINTLIGHT = 2048; // compiler hint (not important to qc) +float Q3SURFACEFLAG_METALSTEPS = 4096; // walking on this surface should make metal step sounds +float Q3SURFACEFLAG_NOSTEPS = 8192; // walking on this surface should not make footstep sounds +float Q3SURFACEFLAG_NONSOLID = 16384; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_LIGHTFILTER = 32768; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_ALPHASHADOW = 65536; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_NODLIGHT = 131072; // compiler hint (not important to qc) +//float Q3SURFACEFLAG_DUST = 262144; // translucent 'light beam' effect (not important to qc) +//description: +//adds additional information after a traceline/tracebox/tracetoss call. +//also (very important) sets trace_* globals before calling .touch functions, +//this allows them to inspect the nature of the collision (for example +//determining if a projectile hit sky), clears trace_* variables for the other +//object in a touch event (that is to say, a projectile moving will see the +//trace results in its .touch function, but the player it hit will see very +//little information in the trace_ variables as it was not moving at the time) + +//DP_VIEWZOOM +//idea: LordHavoc +//darkplaces implementation: LordHavoc +//field definitions: +.float viewzoom; +//description: +//scales fov and sensitivity of player, valid range is 0 to 1 (intended for sniper rifle zooming, and such) + +//EXT_BITSHIFT +//idea: Spike +//darkplaces implementation: [515] +//builtin definitions: +float(float number, float quantity) bitshift = #218; +//description: +//multiplies number by a power of 2 corresponding to quantity (0 = *1, 1 = *2, 2 = *4, 3 = *8, -1 = /2, -2 = /4x, etc), and rounds down (due to integer math) like other bit operations do (& and | and the like). +//note: it is faster to use multiply if you are shifting by a constant, avoiding the quakec function call cost, however that does not do a floor for you. + +//FRIK_FILE +//idea: FrikaC +//darkplaces implementation: LordHavoc +//builtin definitions: +float(string s) stof = #81; // get numerical value from a string +float(string filename, float mode) fopen = #110; // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE), returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason +void(float fhandle) fclose = #111; // closes a file +string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring +void(float fhandle, string s, ...) fputs = #113; // writes a line of text to the end of the file +float(string s) strlen = #114; // returns how many characters are in a string +string(string s1, string s2, ...) strcat = #115; // concatenates two or more strings (for example "abc", "def" would return "abcdef") and returns as a tempstring +string(string s, float start, float length) substring = #116; // returns a section of a string as a tempstring - see FTE_STRINGS for enhanced version +vector(string s) stov = #117; // returns vector value from a string +string(string s, ...) strzone = #118; // makes a copy of a string into the string zone and returns it, this is often used to keep around a tempstring for longer periods of time (tempstrings are replaced often) +void(string s) strunzone = #119; // removes a copy of a string from the string zone (you can not use that string again or it may crash!!!) +//constants: +float FILE_READ = 0; +float FILE_APPEND = 1; +float FILE_WRITE = 2; +//cvars: +//pr_zone_min_strings : default 64 (64k), min 64 (64k), max 8192 (8mb) +//description: +//provides text file access functions and string manipulation functions, note that you may want to set pr_zone_min_strings in the worldspawn function if 64k is not enough string zone space. +// +//NOTE: strzone functionality is partially superseded by +//DP_QC_UNLIMITEDTEMPSTRINGS when longterm storage is not needed +//NOTE: substring is upgraded by FTE_STRINGS extension with negative start/length handling identical to php 5.2.0 + +//FTE_CSQC_SKELETONOBJECTS +//idea: Spike, LordHavoc +//darkplaces implementation: LordHavoc +//builtin definitions: +// all skeleton numbers are 1-based (0 being no skeleton) +// all bone numbers are 1-based (0 being invalid) +float(float modlindex) skel_create = #263; // create a skeleton (be sure to assign this value into .skeletonindex for use), returns skeleton index (1 or higher) on success, returns 0 on failure (for example if the modelindex is not skeletal), it is recommended that you create a new skeleton if you change modelindex, as the skeleton uses the hierarchy from the model. +float(float skel, entity ent, float modlindex, float retainfrac, float firstbone, float lastbone) skel_build = #264; // blend in a percentage of standard animation, 0 replaces entirely, 1 does nothing, 0.5 blends half, etc, and this only alters the bones in the specified range for which out of bounds values like 0,100000 are safe (uses .frame, .frame2, .frame3, .frame4, .lerpfrac, .lerpfrac3, .lerpfrac4, .frame1time, .frame2time, .frame3time, .frame4time), returns skel on success, 0 on failure +float(float skel) skel_get_numbones = #265; // returns how many bones exist in the created skeleton, 0 if skeleton does not exist +string(float skel, float bonenum) skel_get_bonename = #266; // returns name of bone (as a tempstring), "" if invalid bonenum (< 1 for example) or skeleton does not exist +float(float skel, float bonenum) skel_get_boneparent = #267; // returns parent num for supplied bonenum, 0 if bonenum has no parent or bone does not exist (returned value is always less than bonenum, you can loop on this) +float(float skel, string tagname) skel_find_bone = #268; // get number of bone with specified name, 0 on failure, bonenum (1-based) on success, same as using gettagindex but takes modelindex instead of entity +vector(float skel, float bonenum) skel_get_bonerel = #269; // get matrix of bone in skeleton relative to its parent - sets v_forward, v_right, v_up, returns origin (relative to parent bone) +vector(float skel, float bonenum) skel_get_boneabs = #270; // get matrix of bone in skeleton in model space - sets v_forward, v_right, v_up, returns origin (relative to entity) +void(float skel, float bonenum, vector org) skel_set_bone = #271; // set matrix of bone relative to its parent, reads v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) +void(float skel, float bonenum, vector org) skel_mul_bone = #272; // transform bone matrix (relative to its parent) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bone) +void(float skel, float startbone, float endbone, vector org) skel_mul_bones = #273; // transform bone matrices (relative to their parents) by the supplied matrix in v_forward, v_right, v_up, takes origin as parameter (relative to parent bones) +void(float skeldst, float skelsrc, float startbone, float endbone) skel_copybones = #274; // copy bone matrices (relative to their parents) from one skeleton to another, useful for copying a skeleton to a corpse +void(float skel) skel_delete = #275; // deletes skeleton at the beginning of the next frame (you can add the entity, delete the skeleton, renderscene, and it will still work) +float(float modlindex, string framename) frameforname = #276; // finds number of a specified frame in the animation, returns -1 if no match found +float(float modlindex, float framenum) frameduration = #277; // returns the intended play time (in seconds) of the specified framegroup, if it does not exist the result is 0, if it is a single frame it may be a small value around 0.1 or 0. +//fields: +.float skeletonindex; // active skeleton overriding standard animation on model +.float frame; // primary framegroup animation (strength = 1 - lerpfrac - lerpfrac3 - lerpfrac4) +.float frame2; // secondary framegroup animation (strength = lerpfrac) +.float frame3; // tertiary framegroup animation (strength = lerpfrac3) +.float frame4; // quaternary framegroup animation (strength = lerpfrac4) +.float lerpfrac; // strength of framegroup blend +.float lerpfrac3; // strength of framegroup blend +.float lerpfrac4; // strength of framegroup blend +.float frame1time; // start time of framegroup animation +.float frame2time; // start time of framegroup animation +.float frame3time; // start time of framegroup animation +.float frame4time; // start time of framegroup animation +//description: +//this extension provides a way to do complex skeletal animation on an entity. +// +//see also DP_SKELETONOBJECTS (this extension implemented on server as well as client) +// +//notes: +//each model contains its own skeleton, reusing a skeleton with incompatible models will yield garbage (or not render). +//each model contains its own animation data, you can use animations from other model files (for example saving out all character animations as separate model files). +//if an engine supports loading an animation-only file format such as .md5anim in FTEQW, it can be used to animate any model with a compatible skeleton. +//proper use of this extension may require understanding matrix transforms (v_forward, v_right, v_up, origin), and you must keep in mind that v_right is negative for this purpose. +// +//features include: +//multiple animations blended together. +//animating a model with animations from another model with a compatible skeleton. +//restricting animation blends to certain bones of a model - for example independent animation of legs, torso, head. +//custom bone controllers - for example making eyes track a target location. +// +// +// +//example code follows... +// +//this helper function lets you identify (by parentage) what group a bone +//belongs to - for example "torso", "leftarm", would return 1 ("torso") for +//all children of the bone named "torso", unless they are children of +//"leftarm" (which is a child of "torso") which would return 2 instead... +float(float skel, float bonenum, string g1, string g2, string g3, string g4, string g5, string g6) example_skel_findbonegroup = +{ + local string bonename; + while (bonenum >= 0) + { + bonename = skel_get_bonename(skel, bonenum); + if (bonename == g1) return 1; + if (bonename == g2) return 2; + if (bonename == g3) return 3; + if (bonename == g4) return 4; + if (bonename == g5) return 5; + if (bonename == g6) return 6; + bonenum = skel_get_boneparent(skel, bonenum); + } + return 0; +}; +// create a skeletonindex for our player using current modelindex +void() example_skel_player_setup = +{ + self.skeletonindex = skel_create(self.modelindex); +}; +// setup bones of skeleton based on an animation +// note: animmodelindex can be a different model than self.modelindex +void(float animmodelindex, float framegroup, float framegroupstarttime) example_skel_player_update_begin = +{ + // start with our standard animation + self.frame = framegroup; + self.frame2 = 0; + self.frame3 = 0; + self.frame4 = 0; + self.frame1time = framegroupstarttime; + self.frame2time = 0; + self.frame3time = 0; + self.frame4time = 0; + self.lerpfrac = 0; + self.lerpfrac3 = 0; + self.lerpfrac4 = 0; + skel_build(self.skeletonindex, self, animmodelindex, 0, 0, 100000); +}; +// apply a different framegroup animation to bones with a specified parent +void(float animmodelindex, float framegroup, float framegroupstarttime, float blendalpha, string groupbonename, string excludegroupname1, string excludegroupname2) example_skel_player_update_applyoverride = +{ + local float bonenum; + local float numbones; + self.frame = framegroup; + self.frame2 = 0; + self.frame3 = 0; + self.frame4 = 0; + self.frame1time = framegroupstarttime; + self.frame2time = 0; + self.frame3time = 0; + self.frame4time = 0; + self.lerpfrac = 0; + self.lerpfrac3 = 0; + self.lerpfrac4 = 0; + bonenum = 0; + numbones = skel_get_numbones(self.skeletonindex); + while (bonenum < numbones) + { + if (example_skel_findbonegroup(self.skeletonindex, bonenum, groupbonename, excludegroupname1, excludegroupname2, "", "", "") == 1) + skel_build(self.skeletonindex, self, animmodelindex, 1 - blendalpha, bonenum, bonenum + 1); + bonenum = bonenum + 1; + } +}; +// make eyes point at a target location, be sure v_forward, v_right, v_up are set correctly before calling +void(vector eyetarget, string bonename) example_skel_player_update_eyetarget = +{ + local float bonenum; + local vector ang; + local vector oldforward, oldright, oldup; + local vector relforward, relright, relup, relorg; + local vector boneforward, boneright, boneup, boneorg; + local vector parentforward, parentright, parentup, parentorg; + local vector u, v; + local vector modeleyetarget; + bonenum = skel_find_bone(self.skeletonindex, bonename) - 1; + if (bonenum < 0) + return; + oldforward = v_forward; + oldright = v_right; + oldup = v_up; + v = eyetarget - self.origin; + modeleyetarget_x = v * v_forward; + modeleyetarget_y = 0-v * v_right; + modeleyetarget_z = v * v_up; + // this is an eyeball, make it point at the target location + // first get all the data we can... + relorg = skel_get_bonerel(self.skeletonindex, bonenum); + relforward = v_forward; + relright = v_right; + relup = v_up; + boneorg = skel_get_boneabs(self.skeletonindex, bonenum); + boneforward = v_forward; + boneright = v_right; + boneup = v_up; + parentorg = skel_get_boneabs(self.skeletonindex, skel_get_boneparent(self.skeletonindex, bonenum)); + parentforward = v_forward; + parentright = v_right; + parentup = v_up; + // get the vector from the eyeball to the target + u = modeleyetarget - boneorg; + // now transform it inversely by the parent matrix to produce new rel vectors + v_x = u * parentforward; + v_y = u * parentright; + v_z = u * parentup; + ang = vectoangles2(v, relup); + ang_x = 0 - ang_x; + makevectors(ang); + // set the relative bone matrix + skel_set_bone(self.skeletonindex, bonenum, relorg); + // restore caller's v_ vectors + v_forward = oldforward; + v_right = oldright; + v_up = oldup; +}; +// delete skeleton when we're done with it +// note: skeleton remains valid until next frame when it is really deleted +void() example_skel_player_delete = +{ + skel_delete(self.skeletonindex); + self.skeletonindex = 0; +}; +// +// END OF EXAMPLES FOR FTE_CSQC_SKELETONOBJECTS +// + +//KRIMZON_SV_PARSECLIENTCOMMAND +//idea: KrimZon +//darkplaces implementation: KrimZon, LordHavoc +//engine-called QC prototypes: +//void(string s) SV_ParseClientCommand; +//builtin definitions: +void(entity e, string s) clientcommand = #440; +float(string s) tokenize = #441; +string(float n) argv = #442; +//description: +//provides QC the ability to completely control server interpretation of client commands ("say" and "color" for example, clientcommand is necessary for this and substring (FRIK_FILE) is useful) as well as adding new commands (tokenize, argv, and stof (FRIK_FILE) are useful for this)), whenever a clc_stringcmd is received the QC function is called, and it is up to the QC to decide what (if anything) to do with it + +//NEH_CMD_PLAY2 +//idea: Nehahra +//darkplaces implementation: LordHavoc +//description: +//shows that the engine supports the "play2" console command (plays a sound without spatialization). + +//NEH_RESTOREGAME +//idea: Nehahra +//darkplaces implementation: LordHavoc +//engine-called QC prototypes: +//void() RestoreGame; +//description: +//when a savegame is loaded, this function is called + +//NEXUIZ_PLAYERMODEL +//idea: Nexuiz +//darkplaces implementation: Black +//console commands: +//playermodel - FIXME: EXAMPLE NEEDED +//playerskin - FIXME: EXAMPLE NEEDED +//field definitions: +.string playermodel; // name of player model sent by client +.string playerskin; // name of player skin sent by client +//description: +//these client properties are used by Nexuiz. + +//NXQ_GFX_LETTERBOX +//idea: nxQuake +//darkplaces implementation: LordHavoc +//description: +//shows that the engine supports the "r_letterbox" console variable, set to values in the range 0-100 this restricts the view vertically (and turns off sbar and crosshair), value is a 0-100 percentage of how much to constrict the view, <=0 = normal view height, 25 = 75% of normal view height, 50 = 50%, 75 = 25%, >=100 = no view + +//PRYDON_CLIENTCURSOR +//idea: FrikaC +//darkplaces implementation: LordHavoc +//effects bit: +float EF_SELECTABLE = 16384; // allows cursor to highlight entity (brighten) +//field definitions: +.float cursor_active; // true if cl_prydoncursor mode is on +.vector cursor_screen; // screen position of cursor as -1 to +1 in _x and _y (_z unused) +.vector cursor_trace_start; // position of camera +.vector cursor_trace_endpos; // position of cursor in world (as traced from camera) +.entity cursor_trace_ent; // entity the cursor is pointing at (server forces this to world if the entity is currently free at time of receipt) +//cvar definitions: +//cl_prydoncursor (0/1+, default 0, 1 and above use cursors named gfx/prydoncursor%03i.lmp - or .tga and such if DP_GFX_EXTERNALTEXTURES is implemented) +//description: +//shows that the engine supports the cl_prydoncursor cvar, this puts a clientside mouse pointer on the screen and feeds input to the server for the QuakeC to use as it sees fit. +//the mouse pointer triggers button4 if cursor is at left edge of screen, button5 if at right edge of screen, button6 if at top edge of screen, button7 if at bottom edge of screen. +//the clientside trace skips transparent entities (except those marked EF_SELECTABLE). +//the selected entity highlights only if EF_SELECTABLE is set, a typical selection method would be doubling the brightness of the entity by some means (such as colormod[] *= 2). +//intended to be used by Prydon Gate. + +//TENEBRAE_GFX_DLIGHTS +//idea: Tenebrae +//darkplaces implementation: LordHavoc +//fields: +.float light_lev; // radius (does not affect brightness), typical value 350 +.vector color; // color (does not affect radius), typical value '1 1 1' (bright white), can be up to '255 255 255' (nuclear blast) +.float style; // light style (like normal light entities, flickering torches or switchable, etc) +.float pflags; // flags (see PFLAGS_ constants) +.vector angles; // orientation of the light +.float skin; // cubemap filter number, can be 1-255 (0 is assumed to be none, and tenebrae only allows 16-255), this selects a projective light filter, a value of 1 loads cubemaps/1posx.tga and cubemaps/1negx.tga and posy, negy, posz, and negz, similar to skybox but some sides need to be rotated or flipped +//constants: +float PFLAGS_NOSHADOW = 1; // light does not cast shadows +float PFLAGS_CORONA = 2; // light has a corona flare +float PFLAGS_FULLDYNAMIC = 128; // light enable (without this set no light is produced!) +//description: +//more powerful dynamic light settings +//warning: it is best not to use cubemaps on a light entity that has a model, as using a skin number that a model does not have will cause issues in glquake, and produce warnings in darkplaces (use developer 1 to see them) +//changes compared to tenebrae (because they're too 'leet' for standards): +//note: networking should send entities with PFLAGS_FULLDYNAMIC set even if they have no model (lights in general do not have a model, nor should they) +//EF_FULLDYNAMIC effects flag replaced by PFLAGS_FULLDYNAMIC flag (EF_FULLDYNAMIC conflicts with EF_NODRAW) + +//TW_SV_STEPCONTROL +//idea: Transfusion +//darkplaces implementation: LordHavoc +//cvars: +//sv_jumpstep (0/1, default 1) +//sv_stepheight (default 18) +//description: +//sv_jumpstep allows stepping up onto stairs while airborn, sv_stepheight controls how high a single step can be. + +//FTE_QC_CHECKPVS +//idea: Urre +//darkplaces implementation: divVerent +//builtin definitions: +float checkpvs(vector viewpos, entity viewee) = #240; +//description: +//returns true if viewee can be seen from viewpos according to PVS data + +//FTE_STRINGS +//idea: many +//darkplaces implementation: KrimZon +//builtin definitions: +float(string str, string sub, float startpos) strstrofs = #221; // returns the offset into a string of the matching text, or -1 if not found, case sensitive +float(string str, float ofs) str2chr = #222; // returns the character at the specified offset as an integer, or 0 if an invalid index, or byte value - 256 if the engine supports UTF8 and the byte is part of an extended character +string(float c, ...) chr2str = #223; // returns a string representing the character given, if the engine supports UTF8 this may be a multi-byte sequence (length may be more than 1) for characters over 127. +string(float ccase, float calpha, float cnum, string s, ...) strconv = #224; // reformat a string with special color characters in the font, DO NOT USE THIS ON UTF8 ENGINES (if you are lucky they will emit ^4 and such color codes instead), the parameter values are 0=same/1=lower/2=upper for ccase, 0=same/1=white/2=red/5=alternate/6=alternate-alternate for redalpha, 0=same/1=white/2=red/3=redspecial/4=whitespecial/5=alternate/6=alternate-alternate for rednum. +string(float chars, string s, ...) strpad = #225; // pad string with spaces to a specified length, < 0 = left padding, > 0 = right padding +string(string info, string key, string value, ...) infoadd = #226; // sets or adds a key/value pair to an infostring - note: forbidden characters are \ and " +string(string info, string key) infoget = #227; // gets a key/value pair in an infostring, returns value or null if not found +float(string s1, string s2) strcmp = #228; // compare two strings +float(string s1, string s2, float len) strncmp = #228; // compare two strings up to the specified number of characters, if their length differs and is within the specified limit the result will be negative, otherwise it is the difference in value of their first non-matching character. +float(string s1, string s2) strcasecmp = #229; // compare two strings with case-insensitive matching, characters a-z are considered equivalent to the matching A-Z character, no other differences, and this does not consider special characters equal even if they look similar +float(string s1, string s2, float len) strncasecmp = #230; // same as strcasecmp but with a length limit, see strncmp +//string(string s, float start, float length) substring = #116; // see note below +//description: +//various string manipulation functions +//note: substring also exists in FRIK_FILE but this extension adds negative start and length as valid cases (see note above), substring is consistent with the php 5.2.0 substr function (not 5.2.3 behavior) +//substring returns a section of a string as a tempstring, if given negative +// start the start is measured back from the end of the string, if given a +// negative length the length is the offset back from the end of the string to +// stop at, rather than being relative to start, if start is negative and +// larger than length it is treated as 0. +// examples of substring: +// substring("blah", -3, 3) returns "lah" +// substring("blah", 3, 3) returns "h" +// substring("blah", -10, 3) returns "bla" +// substring("blah", -10, -3) returns "b" + +//DP_CON_BESTWEAPON +//idea: many +//darkplaces implementation: divVerent +//description: +//allows QC to register weapon properties for use by the bestweapon command, for mods that change required ammo count or type for the weapons +//it is done using console commands sent via stuffcmd: +// register_bestweapon quake +// register_bestweapon clear +// register_bestweapon +//for example, this is what Quake uses: +// register_bestweapon 1 1 4096 4096 6 0 // STAT_SHELLS is 6 +// register_bestweapon 2 2 1 1 6 1 +// register_bestweapon 3 3 2 2 6 1 +// register_bestweapon 4 4 4 4 7 1 // STAT_NAILS is 7 +// register_bestweapon 5 5 8 8 7 1 +// register_bestweapon 6 6 16 16 8 1 // STAT_ROCKETS is 8 +// register_bestweapon 7 7 32 32 8 1 +// register_bestweapon 8 8 64 64 9 1 // STAT_CELLS is 9 +//after each map client initialization, this is reset back to Quake settings. So you should send these data in ClientConnect. +//also, this extension introduces a new "cycleweapon" command to the user. + +//DP_QC_STRINGBUFFERS +//idea: ?? +//darkplaces implementation: LordHavoc +//functions to manage string buffer objects - that is, arbitrary length string arrays that are handled by the engine +float() buf_create = #460; +void(float bufhandle) buf_del = #461; +float(float bufhandle) buf_getsize = #462; +void(float bufhandle_from, float bufhandle_to) buf_copy = #463; +void(float bufhandle, float sortpower, float backward) buf_sort = #464; +string(float bufhandle, string glue) buf_implode = #465; +string(float bufhandle, float string_index) bufstr_get = #466; +void(float bufhandle, float string_index, string str) bufstr_set = #467; +float(float bufhandle, string str, float order) bufstr_add = #468; +void(float bufhandle, float string_index) bufstr_free = #469; + +//DP_QC_STRINGBUFFERS_CVARLIST +//idea: divVerent +//darkplaces implementation: divVerent +//functions to list cvars and store their names into a stringbuffer +//cvars that start with pattern but not with antipattern will be stored into the buffer +void(float bufhandle, string pattern, string antipattern) buf_cvarlist = #517; + +//DP_QC_STRINGBUFFERS_EXT_WIP +//idea: VorteX +//darkplaces implementation: VorteX +//constant definitions: +const float MATCH_AUTO = 0; +const float MATCH_WHOLE = 1; +const float MATCH_LEFT = 2; +const float MATCH_RIGHT = 3; +const float MATCH_MIDDLE = 4; +const float MATCH_PATTERN = 5; +//builtin definitions: +float(string filename, float bufhandle) buf_loadfile = #535; // append each line of file as new buffer string, return 1 if succesful +float(float filehandle, float bufhandle, float startpos, float numstrings) buf_writefile = #536; // writes buffer strings as lines, returns 1 if succesful +float(float bufhandle, string match, float matchrule, float startpos, float step) bufstr_find = #537; // returns string index +float(string s, string pattern, float matchrule) matchpattern = #538; // returns 0/1 +float(string s, string pattern, float matchrule, float pos) matchpatternofs = #538; +//description: +//provides a set of functions to manipulate with string buffers +//pattern wildcards: * - any character (or no characters), ? - any 1 character +//Warning: This extension is work-in-progress, it may be changed/revamped/removed at any time, dont use it if you dont want any trouble +//wip note: UTF8 is not supported yet + +//DP_QC_STRREPLACE +//idea: Sajt +//darkplaces implementation: Sajt +//builtin definitions: +string(string search, string replace, string subject) strreplace = #484; +string(string search, string replace, string subject) strireplace = #485; +//description: +//strreplace replaces all occurrences of 'search' with 'replace' in the string 'subject', and returns the result as a tempstring. +//strireplace does the same but uses case-insensitive matching of the 'search' term + +//DP_SV_SHUTDOWN +//idea: divVerent +//darkplaces implementation: divVerent +//A function that gets called just before progs exit. To save persistent data from. +//It is not called on a crash or error. +//void SV_Shutdown(); + +//EXT_CSQC +// #232 void(float index, float type, .void field) SV_AddStat (EXT_CSQC) +void(float index, float type, ...) addstat = #232; + +//ZQ_PAUSE +//idea: ZQuake +//darkplaces implementation: GreEn`mArine +//builtin definitions: +void(float pause) setpause = #531; +//function definitions: +//void(float elapsedtime) SV_PausedTic; +//description: +//during pause the world is not updated (time does not advance), SV_PausedTic is the only function you can be sure will be called at regular intervals during the pause, elapsedtime is the current system time in seconds since the pause started (not affected by slowmo or anything else). +// +//calling setpause(0) will end a pause immediately. +// +//Note: it is worth considering that network-related functions may be called during the pause (including customizeentityforclient for example), and it is also important to consider the continued use of the KRIMZON_SV_PARSECLIENTCOMMAND extension while paused (chatting players, etc), players may also join/leave during the pause. In other words, the only things that are not called are think and other time-related functions. + +//DP_COVERAGE +//idea: divVerent +//darkplaces implementation: divVerent +//function definitions: +void coverage() = #642; // Reports a coverage event. The engine counts for each of the calls to this builtin whether it has been called. + + +// EXPERIMENTAL (not finalized) EXTENSIONS: + +//DP_CRYPTO +//idea: divVerent +//darkplaces implementation: divVerent +//field definitions: (SVQC) +.string crypto_keyfp; // fingerprint of CA key the player used to authenticate +.string crypto_mykeyfp; // fingerprint of CA key the server used to authenticate to the player +.string crypto_idfp; // fingerprint of ID used by the player entity, or string_null if not identified +.float crypto_idfp_signed; // set if the player's ID has been signed +.string crypto_encryptmethod; // the string "AES128" if encrypting, and string_null if plaintext +.string crypto_signmethod; // the string "HMAC-SHA256" if signing, and string_null if plaintext +// there is no field crypto_myidfp, as that info contains no additional information the QC may have a use for +//builtin definitions: (SVQC) +float(string url, float id, string content_type, string delim, float buf, float keyid) crypto_uri_postbuf = #513; +//description: +//use -1 as buffer handle to justs end delim as postdata diff --git a/qcsrc/dpdefs/upstream/keycodes.qc b/qcsrc/dpdefs/upstream/keycodes.qc new file mode 100644 index 000000000..e3d98ab9c --- /dev/null +++ b/qcsrc/dpdefs/upstream/keycodes.qc @@ -0,0 +1,146 @@ +/////////////////////////// +// key constants + +// +// these are the key numbers that should be passed to Key_Event +// +float K_TAB = 9; +float K_ENTER = 13; +float K_ESCAPE = 27; +float K_SPACE = 32; + +// normal keys should be passed as lowercased ascii + +float K_BACKSPACE = 127; +float K_UPARROW = 128; +float K_DOWNARROW = 129; +float K_LEFTARROW = 130; +float K_RIGHTARROW = 131; + +float K_ALT = 132; +float K_CTRL = 133; +float K_SHIFT = 134; + +float K_F1 = 135; +float K_F2 = 136; +float K_F3 = 137; +float K_F4 = 138; +float K_F5 = 139; +float K_F6 = 140; +float K_F7 = 141; +float K_F8 = 142; +float K_F9 = 143; +float K_F10 = 144; +float K_F11 = 145; +float K_F12 = 146; + +float K_INS = 147; +float K_DEL = 148; +float K_PGDN = 149; +float K_PGUP = 150; +float K_HOME = 151; +float K_END = 152; + +float K_NUMLOCK = 154; +float K_CAPSLOCK = 155; +float K_SCROLLOCK = 156; + +float K_KP_0 = 157; +float K_KP_INS = 157; // same as K_KP_0 +float K_KP_1 = 158; +float K_KP_END = 158; // same as K_KP_1 +float K_KP_2 = 159; +float K_KP_DOWNARROW = 159; // same as K_KP_2 +float K_KP_3 = 160; +float K_KP_PGDN = 160; // same as K_KP_3 +float K_KP_4 = 161; +float K_KP_LEFTARROW = 161; // same as K_KP_4 +float K_KP_5 = 162; +float K_KP_6 = 163; +float K_KP_RIGHTARROW = 163; // same as K_KP_6 +float K_KP_7 = 164; +float K_KP_HOME = 164; // same as K_KP_7 +float K_KP_8 = 165; +float K_KP_UPARROW = 165; // same as K_KP_8 +float K_KP_9 = 166; +float K_KP_PGUP = 166; // same as K_KP_9 +float K_KP_PERIOD = 167; +float K_KP_DEL = 167; // same as K_KP_PERIOD +float K_KP_DIVIDE = 168; +float K_KP_SLASH = 168; // same as K_KP_DIVIDE +float K_KP_MULTIPLY = 169; +float K_KP_MINUS = 170; +float K_KP_PLUS = 171; +float K_KP_ENTER = 172; +float K_KP_EQUALS = 173; + +// mouse buttons generate virtual keys +float K_PAUSE = 153; + +// +// joystick buttons +// +float K_JOY1 = 768; +float K_JOY2 = 769; +float K_JOY3 = 770; +float K_JOY4 = 771; + +// +// +// aux keys are for multi-buttoned joysticks to generate so they can use +// the normal binding process +// +float K_AUX1 = 772; +float K_AUX2 = 773; +float K_AUX3 = 774; +float K_AUX4 = 775; +float K_AUX5 = 776; +float K_AUX6 = 777; +float K_AUX7 = 778; +float K_AUX8 = 779; +float K_AUX9 = 780; +float K_AUX10 = 781; +float K_AUX11 = 782; +float K_AUX12 = 783; +float K_AUX13 = 784; +float K_AUX14 = 785; +float K_AUX15 = 786; +float K_AUX16 = 787; +float K_AUX17 = 788; +float K_AUX18 = 789; +float K_AUX19 = 790; +float K_AUX20 = 791; +float K_AUX21 = 792; +float K_AUX22 = 793; +float K_AUX23 = 794; +float K_AUX24 = 795; +float K_AUX25 = 796; +float K_AUX26 = 797; +float K_AUX27 = 798; +float K_AUX28 = 799; +float K_AUX29 = 800; +float K_AUX30 = 801; +float K_AUX31 = 802; +float K_AUX32 = 803; + +// +// mouse buttons generate virtual keys +// +float K_MOUSE1 = 512; +float K_MOUSE2 = 513; +float K_MOUSE3 = 514; +float K_MWHEELUP = 515; +float K_MWHEELDOWN = 516; +float K_MOUSE4 = 517; +float K_MOUSE5 = 518; +float K_MOUSE6 = 519; +float K_MOUSE7 = 520; +float K_MOUSE8 = 521; +float K_MOUSE9 = 522; +float K_MOUSE10 = 523; +float K_MOUSE11 = 524; +float K_MOUSE12 = 525; +float K_MOUSE13 = 526; +float K_MOUSE14 = 527; +float K_MOUSE15 = 528; +float K_MOUSE16 = 529; diff --git a/qcsrc/dpdefs/upstream/menudefs.qc b/qcsrc/dpdefs/upstream/menudefs.qc new file mode 100644 index 000000000..8caab4a92 --- /dev/null +++ b/qcsrc/dpdefs/upstream/menudefs.qc @@ -0,0 +1,584 @@ +////////////////////////////////////////////////////////// +// sys globals + +entity self; + +///////////////////////////////////////////////////////// +void end_sys_globals; +///////////////////////////////////////////////////////// +// sys fields + +///////////////////////////////////////////////////////// +void end_sys_fields; +///////////////////////////////////////////////////////// +// sys functions + +void() m_init; +void(float keynr, float ascii) m_keydown; +void(float width, float height) m_draw; +void(float mode) m_toggle; +void() m_shutdown; +// optional: float(float) m_gethostcachecategory; + +///////////////////////////////////////////////////////// +// sys constants +/////////////////////////// +// key dest constants + +float KEY_UNKNOWN = -1; +float KEY_GAME = 0; +float KEY_MENU = 2; +float KEY_MENU_GRABBED = 3; + +/////////////////////////// +// file constants + +float FILE_READ = 0; +float FILE_APPEND = 1; +float FILE_WRITE = 2; + +/////////////////////////// +// logical constants (just for completeness) + +float TRUE = 1; +float FALSE = 0; + +/////////////////////////// +// boolean constants + +float true = 1; +float false = 0; + +/////////////////////////// +// msg constants + +float MSG_BROADCAST = 0; // unreliable to all +float MSG_ONE = 1; // reliable to one (msg_entity) +float MSG_ALL = 2; // reliable to all +float MSG_INIT = 3; // write to the init string + +///////////////////////////// +// mouse target constants + +float MT_MENU = 1; +float MT_CLIENT = 2; + +///////////////////////// +// client state constants + +float CS_DEDICATED = 0; +float CS_DISCONNECTED = 1; +float CS_CONNECTED = 2; + +/////////////////////////// +// blend flags + +float DRAWFLAG_NORMAL = 0; +float DRAWFLAG_ADDITIVE = 1; +float DRAWFLAG_MODULATE = 2; +float DRAWFLAG_2XMODULATE = 3; + +/////////////////////////// +// null entity (actually it is the same like the world entity) + +entity null_entity; + +/////////////////////////// +// error constants + +// file handling +float ERR_CANNOTOPEN = -1; // fopen +float ERR_NOTENOUGHFILEHANDLES = -2; // fopen +float ERR_INVALIDMODE = -3; // fopen +float ERR_BADFILENAME = -4; // fopen + +// drawing functions + +float ERR_NULLSTRING = -1; +float ERR_BADDRAWFLAG = -2; +float ERR_BADSCALE = -3; +float ERR_BADSIZE = -3; // same as ERR_BADSCALE +float ERR_NOTCACHED = -4; + +// server list stuff +float SLIST_HOSTCACHEVIEWCOUNT = 0; +float SLIST_HOSTCACHETOTALCOUNT = 1; +float SLIST_MASTERQUERYCOUNT = 2; +float SLIST_MASTERREPLYCOUNT = 3; +float SLIST_SERVERQUERYCOUNT = 4; +float SLIST_SERVERREPLYCOUNT = 5; +float SLIST_SORTFIELD = 6; +float SLIST_SORTDESCENDING = 7; +float SLIST_LEGACY_LINE1 = 1024; +float SLIST_LEGACY_LINE2 = 1025; +float SLIST_TEST_CONTAINS = 0; +float SLIST_TEST_NOTCONTAIN = 1; +float SLIST_TEST_LESSEQUAL = 2; +float SLIST_TEST_LESS = 3; +float SLIST_TEST_EQUAL = 4; +float SLIST_TEST_GREATER = 5; +float SLIST_TEST_GREATEREQUAL = 6; +float SLIST_TEST_NOTEQUAL = 7; +float SLIST_TEST_STARTSWITH = 8; +float SLIST_TEST_NOTSTARTSWITH = 9; +float SLIST_MASK_AND = 0; +float SLIST_MASK_OR = 512; + +// font stuff +float FONT_DEFAULT = 0; +float FONT_CONSOLE = 1; +float FONT_SBAR = 2; +float FONT_NOTIFY = 3; +float FONT_CHAT = 4; +float FONT_CENTERPRINT = 5; +float FONT_INFOBAR = 6; +float FONT_MENU = 7; +float FONT_USER = 8; // add to this the index, like FONT_USER+3 = user3. At least 8 of them are supported. +float drawfont; + +/* not supported at the moment +/////////////////////////// +// os constants + +float OS_WINDOWS = 0; +float OS_LINUX = 1; +float OS_MAC = 2; +*/ + + + + + + + + + + +////////////////////////////////////////////////// +// common cmd +////////////////////////////////////////////////// +// AK FIXME: Create perhaps a special builtin file for the common cmds + +void checkextension(string ext) = #1; + +// error cmds +void error(string err,...) = #2; +void objerror(string err,...) = #3; + +// print + +void print(string text,...) = #4; +void bprint(string text,...) = #5; +void sprint(float clientnum, string text,...) = #6; +void centerprint(string text,...) = #7; + +// vector stuff + +vector normalize(vector v) = #8; +float vlen(vector v) = #9; +float vectoyaw(vector v) = #10; +vector vectoangles(vector v) = #11; + +float random(void) = #12; + +void cmd(string command, ...) = #13; + +// cvar cmds + +float cvar(string name) = #14; +const string str_cvar(string name) = #71; +void cvar_set(string name, string value) = #15; + +void dprint(string text,...) = #16; + +// conversion functions + +string ftos(float f) = #17; +float fabs(float f) = #18; +string vtos(vector v) = #19; +string etos(entity e) = #20; + +float stof(string val,...) = #21; + +entity spawn(void) = #22; +void remove(entity e) = #23; + +entity find(entity start, .string field, string match) = #24; +entity findfloat(entity start, .float field, float match) = #25; +entity findentity(entity start, .entity field, entity match) = #25; + +entity findchainstring(.string field, string match) = #26; +entity findchainfloat(.float field, float match) = #27; +entity findchainentity(.entity field, entity match) = #27; + +string precache_file(string file) = #28; +string precache_sound(string sample) = #29; + +void crash(void) = #72; +void coredump(void) = #30; +void stackdump(void) = #73; +void traceon(void) = #31; +void traceoff(void) = #32; + +void eprint(entity e) = #33; +float rint(float f) = #34; +float floor(float f) = #35; +float ceil(float f) = #36; +entity nextent(entity e) = #37; +float sin(float f) = #38; +float cos(float f) = #39; +float sqrt(float f) = #40; +vector randomvec(void) = #41; + +float registercvar(string name, string value, float flags) = #42; // returns 1 if success + +float min(float f,...) = #43; +float max(float f,...) = #44; + +float bound(float min,float value, float max) = #45; +float pow(float a, float b) = #46; + +void copyentity(entity src, entity dst) = #47; + +float fopen(string filename, float mode) = #48; +void fclose(float fhandle) = #49; +string fgets(float fhandle) = #50; +void fputs(float fhandle, string s) = #51; + +float strlen(string s) = #52; +string strcat(string s1,string s2,...) = #53; +string substring(string s, float start, float length) = #54; + +vector stov(string s) = #55; + +string strzone(string s) = #56; +void strunzone(string s) = #57; + +float tokenize(string s) = #58; +string argv(float n) = #59; + +float isserver(void) = #60; +float clientcount(void) = #61; +float clientstate(void) = #62; +void clientcommand(float client, string s) = #63; +void changelevel(string map) = #64; +void localsound(string sample) = #65; +vector getmousepos(void) = #66; +float gettime(void) = #67; +void loadfromdata(string data) = #68; +void loadfromfile(string file) = #69; + +float mod(float val, float m) = #70; + +float search_begin(string pattern, float caseinsensitive, float quiet) = #74; +void search_end(float handle) = #75; +float search_getsize(float handle) = #76; +string search_getfilename(float handle, float num) = #77; + +string chr(float ascii) = #78; + +///////////////////////////////////////////////// +// Write* Functions +///////////////////////////////////////////////// +void WriteByte(float data, float dest, float desto) = #401; +void WriteChar(float data, float dest, float desto) = #402; +void WriteShort(float data, float dest, float desto) = #403; +void WriteLong(float data, float dest, float desto) = #404; +void WriteAngle(float data, float dest, float desto) = #405; +void WriteCoord(float data, float dest, float desto) = #406; +void WriteString(string data, float dest, float desto)= #407; +void WriteEntity(entity data, float dest, float desto) = #408; + +////////////////////////////////////////////////// +// Draw funtions +////////////////////////////////////////////////// + +float iscachedpic(string name) = #451; +string precache_pic(string name, ...) = #452; +void freepic(string name) = #453; + +float drawcharacter(vector position, float character, vector scale, vector rgb, float alpha, float flag) = #454; + +float drawstring(vector position, string text, vector scale, vector rgb, float alpha, float flag) = #455; + +float drawcolorcodedstring(vector position, string text, vector scale, float alpha, float flag) = #467; + +vector drawcolorcodedstring2(vector position, string text, vector scale, vector rgb, float alpha, float flag) = #467; + +float drawpic(vector position, string pic, vector size, vector rgb, float alpha, float flag) = #456; + +float drawfill(vector position, vector size, vector rgb, float alpha, float flag) = #457; + +void drawsetcliparea(float x, float y, float width, float height) = #458; + +void drawresetcliparea(void) = #459; + +vector drawgetimagesize(string pic) = #460; + +//////////////////////////////////////////////// +// Menu functions +//////////////////////////////////////////////// + +void setkeydest(float dest) = #601; +float getkeydest(void) = #602; + +void setmousetarget(float trg) = #603; +float getmousetarget(void) = #604; + +float isfunction(string function_name) = #607; +void callfunction(...) = #605; +void writetofile(float fhandle, entity ent) = #606; +vector getresolution(float number) = #608; +string keynumtostring(float keynum) = #609; + +float gethostcachevalue(float type) = #611; +string gethostcachestring(float type, float hostnr) = #612; + +//DP_CSQC_BINDMAPS +//idea: daemon, motorsep +//darkplaces implementation: divVerent +//builtin definitions: +string(float key, float bindmap) getkeybind_bindmap = #342; +float(float key, string bind, float bindmap) setkeybind_bindmap = #630; +vector(void) getbindmaps = #631; +float(vector bm) setbindmaps = #632; +string(string command, float bindmap) findkeysforcommand = #610; +float(string key) stringtokeynum = #341; +// string(float keynum) keynumtostring = #340; +//description: key bind setting/getting including support for switchable +//bindmaps. + +//DP_CRYPTO +//idea: divVerent +//darkplaces implementation: divVerent +//field definitions: (MENUQC) +string(string serveraddress) crypto_getkeyfp = #633; // retrieves the cached host key's CA fingerprint of a server given by IP address +string(string serveraddress) crypto_getidfp = #634; // retrieves the cached host key fingerprint of a server given by IP address +float(string serveraddress) crypto_getidstatus = #643; // retrieves the cached host key's key status. See below for CRYPTO_IDSTATUS_ defines. +string(string serveraddress) crypto_getencryptlevel = #635; // 0 if never encrypting, 1 supported, 2 requested, 3 required, appended by list of allowed methods in order of preference ("AES128"), preceded by a space each +string(float i) crypto_getmykeyfp = #636; // retrieves the CA key fingerprint of a given CA slot, or "" if slot is unused but more to come, or string_null if end of list +string(float i) crypto_getmyidfp = #637; // retrieves the ID fingerprint of a given CA slot, or "" if slot is unused but more to come, or string_null if end of list +float CRYPTO_IDSTATUS_OUTOFRANGE = -1; +float CRYPTO_IDSTATUS_EMPTY = 0; +float CRYPTO_IDSTATUS_UNSIGNED = 1; +float CRYPTO_IDSTATUS_SIGNED = 2; +float(float i) crypto_getmyidstatus = #641; // retrieves the ID's status of a given CA slot, or 0 if slot is unused but more to come, or -1 if end of list +float(string url, float id, string content_type, string delim, float buf, float keyid) crypto_uri_postbuf = #513; +//description: +//use -1 as buffer handle to justs end delim as postdata + +//DP_GECKO_SUPPORT +//idea: Res2k, BlackHC +//darkplaces implementation: Res2k, BlackHC +//constant definitions: +float GECKO_BUTTON_DOWN = 0; +float GECKO_BUTTON_UP = 1; +// either use down and up or just press but not all of them! +float GECKO_BUTTON_PRESS = 2; +// use this for mouse events if needed? +float GECKO_BUTTON_DOUBLECLICK = 3; +//builtin definitions: +float gecko_create( string name ) = #487; +void gecko_destroy( string name ) = #488; +void gecko_navigate( string name, string URI ) = #489; +float gecko_keyevent( string name, float key, float eventtype ) = #490; +void gecko_mousemove( string name, float x, float y ) = #491; +void gecko_resize( string name, float w, float h ) = #492; +vector gecko_get_texture_extent( string name ) = #493; +//engine-called QC prototypes: +//string(string name, string query) Qecko_Query; +//description: +//provides an interface to the offscreengecko library and allows for internet browsing in games + +//FTE_STRINGS +//idea: many +//darkplaces implementation: KrimZon +//description: +//various string manipulation functions +float(string str, string sub, float startpos) strstrofs = #221; +float(string str, float ofs) str2chr = #222; +string(float c, ...) chr2str = #223; +string(float ccase, float calpha, float cnum, string s, ...) strconv = #224; +string(float chars, string s, ...) strpad = #225; +string(string info, string key, string value, ...) infoadd = #226; +string(string info, string key) infoget = #227; +float(string s1, string s2) strcmp = #228; +float(string s1, string s2, float len) strncmp = #228; +float(string s1, string s2) strcasecmp = #229; +float(string s1, string s2, float len) strncasecmp = #230; + +//DP_PRECACHE_PIC_FLAGS +//idea: divVerent +//darkplaces implementation: divVerent +//constant definitions: +float PRECACHE_PIC_FROMWAD = 1; // this one actually is part of EXT_CSQC +float PRECACHE_PIC_NOTPERSISTENT = 2; // picture may get deallocated when unused +float PRECACHE_PIC_MIPMAP = 8; // mipmap the texture for possibly better downscaling at memory expense +//notes: these constants are given as optional second argument to precache_pic() + +//DP_QC_CRC16 +//idea: div0 +//darkplaces implementation: div0 +//Some hash function to build hash tables with. This has to be be the CRC-16-CCITT that is also required for the QuakeWorld download protocol. +//When caseinsensitive is set, the CRC is calculated of the lower cased string. +float(float caseinsensitive, string s, ...) crc16 = #494; + +//DP_QC_CVAR_TYPE +float(string name) cvar_type = #495; +float CVAR_TYPEFLAG_EXISTS = 1; +float CVAR_TYPEFLAG_SAVED = 2; +float CVAR_TYPEFLAG_PRIVATE = 4; +float CVAR_TYPEFLAG_ENGINE = 8; +float CVAR_TYPEFLAG_HASDESCRIPTION = 16; +float CVAR_TYPEFLAG_READONLY = 32; + +//DP_QC_STRINGBUFFERS +//idea: ?? +//darkplaces implementation: LordHavoc +//functions to manage string buffer objects - that is, arbitrary length string arrays that are handled by the engine +float() buf_create = #440; +void(float bufhandle) buf_del = #441; +float(float bufhandle) buf_getsize = #442; +void(float bufhandle_from, float bufhandle_to) buf_copy = #443; +void(float bufhandle, float sortpower, float backward) buf_sort = #444; +string(float bufhandle, string glue) buf_implode = #445; +string(float bufhandle, float string_index) bufstr_get = #446; +void(float bufhandle, float string_index, string str) bufstr_set = #447; +float(float bufhandle, string str, float order) bufstr_add = #448; +void(float bufhandle, float string_index) bufstr_free = #449; +void(float bufhandle, string pattern, string antipattern) buf_cvarlist = #517; + +//DP_QC_STRING_CASE_FUNCTIONS +//idea: Dresk +//darkplaces implementation: LordHavoc / Dresk +//builtin definitions: +string(string s) strtolower = #480; // returns the passed in string in pure lowercase form +string(string s) strtoupper = #481; // returns the passed in string in pure uppercase form +//description: +//provides simple string uppercase and lowercase functions + +//DP_QC_CVAR_DESCRIPTION +//idea: divVerent +//DarkPlaces implementation: divVerent +//builtin definitions: +string(string name) cvar_description = #518; +//description: +//returns the description of a cvar + +//DP_QC_DIGEST +//idea: motorsep, Spike +//DarkPlaces implementation: divVerent +//builtin definitions: +string(string digest, string data, ...) digest_hex = #639; +//description: +//returns a given hex digest of given data +//the returned digest is always encoded in hexadecimal +//only the "MD4" digest is always supported! +//if the given digest is not supported, string_null is returned +//the digest string is matched case sensitively, use "MD4", not "md4"! + +//DP_QC_URI_ESCAPE +//idea: div0 +//darkplaces implementation: div0 +//URI::Escape's functionality +string(string in) uri_escape = #510; +string(string in) uri_unescape = #511; + +//DP_QC_URI_GET +//idea: divVerent +//darkplaces implementation: divVerent +//loads text from an URL into a string +//returns 1 on success of initiation, 0 if there are too many concurrent +//connections already or if the URL is invalid +//the following callback will receive the data and MUST exist! +// void(float id, float status, string data) URI_Get_Callback; +//status is either +// negative for an internal error, +// 0 for success, or +// the HTTP response code on server error (e.g. 404) +//if 1 is returned by uri_get, the callback will be called in the future +float(string url, float id) uri_get = #513; +//DP_QC_URI_POST +//idea: divVerent +//darkplaces implementation: divVerent +//loads text from an URL into a string after POSTing via HTTP +//works like uri_get, but uri_post sends data with Content-Type: content_type to the server +//and uri_post sends the string buffer buf, joined using the delimiter delim +float(string url, float id, string content_type, string data) uri_post = #513; +float(string url, float id, string content_type, string delim, float buf) uri_postbuf = #513; + +//DP_QC_ENTITYDATA +//idea: KrimZon +//darkplaces implementation: KrimZon +//builtin definitions: +float() numentityfields = #496; +string(float fieldnum) entityfieldname = #497; +float(float fieldnum) entityfieldtype = #498; +string(float fieldnum, entity ent) getentityfieldstring = #499; +float(float fieldnum, entity ent, string s) putentityfieldstring = #500; +//constants: +//Returned by entityfieldtype +float FIELD_STRING = 1; +float FIELD_FLOAT = 2; +float FIELD_VECTOR = 3; +float FIELD_ENTITY = 4; +float FIELD_FUNCTION = 6; +//description: +//Versatile functions intended for storing data from specific entities between level changes, but can be customized for some kind of partial savegame. +//WARNING: .entity fields cannot be saved and restored between map loads as they will leave dangling pointers. +//numentityfields returns the number of entity fields. NOT offsets. Vectors comprise 4 fields: v, v_x, v_y and v_z. +//entityfieldname returns the name as a string, eg. "origin" or "classname" or whatever. +//entityfieldtype returns a value that the constants represent, but the field may be of another type in more exotic progs.dat formats or compilers. +//getentityfieldstring returns data as would be written to a savegame, eg... "0.05" (float), "0 0 1" (vector), or "Hello World!" (string). Function names can also be returned. +//putentityfieldstring puts the data returned by getentityfieldstring back into the entity. + +//DP_COVERAGE +//idea: divVerent +//darkplaces implementation: divVerent +//function definitions: +void coverage() = #642; // Reports a coverage event. The engine counts for each of the calls to this builtin whether it has been called. + +// assorted undocumented extensions +string(string, float) netaddress_resolve = #625; +string(string search, string replace, string subject) strreplace = #484; +string(float uselocaltime, string format, ...) strftime = #478; +float(string s) tokenize_console = #514; +float(float i) argv_start_index = #515; +float(float i) argv_end_index = #516; +string(float, float) getgamedirinfo = #626; +#define GETGAMEDIRINFO_NAME 0 +#define GETGAMEDIRINFO_DESCRIPTION 1 +float log(float f) = #532; +string(string format, ...) sprintf = #627; +string(string s) strdecolorize = #477; +entity findflags(entity start, .float field, float match) = #87; +entity findchainflags(.float field, float match) = #88; +float(string s, string separator1, ...) tokenizebyseparator = #479; +float etof(entity ent) = #79; +entity ftoe(float num) = #80; +float validstring(string str) = #81; +float altstr_count(string str) = #82; +string altstr_prepare(string str) = #83; +string altstr_get(string str, float num) = #84; +string altstr_set(string str, float num, string set) = #85; +string altstr_ins(string str, float num, string set) = #86; +float isdemo() = #349; +float drawsubpic(vector position, vector size, string pic, vector srcPosition, vector srcSize, vector rgb, float alpha, float flag) = #469; +//vector getresolution(float number, ...) = #608; // optional argument "isfullscreen" +void parseentitydata(entity ent, string data) = #613; +void resethostcachemasks(void) = #615; +void sethostcachemaskstring(float mask, float fld, string str, float op) = #616; +void sethostcachemasknumber(float mask, float fld, float num, float op) = #617; +void resorthostcache(void) = #618; +float SLSF_DESCENDING = 1; +float SLSF_FAVORITES = 2; +float SLSF_CATEGORIES = 4; +void sethostcachesort(float fld, float slsf) = #619; +void refreshhostcache(...) = #620; // optional boolean argument "clear_list" +float gethostcachenumber(float fld, float hostnr) = #621; +float gethostcacheindexforkey(string key) = #622; +void addwantedhostcachekey(string key) = #623; +string getextresponse(void) = #624; +const string cvar_string(string name) = #71; +const string cvar_defstring(string name) = #89; +float stringwidth(string text, float handleColors, vector size) = #468; diff --git a/qcsrc/dpdefs/upstream/progsdefs.qc b/qcsrc/dpdefs/upstream/progsdefs.qc new file mode 100644 index 000000000..2ccd84314 --- /dev/null +++ b/qcsrc/dpdefs/upstream/progsdefs.qc @@ -0,0 +1,507 @@ +/* +============================================================================== + + SOURCE FOR GLOBALVARS_T C STRUCTURE + MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR + +============================================================================== +*/ + +// +// system globals +// +entity self; +entity other; +entity world; +float time; +float frametime; + +float force_retouch; // force all entities to touch triggers + // next frame. this is needed because + // non-moving things don't normally scan + // for triggers, and when a trigger is + // created (like a teleport trigger), it + // needs to catch everything. + // decremented each frame, so set to 2 + // to guarantee everything is touched +string mapname; + +float deathmatch; +float coop; +float teamplay; + +float serverflags; // propagated from level to level, used to + // keep track of completed episodes + +float total_secrets; +float total_monsters; + +float found_secrets; // number of secrets found +float killed_monsters; // number of monsters killed + + +// spawnparms are used to encode information about clients across server +// level changes +float parm1, parm2, parm3, parm4, parm5, parm6, parm7, parm8, parm9, parm10, parm11, parm12, parm13, parm14, parm15, parm16; + +// +// global variables set by built in functions +// +vector v_forward, v_up, v_right; // set by makevectors() + +// set by traceline / tracebox +float trace_allsolid; +float trace_startsolid; +float trace_fraction; +vector trace_endpos; +vector trace_plane_normal; +float trace_plane_dist; +entity trace_ent; +float trace_inopen; +float trace_inwater; + +entity msg_entity; // destination of single entity writes + +// +// required prog functions +// +void() main; // only for testing + +void() StartFrame; + +void() PlayerPreThink; +void() PlayerPostThink; + +void() ClientKill; +void() ClientConnect; +void() PutClientInServer; // call after setting the parm1... parms +void() ClientDisconnect; + +void() SetNewParms; // called when a client first connects to + // a server. sets parms so they can be + // saved off for restarts + +void() SetChangeParms; // call to set parms for self so they can + // be saved for a level transition + + +//================================================ +void end_sys_globals; // flag for structure dumping +//================================================ + +/* +============================================================================== + + SOURCE FOR ENTVARS_T C STRUCTURE + MUST NOT BE MODIFIED, OR CRC ERRORS WILL APPEAR + +============================================================================== +*/ + +// +// system fields (*** = do not set in prog code, maintained by C code) +// +.float modelindex; // *** model index in the precached list +.vector absmin, absmax; // *** origin + mins / maxs + +.float ltime; // local time for entity +.float movetype; +.float solid; + +.vector origin; // *** +.vector oldorigin; // *** +.vector velocity; +.vector angles; +.vector avelocity; + +.vector punchangle; // temp angle adjust from damage or recoil + +.string classname; // spawn function +.string model; +.float frame; +.float skin; +.float effects; + +.vector mins, maxs; // bounding box extents reletive to origin +.vector size; // maxs - mins + +.void() touch; +.void() use; +.void() think; +.void() blocked; // for doors or plats, called when can't push other + +.float nextthink; +.entity groundentity; + +// stats +.float health; +.float frags; +.float weapon; // one of the IT_SHOTGUN, etc flags +.string weaponmodel; +.float weaponframe; +.float currentammo; +.float ammo_shells, ammo_nails, ammo_rockets, ammo_cells; + +.float items; // bit flags + +.float takedamage; +.entity chain; +.float deadflag; + +.vector view_ofs; // add to origin to get eye point + + +.float button0; // fire +.float button1; // use +.float button2; // jump + +.float impulse; // weapon changes + +.float fixangle; +.vector v_angle; // view / targeting angle for players +.float idealpitch; // calculated pitch angle for lookup up slopes + + +.string netname; + +.entity enemy; + +.float flags; + +.float colormap; +.float team; + +.float max_health; // players maximum health is stored here + +.float teleport_time; // don't back up + +.float armortype; // save this fraction of incoming damage +.float armorvalue; + +.float waterlevel; // 0 = not in, 1 = feet, 2 = wast, 3 = eyes +.float watertype; // a contents value + +.float ideal_yaw; +.float yaw_speed; + +.entity aiment; + +.entity goalentity; // a movetarget or an enemy + +.float spawnflags; + +.string target; +.string targetname; + +// damage is accumulated through a frame. and sent as one single +// message, so the super shotgun doesn't generate huge messages +.float dmg_take; +.float dmg_save; +.entity dmg_inflictor; + +.entity owner; // who launched a missile +.vector movedir; // mostly for doors, but also used for waterjump + +.string message; // trigger messages + +.float sounds; // either a cd track number or sound number + +.string noise, noise1, noise2, noise3; // contains names of wavs to play + +//================================================ +void end_sys_fields; // flag for structure dumping +//================================================ + +/* +============================================================================== + + CONSTANT DEFINITIONS + +============================================================================== +*/ + + +// +// constants +// + +float FALSE = 0; +float TRUE = 1; + +// edict.flags +float FL_FLY = 1; +float FL_SWIM = 2; +float FL_CLIENT = 8; // set for all client edicts +float FL_INWATER = 16; // for enter / leave water splash +float FL_MONSTER = 32; +float FL_GODMODE = 64; // player cheat +float FL_NOTARGET = 128; // player cheat +float FL_ITEM = 256; // extra wide size for bonus items +float FL_ONGROUND = 512; // standing on something +float FL_PARTIALGROUND = 1024; // not all corners are valid +float FL_WATERJUMP = 2048; // player jumping out of water +float FL_JUMPRELEASED = 4096; // for jump debouncing + +// edict.movetype values +float MOVETYPE_NONE = 0; // never moves +//float MOVETYPE_ANGLENOCLIP = 1; +//float MOVETYPE_ANGLECLIP = 2; +float MOVETYPE_WALK = 3; // players only +float MOVETYPE_STEP = 4; // discrete, not real time unless fall +float MOVETYPE_FLY = 5; +float MOVETYPE_TOSS = 6; // gravity +float MOVETYPE_PUSH = 7; // no clip to world, push and crush +float MOVETYPE_NOCLIP = 8; +float MOVETYPE_FLYMISSILE = 9; // fly with extra size against monsters +float MOVETYPE_BOUNCE = 10; +float MOVETYPE_BOUNCEMISSILE = 11; // bounce with extra size + +// edict.solid values +float SOLID_NOT = 0; // no interaction with other objects +float SOLID_TRIGGER = 1; // touch on edge, but not blocking +float SOLID_BBOX = 2; // touch on edge, block +float SOLID_SLIDEBOX = 3; // touch on edge, but not an onground +float SOLID_BSP = 4; // bsp clip, touch on edge, block + +// range values +float RANGE_MELEE = 0; +float RANGE_NEAR = 1; +float RANGE_MID = 2; +float RANGE_FAR = 3; + +// deadflag values + +float DEAD_NO = 0; +float DEAD_DYING = 1; +float DEAD_DEAD = 2; +float DEAD_RESPAWNABLE = 3; +float DEAD_RESPAWNING = 4; // dead, waiting for buttons to be released + +// takedamage values + +float DAMAGE_NO = 0; +float DAMAGE_YES = 1; +float DAMAGE_AIM = 2; + +// items +float IT_AXE = 4096; +float IT_SHOTGUN = 1; +float IT_SUPER_SHOTGUN = 2; +float IT_NAILGUN = 4; +float IT_SUPER_NAILGUN = 8; +float IT_GRENADE_LAUNCHER = 16; +float IT_ROCKET_LAUNCHER = 32; +float IT_LIGHTNING = 64; +float IT_EXTRA_WEAPON = 128; + +float IT_SHELLS = 256; +float IT_NAILS = 512; +float IT_ROCKETS = 1024; +float IT_CELLS = 2048; + +float IT_ARMOR1 = 8192; +float IT_ARMOR2 = 16384; +float IT_ARMOR3 = 32768; +float IT_SUPERHEALTH = 65536; + +float IT_KEY1 = 131072; +float IT_KEY2 = 262144; + +float IT_INVISIBILITY = 524288; +float IT_INVULNERABILITY = 1048576; +float IT_SUIT = 2097152; +float IT_QUAD = 4194304; + +// point content values + +float CONTENT_EMPTY = -1; +float CONTENT_SOLID = -2; +float CONTENT_WATER = -3; +float CONTENT_SLIME = -4; +float CONTENT_LAVA = -5; +float CONTENT_SKY = -6; + +float STATE_TOP = 0; +float STATE_BOTTOM = 1; +float STATE_UP = 2; +float STATE_DOWN = 3; + +vector VEC_ORIGIN = '0 0 0'; +vector VEC_HULL_MIN = '-16 -16 -24'; +vector VEC_HULL_MAX = '16 16 32'; + +vector VEC_HULL2_MIN = '-32 -32 -24'; +vector VEC_HULL2_MAX = '32 32 64'; + +// protocol bytes +float SVC_TEMPENTITY = 23; +float SVC_KILLEDMONSTER = 27; +float SVC_FOUNDSECRET = 28; +float SVC_INTERMISSION = 30; +float SVC_FINALE = 31; +float SVC_CDTRACK = 32; +float SVC_SELLSCREEN = 33; + + +float TE_SPIKE = 0; +float TE_SUPERSPIKE = 1; +float TE_GUNSHOT = 2; +float TE_EXPLOSION = 3; +float TE_TAREXPLOSION = 4; +float TE_LIGHTNING1 = 5; +float TE_LIGHTNING2 = 6; +float TE_WIZSPIKE = 7; +float TE_KNIGHTSPIKE = 8; +float TE_LIGHTNING3 = 9; +float TE_LAVASPLASH = 10; +float TE_TELEPORT = 11; + +// sound channels +// channel 0 never willingly overrides +// other channels (1-7) allways override a playing sound on that channel +float CHAN_AUTO = 0; +float CHAN_WEAPON = 1; +float CHAN_VOICE = 2; +float CHAN_ITEM = 3; +float CHAN_BODY = 4; + +float ATTN_NONE = 0; +float ATTN_NORM = 1; +float ATTN_IDLE = 2; +float ATTN_STATIC = 3; + +// update types + +float UPDATE_GENERAL = 0; +float UPDATE_STATIC = 1; +float UPDATE_BINARY = 2; +float UPDATE_TEMP = 3; + +// entity effects + +float EF_BRIGHTFIELD = 1; +float EF_MUZZLEFLASH = 2; +float EF_BRIGHTLIGHT = 4; +float EF_DIMLIGHT = 8; + + +// messages +float MSG_BROADCAST = 0; // unreliable to all +float MSG_ONE = 1; // reliable to one (msg_entity) +float MSG_ALL = 2; // reliable to all +float MSG_INIT = 3; // write to the init string + +//=========================================================================== + +// +// builtin functions +// + +void(vector ang) makevectors = #1; // sets v_forward, etc globals +void(entity e, vector o) setorigin = #2; +void(entity e, string m) setmodel = #3; // set movetype and solid first +void(entity e, vector min, vector max) setsize = #4; +// #5 was removed +void() break_to_debugger = #6; +float() random = #7; // returns 0 - 1 +void(entity e, float chan, string samp, float vol, float atten) sound = #8; +vector(vector v) normalize = #9; +void(string e, ...) error = #10; +void(string e, ...) objerror = #11; +float(vector v) vlen = #12; +float(vector v) vectoyaw = #13; +entity() spawn = #14; +void(entity e) remove = #15; + +// sets trace_* globals +// nomonsters can be: +// An entity will also be ignored for testing if forent == test, +// forent->owner == test, or test->owner == forent +// a forent of world is ignored +void(vector v1, vector v2, float nomonsters, entity forent) traceline = #16; + +entity() checkclient = #17; // returns a client to look for +entity(entity start, .string fld, string match) find = #18; +string(string s) precache_sound = #19; +string(string s) precache_model = #20; +void(entity client, string s, ...)stuffcmd = #21; +entity(vector org, float rad) findradius = #22; +void(string s, ...) bprint = #23; +void(entity client, string s, ...) sprint = #24; +void(string s, ...) dprint = #25; +string(float f) ftos = #26; +string(vector v) vtos = #27; +void() coredump = #28; // prints all edicts +void() traceon = #29; // turns statment trace on +void() traceoff = #30; +void(entity e) eprint = #31; // prints an entire edict +float(float yaw, float dist) walkmove = #32; // returns TRUE or FALSE +// #33 was removed +float() droptofloor= #34; // TRUE if landed on floor +void(float style, string value) lightstyle = #35; +float(float v) rint = #36; // round to nearest int +float(float v) floor = #37; // largest integer <= v +float(float v) ceil = #38; // smallest integer >= v +// #39 was removed +float(entity e) checkbottom = #40; // true if self is on ground +float(vector v) pointcontents = #41; // returns a CONTENT_* +// #42 was removed +float(float f) fabs = #43; +vector(entity e, float speed) aim = #44; // returns the shooting vector +float(string s) cvar = #45; // return cvar.value +void(string s, ...) localcmd = #46; // put string into local que +entity(entity e) nextent = #47; // for looping through all ents +void(vector o, vector d, float color, float count) particle = #48;// start a particle effect +void() ChangeYaw = #49; // turn towards self.ideal_yaw + // at self.yaw_speed +// #50 was removed +vector(vector v) vectoangles = #51; + +// +// direct client message generation +// +void(float to, float f) WriteByte = #52; +void(float to, float f) WriteChar = #53; +void(float to, float f) WriteShort = #54; +void(float to, float f) WriteLong = #55; +void(float to, float f) WriteCoord = #56; +void(float to, float f) WriteAngle = #57; +void(float to, string s, ...) WriteString = #58; +void(float to, entity s) WriteEntity = #59; + +// +// broadcast client message generation +// + +// void(float f) bWriteByte = #59; +// void(float f) bWriteChar = #60; +// void(float f) bWriteShort = #61; +// void(float f) bWriteLong = #62; +// void(float f) bWriteCoord = #63; +// void(float f) bWriteAngle = #64; +// void(string s) bWriteString = #65; +// void(entity e) bWriteEntity = #66; + +void(float step) movetogoal = #67; + +string(string s) precache_file = #68; // no effect except for -copy +void(entity e) makestatic = #69; +void(string s) changelevel = #70; + +//#71 was removed + +void(string var, string val) cvar_set = #72; // sets cvar.value + +void(entity client, string s, ...) centerprint = #73; // sprint, but in middle + +void(vector pos, string samp, float vol, float atten) ambientsound = #74; + +string(string s) precache_model2 = #75; // registered version only +string(string s) precache_sound2 = #76; // registered version only +string(string s) precache_file2 = #77; // registered version only + +void(entity e) setspawnparms = #78; // set parm1... to the + // values at level start + // for coop respawn + +//============================================================================ diff --git a/qcsrc/server/t_items.qh b/qcsrc/server/t_items.qh index ef5813c6b..7470d2f05 100644 --- a/qcsrc/server/t_items.qh +++ b/qcsrc/server/t_items.qh @@ -10,10 +10,14 @@ const int IT_JETPACK = 16; // actual item const int IT_FUEL_REGEN = 32; // fuel regeneration trigger // where is 64... ? const int IT_FUEL = 128; -const int IT_SHELLS = 256; -const int IT_NAILS = 512; -const int IT_ROCKETS = 1024; -const int IT_CELLS = 2048; +// -Wdouble-declaration +// const int IT_SHELLS = 256; +// -Wdouble-declaration +// const int IT_NAILS = 512; +// -Wdouble-declaration +// const int IT_ROCKETS = 1024; +// -Wdouble-declaration +// const int IT_CELLS = 2048; const int IT_SUPERWEAPON = 4096; const int IT_STRENGTH = 8192; const int IT_INVINCIBLE = 16384; @@ -22,8 +26,10 @@ const int IT_PLASMA = 65536; // shared value space (union): // for items: - const int IT_KEY1 = 131072; - const int IT_KEY2 = 262144; + // -Wdouble-declaration + #define IT_KEY1 131072 + // -Wdouble-declaration + #define IT_KEY2 262144 // for players: const int IT_RED_FLAG_TAKEN = 32768; const int IT_RED_FLAG_LOST = 65536; diff --git a/qcsrc/warpzonelib/mathlib.qh b/qcsrc/warpzonelib/mathlib.qh index ddd494de5..a09bdce42 100644 --- a/qcsrc/warpzonelib/mathlib.qh +++ b/qcsrc/warpzonelib/mathlib.qh @@ -104,7 +104,8 @@ const float M_LOG2E = 1.4426950408889634074; /* log_2 e */ const float M_LOG10E = 0.43429448190325182765; /* log_10 e */ const float M_LN2 = 0.69314718055994530942; /* log_e 2 */ const float M_LN10 = 2.30258509299404568402; /* log_e 10 */ -const float M_PI = 3.14159265358979323846; /* pi */ +// -Wdouble-declaration +#define M_PI 3.14159265358979323846 /* pi */ const float M_PI_2 = 1.57079632679489661923; /* pi/2 */ const float M_PI_4 = 0.78539816339744830962; /* pi/4 */ const float M_1_PI = 0.31830988618379067154; /* 1/pi */