对象 | Objects
此类拼图用于操作场景中的对象。

内容
- 拼图参考
- show(显示)
- hide(隐藏)
- is visible(...是可见的)
- clone(克隆)
- create object(创建对象)
- remove object(删除对象)
- set transform(设置变换)
- get transform(获取变换)
- change local transform(改变本地变换)
- snap to object(对齐对象)
- parent(父子约束)
- set object direction(设置对象的方向)
- get object direction(获取对象方向)
- get objects from(从...获取对象)
- get morph factor(获取变形系数)
- set morph factor(设置变形系数)
- add annotation(添加注解)
- remove annotation(删除注解)
- open annotation(打开注解)
- close annotation(关闭注解)
- create text object(创建文本对象)
- update text object(更新文字对象)
- get object dimension(获取对象尺寸)
- distance(距离)
- get custom props(获取自定义属性)
- outline(轮廓)
- set shadow param(设置阴影参数)
- update light probe objects(更新光照探头)
拼图参考
show(显示)
让处在隐藏状态的指定对象变得可见。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。如果场景中没有这样的对象,或者对象已经是可见的,则不做任何操作。

hide(隐藏)
让指定对象不可见。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。如果场景中没有这样的对象,或者对象已经不可见,则不做任何事情。

is visible(...是可见的)
检查一个对象(或者列表中的任一对象)当前是否可见。如果是,返回逻辑值true,否则返回false。如果场景中没有这样的对象,返回false。

clone(克隆)
复制一个对象,并为该新对象生成一个唯一的名称,并立即将其添加到场景中。输出新的对象。对列表、组或 all objects(所有对象) 拼图不起作用。

create object(创建对象)
创建并添加一个新的对象到场景中。此拼图可直接在场景中创建对象,无需从3D编辑器。因此没有3D建模技能用户,也可以立即用其上手学习拼图,并设计初级的可视化场景。

对其创建的几何对象,比如立方体或茶壶,此拼图也会为其自动创建白色的glTF兼容性PBR材质(roughness透明度值设为1,metalness金属度设为0)。使用 set color(设置颜色) 和 set(设置值) 拼图来调整该材质。
对于“有纹理的对象”,此拼图会为模型指定了一个虚拟的棋盘格纹理,使用 replace texture 来更改此纹理。
remove object(删除对象)
从场景中删除一个指定的对象。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。如果场景中没有这样的对象,则不做任何事情。

set transform(设置变换)
根据指定的变换数据来移动、旋转或缩放一个对象。启用 "offset(偏移)" 复选框可以使对象相对于原始位置/旋转/比例进行移动/旋转/缩放。任何轴的输入都可以留空。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。

有时您需要输入一个向量(由给定的 X、Y、Z 坐标组成)。在这种情况下,您可以通过单击齿轮图标并设置复选框 use vector(使用矢量) 来修改拼图。“world space(世界空间)”复选框支持在世界空间中进行变换(以XYZ顺序进行欧拉旋转),否则在物体空间中进行变换。
get transform(获取变换)
检索对象的位置、旋转或缩放数据。要检索世界空间中的变换,请单击齿轮图标并设置“世界空间world space"”复选框(按XYZ顺序检索欧拉旋转)。不适用于列表,组或 all objects(所有对象) 拼图。

change local transform(改变本地变换)
根据指定的变换数据,在局部空间中移动、旋转或缩放一个物件。任何轴的输入都可以留空。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。有时你需要输入一个(由给定的X、Y、Z坐标组成的)矢量。在这种情况下,请点击齿轮图标并勾选 use vector 复选框来修改拼图。

snap to object(对齐对象)
通过复制目标变换数据,将一个对象其移动到另一个对象的位置。也可以复制旋转和缩放。对列表、组或 all objects(所有对象) 拼图不起作用。

parent(父子约束)
在对象之间建立父子关系,使第一个对象跟随第二个对象的位置/旋转/缩放。对列表、组或 all objects(所有对象) 拼图不起作用。

指定 <none> 作为第二个值,以 解除 对象的父子关系。

set object direction(设置对象的方向)
使用X、Y、Z坐标的点或向量为一个对象设置方向。启用 point复选框,指定 X、Y、Z 坐标是否属于 3D 空间中的某个点或表示方向向量。 lock up 复选框锁定对象的上下轴,使其保持垂直于水平面。

get object direction(获取对象方向)
返回一个对象的方向向量或X、Y、Z数字向量分量。

