Cleanup: API docs
[blender.git] / doc / python_api / examples / bpy.types.ID.user_clear.1.py
1 """
2 This function is for advanced use only, misuse can crash blender since the user
3 count is used to prevent data being removed when it is used.
4 """
5
6 # This example shows what _not_ to do, and will crash blender.
7 import bpy
8
9 # object which is in the scene.
10 obj = bpy.data.objects["Cube"]
11
12 # without this, removal would raise an error.
13 obj.user_clear()
14
15 # runs without an exception
16 # but will crash on redraw.
17 bpy.data.objects.remove(obj)