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
|
Trace
=====
.. module:: ezdxf.entities
:noindex:
TRACE entity (`DXF Reference`_) is solid 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 TRACE entity stores the vertices in an unusual way, the last two vertices
are reversed. The coordinates [(0, 0), (1, 0), (1, 1), (0, 1)] do not create
a square as you would expect:
.. image:: gfx/solid0.png
:align: center
Reverse the last two vertices to get the `expected` square:
[(0, 0), (1, 0), (0, 1), (1, 1)]
.. image:: gfx/solid1.png
:align: center
.. note::
The :meth:`Trace.vertices` and :meth:`Trace.wcs_vertices` methods return the
vertices in the `expected` (reversed) order.
======================== ==========================================
Subclass of :class:`ezdxf.entities.DXFGraphic`
DXF type ``'TRACE'``
Factory function :meth:`ezdxf.layouts.BaseLayout.add_trace`
Inherited DXF attributes :ref:`Common graphical DXF attributes`
======================== ==========================================
.. warning::
Do not instantiate entity classes by yourself - always use the provided factory functions!
.. class:: Trace
.. 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-EA6FBCA8-1AD6-4FB2-B149-770313E93511
|
