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.
20 // cl.input.c -- builds an intended movement command to send to the server
22 // Quake is a trademark of Id Software, Inc., (c) 1996 Id Software, Inc. All
29 ===============================================================================
33 Continuous button event tracking is complicated by the fact that two different
34 input sources (say, mouse button 1 and the control key) can both press the
35 same button, but the button should only be released when both of the
36 pressing key have been released.
38 When a key event issues a button command (+forward, +attack, etc), it appends
39 its key number as a parameter to the command so it can be matched up with
42 state bit 0 is the current state of the key
43 state bit 1 is edge triggered on the up to down transition
44 state bit 2 is edge triggered on the down to up transition
46 ===============================================================================
50 kbutton_t in_mlook, in_klook;
51 kbutton_t in_left, in_right, in_forward, in_back;
52 kbutton_t in_lookup, in_lookdown, in_moveleft, in_moveright;
53 kbutton_t in_strafe, in_speed, in_jump, in_attack, in_use;
54 kbutton_t in_up, in_down;
55 // LordHavoc: added 6 new buttons
56 kbutton_t in_button3, in_button4, in_button5, in_button6, in_button7, in_button8;
58 kbutton_t in_button9, in_button10, in_button11, in_button12, in_button13, in_button14, in_button15, in_button16;
64 void KeyDown (kbutton_t *b)
73 k = -1; // typed manually at the console for continuous down
75 if (k == b->down[0] || k == b->down[1])
76 return; // repeating key
84 Con_Print("Three keys down for a button!\n");
90 b->state |= 1 + 2; // down + impulse down
93 void KeyUp (kbutton_t *b)
102 { // typed manually at the console, assume for unsticking, so clear all
103 b->down[0] = b->down[1] = 0;
104 b->state = 4; // impulse up
110 else if (b->down[1] == k)
113 return; // key up without coresponding down (menu pass through)
114 if (b->down[0] || b->down[1])
115 return; // some other key is still holding it down
118 return; // still up (this should not happen)
119 b->state &= ~1; // now up
120 b->state |= 4; // impulse up
123 void IN_KLookDown (void) {KeyDown(&in_klook);}
124 void IN_KLookUp (void) {KeyUp(&in_klook);}
125 void IN_MLookDown (void) {KeyDown(&in_mlook);}
126 void IN_MLookUp (void)
129 if ( !(in_mlook.state&1) && lookspring.value)
132 void IN_UpDown(void) {KeyDown(&in_up);}
133 void IN_UpUp(void) {KeyUp(&in_up);}
134 void IN_DownDown(void) {KeyDown(&in_down);}
135 void IN_DownUp(void) {KeyUp(&in_down);}
136 void IN_LeftDown(void) {KeyDown(&in_left);}
137 void IN_LeftUp(void) {KeyUp(&in_left);}
138 void IN_RightDown(void) {KeyDown(&in_right);}
139 void IN_RightUp(void) {KeyUp(&in_right);}
140 void IN_ForwardDown(void) {KeyDown(&in_forward);}
141 void IN_ForwardUp(void) {KeyUp(&in_forward);}
142 void IN_BackDown(void) {KeyDown(&in_back);}
143 void IN_BackUp(void) {KeyUp(&in_back);}
144 void IN_LookupDown(void) {KeyDown(&in_lookup);}
145 void IN_LookupUp(void) {KeyUp(&in_lookup);}
146 void IN_LookdownDown(void) {KeyDown(&in_lookdown);}
147 void IN_LookdownUp(void) {KeyUp(&in_lookdown);}
148 void IN_MoveleftDown(void) {KeyDown(&in_moveleft);}
149 void IN_MoveleftUp(void) {KeyUp(&in_moveleft);}
150 void IN_MoverightDown(void) {KeyDown(&in_moveright);}
151 void IN_MoverightUp(void) {KeyUp(&in_moveright);}
153 void IN_SpeedDown(void) {KeyDown(&in_speed);}
154 void IN_SpeedUp(void) {KeyUp(&in_speed);}
155 void IN_StrafeDown(void) {KeyDown(&in_strafe);}
156 void IN_StrafeUp(void) {KeyUp(&in_strafe);}
158 void IN_AttackDown(void) {KeyDown(&in_attack);}
159 void IN_AttackUp(void) {KeyUp(&in_attack);}
161 void IN_UseDown(void) {KeyDown(&in_use);}
162 void IN_UseUp(void) {KeyUp(&in_use);}
164 // LordHavoc: added 6 new buttons
165 void IN_Button3Down(void) {KeyDown(&in_button3);}
166 void IN_Button3Up(void) {KeyUp(&in_button3);}
167 void IN_Button4Down(void) {KeyDown(&in_button4);}
168 void IN_Button4Up(void) {KeyUp(&in_button4);}
169 void IN_Button5Down(void) {KeyDown(&in_button5);}
170 void IN_Button5Up(void) {KeyUp(&in_button5);}
171 void IN_Button6Down(void) {KeyDown(&in_button6);}
172 void IN_Button6Up(void) {KeyUp(&in_button6);}
173 void IN_Button7Down(void) {KeyDown(&in_button7);}
174 void IN_Button7Up(void) {KeyUp(&in_button7);}
175 void IN_Button8Down(void) {KeyDown(&in_button8);}
176 void IN_Button8Up(void) {KeyUp(&in_button8);}
178 void IN_Button9Down(void) {KeyDown(&in_button9);}
179 void IN_Button9Up(void) {KeyUp(&in_button9);}
180 void IN_Button10Down(void) {KeyDown(&in_button10);}
181 void IN_Button10Up(void) {KeyUp(&in_button10);}
182 void IN_Button11Down(void) {KeyDown(&in_button11);}
183 void IN_Button11Up(void) {KeyUp(&in_button11);}
184 void IN_Button12Down(void) {KeyDown(&in_button12);}
185 void IN_Button12Up(void) {KeyUp(&in_button12);}
186 void IN_Button13Down(void) {KeyDown(&in_button13);}
187 void IN_Button13Up(void) {KeyUp(&in_button13);}
188 void IN_Button14Down(void) {KeyDown(&in_button14);}
189 void IN_Button14Up(void) {KeyUp(&in_button14);}
190 void IN_Button15Down(void) {KeyDown(&in_button15);}
191 void IN_Button15Up(void) {KeyUp(&in_button15);}
192 void IN_Button16Down(void) {KeyDown(&in_button16);}
193 void IN_Button16Up(void) {KeyUp(&in_button16);}
195 void IN_JumpDown (void) {KeyDown(&in_jump);}
196 void IN_JumpUp (void) {KeyUp(&in_jump);}
198 void IN_Impulse (void) {in_impulse=atoi(Cmd_Argv(1));}
208 in_bestweapon_info[] =
210 {"1", 1, IT_AXE, STAT_SHELLS, 0},
211 {"2", 2, IT_SHOTGUN, STAT_SHELLS, 1},
212 {"3", 3, IT_SUPER_SHOTGUN, STAT_SHELLS, 1},
213 {"4", 4, IT_NAILGUN, STAT_NAILS, 1},
214 {"5", 5, IT_SUPER_NAILGUN, STAT_NAILS, 1},
215 {"6", 6, IT_GRENADE_LAUNCHER, STAT_ROCKETS, 1},
216 {"7", 7, IT_ROCKET_LAUNCHER, STAT_ROCKETS, 1},
217 {"8", 8, IT_LIGHTNING, STAT_CELLS, 1},
218 {"9", 9, 128, STAT_CELLS, 1}, // generic energy weapon for mods
219 {"p", 209, 128, STAT_CELLS, 1}, // dpmod plasma gun
220 {"w", 210, 8388608, STAT_CELLS, 1}, // dpmod plasma wave cannon
221 {"l", 225, HIT_LASER_CANNON, STAT_CELLS, 1}, // hipnotic laser cannon
222 {"h", 226, HIT_MJOLNIR, STAT_CELLS, 0}, // hipnotic mjolnir hammer
225 void IN_BestWeapon (void)
231 Con_Printf("bestweapon requires 1 or more parameters\n");
234 for (i = 1;i < Cmd_Argc();i++)
237 // figure out which weapon this character refers to
238 for (n = 0;in_bestweapon_info[n].name;n++)
240 if (!strcmp(in_bestweapon_info[n].name, t))
242 // we found out what weapon this character refers to
243 // check if the inventory contains the weapon and enough ammo
244 if ((cl.stats[STAT_ITEMS] & in_bestweapon_info[n].weaponbit) && (cl.stats[in_bestweapon_info[n].ammostat] >= in_bestweapon_info[n].ammomin))
246 // we found one of the weapons the player wanted
247 // send an impulse to switch to it
248 in_impulse = in_bestweapon_info[n].impulse;
254 // if we couldn't identify the weapon we just ignore it and continue checking for other weapons
256 // if we couldn't find any of the weapons, there's nothing more we can do...
263 Returns 0.25 if a key was pressed and released during the frame,
264 0.5 if it was pressed and held
265 0 if held then released, and
266 1.0 if held for the entire time
269 float CL_KeyState (kbutton_t *key)
272 qboolean impulsedown, impulseup, down;
274 impulsedown = key->state & 2;
275 impulseup = key->state & 4;
276 down = key->state & 1;
279 if (impulsedown && !impulseup)
282 val = 0.5; // pressed and held this frame
284 val = 0; // I_Error ();
286 if (impulseup && !impulsedown)
289 val = 0; // I_Error ();
291 val = 0; // released this frame
293 if (!impulsedown && !impulseup)
296 val = 1.0; // held the entire frame
298 val = 0; // up the entire frame
300 if (impulsedown && impulseup)
303 val = 0.75; // released and re-pressed this frame
305 val = 0.25; // pressed and released this frame
308 key->state &= 1; // clear impulses
316 //==========================================================================
318 cvar_t cl_upspeed = {CVAR_SAVE, "cl_upspeed","400","vertical movement speed (while swimming or flying)"};
319 cvar_t cl_forwardspeed = {CVAR_SAVE, "cl_forwardspeed","400","forward movement speed"};
320 cvar_t cl_backspeed = {CVAR_SAVE, "cl_backspeed","400","backward movement speed"};
321 cvar_t cl_sidespeed = {CVAR_SAVE, "cl_sidespeed","350","strafe movement speed"};
323 cvar_t cl_movespeedkey = {CVAR_SAVE, "cl_movespeedkey","2.0","how much +speed multiplies keyboard movement speed"};
325 cvar_t cl_yawspeed = {CVAR_SAVE, "cl_yawspeed","140","keyboard yaw turning speed"};
326 cvar_t cl_pitchspeed = {CVAR_SAVE, "cl_pitchspeed","150","keyboard pitch turning speed"};
328 cvar_t cl_anglespeedkey = {CVAR_SAVE, "cl_anglespeedkey","1.5","how much +speed multiplies keyboard turning speed"};
330 cvar_t cl_movement = {CVAR_SAVE, "cl_movement", "0", "enables clientside prediction of your player movement"};
331 cvar_t cl_movement_minping = {CVAR_SAVE, "cl_movement_minping", "0", "whether to use prediction when ping is lower than this value in milliseconds"};
332 cvar_t cl_movement_maxspeed = {0, "cl_movement_maxspeed", "320", "how fast you can move (should match sv_maxspeed)"};
333 cvar_t cl_movement_maxairspeed = {0, "cl_movement_maxairspeed", "30", "how fast you can move while in the air (should match sv_maxairspeed)"};
334 cvar_t cl_movement_stopspeed = {0, "cl_movement_stopspeed", "100", "speed below which you will be slowed rapidly to a stop rather than sliding endlessly (should match sv_stopspeed)"};
335 cvar_t cl_movement_friction = {0, "cl_movement_friction", "4", "how fast you slow down (should match sv_friction)"};
336 cvar_t cl_movement_waterfriction = {0, "cl_movement_waterfriction", "-1", "how fast you slow down (should match sv_friction), if less than 0 the cl_movement_friction variable is used instead"};
337 cvar_t cl_movement_edgefriction = {0, "cl_movement_edgefriction", "2", "how much to slow down when you may be about to fall off a ledge (should match edgefriction)"};
338 cvar_t cl_movement_stepheight = {0, "cl_movement_stepheight", "18", "how tall a step you can step in one instant (should match sv_stepheight)"};
339 cvar_t cl_movement_accelerate = {0, "cl_movement_accelerate", "10", "how fast you accelerate (should match sv_accelerate)"};
340 cvar_t cl_movement_airaccelerate = {0, "cl_movement_airaccelerate", "-1", "how fast you accelerate while in the air (should match sv_airaccelerate), if less than 0 the cl_movement_accelerate variable is used instead"};
341 cvar_t cl_movement_wateraccelerate = {0, "cl_movement_wateraccelerate", "-1", "how fast you accelerate while in the air (should match sv_airaccelerate), if less than 0 the cl_movement_accelerate variable is used instead"};
342 cvar_t cl_movement_jumpvelocity = {0, "cl_movement_jumpvelocity", "270", "how fast you move upward when you begin a jump (should match the quakec code)"};
343 cvar_t cl_movement_airaccel_qw = {0, "cl_movement_airaccel_qw", "1", "ratio of QW-style air control as opposed to simple acceleration (should match sv_airaccel_qw)"};
344 cvar_t cl_movement_airaccel_sideways_friction = {0, "cl_movement_airaccel_sideways_friction", "0", "anti-sideways movement stabilization (should match sv_airaccel_sideways_friction)"};
345 cvar_t cl_gravity = {0, "cl_gravity", "800", "how much gravity to apply in client physics (should match sv_gravity)"};
346 cvar_t cl_slowmo = {0, "cl_slowmo", "1", "speed of game time (should match slowmo)"};
348 cvar_t in_pitch_min = {0, "in_pitch_min", "-90", "how far downward you can aim (quake used -70"};
349 cvar_t in_pitch_max = {0, "in_pitch_max", "90", "how far upward you can aim (quake used 80"};
351 cvar_t m_filter = {CVAR_SAVE, "m_filter","0", "smoothes mouse movement, less responsive but smoother aiming"};
353 cvar_t cl_netinputpacketspersecond = {CVAR_SAVE, "cl_netinputpacketspersecond","50", "how many input packets to send to server each second"};
354 cvar_t cl_netinputpacketlosstolerance = {CVAR_SAVE, "cl_netinputpacketlosstolerance", "1", "how many packets in a row can be lost without movement issues when using cl_movement (technically how many input messages to repeat in each packet that have not yet been acknowledged by the server), only affects DP7 and later servers (Quake uses 0, QuakeWorld uses 2, and just for comparison Quake3 uses 1)"};
356 cvar_t cl_nodelta = {0, "cl_nodelta", "0", "disables delta compression of non-player entities in QW network protocol"};
363 Moves the local angle positions
366 void CL_AdjustAngles (void)
371 if (in_speed.state & 1)
372 speed = cl.realframetime * cl_anglespeedkey.value;
374 speed = cl.realframetime;
376 if (!(in_strafe.state & 1))
378 cl.viewangles[YAW] -= speed*cl_yawspeed.value*CL_KeyState (&in_right);
379 cl.viewangles[YAW] += speed*cl_yawspeed.value*CL_KeyState (&in_left);
381 if (in_klook.state & 1)
384 cl.viewangles[PITCH] -= speed*cl_pitchspeed.value * CL_KeyState (&in_forward);
385 cl.viewangles[PITCH] += speed*cl_pitchspeed.value * CL_KeyState (&in_back);
388 up = CL_KeyState (&in_lookup);
389 down = CL_KeyState(&in_lookdown);
391 cl.viewangles[PITCH] -= speed*cl_pitchspeed.value * up;
392 cl.viewangles[PITCH] += speed*cl_pitchspeed.value * down;
397 cl.viewangles[YAW] = ANGLEMOD(cl.viewangles[YAW]);
398 cl.viewangles[PITCH] = ANGLEMOD(cl.viewangles[PITCH]);
399 cl.viewangles[ROLL] = ANGLEMOD(cl.viewangles[ROLL]);
400 if (cl.viewangles[YAW] >= 180)
401 cl.viewangles[YAW] -= 360;
402 if (cl.viewangles[PITCH] >= 180)
403 cl.viewangles[PITCH] -= 360;
404 if (cl.viewangles[ROLL] >= 180)
405 cl.viewangles[ROLL] -= 360;
407 cl.viewangles[PITCH] = bound (in_pitch_min.value, cl.viewangles[PITCH], in_pitch_max.value);
408 cl.viewangles[ROLL] = bound(-50, cl.viewangles[ROLL], 50);
411 qboolean cl_ignoremousemove = false;
417 Send the intended movement message to the server
423 static float old_mouse_x = 0, old_mouse_y = 0;
425 // clamp before the move to prevent starting with bad angles
428 // reset some of the command fields
429 cl.cmd.forwardmove = 0;
433 // get basic movement from keyboard
434 if (in_strafe.state & 1)
436 cl.cmd.sidemove += cl_sidespeed.value * CL_KeyState (&in_right);
437 cl.cmd.sidemove -= cl_sidespeed.value * CL_KeyState (&in_left);
440 cl.cmd.sidemove += cl_sidespeed.value * CL_KeyState (&in_moveright);
441 cl.cmd.sidemove -= cl_sidespeed.value * CL_KeyState (&in_moveleft);
443 cl.cmd.upmove += cl_upspeed.value * CL_KeyState (&in_up);
444 cl.cmd.upmove -= cl_upspeed.value * CL_KeyState (&in_down);
446 if (! (in_klook.state & 1) )
448 cl.cmd.forwardmove += cl_forwardspeed.value * CL_KeyState (&in_forward);
449 cl.cmd.forwardmove -= cl_backspeed.value * CL_KeyState (&in_back);
452 // adjust for speed key
453 if (in_speed.state & 1)
455 cl.cmd.forwardmove *= cl_movespeedkey.value;
456 cl.cmd.sidemove *= cl_movespeedkey.value;
457 cl.cmd.upmove *= cl_movespeedkey.value;
463 // allow mice or other external controllers to add to the move
466 // ignore a mouse move if mouse was activated/deactivated this frame
467 if (cl_ignoremousemove)
469 cl_ignoremousemove = false;
474 // apply m_filter if it is on
477 if (m_filter.integer)
479 in_mouse_x = (mx + old_mouse_x) * 0.5;
480 in_mouse_y = (my + old_mouse_y) * 0.5;
485 // if not in menu, apply mouse move to viewangles/movement
486 if (!cl.csqc_wantsmousemove && in_client_mouse)
488 if (cl_prydoncursor.integer)
490 // mouse interacting with the scene, mostly stationary view
492 cl.cmd.cursor_screen[0] += in_mouse_x * sensitivity.value / vid.width;
493 cl.cmd.cursor_screen[1] += in_mouse_y * sensitivity.value / vid.height;
495 else if (in_strafe.state & 1)
497 // strafing mode, all looking is movement
499 cl.cmd.sidemove += m_side.value * in_mouse_x * sensitivity.value;
500 if (noclip_anglehack)
501 cl.cmd.upmove -= m_forward.value * in_mouse_y * sensitivity.value;
503 cl.cmd.forwardmove -= m_forward.value * in_mouse_y * sensitivity.value;
505 else if ((in_mlook.state & 1) || freelook.integer)
507 // mouselook, lookstrafe causes turning to become strafing
509 if (lookstrafe.integer)
510 cl.cmd.sidemove += m_side.value * in_mouse_x * sensitivity.value;
512 cl.viewangles[YAW] -= m_yaw.value * in_mouse_x * sensitivity.value * cl.viewzoom;
513 cl.viewangles[PITCH] += m_pitch.value * in_mouse_y * sensitivity.value * cl.viewzoom;
517 // non-mouselook, yaw turning and forward/back movement
518 cl.viewangles[YAW] -= m_yaw.value * in_mouse_x * sensitivity.value * cl.viewzoom;
519 cl.cmd.forwardmove -= m_forward.value * in_mouse_y * sensitivity.value;
523 // clamp after the move to prevent rendering with bad angles
527 #include "cl_collision.h"
529 void CL_UpdatePrydonCursor(void)
533 if (!cl_prydoncursor.integer)
534 VectorClear(cl.cmd.cursor_screen);
537 if (cl.cmd.cursor_screen[0] < -1)
539 cl.viewangles[YAW] -= m_yaw.value * (cl.cmd.cursor_screen[0] - -1) * vid.width * sensitivity.value * cl.viewzoom;
540 cl.cmd.cursor_screen[0] = -1;
542 if (cl.cmd.cursor_screen[0] > 1)
544 cl.viewangles[YAW] -= m_yaw.value * (cl.cmd.cursor_screen[0] - 1) * vid.width * sensitivity.value * cl.viewzoom;
545 cl.cmd.cursor_screen[0] = 1;
547 if (cl.cmd.cursor_screen[1] < -1)
549 cl.viewangles[PITCH] += m_pitch.value * (cl.cmd.cursor_screen[1] - -1) * vid.height * sensitivity.value * cl.viewzoom;
550 cl.cmd.cursor_screen[1] = -1;
552 if (cl.cmd.cursor_screen[1] > 1)
554 cl.viewangles[PITCH] += m_pitch.value * (cl.cmd.cursor_screen[1] - 1) * vid.height * sensitivity.value * cl.viewzoom;
555 cl.cmd.cursor_screen[1] = 1;
558 cl.cmd.cursor_screen[0] = bound(-1, cl.cmd.cursor_screen[0], 1);
559 cl.cmd.cursor_screen[1] = bound(-1, cl.cmd.cursor_screen[1], 1);
560 cl.cmd.cursor_screen[2] = 1;
562 // calculate current view matrix
563 Matrix4x4_OriginFromMatrix(&r_view.matrix, cl.cmd.cursor_start);
564 // calculate direction vector of cursor in viewspace by using frustum slopes
565 VectorSet(temp, cl.cmd.cursor_screen[2] * 1000000, cl.cmd.cursor_screen[0] * -r_view.frustum_x * 1000000, cl.cmd.cursor_screen[1] * -r_view.frustum_y * 1000000);
566 Matrix4x4_Transform(&r_view.matrix, temp, cl.cmd.cursor_end);
567 // trace from view origin to the cursor
568 cl.cmd.cursor_fraction = CL_SelectTraceLine(cl.cmd.cursor_start, cl.cmd.cursor_end, cl.cmd.cursor_impact, cl.cmd.cursor_normal, &cl.cmd.cursor_entitynumber, (chase_active.integer || cl.intermission) ? &cl.entities[cl.playerentity].render : NULL);
571 void CL_ClientMovement_ExpireOldMoves(void)
575 // remove stale queue items
576 n = cl.movement_numqueue;
577 cl.movement_numqueue = 0;
578 if (cls.servermovesequence)
580 for (i = 0;i < n;i++)
582 if (cl.movement_queue[i].sequence > cls.servermovesequence)
583 cl.movement_queue[cl.movement_numqueue++] = cl.movement_queue[i];
585 cl.movement_replay_canjump = cl.movement_queue[i].canjump;
590 void CL_ClientMovement_Input(qboolean buttonjump, qboolean buttoncrouch)
592 // if time has not advanced, do nothing
593 if (cl.movecmd[0].msec <= 0)
595 // add to input queue if there is room
596 if (cl.movement_numqueue < (int)(sizeof(cl.movement_queue)/sizeof(cl.movement_queue[0])))
598 // add to input queue
599 cl.movement_queue[cl.movement_numqueue].sequence = cl.movecmd[0].sequence;
600 cl.movement_queue[cl.movement_numqueue].time = cl.movecmd[0].time;
601 cl.movement_queue[cl.movement_numqueue].frametime = cl.movecmd[0].msec * 0.001;
602 VectorCopy(cl.movecmd[0].viewangles, cl.movement_queue[cl.movement_numqueue].viewangles);
603 cl.movement_queue[cl.movement_numqueue].move[0] = cl.movecmd[0].forwardmove;
604 cl.movement_queue[cl.movement_numqueue].move[1] = cl.movecmd[0].sidemove;
605 cl.movement_queue[cl.movement_numqueue].move[2] = cl.movecmd[0].upmove;
606 cl.movement_queue[cl.movement_numqueue].jump = buttonjump;
607 cl.movement_queue[cl.movement_numqueue].crouch = buttoncrouch;
608 cl.movement_numqueue++;
611 cl.movement_replay = true;
614 typedef enum waterlevel_e
623 typedef struct cl_clientmovement_state_s
628 // current bounding box (different if crouched vs standing)
631 // currently on the ground
633 // currently crouching
635 // what kind of water (SUPERCONTENTS_LAVA for instance)
638 waterlevel_t waterlevel;
639 // weird hacks when jumping out of water
640 // (this is in seconds and counts down to 0)
644 client_movementqueue_t q;
646 cl_clientmovement_state_t;
648 #define NUMOFFSETS 27
649 static vec3_t offsets[NUMOFFSETS] =
651 // 1 no nudge (just return the original if this test passes)
652 { 0.000, 0.000, 0.000},
654 { 0.000, 0.000, 0.125}, { 0.000, 0.000, -0.125},
655 {-0.125, 0.000, 0.000}, { 0.125, 0.000, 0.000},
656 { 0.000, -0.125, 0.000}, { 0.000, 0.125, 0.000},
657 // 4 diagonal flat nudges
658 {-0.125, -0.125, 0.000}, { 0.125, -0.125, 0.000},
659 {-0.125, 0.125, 0.000}, { 0.125, 0.125, 0.000},
660 // 8 diagonal upward nudges
661 {-0.125, 0.000, 0.125}, { 0.125, 0.000, 0.125},
662 { 0.000, -0.125, 0.125}, { 0.000, 0.125, 0.125},
663 {-0.125, -0.125, 0.125}, { 0.125, -0.125, 0.125},
664 {-0.125, 0.125, 0.125}, { 0.125, 0.125, 0.125},
665 // 8 diagonal downward nudges
666 {-0.125, 0.000, -0.125}, { 0.125, 0.000, -0.125},
667 { 0.000, -0.125, -0.125}, { 0.000, 0.125, -0.125},
668 {-0.125, -0.125, -0.125}, { 0.125, -0.125, -0.125},
669 {-0.125, 0.125, -0.125}, { 0.125, 0.125, -0.125},
672 qboolean CL_ClientMovement_Unstick(cl_clientmovement_state_t *s)
676 for (i = 0;i < NUMOFFSETS;i++)
678 VectorAdd(offsets[i], s->origin, neworigin);
679 if (!CL_Move(neworigin, cl.playercrouchmins, cl.playercrouchmaxs, neworigin, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false).startsolid)
681 VectorCopy(neworigin, s->origin);
685 // if all offsets failed, give up
689 void CL_ClientMovement_UpdateStatus(cl_clientmovement_state_t *s)
691 vec3_t origin1, origin2;
694 // make sure player is not stuck
695 CL_ClientMovement_Unstick(s);
700 // wants to crouch, this always works..
706 // wants to stand, if currently crouching we need to check for a
710 trace = CL_Move(s->origin, cl.playerstandmins, cl.playerstandmaxs, s->origin, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
711 if (!trace.startsolid)
717 VectorCopy(cl.playercrouchmins, s->mins);
718 VectorCopy(cl.playercrouchmaxs, s->maxs);
722 VectorCopy(cl.playerstandmins, s->mins);
723 VectorCopy(cl.playerstandmaxs, s->maxs);
727 VectorSet(origin1, s->origin[0], s->origin[1], s->origin[2] + 1);
728 VectorSet(origin2, s->origin[0], s->origin[1], s->origin[2] - 2);
729 trace = CL_Move(origin1, s->mins, s->maxs, origin2, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
730 s->onground = trace.fraction < 1 && trace.plane.normal[2] > 0.7;
732 // set watertype/waterlevel
733 VectorSet(origin1, s->origin[0], s->origin[1], s->origin[2] + s->mins[2] + 1);
734 s->waterlevel = WATERLEVEL_NONE;
735 s->watertype = CL_Move(origin1, vec3_origin, vec3_origin, origin1, MOVE_NOMONSTERS, NULL, 0, true, false, NULL, false).startsupercontents & SUPERCONTENTS_LIQUIDSMASK;
738 s->waterlevel = WATERLEVEL_WETFEET;
739 origin1[2] = s->origin[2] + (s->mins[2] + s->maxs[2]) * 0.5f;
740 if (CL_Move(origin1, vec3_origin, vec3_origin, origin1, MOVE_NOMONSTERS, NULL, 0, true, false, NULL, false).startsupercontents & SUPERCONTENTS_LIQUIDSMASK)
742 s->waterlevel = WATERLEVEL_SWIMMING;
743 origin1[2] = s->origin[2] + 22;
744 if (CL_Move(origin1, vec3_origin, vec3_origin, origin1, MOVE_NOMONSTERS, NULL, 0, true, false, NULL, false).startsupercontents & SUPERCONTENTS_LIQUIDSMASK)
745 s->waterlevel = WATERLEVEL_SUBMERGED;
749 // water jump prediction
750 if (s->onground || s->velocity[2] <= 0 || s->waterjumptime <= 0)
751 s->waterjumptime = 0;
754 void CL_ClientMovement_Move(cl_clientmovement_state_t *s)
760 vec3_t currentorigin2;
762 vec3_t primalvelocity;
766 CL_ClientMovement_UpdateStatus(s);
767 VectorCopy(s->velocity, primalvelocity);
768 for (bump = 0, t = s->q.frametime;bump < 8 && VectorLength2(s->velocity) > 0;bump++)
770 VectorMA(s->origin, t, s->velocity, neworigin);
771 trace = CL_Move(s->origin, s->mins, s->maxs, neworigin, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
772 if (trace.fraction < 1 && trace.plane.normal[2] == 0)
774 // may be a step or wall, try stepping up
775 // first move forward at a higher level
776 VectorSet(currentorigin2, s->origin[0], s->origin[1], s->origin[2] + cl.movevars_stepheight);
777 VectorSet(neworigin2, neworigin[0], neworigin[1], s->origin[2] + cl.movevars_stepheight);
778 trace2 = CL_Move(currentorigin2, s->mins, s->maxs, neworigin2, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
779 if (!trace2.startsolid)
781 // then move down from there
782 VectorCopy(trace2.endpos, currentorigin2);
783 VectorSet(neworigin2, trace2.endpos[0], trace2.endpos[1], s->origin[2]);
784 trace3 = CL_Move(currentorigin2, s->mins, s->maxs, neworigin2, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
785 //Con_Printf("%f %f %f %f : %f %f %f %f : %f %f %f %f\n", trace.fraction, trace.endpos[0], trace.endpos[1], trace.endpos[2], trace2.fraction, trace2.endpos[0], trace2.endpos[1], trace2.endpos[2], trace3.fraction, trace3.endpos[0], trace3.endpos[1], trace3.endpos[2]);
786 // accept the new trace if it made some progress
787 if (fabs(trace3.endpos[0] - trace.endpos[0]) >= 0.03125 || fabs(trace3.endpos[1] - trace.endpos[1]) >= 0.03125)
790 VectorCopy(trace3.endpos, trace.endpos);
795 // check if it moved at all
796 if (trace.fraction >= 0.001)
797 VectorCopy(trace.endpos, s->origin);
799 // check if it moved all the way
800 if (trace.fraction == 1)
803 //if (trace.plane.normal[2] > 0.7)
804 // s->onground = true;
806 t -= t * trace.fraction;
808 f = DotProduct(s->velocity, trace.plane.normal);
809 VectorMA(s->velocity, -f, trace.plane.normal, s->velocity);
811 if (s->waterjumptime > 0)
812 VectorCopy(primalvelocity, s->velocity);
816 void CL_ClientMovement_Physics_Swim(cl_clientmovement_state_t *s)
823 // water jump only in certain situations
824 // this mimics quakeworld code
825 if (s->q.jump && s->waterlevel == 2 && s->velocity[2] >= -180)
830 VectorSet(yawangles, 0, s->q.viewangles[1], 0);
831 AngleVectors(yawangles, forward, NULL, NULL);
832 VectorMA(s->origin, 24, forward, spot);
834 if (CL_Move(spot, vec3_origin, vec3_origin, spot, MOVE_NOMONSTERS, NULL, 0, true, false, NULL, false).startsolid)
837 if (!CL_Move(spot, vec3_origin, vec3_origin, spot, MOVE_NOMONSTERS, NULL, 0, true, false, NULL, false).startsolid)
839 VectorScale(forward, 50, s->velocity);
840 s->velocity[2] = 310;
841 s->waterjumptime = 2;
843 s->q.canjump = false;
848 if (!VectorLength2(s->q.move))
850 // drift towards bottom
851 VectorSet(wishvel, 0, 0, -60);
859 // calculate movement vector
860 AngleVectors(s->q.viewangles, forward, right, up);
861 VectorSet(up, 0, 0, 1);
862 VectorMAMAM(s->q.move[0], forward, s->q.move[1], right, s->q.move[2], up, wishvel);
865 // split wishvel into wishspeed and wishdir
866 wishspeed = VectorLength(wishvel);
868 VectorScale(wishvel, 1 / wishspeed, wishdir);
870 VectorSet( wishdir, 0.0, 0.0, 0.0 );
871 wishspeed = min(wishspeed, cl.movevars_maxspeed) * 0.7;
876 if (s->waterjumptime <= 0)
879 f = 1 - s->q.frametime * cl.movevars_waterfriction * s->waterlevel;
881 VectorScale(s->velocity, f, s->velocity);
883 // water acceleration
884 f = wishspeed - DotProduct(s->velocity, wishdir);
887 f = min(cl.movevars_wateraccelerate * s->q.frametime * wishspeed, f);
888 VectorMA(s->velocity, f, wishdir, s->velocity);
891 // holding jump button swims upward slowly
894 if (s->watertype & SUPERCONTENTS_LAVA)
896 else if (s->watertype & SUPERCONTENTS_SLIME)
900 if (gamemode == GAME_NEXUIZ)
901 s->velocity[2] = 200;
903 s->velocity[2] = 100;
908 CL_ClientMovement_Move(s);
911 void CL_ClientMovement_Physics_Walk(cl_clientmovement_state_t *s)
926 // jump if on ground with jump button pressed but only if it has been
927 // released at least once since the last jump
930 if (s->onground && s->q.canjump)
932 s->velocity[2] += cl.movevars_jumpvelocity;
934 s->q.canjump = false;
940 // calculate movement vector
941 VectorSet(yawangles, 0, s->q.viewangles[1], 0);
942 AngleVectors(yawangles, forward, right, up);
943 VectorMAM(s->q.move[0], forward, s->q.move[1], right, wishvel);
945 // split wishvel into wishspeed and wishdir
946 wishspeed = VectorLength(wishvel);
948 VectorScale(wishvel, 1 / wishspeed, wishdir);
950 VectorSet( wishdir, 0.0, 0.0, 0.0 );
951 wishspeed = min(wishspeed, cl.movevars_maxspeed);
958 // apply edge friction
959 f = sqrt(s->velocity[0] * s->velocity[0] + s->velocity[1] * s->velocity[1]);
960 friction = cl.movevars_friction;
961 if (f > 0 && cl.movevars_edgefriction != 1)
965 // note: QW uses the full player box for the trace, and yet still
966 // uses s->origin[2] + s->mins[2], which is clearly an bug, but
967 // this mimics it for compatibility
968 VectorSet(neworigin2, s->origin[0] + s->velocity[0]*(16/f), s->origin[1] + s->velocity[1]*(16/f), s->origin[2] + s->mins[2]);
969 VectorSet(neworigin3, neworigin2[0], neworigin2[1], neworigin2[2] - 34);
970 if (cls.protocol == PROTOCOL_QUAKEWORLD)
971 trace = CL_Move(neworigin2, s->mins, s->maxs, neworigin3, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
973 trace = CL_Move(neworigin2, vec3_origin, vec3_origin, neworigin3, MOVE_NORMAL, NULL, SUPERCONTENTS_SOLID | SUPERCONTENTS_BODY | SUPERCONTENTS_PLAYERCLIP, true, true, NULL, false);
974 if (trace.fraction == 1 && !trace.startsolid)
975 friction *= cl.movevars_edgefriction;
977 // apply ground friction
978 f = 1 - s->q.frametime * friction * ((f < cl.movevars_stopspeed) ? (cl.movevars_stopspeed / f) : 1);
980 VectorScale(s->velocity, f, s->velocity);
981 addspeed = wishspeed - DotProduct(s->velocity, wishdir);
984 accelspeed = min(cl.movevars_accelerate * s->q.frametime * wishspeed, addspeed);
985 VectorMA(s->velocity, accelspeed, wishdir, s->velocity);
987 s->velocity[2] -= cl_gravity.value * s->q.frametime;
988 if (cls.protocol == PROTOCOL_QUAKEWORLD)
990 if (VectorLength2(s->velocity))
991 CL_ClientMovement_Move(s);
995 if (s->waterjumptime <= 0)
1002 // apply air speed limit
1003 wishspeed = min(wishspeed, cl.movevars_maxairspeed);
1006 addspeed = wishspeed - DotProduct(s->velocity, wishdir);
1009 accelspeed = min(cl.movevars_accelerate * s->q.frametime * wishspeed, addspeed);
1010 VectorMA(s->velocity, accelspeed, wishdir, s->velocity);
1014 vel_straight = DotProduct(s->velocity, wishdir);
1015 vel_z = s->velocity[2];
1016 VectorMA(s->velocity, -vel_straight, wishdir, vel_perpend);
1017 vel_perpend[2] -= vel_z;
1019 f = wishspeed - vel_straight;
1021 vel_straight += min(f, cl.movevars_accelerate * s->q.frametime * wishspeed) * cl.movevars_airaccel_qw;
1023 vel_straight += min(wishspeed, cl.movevars_accelerate * s->q.frametime * wishspeed) * (1 - cl.movevars_airaccel_qw);
1025 VectorM(1 - (s->q.frametime * (wishspeed / cl.movevars_maxairspeed) * cl.movevars_airaccel_sideways_friction), vel_perpend, vel_perpend);
1027 VectorMA(vel_perpend, vel_straight, wishdir, s->velocity);
1028 s->velocity[2] += vel_z;
1030 s->velocity[2] -= cl_gravity.value * s->q.frametime;
1031 CL_ClientMovement_Move(s);
1035 void CL_ClientMovement_PlayerMove(cl_clientmovement_state_t *s)
1037 //Con_Printf(" %f", frametime);
1039 s->q.canjump = true;
1040 s->waterjumptime -= s->q.frametime;
1041 CL_ClientMovement_UpdateStatus(s);
1042 if (s->waterlevel >= WATERLEVEL_SWIMMING)
1043 CL_ClientMovement_Physics_Swim(s);
1045 CL_ClientMovement_Physics_Walk(s);
1048 extern cvar_t slowmo;
1049 void CL_UpdateMoveVars(void)
1051 if (cls.protocol == PROTOCOL_QUAKEWORLD)
1053 cl.movevars_slowmo = 1;
1054 cl.movevars_ticrate = 1.0 / bound(1, cl_netinputpacketspersecond.value, 100);
1055 // scale playback speed of demos by slowmo cvar
1056 if (cls.demoplayback)
1057 cl.movevars_slowmo *= slowmo.value;
1059 else if (cl.stats[STAT_MOVEVARS_TICRATE])
1061 cl.movevars_ticrate = cl.statsf[STAT_MOVEVARS_TICRATE];
1062 cl.movevars_slowmo = cl.statsf[STAT_MOVEVARS_TIMESCALE];
1063 cl.movevars_gravity = cl.statsf[STAT_MOVEVARS_GRAVITY];
1064 cl.movevars_stopspeed = cl.statsf[STAT_MOVEVARS_STOPSPEED] ;
1065 cl.movevars_maxspeed = cl.statsf[STAT_MOVEVARS_MAXSPEED];
1066 cl.movevars_spectatormaxspeed = cl.statsf[STAT_MOVEVARS_SPECTATORMAXSPEED];
1067 cl.movevars_accelerate = cl.statsf[STAT_MOVEVARS_ACCELERATE];
1068 cl.movevars_airaccelerate = cl.statsf[STAT_MOVEVARS_AIRACCELERATE];
1069 cl.movevars_wateraccelerate = cl.statsf[STAT_MOVEVARS_WATERACCELERATE];
1070 cl.movevars_entgravity = cl.statsf[STAT_MOVEVARS_ENTGRAVITY];
1071 cl.movevars_jumpvelocity = cl.statsf[STAT_MOVEVARS_JUMPVELOCITY];
1072 cl.movevars_edgefriction = cl.statsf[STAT_MOVEVARS_EDGEFRICTION];
1073 cl.movevars_maxairspeed = cl.statsf[STAT_MOVEVARS_MAXAIRSPEED];
1074 cl.movevars_stepheight = cl.statsf[STAT_MOVEVARS_STEPHEIGHT];
1075 cl.movevars_airaccel_qw = cl.statsf[STAT_MOVEVARS_AIRACCEL_QW];
1076 cl.movevars_airaccel_sideways_friction = cl.statsf[STAT_MOVEVARS_AIRACCEL_SIDEWAYS_FRICTION];
1077 cl.movevars_friction = cl.statsf[STAT_MOVEVARS_FRICTION];
1078 cl.movevars_waterfriction = cl.statsf[STAT_MOVEVARS_WATERFRICTION];
1079 // scale playback speed of demos by slowmo cvar
1080 if (cls.demoplayback)
1081 cl.movevars_slowmo *= slowmo.value;
1085 cl.movevars_ticrate = 1.0 / bound(1, cl_netinputpacketspersecond.value, 100);
1086 cl.movevars_slowmo = slowmo.value;
1087 cl.movevars_gravity = sv_gravity.value;
1088 cl.movevars_stopspeed = cl_movement_stopspeed.value;
1089 cl.movevars_maxspeed = cl_movement_maxspeed.value;
1090 cl.movevars_spectatormaxspeed = cl_movement_maxspeed.value;
1091 cl.movevars_accelerate = cl_movement_accelerate.value;
1092 cl.movevars_airaccelerate = cl_movement_airaccelerate.value < 0 ? cl_movement_accelerate.value : cl_movement_airaccelerate.value;
1093 cl.movevars_wateraccelerate = cl_movement_wateraccelerate.value < 0 ? cl_movement_accelerate.value : cl_movement_wateraccelerate.value;
1094 cl.movevars_friction = cl_movement_friction.value;
1095 cl.movevars_waterfriction = cl_movement_waterfriction.value < 0 ? cl_movement_friction.value : cl_movement_waterfriction.value;
1096 cl.movevars_entgravity = 1;
1097 cl.movevars_jumpvelocity = cl_movement_jumpvelocity.value;
1098 cl.movevars_edgefriction = cl_movement_edgefriction.value;
1099 cl.movevars_maxairspeed = cl_movement_maxairspeed.value;
1100 cl.movevars_stepheight = cl_movement_stepheight.value;
1101 cl.movevars_airaccel_qw = cl_movement_airaccel_qw.value;
1102 cl.movevars_airaccel_sideways_friction = cl_movement_airaccel_sideways_friction.value;
1106 void CL_ClientMovement_Replay(void)
1110 double totalmovetime;
1111 cl_clientmovement_state_t s;
1113 CL_ClientMovement_ExpireOldMoves();
1115 // set up starting state for the series of moves
1116 memset(&s, 0, sizeof(s));
1117 VectorCopy(cl.entities[cl.playerentity].state_current.origin, s.origin);
1118 VectorCopy(cl.mvelocity[0], s.velocity);
1119 s.crouched = true; // will be updated on first move
1120 //Con_Printf("movement replay starting org %f %f %f vel %f %f %f\n", s.origin[0], s.origin[1], s.origin[2], s.velocity[0], s.velocity[1], s.velocity[2]);
1123 for (i = 0;i < cl.movement_numqueue - 1;i++)
1124 totalmovetime += cl.movement_queue[i].frametime;
1125 cl.movement_predicted = totalmovetime * 1000.0 >= cl_movement_minping.value && cls.servermovesequence && (cl_movement.integer && !cls.demoplayback && cls.signon == SIGNONS && cl.stats[STAT_HEALTH] > 0 && !cl.intermission);
1126 //Con_Printf("%i = %.0f >= %.0f && %i && (%i && %i && %i == %i && %i > 0 && %i\n", cl.movement_predicted, totalmovetime * 1000.0, cl_movement_minping.value, cls.servermovesequence, cl_movement.integer, !cls.demoplayback, cls.signon, SIGNONS, cl.stats[STAT_HEALTH], !cl.intermission);
1127 if (cl.movement_predicted)
1129 //Con_Printf("%ims\n", cl.movecmd[0].msec);
1131 // replay the input queue to predict current location
1132 // note: this relies on the fact there's always one queue item at the end
1134 canjump = cl.movement_replay_canjump;
1135 for (i = 0;i < cl.movement_numqueue;i++)
1137 s.q = cl.movement_queue[i];
1138 s.q.canjump = canjump;
1139 // if a move is more than 50ms, do it as two moves (matching qwsv)
1140 if (s.q.frametime > 0.05)
1142 s.q.frametime *= 0.5;
1143 CL_ClientMovement_PlayerMove(&s);
1145 CL_ClientMovement_PlayerMove(&s);
1146 canjump = cl.movement_queue[i].canjump = s.q.canjump;
1151 // get the first movement queue entry to know whether to crouch and such
1152 s.q = cl.movement_queue[0];
1154 CL_ClientMovement_UpdateStatus(&s);
1156 if (cl.movement_replay)
1158 cl.movement_replay = false;
1159 // update interpolation timestamps if time has passed
1160 if (cl.movement_time[0] != cl.movecmd[0].time)
1162 cl.movement_time[1] = cl.movement_time[0];
1163 cl.movement_time[0] = cl.movecmd[0].time;
1164 cl.movement_time[2] = cl.time;
1165 VectorCopy(cl.movement_origin, cl.movement_oldorigin);
1166 //VectorCopy(s.origin, cl.entities[cl.playerentity].state_current.origin);
1167 //VectorSet(cl.entities[cl.playerentity].state_current.angles, 0, cl.viewangles[1], 0);
1170 // update the interpolation target position and velocity
1171 VectorCopy(s.origin, cl.movement_origin);
1172 VectorCopy(s.velocity, cl.movement_velocity);
1175 // update the onground flag if appropriate
1176 if (cl.movement_predicted)
1178 // when predicted we simply set the flag according to the UpdateStatus
1179 cl.onground = s.onground;
1183 // when not predicted, cl.onground is cleared by cl_parse.c each time
1184 // an update packet is received, but can be forced on here to hide
1185 // server inconsistencies in the onground flag
1186 // (which mostly occur when stepping up stairs at very high framerates
1187 // where after the step up the move continues forward and not
1188 // downward so the ground is not detected)
1190 // such onground inconsistencies can cause jittery gun bobbing and
1191 // stair smoothing, so we set onground if UpdateStatus says so
1196 // react to onground state changes (for gun bob)
1199 if (!cl.oldonground)
1200 cl.hitgroundtime = cl.movecmd[0].time;
1201 cl.lastongroundtime = cl.movecmd[0].time;
1203 cl.oldonground = cl.onground;
1206 void QW_MSG_WriteDeltaUsercmd(sizebuf_t *buf, usercmd_t *from, usercmd_t *to)
1211 if (to->viewangles[0] != from->viewangles[0])
1212 bits |= QW_CM_ANGLE1;
1213 if (to->viewangles[1] != from->viewangles[1])
1214 bits |= QW_CM_ANGLE2;
1215 if (to->viewangles[2] != from->viewangles[2])
1216 bits |= QW_CM_ANGLE3;
1217 if (to->forwardmove != from->forwardmove)
1218 bits |= QW_CM_FORWARD;
1219 if (to->sidemove != from->sidemove)
1221 if (to->upmove != from->upmove)
1223 if (to->buttons != from->buttons)
1224 bits |= QW_CM_BUTTONS;
1225 if (to->impulse != from->impulse)
1226 bits |= QW_CM_IMPULSE;
1228 MSG_WriteByte(buf, bits);
1229 if (bits & QW_CM_ANGLE1)
1230 MSG_WriteAngle16i(buf, to->viewangles[0]);
1231 if (bits & QW_CM_ANGLE2)
1232 MSG_WriteAngle16i(buf, to->viewangles[1]);
1233 if (bits & QW_CM_ANGLE3)
1234 MSG_WriteAngle16i(buf, to->viewangles[2]);
1235 if (bits & QW_CM_FORWARD)
1236 MSG_WriteShort(buf, to->forwardmove);
1237 if (bits & QW_CM_SIDE)
1238 MSG_WriteShort(buf, to->sidemove);
1239 if (bits & QW_CM_UP)
1240 MSG_WriteShort(buf, to->upmove);
1241 if (bits & QW_CM_BUTTONS)
1242 MSG_WriteByte(buf, to->buttons);
1243 if (bits & QW_CM_IMPULSE)
1244 MSG_WriteByte(buf, to->impulse);
1245 MSG_WriteByte(buf, to->msec);
1253 usercmd_t nullcmd; // for delta compression of qw moves
1254 void CL_SendMove(void)
1256 int i, j, packetloss;
1259 unsigned char data[1024];
1260 static double lastsendtime = 0;
1264 CL_ClientMovement_ExpireOldMoves();
1266 // if playing a demo, do nothing
1270 // don't send too often or else network connections can get clogged by a high renderer framerate
1271 packettime = cl.movevars_ticrate;
1272 // quakeworld servers take only frametimes
1273 // predicted dp7 servers take current interpolation time
1274 // unpredicted servers take an echo of the latest server timestamp
1275 if (cls.protocol == PROTOCOL_QUAKEWORLD)
1277 if (realtime < lastsendtime + packettime)
1279 cl.cmd.time = realtime;
1280 cl.cmd.sequence = cls.netcon->qw.outgoing_sequence;
1282 else if (cl.movement_predicted)
1284 if (realtime < lastsendtime + packettime)
1286 cl.cmd.time = cl.time;
1287 cl.cmd.sequence = cls.movesequence;
1291 // unpredicted movement should be sent immediately whenever a server
1292 // packet is received, to minimize ping times
1293 if (!cl.movement_needupdate && realtime < lastsendtime + packettime)
1295 if (cl.mtime[0] == cl.movecmd[0].time && cl.mtime[1] != cl.mtime[0])
1297 cl.cmd.time = cl.mtime[0];
1298 cl.cmd.sequence = cls.movesequence;
1301 // don't let it fall behind if CL_SendMove hasn't been called recently
1302 // (such is the case when framerate is too low for instance)
1303 lastsendtime = bound(realtime, lastsendtime + packettime, realtime + packettime);
1304 // set the flag indicating that we sent a packet recently
1305 cl.movement_needupdate = false;
1307 buf.maxsize = sizeof(data);
1311 // conditions for sending a move:
1312 // if the move advances time or if the game is paused (in which case time
1313 // is not advancing)
1314 // don't send a new input packet if the connection is still saturated from
1315 // the last one (or chat messages, etc)
1316 // note: this behavior comes from QW
1317 if ((cls.protocol == PROTOCOL_QUAKEWORLD || cls.signon == SIGNONS) && !NetConn_CanSend(cls.netcon))
1320 // increase the move counter since we intend to send a move
1323 // send the movement message
1324 // PROTOCOL_QUAKE clc_move = 16 bytes total
1325 // PROTOCOL_QUAKEDP clc_move = 16 bytes total
1326 // PROTOCOL_NEHAHRAMOVIE clc_move = 16 bytes total
1327 // PROTOCOL_DARKPLACES1 clc_move = 19 bytes total
1328 // PROTOCOL_DARKPLACES2 clc_move = 25 bytes total
1329 // PROTOCOL_DARKPLACES3 clc_move = 25 bytes total
1330 // PROTOCOL_DARKPLACES4 clc_move = 19 bytes total
1331 // PROTOCOL_DARKPLACES5 clc_move = 19 bytes total
1332 // PROTOCOL_DARKPLACES6 clc_move = 52 bytes total
1333 // PROTOCOL_DARKPLACES7 clc_move = 56 bytes total per move (can be up to 16 moves)
1334 // PROTOCOL_QUAKEWORLD clc_move = 34 bytes total (typically, but can reach 43 bytes, or even 49 bytes with roll)
1336 // set prydon cursor info
1337 CL_UpdatePrydonCursor();
1340 // LordHavoc: added 6 new buttons and use and chat buttons, and prydon cursor active button
1342 if (in_attack.state & 3) bits |= 1;in_attack.state &= ~2;
1343 if (in_jump.state & 3) bits |= 2;in_jump.state &= ~2;
1344 if (in_button3.state & 3) bits |= 4;in_button3.state &= ~2;
1345 if (in_button4.state & 3) bits |= 8;in_button4.state &= ~2;
1346 if (in_button5.state & 3) bits |= 16;in_button5.state &= ~2;
1347 if (in_button6.state & 3) bits |= 32;in_button6.state &= ~2;
1348 if (in_button7.state & 3) bits |= 64;in_button7.state &= ~2;
1349 if (in_button8.state & 3) bits |= 128;in_button8.state &= ~2;
1350 if (in_use.state & 3) bits |= 256;in_use.state &= ~2;
1351 if (key_dest != key_game || key_consoleactive) bits |= 512;
1352 if (cl_prydoncursor.integer) bits |= 1024;
1353 if (in_button9.state & 3) bits |= 2048;in_button9.state &= ~2;
1354 if (in_button10.state & 3) bits |= 4096;in_button10.state &= ~2;
1355 if (in_button11.state & 3) bits |= 8192;in_button11.state &= ~2;
1356 if (in_button12.state & 3) bits |= 16384;in_button12.state &= ~2;
1357 if (in_button13.state & 3) bits |= 32768;in_button13.state &= ~2;
1358 if (in_button14.state & 3) bits |= 65536;in_button14.state &= ~2;
1359 if (in_button15.state & 3) bits |= 131072;in_button15.state &= ~2;
1360 if (in_button16.state & 3) bits |= 262144;in_button16.state &= ~2;
1361 // button bits 19-31 unused currently
1362 // rotate/zoom view serverside if PRYDON_CLIENTCURSOR cursor is at edge of screen
1363 if (cl.cmd.cursor_screen[0] <= -1) bits |= 8;
1364 if (cl.cmd.cursor_screen[0] >= 1) bits |= 16;
1365 if (cl.cmd.cursor_screen[1] <= -1) bits |= 32;
1366 if (cl.cmd.cursor_screen[1] >= 1) bits |= 64;
1367 cl.cmd.buttons = bits;
1370 cl.cmd.impulse = in_impulse;
1373 // movement is set by input code (forwardmove/sidemove/upmove)
1376 VectorCopy(cl.viewangles, cl.cmd.viewangles);
1378 msecdelta = (int)(floor(cl.cmd.time * 1000) - floor(cl.movecmd[0].time * 1000));
1379 cl.cmd.msec = (unsigned char)bound(0, msecdelta, 255);
1380 // ridiculous value rejection (matches qw)
1381 if (cl.cmd.msec > 250)
1384 cl.cmd.predicted = cl_movement.integer;
1386 // always dump the first two messages, because they may contain leftover inputs from the last level
1387 if (cl.cmd.sequence <= 2)
1388 cl.cmd.forwardmove = cl.cmd.sidemove = cl.cmd.upmove = cl.cmd.impulse = cl.cmd.buttons = 0;
1390 // update the cl.movecmd array which holds the most recent moves
1391 for (i = CL_MAX_USERCMDS - 1;i >= 1;i--)
1392 cl.movecmd[i] = cl.movecmd[i-1];
1393 cl.movecmd[0] = cl.cmd;
1395 if (cls.protocol == PROTOCOL_QUAKEWORLD)
1399 CL_ClientMovement_Input((cl.movecmd[0].buttons & 2) != 0, false);
1401 MSG_WriteByte(&buf, qw_clc_move);
1402 // save the position for a checksum byte
1403 checksumindex = buf.cursize;
1404 MSG_WriteByte(&buf, 0);
1405 // packet loss percentage
1406 for (j = 0, packetloss = 0;j < NETGRAPH_PACKETS;j++)
1407 if (cls.netcon->incoming_unreliablesize[j] == NETGRAPH_LOSTPACKET)
1409 packetloss = packetloss * 100 / NETGRAPH_PACKETS;
1410 MSG_WriteByte(&buf, packetloss);
1411 // write most recent 3 moves
1412 QW_MSG_WriteDeltaUsercmd(&buf, &nullcmd, &cl.movecmd[2]);
1413 QW_MSG_WriteDeltaUsercmd(&buf, &cl.movecmd[2], &cl.movecmd[1]);
1414 QW_MSG_WriteDeltaUsercmd(&buf, &cl.movecmd[1], &cl.movecmd[0]);
1415 // calculate the checksum
1416 buf.data[checksumindex] = COM_BlockSequenceCRCByteQW(buf.data + checksumindex + 1, buf.cursize - checksumindex - 1, cls.netcon->qw.outgoing_sequence);
1417 // if delta compression history overflows, request no delta
1418 if (cls.netcon->qw.outgoing_sequence - cl.qw_validsequence >= QW_UPDATE_BACKUP-1)
1419 cl.qw_validsequence = 0;
1420 // request delta compression if appropriate
1421 if (cl.qw_validsequence && !cl_nodelta.integer && cls.state == ca_connected && !cls.demorecording)
1423 cl.qw_deltasequence[cls.netcon->qw.outgoing_sequence & QW_UPDATE_MASK] = cl.qw_validsequence;
1424 MSG_WriteByte(&buf, qw_clc_delta);
1425 MSG_WriteByte(&buf, cl.qw_validsequence & 255);
1428 cl.qw_deltasequence[cls.netcon->qw.outgoing_sequence & QW_UPDATE_MASK] = -1;
1430 else if (cls.signon == SIGNONS)
1432 if (cls.protocol == PROTOCOL_QUAKE || cls.protocol == PROTOCOL_QUAKEDP || cls.protocol == PROTOCOL_NEHAHRAMOVIE)
1435 MSG_WriteByte (&buf, clc_move);
1436 MSG_WriteFloat (&buf, cl.movecmd[0].time); // last server packet time
1438 for (i = 0;i < 3;i++)
1439 MSG_WriteAngle8i (&buf, cl.movecmd[0].viewangles[i]);
1441 MSG_WriteCoord16i (&buf, cl.movecmd[0].forwardmove);
1442 MSG_WriteCoord16i (&buf, cl.movecmd[0].sidemove);
1443 MSG_WriteCoord16i (&buf, cl.movecmd[0].upmove);
1445 MSG_WriteByte (&buf, cl.movecmd[0].buttons);
1446 MSG_WriteByte (&buf, cl.movecmd[0].impulse);
1448 else if (cls.protocol == PROTOCOL_DARKPLACES2 || cls.protocol == PROTOCOL_DARKPLACES3)
1451 MSG_WriteByte (&buf, clc_move);
1452 MSG_WriteFloat (&buf, cl.movecmd[0].time); // last server packet time
1454 for (i = 0;i < 3;i++)
1455 MSG_WriteAngle32f (&buf, cl.movecmd[0].viewangles[i]);
1457 MSG_WriteCoord16i (&buf, cl.movecmd[0].forwardmove);
1458 MSG_WriteCoord16i (&buf, cl.movecmd[0].sidemove);
1459 MSG_WriteCoord16i (&buf, cl.movecmd[0].upmove);
1461 MSG_WriteByte (&buf, cl.movecmd[0].buttons);
1462 MSG_WriteByte (&buf, cl.movecmd[0].impulse);
1464 else if (cls.protocol == PROTOCOL_DARKPLACES1 || cls.protocol == PROTOCOL_DARKPLACES4 || cls.protocol == PROTOCOL_DARKPLACES5)
1467 MSG_WriteByte (&buf, clc_move);
1468 MSG_WriteFloat (&buf, cl.movecmd[0].time); // last server packet time
1470 for (i = 0;i < 3;i++)
1471 MSG_WriteAngle16i (&buf, cl.movecmd[0].viewangles[i]);
1473 MSG_WriteCoord16i (&buf, cl.movecmd[0].forwardmove);
1474 MSG_WriteCoord16i (&buf, cl.movecmd[0].sidemove);
1475 MSG_WriteCoord16i (&buf, cl.movecmd[0].upmove);
1477 MSG_WriteByte (&buf, cl.movecmd[0].buttons);
1478 MSG_WriteByte (&buf, cl.movecmd[0].impulse);
1480 else if (cls.signon == SIGNONS)
1485 // FIXME: cl.movecmd[0].buttons & 16 is +button5, Nexuiz specific
1486 CL_ClientMovement_Input((cl.movecmd[0].buttons & 2) != 0, (cl.movecmd[0].buttons & 16) != 0);
1488 // set the maxusercmds variable to limit how many should be sent
1489 maxusercmds = bound(1, cl_netinputpacketlosstolerance.integer + 1, CL_MAX_USERCMDS);
1490 // when movement prediction is off, there's not much point in repeating old input as it will just be ignored
1491 if (!cl.cmd.predicted)
1494 // send the latest moves in order, the old ones will be
1495 // ignored by the server harmlessly, however if the previous
1496 // packets were lost these moves will be used
1498 // this reduces packet loss impact on gameplay.
1499 for (j = 0, cmd = &cl.movecmd[maxusercmds-1];j < maxusercmds;j++, cmd--)
1501 // don't repeat any stale moves
1502 if (cmd->sequence && cmd->sequence < cls.servermovesequence)
1505 MSG_WriteByte (&buf, clc_move);
1506 if (cls.protocol != PROTOCOL_DARKPLACES6)
1507 MSG_WriteLong (&buf, cmd->predicted ? cmd->sequence : 0);
1508 MSG_WriteFloat (&buf, cmd->time); // last server packet time
1510 for (i = 0;i < 3;i++)
1511 MSG_WriteAngle16i (&buf, cmd->viewangles[i]);
1513 MSG_WriteCoord16i (&buf, cmd->forwardmove);
1514 MSG_WriteCoord16i (&buf, cmd->sidemove);
1515 MSG_WriteCoord16i (&buf, cmd->upmove);
1517 MSG_WriteLong (&buf, cmd->buttons);
1518 MSG_WriteByte (&buf, cmd->impulse);
1519 // PRYDON_CLIENTCURSOR
1521 MSG_WriteShort (&buf, (short)(cmd->cursor_screen[0] * 32767.0f));
1522 MSG_WriteShort (&buf, (short)(cmd->cursor_screen[1] * 32767.0f));
1523 MSG_WriteFloat (&buf, cmd->cursor_start[0]);
1524 MSG_WriteFloat (&buf, cmd->cursor_start[1]);
1525 MSG_WriteFloat (&buf, cmd->cursor_start[2]);
1526 MSG_WriteFloat (&buf, cmd->cursor_impact[0]);
1527 MSG_WriteFloat (&buf, cmd->cursor_impact[1]);
1528 MSG_WriteFloat (&buf, cmd->cursor_impact[2]);
1529 MSG_WriteShort (&buf, cmd->cursor_entitynumber);
1534 if (cls.protocol != PROTOCOL_QUAKEWORLD && buf.cursize)
1536 // ack the last few frame numbers
1537 // (redundent to improve handling of client->server packet loss)
1538 // for LATESTFRAMENUMS == 3 case this is 15 bytes
1539 for (i = 0;i < LATESTFRAMENUMS;i++)
1541 if (cl.latestframenums[i] > 0)
1543 if (developer_networkentities.integer >= 10)
1544 Con_Printf("send clc_ackframe %i\n", cl.latestframenums[i]);
1545 MSG_WriteByte(&buf, clc_ackframe);
1546 MSG_WriteLong(&buf, cl.latestframenums[i]);
1551 // PROTOCOL_DARKPLACES6 = 67 bytes per packet
1552 // PROTOCOL_DARKPLACES7 = 71 bytes per packet
1554 // acknowledge any recently received data blocks
1555 for (i = 0;i < CL_MAX_DOWNLOADACKS && (cls.dp_downloadack[i].start || cls.dp_downloadack[i].size);i++)
1557 MSG_WriteByte(&buf, clc_ackdownloaddata);
1558 MSG_WriteLong(&buf, cls.dp_downloadack[i].start);
1559 MSG_WriteShort(&buf, cls.dp_downloadack[i].size);
1560 cls.dp_downloadack[i].start = 0;
1561 cls.dp_downloadack[i].size = 0;
1564 // send the reliable message (forwarded commands) if there is one
1565 if (buf.cursize || cls.netcon->message.cursize)
1566 NetConn_SendUnreliableMessage(cls.netcon, &buf, cls.protocol, max(20*(buf.cursize+40), cl_rate.integer));
1568 if (cls.netcon->message.overflowed)
1570 Con_Print("CL_SendMove: lost server connection\n");
1572 Host_ShutdownServer();
1581 void CL_InitInput (void)
1583 Cmd_AddCommand ("+moveup",IN_UpDown, "swim upward");
1584 Cmd_AddCommand ("-moveup",IN_UpUp, "stop swimming upward");
1585 Cmd_AddCommand ("+movedown",IN_DownDown, "swim downward");
1586 Cmd_AddCommand ("-movedown",IN_DownUp, "stop swimming downward");
1587 Cmd_AddCommand ("+left",IN_LeftDown, "turn left");
1588 Cmd_AddCommand ("-left",IN_LeftUp, "stop turning left");
1589 Cmd_AddCommand ("+right",IN_RightDown, "turn right");
1590 Cmd_AddCommand ("-right",IN_RightUp, "stop turning right");
1591 Cmd_AddCommand ("+forward",IN_ForwardDown, "move forward");
1592 Cmd_AddCommand ("-forward",IN_ForwardUp, "stop moving forward");
1593 Cmd_AddCommand ("+back",IN_BackDown, "move backward");
1594 Cmd_AddCommand ("-back",IN_BackUp, "stop moving backward");
1595 Cmd_AddCommand ("+lookup", IN_LookupDown, "look upward");
1596 Cmd_AddCommand ("-lookup", IN_LookupUp, "stop looking upward");
1597 Cmd_AddCommand ("+lookdown", IN_LookdownDown, "look downward");
1598 Cmd_AddCommand ("-lookdown", IN_LookdownUp, "stop looking downward");
1599 Cmd_AddCommand ("+strafe", IN_StrafeDown, "activate strafing mode (move instead of turn)");
1600 Cmd_AddCommand ("-strafe", IN_StrafeUp, "deactivate strafing mode");
1601 Cmd_AddCommand ("+moveleft", IN_MoveleftDown, "strafe left");
1602 Cmd_AddCommand ("-moveleft", IN_MoveleftUp, "stop strafing left");
1603 Cmd_AddCommand ("+moveright", IN_MoverightDown, "strafe right");
1604 Cmd_AddCommand ("-moveright", IN_MoverightUp, "stop strafing right");
1605 Cmd_AddCommand ("+speed", IN_SpeedDown, "activate run mode (faster movement and turning)");
1606 Cmd_AddCommand ("-speed", IN_SpeedUp, "deactivate run mode");
1607 Cmd_AddCommand ("+attack", IN_AttackDown, "begin firing");
1608 Cmd_AddCommand ("-attack", IN_AttackUp, "stop firing");
1609 Cmd_AddCommand ("+jump", IN_JumpDown, "jump");
1610 Cmd_AddCommand ("-jump", IN_JumpUp, "end jump (so you can jump again)");
1611 Cmd_AddCommand ("impulse", IN_Impulse, "send an impulse number to server (select weapon, use item, etc)");
1612 Cmd_AddCommand ("+klook", IN_KLookDown, "activate keyboard looking mode, do not recenter view");
1613 Cmd_AddCommand ("-klook", IN_KLookUp, "deactivate keyboard looking mode");
1614 Cmd_AddCommand ("+mlook", IN_MLookDown, "activate mouse looking mode, do not recenter view");
1615 Cmd_AddCommand ("-mlook", IN_MLookUp, "deactivate mouse looking mode");
1617 // LordHavoc: added use button
1618 Cmd_AddCommand ("+use", IN_UseDown, "use something (may be used by some mods)");
1619 Cmd_AddCommand ("-use", IN_UseUp, "stop using something");
1621 // LordHavoc: added 6 new buttons
1622 Cmd_AddCommand ("+button3", IN_Button3Down, "activate button3 (behavior depends on mod)");
1623 Cmd_AddCommand ("-button3", IN_Button3Up, "deactivate button3");
1624 Cmd_AddCommand ("+button4", IN_Button4Down, "activate button4 (behavior depends on mod)");
1625 Cmd_AddCommand ("-button4", IN_Button4Up, "deactivate button4");
1626 Cmd_AddCommand ("+button5", IN_Button5Down, "activate button5 (behavior depends on mod)");
1627 Cmd_AddCommand ("-button5", IN_Button5Up, "deactivate button5");
1628 Cmd_AddCommand ("+button6", IN_Button6Down, "activate button6 (behavior depends on mod)");
1629 Cmd_AddCommand ("-button6", IN_Button6Up, "deactivate button6");
1630 Cmd_AddCommand ("+button7", IN_Button7Down, "activate button7 (behavior depends on mod)");
1631 Cmd_AddCommand ("-button7", IN_Button7Up, "deactivate button7");
1632 Cmd_AddCommand ("+button8", IN_Button8Down, "activate button8 (behavior depends on mod)");
1633 Cmd_AddCommand ("-button8", IN_Button8Up, "deactivate button8");
1634 Cmd_AddCommand ("+button9", IN_Button9Down, "activate button9 (behavior depends on mod)");
1635 Cmd_AddCommand ("-button9", IN_Button9Up, "deactivate button9");
1636 Cmd_AddCommand ("+button10", IN_Button10Down, "activate button10 (behavior depends on mod)");
1637 Cmd_AddCommand ("-button10", IN_Button10Up, "deactivate button10");
1638 Cmd_AddCommand ("+button11", IN_Button11Down, "activate button11 (behavior depends on mod)");
1639 Cmd_AddCommand ("-button11", IN_Button11Up, "deactivate button11");
1640 Cmd_AddCommand ("+button12", IN_Button12Down, "activate button12 (behavior depends on mod)");
1641 Cmd_AddCommand ("-button12", IN_Button12Up, "deactivate button12");
1642 Cmd_AddCommand ("+button13", IN_Button13Down, "activate button13 (behavior depends on mod)");
1643 Cmd_AddCommand ("-button13", IN_Button13Up, "deactivate button13");
1644 Cmd_AddCommand ("+button14", IN_Button14Down, "activate button14 (behavior depends on mod)");
1645 Cmd_AddCommand ("-button14", IN_Button14Up, "deactivate button14");
1646 Cmd_AddCommand ("+button15", IN_Button15Down, "activate button15 (behavior depends on mod)");
1647 Cmd_AddCommand ("-button15", IN_Button15Up, "deactivate button15");
1648 Cmd_AddCommand ("+button16", IN_Button16Down, "activate button16 (behavior depends on mod)");
1649 Cmd_AddCommand ("-button16", IN_Button16Up, "deactivate button16");
1651 // LordHavoc: added bestweapon command
1652 Cmd_AddCommand ("bestweapon", IN_BestWeapon, "send an impulse number to server to select the first usable weapon out of several (example: 8 7 6 5 4 3 2 1)");
1654 Cvar_RegisterVariable(&cl_movement);
1655 Cvar_RegisterVariable(&cl_movement_minping);
1656 Cvar_RegisterVariable(&cl_movement_maxspeed);
1657 Cvar_RegisterVariable(&cl_movement_maxairspeed);
1658 Cvar_RegisterVariable(&cl_movement_stopspeed);
1659 Cvar_RegisterVariable(&cl_movement_friction);
1660 Cvar_RegisterVariable(&cl_movement_edgefriction);
1661 Cvar_RegisterVariable(&cl_movement_stepheight);
1662 Cvar_RegisterVariable(&cl_movement_airaccelerate);
1663 Cvar_RegisterVariable(&cl_movement_accelerate);
1664 Cvar_RegisterVariable(&cl_movement_jumpvelocity);
1665 Cvar_RegisterVariable(&cl_movement_airaccel_qw);
1666 Cvar_RegisterVariable(&cl_movement_airaccel_sideways_friction);
1667 Cvar_RegisterVariable(&cl_gravity);
1668 Cvar_RegisterVariable(&cl_slowmo);
1670 Cvar_RegisterVariable(&in_pitch_min);
1671 Cvar_RegisterVariable(&in_pitch_max);
1672 Cvar_RegisterVariable(&m_filter);
1674 Cvar_RegisterVariable(&cl_netinputpacketspersecond);
1675 Cvar_RegisterVariable(&cl_netinputpacketlosstolerance);
1677 Cvar_RegisterVariable(&cl_nodelta);