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
|
# Copyright (c) 2020 Ultimaker B.V.
# Uranium is released under the terms of the LGPLv3 or higher.
from typing import Union, TYPE_CHECKING, Optional
from UM.Scene.SceneNode import SceneNode
from UM.Math.Vector import Vector
from . import Operation
if TYPE_CHECKING:
from UM.Math.Quaternion import Quaternion # To store the amount of rotation in each dimension.
class RotateOperation(Operation.Operation):
"""Operation that rotates a scene node."""
def __init__(self, node: SceneNode, rotation: "Quaternion", rotate_around_point: Optional[Vector] = None) -> None:
"""Initialises the operation.
:param node: The node to rotate.
:param rotation: A transformation quaternion that rotates a space. This
rotation is applied on the node.
:param rotate_around_point: The point to rotate around.
"""
super().__init__()
self._node = node #The node to rotate.
self._old_transformation = node.getLocalTransformation() #The transformation matrix before rotating, which must be restored if we undo.
self._rotation = rotation #A rotation matrix to rotate the node with.
self._rotate_around_point = rotate_around_point #Around what point should the rotation be done?
def undo(self) -> None:
"""Undoes the rotation, rotating the node back."""
self._node.setTransformation(self._old_transformation)
def redo(self) -> None:
"""Redoes the rotation, rotating the node again."""
if self._rotate_around_point:
self._node.setPosition(-self._rotate_around_point)
self._node.rotate(self._rotation, SceneNode.TransformSpace.World)
if self._rotate_around_point:
self._node.setPosition(self._rotate_around_point)
def mergeWith(self, other: "RotateOperation") -> Union[bool, "RotateOperation"]:
"""Merges this operation with another RotateOperation.
This prevents the user from having to undo multiple operations if they
were not his operations.
You should ONLY merge this operation with an older operation. It is NOT
symmetric.
:param other: The older RotateOperation to merge this with.
:return: A combination of the two rotate operations.
"""
if type(other) is not RotateOperation:
return False
if other._node != self._node: #Must be operations on the same node.
return False
op = RotateOperation(self._node, other._rotation * self._rotation)
op._old_transformation = other._old_transformation #Use the _old_transformation of the oldest rotation in the new operation.
return op
def __repr__(self) -> str:
"""Returns a programmer-readable representation of this operation.
:return: A programmer-readable representation of this operation.
"""
return "RotateOp.(node={0},rot.={1})".format(self._node, self._rotation)
|
