对象 | 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)，在线寻求帮助。