自定义属性

../_images/files_data-blocks_add.png

自定义属性面板。

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

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

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

编辑属性

用户界面

../_images/files_data-blocks_edit.png

编辑自定义属性的弹框。

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

类型

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

  • 浮动:

    小数位数值，例如3.141、5.0或6.125。

    浮点数:

    多个浮点数据类型的集合，例如 “[3.141, 5.0, 6.125]“。这种数据类型还可用于可表示为诸如颜色的浮点数组的数据。这些特殊的浮点数组可以在 子类型 选择器中设置。

    整数:

    没有任何小数位数的数值，例如1、2、3或4。

    整数（Integer）:

    多个整数数据类型的集合，例如 “[1、2、3、4]“。

    布尔:

    A data type that has two possible values e.g. True or False.

    Boolean Array:

    A collection of boolean values e.g. [True, False, True]

    字符串型:

    一个字符序列，如 “一些文本” 。

    数据块:

    A reference to a Blender object, see 数据块.

    Python:

    直接编辑Python数据类型，用于不支持的数据类型。

阵列偏移

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

属性名

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

默认值

This sets the default value of the property used by the Reset to Default Value operator.

Warning

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

最小值，最大值

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

库

当数据块链接时，允许属性为 覆盖 。

只有当插值模式设置为立方体时，强度选项才可用。将强度设置为零，得到的结果与线性插值非常相似，而较高的强度会使曲线更加流畅。设置负强度会改变曲线的方向。或者用更直观的方式来描述：它使缩减的体积膨胀，反之亦然。该选项的软限制范围为-3至+3，但你可以通过手动输入一个数字，而不是使用滑块，轻松地指定更大或更小的值。这与Blender中的普通滑块的工作原理相同。

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

  • 角度最小，最大

    钳制 节点用于将数值钳制在最小值和最大值之间的范围内。

步长

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

精度

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

子类型

Specifies the type of data the property contains, which affects how it appears in the user interface. This option is only available for float properties and has different options for regular floats and float arrays. Note, the unit often depends on the Scene Units.

For regular floats:

  • 边角定位节点为图像平面弯曲变换指定明确的边角值。工作方式有些像平面追踪变形节点，区别是不在剪辑编辑器中使用 “平面追踪” 数据。:

    数据值没有任何特殊行为。

    像素:

    A measure digital image resolution.

    百分比:

    The displayed value is a percentage, typically you will want the Min and Max values to be 0 and 100.

    系数:

    A percentage between an upper and lower bound which typical have a numerical significance.

    角度:

    A measure between intersecting lines.

    时间:

    Time specified in seconds.

    距离:

    Measure of space between items.

    能量（乘方）:

    Work as a factor of time, measured in watts. This is used in Blender to measure light intensity.

    温度:

    Intensity of heat present.

For float arrays:

  • 边角定位节点为图像平面弯曲变换指定明确的边角值。工作方式有些像平面追踪变形节点，区别是不在剪辑编辑器中使用 “平面追踪” 数据。:

    数据值没有任何特殊行为。

    场景线性色彩空间:

    场景线性色彩空间

    伽玛校正颜色:

    伽玛校正色彩空间中的颜色。

    欧拉角度:

    Euler Rotation 角度。

    四元数角度。:

    Quaternion Rotation 角度。

Note

For either of the color subtypes to work as expected the Property Value must be a vector with three or four values depending on the availability of an Alpha Channel.

ID Type Data-Block

The ID-block type. For example: Key, Image, Object, Material. See 数据块类型 for a full list.

描述:

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

Python 脚本访问

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

有关详细信息，请参阅 “API 文档 <https://docs.blender.org/api/current/info_quickstart.html#custom-properties>`__。