diff options
author | Campbell Barton <ideasman42@gmail.com> | 2012-04-23 04:20:32 +0400 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2012-04-23 04:20:32 +0400 |
commit | a1b9608ddd555cc3c89c72a5cacd4042e91781f0 (patch) | |
tree | 40a71c8a1f20da38a02c8aaeb551d2bcc943dffc /doc | |
parent | 1642e2888c296d71b2facd1a607f24a5992bb164 (diff) |
add mesh example with docs explaining polygon / loop relationship
Diffstat (limited to 'doc')
-rw-r--r-- | doc/python_api/examples/bpy.types.Mesh.py | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/doc/python_api/examples/bpy.types.Mesh.py b/doc/python_api/examples/bpy.types.Mesh.py new file mode 100644 index 00000000000..69edf2cba50 --- /dev/null +++ b/doc/python_api/examples/bpy.types.Mesh.py @@ -0,0 +1,41 @@ +""" +Mesh Data ++++++++++ + +The mesh data is accessed in object mode and intended for compact storage, +for more flexible mesh editing from python see :mod:`bmesh`. + +Blender stores 4 main arrays to define mesh geometry. + +* :class:`Mesh.vertices` (3 points in space) +* :class:`Mesh.edges` (reference 2 vertices) +* :class:`Mesh.loops` (reference a single vertex and edge) +* :class:`Mesh.polygons`: (reference a range of loops) + + +Each polygon reference a slice in the loop array, this way, polygons do not store vertices or corner data such as UV's directly, +only a reference to loops that the polygon uses. + +:class:`Mesh.loops`, :class:`Mesh.uv_layers` :class:`Mesh.vertex_colors` are all aligned so the same polygon loop +indicies can be used to find the UV's and vertex colors as with as the vertices. + +To compare mesh API options see: :ref:`NGons and Tessellation Faces <info_gotcha_mesh_faces>` + + +This example script prints the vertices and UV's for each polygon, assumes the active object is a mesh with UVs. +""" + +import bpy + +me = bpy.context.object.data +uv_layer = me.uv.layers.active.data + +for poly in me.polygons: + print("Polygon index: %d, length: %d" % (poly.index, poly.loop_total)) + + # range is used here to show how the polygons reference loops, + # for convenience 'poly.loop_indices' can be used instead. + for loop_index in range(poly.loop_start, poly.loop_start + poly.loop_total): + print(" Vertex: %d" % me.loops[loop_index].vertex_index) + print(" UV: %r" % uv_layer[loop_index].uv) + |