2 * Copyright (C) 2008 Apple Inc. All Rights Reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution.
13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 #ifndef WebKitCSSMatrix_h
27 #define WebKitCSSMatrix_h
29 #include "ExceptionCode.h"
30 #include "PlatformString.h"
31 #include "StyleBase.h"
32 #include "TransformationMatrix.h"
33 #include <wtf/PassRefPtr.h>
34 #include <wtf/RefPtr.h>
38 class WebKitCSSMatrix : public StyleBase {
40 static PassRefPtr<WebKitCSSMatrix> create()
42 return adoptRef(new WebKitCSSMatrix());
44 static PassRefPtr<WebKitCSSMatrix> create(const WebKitCSSMatrix& m)
46 return adoptRef(new WebKitCSSMatrix(m));
48 static PassRefPtr<WebKitCSSMatrix> create(const TransformationMatrix& m)
50 return adoptRef(new WebKitCSSMatrix(m));
52 static PassRefPtr<WebKitCSSMatrix> create(const String& s, ExceptionCode& ec)
54 return adoptRef(new WebKitCSSMatrix(s, ec));
57 virtual ~WebKitCSSMatrix();
59 double a() const { return m_matrix.a(); }
60 double b() const { return m_matrix.b(); }
61 double c() const { return m_matrix.c(); }
62 double d() const { return m_matrix.d(); }
63 double e() const { return m_matrix.e(); }
64 double f() const { return m_matrix.f(); }
66 void setA(double f) { m_matrix.setA(f); }
67 void setB(double f) { m_matrix.setB(f); }
68 void setC(double f) { m_matrix.setC(f); }
69 void setD(double f) { m_matrix.setD(f); }
70 void setE(double f) { m_matrix.setE(f); }
71 void setF(double f) { m_matrix.setF(f); }
73 double m11() const { return m_matrix.m11(); }
74 double m12() const { return m_matrix.m12(); }
75 double m13() const { return m_matrix.m13(); }
76 double m14() const { return m_matrix.m14(); }
77 double m21() const { return m_matrix.m21(); }
78 double m22() const { return m_matrix.m22(); }
79 double m23() const { return m_matrix.m23(); }
80 double m24() const { return m_matrix.m24(); }
81 double m31() const { return m_matrix.m31(); }
82 double m32() const { return m_matrix.m32(); }
83 double m33() const { return m_matrix.m33(); }
84 double m34() const { return m_matrix.m34(); }
85 double m41() const { return m_matrix.m41(); }
86 double m42() const { return m_matrix.m42(); }
87 double m43() const { return m_matrix.m43(); }
88 double m44() const { return m_matrix.m44(); }
90 void setM11(double f) { m_matrix.setM11(f); }
91 void setM12(double f) { m_matrix.setM12(f); }
92 void setM13(double f) { m_matrix.setM13(f); }
93 void setM14(double f) { m_matrix.setM14(f); }
94 void setM21(double f) { m_matrix.setM21(f); }
95 void setM22(double f) { m_matrix.setM22(f); }
96 void setM23(double f) { m_matrix.setM23(f); }
97 void setM24(double f) { m_matrix.setM24(f); }
98 void setM31(double f) { m_matrix.setM31(f); }
99 void setM32(double f) { m_matrix.setM32(f); }
100 void setM33(double f) { m_matrix.setM33(f); }
101 void setM34(double f) { m_matrix.setM34(f); }
102 void setM41(double f) { m_matrix.setM41(f); }
103 void setM42(double f) { m_matrix.setM42(f); }
104 void setM43(double f) { m_matrix.setM43(f); }
105 void setM44(double f) { m_matrix.setM44(f); }
107 void setMatrixValue(const String& string, ExceptionCode&);
109 // The following math function return a new matrix with the
110 // specified operation applied. The this value is not modified.
112 // Multiply this matrix by secondMatrix, on the right (result = this * secondMatrix)
113 PassRefPtr<WebKitCSSMatrix> multiply(WebKitCSSMatrix* secondMatrix) const;
115 // Return the inverse of this matrix. Throw an exception if the matrix is not invertible
116 PassRefPtr<WebKitCSSMatrix> inverse(ExceptionCode&) const;
118 // Return this matrix translated by the passed values.
119 // Passing a NaN will use a value of 0. This allows the 3D form to used for 2D operations
120 // Operation is performed as though the this matrix is multiplied by a matrix with
121 // the translation values on the left (result = translation(x,y,z) * this)
122 PassRefPtr<WebKitCSSMatrix> translate(double x, double y, double z) const;
124 // Returns this matrix scaled by the passed values.
125 // Passing scaleX or scaleZ as NaN uses a value of 1, but passing scaleY of NaN
126 // makes it the same as scaleX. This allows the 3D form to used for 2D operations
127 // Operation is performed as though the this matrix is multiplied by a matrix with
128 // the scale values on the left (result = scale(x,y,z) * this)
129 PassRefPtr<WebKitCSSMatrix> scale(double scaleX, double scaleY, double scaleZ) const;
131 // Returns this matrix rotated by the passed values.
132 // If rotY and rotZ are NaN, rotate about Z (rotX=0, rotateY=0, rotateZ=rotX).
133 // Otherwise use a rotation value of 0 for any passed NaN.
134 // Operation is performed as though the this matrix is multiplied by a matrix with
135 // the rotation values on the left (result = rotation(x,y,z) * this)
136 PassRefPtr<WebKitCSSMatrix> rotate(double rotX, double rotY, double rotZ) const;
138 // Returns this matrix rotated about the passed axis by the passed angle.
139 // Passing a NaN will use a value of 0. If the axis is (0,0,0) use a value
140 // Operation is performed as though the this matrix is multiplied by a matrix with
141 // the rotation values on the left (result = rotation(x,y,z,angle) * this)
142 PassRefPtr<WebKitCSSMatrix> rotateAxisAngle(double x, double y, double z, double angle) const;
144 const TransformationMatrix& transform() const { return m_matrix; }
146 String toString() const;
150 WebKitCSSMatrix(const WebKitCSSMatrix&);
151 WebKitCSSMatrix(const TransformationMatrix&);
152 WebKitCSSMatrix(const String&, ExceptionCode&);
154 TransformationMatrix m_matrix;
157 } // namespace WebCore
159 #endif // WebKitCSSMatrix_h