Crate gametime

This crate provides TimeSpan and TimeStamp types for working with time in ergonomic way in game engines.

TimeSpan is a type that represents a time span in nanoseconds. Similar to std::time::Duration, but smaller and thus faster.

TimeStamp is a type that represents a point in time in nanoseconds, relative to reference point.

Clock is a type that represents a clock to measure time and steps.

Frequency and FrequencyTicker allow exact frequency ticker using rational values.

Features

• std - enables std support, including Clock and ClockStep types.
• global_reference - enables [TimeStamp::now] function to get time stamp relative to global reference point that is initialized by first call to [TimeStamp::now].
• serde - enables serde support for TimeSpan and Frequency.

Macros

• timespan
  Converts human-readable expression into TimeSpan.
• ts
  Converts human-readable expression into TimeSpan. Shortcut for timespan!.

Structs

• Clock
  Time measuring device. Uses system monotonic clock counter and yields ClockSteps for each step.
• ClockRate
  Time measuring device. Uses system monotonic clock counter and yields ClockSteps for each step.
• ClockStep
  Result of Clock step. Contains time stamp corresponding to “now” and time span since previous step.
• Frequency
  Represents frequency. Able to accurately represent any rational frequency.
• FrequencyTicker
• FrequencyTickerIter
  Iterator over ticks from FrequencyTicker.
• TimeSpan
  An interval in between time stamps. This type is used to represent durations with nanosecond precision.
• TimeStamp
  A fixed point in time relative to the reference point in time.

Traits

• FrequencyNumExt
  This trait adds methods to integers to convert values into Frequencys.
• TimeSpanNumExt
  This trait adds methods to integers to convert values into TimeSpans.