From a9813f23802c54bb102df2c5f11ab1621fb707c1 Mon Sep 17 00:00:00 2001 From: Bastien Montagne Date: Sun, 14 Feb 2016 18:26:34 +0100 Subject: Tweak doc section about overriding context - point out context.copy() usage! --- doc/python_api/examples/bpy.ops.1.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'doc/python_api') diff --git a/doc/python_api/examples/bpy.ops.1.py b/doc/python_api/examples/bpy.ops.1.py index b4137e5c740..d89a1360c1c 100644 --- a/doc/python_api/examples/bpy.ops.1.py +++ b/doc/python_api/examples/bpy.ops.1.py @@ -10,9 +10,14 @@ The context overrides are passed as a dictionary, with keys matching the context member names in bpy.context. For example to override ``bpy.context.active_object``, you would pass ``{'active_object': object}``. + +.. note:: + You will nearly always want to use a copy of the actual current context as basis + (otherwise, you'll have to find and gather all needed data yourself). """ # remove all objects in scene rather than the selected ones import bpy -override = {'selected_bases': list(bpy.context.scene.object_bases)} +override = bpy.context.copy() +override['selected_bases'] = list(bpy.context.scene.object_bases) bpy.ops.object.delete(override) -- cgit v1.2.3