summaryrefslogtreecommitdiff
path: root/src/cgame/cg_snapshot.c
blob: d69da95d94253de50a1126954a5671a4a9063982 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
/*
===========================================================================
Copyright (C) 1999-2005 Id Software, Inc.
Copyright (C) 2000-2009 Darklegion Development

This file is part of Tremulous.

Tremulous is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the License,
or (at your option) any later version.

Tremulous is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Tremulous; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
===========================================================================
*/

// cg_snapshot.c -- things that happen on snapshot transition,
// not necessarily every single rendered frame


#include "cg_local.h"

/*
==================
CG_ResetEntity
==================
*/
static void CG_ResetEntity( centity_t *cent )
{
  // if the previous snapshot this entity was updated in is at least
  // an event window back in time then we can reset the previous event
  if( cent->snapShotTime < cg.time - EVENT_VALID_MSEC )
    cent->previousEvent = 0;

  cent->trailTime = cg.snap->serverTime;

  VectorCopy( cent->currentState.origin, cent->lerpOrigin );
  VectorCopy( cent->currentState.angles, cent->lerpAngles );

  if( cent->currentState.eType == ET_PLAYER )
    CG_ResetPlayerEntity( cent );
}

/*
===============
CG_TransitionEntity

cent->nextState is moved to cent->currentState and events are fired
===============
*/
static void CG_TransitionEntity( centity_t *cent )
{
  cent->currentState = cent->nextState;
  cent->currentValid = qtrue;

  // reset if the entity wasn't in the last frame or was teleported
  if( !cent->interpolate )
    CG_ResetEntity( cent );

  // clear the next state.  if will be set by the next CG_SetNextSnap
  cent->interpolate = qfalse;

  // check for events
  CG_CheckEvents( cent );
}


/*
==================
CG_SetInitialSnapshot

This will only happen on the very first snapshot, or
on tourney restarts.  All other times will use
CG_TransitionSnapshot instead.

FIXME: Also called by map_restart?
==================
*/
void CG_SetInitialSnapshot( snapshot_t *snap )
{
  int           i;
  centity_t     *cent;
  entityState_t *state;

  cg.snap = snap;

  BG_PlayerStateToEntityState( &snap->ps, &cg_entities[ snap->ps.clientNum ].currentState, qfalse );

  // sort out solid entities
  CG_BuildSolidList( );

  CG_ExecuteNewServerCommands( snap->serverCommandSequence );

  // set our local weapon selection pointer to
  // what the server has indicated the current weapon is
  CG_Respawn( );

  for( i = 0; i < cg.snap->numEntities; i++ )
  {
    state = &cg.snap->entities[ i ];
    cent = &cg_entities[ state->number ];

    memcpy( &cent->currentState, state, sizeof( entityState_t ) );
    //cent->currentState = *state;
    cent->interpolate = qfalse;
    cent->currentValid = qtrue;

    CG_ResetEntity( cent );

    // check for events
    CG_CheckEvents( cent );
  }
}


/*
===================
CG_TransitionSnapshot

The transition point from snap to nextSnap has passed
===================
*/
static void CG_TransitionSnapshot( void )
{
  centity_t   *cent;
  snapshot_t  *oldFrame;
  int         i;

  if( !cg.snap )
    CG_Error( "CG_TransitionSnapshot: NULL cg.snap" );

  if( !cg.nextSnap )
    CG_Error( "CG_TransitionSnapshot: NULL cg.nextSnap" );

  // execute any server string commands before transitioning entities
  CG_ExecuteNewServerCommands( cg.nextSnap->serverCommandSequence );

  // clear the currentValid flag for all entities in the existing snapshot
  for( i = 0; i < cg.snap->numEntities; i++ )
  {
    cent = &cg_entities[ cg.snap->entities[ i ].number ];
    cent->currentValid = qfalse;
  }

  // move nextSnap to snap and do the transitions
  oldFrame = cg.snap;
  cg.snap = cg.nextSnap;

  BG_PlayerStateToEntityState( &cg.snap->ps, &cg_entities[ cg.snap->ps.clientNum ].currentState, qfalse );
  cg_entities[ cg.snap->ps.clientNum ].interpolate = qfalse;

  for( i = 0; i < cg.snap->numEntities; i++ )
  {
    cent = &cg_entities[ cg.snap->entities[ i ].number ];
    CG_TransitionEntity( cent );

    // remember time of snapshot this entity was last updated in
    cent->snapShotTime = cg.snap->serverTime;
  }

  cg.nextSnap = NULL;

  // check for playerstate transition events
  if( oldFrame )
  {
    playerState_t *ops, *ps;

    ops = &oldFrame->ps;
    ps = &cg.snap->ps;
    // teleporting checks are irrespective of prediction
    if( ( ps->eFlags ^ ops->eFlags ) & EF_TELEPORT_BIT )
      cg.thisFrameTeleport = qtrue; // will be cleared by prediction code

    // if we are not doing client side movement prediction for any
    // reason, then the client events and view changes will be issued now
    if( cg.demoPlayback || ( cg.snap->ps.pm_flags & PMF_FOLLOW ) ||
        cg_nopredict.integer || cg_synchronousClients.integer )
      CG_TransitionPlayerState( ps, ops );
  }
}


