2 Copyright (C) 1996-1997 Id Software, Inc.
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 See the GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 #include "matrixlib.h"
27 // LordHavoc: 256 dynamic lights
28 #define MAX_DLIGHTS 256
30 // this is the maximum number of input packets that can be lost without a
32 #define CL_MAX_USERCMDS 16
34 // flags for rtlight rendering
35 #define LIGHTFLAG_NORMALMODE 1
36 #define LIGHTFLAG_REALTIMEMODE 2
38 typedef struct effect_s
47 // these are for interpolation
57 // draw this as lightning polygons, or a model?
59 struct model_s *model;
65 typedef struct rtlight_s
67 // shadow volumes are done entirely in model space, so there are no matrices for dealing with them... they just use the origin
69 // note that the world to light matrices are inversely scaled (divided) by lightradius
72 // matrix for transforming light filter coordinates to world coordinates
73 matrix4x4_t matrix_lighttoworld;
74 // matrix for transforming world coordinates to light filter coordinates
75 matrix4x4_t matrix_worldtolight;
76 // typically 1 1 1, can be lower (dim) or higher (overbright)
78 // size of the light (remove?)
82 // light style to monitor for brightness
84 // whether light should render shadows
86 // intensity of corona to render
88 // radius scale of corona to render (1.0 means same as light radius)
89 vec_t coronasizescale;
90 // ambient intensity to render
92 // diffuse intensity to render
94 // specular intensity to render
99 // generated properties
100 // used only for shadow volumes
107 // squared cullradius
110 // rendering properties, updated each time a light is rendered
111 // this is rtlight->color * d_lightstylevalue
113 // this is R_Shadow_Cubemap(rtlight->cubemapname)
114 rtexture_t *currentcubemap;
117 // true if this light should be compiled as a static light
119 // true if this is a compiled world light, cleared if the light changes
121 // premade shadow volumes to render for world entity
122 shadowmesh_t *static_meshchain_shadow;
123 // used for visibility testing (more exact than bbox)
125 int static_numleafpvsbytes;
126 int *static_leaflist;
127 unsigned char *static_leafpvs;
128 // surfaces seen by light
129 int static_numsurfaces;
130 int *static_surfacelist;
131 // flag bits indicating which triangles of the world model should cast
132 // shadows, and which ones should be lit
134 // this avoids redundantly scanning the triangles in each surface twice
135 // for whether they should cast shadows, once in culling and once in the
136 // actual shadowmarklist production.
137 int static_numshadowtrispvsbytes;
138 unsigned char *static_shadowtrispvs;
139 // this allows the lighting batch code to skip backfaces andother culled
140 // triangles not relevant for lighting
141 // (important on big surfaces such as terrain)
142 int static_numlighttrispvsbytes;
143 unsigned char *static_lighttrispvs;
147 typedef struct dlight_s
149 // destroy light after this time
152 // the entity that owns this light (can be NULL)
154 struct entity_render_s *ent;
156 // (worldlight: saved to .rtlights file)
158 // worldlight orientation
160 // (worldlight: saved to .rtlights file)
162 // dlight orientation/scaling/location
166 // (worldlight: saved to .rtlights file)
168 // cubemap name to use on this light
169 // (worldlight: saved to .rtlights file)
170 char cubemapname[64];
171 // make light flash while selected
174 // brightness (not really radius anymore)
175 // (worldlight: saved to .rtlights file)
177 // drop intensity this much each second
180 // intensity value which is dropped over time
183 // initial values for intensity to modify
187 // light style which controls intensity of this light
188 // (worldlight: saved to .rtlights file)
191 // (worldlight: saved to .rtlights file)
194 // (worldlight: saved to .rtlights file)
196 // radius scale of corona to render (1.0 means same as light radius)
197 // (worldlight: saved to .rtlights file)
198 vec_t coronasizescale;
199 // ambient intensity to render
200 // (worldlight: saved to .rtlights file)
202 // diffuse intensity to render
203 // (worldlight: saved to .rtlights file)
205 // specular intensity to render
206 // (worldlight: saved to .rtlights file)
209 // (worldlight: saved to .rtlights file)
211 // linked list of world lights
213 struct dlight_s *next;
214 // embedded rtlight struct for renderer
220 typedef struct frameblend_s
227 // LordHavoc: this struct is intended for the renderer but some fields are
228 // used by the client.
230 // The renderer should not rely on any changes to this struct to be persistent
231 // across multiple frames because temp entities are wiped every frame, but it
232 // is acceptable to cache things in this struct that are not critical.
234 // For example the r_cullentities_trace code does such caching.
235 typedef struct entity_render_s
241 // transform matrix for model to world
243 // transform matrix for world to model
244 matrix4x4_t inversematrix;
245 // opacity (alpha) of the model
247 // size the model is shown
252 // number of the entity represents, or 0 for non-network entities
254 // literal colormap colors for renderer, if both are 0 0 0 it is not colormapped
255 vec3_t colormap_pantscolor;
256 vec3_t colormap_shirtcolor;
257 // light, particles, etc
259 // qw CTF flags and other internal-use-only effect bits
266 // colormod tinting of models
269 // interpolated animation
271 // frame that the model is interpolating from
273 // frame that the model is interpolating to
275 // interpolation factor, usually computed from frame2time
277 // time frame1 began playing (for framegroup animations)
279 // time frame2 began playing (for framegroup animations)
282 // calculated by the renderer (but not persistent)
284 // calculated during R_AddModelEntities
286 // 4 frame numbers (-1 if not used) and their blending scalers (0-1), if interpolation is not desired, use frame instead
287 frameblend_t frameblend[4];
289 // current lighting from map (updated ONLY by client code, not renderer)
290 vec3_t modellight_ambient;
291 vec3_t modellight_diffuse; // q3bsp
292 vec3_t modellight_lightdir; // q3bsp
294 // FIELDS UPDATED BY RENDERER:
295 // last time visible during trace culling
296 double last_trace_visibility;
300 typedef struct entity_persistent_s
306 qboolean trail_allowed; // set to false by teleports, true by update code, prevents bad lerps
308 // muzzleflash fading
311 // interpolated movement
313 // start time of move
315 // time difference from start to end of move
317 // the move itself, start and end
325 typedef struct entity_s
327 // baseline state (default values)
328 entity_state_t state_baseline;
329 // previous state (interpolating from this)
330 entity_state_t state_previous;
331 // current state (interpolating to this)
332 entity_state_t state_current;
334 // used for regenerating parts of render
335 entity_persistent_t persistent;
337 // the only data the renderer should know about
338 entity_render_t render;
342 typedef struct usercmd_s
346 // intended velocities
351 vec3_t cursor_screen;
354 vec3_t cursor_impact;
355 vec3_t cursor_normal;
356 vec_t cursor_fraction;
357 int cursor_entitynumber;
361 int msec; // for qw moves
365 qboolean applied; // if false we're still accumulating a move
366 qboolean predicted; // if true the sequence should be sent as 0
369 typedef struct lightstyle_s
372 char map[MAX_STYLESTRING];
375 typedef struct scoreboard_s
377 char name[MAX_SCOREBOARDNAME];
379 int colors; // two 4 bit fields
382 char qw_userinfo[MAX_USERINFO_STRING];
388 char qw_skin[MAX_QPATH];
391 typedef struct cshift_s
394 float percent; // 0-256
397 #define CSHIFT_CONTENTS 0
398 #define CSHIFT_DAMAGE 1
399 #define CSHIFT_BONUS 2
400 #define CSHIFT_POWERUP 3
401 #define CSHIFT_VCSHIFT 4
402 #define NUM_CSHIFTS 5
404 #define NAME_LENGTH 64
408 // client_state_t should hold all pieces of the client state
411 #define SIGNONS 4 // signon messages to receive before connected
414 #define MAX_DEMONAME 16
416 typedef enum cactive_e
418 ca_uninitialized, // during early startup
419 ca_dedicated, // a dedicated server with no ability to start a client
420 ca_disconnected, // full screen console with no connection
421 ca_connected // valid netcon, talking to a server
425 typedef enum qw_downloadtype_e
435 typedef enum capturevideoformat_e
437 CAPTUREVIDEOFORMAT_AVI_I420
439 capturevideoformat_t;
441 typedef struct capturevideostate_s
445 // for AVI saving some values have to be written after capture ends
446 fs_offset_t videofile_firstchunkframes_offset;
447 fs_offset_t videofile_totalframes_offset1;
448 fs_offset_t videofile_totalframes_offset2;
449 fs_offset_t videofile_totalsampleframes_offset;
450 int videofile_ix_master_audio_inuse;
451 fs_offset_t videofile_ix_master_audio_inuse_offset;
452 fs_offset_t videofile_ix_master_audio_start_offset;
453 int videofile_ix_master_video_inuse;
454 fs_offset_t videofile_ix_master_video_inuse_offset;
455 fs_offset_t videofile_ix_master_video_start_offset;
456 fs_offset_t videofile_ix_movistart;
461 capturevideoformat_t format;
464 int soundsampleframe; // for AVI saving
465 unsigned char *screenbuffer;
466 unsigned char *outbuffer;
467 sizebuf_t riffbuffer;
468 unsigned char riffbufferdata[128];
469 // note: riffindex buffer has an allocated ->data member, not static like most!
470 sizebuf_t riffindexbuffer;
472 fs_offset_t riffstackstartoffset[4];
473 short rgbtoyuvscaletable[3][3][256];
474 unsigned char yuvnormalizetable[3][256];
480 #define CL_MAX_DOWNLOADACKS 4
482 typedef struct cl_downloadack_s
488 typedef struct cl_soundstats_s
492 int latency_milliseconds;
497 // the client_static_t structure is persistent through an arbitrary number
498 // of server connections
500 typedef struct client_static_s
504 // all client memory allocations go in these pools
505 mempool_t *levelmempool;
506 mempool_t *permanentmempool;
509 // -1 = don't play demos
511 // list of demos in loop
512 char demos[MAX_DEMOS][MAX_DEMONAME];
513 // the actively playing demo (set by CL_PlayDemo_f)
516 // demo recording info must be here, because record is started before
517 // entering a map (and clearing client_state_t)
518 qboolean demorecording;
519 qboolean demoplayback;
521 // -1 = use normal cd track
524 // realtime at second frame of timedemo (LordHavoc: changed to double)
526 int td_frames; // total frames parsed
527 double td_onesecondnexttime;
528 double td_onesecondframes;
529 double td_onesecondrealtime;
530 double td_onesecondminfps;
531 double td_onesecondmaxfps;
532 double td_onesecondavgfps;
533 int td_onesecondavgcount;
534 // LordHavoc: pausedemo
537 // sound mixer statistics for showsound display
538 cl_soundstats_t soundstats;
540 qboolean connect_trying;
541 int connect_remainingtries;
542 double connect_nextsendtime;
543 lhnetsocket_t *connect_mysocket;
544 lhnetaddress_t connect_address;
545 // protocol version of the server we're connected to
546 // (kept outside client_state_t because it's used between levels)
547 protocolversion_t protocol;
549 // connection information
552 // network connection
555 // download information
556 // (note: qw_download variables are also used)
557 cl_downloadack_t dp_downloadack[CL_MAX_DOWNLOADACKS];
559 // input sequence numbers are not reset on level change, only connect
561 int servermovesequence;
563 // quakeworld stuff below
565 // value of "qport" cvar at time of connection
567 // copied from cls.netcon->qw. variables every time they change, or set by demos (which have no cls.netcon)
568 int qw_incoming_sequence;
569 int qw_outgoing_sequence;
571 // current file download buffer (only saved when file is completed)
572 char qw_downloadname[MAX_QPATH];
573 unsigned char *qw_downloadmemory;
574 int qw_downloadmemorycursize;
575 int qw_downloadmemorymaxsize;
576 int qw_downloadnumber;
577 int qw_downloadpercent;
578 qw_downloadtype_t qw_downloadtype;
579 // transfer rate display
580 double qw_downloadspeedtime;
581 int qw_downloadspeedcount;
582 int qw_downloadspeedrate;
584 // current file upload buffer (for uploading screenshots to server)
585 unsigned char *qw_uploaddata;
590 // this normally contains the following keys in quakeworld:
591 // password spectator name team skin topcolor bottomcolor rate noaim msg *ver *ip
592 char userinfo[MAX_USERINFO_STRING];
594 // video capture stuff
595 capturevideostate_t capturevideo;
599 extern client_static_t cls;
601 typedef struct client_movementqueue_s
612 client_movementqueue_t;
618 qboolean drawenginesbar;
619 qboolean drawcrosshair;
624 PARTICLE_BILLBOARD = 0,
626 PARTICLE_ORIENTED_DOUBLESIDED = 2,
639 typedef struct particletype_s
642 porientation_t orientation;
649 pt_dead, pt_alphastatic, pt_static, pt_spark, pt_beam, pt_rain, pt_raindecal, pt_snow, pt_bubble, pt_blood, pt_smoke, pt_decal, pt_entityparticle, pt_total
653 typedef struct decal_s
655 // fields used by rendering: (40 bytes)
656 unsigned short typeindex;
657 unsigned short texnum;
661 float alpha; // 0-255
662 unsigned char color[3];
663 unsigned char unused1;
665 // fields not used by rendering: (36 bytes in 32bit, 40 bytes in 64bit)
666 float time2; // used for decal fade
667 unsigned int owner; // decal stuck to this entity
668 model_t *ownermodel; // model the decal is stuck to (used to make sure the entity is still alive)
669 vec3_t relativeorigin; // decal at this location in entity's coordinate space
670 vec3_t relativenormal; // decal oriented this way relative to entity's coordinate space
674 typedef struct particle_s
676 // fields used by rendering: (40 bytes)
677 unsigned short typeindex;
678 unsigned short texnum;
680 vec3_t vel; // velocity of particle, or orientation of decal, or end point of beam
682 float alpha; // 0-255
683 unsigned char color[3];
684 unsigned char qualityreduction; // enables skipping of this particle according to r_refdef.view.qualityreduction
686 // fields not used by rendering: (40 bytes)
687 float sizeincrease; // rate of size change per second
688 float alphafade; // how much alpha reduces per second
689 float time2; // used for snow fluttering and decal fade
690 float bounce; // how much bounce-back from a surface the particle hits (0 = no physics, 1 = stop and slide, 2 = keep bouncing forever, 1.5 is typical)
691 float gravity; // how much gravity affects this particle (1.0 = normal gravity, 0.0 = none)
692 float airfriction; // how much air friction affects this object (objects with a low mass/size ratio tend to get more air friction)
693 float liquidfriction; // how much liquid friction affects this object (objects with a low mass/size ratio tend to get more liquid friction)
694 float delayedcollisions; // time that p->bounce becomes active
695 float delayedspawn; // time that particle appears and begins moving
696 float die; // time when this particle should be removed, regardless of alpha
700 typedef enum cl_parsingtextmode_e
702 CL_PARSETEXTMODE_NONE,
703 CL_PARSETEXTMODE_PING,
704 CL_PARSETEXTMODE_STATUS,
705 CL_PARSETEXTMODE_STATUS_PLAYERID,
706 CL_PARSETEXTMODE_STATUS_PLAYERIP
708 cl_parsingtextmode_t;
710 typedef struct cl_locnode_s
712 struct cl_locnode_s *next;
718 typedef struct showlmp_s
729 // the client_state_t structure is wiped completely at every
732 typedef struct client_state_s
734 // true if playing in a local game and no one else is connected
737 // send a clc_nop periodically until connected
740 // current input being accumulated by mouse/joystick/etc input
742 // latest moves sent to the server that have not been confirmed yet
743 usercmd_t movecmd[CL_MAX_USERCMDS];
745 // information for local display
747 int stats[MAX_CL_STATS];
748 float *statsf; // points to stats[] array
749 // last known inventory bit flags, for blinking
751 // cl.time of acquiring item, for blinking
752 float item_gettime[32];
753 // last known STAT_ACTIVEWEAPON
755 // cl.time of changing STAT_ACTIVEWEAPON
757 // use pain anim frame if cl.time < this
759 // for stair smoothing
761 double stairsmoothtime;
763 // color shifts for damage, powerups
764 cshift_t cshifts[NUM_CSHIFTS];
766 cshift_t prev_cshifts[NUM_CSHIFTS];
768 // the client maintains its own idea of view angles, which are
769 // sent to the server each frame. The server sets punchangle when
770 // the view is temporarily offset, and an angle reset commands at the start
771 // of each level and after teleporting.
773 // mviewangles is read from demo
774 // viewangles is either client controlled or lerped from mviewangles
775 vec3_t mviewangles[2], viewangles;
776 // update by server, used by qc to do weapon recoil
777 vec3_t mpunchangle[2], punchangle;
778 // update by server, can be used by mods to kick view around
779 vec3_t mpunchvector[2], punchvector;
780 // update by server, used for lean+bob (0 is newest)
781 vec3_t mvelocity[2], velocity;
782 // update by server, can be used by mods for zooming
783 vec_t mviewzoom[2], viewzoom;
784 // if true interpolation the mviewangles and other interpolation of the
785 // player is disabled until the next network packet
786 // this is used primarily by teleporters, and when spectating players
787 // special checking of the old fixangle[1] is used to differentiate
788 // between teleporting and spectating
789 qboolean fixangle[2];
791 // client movement simulation
792 // these fields are only updated by CL_ClientMovement (called by CL_SendMove after parsing each network packet)
793 // set by CL_ClientMovement_Replay functions
794 qboolean movement_predicted;
795 // if true the CL_ClientMovement_Replay function will update origin, etc
796 qboolean movement_replay;
797 // this is set true by svc_time parsing and causes a new movement to be
798 // queued for prediction purposes
799 qboolean movement_needupdate;
800 // timestamps of latest two predicted moves for interpolation
801 double movement_time[4];
802 // simulated data (this is valid even if cl.movement is false)
803 vec3_t movement_origin;
804 vec3_t movement_oldorigin;
805 vec3_t movement_velocity;
806 // queue of proposed moves
807 int movement_numqueue;
808 client_movementqueue_t movement_queue[256];
809 // whether the replay should allow a jump at the first sequence
810 qboolean movement_replay_canjump;
812 // pitch drifting vars
819 //[515]: added for csqc purposes
820 float sensitivityscale;
821 csqc_vidvars_t csqc_vidvars; //[515]: these parms must be set to true by default
822 qboolean csqc_wantsmousemove;
823 struct model_s *csqc_model_precache[MAX_MODELS];
825 // local amount for smoothing stepups
834 qboolean oldonground;
835 double lastongroundtime;
836 double hitgroundtime;
838 // don't change view angle, full screen, etc
840 // latched at intermission start
841 double completed_time;
843 // the timestamp of the last two messages
846 // clients view of time, time should be between mtime[0] and mtime[1] to
847 // generate a lerp point for other data, oldtime is the previous frame's
848 // value of time, frametime is the difference between time and oldtime
849 // note: cl.time may be beyond cl.mtime[0] if packet loss is occuring, it
850 // is only forcefully limited when a packet is received
851 double time, oldtime;
852 // how long it has been since the previous client frame in real time
853 // (not game time, for that use cl.time - cl.oldtime)
854 double realframetime;
856 // copy of realtime from last recieved message, for net trouble icon
857 float last_received_message;
859 // information that is static for the entire time connected to a server
860 struct model_s *model_precache[MAX_MODELS];
861 struct sfx_s *sound_precache[MAX_SOUNDS];
863 // FIXME: this is a lot of memory to be keeping around, this really should be dynamically allocated and freed somehow
864 char model_name[MAX_MODELS][MAX_QPATH];
865 char sound_name[MAX_SOUNDS][MAX_QPATH];
867 // for display on solo scoreboard
869 // cl_entitites[cl.viewentity] = player
871 // the real player entity (normally same as viewentity,
872 // different than viewentity if mod uses chasecam or other tricks)
873 int realplayerentity;
874 // this is updated to match cl.viewentity whenever it is in the clients
875 // range, basically this is used in preference to cl.realplayerentity for
876 // most purposes because when spectating another player it should show
877 // their information rather than yours
879 // max players that can be in this game
881 // type of game (deathmatch, coop, singleplayer)
884 // models and sounds used by engine code (particularly cl_parse.c)
886 model_t *model_bolt2;
887 model_t *model_bolt3;
890 sfx_t *sfx_knighthit;
896 // indicates that the file "sound/misc/talk2.wav" was found (for use by team chat messages)
897 qboolean foundtalk2wav;
899 // refresh related state
901 // cl_entitites[0].model
902 struct model_s *worldmodel;
908 int cdtrack, looptrack;
913 scoreboard_t *scores;
915 // keep track of svc_print parsing state (analyzes ping reports and status reports)
916 cl_parsingtextmode_t parsingtextmode;
917 int parsingtextplayerindex;
918 // set by scoreboard code when sending ping command, this causes the next ping results to be hidden
919 // (which could eat the wrong ping report if the player issues one
920 // manually, but they would still see a ping report, just a later one
921 // caused by the scoreboard code rather than the one they intentionally
923 int parsingtextexpectingpingforscores;
925 // entity database stuff
926 // latest received entity frame numbers
927 #define LATESTFRAMENUMS 3
928 int latestframenums[LATESTFRAMENUMS];
929 entityframe_database_t *entitydatabase;
930 entityframe4_database_t *entitydatabase4;
931 entityframeqw_database_t *entitydatabaseqw;
933 // keep track of quake entities because they need to be killed if they get stale
935 unsigned char isquakeentity[MAX_EDICTS];
937 // bounding boxes for clientside movement
938 vec3_t playerstandmins;
939 vec3_t playerstandmaxs;
940 vec3_t playercrouchmins;
941 vec3_t playercrouchmaxs;
944 int max_static_entities;
949 int max_brushmodel_entities;
955 unsigned char *entities_active;
956 entity_t *static_entities;
957 cl_effect_t *effects;
960 lightstyle_t *lightstyle;
961 int *brushmodel_entities;
962 particle_t *particles;
967 int num_static_entities;
968 int num_brushmodel_entities;
976 double particles_updatetime;
977 double decals_updatetime;
981 // cl_serverextension_download feature
982 int loadmodel_current;
983 int downloadmodel_current;
985 int loadsound_current;
986 int downloadsound_current;
988 qboolean downloadcsqc;
991 qboolean loadfinished;
995 // local copy of the server infostring
996 char qw_serverinfo[MAX_SERVERINFO_STRING];
998 // time of last qw "pings" command sent to server while showing scores
999 double last_ping_request;
1001 // used during connect
1004 // updated from serverinfo
1007 // unused: indicates whether the player is spectating
1008 // use cl.scores[cl.playerentity-1].qw_spectator instead
1009 //qboolean qw_spectator;
1011 // last time an input packet was sent
1012 double lastpackettime;
1014 // movement parameters for client prediction
1015 float movevars_wallfriction;
1016 float movevars_waterfriction;
1017 float movevars_friction;
1018 float movevars_timescale;
1019 float movevars_gravity;
1020 float movevars_stopspeed;
1021 float movevars_maxspeed;
1022 float movevars_spectatormaxspeed;
1023 float movevars_accelerate;
1024 float movevars_airaccelerate;
1025 float movevars_wateraccelerate;
1026 float movevars_entgravity;
1027 float movevars_jumpvelocity;
1028 float movevars_edgefriction;
1029 float movevars_maxairspeed;
1030 float movevars_stepheight;
1031 float movevars_airaccel_qw;
1032 float movevars_airaccel_sideways_friction;
1034 // models used by qw protocol
1035 int qw_modelindex_spike;
1036 int qw_modelindex_player;
1037 int qw_modelindex_flag;
1038 int qw_modelindex_s_explod;
1040 vec3_t qw_intermission_origin;
1041 vec3_t qw_intermission_angles;
1043 // 255 is the most nails the QW protocol could send
1045 vec_t qw_nails[255][6];
1047 float qw_weaponkick;
1049 int qw_validsequence;
1051 int qw_deltasequence[QW_UPDATE_BACKUP];
1054 // server entity number corresponding to a clientside entity
1055 unsigned short csqc_server2csqcentitynumber[MAX_EDICTS];
1056 qboolean csqc_loaded;
1059 qboolean csqc_usecsqclistener;
1060 matrix4x4_t csqc_listenermatrix;
1061 char csqc_printtextbuf[MAX_INPUTLINE];
1063 // collision culling data
1066 // loc file stuff (points and boxes describing locations in the level)
1067 cl_locnode_t *locnodes;
1068 // this is updated to cl.movement_origin whenever health is < 1
1069 // used by %d print in say/say_team messages if cl_locs_enable is on
1070 vec3_t lastdeathorigin;
1072 // processing buffer used by R_BuildLightMap, reallocated as needed,
1073 // freed on each level change
1074 size_t buildlightmapmemorysize;
1075 unsigned char *buildlightmapmemory;
1082 extern cvar_t cl_name;
1083 extern cvar_t cl_color;
1084 extern cvar_t cl_rate;
1085 extern cvar_t cl_pmodel;
1086 extern cvar_t cl_playermodel;
1087 extern cvar_t cl_playerskin;
1089 extern cvar_t rcon_password;
1090 extern cvar_t rcon_address;
1092 extern cvar_t cl_upspeed;
1093 extern cvar_t cl_forwardspeed;
1094 extern cvar_t cl_backspeed;
1095 extern cvar_t cl_sidespeed;
1097 extern cvar_t cl_movespeedkey;
1099 extern cvar_t cl_yawspeed;
1100 extern cvar_t cl_pitchspeed;
1102 extern cvar_t cl_anglespeedkey;
1104 extern cvar_t cl_autofire;
1106 extern cvar_t cl_shownet;
1107 extern cvar_t cl_nolerp;
1108 extern cvar_t cl_nettimesyncfactor;
1109 extern cvar_t cl_nettimesyncboundmode;
1110 extern cvar_t cl_nettimesyncboundtolerance;
1112 extern cvar_t cl_pitchdriftspeed;
1113 extern cvar_t lookspring;
1114 extern cvar_t lookstrafe;
1115 extern cvar_t sensitivity;
1117 extern cvar_t freelook;
1119 extern cvar_t m_pitch;
1120 extern cvar_t m_yaw;
1121 extern cvar_t m_forward;
1122 extern cvar_t m_side;
1124 extern cvar_t cl_autodemo;
1125 extern cvar_t cl_autodemo_nameformat;
1127 extern cvar_t r_draweffects;
1129 extern cvar_t cl_explosions_alpha_start;
1130 extern cvar_t cl_explosions_alpha_end;
1131 extern cvar_t cl_explosions_size_start;
1132 extern cvar_t cl_explosions_size_end;
1133 extern cvar_t cl_explosions_lifetime;
1134 extern cvar_t cl_stainmaps;
1135 extern cvar_t cl_stainmaps_clearonload;
1137 extern cvar_t cl_prydoncursor;
1139 extern cvar_t cl_locs_enable;
1141 extern client_state_t cl;
1143 extern void CL_AllocLightFlash (entity_render_t *ent, matrix4x4_t *matrix, float radius, float red, float green, float blue, float decay, float lifetime, int cubemapnum, int style, int shadowenable, vec_t corona, vec_t coronasizescale, vec_t ambientscale, vec_t diffusescale, vec_t specularscale, int flags);
1145 cl_locnode_t *CL_Locs_FindNearest(const vec3_t point);
1146 void CL_Locs_FindLocationName(char *buffer, size_t buffersize, vec3_t point);
1148 //=============================================================================
1154 void CL_Shutdown (void);
1155 void CL_Init (void);
1157 void CL_EstablishConnection(const char *host);
1159 void CL_Disconnect (void);
1160 void CL_Disconnect_f (void);
1162 void CL_UpdateRenderEntity(entity_render_t *ent);
1163 void CL_SetEntityColormapColors(entity_render_t *ent, int colormap);
1164 void CL_UpdateViewEntities(void);
1169 typedef struct kbutton_s
1171 int down[2]; // key nums holding it down
1172 int state; // low bit is down state
1176 extern kbutton_t in_mlook, in_klook;
1177 extern kbutton_t in_strafe;
1178 extern kbutton_t in_speed;
1180 void CL_InitInput (void);
1181 void CL_SendMove (void);
1183 void CL_ValidateState(entity_state_t *s);
1184 void CL_MoveLerpEntityStates(entity_t *ent);
1185 void CL_LerpUpdate(entity_t *e);
1186 void CL_ParseTEnt (void);
1187 void CL_NewBeam (int ent, vec3_t start, vec3_t end, model_t *m, int lightning);
1188 void CL_RelinkBeams (void);
1189 void CL_Beam_CalculatePositions (const beam_t *b, vec3_t start, vec3_t end);
1190 void CL_ClientMovement_Replay(void);
1192 void CL_ClearTempEntities (void);
1193 entity_render_t *CL_NewTempEntity (void);
1195 void CL_Effect(vec3_t org, int modelindex, int startframe, int framecount, float framerate);
1197 void CL_ClearState (void);
1198 void CL_ExpandEntities(int num);
1199 void CL_SetInfo(const char *key, const char *value, qboolean send, qboolean allowstarkey, qboolean allowmodel, qboolean quiet);
1202 void CL_UpdateWorld (void);
1203 void CL_WriteToServer (void);
1204 void CL_Input (void);
1205 extern int cl_ignoremousemoves;
1208 float CL_KeyState (kbutton_t *key);
1209 const char *Key_KeynumToString (int keynum);
1210 int Key_StringToKeynum (const char *str);
1215 void CL_StopPlayback(void);
1216 void CL_ReadDemoMessage(void);
1217 void CL_WriteDemoMessage(sizebuf_t *mesage);
1219 void CL_NextDemo(void);
1220 void CL_Stop_f(void);
1221 void CL_Record_f(void);
1222 void CL_PlayDemo_f(void);
1223 void CL_TimeDemo_f(void);
1228 void CL_Parse_Init(void);
1229 void CL_Parse_Shutdown(void);
1230 void CL_ParseServerMessage(void);
1231 void CL_Parse_DumpPacket(void);
1232 void CL_Parse_ErrorCleanUp(void);
1233 void QW_CL_StartUpload(unsigned char *data, int size);
1234 extern cvar_t qport;
1239 void V_StartPitchDrift (void);
1240 void V_StopPitchDrift (void);
1243 float V_CalcRoll (vec3_t angles, vec3_t velocity);
1244 void V_UpdateBlends (void);
1245 void V_ParseDamage (void);
1251 extern cvar_t cl_particles;
1252 extern cvar_t cl_particles_quality;
1253 extern cvar_t cl_particles_size;
1254 extern cvar_t cl_particles_quake;
1255 extern cvar_t cl_particles_blood;
1256 extern cvar_t cl_particles_blood_alpha;
1257 extern cvar_t cl_particles_blood_bloodhack;
1258 extern cvar_t cl_particles_bulletimpacts;
1259 extern cvar_t cl_particles_explosions_sparks;
1260 extern cvar_t cl_particles_explosions_shell;
1261 extern cvar_t cl_particles_rain;
1262 extern cvar_t cl_particles_snow;
1263 extern cvar_t cl_particles_smoke;
1264 extern cvar_t cl_particles_smoke_alpha;
1265 extern cvar_t cl_particles_smoke_alphafade;
1266 extern cvar_t cl_particles_sparks;
1267 extern cvar_t cl_particles_bubbles;
1268 extern cvar_t cl_decals;
1269 extern cvar_t cl_decals_time;
1270 extern cvar_t cl_decals_fadetime;
1272 void CL_Particles_Clear(void);
1273 void CL_Particles_Init(void);
1274 void CL_Particles_Shutdown(void);
1276 typedef enum effectnameindex_s
1280 EFFECT_TE_GUNSHOTQUAD,
1282 EFFECT_TE_SPIKEQUAD,
1283 EFFECT_TE_SUPERSPIKE,
1284 EFFECT_TE_SUPERSPIKEQUAD,
1286 EFFECT_TE_KNIGHTSPIKE,
1287 EFFECT_TE_EXPLOSION,
1288 EFFECT_TE_EXPLOSIONQUAD,
1289 EFFECT_TE_TAREXPLOSION,
1291 EFFECT_TE_LAVASPLASH,
1292 EFFECT_TE_SMALLFLASH,
1297 EFFECT_TE_PLASMABURN,
1299 EFFECT_TE_TEI_SMOKE,
1300 EFFECT_TE_TEI_BIGEXPLOSION,
1301 EFFECT_TE_TEI_PLASMAHIT,
1307 EFFECT_TR_SLIGHTBLOOD,
1308 EFFECT_TR_KNIGHTSPIKE,
1309 EFFECT_TR_VORESPIKE,
1310 EFFECT_TR_NEHAHRASMOKE,
1311 EFFECT_TR_NEXUIZPLASMA,
1312 EFFECT_TR_GLOWTRAIL,
1313 EFFECT_SVC_PARTICLE,
1318 int CL_ParticleEffectIndexForName(const char *name);
1319 const char *CL_ParticleEffectNameForIndex(int i);
1320 void CL_ParticleEffect(int effectindex, float pcount, const vec3_t originmins, const vec3_t originmaxs, const vec3_t velocitymins, const vec3_t velocitymaxs, entity_t *ent, int palettecolor);
1321 void CL_ParticleTrail(int effectindex, float pcount, const vec3_t originmins, const vec3_t originmaxs, const vec3_t velocitymins, const vec3_t velocitymaxs, entity_t *ent, int palettecolor, qboolean spawndlight, qboolean spawnparticles);
1322 void CL_ParseParticleEffect (void);
1323 void CL_ParticleCube (const vec3_t mins, const vec3_t maxs, const vec3_t dir, int count, int colorbase, vec_t gravity, vec_t randomvel);
1324 void CL_ParticleRain (const vec3_t mins, const vec3_t maxs, const vec3_t dir, int count, int colorbase, int type);
1325 void CL_EntityParticles (const entity_t *ent);
1326 void CL_ParticleExplosion (const vec3_t org);
1327 void CL_ParticleExplosion2 (const vec3_t org, int colorStart, int colorLength);
1328 void R_NewExplosion(const vec3_t org);
1330 void Debug_PolygonBegin(const char *picname, int flags);
1331 void Debug_PolygonVertex(float x, float y, float z, float s, float t, float r, float g, float b, float a);
1332 void Debug_PolygonEnd(void);
1334 #include "cl_screen.h"
1336 extern qboolean sb_showscores;
1338 float FogPoint_World(const vec3_t p);
1339 float FogPoint_Model(const vec3_t p);
1340 float FogForDistance(vec_t dist);
1342 typedef struct r_refdef_stats_s
1346 int entities_surfaces;
1347 int entities_triangles;
1351 int world_triangles;
1352 int lightmapupdates;
1353 int lightmapupdatepixels;
1357 int meshes_elements;
1360 int lights_scissored;
1361 int lights_lighttriangles;
1362 int lights_shadowtriangles;
1363 int lights_dynamicshadowtriangles;
1365 int bloom_copypixels;
1366 int bloom_drawpixels;
1370 typedef struct r_refdef_view_s
1372 // view information (changes multiple times per frame)
1373 // if any of these variables change then r_refdef.viewcache must be regenerated
1374 // by calling R_View_Update
1375 // (which also updates viewport, scissor, colormask)
1377 // it is safe and expected to copy this into a structure on the stack and
1378 // call the renderer recursively, then restore from the stack afterward
1379 // (as long as R_View_Update is called)
1381 // eye position information
1382 matrix4x4_t matrix, inverse_matrix;
1388 int numfrustumplanes;
1389 mplane_t frustum[6];
1390 qboolean useclipplane;
1391 qboolean usecustompvs; // uses r_refdef.viewcache.pvsbits as-is rather than computing it
1393 float frustum_x, frustum_y;
1394 vec3_t frustumcorner[4];
1395 // if turned off it renders an ortho view
1397 float ortho_x, ortho_y;
1399 // screen area to render in
1407 // which color components to allow (for anaglyph glasses)
1410 // global RGB color multiplier for rendering, this is required by HDR
1413 // whether to call R_ClearScreen before rendering stuff
1416 // whether to draw r_showtris and such, this is only true for the main
1417 // view render, all secondary renders (HDR, mirrors, portals, cameras,
1418 // distortion effects, etc) omit such debugging information
1421 // these define which values to use in GL_CullFace calls to request frontface or backface culling
1425 // render quality (0 to 1) - affects r_drawparticles_drawdistance and others
1430 typedef struct r_refdef_viewcache_s
1432 // these properties are generated by R_View_Update()
1434 // which entities are currently visible for this viewpoint
1435 // (the used range is 0...r_refdef.scene.numentities)
1436 unsigned char entityvisible[MAX_EDICTS];
1437 // flag arrays used for visibility checking on world model
1438 // (all other entities have no per-surface/per-leaf visibility checks)
1439 // TODO: dynamic resize according to r_refdef.scene.worldmodel->brush.num_clusters
1440 unsigned char world_pvsbits[(32768+7)>>3]; // FIXME: buffer overflow on huge maps
1441 // TODO: dynamic resize according to r_refdef.scene.worldmodel->brush.num_leafs
1442 unsigned char world_leafvisible[32768]; // FIXME: buffer overflow on huge maps
1443 // TODO: dynamic resize according to r_refdef.scene.worldmodel->num_surfaces
1444 unsigned char world_surfacevisible[262144]; // FIXME: buffer overflow on huge maps
1445 // if true, the view is currently in a leaf without pvs data
1446 qboolean world_novis;
1448 r_refdef_viewcache_t;
1450 // TODO: really think about which fields should go into scene and which one should stay in refdef [1/7/2008 Black]
1451 // maybe also refactor some of the functions to support different setting sources (ie. fogenabled, etc.) for different scenes
1452 typedef struct r_refdef_scene_s {
1453 // whether to call S_ExtraUpdate during render to reduce sound chop
1454 qboolean extraupdate;
1456 // (client gameworld) time for rendering time based effects
1460 entity_render_t *worldentity;
1462 // same as worldentity->model
1463 model_t *worldmodel;
1465 // renderable entities (excluding world)
1466 entity_render_t **entities;
1470 // field of temporary entities that is reset each (client) frame
1471 entity_render_t *tempentities;
1472 int numtempentities;
1473 int maxtempentities;
1475 // renderable dynamic lights
1476 rtlight_t lights[MAX_DLIGHTS];
1479 // intensities for light styles right now, controls rtlights
1480 float rtlightstylevalue[256]; // float fraction of base light value
1481 // 8.8bit fixed point intensities for light styles
1482 // controls intensity lightmap layers
1483 unsigned short lightstylevalue[256]; // 8.8 fraction of base light value
1488 qboolean rtworldshadows;
1490 qboolean rtdlightshadows;
1493 typedef struct r_refdef_s
1495 // these fields define the basic rendering information for the world
1496 // but not the view, which could change multiple times in one rendered
1497 // frame (for example when rendering textures for certain effects)
1499 // these are set for water warping before
1500 // frustum_x/frustum_y are calculated
1501 float frustumscale_x, frustumscale_y;
1503 // current view settings (these get reset a few times during rendering because of water rendering, reflections, etc)
1504 r_refdef_view_t view;
1505 r_refdef_viewcache_t viewcache;
1507 // minimum visible distance (pixels closer than this disappear)
1509 // maximum visible distance (pixels further than this disappear in 16bpp modes,
1510 // in 32bpp an infinite-farclip matrix is used instead)
1513 // fullscreen color blend
1516 r_refdef_scene_t scene;
1520 vec_t fograngerecip;
1521 vec_t fogmasktabledistmultiplier;
1522 #define FOGMASKTABLEWIDTH 1024
1523 float fogmasktable[FOGMASKTABLEWIDTH];
1524 float fogmasktable_start, fogmasktable_alpha, fogmasktable_range, fogmasktable_density;
1532 qboolean fogenabled;
1533 qboolean oldgl_fogenable;
1535 qboolean draw2dstage;
1537 // true during envmap command capture
1540 // brightness of world lightmaps and related lighting
1541 // (often reduced when world rtlights are enabled)
1542 float lightmapintensity;
1543 // whether to draw world lights realtime, dlights realtime, and their shadows
1544 float polygonfactor;
1545 float polygonoffset;
1546 float shadowpolygonfactor;
1547 float shadowpolygonoffset;
1549 // rendering stats for r_speeds display
1550 // (these are incremented in many places)
1551 r_refdef_stats_t stats;
1555 extern r_refdef_t r_refdef;