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
|
.. _transform:
.. module:: ezdxf.transform
Transform
=========
.. versionadded:: 1.1
This module provides functions to apply transformations to multiple DXF
entities inplace or to virtual copies of that entities in a convenient and safe way:
.. code-block:: Python
import math
import ezdxf
from ezdxf import transform
doc = ezdxf.readfile("my.dxf")
msp = doc.modelspace()
log = transform.inplace(msp, m=transform.Matrix44.rotate_z(math.pi/2))
# or more simple
log = transform.z_rotate(msp, math.pi/2)
All functions handle errors by collecting them in an logging object without raising
an error.
The input `entities` are an iterable of :class:`~ezdxf.entities.DXFEntity`, which can be
any layout, :class:`~ezdxf.query.EntityQuery` or just a list/sequence of entities and
virtual entities are supported as well.
.. autosummary::
:nosignatures:
inplace
copies
translate
scale_uniform
scale
x_rotate
y_rotate
z_rotate
axis_rotate
.. autofunction:: inplace
.. autofunction:: copies
.. autofunction:: translate
.. autofunction:: scale_uniform
.. autofunction:: scale
.. autofunction:: x_rotate
.. autofunction:: y_rotate
.. autofunction:: z_rotate
.. autofunction:: axis_rotate
.. attribute:: MIN_SCALING_FACTOR
Minimal scaling factor: 1e-12
.. class:: Error
.. attribute:: NONE
No error, same as a boolean ``False``, this allows check :code:`if error: ...`
.. attribute:: COPY_NOT_SUPPORTED
Entity without copy support.
.. attribute:: TRANSFORMATION_NOT_SUPPORTED
Entity without transformation support.
.. attribute:: NON_UNIFORM_SCALING_ERROR
Circular arcs (CIRCLE, ARC, bulges in POLYLINE and LWPOLYLINE entities)
cannot be scaled non-uniformly.
.. attribute:: INSERT_TRANSFORMATION_ERROR
INSERT entities cannot represent a non-orthogonal target coordinate system.
Maybe exploding the INSERT entities (recursively) beforehand can solve this
issue, see function :func:`ezdxf.disassemble.recursive_decompose`.
.. attribute:: VIRTUAL_ENTITY_NOT_SUPPORTED
Transformation not supported for virtual entities e.g. non-uniform scaling for
CIRCLE, ARC or POLYLINE with bulges
.. autoclass:: Logger
A :class:`Sequence` of errors as :class:`Logger.Entry` instances.
.. class:: Entry
Named tuple representing a logger entry.
.. attribute:: error
:class:`Error` enum
.. attribute:: msg
error message as string
.. attribute:: entity
DXF entity which causes the error
.. automethod:: __len__
.. automethod:: __getitem__
.. automethod:: __iter__
.. automethod:: messages
|
