# 게이지(Gauge)

## Content

`게이지 플롯`은 속도계 또는 다이얼 플롯으로도 알려져 있으며, 특정 범위 내에서 단일 데이터 포인트를 시각화하는 데 적합합니다. 주로 목표나 목표치에 대한 관계를 나타낼 때 사용됩니다. 이러한 플롯은 진행 상황이나 성과를 시각적으로 매력적으로 전달하려 할 때 특히 유용합니다.
예를 들어, [게이지 플롯 데모](/activereportsjs/demos/Reports/GaugePlot/purejs)의 플롯은 제품 또는 서비스의 네 가지 측면(`제품 품질`, `배송 속도`, `사용 용이성`, `가격`)에 대한 고객 만족도를 시각적으로 표현합니다. 이 플롯은 색상으로 구분된 척도를 사용하며, 만족도 점수는 `1 (매우 불만족)`에서 `100 (매우 만족)`까지 범위를 갖습니다.

![image.d5c985](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/5782ed59-7caa-432e-b8fb-3d0b076233da/image.d5c985.079da8.png)

### 차트 마법사

보고서에 [차트를 추가](/activereportsjs/docs/v6.2/#adding-a-chart)하고 `차트 마법사`의 첫 화면에서 플롯 유형을 `게이지`로 설정한 후 `다음` 버튼을 클릭하면, 다음과 같은 `게이지 설정` 화면이 표시됩니다.

![image.42a0af](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/5782ed59-7caa-432e-b8fb-3d0b076233da/image.42a0af.b7cac7.png)

`필드` 편집기는 게이지의 척도 범위를 정의할 수 있게 해줍니다.
`게이지 포인터` 편집기는 포인터가 가리키는 값을 설정할 수 있습니다.
`게이지 레이블` 편집기는 게이지 내에 표시되는 텍스트를 사용자 지정할 수 있도록 도와줍니다.

### 값

게이지 플롯의 `값` 컬렉션은 게이지 척도의 구간을 설정합니다. 각 `값`은 범위의 상한을 나타내며, 값은 가장 큰 값에서 가장 작은 값 순서로 지정해야 합니다. 플롯은 범위의 색상을 [차트 팔레트](/ReportAuthorGuide/Report-Items/Data-Regions/Chart#%EC%9D%BC%EB%B0%98-%EC%B0%A8%ED%8A%B8-%EA%B5%AC%EC%84%B1)에서 선택합니다.
각 값에 대해 `캡션` 속성을 지정할 수 있으며, 플롯 속성에서 `범례에 값 이름 표시` 플래그를 설정하면 범례에 표시됩니다.
예를 들어, [게이지 플롯 데모](/ReportAuthorGuide/Report-Items/Data-Regions/Chart#%EC%B0%A8%ED%8A%B8-%EC%B6%94%EA%B0%80)에서는 `100`, `75`, `50`, `25`의 네 개의 이름이 지정된 값이 척도 범위를 설정하는 데 사용됩니다. 그 결과, 게이지 척도에는 각기 다른 색상으로 구분된 네 개의 구간이 표시되며, 범례에는 구간의 이름이 표시됩니다.

### 축

게이지 플롯에는 `Y 축`이 포함되어 있으며, 이를 통해 게이지 척도에 표시되는 레이블의 외관 및 기타 속성을 [축 설명서](/activereportsjs/docs/v6.2/ReportAuthorGuide/Report-Items/Data-Regions/Chart/axes)에 따라 구성할 수 있습니다.

### 게이지 포인터

`게이지 포인터` 컬렉션을 통해 게이지 척도에서 특정 지점을 강조하는 여러 포인터를 생성할 수 있습니다. 각 포인터에 대해 다음 속성을 사용자 지정할 수 있습니다:

* `배경색` 표현식은 포인터의 채우기 색상을 설정합니다.
* `바늘 너비` 길이 값은 포인터의 크기를 결정합니다.
* `바늘 핀 너비 ` 길이 값은 포인터 하단에 위치한 원의 크기를 조정합니다.
* `끝` 표현식은 포인터가 나타내는 값을 지정합니다.

예를 들어, [게이지 플롯 데모](/activereportsjs/demos/Reports/GaugePlot/purejs)에서 포인터의 `끝`은 `{satisfaction_score}` 표현식으로 설정되어 있어, 포인터가 현재 측면의 점수를 나타내도록 합니다.

### 게이지 레이블

`게이지 레이블` 컬렉션을 사용하여 게이지 내에 표시되는 텍스트 요소를 추가할 수 있습니다. 각 레이블에 대해 다음 속성을 구성할 수 있습니다:

* `텍스트` 표현식은 레이블의 내용을 설정합니다.
* `오프셋 X` 및 `오프셋 Y` 길이 값은 게이지 중심에 대한 레이블의 위치를 결정합니다.
* [텍스트 속성](/ReportAuthorGuide/Report-Items/Common-Properties#%ED%85%8D%EC%8A%A4%ED%8A%B8-%EC%86%8D%EC%84%B1)의 하위 집합을 통해 레이블의 외관을 사용자 지정할 수 있습니다.

예를 들어, 게이지 데모에서 유일한 레이블의 텍스트는 `{aspect}` 표현식으로 구성되어 있어, 현재 측면이 포인터 근처에 표시되도록 합니다.

### 게이지 외관

아래 속성들은 `게이지` 플롯의 외관을 사용자 지정하는 데 도움이 됩니다. [게이지 플롯 데모](/activereportsjs/demos/Reports/GaugePlot/purejs)에서 설정을 조정하여 그 효과를 확인해 보세요.

* `불투명`: 게이지 척도와 포인터의 불투명도를 설정하는 [숫자](/activereportsjs/docs/v6.2/#scalar)로, 백분율로 표현됩니다. `100%`는 불투명, `0%`는 완전 투명입니다.
* `내부 반경`: 게이지 척도와 중심 사이의 간격을 정의하는 외부 반지름의 백분율을 나타내는 [숫자](/activereportsjs/docs/v6.2/#scalar)입니다.
* `시작 각도`: 플롯의 시계 방향 회전을 지정하는 호도 단위의 [숫자](/activereportsjs/docs/v6.2/#scalar)입니다. 전체 회전은 `360`도입니다.
* `스윕`: 플롯이 차지하는 호의 길이를 결정하는 `0`에서 `360` 사이의 호도 단위 [숫자](/activereportsjs/docs/v6.2/#scalar)입니다.
* `클리핑 모드`: [플롯 영역](/ReportAuthorGuide/Report-Items/Data-Regions/Chart#%EB%8F%84%ED%91%9C-%EC%98%81%EC%97%AD)에서 플롯을 렌더링하는 방식을 정의합니다:
    * `맞춤`: 플롯 영역이 사용 가능한 모든 공간을 사용하여 플롯을 맞춥니다.
    * `자르기`: 플롯 영역이 오른쪽 또는 아래쪽 여백에서 플롯을 잘라냅니다.
    * `없음`: `맞춤`과 동일합니다.
* `스타일` 섹션의 [선](/ReportAuthorGuide/Report-Items/Common-Properties#%EC%84%A0-%EC%86%8D%EC%84%B1) 속성은 척도 범위의 테두리 외관에 영향을 줍니다.
* `배경색` 섹션의 색상 [표현식](/activereportsjs/docs/v6.2/ReportAuthorGuide/Expressions)은 척도 범위의 채우기 색상을 결정하며, 이는 `차트 팔레트` 색상을 무시하고 적용됩니다.