data-scada-part="needle" 인 조각 · 심볼 게이지에는 이미 들어 있습니다prop: angle 태그 필수 levelMin/levelMax(값) → angleMin/angleMax(각도)설명
값을 levelMin~levelMax 구간의 비율로 바꾼 뒤, 그 비율만큼 angleMin~angleMax 사이의 각도로 파트를 돌립니다. 기본값 −120°~+120° 는 아래쪽이 트인 흔한 계기판 눈금과 맞습니다.
rotate 와 다른 점이 두 가지입니다. 요소 전체가 아니라 요소 안의 한 조각만 돌고, 각도를 직접 받는 것이 아니라 값의 범위를 각도의 범위로 옮깁니다. 압력 0~10 bar 를 바늘의 −120°~+120° 에 대응시키는 일을 바인딩 하나로 끝냅니다.
설정 항목
| 이름 | 값 | 기본 | 설명 |
|---|---|---|---|
| 태그 | tagId | — | 읽을 게이트웨이 태그. |
| levelMin | number | 0 | angleMin 에 해당하는 값. |
| levelMax | number | 100 | angleMax 에 해당하는 값. |
| angleMin | number | -120 | 최솟값일 때의 각도(도). 음수는 반시계 방향. |
| angleMax | number | 120 | 최댓값일 때의 각도(도). |
| part | string | needle | 회전시킬 파트 이름. |
동작
값 5 · levelMin 0 · levelMax 10 · 각도 기본값 → −120 + 0.5 × 240 = 0°(정면). 구간 밖의 값은 양 끝 각도에서 멈춥니다.
회전 중심은 파트에 적힌 data-cx / data-cy 입니다. 심볼 안의 좌표(보통 0~100 뷰박스 기준)이고, 없으면 50,50 — 즉 요소 한가운데를 씁니다. 심볼 게이지의 바늘에는 data-cx="50" data-cy="50" 이 들어 있습니다.
직접 그린 도형에 걸 때는 중심을 반드시 확인하세요. 바늘 그림이 뷰박스 한가운데에 있지 않으면 기본 중심(50,50)으로 돌면서 궤도가 어긋납니다. 바늘 조각을 <g data-scada-part="needle" data-cx="…" data-cy="…"> 로 감싸고 실제 회전축 좌표를 적어 주세요.
파트를 못 찾으면 조용히 아무 일도 하지 않습니다. 지금 needle 파트를 가진 심볼은 게이지 하나뿐입니다 — 다른 심볼에 걸었다면 그것이 원인입니다.