====== 노브 ======

노브(Knob)는 오디오 볼륨 다이얼처럼 회전 동작을 통해 값을 조정하는 위젯입니다.  \\ 
아날로그 감성의 입력 방식이 필요할 때 사용합니다.

{{ :comfilestudio:widget_knob:nobe1.png?nolink |노브 위젯이 화면에 배치된 예시입니다.}}

===== 기본 설정 =====

{{ :comfilestudio:widget_knob:nobe2.png?nolink |노브 기본 설정 화면입니다.}}

==== 1. 연동 대상 선택 ====

노브는 다음 중 하나의 대상과 연동할 수 있습니다.

  * 외부 장치 워드 주소
  * 내부 변수
  * 내부 메모리

노브를 돌리면 선택한 대상에 값이 기록되며,
반대로 대상 값이 변경되면 노브 위치도 자동으로 변경됩니다.

==== 2. 각도 표현 설정 ====

노브의 최소값과 최대값이 위치할 각도를 설정합니다.

{{ :comfilestudio:widget_knob:s4.png?nolink |노브 최소/최대 각도 설정 화면입니다.}}

예를 들어:
  * 시작 각도: 135°
  * 끝 각도: 45°

와 같이 설정하면 해당 범위 내에서 회전합니다.

===== 사용 예 =====

노브 값을 모니터링하기 위해 <숫자> 위젯을 추가하고,
내부 변수 num을 표시하도록 설정한 예입니다.

{{ :comfilestudio:widget_knob:nobe_number.png?nolink |숫자 위젯과 연동한 예시입니다.}}

{{ :comfilestudio:widget_knob:nobe_number2.png?nolink |내부 변수 연동 설정 화면입니다.}}

{{ :comfilestudio:widget_knob:dialsimul1.gif?nolink |노브 동작 데모입니다.}}

==== 3. 스위치 방식 ====

기본 방식은 최소값~최대값 사이의 연속적인 값을 전달합니다.

그러나 "스위치 방식"을 선택하면
미리 정의된 특정 값에서만 멈추도록 설정할 수 있습니다.

  * 스위치 개수와 값 개수는 반드시 일치해야 합니다.
  * 위치는 시작점과 끝점 사이를 균등 분할하여 자동 배치됩니다.

{{ :comfilestudio:widget_knob:nobe_number3.png?nolink |스위치 방식 설정 화면입니다.}}

{{ :comfilestudio:widget_knob:dialsimul2.gif?nolink |스위치 방식 동작 예시입니다.}}

===== 디자인 =====

{{ :comfilestudio:widget_knob:nobe3.png?nolink |노브 디자인 설정 화면입니다.}}

디자인은 두 부분으로 구성됩니다.

  * 본체 (Body)
  * 포인터 (Pointer)

각각:
  * 시스템 리소스 사용
  * 사용자 이미지 직접 지정

중 선택할 수 있습니다.

===== 내부 레이아웃 =====

{{ :comfilestudio:widget_knob:s3.png?nolink |노브 내부 레이아웃 설정 화면입니다.}}

  * 포인터 크기 설정
  * 회전 반경 설정
  * 궤적 범위 설정

※ 시스템 리소스를 사용하는 경우  
"시스템 레이아웃 사용"을 체크하면
해당 디자인에 최적화된 레이아웃이 자동 적용됩니다.

===== 캡션 / 표시 및 위치 =====

노브 위에 표시할 텍스트를 설정하고
표시 여부 및 위치를 조정할 수 있습니다.

  * [[..:widget_attribute:index|위젯 속성 설정]]

{{ :comfilestudio:widget_knob:s3_1.png?nolink |캡션 및 위치 설정 화면입니다.}}

----
키워드: 노브 위젯, 다이얼 입력, 스위치 방식 노브, 내부 변수 연동, 워드 주소 제어, Comfile Studio 회전 입력

[[comfilestudio:index#위젯|상위 페이지로 가기]]