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 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125
|
Leader
======
.. module:: ezdxf.entities
:noindex:
The LEADER entity (`DXF Reference`_) represents a pointer line, made up of one or more
vertices (or spline fit points) and an arrowhead. The label or other content to which
the :class:`Leader` is attached is stored as a separate entity, and is not part of
the :class:`Leader` itself.
The LEADER entity uses parts of the styling infrastructure of the DIMENSION entity.
By default a :class:`Leader` without any annotation is created. For creating more fancy
leaders and annotations see the documentation provided by Autodesk or
`Demystifying DXF: LEADER and MULTILEADER implementation notes <https://atlight.github.io/formats/dxf-leader.html>`_ .
======================== ==========================================
Subclass of :class:`ezdxf.entities.DXFGraphic`
DXF type ``'LEADER'``
Factory function :meth:`ezdxf.layouts.BaseLayout.add_leader`
Inherited DXF attributes :ref:`Common graphical DXF attributes`
Required DXF version DXF R2000 (``'AC1015'``)
======================== ==========================================
.. _DXF Reference: http://help.autodesk.com/view/OARX/2018/ENU/?guid=GUID-396B2369-F89F-47D7-8223-8B7FB794F9F3
.. class:: Leader
.. attribute:: dxf.dimstyle
Name of :class:`Dimstyle` as string.
.. attribute:: dxf.has_arrowhead
== ============
0 Disabled
1 Enabled
== ============
.. attribute:: dxf.path_type
Leader path type:
== ==========================
0 Straight line segments
1 Spline
== ==========================
.. attribute:: dxf.annotation_type
== ===========================================
0 Created with text annotation
1 Created with tolerance annotation
2 Created with block reference annotation
3 Created without any annotation (default)
== ===========================================
.. attribute:: dxf.hookline_direction
Hook line direction flag:
== =================================================================
0 Hookline (or end of tangent for a splined leader) is the opposite
direction from the horizontal vector
1 Hookline (or end of tangent for a splined leader) is the same
direction as horizontal vector (see ``has_hook_line``)
== =================================================================
.. attribute:: dxf.has_hookline
== ==================
0 No hookline
1 Has a hookline
== ==================
.. attribute:: dxf.text_height
Text annotation height in drawing units.
.. attribute:: dxf.text_width
Text annotation width.
.. attribute:: dxf.block_color
Color to use if leader's DIMCLRD = BYBLOCK
.. attribute:: dxf.annotation_handle
Hard reference (handle) to associated annotation (:class:`MText`, :class:`Tolerance`,
or :class:`Insert` entity)
.. attribute:: dxf.normal_vector
Extrusion vector? default is (0, 0, 1).
.. attribute:: .dxf.horizontal_direction
`Horizontal` direction for leader, default is (1, 0, 0).
.. attribute:: dxf.leader_offset_block_ref
Offset of last leader vertex from block reference insertion point, default is
(0, 0, 0).
.. attribute:: dxf.leader_offset_annotation_placement
Offset of last leader vertex from annotation placement point, default
(0, 0, 0).
.. attribute:: vertices
List of :class:`~ezdxf.math.Vec3` objects, representing the vertices of the
leader (3D Point in :ref:`WCS`).
.. automethod:: set_vertices
.. automethod:: transform
.. automethod:: virtual_entities
.. automethod:: explode
|