<lin> (Linear Gradient Fill)

This element specifies a linear gradient.

Parent Elements

<gradFill>5.1.10.33)

Attributes

Description

<ang> (Angle)

Specifies the direction of color change for the gradient. To define this angle, let its value be x measured clockwise. Then ( -sin x, cos x ) is a vector parallel to the line of constant color in the gradient fill.

The possible values for this attribute are defined by the ST_PositiveFixedAngle simple type (§5.1.12.44).

<scaled> (Scaled)

Whether the gradient angle scales with the fill region. Mathematically, if this flag is true, then we scale the gradient vector ( cos x , sin x ) by the width (w) and height (h) of the fill region, so that the vector becomes ( w cos x, h sin x ) (before normalization). Observe that now if the gradient angle is 45 degrees, the gradient vector is ( w, h ), which goes from top-left to bottom-right of the fill region. If this flag is false, the gradient angle is independent of the fill region and will not be scaled using the manipulation described above. So a 45-degree gradient angle always give a gradient band whose line of constant color is parallel to the vector (1, -1).

The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_LinearShadeProperties">
	<attribute name="ang" type="ST_PositiveFixedAngle" use="optional"/>
	<attribute name="scaled" type="xsd:boolean" use="optional"/>
</complexType>