Gewichteter Strich

Seit Version 2

Ein Strichmuster mit einzelnen Segmenten, die bestimmte Gewichtungen und Farben annehmen können. Insbesondere beim Rendern von GOAL_PROGRESS-, RANGED_VALUE- und WEIGHTED_ELEMENTS-Zusatzfunktionen.

Syntax

<WeightedStroke colors="argb-color-list" thickness="float"
    weights="weight-list" discreteGap="float" interpolate="boolean"
    cap="BUTT | ROUND | SQUARE" />

Merkmale

Das WeightedStroke-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

colors

Die Farben der einzelnen Elemente des gewichteten Strichs als durch Leerzeichen getrennte Liste von Hexadezimalwerten, z. B. #FF0000 #00FF00 #0000FF.

Wenn die Zusatzfunktionsdaten von GOAL_PROGRESS oder RANGED_VALUE, die Farbdaten angeben, oder mit WEIGHTED_ELEMENTS gerendert werden, kann colors direkt mit [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] oder [COMPLICATION.WEIGHTED_ELEMENTS_COLORS] ausgefüllt werden.

thickness

Die Dicke der Kontur wird als Gleitkommadimension ausgedrückt.

Optionale Attribute

Die folgenden Attribute sind optional:

weights

Eine durch Leerzeichen getrennte Liste von Werten, die den Anteil des von jeder Gewichtung eingenommenen Bogens bestimmt, z. B. 1.0 2.0 3.0, wobei das dritte Element den dreifachen Winkel des ersten Elements einnimmt.

Bei Verwendung zur Darstellung von Daten aus der WEIGHTED_ELEMENTS-Zusatzfunktion kann [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] direkt übergeben werden.

discreteGap

Der Winkel zwischen den einzelnen Elementen. Die Standardeinstellung ist 0.0.

interpolate

Wenn true festgelegt ist, hat jedes Element N aus der Liste weights einen Farbverlauf von Farbe N zu Farbe N+1 in der Liste colors (im Gegensatz zu einer Volltonfarbe).

Wenn Sie Daten aus den Zusatzfunktionen GOAL_PROGRESS oder RANGED_VALUE darstellen möchten, können Sie Werte für die Felder [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] oder [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] direkt übergeben. Wenn Sie die Zusatzfunktionsdaten von WEIGHTED_ELEMENTS verwenden, legen Sie interpolate auf false fest.

Die Standardeinstellung ist false.

cap

Bestimmen Sie die Form der Kontur. Unterstützte Werte:

  • BUTT führt dazu, dass die Kontur mit dem Pfad endet und nicht darüber hinausragt.
  • ROUND führt dazu, dass die Kontur als Halbkreis herausragt, wobei sich der Mittelpunkt am Ende des Pfads befindet.
  • SQUARE führt dazu, dass die Kontur als Quadrat überlagert wird, wobei sich der Mittelpunkt am Ende des Pfads befindet.

Innere Elemente

Das Element WeightedStroke kann die folgenden Elemente enthalten: