위젯 작업 > 3D > 모델
  
모델
* 
모델 파일은 각 경험 내에 번들 처리되어 있고 자격 증명 정보를 포함할 수 있으므로, 보호되어야 할 IP 정보가 번들 처리된 파일에 의해 노출되지 않도록 확인하는 것이 좋습니다.
이 위젯의 기능은 무엇인가요?
모델 위젯을 사용하면 모델을 사용자의 경험에 추가할 수 있습니다.
이 위젯은 언제 사용해야 하나요?
3D 모델을 사용자의 경험에 포함하려는 경우 모델을 사용합니다. 경험을 볼 때 모델 성능 향상에 대한 정보는 모델 복잡성 지침 항목을 참조하십시오.
특별한 속성, 서비스, 이벤트 또는 작업이 있나요?
공통적인 위젯 속성, 서비스 및 이벤트 목록을 보려면 공통적인 위젯 속성, 서비스 및 이벤트 항목을 참조하십시오.
다음 테이블은 이 위젯에 한정된 속성, 서비스 및 이벤트 목록을 제시합니다.
속성 이름
JavaScript
유형
설명
리소스
src
resource url
모델에 사용되는 리소스의 경로입니다. 지원되는 형식에 대한 자세한 내용은 지원되는 CAD 파일 형식 항목을 참조하십시오.
배율
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축에 대한 모델의 회전입니다.
가림
occlude
boolean
true로 설정하면 위젯의 형상이 표시되지 않으며, 동시에 3D 장면에서 위젯 뒤에 다른 모든 증강을 숨깁니다.
따라서 배경 또는 카메라 피드에 가려진 위젯이 있어야 할 위치가 표시됩니다. 이는 주변 3D 형상을 숨겨 일부 증강을 강조하는 데 사용할 수 있습니다.
항상 위에 표시
decal
boolean
모델이 항상 맨 위에 오도록 렌더링을 변경합니다.
이 확인란을 선택하면 모델이 다른 증강에 의해 숨겨지지 않습니다.
불투명도(1 불투명 - 0 투명)
opacity
number
객체의 투명도 레벨을 0 ~ 1 사이로 제어합니다. 0은 완전히 투명이며 1은 완전히 불투명입니다. 반투명으로 설정한 경우(예: 투명도를 1미만으로 설정), 모델 항목을 투명 셸로 그릴 것인지(기본값) 안이 다 보이도록 할 것인지 여부를 제어합니다.
현재 단계
currentStep
number
모델에 대해 지정되어 있는 활성 시퀀스의 현재 단계입니다.
재생 중
playing
boolean
시퀀스가 재생 중일 때 true입니다.
시퀀스 목록
sequenceList
info table
모델에 사용할 수 있는 시퀀스 목록을 제공하는 인포테이블입니다. 인포테이블에는 namefilename 열이 포함되어 있습니다. 위젯에 바인딩된 경우(예: 반복기, 목록 또는 위젯 선택), 여러 시퀀스가 있는 모델에 대한 시퀀스를 간단하게 변경할 수 있습니다.
시퀀스
sequence
resource url
활성 애니메이션 시퀀스의 경로입니다. 이 드롭다운 목록은 .pvz 파일이 리소스 속성에 대해 선택되면 사용 가능한 .pvi 파일로 자동으로 채워집니다. 동시에 두 개의 시퀀스를 실행해서는 안 됩니다.
* 
Creo Illustrate 8.1 이상에서 생성된 시퀀스가 지원됩니다.
디자인 타임에 시퀀스 적용
showSequenceInCanvas
boolean
디자인 타임 동안 Vuforia Studio 내 모델의 모양새에 영향을 미칩니다. 이 확인란과 시퀀스를 선택하는 경우, 시퀀스의 초기 단계가 설계 보기에 직접 적용됩니다. 이 확인란을 선택하지 않으면 모델이 기본 상태로 나타납니다.
단계
steps
number
활성 시퀀스의 전체 단계 수입니다.
서비스 이름
JavaScript
설명
앞으로
forward
시퀀스를 한 단계 앞으로 이동합니다.
재생
play
현재 위치에서 시퀀스를 재생합니다.
모두 재생
playAll
단계 사이에서 중지하지 않고 현재 위치에서 시퀀스를 재생합니다.
재설정
reset
보기의 모든 모델을 첫 번째 단계로 재설정합니다.
되감기
rewind
시퀀스를 한 단계 뒤로 이동합니다.
중지
stop
현재 위치에서 시퀀스를 중지합니다.
이벤트
JavaScript
설명
재생 시작됨
playstarted
시퀀스의 단계가 재생되기 시작하면 트리거됩니다.
재생 중지됨
playstopped
시퀀스의 단계가 재생을 중지하면 트리거됩니다. 데이터 객체 매개 변수를 전달하여 단계에 대한 정보를 제공합니다.
모델 로드됨
modelLoaded
모델이 완전히 로드되면 트리거됩니다.
승인 요청됨
acknowledgeRequested
시퀀스 중 승인이 요청되면 트리거됩니다.
* 
승인에 대한 사용자 정의 상호 작용을 생성하려면 JS 표현식 상자를 사용합니다.
* 
다른 모든 가시성 설정을 무시하고 모델과 관련된 모든 항목을 숨기려면 다음 위젯 속성 중 한 가지를 모델에 바인딩하고 바인딩 대상 선택 창에서 강제로 숨기기를 선택합니다.
2D 위젯
속성
확인란
전환
전환 버튼
누름
누르지 않음
선택한 시퀀스로 설정하면 어떤 가시성도 무시됩니다.
위젯 작동
본 예는 위젯의 작동 장면입니다.
사용에 필요한 최소 단계
작동 장면
1. 모델 위젯을 캔버스로 끌어서 놓습니다.
2. 리소스 필드에서 기존 CAD 파일을 선택하고, 새 CAD 파일을 추가한 다음 표시하려는 이미지에 대한 URL을 입력합니다.
3. 모델을 원하는 캔버스에 배치합니다.