自定义属性

../_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 。

整数数列:

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

布尔:

有两种可能取值的数据类型例如 True (真) 或 False (假)。

布尔数列:

布尔值的集合，例如 [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）可能会导致问题。

最小值，最大值

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

库重写

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

软限制

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

软限制最小值、最大值

软限制的最小/最大值。

步长

用于控制数据类型一次增量的乘数。浮点的内部步长为 0.01，因此 步长 值为 5 将以 0.05 的速率递增，步长 值为 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.

对于常规浮点数：

纯数据:

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

像素:

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.

波长:

以毫米（mm）、微米（µm）、纳米（nm）或皮米（pm）为单位测量的波周期之间的距离。

对于浮点数列：

纯数据:

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

线性颜色:

线性色彩空间的颜色。

伽玛校正颜色:

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

欧拉转角:

欧拉旋转角度。

四元数角度:

四元数旋转角度。

Note

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

标识类型 数据块

标识块的类型。例如：关键帧、图像、物体、材质。请参阅数据块类型获取完整列表。

描述

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

Python 脚本访问

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

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