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
|
.. module:: ezdxf.math
:noindex:
.. _tut_ucs_transform:
Tutorial for UCS Based Transformations
======================================
The `ezdxf` version v0.13 introduced a transformation interface for DXF
primitives, which makes working with OCS/UCS much easier. This is a new
edition of the :ref:`tut_ocs`. Please read the old tutorial for the basics
about the OCS.
For this tutorial we don't have to worry about the OCS and the extrusion vector,
this is done automatically by the :meth:`transform` method of each DXF entity.
Placing 2D Circle in 3D Space
-----------------------------
To recreate the situation of the old tutorial instantiate a new UCS and rotate
it around the local x-axis. Use UCS coordinates to place the 2D CIRCLE in
3D space and transform the UCS coordinates to the WCS.
.. literalinclude:: src/ucs/circle.py
:lines: 6-26
.. image:: gfx/ucs-circle-side-view.png
:alt: circle in ucs as side view
.. image:: gfx/ucs-circle-front-view.png
:alt: circle in ucs as front view
Placing LWPolyline in 3D Space
------------------------------
Simplified LWPOLYLINE example:
.. literalinclude:: src/ucs/lwpolyline.py
:lines: 14-26
The 2D pentagon in 3D space in BricsCAD `Left` and `Front` view.
.. image:: gfx/ucs-lwpolyline-side-view.png
:alt: pentagon in ucs as side view
.. image:: gfx/ucs-lwpolyline-front-view.png
:alt: pentagon in ucs as front view
Using UCS to Place 3D Polyline
------------------------------
Simplified POLYLINE example: Using a first UCS to transform the POLYLINE and a
second UCS to place the POLYLINE in 3D space.
.. literalinclude:: src/ucs/polyline3d.py
:lines: 13-37
.. image:: gfx/ucs-polyline3d-bricscad.png
:alt: 3d poyline with UCS
Placing 2D Text in 3D Space
---------------------------
The problem with the text rotation in the old tutorial disappears with the new
UCS based transformation method:
AutoCAD supports thickness for the TEXT entity only for `.shx` fonts and not for
true type fonts.
.. literalinclude:: src/ucs/text.py
:lines: 13-29
.. image:: gfx/ucs-text-top-bricscad.png
:alt: text in ucs as top view
.. image:: gfx/ucs-text-front-bricscad.png
:alt: text in ucs as front view
Placing 2D Arc in 3D Space
--------------------------
Same as for the text example, OCS angle transformation can be ignored:
.. literalinclude:: src/ucs/arc.py
:lines: 13-37
.. image:: gfx/ucs-arc-top.png
:alt: arc in ucs as top view
.. image:: gfx/ucs-arc-front.png
:alt: arc in ucs as front view
Placing Block References in 3D Space
------------------------------------
Despite the fact that block references (INSERT) can contain true 3D entities like
LINE or MESH, the INSERT entity uses the same placing principe as TEXT or ARC
shown in the previous sections.
To rotate the block reference 15 degrees around the WCS x-axis, we place the
block reference in the origin of the UCS, and rotate the UCS 90 degrees around
its local y-axis, to align the UCS z-axis with the WCS x-axis:
This is just an excerpt of the important parts, see the whole code of
`insert.py`_ at github.
.. literalinclude:: src/ucs/insert.py
:lines: 47-58
.. image:: gfx/ucs-insert-01-iso.png
.. image:: gfx/ucs-insert-01-side.png
A more simple approach is to ignore the :attr:`rotate` attribute at all and just
rotate the UCS. To rotate a block reference around any axis rather than the
block z-axis, rotate the UCS into the desired position. The following example
rotates the block reference around the block x-axis by 15 degrees:
.. literalinclude:: src/ucs/insert.py
:lines: 66-68
.. image:: gfx/ucs-insert-02-iso.png
.. image:: gfx/ucs-insert-02-side.png
The next example shows how to translate a block references with an already
established OCS:
.. literalinclude:: src/ucs/insert.py
:lines: 72-76
.. image:: gfx/ucs-insert-03-iso.png
.. image:: gfx/ucs-insert-03-side.png
The next operation is to rotate a block reference with an established OCS,
rotation axis is the block y-axis, rotation angle is -90 degrees. The idea is
to create an UCS in the origin of the already placed block reference, UCS axis
aligned to the block axis and resetting the block reference parameters for a
new WCS transformation.
.. literalinclude:: src/ucs/insert.py
:lines: 82-86
Reset block reference parameters, this places the block reference in the UCS
origin and aligns the block axis to the UCS axis, now we do a new transformation
from UCS to WCS:
.. literalinclude:: src/ucs/insert.py
:lines: 88-93
.. image:: gfx/ucs-insert-04-iso.png
.. image:: gfx/ucs-insert-04-side.png
.. _insert.py: https://github.com/mozman/ezdxf/blob/master/docs/source/tutorials/src/ucs/insert.py
|
