低層級的 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
|
函數
|
在作業失敗時呼叫。
|
選用
|
|
|
此函數等同於在一個步驟中呼叫 setTranslation 和 setRotation。
|
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))。
• 如果省略顏色，先前設定的顏色覆寫會遭到清除，且項目會以預設的材質顏色進行彩現。
|