The colour value in this field is applicable only when a gradient is in clip-mode by specifying the VSPREAD::CLIP flag in SpreadMethod. By default, this field has an alpha value of zero to ensure that nothing is drawn outside the initial bounds of the gradient. Setting any other colour value will otherwise fill in those areas.

An alternative to defining colour Stops in a gradient is available in the form of named colourmaps. Declaring a colourmap in this field will automatically populate the gradient with the colours defined in the map.

We currently support the following established colourmaps from the matplotlib and seaborn projects: cmap:crest, cmap:flare, cmap:icefire, cmap:inferno, cmap:magma, cmap:mako, cmap:plasma, cmap:rocket, cmap:viridis.

The use of colourmaps and custom stops are mutually exclusive.

By default, gradients are rendered using the standard RGB colour space and alpha blending rules. Changing the colour space to LINEAR_RGB will force the renderer to automatically convert sRGB values to linear RGB when blending.

Easing modifies the interpolation position between each adjacent pair of Stops. For gradients sourced from ColourMap, it remaps the lookup position through the selected easing function before Gamma and Resolution are applied. The default GEZ::LINEAR mode leaves the gradient unchanged.

Gamma remaps the completed colour ramp before Resolution is applied. Values greater than 1.0 bias the ramp toward the first colour, while values between 0.0 and 1.0 bias it toward the last colour. A value of 1.0 leaves the gradient unchanged.

A transform can be applied to a gradient via one or more matrices. These will influence how gradient fills are rendered within their vector space. Each matrix is represented by a VectorMatrix structure, and the matrices are linked in the order in which they should be applied.

The NumericID field is provided for internal use by the SVG and vector modules. If NumericID is set by the client, then any value in SID will be immediately cleared.

By default, the colours generated for a gradient will be spaced for a smooth transition between stops that maximise resolution. The resolution can be reduced by setting the Resolution value to a fraction between 0 and 1.0.

This results in the colour values being averaged to a single value for every block of n colours, where n is the value 1 / (1 - Resolution).

Resolution is at its maximum when this value is set to 1 (the default).

The SID field is provided for the purpose of SVG support. Where possible, we recommend that you use the existing object name and automatically assigned ID's for identifiers.

SpreadMethod determines what happens when the first cycle of gradient colours is exhausted and needs to begin again. The default setting is VSPREAD::PAD.

The colours that will be used for drawing a gradient are defined by the Stops array. At least two stops are required to define a start and end point for interpolating the gradient colours.

A transform can be applied to the gradient by setting this field with an SVG compliant transform string.

The default coordinate system for gradients is BOUNDING_BOX, which positions the gradient around the vector that references it. The alternative is USERSPACE, which positions the gradient scaled to the current viewport.

Derived gradient classes override this field to return the SVG element name and any shape-specific attributes. The returned string does not include angle brackets, common gradient attributes, stops or child elements.