Transitions are used to incrementally apply transforms over distance.
The VectorTransition class is used to gradually transform vector shapes over the length of a path. This feature is not SVG compliant, though it can be utilised from SVG files via the 'kotuku:' name space.
The transition is defined as a series of stops and transform instructions, of which at least 2 are required in order to interpolate the transforms over distance. The transform strings are defined as per the SVG guidelines for the transform attribute.
The following example illustrates the use of a transition in SVG:
<defs>
<kotuku:transition id="hill">
<stop offset="0" transform="scale(0.3)"/>
<stop offset="50%" transform="scale(1.5)"/>
<stop offset="100%" transform="scale(0.3)"/>
</kotuku:transition>
</defs>
<rect fill="#ffffff" width="100%" height="100%"/>
<text x="3" y="80" font-size="19.6" fill="navy" transition="url(#hill)">This text is morphed by a transition</text>
Transitions are most effective when used in conjunction with the Vector⇒GuidePath feature.
The VectorTransition class consists of the following fields:
Access | Name | Type | Comment | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Stops | kt::vector<Transition> | Defines the transforms that will be used at specific stop points. | ||||||||||
A valid transition object must consist of at least two stop points in order to transition from one transform to another. This is achieved by setting the Stops field with an array of Transition structures that define each stop point with a transform string. The Transition structure consists of the following fields:
| ||||||||||||
| XMLDef | STRING | Returns an SVG compliant XML string that describes the transition. | ||||||||||
The returned XML defines the transition's stop list as | ||||||||||||
For VectorTransition definitions
| Field | Type | Description |
|---|---|---|
| Offset | DOUBLE | An offset from 0.0 to 1.0 at which to apply the transform. |
| Transform | STRING | A transform string, as per SVG guidelines. |