위젯 작업 > 3D > 3D 게이지
  
3D 게이지
이 위젯의 기능은 무엇인가요?
3D 게이지 위젯은 AR 경험의 3D 캔버스에서 이미지와 텍스트 위젯 기능을 결합합니다. 3D 게이지 위젯을 캔버스로 끌어서 놓으면 기본 이미지 및 기본 텍스트가 표시됩니다(업데이트 가능한 두 가지 모두). 지원되는 파일 유형은 다음과 같습니다.
.png
.jpg, .jpeg
.svg
.gif
.bmp
이 위젯은 언제 사용해야 하나요?
3D 게이지에 연결된 사물의 속성을 표시하려는 경우 3D 게이지를 사용합니다. 예를 들어 생성기의 엔진 온도를 표시하려는 경우 엔진 온도 속성을 게이지에 바인딩하기만 하면 됩니다.
특별한 속성, 서비스, 이벤트 또는 작업이 있나요?
공통적인 위젯 속성, 서비스 및 이벤트 목록을 보려면 공통적인 위젯 속성, 서비스 및 이벤트 항목을 참조하십시오.
다음 테이블은 이 위젯에 한정된 속성 목록입니다.
속성
JavaScript
유형
설명
텍스트
text
string
위젯에 표시되는 텍스트입니다.
리소스
src
resource url
3D 게이지에 사용되는 이미지의 경로입니다. 기본적으로 vu_gauge1.svg로 설정됩니다.
3D 게이지를 포함하려면 다음 중 한 가지를 수행하십시오.
필드 옆의 를 클릭하여 새 이미지 파일을 추가합니다.
이미지 URL을 필드에 입력하거나 복사하여 직접 붙여 넣습니다.
드롭다운 메뉴에서 이미지를 선택합니다.
지원되는 파일 유형은 다음과 같습니다.
.png
.jpg
.svg
.jpeg
.gif
.bmp
글꼴
font
string
글꼴 유형입니다. 기본적으로 Arial로 설정됩니다.
글꼴 크기
fontsize
string
글꼴 크기는 픽셀로 지정됩니다. 기본적으로 40px로 설정됩니다.
텍스트 특성
textattrs
string
텍스트 특성은 다음을 포함합니다.
채우기
텍스트 베이스라인
텍스트 정렬
상태 기반 서식 적용 사용
enableStateFormatting
boolean
ThingWorx에서 정의된 상태 정의를 기반으로 하는 위젯의 서식을 지정할 수 있습니다.
확인란을 선택하면 다음 속성이 표시됩니다.
종속 필드
상태 정의
ThingWorx의 스타일 및 상태 정의에 대한 자세한 내용은 ThingWorx 도움말 센터에서 스타일 및 상태 정의를 참조하십시오.
종속 필드
stateFormatValue
string
이 속성은 상태 기반 서식 적용 사용 확인란을 선택한 경우 표시됩니다. ThingWorx의 스타일 및 상태 정의에 대한 자세한 내용은 ThingWorx 도움말 센터에서 스타일 및 상태 정의를 참조하십시오.
상태 정의
stateFormat
boolean
이 속성은 상태 기반 서식 적용 사용 확인란을 선택한 경우 표시됩니다. ThingWorx의 스타일 및 상태 정의에 대한 자세한 내용은 ThingWorx 도움말 센터에서 스타일 및 상태 정의를 참조하십시오.
캔버스에 대한 텍스트의 X 좌표
textx
number
캔버스에 대한 X축에서의 텍스트 위치입니다.
캔버스에 대한 텍스트의 Y 좌표
texty
number
캔버스에 대한 Y축에서의 텍스트 위치입니다.
배율
scale
string
게이지의 배율입니다.
X 좌표
x
number
x축에서의 게이지 위치입니다.
Y 좌표
y
number
y축에서의 게이지 위치입니다.
Z 좌표
z
number
z축에서의 게이지 위치입니다.
X 회전
rx
number
x축에 대한 게이지의 회전입니다.
Y 회전
ry
number
y축에 대한 게이지의 회전입니다.
Z 회전
rz
number
z축에 대한 게이지의 회전입니다.
캔버스에 대한 이미지의 X 좌표
imagex
number
캔버스에 대한 X축에서의 게이지 위치입니다.
캔버스에 대한 이미지의 Y 좌표
imagey
number
캔버스에 대한 Y축에서의 게이지 위치입니다.
캔버스 크기 증가 무시
canvasgrowthoverride
string
캔버스 크기가 무시된 경우 선택할 수 있습니다. 다음 옵션 중 한 가지를 선택합니다.
텍스트 크기에 따라 캔버스 크기 함께 증가 - 텍스트가 커지거나 작아짐에 따라 캔버스의 크기가 변경됩니다
이미지 크기에 따라 캔버스 크기 함께 증가 - 이미지가 커지거나 작아짐에 따라 캔버스의 크기가 변경됩니다
이미지 및 텍스트 크기에 따라 캔버스 크기 함께 증가(기본값) - 이미지 또는 텍스트가 커지거나 작아짐에 따라 캔버스의 크기가 변경됩니다(텍스트와 이미지 중에서 더 큰 값이 캔버스 크기를 재정의).
재정의하지 않음 - 캔버스가 캔버스 높이캔버스 너비 속성으로 정의된 크기로 유지됩니다.
캔버스 높이
canvasheight
number
캔버스의 높이입니다.
캔버스 너비
canvaswidth
number
캔버스의 너비입니다.
빌보드
billboard
boolean
항상 뷰어를 마주보도록 중심 주변으로 위젯을 회전합니다. 위젯이 화면에 맞춰 조정됩니다.
가림
occlude
boolean
이 확인란을 선택하면 위젯의 형상이 표시되지 않으며, 동시에 3D 장면에서 위젯 뒤에 다른 모든 증강을 숨깁니다.
따라서 배경 또는 카메라 피드에 가려진 위젯이 있어야 할 위치가 표시됩니다. 이는 주변 3D 형상을 숨겨 일부 증강을 강조하는 데 사용할 수 있습니다.
항상 위에 표시
decal
boolean
3D 장면에서 깊이에 관계없이 다른 모든 증강의 위젯 형상을 오버레이합니다. 로 설정하면 다른 증강에 의해 숨겨지지 않습니다. 일반적으로 이는 항상 표시되도록 유지해야 하는 레이블 또는 센서에 사용할 수 있습니다.
불투명도(1 불투명 - 0 투명)
opacity
number
객체의 투명도 레벨을 0 ~ 1 사이로 제어합니다. 0은 완전히 투명이며 1은 완전히 불투명입니다.
피벗
pivot
select
이미지의 피봇 점을 결정합니다.
왼쪽 위
위쪽 가운데
오른쪽 위
가운데 왼쪽
정가운데
가운데 오른쪽
왼쪽 아래
아래쪽 가운데
오른쪽 아래
높이
height
number
미터 단위의 게이지 높이입니다.
너비
width
number
미터 단위의 게이지 너비입니다.
위젯 작동
본 예는 위젯의 작동 장면입니다.
사용에 필요한 최소 단계
작동 장면
1. 3D 게이지 위젯을 캔버스로 끌어서 놓습니다.
2. 데이터 창에서 숫자 속성을 가진 서비스가 포함된 엔티티를 검색합니다.
3. 서비스가 추가되면 현재 선택된 항목 아래에서 숫자 속성을 위젯으로 끌어서 놓고 바인딩 대상 선택 창에서 텍스트를 선택합니다.
* 
데이터 창에서 시작 시 호출서비스 > 구성을 선택합니다.