/*
===================
CG_SetNextSnap

A new snapshot has just been read in from the client system.
===================
*/
static void CG_SetNextSnap( snapshot_t *snap )
{
  int           num;
  entityState_t *es;
  centity_t     *cent;

  cg.nextSnap = snap;

  BG_PlayerStateToEntityState( &snap->ps, &cg_entities[ snap->ps.clientNum ].nextState, qfalse );
  cg_entities[ cg.snap->ps.clientNum ].interpolate = qtrue;

  // check for extrapolation errors
  for( num = 0 ; num < snap->numEntities ; num++ )
  {
    es = &snap->entities[ num ];
    cent = &cg_entities[ es->number ];

    memcpy( &cent->nextState, es, sizeof( entityState_t ) );
    //cent->nextState = *es;

    // if this frame is a teleport, or the entity wasn't in the
    // previous frame, don't interpolate
    if( !cent->currentValid || ( ( cent->currentState.eFlags ^ es->eFlags ) & EF_TELEPORT_BIT ) )
      cent->interpolate = qfalse;
    else
      cent->interpolate = qtrue;
  }

  // if the next frame is a teleport for the playerstate, we
  // can't interpolate during demos
  if( cg.snap && ( ( snap->ps.eFlags ^ cg.snap->ps.eFlags ) & EF_TELEPORT_BIT ) )
    cg.nextFrameTeleport = qtrue;
  else
    cg.nextFrameTeleport = qfalse;

  // if changing follow mode, don't interpolate
  if( cg.nextSnap->ps.clientNum != cg.snap->ps.clientNum )
    cg.nextFrameTeleport = qtrue;

  // if changing server restarts, don't interpolate
  if( ( cg.nextSnap->snapFlags ^ cg.snap->snapFlags ) & SNAPFLAG_SERVERCOUNT )
    cg.nextFrameTeleport = qtrue;

  // sort out solid entities
  CG_BuildSolidList( );
}

#ifdef MODULE_INTERFACE_11
static moduleAlternateSnapshot_t moduleAlternateSnapshot;

static qboolean CG_GetModuleAlternateSnapshot( int snapshotNumber, snapshot_t *snap )
{
  moduleAlternateSnapshot_t *alt = &moduleAlternateSnapshot;
  int r = trap_GetSnapshot( snapshotNumber, alt );

  if( r )
  {
    int i;

    snap->snapFlags = alt->snapFlags;
    snap->ping = alt->ping;
    snap->serverTime = alt->serverTime;
    snap->numEntities = alt->numEntities;
    snap->numServerCommands = alt->numServerCommands;
    snap->serverCommandSequence = alt->serverCommandSequence;
    memcpy( &snap->areamask, &alt->areamask, sizeof( snap->areamask ) );

#define PSFO(x) ((size_t)&(((playerState_t*)0)->x))
    memcpy( &snap->ps.commandTime, &alt->ps.commandTime, PSFO(tauntTimer) - PSFO(commandTime) );
    memcpy( &snap->ps.movementDir, &alt->ps.movementDir, PSFO(ammo) - PSFO(movementDir) );
    memcpy( &snap->ps.generic1, &alt->ps.generic1, PSFO(entityEventSequence) - PSFO(generic1) );

    snap->ps.weaponAnim = alt->ps.ammo[0] & 0xFF;
    snap->ps.pm_flags |= ( alt->ps.ammo[0] & 0xFF00 ) << 8;
    snap->ps.ammo = alt->ps.ammo[1] & 0xFFF;
    snap->ps.clips = ( alt->ps.ammo[1] & 0xF000 ) >> 12;
    snap->ps.tauntTimer = alt->ps.ammo[2] & 0xFFF;
    snap->ps.generic1 |= ( alt->ps.ammo[2] & 0x3000 ) >> 4;

    for( i = 0; i < alt->numEntities; ++i )
    {
      entityState_t *s = &snap->entities[ i ];
      const moduleAlternateEntityState_t *a = &alt->entities[ i ];

#define ESFO(x) ((size_t)&(((entityState_t*)0)->x))
      memcpy( &s->number, &a->number, ESFO(weaponAnim) - ESFO(number) );

      s->weaponAnim = 0;
      s->generic1 = a->generic1;
    }
  }

  return r;
}
#endif

