The recording as the edit shows it. Cropped to the kept part: its clock
and distance start again from zero there, its start time (UTC and local)
moves on by what was cropped, and its totals are the recording's own
shared out by how much the kept part holds. Laps split and joined: a lap
the edit doesn't touch is kept as recorded; a split, joined or cropped one
is worked out from the recorded laps it covers, each sharing out its
distance, time, work, calories and climb by how much of it is kept, with
heart rate and power averaged from the samples where there are any. A
swim keeps the lengths inside the kept part, and its swim time is worked
out again from the new laps.
keepClock keeps the whole recording on its own clock and only changes
the laps (for an editor that draws the new laps over the whole
recording). An empty edit returns the recording as it is.
The kept part starts at the first sample at or after from, so after a
crop between samples the first time and distance can be a little above
zero. A lap boundary within a second of another, or of either end, is
dropped. A lap the edit made has no max speed (the recorded laps' maxima
don't say where in the lap they fell).
Throws a RangeError when from or to is not a finite number, when
the edit keeps nothing (from at or past to, after holding both to the
recording), or when cropping a recording with no timeSeconds.
Non-finite seconds in splitLapsAt / joinLapsAt are ignored.
The recording as the edit shows it. Cropped to the kept part: its clock and distance start again from zero there, its start time (UTC and local) moves on by what was cropped, and its totals are the recording's own shared out by how much the kept part holds. Laps split and joined: a lap the edit doesn't touch is kept as recorded; a split, joined or cropped one is worked out from the recorded laps it covers, each sharing out its distance, time, work, calories and climb by how much of it is kept, with heart rate and power averaged from the samples where there are any. A swim keeps the lengths inside the kept part, and its swim time is worked out again from the new laps.
keepClockkeeps the whole recording on its own clock and only changes the laps (for an editor that draws the new laps over the whole recording). An empty edit returns the recording as it is.The kept part starts at the first sample at or after
from, so after a crop between samples the first time and distance can be a little above zero. A lap boundary within a second of another, or of either end, is dropped. A lap the edit made has no max speed (the recorded laps' maxima don't say where in the lap they fell).Throws a
RangeErrorwhenfromortois not a finite number, when the edit keeps nothing (fromat or pastto, after holding both to the recording), or when cropping a recording with notimeSeconds. Non-finite seconds insplitLapsAt/joinLapsAtare ignored.