블렌더 데이터블록 - beullendeo deiteobeullog

Data-Block Types

Data-blocks types with their icon.

For reference, here is a table of data-blocks types stored in blend-files.

Library Linking, supports being linked into other blend-files.

File Packing, supports file contents being packed into the blend-file (not applicable for most data-blocks which have no file reference).

Life Time

Every data-block has its usage counted (reference count), when there is more than one, you can see the number of current users of a data-block to the right of its name in the interface. Blender follows the general rule that unused data is eventually removed.

Since it is common to add and remove a lot of data while working, this has the advantage of not having to manually manage every single data-block. This works by skipping zero user data-blocks when writing blend-files.

Sharing

Data-blocks can be shared among other data-blocks.

Examples where sharing data is common:

• Sharing textures among materials.

• Sharing meshes between objects (instances).

• Sharing animated actions between objects, for example to make all the lights dim together.

You can also share data-blocks between files, see linked libraries.

Making Single User

When a data-block is shared between several users, you can make a copy of it for a given user. To do so, click on the user count button to the right of its name. This will duplicate that data-block and assign the newly created copy to that usage only.

Note

Objects have a set of more advanced actions to become single-user, see their documentation.

Removing Data-Blocks

As covered in Life Time, data-blocks are typically removed when they are no longer used. They can also be manually unlinked or deleted.

Unlinking a data-block means that its user won’t use it anymore. This can be achieved by clicking on the “X” icon next to a data-block’s name. If you unlink a data-block from all of its users, it will eventually be deleted by Blender as described above (unless it is a protected one).

Deleting a data-block directly erases it from the blend-file, automatically unlinking it from all of its users. This can be achieved by Shift-LMB on the “X” icon next to its name.

Warning

Deleting some data-blocks can lead to deletion of some of its users, which would become invalid without them. The main example is that object-data deletion (like mesh, curve, camera…) will also delete all objects using it.

Those two operations are also available in the context menu when RMB-clicking on a data-block in the Outliner.

Custom Properties

Custom Properties panel.

Custom properties are a way to store your own data in Blender’s data-blocks. It can be used for rigging (where bones and objects can have custom properties driving other properties), and Python scripts, where it’s common to define new settings not available in Blender. It is also possible to access custom properties from materials via the Attribute Node.

Only certain data supports custom properties:

• All data-blocks types.

• Bones and pose bones.

• Sequence strips.

To add a custom property, search for the Custom Properties panel, found at the bottom of most Properties or Sidebar region, and click New. Properties can be removed from the same location with the delete icon. Once properties are added they can be configured via the edit icon to work for a particular use case; see Editing Properties for more information.

Editing Properties

User Interface

Custom Properties edit pop-up.

Custom properties can be edited using the panel available for data types that support it. Editing the properties allows you to configure things such as default values, ranges, and even add a custom tooltip.

Type

The data type of the property; different data types have can only have specific data properties.

Float

A numeric value with decimals e.g. 3.141, 5.0, or 6.125.

Float Array

A collection of multiple float data types e.g. [3.141, 5.0, 6.125] . This data type can also be used for data that can be represented as a float array such as colors. These special float arrays can be set in the Subtype selector.

Integer

A numeric value without any decimals e.g. 1, 2, 3, or 4.

Integer Array

A collection of multiple integer data types e.g. [1, 2, 3, 4] .

String

A sequence of characters such as “Some Text”.

Python

Edit a Python data type directly, used for unsupported data types.

Note

Boolean values must be handled as integers and only work when using Min/Max values that are integers and that are no more than 1 apart.

At this point, the Boolean values will still look like integers but behave like a Boolean having one lower, off, value and a higher, on, value.

Array Length

The number of elements in the array. Note that if the array length is greater than 7 you cannot directly edit its elements, you must press Edit Value to edit the elements of the array.

Property Name

The text that is displayed to the left of the value. This name is also used to access the property via Python.

Default Value

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

Warning

Default values are used as the basis of NLA blending, and a nonsensical default (e.g. 0 for a property used for scaling) on a property intended for being keyframed is likely to cause issues.

Min, Max

The minimum/maximum value the custom property can take.

Library Overridable

Allow the property to be overridden when the data-block is linked.

Soft Limits

Enables limits that the Property Value slider can be adjusted to without having to input the value numerically.

Soft Min, Max

The minimum/maximum value for the soft limit.

Step

A multiplier to control how much the data type is incremented at a time. The internal step size for floats is 0.01, so a Step value of 5 will increment at a rate of 0.05 and a Step value of 100 will increment by 1.0. For integers the internal step size is 1.

Precision

The number of digits after the decimal to display in the user interface for float data types.

Subtype

Specifies the type of data the property contains, which affects how it appears in the user interface. In order for this property to appear the Property Value must be a vector of floats. For either of the color subtypes to work the Property Value must be a vector with three or four values depending on the availability of an Alpha Channel.

Plane Data

Data values do not have any special behavior.

Linear Color

Color in linear color space.

Gamma-Corrected Color

Color in gamma corrected color space.

Euler Angles

Euler Rotation angles.

Quaternion Angles

Quaternion Rotation angles.

Description

Allows you to write a custom Tooltip for your property.

Python Access

Custom properties can be accessed in a similar way to dictionaries, with the constraints that keys can only be strings, and values can only be strings, numbers, arrays of such, or nested properties.

See the API documentation for details.