/usr/src/castle-game-engine-5.2.0/x3d/x3dtime.pas is in castle-game-engine-src 5.2.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | {
Copyright 2008-2014 Michalis Kamburelis.
This file is part of "Castle Game Engine".
"Castle Game Engine" is free software; see the file COPYING.txt,
included in this distribution, for details about the copyright.
"Castle Game Engine" 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.
----------------------------------------------------------------------------
}
{ X3D time. }
unit X3DTime;
interface
uses CastleUtils, CastleTimeUtils, CastleGenericLists;
type
{ Complete timestamp for X3D events.
For most purposes, you're interested only in it's @link(Seconds) field,
this is the amount of continous time that passed (in double-precision
seconds).
More precisely, timestamp is actually a sum of @italic(Seconds +
PlusTicks ticks). PlusTicks is the number of discrete "ticks" that
occurred with the same Seconds value. A tick is, conceptually, an
infinitely small amount of time.
Ticks are used when comparing time values: when two timestamps
have the same @link(Seconds) value, then we can compare the PlusTicks
field. Timestamps are equal only when both Seconds and PlusTicks values
are exactly equal.
The practical justification of PlusTicks usage:
@orderedList(
@item(First, note that
X3D standard defines that within one timestamp, only one event may
pass through one route. This mechanism allows to avoid loops in routes.)
@item(Now note that when using TCastleSceneCore, Seconds is increased by
TCastleSceneCore.IncreaseTime. TCastleSceneCore doesn't require how often
should IncreaseTime be called, in particular you can call multiple
times TCastleSceneCore.Press, TCastleSceneCore.Release, TCastleSceneCore.PointingDeviceMove
without continously updating time. You can even not update time at all,
and still call TCastleSceneCore.Press and such.
This is a good thing --- it allows TCastleSceneCore to be very flexible.
The idea is that sensors are activated when user interface reports
some event. You don't have to update time before every TCastleSceneCore.Press
and such.)
@item(The potential problem here is that when you call
TCastleSceneCore.Press twice, without the TCastleSceneCore.IncreaseTime
in between, then the second TCastleSceneCore.Press events will have "clogged" routes.
Events send from the second TCastleSceneCore.Press may be blocked on routes,
since they will be detected as occuring within the same timestamp,
so (following VRML/X3D standard) they'll have to be ignored.)
@item(Using "Seconds seconds + PlusTicks ticks" allows to avoid this.
Each TCastleSceneCore.Press and such increases world time by 1 tick
-- this way, the second TCastleSceneCore.Press will have one more tick, so will
always be considered later, and things will work Ok.)
) }
TX3DTime = record
Seconds: TFloatTime;
PlusTicks: Cardinal;
end;
PX3DTime = ^TX3DTime;
TFloatTime = CastleTimeUtils.TFloatTime;
const
OldestX3DTime: TX3DTime = (Seconds: OldestTime; PlusTicks: 0);
{$ifdef FPC_OBJFPC}
operator > (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
operator >= (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
operator < (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
operator <= (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
{$endif FPC_OBJFPC}
type
TX3DTimeList = specialize TGenericStructList<TX3DTime>;
implementation
{$ifdef FPC_OBJFPC}
operator > (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
begin
Result := (Time1.Seconds > Time2.Seconds) or
( (Time1.Seconds = Time2.Seconds) and
(Time1.PlusTicks > Time2.PlusTicks) );
end;
operator >= (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
begin
Result := (Time1.Seconds > Time2.Seconds) or
( (Time1.Seconds = Time2.Seconds) and
(Time1.PlusTicks >= Time2.PlusTicks) );
end;
operator < (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
begin
Result := (Time1.Seconds < Time2.Seconds) or
( (Time1.Seconds = Time2.Seconds) and
(Time1.PlusTicks < Time2.PlusTicks) );
end;
operator <= (const Time1: TX3DTime; const Time2: TX3DTime): boolean;
begin
Result := (Time1.Seconds < Time2.Seconds) or
( (Time1.Seconds = Time2.Seconds) and
(Time1.PlusTicks <= Time2.PlusTicks) );
end;
{$endif FPC_OBJFPC}
end.
|