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
|
.. module:: ezdxf.addons.text2path
text2path
=========
.. versionadded:: 0.16
Tools to convert text strings and text based DXF entities into outer- and inner
linear paths as :class:`~ezdxf.path.Path` objects. These tools depend on
the optional `Matplotlib`_ package. At the moment only the TEXT and the ATTRIB
entity can be converted into paths and hatches.
Don't expect a 100% match compared to CAD applications.
Text Alignments
---------------
The text alignments are enums of type :class:`ezdxf.enums.TextEntityAlignment`
============ =============== ================= =====
Vertical Left Center Right
============ =============== ================= =====
Top TOP_LEFT TOP_CENTER TOP_RIGHT
Middle MIDDLE_LEFT MIDDLE_CENTER MIDDLE_RIGHT
Bottom BOTTOM_LEFT BOTTOM_CENTER BOTTOM_RIGHT
Baseline LEFT CENTER RIGHT
============ =============== ================= =====
The vertical middle alignments (MIDDLE_XXX), center the text
vertically in the middle of the uppercase letter "X" (cap height).
Special alignments, where the horizontal alignment is always in the center of
the text:
- ALIGNED: text is scaled to match the given `length`, scales x- and
y-direction by the same factor.
- FIT: text is scaled to match the given `length`, but scales only in
x-direction.
- MIDDLE: insertion point is the center of the total height (cap height +
descender height) without scaling, the `length` argument is ignored.
Font Face Definition
--------------------
A font face is defined by the Matplotlib compatible
:class:`~ezdxf.tools.fonts.FontFace` object by ``font-family``, ``font-style``,
``font-stretch`` and ``font-weight``.
.. seealso::
- :ref:`font_anatomy`
- :ref:`font_properties`
String Functions
----------------
.. autofunction:: make_path_from_str
.. autofunction:: make_paths_from_str
.. autofunction:: make_hatches_from_str
Entity Functions
----------------
.. autoclass:: Kind
.. autofunction:: virtual_entities
.. autofunction:: explode
.. autofunction:: make_path_from_entity
.. autofunction:: make_paths_from_entity
.. _Matplotlib: https://matplotlib.org
|