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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
.. _external_references:
.. module:: ezdxf.xref
External References (XREF)
==========================
.. versionadded:: 1.1
Attached XREFs are links to the modelspace of a specified drawing file. Changes made
to the referenced drawing are automatically reflected in the current drawing when it's
opened or if the XREF is reloaded.
XREFs can be nested within other XREFs: that is, you can attach an XREF that contains
another XREF. You can attach as many copies of an XREF as you want, and each copy can
have a different position, scale, and rotation.
You can also overlay an XREF on your drawing. Unlike an attached XREF, an overlaid XREF
is not included when the drawing is itself attached or overlaid as an XREF to another
drawing.
DXF Files as Attached XREFs
---------------------------
.. important::
AutoCAD can only display DWG files as attached XREFs but `ezdxf` can only create
DXF files. Consequently, any DXF file attached as an XREF to a DXF document must
be converted to DWG in order to be viewed in AutoCAD.
Fortunately, other CAD applications are more cooperative, BricsCAD has no problem
displaying DXF files as XREFs, although it is not possible to attach a DXF file as an
XREF in the BricsCAD application itself.
The :mod:`ezdxf.xref` module provides an interface for working with XREFs.
- :func:`attach` - attach a DXF/DWG file as XREF
- :func:`detach` - detach a BLOCK definition as XREF
- :func:`embed` - embed an XREF as a BLOCK definition
- :func:`dxf_info` - scans a DXF file for basic settings and properties
For loading the content of DWG files is a loading function required, which loads the
DWG file as :class:`Drawing` document. The :mod:`~ezdxf.addons.odafc` add-on module
provides such a function: :func:`~ezdxf.addons.odafc.readfile`
.. seealso::
- :ref:`tut_xref_module`
XREF Structures
---------------
An XREF is a normal block definition located in the BLOCKS section with special flags
set and a filename to the referenced DXF/DWG file and without any content, the block
content is the modelspace of the referenced file. An XREF can be referenced (inserted)
by one or multiple INSERT entities.
Find block definitions in the BLOCKS section:
.. code-block:: Python
for block_layout in doc.blocks:
block = block_layout.block # the BLOCK entity
if block.is_xref:
handle_xref(block_layout)
elif block.is_xref_overlay:
handle_xref_overlay(block_layout)
Find XREF references in modelspace:
.. code-block:: Python
for insert in msp.query("INSERT"):
if insert.is_xref:
handle_xref_reference(insert)
# ... or get the XREF definition
block_layout = insert.block()
if block_layout is not None:
handle_xref_definition(block_layout)
Use the helper function :func:`define` to create your own XREF definition, the
:func:`attach` creates this definition automatically and raises an exception if the
block already exists.
Supported Entities
------------------
The current implementation supports only copyable and transformable DXF entities,
these are all basic entity types as LINE, CIRCLE, ... and block references and their
associated required table entries and objects from the OBJECTS section.
Unsupported is the ACAD_TABLE entity and preserved unknown entities wrapped in a
:class:`DXFTagStorage` class like proxy entities and objects.
Support for these entities may be added in a later version of `ezdxf`.
Unsupported entities are ignored and do not raise exceptions.
Most document features stored in the HEADER and OBJECTS sections are not supported by
this module like GROUPS, LAYER_FILTER, GEODATA, SUN.
.. versionadded:: 1.3.0
Support for ACIS based entities was added.
.. _xref_importing_data:
Importing Data and Resources
----------------------------
The :mod:`ezdxf.xref` module replaces the :class:`~ezdxf.addons.importer.Importer` add-on.
The basic functionality of the :mod:`ezdxf.xref` module is loading data from external
files including their required resources, which is an often requested feature by users
for importing data from other DXF files into the current document.
The :class:`Importer` add-on was very limited and removed many resources,
where the :mod:`ezdxf.xref` module tries to preserve as much information as possible.
- :func:`load_modelspace` - loads the modelspace content from another DXF document
- :func:`load_paperspace` - loads a paperspace layout from another DXF document
- :func:`write_block` - writes entities into the modelspace of a new DXF document
- :class:`Loader` - low level loading interface
High Level Functions
--------------------
.. autofunction:: attach
.. autofunction:: define
.. autofunction:: detach
.. autofunction:: dxf_info
.. autofunction:: embed
.. autofunction:: load_modelspace
.. autofunction:: load_paperspace
.. autofunction:: write_block
Conflict Policy
---------------
.. autoclass:: ConflictPolicy
Low Level Loading Interface
---------------------------
The :class:`Loader` class is the basic building block for loading entities and
resources. The class manages a list of loading commands which is executed at once by
calling the :meth:`Loader.execute` method. It is important to execute the commands at
once to get a consistent renaming of resources when using resource name prefixes
otherwise the loaded resources would get a new unique name at each loading process even
when the resources are loaded from the same document.
.. autoclass:: Loader
.. automethod:: load_modelspace
.. automethod:: load_paperspace_layout
.. automethod:: load_paperspace_layout_into
.. automethod:: load_block_layout
.. automethod:: load_block_layout_into
.. automethod:: load_layers
.. automethod:: load_linetypes
.. automethod:: load_text_styles
.. automethod:: load_dim_styles
.. automethod:: load_mline_styles
.. automethod:: load_mleader_styles
.. automethod:: load_materials
.. automethod:: execute
|
