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
|
# Copyright (c) 2016-2023 Manfred Moitzi
# License: MIT License
import pathlib
import shutil
import ezdxf
from ezdxf.math import basic_transformation
CWD = pathlib.Path("~/Desktop/Outbox").expanduser()
if not CWD.exists():
CWD = pathlib.Path(".")
# ------------------------------------------------------------------------------
# This example shows how to use UNDERLAY objects.
#
# This does not work reliable across CAD applications - don't use UNDERLAY objects!
# docs: https://ezdxf.mozman.at/docs/dxfentities/underlay.html
# tutorial: https://ezdxf.mozman.at/docs/tutorials/underlay.html
# ------------------------------------------------------------------------------
doc = ezdxf.new("R2000") # underlay requires the DXF R2000 format or newer
pdf_underlay_def = doc.add_underlay_def(
filename="underlay.pdf", name="1"
) # name = page to display
dwf_underlay_def = doc.add_underlay_def(
filename="underlay.dwf", name="Underlay_R2013-Model"
) # don't know how to get this name
dgn_underlay_def = doc.add_underlay_def(
filename="underlay.dgn", name="default"
) # name = 'default' just works
# The (PDF)DEFINITION entity is like a block definition, it just defines the underlay
msp = doc.modelspace()
# add first underlay
pdf_underlay = msp.add_underlay(pdf_underlay_def, insert=(0, 0, 0), scale=1.0)
# The (PDF)UNDERLAY entity is like the INSERT entity, it creates an underlay reference,
# and there can be multiple references to the same underlay in a drawing.
msp.add_underlay(pdf_underlay_def, insert=(10, 0, 0), scale=0.5, rotation=30)
# UNDERLAY entities support the copy() and transform() methods:
clone = pdf_underlay.copy()
clone.transform(
basic_transformation(move=(20, 0), scale=(0.25, 0.25, 0.25), z_rotation=-30)
)
msp.add_entity(clone)
# use dgn format
msp.add_underlay(dgn_underlay_def, insert=(0, 30, 0), scale=1.0)
# use dwf format
msp.add_underlay(dwf_underlay_def, insert=(0, 15, 0), scale=1.0)
# get existing underlay definitions, Important: UNDERLAYDEFs resides in the objects section
pdf_defs = doc.objects.query("PDFDEFINITION") # get all pdf underlay defs in drawing
doc.saveas(CWD / "underlay.dxf")
# copy underlay files to the same folder as the DXF file:
for name in ["underlay.pdf", "underlay.dwf", "underlay.dgn"]:
shutil.copy(name, CWD / name)
|
