가중치가 적용된 스트로크

버전 2 이후

지정된 두께와 색상을 사용할 수 있는 개별 세그먼트가 있는 획 패턴입니다. 특히 GOAL_PROGRESS, RANGED_VALUE, WEIGHTED_ELEMENTS 정보 표시를 렌더링하는 데 사용됩니다.

문법

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

속성

WeightedStroke 요소는 다음과 같은 속성을 포함합니다.

필수 속성

다음 속성은 필수입니다.

colors

가중치가 적용된 획의 각 요소의 색상으로, 공백으로 구분된 16진수 값 목록으로 지정됩니다(예: #FF0000 #00FF00 #0000FF).

색상 데이터를 제공하는 GOAL_PROGRESS 또는 RANGED_VALUE 정보 표시 데이터를 렌더링하는 데 사용되거나 WEIGHTED_ELEMENTS를 사용하여 colors를 [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] 또는 [COMPLICATION.WEIGHTED_ELEMENTS_COLORS]로 직접 채울 수 있습니다.

thickness

부동 소수점 수로 표현된 획의 두께입니다.

선택사항 속성

다음 속성은 선택사항입니다.

weights

공백으로 구분된 값 목록으로, 각 가중치가 차지하는 원호의 비율을 결정합니다(예: 1.0 2.0 3.0). 여기서 세 번째 요소는 첫 번째 요소 각도의 3배를 차지합니다.

WEIGHTED_ELEMENTS 정보 표시의 데이터를 나타내는 데 사용되는 경우 [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS]를 직접 전달할 수 있습니다.

discreteGap

각 요소 사이의 각도입니다. 기본값은 0.0입니다.

interpolate

true로 설정하면 weights 목록의 각 요소 N은 단색과 달리 colors 목록의 색상 N에서 색상 N+1까지의 색상 그라디언트를 가집니다.

GOAL_PROGRESS 또는 RANGED_VALUE 정보 표시의 데이터를 나타내는 데 사용하는 경우 [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] 또는 [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] 필드의 값을 직접 전달할 수 있습니다. WEIGHTED_ELEMENTS 정보 표시 데이터를 나타내는 데 사용할 경우 interpolate를 false로 설정합니다.

기본값은 false입니다.

cap

획의 가장자리 모양을 정합니다. 지원되는 값은 다음과 같습니다.

  • BUTT: 획이 경로와 함께 종료되고 그 뒤로 돌출되지 않습니다.
  • ROUND: 획이 중심이 경로의 끝에 있는 반원으로 돌출됩니다.
  • SQUARE: 획이 중심이 경로의 끝에 있는 정사각형으로 돌출됩니다.

내부 요소

WeightedStroke 요소는 다음 요소를 포함할 수 있습니다.