diff options
author | Brecht Van Lommel <brechtvanlommel@gmail.com> | 2019-05-17 11:30:41 +0300 |
---|---|---|
committer | Brecht Van Lommel <brechtvanlommel@gmail.com> | 2019-05-17 11:34:20 +0300 |
commit | 32b5f24c2a9cdf3a7c1f2f695bbc8704eb159a12 (patch) | |
tree | cf811f1e2a4beba26ca60fcf69312d93b2d91712 /doc | |
parent | 5186cfbea4c1c1111d6e6061ab877ee8d9b4f206 (diff) |
API Docs: add example use cases for mesh functions, fix wrong description
Diffstat (limited to 'doc')
-rw-r--r-- | doc/python_api/examples/bpy.types.Depsgraph.4.py | 3 | ||||
-rw-r--r-- | doc/python_api/examples/bpy.types.Depsgraph.5.py | 6 |
2 files changed, 6 insertions, 3 deletions
diff --git a/doc/python_api/examples/bpy.types.Depsgraph.4.py b/doc/python_api/examples/bpy.types.Depsgraph.4.py index a7b6068cfae..c2017afa2f9 100644 --- a/doc/python_api/examples/bpy.types.Depsgraph.4.py +++ b/doc/python_api/examples/bpy.types.Depsgraph.4.py @@ -2,6 +2,9 @@ Dependency graph: Object.to_mesh() +++++++++++++++++++++++++++++++++++ +Function to get a mesh from any object with geometry. It is typically used by exporters, render +engines and tools that need to access the evaluated mesh as displayed in the viewport. + Object.to_mesh() is closely interacting with dependency graph: its behavior depends on whether it is used on original or evaluated object. diff --git a/doc/python_api/examples/bpy.types.Depsgraph.5.py b/doc/python_api/examples/bpy.types.Depsgraph.5.py index 353161a547a..335e87071e5 100644 --- a/doc/python_api/examples/bpy.types.Depsgraph.5.py +++ b/doc/python_api/examples/bpy.types.Depsgraph.5.py @@ -2,8 +2,9 @@ Dependency graph: bpy.data.meshes.new_from_object() +++++++++++++++++++++++++++++++++++++++++++++++++++ -Object.to_mesh() is closely interacting with dependency graph: its behavior depends on whether it -is used on original or evaluated object. +Function to copy a new mesh from any object with geometry. The mesh is added to the main +database and can be referenced by objects. Typically used by tools that create new objects +or apply modifiers. When is used on original object, the result mesh is calculated from the object without taking animation or modifiers into account: @@ -17,7 +18,6 @@ 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. This mesh can be referenced by any object, .. note:: If object does not have geometry (i.e. camera) the functions returns None. """ import bpy |