1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85
|
Mesh
====
.. module:: ezdxf.entities
:noindex:
The MESH entity (`DXF Reference`_) is a 3D mesh similar to the :class:`Polyface` entity.
All vertices in :ref:`WCS` as (x, y, z) tuples
.. versionchanged:: 0.8.9
:class:`Mesh` stores vertices, edges, faces and creases as packed data.
======================== ==========================================
Subclass of :class:`ezdxf.entities.DXFGraphic`
DXF type ``'MESH'``
Factory function :meth:`ezdxf.layouts.BaseLayout.add_mesh`
Inherited DXF attributes :ref:`Common graphical DXF attributes`
Required DXF version DXF R2000 (``'AC1015'``)
======================== ==========================================
.. seealso::
:ref:`tut_mesh` and helper classes: :class:`~ezdxf.render.MeshBuilder`, :class:`~ezdxf.render.MeshVertexMerger`
.. _DXF Reference: http://help.autodesk.com/view/OARX/2018/ENU/?guid=GUID-4B9ADA67-87C8-4673-A579-6E4C76FF7025
.. class:: Mesh
.. attribute:: dxf.version
.. attribute:: dxf.blend_crease
``0`` = off, ``1`` = on
.. attribute:: dxf.subdivision_levels
``0`` for no smoothing else integer greater than ``0``.
.. autoattribute:: vertices
.. autoattribute:: edges
.. autoattribute:: faces
.. autoattribute:: creases
.. automethod:: edit_data
.. automethod:: transform
MeshData
--------
.. class:: MeshData
.. attribute:: vertices
A standard Python list with (x, y, z) tuples (read/write)
.. attribute:: faces
A standard Python list with (v1, v2, v3,...) tuples (read/write)
Each face consist of a list of vertex indices (= index in :attr:`vertices`).
.. attribute:: edges
A standard Python list with (v1, v2) tuples (read/write). These list
represents the edges to which the :attr:`edge_crease_values` values
will be applied. Each edge consist of exact two vertex indices
(= index in :attr:`vertices`).
.. attribute:: edge_crease_values
A standard Python list of float values, one value for each edge. (read/write)
.. automethod:: add_face
.. automethod:: add_edge_crease
.. automethod:: optimize
|