저수준 3D 렌더링 함수
setTranslation
장면에서 위젯의 3D 위치(병진)를 설정합니다. 이 함수는 모델, 모델 항목, 3D 이미지, 3D 게이지, 3D 레이블 및 일부 트래커 위젯에 지원됩니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
name
|
문자열
|
배치할 위젯의 Studio ID
|
필수
|
|
x
|
숫자
|
3D 공간의 X 좌표입니다(단위: 미터).
|
필수
|
|
y
|
숫자
|
3D 공간의 Y 좌표입니다(단위: 미터).
|
필수
|
|
z
|
숫자
|
3D 공간의 Z 좌표입니다(단위: 미터).
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
setRotation
도 단위의 오일러 각을 사용하여 위젯의 3D 회전을 설정합니다. 이 함수는 모델, 모델 항목, 3D 이미지, 3D 게이지, 3D 레이블 및 일부 트래커 위젯에 지원됩니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
name
|
문자열
|
회전할 위젯의 Studio ID입니다.
|
필수
|
|
x
|
숫자
|
X축을 중심으로 한 회전입니다(단위: 도).
|
필수
|
|
y
|
숫자
|
Y축을 중심으로 한 회전입니다(단위: 도).
|
필수
|
|
z
|
숫자
|
Z축을 중심으로 한 회전입니다(단위: 도).
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
setScale
3D 공간에서 위젯의 배율을 설정합니다. 이 함수는 모델, 모델 항목, 3D 이미지, 3D 게이지, 3D 레이블 및 일부 트래커 위젯에 지원됩니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
name
|
문자열
|
배율을 조정할 위젯의 Studio ID입니다.
|
필수
|
|
x
|
숫자
|
X축을 따른 배율 계수입니다.
|
필수
|
|
y
|
숫자
|
Y축을 따른 배율 계수입니다.
|
필수
|
|
z
|
숫자
|
Z축을 따른 배율 계수입니다.
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
 |
이 함수를 사용하여 장면 내의 객체의 배율을 균일하게 또는 균일하지 않게 조정할 수 있습니다.
|
transform
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
name
|
문자열
|
변환할 위젯의 Studio ID입니다.
|
필수
|
|
dx
|
숫자
|
3D 공간의 X 위치입니다(단위: 미터).
|
필수
|
|
dy
|
숫자
|
3D 공간의 Y 위치입니다(단위: 미터).
|
필수
|
|
dz
|
숫자
|
3D 공간의 Z 위치입니다(단위: 미터).
|
필수
|
|
drx
|
숫자
|
X축을 중심으로 한 회전입니다(단위: 도).
|
필수
|
|
dry
|
숫자
|
Y축을 중심으로 한 회전입니다(단위: 도).
|
필수
|
|
drz
|
숫자
|
Z축을 중심으로 한 회전입니다(단위: 도).
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
이 함수는 setRotation과 setTranslation을 한 번에 호출하는 것과 동일합니다.
|
setTexture
위젯의 질감을 설정하거나 업데이트합니다. 질감 소스는 원격 URL 또는 base64로 인코딩된 문자열일 수 있습니다.
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
name
|
문자열
|
질감이 적용될 요소의 Studio ID 입니다.
|
필수
|
|
texture
|
문자열
|
URI 또는 base64로 인코딩된 이미지 문자열입니다. 생략하면 기존 질감이 위젯에서 모두 제거됩니다.
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
질감은 모델, 3D 이미지, 3D 게이지 및 3D 레이블에 적용할 수 있습니다.
|
setColor
|
이름
|
유형
|
설명
|
필수/선택 사항
|
|---|---|---|---|
|
name
|
문자열
|
색상을 적용할 모델의 Studio ID입니다.
|
필수
|
|
color
|
문자열
|
색상은 CSS 스타일, rgb 또는 rgba 값으로 지정됩니다(예: 주황색의 경우 rgb(255, 165, 0) 또는 rgba(255, 165, 0, 1.0)). 생략하면 현재 색상이 제거됩니다.
|
필수
|
|
successCallback
|
함수
|
작업이 성공적으로 완료되면 호출됩니다.
|
선택 사항
|
|
errorCallback
|
함수
|
작업이 실패하면 호출됩니다.
|
선택 사항
|
|
|
• 색상은 rgba(r,g,b,a) 또는 rgb(r,g,b) 형식의 문자열 로 제공해야 합니다. 여기서:
◦ r, g, b는 0에서 255 사이의 정수입니다.
◦ a는 0.0에서 1.0 사이의 실수입니다(생략하면 기본적으로 1.0).
• 색상 문자열이 유효하지 않은 경우 기본값으로 완전 불투명한 검정색(rgba(0,0,0,1))이 사용됩니다.
• 색상을 생략하면 이전에 설정한 색상 재정의가 지워지고 항목이 기본 재료 색으로 렌더링됩니다.
|