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
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_GFX_TRANSFORM_H_
#define UI_GFX_TRANSFORM_H_
#include "base/compiler_specific.h"
#include "third_party/skia/include/utils/SkMatrix44.h"
#include "ui/base/ui_export.h"
namespace gfx {
class RectF;
class Point;
class Point3F;
class Vector3dF;
// 4x4 transformation matrix. Transform is cheap and explicitly allows
// copy/assign.
class UI_EXPORT Transform {
public:
Transform();
~Transform();
bool operator==(const Transform& rhs) const;
bool operator!=(const Transform& rhs) const;
// Resets this transform to the identity transform.
void MakeIdentity();
// Applies the current transformation on a 2d rotation and assigns the result
// to |this|.
void Rotate(double degrees) { RotateAboutZAxis(degrees); }
// Applies the current transformation on an axis-angle rotation and assigns
// the result to |this|.
void RotateAboutXAxis(double degrees);
void RotateAboutYAxis(double degrees);
void RotateAboutZAxis(double degrees);
void RotateAbout(const Vector3dF& axis, double degrees);
// Applies the current transformation on a scaling and assigns the result
// to |this|.
void Scale(double x, double y);
void Scale3d(double x, double y, double z);
// Applies the current transformation on a translation and assigns the result
// to |this|.
void Translate(double x, double y);
void Translate3d(double x, double y, double z);
// Applies the current transformation on a skew and assigns the result
// to |this|.
void SkewX(double angle_x);
void SkewY(double angle_y);
// Applies the current transformation on a perspective transform and assigns
// the result to |this|.
void ApplyPerspectiveDepth(double depth);
// Applies a transformation on the current transformation
// (i.e. 'this = this * transform;').
void PreconcatTransform(const Transform& transform);
// Applies a transformation on the current transformation
// (i.e. 'this = transform * this;').
void ConcatTransform(const Transform& transform);
// Returns true if this is the identity matrix.
bool IsIdentity() const;
// Returns true if the matrix is either identity or pure translation.
bool IsIdentityOrTranslation() const;
// Returns true if the matrix is has only scaling and translation components.
bool IsScaleOrTranslation() const;
// Returns true if the matrix has any perspective component that would
// change the w-component of a homogeneous point.
bool HasPerspective() const;
// Returns true if this transform is non-singular.
bool IsInvertible() const;
// Returns true if a layer with a forward-facing normal of (0, 0, 1) would
// have its back side facing frontwards after applying the transform.
bool IsBackFaceVisible() const;
// Inverts the transform which is passed in. Returns true if successful.
bool GetInverse(Transform* transform) const WARN_UNUSED_RESULT;
// Transposes this transform in place.
void Transpose();
// Applies the transformation on the point. Returns true if the point is
// transformed successfully.
void TransformPoint(Point3F& point) const;
// Applies the transformation on the point. Returns true if the point is
// transformed successfully. Rounds the result to the nearest point.
void TransformPoint(Point& point) const;
// Applies the reverse transformation on the point. Returns true if the
// transformation can be inverted.
bool TransformPointReverse(Point3F& point) const;
// Applies the reverse transformation on the point. Returns true if the
// transformation can be inverted. Rounds the result to the nearest point.
bool TransformPointReverse(Point& point) const;
// Applies transformation on the rectangle. Returns true if the transformed
// rectangle was axis aligned. If it returns false, rect will be the
// smallest axis aligned bounding box containing the transformed rect.
void TransformRect(RectF* rect) const;
// Applies the reverse transformation on the rectangle. Returns true if
// the transformed rectangle was axis aligned. If it returns false,
// rect will be the smallest axis aligned bounding box containing the
// transformed rect.
bool TransformRectReverse(RectF* rect) const;
// Decomposes |this| and |from|, interpolates the decomposed values, and
// sets |this| to the reconstituted result. Returns false if either matrix
// can't be decomposed. Uses routines described in this spec:
// http://www.w3.org/TR/css3-3d-transforms/.
//
// Note: this call is expensive since we need to decompose the transform. If
// you're going to be calling this rapidly (e.g., in an animation) you should
// decompose once using gfx::DecomposeTransforms and reuse your
// DecomposedTransform.
bool Blend(const Transform& from, double progress);
// Returns |this| * |other|.
Transform operator*(const Transform& other) const;
// Sets |this| = |this| * |other|
Transform& operator*=(const Transform& other);
// Returns the underlying matrix.
const SkMatrix44& matrix() const { return matrix_; }
SkMatrix44& matrix() { return matrix_; }
private:
void TransformPointInternal(const SkMatrix44& xform,
Point& point) const;
void TransformPointInternal(const SkMatrix44& xform,
Point3F& point) const;
SkMatrix44 matrix_;
// copy/assign are allowed.
};
} // namespace gfx
#endif // UI_GFX_TRANSFORM_H_
|