/*
========================
CG_ReadNextSnapshot

This is the only place new snapshots are requested
This may increment cgs.processedSnapshotNum multiple
times if the client system fails to return a
valid snapshot.
========================
*/
static snapshot_t *CG_ReadNextSnapshot( void )
{
  qboolean    r;
  snapshot_t  *dest;

  if( cg.latestSnapshotNum > cgs.processedSnapshotNum + 1000 )
  {
    CG_Printf( "WARNING: CG_ReadNextSnapshot: way out of range, %i > %i\n",
      cg.latestSnapshotNum, cgs.processedSnapshotNum );
  }

  while( cgs.processedSnapshotNum < cg.latestSnapshotNum )
  {
    // decide which of the two slots to load it into
    if( cg.snap == &cg.activeSnapshots[ 0 ] )
      dest = &cg.activeSnapshots[ 1 ];
    else
      dest = &cg.activeSnapshots[ 0 ];

    // try to read the snapshot from the client system
    cgs.processedSnapshotNum++;
#ifdef MODULE_INTERFACE_11
    r = CG_GetModuleAlternateSnapshot( cgs.processedSnapshotNum, dest );
#else
    r = trap_GetSnapshot( cgs.processedSnapshotNum, dest );
#endif

    // FIXME: why would trap_GetSnapshot return a snapshot with the same server time
    if( cg.snap && r && dest->serverTime == cg.snap->serverTime )
    {
      //continue;
    }

    // if it succeeded, return
    if( r )
    {
      CG_AddLagometerSnapshotInfo( dest );
      return dest;
    }

    // a GetSnapshot will return failure if the snapshot
    // never arrived, or  is so old that its entities
    // have been shoved off the end of the circular
    // buffer in the client system.

    // record as a dropped packet
    CG_AddLagometerSnapshotInfo( NULL );

    // If there are additional snapshots, continue trying to
    // read them.
  }

  // nothing left to read
  return NULL;
}


/*
============
CG_ProcessSnapshots

We are trying to set up a renderable view, so determine
what the simulated time is, and try to get snapshots
both before and after that time if available.

If we don't have a valid cg.snap after exiting this function,
then a 3D game view cannot be rendered.  This should only happen
right after the initial connection.  After cg.snap has been valid
once, it will never turn invalid.

Even if cg.snap is valid, cg.nextSnap may not be, if the snapshot
hasn't arrived yet (it becomes an extrapolating situation instead
of an interpolating one)

============
*/
void CG_ProcessSnapshots( void )
{
  snapshot_t  *snap;
  int         n;

  // see what the latest snapshot the client system has is
  trap_GetCurrentSnapshotNumber( &n, &cg.latestSnapshotTime );

  if( n != cg.latestSnapshotNum )
  {
    if( n < cg.latestSnapshotNum )
    {
      // this should never happen
      CG_Error( "CG_ProcessSnapshots: n < cg.latestSnapshotNum" );
    }

    cg.latestSnapshotNum = n;
  }

  // If we have yet to receive a snapshot, check for it.
  // Once we have gotten the first snapshot, cg.snap will
  // always have valid data for the rest of the game
  while( !cg.snap )
  {
    snap = CG_ReadNextSnapshot( );

    if( !snap )
    {
      // we can't continue until we get a snapshot
      return;
    }

    // set our weapon selection to what
    // the playerstate is currently using
    if( !( snap->snapFlags & SNAPFLAG_NOT_ACTIVE ) )
      CG_SetInitialSnapshot( snap );
  }

  // loop until we either have a valid nextSnap with a serverTime
  // greater than cg.time to interpolate towards, or we run
  // out of available snapshots
  do
  {
    // if we don't have a nextframe, try and read a new one in
    if( !cg.nextSnap )
    {
      snap = CG_ReadNextSnapshot( );

      // if we still don't have a nextframe, we will just have to
      // extrapolate
      if( !snap )
        break;

      CG_SetNextSnap( snap );

      // if time went backwards, we have a level restart
      if( cg.nextSnap->serverTime < cg.snap->serverTime )
        CG_Error( "CG_ProcessSnapshots: Server time went backwards" );
    }

    // if our time is < nextFrame's, we have a nice interpolating state
    if( cg.time >= cg.snap->serverTime && cg.time < cg.nextSnap->serverTime )
      break;

    // we have passed the transition from nextFrame to frame
    CG_TransitionSnapshot( );
  } while( 1 );

  // assert our valid conditions upon exiting
  if( cg.snap == NULL )
    CG_Error( "CG_ProcessSnapshots: cg.snap == NULL" );

  if( cg.time < cg.snap->serverTime )
  {
    // this can happen right after a vid_restart
    cg.time = cg.snap->serverTime;
  }

  if( cg.nextSnap != NULL && cg.nextSnap->serverTime <= cg.time )
    CG_Error( "CG_ProcessSnapshots: cg.nextSnap->serverTime <= cg.time" );
}