自定义属性

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

百分比:

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.

时间:

以秒为单位的时间。

距离:

项目之间空间的测量。

能量（乘方）:

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

温度:

Intensity of heat present.

波长:

The distance between cycles of a wave measured in millimeters (mm), micrometers (µm), nanometers (nm), or picometers (pm).

对于浮点数列：

纯数据:

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

线性颜色:

线性色彩空间的颜色。

伽玛校正颜色:

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

欧拉转角:

欧拉旋转 角度。

四元数角度:

四元数旋转 角度。

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.

标识类型 数据块

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

描述

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

Python 脚本访问

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

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