Table of Contents

Property KeyTimes

Namespace
SharpVectors.Dom.Svg
Assembly
SharpVectors.Model.dll

KeyTimes

Gets or sets a semicolon-separated list of time values used to control the pacing of the animation.

public string KeyTimes { get; set; }

Property Value

string

Each time in the list corresponds to a value in the "values" attribute list, and defines when the value is used in the animation function. Each time value in the "keyTimes" list is specified as a floating point value between 0 and 1 (inclusive), representing a proportional offset into the simple duration of the animation element.

Remarks

For animations specified with a "values" list, the "keyTimes" attribute if specified must have exactly as many values as there are in the "values" attribute. For from/to/by animations, the "keyTimes" attribute if specified must have two values.

Each successive time value must be greater than or equal to the preceding time value.

The "keyTimes" list semantics depends upon the interpolation mode:

  • For linear and spline animation, the first time value in the list must be 0, and the last time value in the list must be 1. The key time associated with each value defines when the value is set; values are interpolated between the key times.
  • For discrete animation, the first time value in the list must be 0. The time associated with each value defines when the value is set; the animation function uses that value until the next time defined in "keyTimes".

If the interpolation mode is 'paced', the "keyTimes" attribute is ignored.

If there are any errors in the "keyTimes" specification (bad values, too many or too few values), the document fragment is in error (see error processing).

If the simple duration is indefinite, any "keyTimes" specification will be ignored.