自定义属性

自定义属性是一种在 Blender 的数据块中存储您自己的数据的方法。它可用于绑定（骨骼和物体可以具有驱动其他属性的自定义属性）和 Python 脚本，其中定义 Blender 中不可用的新设置是很常见的。还可以通过属性节点从材质访问自定义属性。

只有这些数据支持自定义属性：

要添加自定义属性，请搜索大多数属性或侧栏底部的 自定义属性 面板，然后单击新建。可以使用删除图标从同一位置删除属性。属性添加后，可以通过编辑图标进行配置，以处理特定用例；有关详细信息，请参阅编辑属性。

编辑属性

自定义属性可以使用可用于支持它的数据类型的面板进行编辑。编辑属性允许您配置默认值、范围，甚至添加自定义工具提示。

类型

属性的数据类型；不同的数据类型只能具有特定的数据属性。

浮点:: 小数位数值，例如 3.141、5.0 或 6.125 。
浮点数列:: 多个浮点数据类型的集合，例如 [3.141, 5.0, 6.125]。这种数据类型还可用于可表示为诸如颜色的浮点数组的数据。这些特殊的浮点数组可以在 子类型 选择器中设置。
整数:: 没有任何小数位数的数值，例如 1、2、3 或 4 。
整数数列:: 多个整数数据类型的集合，例如 [1, 2, 3, 4]。
布尔:: 有两种可能取值的数据类型例如 True (真) 或 False (假)。
布尔数列:: 布尔值的集合，例如 [True, False, True]
字符串:: 一个字符序列，如 "一些文本"。
Python:: 直接编辑 Python 数据类型，用于不支持的数据类型。

数组长度

数组中的元素数。请注意，如果数组长度大于 7，则无法直接编辑其元素，则必须按 编辑值 编辑数组的元素。

属性名

显示在值左侧的文本。此名称还用于通过 Python 访问属性。

默认值

这将设置重置为默认值操作符使用的属性默认值。

Warning

默认值用作 NLA 混合的基础，而用于作为关键帧的属性上的无意义默认值（例如，用于缩放的属性为 0）可能会导致问题。

最小值，最大值

自定义属性可以采用的最小/最大值。

库重写

当数据块被关联时，允许属性重写。

软限制

开启通过滑块调整 属性值 的限制，而无需以数字方式输入值。

步长

用于控制数据类型一次增量的乘数。浮点的内部步长为 0.01，因此步长值为 5 将以 0.05 的速率递增，步长值为 100 将递增 1.0。对于整数，内部步长为 1。

精度

要在用户界面中显示的浮点数据类型的小数后面的位数。

子类型

指定属性包含的数据类型，这将影响其在用户界面中的显示方式。此选项仅适用于浮点属性，常规浮点和浮点数列有不同的选项。注意，单位通常取决于场景单位设置。

对于常规浮点数：

纯数据:: 数据值没有任何特殊行为。
像素:: A measure digital image resolution.
百分比:: 显示值是一个百分比，通常情况下，您可能希望最小值和最大值分别为 0 和 100 。
系数:: A percentage between an upper and lower bound which typical have a numerical significance.
角度:: A measure between intersecting lines.
时间:: 以秒为单位的时间。
距离:: 项目之间空间的测量。
能量(乘方):: Work as a factor of time, measured in watts. This is used in Blender to measure light intensity.
温度:: Intensity of heat present.

对于浮点数列：

Note

要使任一颜色子类型按预期工作，属性值 必须是一个包含三个或四个值的向量，具体取决于是否有 Alpha 通道可用。

描述

允许你为你的自定义属性编写提示。

可以通过与字典类似的方式访问自定义属性，其中键值只能是字符串，而值只能是字符串、数字、数组或嵌套属性。

有关详细信息，请参阅 API 文档。