위젯 작업 > 3D > 이미지 대상
  
이미지 대상
이 위젯의 기능은 무엇인가요?
이미지 대상 위젯을 사용하면 이미지를 추적 방법으로 사용할 수 있습니다.
이 위젯은 언제 사용해야 하나요?
이미지 대상은 여러 가지 이유로 사용할 수 있습니다. 예를 들어, 마케팅 캠페인 혹은 제품이 사용될 환경에서 제품을 시각화하기 위해 이미지를 사용하고자 할 때 이미지 대상을 사용할 수 있습니다.
* 
이미지 대상은 적당히 밝은 확산 조명 아래에서 사용해야 합니다. 조명이 이미지의 표면에 고르게 비춰져야 합니다.
특별한 속성, 서비스, 이벤트 또는 작업이 있나요?
공통적인 위젯 속성, 서비스 및 이벤트 목록을 보려면 공통적인 위젯 속성, 서비스 및 이벤트 항목을 참조하십시오.
다음 테이블은 이 위젯에 한정된 속성 목록입니다.
속성
JavaScript
유형
설명
이미지
url
string
대상에 사용되는 이미지 리소스의 경로입니다.
* 
이 속성은 런타임 중에 편집할 수 없습니다.
사용된 이미지는 다음 조건을 충족해야 합니다.
8비트 또는 24비트 PNG 또는 JPG 파일
2MB 미만의 크기
JPG는 RGB 또는 회색조여야 합니다(CMYK 아님).
어느 면에서든 2024 픽셀을 초과하지 않습니다.
비율은 3:1을 초과하지 않습니다(이미지가 사각형이 아니어도 어느 면도 다른 면보다 3배 이상 길지 ㄴ않아야 함).
마커 너비
width
number
이미지의 너비입니다.
이 필드의 값은 미터 단위로 설정됩니다.
X 좌표
x
number
X축에서의 이미지 대상 위치입니다.
Y 좌표
y
number
Y축에서의 이미지 대상 위치입니다.
Z 좌표
z
number
Z축에서의 이미지 대상 위치입니다.
X 회전
rx
number
X축을 기준으로 한 이미지 대상의 회전입니다.
Y 회전
ry
number
Y축을 기준으로 한 이미지 대상의 회전입니다.
Z 회전
rz
number
Z축을 기준으로 한 이미지 대상의 회전입니다.
추적됨
src
boolean
카메라가 대상을 인식할 때 활성화됩니다.
추적 표기기 표시
src
boolean
이 확인란을 선택하면 추적이 진행 중임을 나타내는 대상의 녹색 추적 아웃라인이 표시됩니다.
고정(아이웨어 프로젝트에만 해당)
src
boolean
대상이 안정된 환경에 있으며 사용자에 의해 이동되지 않는 경우 이 확인란을 선택합니다. 이 확인란을 선택하면 추적 성능이 향상될 수 있습니다.
이벤트
JavaScript
설명
추적 얻음
trackingacquired
추적이 설정되면 트리거됩니다. 전달되는 매개 변수는 위젯 ID입니다.
추적 손실
trackinglost
추적이 손실되면 트리거됩니다. 전달되는 매개 변수는 위젯 ID입니다.
위젯 작동
본 예는 위젯의 작동 장면입니다.
사용에 필요한 최소 단계
작동 장면
1. 이미지 대상 위젯을 캔버스로 끌어서 놓습니다.
2. 새 이미지를 업로드하려면 이미지 필드 옆에 있는 + 아이콘을 클릭하거나 드롭다운 메뉴에서 이미지를 선택합니다.
3. 프로젝트 창의 구성 > 경험 아래에서 ThingMark 연결 드롭다운의 없음을 선택합니다.