Blender Property

Description

The blender property node is your way of getting data from your blender file. You can paste in copied properties. You can get these properties either from right-clicking properties in the blender interface (Get Serpens Property) or by copying them from the blend data browser.

You can’t copy all properties with the right-click option. These will show you a warning to get them over the blend data browser.

To quickly add a copied property you don’t have to add the node manually. Simply press Shift+V to quickly add a blender property node with the pasted property.

Inputs

Once you copy a property you might see inputs appear on the node.

These inputs are indexable inputs, meaning you can change their type between Name, Index, and Property. You can see the type of data you’re indexing by the name of the input. In the example above this is all Objects in your file.

Name: A Name input lets you enter a name from which to get the item. In the example above the object is selected by its name

Index: This lets you select an item by its index. In the example above we could for example select the first object in the file

Property: This option lets you plug in blend data to get this property from. In the example above we could plug in another object, for example from an Objects node or a loop.

Some property inputs have default values: These will show Using ... in brackets behind the name. If they don’t have a default this will show No Data and you have to connect blend data to get a valid output from the node

Outputs

Property (first output): This output will return the actual property. You can use this to connect to something like a display property node

Value: This output will return the current value of the property. In the example above you could use the property output to display a name input and the value output to get the current name, for example to display in a label.

You need to make sure the value output type is set to the correct type for Serpens to be able to properly convert the data if necessary. When you copy data from the interface or the blend data browser this should be set automatically.

While you can usually also plug the property output into something like a string input to get the value, you should make a habit of using the value output. Most of the time converting the property has no issues, but in some cases, this could lead to unexpected results.