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
|
Disassemble
===========
.. module:: ezdxf.disassemble
This module provide tools for the recursive decomposition of nested block
reference structures into a flat stream of DXF entities and converting DXF
entities into geometric primitives of :class:`~ezdxf.path.Path` and
:class:`~ezdxf.render.mesh.MeshBuilder` objects encapsulated into
intermediate :class:`Primitive` classes.
.. warning::
Do not expect advanced vectorization capabilities: Text entities like TEXT,
ATTRIB, ATTDEF and MTEXT get only a rough border box representation.
The :mod:`~ezdxf.addons.text2path` add-on can convert text into paths.
VIEWPORT, IMAGE and WIPEOUT are represented by their clipping path.
Unsupported entities: all ACIS based entities, XREF, UNDERLAY, ACAD_TABLE,
RAY, XLINE. Unsupported entities will be ignored.
.. _Text Boundary Calculation:
Text Boundary Calculation
-------------------------
Text boundary calculations are based on monospaced (fixed-pitch, fixed-width,
non-proportional) font metrics, which do not provide a good accuracy for text
height calculation and much less accuracy for text width calculation. It is
possible to improve this results by using the font support from the
**optional** `Matplotlib` package.
Install Matplotlib from command line::
C:\> pip3 install matplotlib
The `Matplotlib` font support will improve the results for TEXT, ATTRIB and
ATTDEF. The MTEXT entity has many advanced features which would require a full
"Rich Text Format" rendering and that is far beyond the goals and capabilities
of this library, therefore the boundary box for MTEXT will **never** be as
accurate as in a dedicated CAD application.
Using the `Matplotlib` font support adds **runtime overhead**, therefore it is
possible to deactivate the `Matplotlib` font support by setting the
global option::
options.use_matplotlib_font_support = False
Flatten Complex DXF Entities
----------------------------
.. autofunction:: recursive_decompose
Entity Deconstruction
---------------------
These functions disassemble DXF entities into simple geometric objects
like meshes, paths or vertices. The :class:`Primitive` is a simplified
intermediate class to use a common interface on various DXF entities.
.. autofunction:: make_primitive
.. autofunction:: to_primitives
.. autofunction:: to_meshes
.. autofunction:: to_paths
.. autofunction:: to_vertices
.. autofunction:: to_control_vertices
.. class:: Primitive
Interface class for path/mesh primitives.
.. attribute:: entity
Reference to the source DXF entity of this primitive.
.. attribute:: max_flattening_distance
The `max_flattening_distance` attribute defines the max distance in drawing
units between the approximation line and the original curve.
Set the value by direct attribute access. (float) default = 0.01
.. autoproperty:: path
.. autoproperty:: mesh
.. autoproperty:: is_empty
.. automethod:: vertices
.. automethod:: bbox
|
