bartvdbraak/blender
1
0
Fork 4
Code Issues 4 Pull Requests 1 Actions 1 Packages Projects Releases Wiki Activity

rename references to faces in docs.

Browse Source
This commit is contained in:
Campbell Barton 2013-05-28 13:58:56 +00:00
parent c7a46d5369
commit f3ad5bd3ff
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/python_api/rst/info_gotcha.rst
View File

@ -585,19 +585,19 @@ So it's best to consider modifying library data an advanced usage of the API and
Edit Mode / Memory Access Edit Mode / Memory Access
------------------------- -------------------------
Switching edit-mode ``bpy.ops.object.mode_set(mode='EDIT')`` / ``bpy.ops.object.mode_set(mode='OBJECT')`` will re-allocate objects data, any references to a meshes vertices/faces/uvs, armatures bones, curves points etc cannot be accessed after switching edit-mode. Switching edit-mode ``bpy.ops.object.mode_set(mode='EDIT')`` / ``bpy.ops.object.mode_set(mode='OBJECT')`` will re-allocate objects data, any references to a meshes vertices/polygons/uvs, armatures bones, curves points etc cannot be accessed after switching edit-mode.
Only the reference to the data its self can be re-accessed, the following example will crash. Only the reference to the data its self can be re-accessed, the following example will crash.
.. code-block:: python .. code-block:: python
mesh = bpy.context.active_object.data mesh = bpy.context.active_object.data
faces = mesh.faces polygons = mesh.polygons
bpy.ops.object.mode_set(mode='EDIT') bpy.ops.object.mode_set(mode='EDIT')
bpy.ops.object.mode_set(mode='OBJECT') bpy.ops.object.mode_set(mode='OBJECT')
# this will crash # this will crash
print(faces) print(polygons)
So after switching edit-mode you need to re-access any object data variables, the following example shows how to avoid the crash above. So after switching edit-mode you need to re-access any object data variables, the following example shows how to avoid the crash above.
@ -605,13 +605,13 @@ So after switching edit-mode you need to re-access any object data variables, th
.. code-block:: python .. code-block:: python
mesh = bpy.context.active_object.data mesh = bpy.context.active_object.data
faces = mesh.faces polygons = mesh.polygons
bpy.ops.object.mode_set(mode='EDIT') bpy.ops.object.mode_set(mode='EDIT')
bpy.ops.object.mode_set(mode='OBJECT') bpy.ops.object.mode_set(mode='OBJECT')
# faces have been re-allocated # polygons have been re-allocated
faces = mesh.faces polygons = mesh.polygons
print(faces) print(polygons)
These kinds of problems can happen for any functions which re-allocate the object data but are most common when switching edit-mode. These kinds of problems can happen for any functions which re-allocate the object data but are most common when switching edit-mode.
@ -620,7 +620,7 @@ These kinds of problems can happen for any functions which re-allocate the objec
Array Re-Allocation Array Re-Allocation
------------------- -------------------
When adding new points to a curve or vertices's/edges/faces to a mesh, internally the array which stores this data is re-allocated. When adding new points to a curve or vertices's/edges/polygons to a mesh, internally the array which stores this data is re-allocated.
.. code-block:: python .. code-block:: python