gradientUnits

Das gradientUnits Attribut definiert das Koordinatensystem, das für Attribute auf den Gradientelementen verwendet wird.

Sie können dieses Attribut mit den folgenden SVG-Elementen verwenden:

linearGradient

Für <linearGradient> definiert gradientUnits das Koordinatensystem, das für die Attribute x1, y1, x2 und y2 verwendet wird.

Wert userSpaceOnUse | objectBoundingBox
Standardwert objectBoundingBox
Animierbar Ja
userSpaceOnUse

Dieser Wert bedeutet, dass die Attribute Werte im Koordinatensystem darstellen, das sich ergibt, indem man das aktuelle Benutzerkoordinatensystem zur Zeit der Verweisnahme auf das Gradientelement (d. h. das Benutzerkoordinatensystem des Elements, das auf das Gradientelement über eine fill oder stroke Eigenschaft verweist) verwendet und dann die durch das Attribut gradientTransform angegebene Transformierung anwendet. Prozentsätze repräsentieren Werte relativ zum aktuellen SVG-Viewport.

objectBoundingBox

Dieser Wert bedeutet, dass das Benutzerkoordinatensystem für die Attribute unter Verwendung des Begrenzungsrahmens des Elements, auf das der Gradient angewendet wird, festgelegt wird und dann die durch das Attribut gradientTransform angegebene Transformierung angewendet wird.

Prozentsätze repräsentieren Werte relativ zum Begrenzungsrahmen des Objekts.

Mit diesem Wert und gradientTransform als Einheitsmatrix ist die Normale des linearen Gradienten senkrecht zum Gradientenvektor im Objektbegrenzungsrahmenraum (d. h. das abstrakte Koordinatensystem, in dem (0,0) sich oben/links des Objektbegrenzungsrahmens befindet und (1,1) unten/rechts). Wenn der Begrenzungsrahmen des Objekts nicht quadratisch ist, kann die Normale des Gradienten, die zunächst senkrecht zum Gradientenvektor im Objektbegrenzungsrahmenraum verläuft, relativ zum Gradientenvektor im Benutzerraum nicht senkrecht dargestellt werden. Wenn der Gradientenvektor parallel zu einer der Achsen des Begrenzungsrahmens ist, bleibt die Gradienten-Normale senkrecht. Diese Transformation erfolgt aufgrund der Anwendung der nicht gleichmäßigen Skalierungstransformation vom Begrenzungsrahmenraum zum Benutzerraum.

radialGradient

Für <radialGradient> definiert gradientUnits das Koordinatensystem, das für die Attribute cx, cy, r, fx, fy und fr verwendet wird.

Wert userSpaceOnUse | objectBoundingBox
Standardwert objectBoundingBox
Animierbar Ja
userSpaceOnUse

cx, cy, r, fx, fy und fr repräsentieren Werte im Koordinatensystem, das sich ergibt, indem man das aktuelle Benutzerkoordinatensystem zur Zeit der Verweisnahme auf das Gradientelement (d. h. das Benutzerkoordinatensystem des Elements, das auf das Gradientelement über eine fill oder stroke Eigenschaft verweist) verwendet und dann die durch das Attribut gradientTransform angegebene Transformierung anwendet.

objectBoundingBox

für <radialGradient>: das Benutzerkoordinatensystem für die Attribute cx, cy, r, fx, fy und fr wird unter Verwendung des Begrenzungsrahmens des Elements, auf das der Gradient angewendet wird (siehe Objekt-Begrenzungsrahmen-Einheiten), festgelegt und dann die durch das Attribut gradientTransform angegebene Transformierung angewendet. Mit diesem Wert und gradientTransform als Einheitsmatrix sind die Ringe des radialen Gradienten kreisförmig im Bezug auf den Objektbegrenzungsrahmenraum (d. h. das abstrakte Koordinatensystem, in dem (0,0) sich oben/links des Objektbegrenzungsrahmens befindet und (1,1) unten/rechts). Wenn der Begrenzungsrahmen des Objekts nicht quadratisch ist, werden die konzeptionell kreisförmigen Ringe im Objektbegrenzungsrahmenraum durch die Anwendung der nicht gleichmäßigen Skalierungstransformation vom Begrenzungsrahmenraum zum Benutzerraum elliptisch dargestellt.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# RadialGradientElementGradientUnitsAttribute
Scalable Vector Graphics (SVG) 2
# LinearGradientElementGradientUnitsAttribute