get objects from(从...获取对象)
这个通用拼图可用于:
- 获取组中包含的对象列表,从而使其可迭代。
- 将所有对象拼图的输出转换为一个列表,从而使其可遍历。
- 获取某个父对象的子对象

可用下拉菜单来启用对象类型过滤(比如摄影机、灯、注解等)。
get morph factor(获取变形系数)
返回一个对象的变形目标系数。
可以用文本输入代替下拉选项来设置变形目标。在这种情况下,请点击齿轮图标并勾选 flexible target input 复选框来修改拼图。

set morph factor(设置变形系数)
设定一个对象的变形目标系数。
可以用文本输入代替下拉选项来设置变形目标。在这种情况下,请点击齿轮图标并勾选 flexible target input 复选框来修改拼图。

示例:

参见Parametric Models演示的源文件,以及这一视频教程解释了使用morph target puzzles的基础知识。Bilibili: 使用Verge3D,Blender和WebGL制作交互式参数化模型
add annotation(添加注解)
向对象添加兴趣点图标,用户可以通过单击该图标来展开该图标以查看某些描述。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。

也可以用文本来传递自定义名称。在这种情况下,请点击齿轮图标并勾选 enable "name" 复选框选项。

注意:
此拼图创建了2个HTML元素,可以使用它们的类对其进行 CSS样式化 。

您还可以通过分配和访问其元素的 id 来设置每个单独的注解的样式。

默认情况下,被某些几何体遮挡的注解会自动关闭并变为半透明。可通过关闭 configure application(配置应用) 拼图中的 fade annotation(淡化注解) 选项来修改此项默认设定。

您可以使用一个更低级的替代方案,即 bind(绑定元素) 拼图,但它不会在点击后展开,也不会被几何图形遮挡。
remove annotation(删除注解)
从对象中移除之前添加的注解。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。

open annotation(打开注解)
展开一个由其标签指定的注解。

close annotation(关闭注解)
关闭一个由其标签指定的注解。

create text object(创建文本对象)
根据指定的文本内容和参数,生成一个新的文本对象。

基础选项:
- with text
- 生成文本。
- font
- 用于生成文本的字体。支持以下字体格式: WOFF, TTF, OTF。
- size
- 以引擎单位渲染文本的大小(取决于建模套件:米、英寸等)。
- extrude
- 文本字形的挤出高度。
高级选项:
- segments
- 用于渲染文本的分段数。数字越小,性能越好;数字越大,渲染质量越好。
- bevel thickness
- 文本斜角的厚度。
- bevel size
- 文本斜角的大小。
- horizontal align
- 水平文本对齐。
- vertical align
- 垂直文本对齐。
update text object(更新文字对象)
根据指定的文本内容为一个文本对象生成一个新的网格。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。

此拼图也适用于对象列表、组(或组的列表)以及 all objects(所有对象) 拼图。
get object dimension(获取对象尺寸)
将对象尺寸输出为数字 X、Y、Z 分量或向量。 也适用于对象列表、组(或组列表)或 all objects(所有对象) 拼图。

使用示例:

此拼图有一定的局限性。对变形对象,它将返回对象可以变形的最大尺寸。对于蒙皮对象,拼图将返回对象的原始尺寸。
distance(距离)
输出两个指定对象之间的距离。对列表、组或 all objects(所有对象) 拼图不起作用。

get custom props(获取自定义属性)
返回一个 dictionary(字典) ,其中包含分配给一个对象的自定义属性。


自定义属性可以在Blender中通过使用Custom Properties面板来指定。

或者在 3ds Max 中通过在 对象属性 对话框中输入属性。

或在Maya中通过属性编辑器中的菜单 属性 -> 添加属性... 添加。


如果是Maya,您需要指定额外的customProperties属性,其中包含空格分隔的自定义属性名称列表。

outline(轮廓)
对指定对象应用或删除轮廓效果。需要在 Blender、 3ds Max 或 Maya中启用轮廓效果。也适用于对象列表,组(或者组的列表)以及 all objects(所有对象) 拼图。

set shadow param(设置阴影参数)
启用/禁用给定对象投射/接收阴影。也适用于对象列表、组(或组列表)或 all objects(所有对象) 拼图。

update light probe objects(更新光照探头)
为指定的光照探头更新或渲染反射贴图。

在使用拼图时遇到困难?
欢迎您随时在 论坛上提问!您还可以加入中文用户社区QQ群(171678760),在线寻求帮助。