base class — bpy_struct
subclasses — Lattice, Library, Key, NodeTree, MetaBall, Text, Lamp, World, Brush, Object, Armature, Mesh, VectorFont, GreasePencil, Sound, ParticleSettings, Scene, WindowManager, Texture, Curve, Action, Group, Screen, Speaker, Material, Image, Camera
Base type for datablocks, defining a unique name, linking from other libraries and garbage collection
Unique datablock ID name
Type : | string, default “” |
---|
Tools can use this to tag data, (initial state is undefined)
Type : | boolean, default False |
---|
Saves this datablock even if it has no users
Type : | boolean, default False |
---|
Number of times this datablock is referenced
Type : | int in [0, 32767], default 0, (readonly) |
---|
Create a copy of this datablock (not supported for all datablocks).
Returns: | New copy of the ID. |
---|---|
Return type: | ID |
Clears the user count of a datablock so its not saved, on reload the data will be removed.
This function is for advanced use only, misuse can crash blender since the user count is used to prevent data being removed when it is used.
# This example shows what _not_ to do, and will crash blender.
import bpy
# object which is in the scene.
obj = bpy.data.objects["Cube"]
# without this, removal would raise an error.
obj.user_clear()
# runs without an exception
# but will crash on redraw.
bpy.data.objects.remove(obj)
Create animation data to this ID, note that not all ID types support this.
Returns: | New animation data or NULL. |
---|---|
Return type: | AnimData |
Clear animation on this this ID.
Tag the id to update its display data.
Parameters: | refresh (enum set in {‘OBJECT’, ‘DATA’, ‘TIME’}, (optional)) – Type of updates to perform. |
---|
Inherited Properties
Inherited Functions
|
References