54f195457742ed7e161c10ca51e885b695f99f2b
[WebKit.git] / Source / WebCore / platform / graphics / transforms / AffineTransform.h
1 /*
2  * Copyright (C) 2005-2016 Apple Inc.  All rights reserved.
3  *               2010 Dirk Schulze <krit@webkit.org>
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
25  */
26
27 #ifndef AffineTransform_h
28 #define AffineTransform_h
29
30 #include <array>
31 #include <wtf/FastMalloc.h>
32 #include <wtf/Optional.h>
33
34 #if USE(CG)
35 typedef struct CGAffineTransform CGAffineTransform;
36 #endif
37
38 #if PLATFORM(WIN)
39 struct D2D_MATRIX_3X2_F;
40 typedef D2D_MATRIX_3X2_F D2D1_MATRIX_3X2_F;
41 #endif
42
43 namespace WTF {
44 class TextStream;
45 }
46
47 namespace WebCore {
48
49 class FloatPoint;
50 class FloatQuad;
51 class FloatRect;
52 class FloatSize;
53 class IntPoint;
54 class IntSize;
55 class IntRect;
56 class TransformationMatrix;
57
58 class AffineTransform {
59     WTF_MAKE_FAST_ALLOCATED;
60 public:
61     WEBCORE_EXPORT AffineTransform();
62     WEBCORE_EXPORT AffineTransform(double a, double b, double c, double d, double e, double f);
63
64 #if USE(CG)
65     WEBCORE_EXPORT AffineTransform(const CGAffineTransform&);
66 #endif
67
68 #if PLATFORM(WIN)
69     AffineTransform(const D2D1_MATRIX_3X2_F&);
70 #endif
71
72     void setMatrix(double a, double b, double c, double d, double e, double f);
73
74     void map(double x, double y, double& x2, double& y2) const;
75
76     // Rounds the mapped point to the nearest integer value.
77     WEBCORE_EXPORT IntPoint mapPoint(const IntPoint&) const;
78
79     WEBCORE_EXPORT FloatPoint mapPoint(const FloatPoint&) const;
80
81     WEBCORE_EXPORT IntSize mapSize(const IntSize&) const;
82
83     WEBCORE_EXPORT FloatSize mapSize(const FloatSize&) const;
84
85     // Rounds the resulting mapped rectangle out. This is helpful for bounding
86     // box computations but may not be what is wanted in other contexts.
87     WEBCORE_EXPORT IntRect mapRect(const IntRect&) const;
88
89     WEBCORE_EXPORT FloatRect mapRect(const FloatRect&) const;
90     WEBCORE_EXPORT FloatQuad mapQuad(const FloatQuad&) const;
91
92     WEBCORE_EXPORT bool isIdentity() const;
93
94     double a() const { return m_transform[0]; }
95     void setA(double a) { m_transform[0] = a; }
96     double b() const { return m_transform[1]; }
97     void setB(double b) { m_transform[1] = b; }
98     double c() const { return m_transform[2]; }
99     void setC(double c) { m_transform[2] = c; }
100     double d() const { return m_transform[3]; }
101     void setD(double d) { m_transform[3] = d; }
102     double e() const { return m_transform[4]; }
103     void setE(double e) { m_transform[4] = e; }
104     double f() const { return m_transform[5]; }
105     void setF(double f) { m_transform[5] = f; }
106
107     WEBCORE_EXPORT void makeIdentity();
108
109     WEBCORE_EXPORT AffineTransform& multiply(const AffineTransform& other);
110     WEBCORE_EXPORT AffineTransform& scale(double);
111     AffineTransform& scale(double sx, double sy); 
112     WEBCORE_EXPORT AffineTransform& scaleNonUniform(double sx, double sy); // Same as scale(sx, sy).
113     WEBCORE_EXPORT AffineTransform& scale(const FloatSize&);
114     WEBCORE_EXPORT AffineTransform& rotate(double);
115     AffineTransform& rotateFromVector(double x, double y);
116     WEBCORE_EXPORT AffineTransform& translate(double tx, double ty);
117     WEBCORE_EXPORT AffineTransform& translate(const FloatPoint&);
118     WEBCORE_EXPORT AffineTransform& translate(const FloatSize&);
119     WEBCORE_EXPORT AffineTransform& shear(double sx, double sy);
120     WEBCORE_EXPORT AffineTransform& flipX();
121     WEBCORE_EXPORT AffineTransform& flipY();
122     WEBCORE_EXPORT AffineTransform& skew(double angleX, double angleY);
123     AffineTransform& skewX(double angle);
124     AffineTransform& skewY(double angle);
125
126     // These functions get the length of an axis-aligned unit vector
127     // once it has been mapped through the transform
128     WEBCORE_EXPORT double xScale() const;
129     WEBCORE_EXPORT double yScale() const;
130
131     bool isInvertible() const; // If you call this this, you're probably doing it wrong.
132     WEBCORE_EXPORT Optional<AffineTransform> inverse() const;
133
134     WEBCORE_EXPORT void blend(const AffineTransform& from, double progress);
135
136     WEBCORE_EXPORT TransformationMatrix toTransformationMatrix() const;
137
138     bool isIdentityOrTranslation() const
139     {
140         return m_transform[0] == 1 && m_transform[1] == 0 && m_transform[2] == 0 && m_transform[3] == 1;
141     }
142     
143     bool isIdentityOrTranslationOrFlipped() const
144     {
145         return m_transform[0] == 1 && m_transform[1] == 0 && m_transform[2] == 0 && (m_transform[3] == 1 || m_transform[3] == -1);
146     }
147
148     bool preservesAxisAlignment() const
149     {
150         return (m_transform[1] == 0 && m_transform[2] == 0) || (m_transform[0] == 0 && m_transform[3] == 0);
151     }
152
153     bool operator== (const AffineTransform& m2) const
154     {
155         return (m_transform[0] == m2.m_transform[0]
156              && m_transform[1] == m2.m_transform[1]
157              && m_transform[2] == m2.m_transform[2]
158              && m_transform[3] == m2.m_transform[3]
159              && m_transform[4] == m2.m_transform[4]
160              && m_transform[5] == m2.m_transform[5]);
161     }
162
163     bool operator!=(const AffineTransform& other) const { return !(*this == other); }
164
165     // *this = *this * t (i.e., a multRight)
166     AffineTransform& operator*=(const AffineTransform& t)
167     {
168         return multiply(t);
169     }
170     
171     // result = *this * t (i.e., a multRight)
172     AffineTransform operator*(const AffineTransform& t) const
173     {
174         AffineTransform result = *this;
175         result *= t;
176         return result;
177     }
178
179 #if USE(CG)
180     WEBCORE_EXPORT operator CGAffineTransform() const;
181 #endif
182
183 #if PLATFORM(WIN)
184     operator D2D1_MATRIX_3X2_F() const;
185 #endif
186
187     static AffineTransform translation(double x, double y)
188     {
189         return AffineTransform(1, 0, 0, 1, x, y);
190     }
191
192     // decompose the matrix into its component parts
193     typedef struct {
194         double scaleX, scaleY;
195         double angle;
196         double remainderA, remainderB, remainderC, remainderD;
197         double translateX, translateY;
198     } DecomposedType;
199     
200     bool decompose(DecomposedType&) const;
201     void recompose(const DecomposedType&);
202
203 private:
204     std::array<double, 6> m_transform;
205 };
206
207 WEBCORE_EXPORT AffineTransform makeMapBetweenRects(const FloatRect& source, const FloatRect& dest);
208
209 WEBCORE_EXPORT WTF::TextStream& operator<<(WTF::TextStream&, const AffineTransform&);
210
211 }
212
213 #endif