LUMIERA.clone/src/lib/time
Ichthyostega 50c602ec3f Library: rectify clipping of time::Duration (see #1263)
This is a deep refactoring to allow to represent the distance
between all valid time points as a time::Offset or time::Duration.

By design this is possible, since Time::MAX was defined as 1/30 of
the maximum value technically representable as int64_t. However,
introducing a different limiter for offsets and durations turns
out difficult, due to the inconsistencies in the exiting hierarchy
of temporal entities. Which in turn seems to stem from the unfortunate
decision to make time entities immutable, see #1261

Since the limiter is hard wired into the `time::TimeValue` constructor,
we are forced to create a "backdoor" of sorts, to pass up values
with different limiting from child classes. This would not be so
much of a problem if calculations weren't forced to go through `TimeVar`,
which does not distinguish between time points and time durations.

This solution rearranges all checks to be performed now by time::Offset,
while time::Duration will only take the absolute value at construction,
based on the fact that there is no valid construction path to yield
a duration which does not go through an offset first.

Later, when we're ready to sort out the implementation base of time values
(see #1258), this design issue should be revisited
- either we'll allow derived classes explicitly to invoke the limiter functions
- or we may be able to have an automatic conversion path from clearly
  marked base implementation types, in which case we wouldn't use the
  buildRaw_() and _raw() "backdoor" functions any more...
2022-12-05 00:58:32 +01:00
..
control-impl.hpp Timeline: draft arrangement to provide a display-metric (closes #1213) 2022-10-28 02:08:34 +02:00
control-policy.hpp Project: update and clean-up Doxygen configuration 2021-01-24 19:35:45 +01:00
control.hpp Clip-Drag: integrate indirectly with the TimelineLayout for metric translation 2021-05-13 18:29:37 +02:00
diagnostics.hpp Doxygen Fixes (#1062) 2017-04-02 04:22:51 +02:00
digxel.hpp Global-Layer-Renaming: fix remaining textual usages and IDs in the code 2018-12-10 00:09:56 +01:00
formats.hpp Timeline: reconsider time handling and Stage/Steam integration 2022-10-30 23:12:34 +01:00
grid.hpp Timehandling: choose safer representation for fractional seconds (closes #939) 2020-02-17 03:13:36 +01:00
mutation.cpp clean-up and finalise time::Mutation 2012-12-02 01:54:02 +01:00
mutation.hpp Library: replace boost::noncopyable by our own library solution 2018-03-24 05:35:13 +01:00
quantiser.cpp Doxygen: fill in missing file level headlines for the Library (timecode handling) 2016-11-07 16:22:04 +01:00
quantiser.hpp Global-Layer-Renaming: fix remaining textual usages and IDs in the code 2018-12-10 00:09:56 +01:00
time.cpp Library: rectify clipping of time::Duration (see #1263) 2022-12-05 00:58:32 +01:00
timecode.cpp Timehandling: choose safer representation for fractional seconds (closes #939) 2020-02-17 03:13:36 +01:00
timecode.hpp Doxygen: fill in missing file level headlines for the Library (timecode handling) 2016-11-07 16:22:04 +01:00
timequant.hpp Timeline: reconsider time handling and Stage/Steam integration 2022-10-30 23:12:34 +01:00
timevalue.hpp Library: rectify clipping of time::Duration (see #1263) 2022-12-05 00:58:32 +01:00