From 5186cfbea4c1c1111d6e6061ab877ee8d9b4f206 Mon Sep 17 00:00:00 2001 From: Sergey Sharybin Date: Fri, 17 May 2019 10:23:31 +0200 Subject: Depsgraph: State behavior details more explicitly --- doc/python_api/examples/bpy.types.Depsgraph.4.py | 4 ++++ doc/python_api/examples/bpy.types.Depsgraph.5.py | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) (limited to 'doc/python_api/examples') diff --git a/doc/python_api/examples/bpy.types.Depsgraph.4.py b/doc/python_api/examples/bpy.types.Depsgraph.4.py index 41f94a32c4c..a7b6068cfae 100644 --- a/doc/python_api/examples/bpy.types.Depsgraph.4.py +++ b/doc/python_api/examples/bpy.types.Depsgraph.4.py @@ -15,6 +15,10 @@ animation or modifiers into account: When is used on evaluated object all modifiers are taken into account. .. note:: The result mesh is owned by the object. It can be freed by calling `object.to_mesh_clear()`. +.. note:: + The result mesh must be treated as temporary, and can not be referenced from objects in the main + database. If the mesh intended to be used in a persistent manner use bpy.data.meshes.new_from_object() + instead. .. note:: If object does not have geometry (i.e. camera) the functions returns None. """ import bpy diff --git a/doc/python_api/examples/bpy.types.Depsgraph.5.py b/doc/python_api/examples/bpy.types.Depsgraph.5.py index a37d2674ecd..353161a547a 100644 --- a/doc/python_api/examples/bpy.types.Depsgraph.5.py +++ b/doc/python_api/examples/bpy.types.Depsgraph.5.py @@ -17,7 +17,7 @@ When is used on evaluated object all modifiers are taken into account. All the references (such as materials) are re-mapped to original. This ensures validity and consistency of the main database. -.. note:: The result mesh is added to the main database. +.. note:: The result mesh is added to the main database. This mesh can be referenced by any object, .. note:: If object does not have geometry (i.e. camera) the functions returns None. """ import bpy -- cgit v1.2.3