blender
/
blender
130
398
Fork 572
Code Issues 6.2k Pull Requests 747 Projects 19 Wiki Activity

API Docs: add example use cases for mesh functions, fix wrong description

This commit is contained in:
Brecht Van Lommel 2019-05-17 10:30:41 +02:00
parent 5186cfbea4
commit 32b5f24c2a
2 changed files with 6 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/python_api/examples/bpy.types.Depsgraph.4.py
View File

@ -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.

6
doc/python_api/examples/bpy.types.Depsgraph.5.py
View File

@ -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