]> icculus.org git repositories - divverent/darkplaces.git/blob - client.h
Added DP_QC_STRING_CASE_FUNCTIONS extension, providing VM functions strtolower and...
[divverent/darkplaces.git] / client.h
1 /*
2 Copyright (C) 1996-1997 Id Software, Inc.
3
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.
8
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.
12
13 See the GNU General Public License for more details.
14
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.
18
19 */
20 // client.h
21
22 #ifndef CLIENT_H
23 #define CLIENT_H
24
25 #include "matrixlib.h"
26
27 // LordHavoc: 256 dynamic lights
28 #define MAX_DLIGHTS 256
29
30 // this is the maximum number of input packets that can be lost without a
31 // misprediction
32 #define CL_MAX_USERCMDS 16
33
34 // flags for rtlight rendering
35 #define LIGHTFLAG_NORMALMODE 1
36 #define LIGHTFLAG_REALTIMEMODE 2
37
38 typedef struct effect_s
39 {
40         int active;
41         vec3_t origin;
42         float starttime;
43         float framerate;
44         int modelindex;
45         int startframe;
46         int endframe;
47         // these are for interpolation
48         int frame;
49         double frame1time;
50         double frame2time;
51 }
52 cl_effect_t;
53
54 typedef struct beam_s
55 {
56         int             entity;
57         // draw this as lightning polygons, or a model?
58         int             lightning;
59         struct model_s  *model;
60         float   endtime;
61         vec3_t  start, end;
62 }
63 beam_t;
64
65 typedef struct rtlight_s
66 {
67         // shadow volumes are done entirely in model space, so there are no matrices for dealing with them...  they just use the origin
68
69         // note that the world to light matrices are inversely scaled (divided) by lightradius
70
71         // core properties
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)
77         vec3_t color;
78         // size of the light (remove?)
79         vec_t radius;
80         // light filter
81         char cubemapname[64];
82         // light style to monitor for brightness
83         int style;
84         // whether light should render shadows
85         int shadow;
86         // intensity of corona to render
87         vec_t corona;
88         // radius scale of corona to render (1.0 means same as light radius)
89         vec_t coronasizescale;
90         // ambient intensity to render
91         vec_t ambientscale;
92         // diffuse intensity to render
93         vec_t diffusescale;
94         // specular intensity to render
95         vec_t specularscale;
96         // LIGHTFLAG_* flags
97         int flags;
98
99         // generated properties
100         // used only for shadow volumes
101         vec3_t shadoworigin;
102         // culling
103         vec3_t cullmins;
104         vec3_t cullmaxs;
105         // culling
106         //vec_t cullradius;
107         // squared cullradius
108         //vec_t cullradius2;
109
110         // rendering properties, updated each time a light is rendered
111         // this is rtlight->color * d_lightstylevalue
112         vec3_t currentcolor;
113         // this is R_Shadow_Cubemap(rtlight->cubemapname)
114         rtexture_t *currentcubemap;
115
116         // static light info
117         // true if this light should be compiled as a static light
118         int isstatic;
119         // true if this is a compiled world light, cleared if the light changes
120         int compiled;
121         // premade shadow volumes to render for world entity
122         shadowmesh_t *static_meshchain_shadow;
123         // used for visibility testing (more exact than bbox)
124         int static_numleafs;
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
133         //
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;
144 }
145 rtlight_t;
146
147 typedef struct dlight_s
148 {
149         // destroy light after this time
150         // (dlight only)
151         vec_t die;
152         // the entity that owns this light (can be NULL)
153         // (dlight only)
154         struct entity_render_s *ent;
155         // location
156         // (worldlight: saved to .rtlights file)
157         vec3_t origin;
158         // worldlight orientation
159         // (worldlight only)
160         // (worldlight: saved to .rtlights file)
161         vec3_t angles;
162         // dlight orientation/scaling/location
163         // (dlight only)
164         matrix4x4_t matrix;
165         // color of light
166         // (worldlight: saved to .rtlights file)
167         vec3_t color;
168         // cubemap name to use on this light
169         // (worldlight: saved to .rtlights file)
170         char cubemapname[64];
171         // make light flash while selected
172         // (worldlight only)
173         int selected;
174         // brightness (not really radius anymore)
175         // (worldlight: saved to .rtlights file)
176         vec_t radius;
177         // drop intensity this much each second
178         // (dlight only)
179         vec_t decay;
180         // intensity value which is dropped over time
181         // (dlight only)
182         vec_t intensity;
183         // initial values for intensity to modify
184         // (dlight only)
185         vec_t initialradius;
186         vec3_t initialcolor;
187         // light style which controls intensity of this light
188         // (worldlight: saved to .rtlights file)
189         int style;
190         // cast shadows
191         // (worldlight: saved to .rtlights file)
192         int shadow;
193         // corona intensity
194         // (worldlight: saved to .rtlights file)
195         vec_t corona;
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)
201         vec_t ambientscale;
202         // diffuse intensity to render
203         // (worldlight: saved to .rtlights file)
204         vec_t diffusescale;
205         // specular intensity to render
206         // (worldlight: saved to .rtlights file)
207         vec_t specularscale;
208         // LIGHTFLAG_* flags
209         // (worldlight: saved to .rtlights file)
210         int flags;
211         // linked list of world lights
212         // (worldlight only)
213         struct dlight_s *next;
214         // embedded rtlight struct for renderer
215         // (worldlight only)
216         rtlight_t rtlight;
217 }
218 dlight_t;
219
220 typedef struct frameblend_s
221 {
222         int frame;
223         float lerp;
224 }
225 frameblend_t;
226
227 // LordHavoc: this struct is intended for the renderer but some fields are
228 // used by the client.
229 typedef struct entity_render_s
230 {
231         // location
232         //vec3_t origin;
233         // orientation
234         //vec3_t angles;
235         // transform matrix for model to world
236         matrix4x4_t matrix;
237         // transform matrix for world to model
238         matrix4x4_t inversematrix;
239         // opacity (alpha) of the model
240         float alpha;
241         // size the model is shown
242         float scale;
243
244         // NULL = no model
245         model_t *model;
246         // current uninterpolated animation frame (for things which do not use interpolation)
247         int frame;
248         // number of the entity represents, or 0 for non-network entities
249         int entitynumber;
250         // entity shirt and pants colors (-1 if not colormapped)
251         int colormap;
252         // literal colors for renderer
253         vec3_t colormap_pantscolor;
254         vec3_t colormap_shirtcolor;
255         // light, particles, etc
256         int effects;
257         // qw CTF flags and other internal-use-only effect bits
258         int internaleffects;
259         // for Alias models
260         int skinnum;
261         // render flags
262         int flags;
263
264         // colormod tinting of models
265         float colormod[3];
266
267         // interpolated animation
268
269         // frame that the model is interpolating from
270         int frame1;
271         // frame that the model is interpolating to
272         int frame2;
273         // interpolation factor, usually computed from frame2time
274         float framelerp;
275         // time frame1 began playing (for framegroup animations)
276         double frame1time;
277         // time frame2 began playing (for framegroup animations)
278         double frame2time;
279
280         // calculated by the renderer (but not persistent)
281
282         // calculated during R_AddModelEntities
283         vec3_t mins, maxs;
284         // 4 frame numbers (-1 if not used) and their blending scalers (0-1), if interpolation is not desired, use frame instead
285         frameblend_t frameblend[4];
286
287         // current lighting from map
288         vec3_t modellight_ambient;
289         vec3_t modellight_diffuse; // q3bsp
290         vec3_t modellight_lightdir; // q3bsp
291
292         // last time visible during trace culling
293         double last_trace_visibility;
294 }
295 entity_render_t;
296
297 typedef struct entity_persistent_s
298 {
299         vec3_t trail_origin;
300
301         // particle trail
302         float trail_time;
303
304         // muzzleflash fading
305         float muzzleflash;
306
307         // interpolated movement
308
309         // start time of move
310         float lerpstarttime;
311         // time difference from start to end of move
312         float lerpdeltatime;
313         // the move itself, start and end
314         float oldorigin[3];
315         float oldangles[3];
316         float neworigin[3];
317         float newangles[3];
318 }
319 entity_persistent_t;
320
321 typedef struct entity_s
322 {
323         // baseline state (default values)
324         entity_state_t state_baseline;
325         // previous state (interpolating from this)
326         entity_state_t state_previous;
327         // current state (interpolating to this)
328         entity_state_t state_current;
329
330         // used for regenerating parts of render
331         entity_persistent_t persistent;
332
333         // the only data the renderer should know about
334         entity_render_t render;
335 }
336 entity_t;
337
338 typedef struct usercmd_s
339 {
340         vec3_t  viewangles;
341
342 // intended velocities
343         float   forwardmove;
344         float   sidemove;
345         float   upmove;
346
347         vec3_t  cursor_screen;
348         vec3_t  cursor_start;
349         vec3_t  cursor_end;
350         vec3_t  cursor_impact;
351         vec3_t  cursor_normal;
352         vec_t   cursor_fraction;
353         int             cursor_entitynumber;
354
355         double time;
356         double receivetime;
357         int msec; // for qw moves
358         int buttons;
359         int impulse;
360         int sequence;
361         qboolean applied; // if false we're still accumulating a move
362 } usercmd_t;
363
364 typedef struct lightstyle_s
365 {
366         int             length;
367         char    map[MAX_STYLESTRING];
368 } lightstyle_t;
369
370 typedef struct scoreboard_s
371 {
372         char    name[MAX_SCOREBOARDNAME];
373         int             frags;
374         int             colors; // two 4 bit fields
375         // QW fields:
376         int             qw_userid;
377         char    qw_userinfo[MAX_USERINFO_STRING];
378         float   qw_entertime;
379         int             qw_ping;
380         int             qw_packetloss;
381         int             qw_spectator;
382         char    qw_team[8];
383         char    qw_skin[MAX_QPATH];
384 } scoreboard_t;
385
386 typedef struct cshift_s
387 {
388         float   destcolor[3];
389         float   percent;                // 0-256
390 } cshift_t;
391
392 #define CSHIFT_CONTENTS 0
393 #define CSHIFT_DAMAGE   1
394 #define CSHIFT_BONUS    2
395 #define CSHIFT_POWERUP  3
396 #define CSHIFT_VCSHIFT  4
397 #define NUM_CSHIFTS             5
398
399 #define NAME_LENGTH     64
400
401
402 //
403 // client_state_t should hold all pieces of the client state
404 //
405
406 #define SIGNONS         4                       // signon messages to receive before connected
407
408 #define MAX_DEMOS               8
409 #define MAX_DEMONAME    16
410
411 typedef enum cactive_e
412 {
413         ca_dedicated,           // a dedicated server with no ability to start a client
414         ca_disconnected,        // full screen console with no connection
415         ca_connected            // valid netcon, talking to a server
416 }
417 cactive_t;
418
419 typedef enum qw_downloadtype_e
420 {
421         dl_none,
422         dl_single,
423         dl_skin,
424         dl_model,
425         dl_sound
426 }
427 qw_downloadtype_t;
428
429 typedef enum capturevideoformat_e
430 {
431         CAPTUREVIDEOFORMAT_AVI_I420
432 }
433 capturevideoformat_t;
434
435 typedef struct capturevideostate_s
436 {
437         double starttime;
438         double framerate;
439         // for AVI saving some values have to be written after capture ends
440         fs_offset_t videofile_totalframes_offset1;
441         fs_offset_t videofile_totalframes_offset2;
442         fs_offset_t videofile_totalsampleframes_offset;
443         qfile_t *videofile;
444         qboolean active;
445         qboolean realtime;
446         qboolean error;
447         capturevideoformat_t format;
448         int soundrate;
449         int frame;
450         int soundsampleframe; // for AVI saving
451         unsigned char *buffer;
452         sizebuf_t riffbuffer;
453         unsigned char riffbufferdata[128];
454         // note: riffindex buffer has an allocated ->data member, not static like most!
455         sizebuf_t riffindexbuffer;
456         int riffstacklevel;
457         fs_offset_t riffstackstartoffset[4];
458         short rgbtoyuvscaletable[3][3][256];
459         unsigned char yuvnormalizetable[3][256];
460         char basename[64];
461 }
462 capturevideostate_t;
463
464 #define CL_MAX_DOWNLOADACKS 4
465
466 typedef struct cl_downloadack_s
467 {
468         int start, size;
469 }
470 cl_downloadack_t;
471
472 //
473 // the client_static_t structure is persistent through an arbitrary number
474 // of server connections
475 //
476 typedef struct client_static_s
477 {
478         cactive_t state;
479
480         // all client memory allocations go in these pools
481         mempool_t *levelmempool;
482         mempool_t *permanentmempool;
483
484 // demo loop control
485         // -1 = don't play demos
486         int demonum;
487         // list of demos in loop
488         char demos[MAX_DEMOS][MAX_DEMONAME];
489         // the actively playing demo (set by CL_PlayDemo_f)
490         char demoname[64];
491
492 // demo recording info must be here, because record is started before
493 // entering a map (and clearing client_state_t)
494         qboolean demorecording;
495         qboolean demoplayback;
496         qboolean timedemo;
497         // -1 = use normal cd track
498         int forcetrack;
499         qfile_t *demofile;
500         // to meter out one message a frame
501         int td_lastframe;
502         // host_framecount at start
503         int td_startframe;
504         // realtime at second frame of timedemo (LordHavoc: changed to double)
505         double td_starttime;
506         double td_onesecondnexttime;
507         double td_onesecondframes;
508         double td_onesecondminframes;
509         double td_onesecondmaxframes;
510         double td_onesecondavgframes;
511         int td_onesecondavgcount;
512         // LordHavoc: pausedemo
513         qboolean demopaused;
514
515         qboolean connect_trying;
516         int connect_remainingtries;
517         double connect_nextsendtime;
518         lhnetsocket_t *connect_mysocket;
519         lhnetaddress_t connect_address;
520         // protocol version of the server we're connected to
521         // (kept outside client_state_t because it's used between levels)
522         protocolversion_t protocol;
523
524 // connection information
525         // 0 to SIGNONS
526         int signon;
527         // network connection
528         netconn_t *netcon;
529
530         // download information
531         // (note: qw_download variables are also used)
532         cl_downloadack_t dp_downloadack[CL_MAX_DOWNLOADACKS];
533
534         // input sequence numbers are not reset on level change, only connect
535         int movesequence;
536         int servermovesequence;
537
538         // quakeworld stuff below
539
540         // value of "qport" cvar at time of connection
541         int qw_qport;
542         // copied from cls.netcon->qw. variables every time they change, or set by demos (which have no cls.netcon)
543         int qw_incoming_sequence;
544         int qw_outgoing_sequence;
545
546         // current file download buffer (only saved when file is completed)
547         char qw_downloadname[MAX_QPATH];
548         unsigned char *qw_downloadmemory;
549         int qw_downloadmemorycursize;
550         int qw_downloadmemorymaxsize;
551         int qw_downloadnumber;
552         int qw_downloadpercent;
553         qw_downloadtype_t qw_downloadtype;
554         // transfer rate display
555         double qw_downloadspeedtime;
556         int qw_downloadspeedcount;
557         int qw_downloadspeedrate;
558
559         // current file upload buffer (for uploading screenshots to server)
560         unsigned char *qw_uploaddata;
561         int qw_uploadsize;
562         int qw_uploadpos;
563
564         // user infostring
565         // this normally contains the following keys in quakeworld:
566         // password spectator name team skin topcolor bottomcolor rate noaim msg *ver *ip
567         char userinfo[MAX_USERINFO_STRING];
568
569         // video capture stuff
570         capturevideostate_t capturevideo;
571 }
572 client_static_t;
573
574 extern client_static_t  cls;
575
576 typedef struct client_movementqueue_s
577 {
578         double time;
579         float frametime;
580         int sequence;
581         float viewangles[3];
582         float move[3];
583         qboolean jump;
584         qboolean crouch;
585 }
586 client_movementqueue_t;
587
588 //[515]: csqc
589 typedef struct
590 {
591         qboolean drawworld;
592         qboolean drawenginesbar;
593         qboolean drawcrosshair;
594 }csqc_vidvars_t;
595
596 typedef enum
597 {
598         PARTICLE_BILLBOARD = 0,
599         PARTICLE_SPARK = 1,
600         PARTICLE_ORIENTED_DOUBLESIDED = 2,
601         PARTICLE_BEAM = 3
602 }
603 porientation_t;
604
605 typedef enum
606 {
607         PBLEND_ALPHA = 0,
608         PBLEND_ADD = 1,
609         PBLEND_MOD = 2
610 }
611 pblend_t;
612
613 typedef struct particletype_s
614 {
615         pblend_t blendmode;
616         porientation_t orientation;
617         qboolean lighting;
618 }
619 particletype_t;
620
621 typedef enum
622 {
623         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
624 }
625 ptype_t;
626
627 typedef struct particle_s
628 {
629         particletype_t *type;
630         int                     texnum;
631         vec3_t          org;
632         vec3_t          vel; // velocity of particle, or orientation of decal, or end point of beam
633         float           size;
634         float           sizeincrease; // rate of size change per second
635         float           alpha; // 0-255
636         float           alphafade; // how much alpha reduces per second
637         float           time2; // used for snow fluttering and decal fade
638         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)
639         float           gravity; // how much gravity affects this particle (1.0 = normal gravity, 0.0 = none)
640         float           airfriction; // how much air friction affects this object (objects with a low mass/size ratio tend to get more air friction)
641         float           liquidfriction; // how much liquid friction affects this object (objects with a low mass/size ratio tend to get more liquid friction)
642         unsigned char           color[4];
643         unsigned int            owner; // decal stuck to this entity
644         model_t         *ownermodel; // model the decal is stuck to (used to make sure the entity is still alive)
645         vec3_t          relativeorigin; // decal at this location in entity's coordinate space
646         vec3_t          relativedirection; // decal oriented this way relative to entity's coordinate space
647 }
648 particle_t;
649
650 typedef enum cl_parsingtextmode_e
651 {
652         CL_PARSETEXTMODE_NONE,
653         CL_PARSETEXTMODE_PING,
654         CL_PARSETEXTMODE_STATUS,
655         CL_PARSETEXTMODE_STATUS_PLAYERID,
656         CL_PARSETEXTMODE_STATUS_PLAYERIP
657 }
658 cl_parsingtextmode_t;
659
660 typedef struct cl_locnode_s
661 {
662         struct cl_locnode_s *next;
663         char *name;
664         vec3_t mins, maxs;
665 }
666 cl_locnode_t;
667
668 //
669 // the client_state_t structure is wiped completely at every
670 // server signon
671 //
672 typedef struct client_state_s
673 {
674         // true if playing in a local game and no one else is connected
675         int islocalgame;
676
677         // send a clc_nop periodically until connected
678         float sendnoptime;
679
680         // current input being accumulated by mouse/joystick/etc input
681         usercmd_t cmd;
682         // latest moves sent to the server that have not been confirmed yet
683         usercmd_t movecmd[CL_MAX_USERCMDS];
684
685 // information for local display
686         // health, etc
687         int stats[MAX_CL_STATS];
688         // last known inventory bit flags, for blinking
689         int olditems;
690         // cl.time of acquiring item, for blinking
691         float item_gettime[32];
692         // last known STAT_ACTIVEWEAPON
693         int activeweapon;
694         // cl.time of changing STAT_ACTIVEWEAPON
695         float weapontime;
696         // use pain anim frame if cl.time < this
697         float faceanimtime;
698         // for stair smoothing
699         float stairsmoothz;
700         double stairsmoothtime;
701
702         // color shifts for damage, powerups
703         cshift_t cshifts[NUM_CSHIFTS];
704         // and content types
705         cshift_t prev_cshifts[NUM_CSHIFTS];
706
707 // the client maintains its own idea of view angles, which are
708 // sent to the server each frame.  The server sets punchangle when
709 // the view is temporarily offset, and an angle reset commands at the start
710 // of each level and after teleporting.
711
712         // mviewangles is read from demo
713         // viewangles is either client controlled or lerped from mviewangles
714         vec3_t mviewangles[2], viewangles;
715         // update by server, used by qc to do weapon recoil
716         vec3_t mpunchangle[2], punchangle;
717         // update by server, can be used by mods to kick view around
718         vec3_t mpunchvector[2], punchvector;
719         // update by server, used for lean+bob (0 is newest)
720         vec3_t mvelocity[2], velocity;
721         // update by server, can be used by mods for zooming
722         vec_t mviewzoom[2], viewzoom;
723         // if true interpolation the mviewangles and other interpolation of the
724         // player is disabled until the next network packet
725         // this is used primarily by teleporters, and when spectating players
726         // special checking of the old fixangle[1] is used to differentiate
727         // between teleporting and spectating
728         qboolean fixangle[2];
729
730         // client movement simulation
731         // these fields are only updated by CL_ClientMovement (called by CL_SendMove after parsing each network packet)
732         // set by CL_ClientMovement_Replay functions
733         qboolean movement_predicted;
734         // if true the CL_ClientMovement_Replay function will update origin, etc
735         qboolean movement_replay;
736         // this is set true by svc_time parsing and causes a new movement to be
737         // queued for prediction purposes
738         qboolean movement_needupdate;
739         // timestamps of latest two predicted moves for interpolation
740         double movement_time[4];
741         // simulated data (this is valid even if cl.movement is false)
742         vec3_t movement_origin;
743         vec3_t movement_oldorigin;
744         vec3_t movement_velocity;
745         // queue of proposed moves
746         int movement_numqueue;
747         client_movementqueue_t movement_queue[256];
748         // whether the replay should allow a jump at the first sequence
749         qboolean movement_replay_canjump;
750
751 // pitch drifting vars
752         float idealpitch;
753         float pitchvel;
754         qboolean nodrift;
755         float driftmove;
756         double laststop;
757
758 //[515]: added for csqc purposes
759         float sensitivityscale;
760         csqc_vidvars_t csqc_vidvars;    //[515]: these parms must be set to true by default
761         qboolean csqc_wantsmousemove;
762         struct model_s *csqc_model_precache[MAX_MODELS];
763
764         // local amount for smoothing stepups
765         //float crouch;
766
767         // sent by server
768         qboolean paused;
769         qboolean onground;
770         qboolean inwater;
771
772         // used by bob
773         qboolean oldonground;
774         double lastongroundtime;
775         double hitgroundtime;
776
777         // don't change view angle, full screen, etc
778         int intermission;
779         // latched at intermission start
780         double completed_time;
781
782         // the timestamp of the last two messages
783         double mtime[2];
784
785         // clients view of time, time should be between mtime[0] and mtime[1] to
786         // generate a lerp point for other data, oldtime is the previous frame's
787         // value of time, frametime is the difference between time and oldtime
788         // note: cl.time may be beyond cl.mtime[0] if packet loss is occuring, it
789         // is only forcefully limited when a packet is received
790         double time, oldtime;
791         // how long it has been since the previous client frame in real time
792         // (not game time, for that use cl.time - cl.oldtime)
793         double realframetime;
794
795         // copy of realtime from last recieved message, for net trouble icon
796         float last_received_message;
797
798 // information that is static for the entire time connected to a server
799         struct model_s *model_precache[MAX_MODELS];
800         struct sfx_s *sound_precache[MAX_SOUNDS];
801
802         // FIXME: this is a lot of memory to be keeping around, this really should be dynamically allocated and freed somehow
803         char model_name[MAX_MODELS][MAX_QPATH];
804         char sound_name[MAX_SOUNDS][MAX_QPATH];
805
806         // for display on solo scoreboard
807         char levelname[40];
808         // cl_entitites[cl.viewentity] = player
809         int viewentity;
810         // the real player entity (normally same as viewentity,
811         // different than viewentity if mod uses chasecam or other tricks)
812         int playerentity;
813         // max players that can be in this game
814         int maxclients;
815         // type of game (deathmatch, coop, singleplayer)
816         int gametype;
817
818         // models and sounds used by engine code (particularly cl_parse.c)
819         model_t *model_bolt;
820         model_t *model_bolt2;
821         model_t *model_bolt3;
822         model_t *model_beam;
823         sfx_t *sfx_wizhit;
824         sfx_t *sfx_knighthit;
825         sfx_t *sfx_tink1;
826         sfx_t *sfx_ric1;
827         sfx_t *sfx_ric2;
828         sfx_t *sfx_ric3;
829         sfx_t *sfx_r_exp3;
830         // indicates that the file "sound/misc/talk2.wav" was found (for use by team chat messages)
831         qboolean foundtalk2wav;
832
833 // refresh related state
834
835         // cl_entitites[0].model
836         struct model_s *worldmodel;
837
838         // the gun model
839         entity_t viewent;
840
841         // cd audio
842         int cdtrack, looptrack;
843
844 // frag scoreboard
845
846         // [cl.maxclients]
847         scoreboard_t *scores;
848
849         // keep track of svc_print parsing state (analyzes ping reports and status reports)
850         cl_parsingtextmode_t parsingtextmode;
851         int parsingtextplayerindex;
852         // set by scoreboard code when sending ping command, this causes the next ping results to be hidden
853         // (which could eat the wrong ping report if the player issues one
854         //  manually, but they would still see a ping report, just a later one
855         //  caused by the scoreboard code rather than the one they intentionally
856         //  issued)
857         int parsingtextexpectingpingforscores;
858
859         // entity database stuff
860         // latest received entity frame numbers
861 #define LATESTFRAMENUMS 3
862         int latestframenums[LATESTFRAMENUMS];
863         entityframe_database_t *entitydatabase;
864         entityframe4_database_t *entitydatabase4;
865         entityframeqw_database_t *entitydatabaseqw;
866
867         // keep track of quake entities because they need to be killed if they get stale
868         int lastquakeentity;
869         unsigned char isquakeentity[MAX_EDICTS];
870
871         // bounding boxes for clientside movement
872         vec3_t playerstandmins;
873         vec3_t playerstandmaxs;
874         vec3_t playercrouchmins;
875         vec3_t playercrouchmaxs;
876
877         int max_entities;
878         int max_static_entities;
879         int max_temp_entities;
880         int max_effects;
881         int max_beams;
882         int max_dlights;
883         int max_lightstyle;
884         int max_brushmodel_entities;
885         int max_particles;
886
887         entity_t *entities;
888         unsigned char *entities_active;
889         entity_t *static_entities;
890         entity_t *temp_entities;
891         cl_effect_t *effects;
892         beam_t *beams;
893         dlight_t *dlights;
894         lightstyle_t *lightstyle;
895         int *brushmodel_entities;
896         particle_t *particles;
897
898         int num_entities;
899         int num_static_entities;
900         int num_temp_entities;
901         int num_brushmodel_entities;
902         int num_effects;
903         int num_beams;
904         int num_dlights;
905         int num_particles;
906
907         int free_particle;
908
909         // cl_serverextension_download feature
910         int loadmodel_current;
911         int downloadmodel_current;
912         int loadmodel_total;
913         int loadsound_current;
914         int downloadsound_current;
915         int loadsound_total;
916         qboolean downloadcsqc;
917         qboolean loadbegun;
918         qboolean loadfinished;
919
920         // quakeworld stuff
921
922         // local copy of the server infostring
923         char qw_serverinfo[MAX_SERVERINFO_STRING];
924
925         // time of last qw "pings" command sent to server while showing scores
926         double last_ping_request;
927
928         // used during connect
929         int qw_servercount;
930
931         // updated from serverinfo
932         int qw_teamplay;
933
934         // unused: indicates whether the player is spectating
935         // use cl.scores[cl.playerentity].qw_spectator instead
936         //qboolean qw_spectator;
937
938         // movement parameters for client prediction
939         float qw_movevars_gravity;
940         float qw_movevars_stopspeed;
941         float qw_movevars_maxspeed; // can change during play
942         float qw_movevars_spectatormaxspeed;
943         float qw_movevars_accelerate;
944         float qw_movevars_airaccelerate;
945         float qw_movevars_wateraccelerate;
946         float qw_movevars_friction;
947         float qw_movevars_waterfriction;
948         float qw_movevars_entgravity; // can change during play
949
950         // models used by qw protocol
951         int qw_modelindex_spike;
952         int qw_modelindex_player;
953         int qw_modelindex_flag;
954         int qw_modelindex_s_explod;
955
956         vec3_t qw_intermission_origin;
957         vec3_t qw_intermission_angles;
958
959         // 255 is the most nails the QW protocol could send
960         int qw_num_nails;
961         vec_t qw_nails[255][6];
962
963         float qw_weaponkick;
964
965         int qw_validsequence;
966
967         int qw_deltasequence[QW_UPDATE_BACKUP];
968
969         // csqc stuff:
970
971         // collision culling data
972         world_t world;
973
974         // loc file stuff (points and boxes describing locations in the level)
975         cl_locnode_t *locnodes;
976         // this is updated to cl.movement_origin whenever health is < 1
977         // used by %d print in say/say_team messages if cl_locs_enable is on
978         vec3_t lastdeathorigin;
979 }
980 client_state_t;
981
982 //
983 // cvars
984 //
985 extern cvar_t cl_name;
986 extern cvar_t cl_color;
987 extern cvar_t cl_rate;
988 extern cvar_t cl_pmodel;
989 extern cvar_t cl_playermodel;
990 extern cvar_t cl_playerskin;
991
992 extern cvar_t rcon_password;
993 extern cvar_t rcon_address;
994
995 extern cvar_t cl_upspeed;
996 extern cvar_t cl_forwardspeed;
997 extern cvar_t cl_backspeed;
998 extern cvar_t cl_sidespeed;
999
1000 extern cvar_t cl_movespeedkey;
1001
1002 extern cvar_t cl_yawspeed;
1003 extern cvar_t cl_pitchspeed;
1004
1005 extern cvar_t cl_anglespeedkey;
1006
1007 extern cvar_t cl_autofire;
1008
1009 extern cvar_t cl_shownet;
1010 extern cvar_t cl_nolerp;
1011 extern cvar_t cl_nettimesyncfactor;
1012 extern cvar_t cl_nettimesyncboundmode;
1013 extern cvar_t cl_nettimesyncboundtolerance;
1014
1015 extern cvar_t cl_pitchdriftspeed;
1016 extern cvar_t lookspring;
1017 extern cvar_t lookstrafe;
1018 extern cvar_t sensitivity;
1019
1020 extern cvar_t freelook;
1021
1022 extern cvar_t m_pitch;
1023 extern cvar_t m_yaw;
1024 extern cvar_t m_forward;
1025 extern cvar_t m_side;
1026
1027 extern cvar_t cl_autodemo;
1028 extern cvar_t cl_autodemo_nameformat;
1029
1030 extern cvar_t r_draweffects;
1031
1032 extern cvar_t cl_explosions_alpha_start;
1033 extern cvar_t cl_explosions_alpha_end;
1034 extern cvar_t cl_explosions_size_start;
1035 extern cvar_t cl_explosions_size_end;
1036 extern cvar_t cl_explosions_lifetime;
1037 extern cvar_t cl_stainmaps;
1038 extern cvar_t cl_stainmaps_clearonload;
1039
1040 extern cvar_t cl_prydoncursor;
1041
1042 extern cvar_t cl_locs_enable;
1043
1044 extern client_state_t cl;
1045
1046 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);
1047
1048 cl_locnode_t *CL_Locs_FindNearest(const vec3_t point);
1049 void CL_Locs_FindLocationName(char *buffer, size_t buffersize, vec3_t point);
1050
1051 //=============================================================================
1052
1053 //
1054 // cl_main
1055 //
1056
1057 void CL_Shutdown (void);
1058 void CL_Init (void);
1059
1060 void CL_EstablishConnection(const char *host);
1061
1062 void CL_Disconnect (void);
1063 void CL_Disconnect_f (void);
1064
1065 void CL_UpdateRenderEntity(entity_render_t *ent);
1066 void CL_UpdateViewEntities(void);
1067
1068 //
1069 // cl_input
1070 //
1071 typedef struct kbutton_s
1072 {
1073         int             down[2];                // key nums holding it down
1074         int             state;                  // low bit is down state
1075 }
1076 kbutton_t;
1077
1078 extern  kbutton_t       in_mlook, in_klook;
1079 extern  kbutton_t       in_strafe;
1080 extern  kbutton_t       in_speed;
1081
1082 void CL_InitInput (void);
1083 void CL_SendMove (void);
1084
1085 void CL_ValidateState(entity_state_t *s);
1086 void CL_MoveLerpEntityStates(entity_t *ent);
1087 void CL_LerpUpdate(entity_t *e);
1088 void CL_ParseTEnt (void);
1089 void CL_NewBeam (int ent, vec3_t start, vec3_t end, model_t *m, int lightning);
1090 void CL_RelinkBeams (void);
1091 void CL_Beam_CalculatePositions (const beam_t *b, vec3_t start, vec3_t end);
1092 void CL_ClientMovement_Replay(void);
1093
1094 void CL_ClearTempEntities (void);
1095 entity_t *CL_NewTempEntity (void);
1096
1097 void CL_Effect(vec3_t org, int modelindex, int startframe, int framecount, float framerate);
1098
1099 void CL_ClearState (void);
1100 void CL_ExpandEntities(int num);
1101 void CL_SetInfo(const char *key, const char *value, qboolean send, qboolean allowstarkey, qboolean allowmodel, qboolean quiet);
1102
1103
1104 void CL_UpdateWorld (void);
1105 void CL_WriteToServer (void);
1106 void CL_Input (void);
1107 extern qboolean cl_ignoremousemove;
1108
1109
1110 float CL_KeyState (kbutton_t *key);
1111 const char *Key_KeynumToString (int keynum);
1112 int Key_StringToKeynum (const char *str);
1113
1114 //
1115 // cl_demo.c
1116 //
1117 void CL_StopPlayback(void);
1118 void CL_ReadDemoMessage(void);
1119 void CL_WriteDemoMessage(sizebuf_t *mesage);
1120
1121 void CL_NextDemo(void);
1122 void CL_Stop_f(void);
1123 void CL_Record_f(void);
1124 void CL_PlayDemo_f(void);
1125 void CL_TimeDemo_f(void);
1126
1127 //
1128 // cl_parse.c
1129 //
1130 void CL_Parse_Init(void);
1131 void CL_Parse_Shutdown(void);
1132 void CL_ParseServerMessage(void);
1133 void CL_Parse_DumpPacket(void);
1134 void CL_Parse_ErrorCleanUp(void);
1135 void QW_CL_StartUpload(unsigned char *data, int size);
1136 extern cvar_t qport;
1137
1138 //
1139 // view
1140 //
1141 void V_StartPitchDrift (void);
1142 void V_StopPitchDrift (void);
1143
1144 void V_Init (void);
1145 float V_CalcRoll (vec3_t angles, vec3_t velocity);
1146 void V_UpdateBlends (void);
1147 void V_ParseDamage (void);
1148
1149 //
1150 // cl_part
1151 //
1152
1153 extern cvar_t cl_particles;
1154 extern cvar_t cl_particles_quality;
1155 extern cvar_t cl_particles_size;
1156 extern cvar_t cl_particles_quake;
1157 extern cvar_t cl_particles_blood;
1158 extern cvar_t cl_particles_blood_alpha;
1159 extern cvar_t cl_particles_blood_bloodhack;
1160 extern cvar_t cl_particles_bulletimpacts;
1161 extern cvar_t cl_particles_explosions_smoke;
1162 extern cvar_t cl_particles_explosions_sparks;
1163 extern cvar_t cl_particles_explosions_shell;
1164 extern cvar_t cl_particles_rain;
1165 extern cvar_t cl_particles_snow;
1166 extern cvar_t cl_particles_smoke;
1167 extern cvar_t cl_particles_smoke_alpha;
1168 extern cvar_t cl_particles_smoke_alphafade;
1169 extern cvar_t cl_particles_sparks;
1170 extern cvar_t cl_particles_bubbles;
1171 extern cvar_t cl_decals;
1172 extern cvar_t cl_decals_time;
1173 extern cvar_t cl_decals_fadetime;
1174
1175 void CL_Particles_Clear(void);
1176 void CL_Particles_Init(void);
1177 void CL_Particles_Shutdown(void);
1178
1179 typedef enum effectnameindex_s
1180 {
1181         EFFECT_NONE,
1182         EFFECT_TE_GUNSHOT,
1183         EFFECT_TE_GUNSHOTQUAD,
1184         EFFECT_TE_SPIKE,
1185         EFFECT_TE_SPIKEQUAD,
1186         EFFECT_TE_SUPERSPIKE,
1187         EFFECT_TE_SUPERSPIKEQUAD,
1188         EFFECT_TE_WIZSPIKE,
1189         EFFECT_TE_KNIGHTSPIKE,
1190         EFFECT_TE_EXPLOSION,
1191         EFFECT_TE_EXPLOSIONQUAD,
1192         EFFECT_TE_TAREXPLOSION,
1193         EFFECT_TE_TELEPORT,
1194         EFFECT_TE_LAVASPLASH,
1195         EFFECT_TE_SMALLFLASH,
1196         EFFECT_TE_FLAMEJET,
1197         EFFECT_EF_FLAME,
1198         EFFECT_TE_BLOOD,
1199         EFFECT_TE_SPARK,
1200         EFFECT_TE_PLASMABURN,
1201         EFFECT_TE_TEI_G3,
1202         EFFECT_TE_TEI_SMOKE,
1203         EFFECT_TE_TEI_BIGEXPLOSION,
1204         EFFECT_TE_TEI_PLASMAHIT,
1205         EFFECT_EF_STARDUST,
1206         EFFECT_TR_ROCKET,
1207         EFFECT_TR_GRENADE,
1208         EFFECT_TR_BLOOD,
1209         EFFECT_TR_WIZSPIKE,
1210         EFFECT_TR_SLIGHTBLOOD,
1211         EFFECT_TR_KNIGHTSPIKE,
1212         EFFECT_TR_VORESPIKE,
1213         EFFECT_TR_NEHAHRASMOKE,
1214         EFFECT_TR_NEXUIZPLASMA,
1215         EFFECT_TR_GLOWTRAIL,
1216         EFFECT_SVC_PARTICLE,
1217         EFFECT_TOTAL
1218 }
1219 effectnameindex_t;
1220
1221 int CL_ParticleEffectIndexForName(const char *name);
1222 const char *CL_ParticleEffectNameForIndex(int i);
1223 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);
1224 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);
1225 void CL_ParseParticleEffect (void);
1226 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);
1227 void CL_ParticleRain (const vec3_t mins, const vec3_t maxs, const vec3_t dir, int count, int colorbase, int type);
1228 void CL_EntityParticles (const entity_t *ent);
1229 void CL_ParticleExplosion (const vec3_t org);
1230 void CL_ParticleExplosion2 (const vec3_t org, int colorStart, int colorLength);
1231 void CL_MoveParticles(void);
1232 void R_MoveExplosions(void);
1233 void R_NewExplosion(const vec3_t org);
1234
1235 void Debug_PolygonBegin(const char *picname, int flags, qboolean draw2d, float linewidth);
1236 void Debug_PolygonVertex(float x, float y, float z, float s, float t, float r, float g, float b, float a);
1237 void Debug_PolygonEnd(void);
1238
1239 #include "cl_screen.h"
1240
1241 extern qboolean sb_showscores;
1242
1243 #define NUMCROSSHAIRS 32
1244 extern cachepic_t *r_crosshairs[NUMCROSSHAIRS+1];
1245
1246 float FogPoint_World(const vec3_t p);
1247 float FogPoint_Model(const vec3_t p);
1248
1249 typedef struct r_refdef_stats_s
1250 {
1251         int entities;
1252         int entities_surfaces;
1253         int entities_triangles;
1254         int world_leafs;
1255         int world_portals;
1256         int particles;
1257         int meshes;
1258         int meshes_elements;
1259         int lights;
1260         int lights_clears;
1261         int lights_scissored;
1262         int lights_lighttriangles;
1263         int lights_shadowtriangles;
1264         int lights_dynamicshadowtriangles;
1265         int bloom;
1266         int bloom_copypixels;
1267         int bloom_drawpixels;
1268 }
1269 r_refdef_stats_t;
1270
1271 typedef struct r_refdef_s
1272 {
1273         // these fields define the basic rendering information for the world
1274         // but not the view, which could change multiple times in one rendered
1275         // frame (for example when rendering textures for certain effects)
1276
1277         // these are set for water warping before
1278         // frustum_x/frustum_y are calculated
1279         float frustumscale_x, frustumscale_y;
1280
1281         // minimum visible distance (pixels closer than this disappear)
1282         double nearclip;
1283         // maximum visible distance (pixels further than this disappear in 16bpp modes,
1284         // in 32bpp an infinite-farclip matrix is used instead)
1285         double farclip;
1286
1287         // fullscreen color blend
1288         float viewblend[4];
1289
1290         // whether to call S_ExtraUpdate during render to reduce sound chop
1291         qboolean extraupdate;
1292
1293         // client gameworld time for rendering time based effects
1294         double time;
1295
1296         // the world
1297         entity_render_t *worldentity;
1298
1299         // same as worldentity->model
1300         model_t *worldmodel;
1301
1302         // renderable entities (excluding world)
1303         entity_render_t **entities;
1304         int numentities;
1305         int maxentities;
1306
1307         // renderable dynamic lights
1308         rtlight_t lights[MAX_DLIGHTS];
1309         int numlights;
1310
1311         // 8.8bit fixed point intensities for light styles
1312         // controls intensity of dynamic lights and lightmap layers
1313         unsigned short  lightstylevalue[256];   // 8.8 fraction of base light value
1314
1315         vec3_t fogcolor;
1316         vec_t fogrange;
1317         vec_t fograngerecip;
1318         vec_t fogmasktabledistmultiplier;
1319 #define FOGMASKTABLEWIDTH 1024
1320         float fogmasktable[FOGMASKTABLEWIDTH];
1321         float fog_density;
1322         float fog_red;
1323         float fog_green;
1324         float fog_blue;
1325         qboolean fogenabled;
1326         qboolean oldgl_fogenable;
1327
1328         qboolean draw2dstage;
1329
1330         // true during envmap command capture
1331         qboolean envmap;
1332
1333         // brightness of world lightmaps and related lighting
1334         // (often reduced when world rtlights are enabled)
1335         float lightmapintensity;
1336         // whether to draw world lights realtime, dlights realtime, and their shadows
1337         qboolean rtworld;
1338         qboolean rtworldshadows;
1339         qboolean rtdlight;
1340         qboolean rtdlightshadows;
1341         float polygonfactor;
1342         float polygonoffset;
1343         float shadowpolygonfactor;
1344         float shadowpolygonoffset;
1345
1346         // rendering stats for r_speeds display
1347         // (these are incremented in many places)
1348         r_refdef_stats_t stats;
1349 }
1350 r_refdef_t;
1351
1352 typedef struct r_view_s
1353 {
1354         // view information (changes multiple times per frame)
1355         // if any of these variables change then r_viewcache must be regenerated
1356         // by calling R_View_Update
1357         // (which also updates viewport, scissor, colormask)
1358
1359         // it is safe and expected to copy this into a structure on the stack and
1360         // call the renderer recursively, then restore from the stack afterward
1361         // (as long as R_View_Update is called)
1362
1363         // eye position information
1364         matrix4x4_t matrix;
1365         vec3_t origin;
1366         vec3_t forward;
1367         vec3_t left;
1368         vec3_t right;
1369         vec3_t up;
1370         mplane_t frustum[5];
1371         float frustum_x, frustum_y;
1372         vec3_t frustumcorner[4];
1373
1374         // screen area to render in
1375         int x;
1376         int y;
1377         int z;
1378         int width;
1379         int height;
1380         int depth;
1381
1382         // which color components to allow (for anaglyph glasses)
1383         int colormask[4];
1384
1385         // global RGB color multiplier for rendering, this is required by HDR
1386         float colorscale;
1387 }
1388 r_view_t;
1389
1390 typedef struct r_viewcache_s
1391 {
1392         // these properties are generated by R_View_Update()
1393
1394         // which entities are currently visible for this viewpoint
1395         // (the used range is 0...r_refdef.numentities)
1396         unsigned char entityvisible[MAX_EDICTS];
1397         // flag arrays used for visibility checking on world model
1398         // (all other entities have no per-surface/per-leaf visibility checks)
1399         // TODO: dynamic resize according to r_refdef.worldmodel->brush.num_clusters
1400         unsigned char world_pvsbits[(32768+7)>>3];
1401         // TODO: dynamic resize according to r_refdef.worldmodel->brush.num_leafs
1402         unsigned char world_leafvisible[32768];
1403         // TODO: dynamic resize according to r_refdef.worldmodel->num_surfaces
1404         unsigned char world_surfacevisible[262144];
1405         // if true, the view is currently in a leaf without pvs data
1406         qboolean world_novis;
1407 }
1408 r_viewcache_t;
1409
1410 extern r_refdef_t r_refdef;
1411 extern r_view_t r_view;
1412 extern r_viewcache_t r_viewcache;
1413
1414 #endif
1415