To completely remove the object from the scene through the Blender Python API do the following:
Open the “Text Editor” window.
Import the main Blender Python API module.
|
1 |
import bpy |
Removing objects with the operator
To delete objects with the API operators, first, switch to the “Object” mode if the scene is in the “Edit” mode.
|
1 2 |
if bpy.context.object.mode == 'EDIT': bpy.ops.object.mode_set(mode='OBJECT') |
The operator removes all the selected objects. To delete only required objects we need to deselect all the scene objects,
|
1 |
bpy.ops.object.select_all(action='DESELECT') |
and next, select the required object. If we select several objects – all of them will be deleted from the scene.
|
1 |
bpy.data.objects['Suzanne'].select_set(True) |
Now let’s use the delete operator.
|
1 |
bpy.ops.object.delete() |
After its execution, all the selected objects will be deleted.
Final code:
|
1 2 3 4 5 6 7 8 9 10 |
import bpy if bpy.context.object.mode == 'EDIT': bpy.ops.object.mode_set(mode='OBJECT') # deselect all objects bpy.ops.object.select_all(action='DESELECT') # select the object bpy.data.objects['Suzanne'].select_set(True) # delete all selected objects bpy.ops.object.delete() |
Removing objects without an operator
We can also delete objects from the scene without using an operator. At first, we need to get the object to remove:
|
1 |
object_to_delete = bpy.data.objects['Suzanne'] |
and delete it from the global objects list.
|
1 |
bpy.data.objects.remove(object_to_delete, do_unlink=True) |
Pay attention to the second “do_unlink” parameter, which we mast set to “True” to proper unlink the object from the scene.
Final code:
|
1 2 3 4 |
import bpy object_to_delete = bpy.data.objects['Suzanne'] bpy.data.objects.remove(object_to_delete, do_unlink=True) |
After the code execution, by pressing the “Run Script” button, in case of the deleting way all the selected objects will be removed from the scene or only the required object.