Traço ponderado

Desde a versão 2

Um padrão de traço com segmentos individuais, que pode assumir pesos e cores especificadas. É um uso especial para renderizar as complicações GOAL_PROGRESS, RANGED_VALUE e WEIGHTED_ELEMENTS.

Sintaxe

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

Atributos

O elemento WeightedStroke tem os seguintes atributos:

Atributos obrigatórios

Os seguintes atributos são obrigatórios:

colors

As cores de cada elemento do traço ponderado, como uma lista separada por espaços de valores hexadecimais, por exemplo: #FF0000 #00FF00 #0000FF.

Quando usado para renderizar dados de complicação de GOAL_PROGRESS ou RANGED_VALUE que fornecem dados de cor, ou com WEIGHTED_ELEMENTS, colors pode ser preenchido diretamente com [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] ou [COMPLICATION.WEIGHTED_ELEMENTS_COLORS].

thickness

A espessura do traço expressa como uma dimensão flutuante.

Atributos opcionais

Os seguintes atributos são opcionais:

weights

Uma lista de valores separados por espaços, que determina a proporção do arco ocupada por cada peso. Por exemplo, 1.0 2.0 3.0, em que o terceiro elemento ocupa três vezes o ângulo do primeiro elemento.

Quando usado para representar dados da complicação WEIGHTED_ELEMENTS, o [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] pode ser transmitido diretamente.

discreteGap

É o ângulo entre cada elemento. O valor padrão é 0.0.

interpolate

Quando definido como true, cada elemento N da lista weights tem um gradiente de cor da cor N para a cor N+1 da lista colors, em oposição a uma cor sólida.

Quando usado para representar dados de complicações GOAL_PROGRESS ou RANGED_VALUE, é possível transmitir valores para os campos [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] ou [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] diretamente. Quando usado para representar dados de complicação de WEIGHTED_ELEMENTS, defina interpolate como false.

O valor padrão é false.

cap

Determina a forma da borda do traço. Valores aceitos:

  • BUTT faz com que o traço termine com o caminho, e não se projete além dele.
  • ROUND faz com que o traço seja projetado como um semicírculo, com o centro no final do caminho.
  • SQUARE faz com que o traço seja projetado como um quadrado, com o centro no final do caminho.

Elementos internos

O elemento WeightedStroke pode conter os seguintes elementos: