Matrix.h revision a3dc55f83ab583e0a66b893c71b849afa046770a
108ae317c21ec3086b5017672bba87420cc38a407Romain Guy/*
208ae317c21ec3086b5017672bba87420cc38a407Romain Guy * Copyright (C) 2010 The Android Open Source Project
308ae317c21ec3086b5017672bba87420cc38a407Romain Guy *
408ae317c21ec3086b5017672bba87420cc38a407Romain Guy * Licensed under the Apache License, Version 2.0 (the "License");
508ae317c21ec3086b5017672bba87420cc38a407Romain Guy * you may not use this file except in compliance with the License.
608ae317c21ec3086b5017672bba87420cc38a407Romain Guy * You may obtain a copy of the License at
708ae317c21ec3086b5017672bba87420cc38a407Romain Guy *
808ae317c21ec3086b5017672bba87420cc38a407Romain Guy *      http://www.apache.org/licenses/LICENSE-2.0
908ae317c21ec3086b5017672bba87420cc38a407Romain Guy *
1008ae317c21ec3086b5017672bba87420cc38a407Romain Guy * Unless required by applicable law or agreed to in writing, software
1108ae317c21ec3086b5017672bba87420cc38a407Romain Guy * distributed under the License is distributed on an "AS IS" BASIS,
1208ae317c21ec3086b5017672bba87420cc38a407Romain Guy * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1308ae317c21ec3086b5017672bba87420cc38a407Romain Guy * See the License for the specific language governing permissions and
1408ae317c21ec3086b5017672bba87420cc38a407Romain Guy * limitations under the License.
1508ae317c21ec3086b5017672bba87420cc38a407Romain Guy */
1608ae317c21ec3086b5017672bba87420cc38a407Romain Guy
175b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#ifndef ANDROID_HWUI_MATRIX_H
185b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#define ANDROID_HWUI_MATRIX_H
1908ae317c21ec3086b5017672bba87420cc38a407Romain Guy
20f6a11b8a9e25ff9861bbba19251bea84d8a5daf2Romain Guy#include <SkMatrix.h>
21f6a11b8a9e25ff9861bbba19251bea84d8a5daf2Romain Guy
2271e36aa7db69449e210d0791284cb810a7471c07Romain Guy#include <cutils/compiler.h>
2371e36aa7db69449e210d0791284cb810a7471c07Romain Guy
249d5316e3f56d138504565ff311145ac01621dff4Romain Guy#include "Rect.h"
259d5316e3f56d138504565ff311145ac01621dff4Romain Guy
2608ae317c21ec3086b5017672bba87420cc38a407Romain Guynamespace android {
279d5316e3f56d138504565ff311145ac01621dff4Romain Guynamespace uirenderer {
2808ae317c21ec3086b5017672bba87420cc38a407Romain Guy
2908ae317c21ec3086b5017672bba87420cc38a407Romain Guy///////////////////////////////////////////////////////////////////////////////
3008ae317c21ec3086b5017672bba87420cc38a407Romain Guy// Classes
3108ae317c21ec3086b5017672bba87420cc38a407Romain Guy///////////////////////////////////////////////////////////////////////////////
3208ae317c21ec3086b5017672bba87420cc38a407Romain Guy
3371e36aa7db69449e210d0791284cb810a7471c07Romain Guyclass ANDROID_API Matrix4 {
3408ae317c21ec3086b5017672bba87420cc38a407Romain Guypublic:
357ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    float data[16];
36c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy
37af28b514964861d81b48902f942f706050936d38Romain Guy    enum Entry {
38af28b514964861d81b48902f942f706050936d38Romain Guy        kScaleX = 0,
39af28b514964861d81b48902f942f706050936d38Romain Guy        kSkewY = 1,
40af28b514964861d81b48902f942f706050936d38Romain Guy        kPerspective0 = 3,
41af28b514964861d81b48902f942f706050936d38Romain Guy        kSkewX = 4,
42af28b514964861d81b48902f942f706050936d38Romain Guy        kScaleY = 5,
43af28b514964861d81b48902f942f706050936d38Romain Guy        kPerspective1 = 7,
44af28b514964861d81b48902f942f706050936d38Romain Guy        kScaleZ = 10,
45af28b514964861d81b48902f942f706050936d38Romain Guy        kTranslateX = 12,
46af28b514964861d81b48902f942f706050936d38Romain Guy        kTranslateY = 13,
47af28b514964861d81b48902f942f706050936d38Romain Guy        kTranslateZ = 14,
48af28b514964861d81b48902f942f706050936d38Romain Guy        kPerspective2 = 15
49af28b514964861d81b48902f942f706050936d38Romain Guy    };
50af28b514964861d81b48902f942f706050936d38Romain Guy
517ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    Matrix4() {
527ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        loadIdentity();
537ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
5408ae317c21ec3086b5017672bba87420cc38a407Romain Guy
557ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    Matrix4(const float* v) {
567ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        load(v);
577ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
5808ae317c21ec3086b5017672bba87420cc38a407Romain Guy
597ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    Matrix4(const Matrix4& v) {
607ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        load(v);
617ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
6208ae317c21ec3086b5017672bba87420cc38a407Romain Guy
637ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    Matrix4(const SkMatrix& v) {
647ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        load(v);
657ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
66f6a11b8a9e25ff9861bbba19251bea84d8a5daf2Romain Guy
677ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void loadIdentity();
6808ae317c21ec3086b5017672bba87420cc38a407Romain Guy
697ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void load(const float* v);
707ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void load(const Matrix4& v);
717ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void load(const SkMatrix& v);
7208ae317c21ec3086b5017672bba87420cc38a407Romain Guy
73079ba2c85b15e882629b8d188f5fbdb42f7f8eeaRomain Guy    void loadInverse(const Matrix4& v);
74079ba2c85b15e882629b8d188f5fbdb42f7f8eeaRomain Guy
757ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void loadTranslate(float x, float y, float z);
767ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void loadScale(float sx, float sy, float sz);
77807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy    void loadSkew(float sx, float sy);
787ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void loadRotate(float angle, float x, float y, float z);
797ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void loadMultiply(const Matrix4& u, const Matrix4& v);
8008ae317c21ec3086b5017672bba87420cc38a407Romain Guy
817ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void loadOrtho(float left, float right, float bottom, float top, float near, float far);
8208ae317c21ec3086b5017672bba87420cc38a407Romain Guy
837ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void multiply(const Matrix4& v) {
847ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        Matrix4 u;
857ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        u.loadMultiply(*this, v);
867ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        load(u);
877ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
8808ae317c21ec3086b5017672bba87420cc38a407Romain Guy
89ddb80bebb0776e6d852aab6e8bba5d5591847a55Romain Guy    void multiply(float v);
90ddb80bebb0776e6d852aab6e8bba5d5591847a55Romain Guy
917ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void translate(float x, float y, float z) {
927ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        Matrix4 u;
937ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        u.loadTranslate(x, y, z);
947ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        multiply(u);
957ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
9608ae317c21ec3086b5017672bba87420cc38a407Romain Guy
977ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void scale(float sx, float sy, float sz) {
987ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        Matrix4 u;
997ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        u.loadScale(sx, sy, sz);
1007ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        multiply(u);
1017ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
10208ae317c21ec3086b5017672bba87420cc38a407Romain Guy
103807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy    void skew(float sx, float sy) {
104807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy        Matrix4 u;
105807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy        u.loadSkew(sx, sy);
106807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy        multiply(u);
107807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy    }
108807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy
1097ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void rotate(float angle, float x, float y, float z) {
1107ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        Matrix4 u;
1117ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        u.loadRotate(angle, x, y, z);
1127ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        multiply(u);
1137ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    }
11408ae317c21ec3086b5017672bba87420cc38a407Romain Guy
115710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik    bool isPureTranslate() const;
116710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik    bool isSimple() const;
117710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik    bool isIdentity() const;
118a3dc55f83ab583e0a66b893c71b849afa046770aRomain Guy    bool isPerspective() const;
1196620c6d413f972819fada92b574f0fa9e96d36c1Romain Guy
120710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik    bool changesBounds() const;
121e8cb9c14309b0f01c0159efdf9a7198f44a62642Romain Guy
1227ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void copyTo(float* v) const;
1237ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void copyTo(SkMatrix& v) const;
12408ae317c21ec3086b5017672bba87420cc38a407Romain Guy
1257ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void mapRect(Rect& r) const;
1260ba681bce12d522c5575dfccb5a6ca12f0fba746Romain Guy    void mapPoint(float& x, float& y) const;
1279d5316e3f56d138504565ff311145ac01621dff4Romain Guy
128bd6b79b40247aea7bfe13d0831c6c0472df6c636Romain Guy    float getTranslateX();
129bd6b79b40247aea7bfe13d0831c6c0472df6c636Romain Guy    float getTranslateY();
130bd6b79b40247aea7bfe13d0831c6c0472df6c636Romain Guy
1317ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy    void dump() const;
13208ae317c21ec3086b5017672bba87420cc38a407Romain Guy
133f6a11b8a9e25ff9861bbba19251bea84d8a5daf2Romain Guyprivate:
134af28b514964861d81b48902f942f706050936d38Romain Guy    bool mSimpleMatrix;
135302a9df1d50373c82923bb84ff665dfce584fb22Romain Guy    bool mIsIdentity;
136af28b514964861d81b48902f942f706050936d38Romain Guy
13708ae317c21ec3086b5017672bba87420cc38a407Romain Guy    inline float get(int i, int j) const {
138c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy        return data[i * 4 + j];
13908ae317c21ec3086b5017672bba87420cc38a407Romain Guy    }
14008ae317c21ec3086b5017672bba87420cc38a407Romain Guy
14108ae317c21ec3086b5017672bba87420cc38a407Romain Guy    inline void set(int i, int j, float v) {
1427ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy        data[i * 4 + j] = v;
14308ae317c21ec3086b5017672bba87420cc38a407Romain Guy    }
14408ae317c21ec3086b5017672bba87420cc38a407Romain Guy}; // class Matrix4
14508ae317c21ec3086b5017672bba87420cc38a407Romain Guy
14608ae317c21ec3086b5017672bba87420cc38a407Romain Guy///////////////////////////////////////////////////////////////////////////////
14708ae317c21ec3086b5017672bba87420cc38a407Romain Guy// Types
14808ae317c21ec3086b5017672bba87420cc38a407Romain Guy///////////////////////////////////////////////////////////////////////////////
14908ae317c21ec3086b5017672bba87420cc38a407Romain Guy
15008ae317c21ec3086b5017672bba87420cc38a407Romain Guytypedef Matrix4 mat4;
15108ae317c21ec3086b5017672bba87420cc38a407Romain Guy
1529d5316e3f56d138504565ff311145ac01621dff4Romain Guy}; // namespace uirenderer
15308ae317c21ec3086b5017672bba87420cc38a407Romain Guy}; // namespace android
15408ae317c21ec3086b5017672bba87420cc38a407Romain Guy
1555b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#endif // ANDROID_HWUI_MATRIX_H
156