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
|
Solid
=====
.. module:: ezdxf.entities
:noindex:
The SOLID entity (`DXF Reference`_) is a filled triangle or quadrilateral.
Access vertices by name (:code:`entity.dxf.vtx0 = (1.7, 2.3)`) or by index
(:code:`entity[0] = (1.7, 2.3)`). If only 3 vertices are provided the
last (3rd) vertex will be repeated in the DXF file.
The SOLID entity stores the vertices in an unusual way, the last two vertices
are reversed:
.. code-block:: Python
msp.add_solid([(0, 0), (10, 0), (10, 10), (0, 10)])
.. image:: gfx/solid0.png
:align: center
Reverse the last two vertices to get the `expected` square:
.. code-block:: Python
msp.add_solid([(0, 0), (10, 0), (0, 10), (10, 10)])
.. image:: gfx/solid1.png
:align: center
.. note::
The quirky vertex order is preserved at the lowest access level because
`ezdxf` is intended as a DXF file format interface and presents the content
of the DXF document to the package user as natively as possible.
The :meth:`Solid.vertices` and :meth:`Solid.wcs_vertices` methods return the
vertices in the `expected` (reversed) order.
======================== ==========================================
Subclass of :class:`ezdxf.entities.DXFGraphic`
DXF type ``'SOLID'``
Factory function :meth:`ezdxf.layouts.BaseLayout.add_solid`
Inherited DXF attributes :ref:`Common graphical DXF attributes`
======================== ==========================================
.. warning::
Do not instantiate entity classes by yourself - always use the provided
factory functions!
.. class:: Solid
.. attribute:: dxf.vtx0
Location of 1. vertex (2D/3D Point in :ref:`OCS`)
.. attribute:: dxf.vtx1
Location of 2. vertex (2D/3D Point in :ref:`OCS`)
.. attribute:: dxf.vtx2
Location of 3. vertex (2D/3D Point in :ref:`OCS`)
.. attribute:: dxf.vtx3
Location of 4. vertex (2D/3D Point in :ref:`OCS`)
.. automethod:: transform
.. automethod:: vertices
.. automethod:: wcs_vertices
.. _DXF Reference: http://help.autodesk.com/view/OARX/2018/ENU/?guid=GUID-E0C5F04E-D0C5-48F5-AC09-32733E8848F2
|
