Matrix.h revision b79a3e301a8d89b9e1b1f6f3d7fd6aa56610a6f0
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 29629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik#define SK_MATRIX_STRING "[%.2f %.2f %.2f] [%.2f %.2f %.2f] [%.2f %.2f %.2f]" 30629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik#define SK_MATRIX_ARGS(m) \ 3128ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik (m)->get(0), (m)->get(1), (m)->get(2), \ 3228ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik (m)->get(3), (m)->get(4), (m)->get(5), \ 3328ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik (m)->get(6), (m)->get(7), (m)->get(8) 3428ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik 35629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik#define MATRIX_4_STRING "[%.2f %.2f %.2f %.2f] [%.2f %.2f %.2f %.2f]" \ 36629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik " [%.2f %.2f %.2f %.2f] [%.2f %.2f %.2f %.2f]" 37629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik#define MATRIX_4_ARGS(m) \ 38629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik (m)->data[0], (m)->data[4], (m)->data[8], (m)->data[12], \ 39629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik (m)->data[1], (m)->data[5], (m)->data[9], (m)->data[13], \ 40629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik (m)->data[2], (m)->data[6], (m)->data[10], (m)->data[14], \ 41629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik (m)->data[3], (m)->data[7], (m)->data[11], (m)->data[15] \ 42629f67709b84a6bebdecdc8a500bf83560f557d0Chris Craik 4308ae317c21ec3086b5017672bba87420cc38a407Romain Guy/////////////////////////////////////////////////////////////////////////////// 4408ae317c21ec3086b5017672bba87420cc38a407Romain Guy// Classes 4508ae317c21ec3086b5017672bba87420cc38a407Romain Guy/////////////////////////////////////////////////////////////////////////////// 4608ae317c21ec3086b5017672bba87420cc38a407Romain Guy 4771e36aa7db69449e210d0791284cb810a7471c07Romain Guyclass ANDROID_API Matrix4 { 4808ae317c21ec3086b5017672bba87420cc38a407Romain Guypublic: 497ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy float data[16]; 50c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 51af28b514964861d81b48902f942f706050936d38Romain Guy enum Entry { 52af28b514964861d81b48902f942f706050936d38Romain Guy kScaleX = 0, 53af28b514964861d81b48902f942f706050936d38Romain Guy kSkewY = 1, 54af28b514964861d81b48902f942f706050936d38Romain Guy kPerspective0 = 3, 55af28b514964861d81b48902f942f706050936d38Romain Guy kSkewX = 4, 56af28b514964861d81b48902f942f706050936d38Romain Guy kScaleY = 5, 57af28b514964861d81b48902f942f706050936d38Romain Guy kPerspective1 = 7, 58af28b514964861d81b48902f942f706050936d38Romain Guy kScaleZ = 10, 59af28b514964861d81b48902f942f706050936d38Romain Guy kTranslateX = 12, 60af28b514964861d81b48902f942f706050936d38Romain Guy kTranslateY = 13, 61af28b514964861d81b48902f942f706050936d38Romain Guy kTranslateZ = 14, 62af28b514964861d81b48902f942f706050936d38Romain Guy kPerspective2 = 15 63af28b514964861d81b48902f942f706050936d38Romain Guy }; 64af28b514964861d81b48902f942f706050936d38Romain Guy 658ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy // NOTE: The flags from kTypeIdentity to kTypePerspective 668ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy // must be kept in sync with the type flags found 678ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy // in SkMatrix 688ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy enum Type { 698ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy kTypeIdentity = 0, 708ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy kTypeTranslate = 0x1, 718ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy kTypeScale = 0x2, 728ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy kTypeAffine = 0x4, 738ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy kTypePerspective = 0x8, 748ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy kTypeRectToRect = 0x10, 75996fe656340ede058a6f0e6b18f9ec525ddb4e27Chris Craik kTypeUnknown = 0x20, 768ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy }; 778ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy 788ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy static const int sGeometryMask = 0xf; 798ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy 807ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4() { 817ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy loadIdentity(); 827ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 8308ae317c21ec3086b5017672bba87420cc38a407Romain Guy 847ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4(const float* v) { 857ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy load(v); 867ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 8708ae317c21ec3086b5017672bba87420cc38a407Romain Guy 887ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4(const Matrix4& v) { 897ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy load(v); 907ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 9108ae317c21ec3086b5017672bba87420cc38a407Romain Guy 927ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4(const SkMatrix& v) { 937ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy load(v); 947ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 95f6a11b8a9e25ff9861bbba19251bea84d8a5daf2Romain Guy 963b753829ae858d424fe109f714745379a6daf455Romain Guy float operator[](int index) const { 973b753829ae858d424fe109f714745379a6daf455Romain Guy return data[index]; 983b753829ae858d424fe109f714745379a6daf455Romain Guy } 993b753829ae858d424fe109f714745379a6daf455Romain Guy 1003b753829ae858d424fe109f714745379a6daf455Romain Guy float& operator[](int index) { 1013b753829ae858d424fe109f714745379a6daf455Romain Guy mType = kTypeUnknown; 1023b753829ae858d424fe109f714745379a6daf455Romain Guy return data[index]; 1033b753829ae858d424fe109f714745379a6daf455Romain Guy } 1043b753829ae858d424fe109f714745379a6daf455Romain Guy 1053b753829ae858d424fe109f714745379a6daf455Romain Guy Matrix4& operator=(const SkMatrix& v) { 1063b753829ae858d424fe109f714745379a6daf455Romain Guy load(v); 1073b753829ae858d424fe109f714745379a6daf455Romain Guy return *this; 1083b753829ae858d424fe109f714745379a6daf455Romain Guy } 1093b753829ae858d424fe109f714745379a6daf455Romain Guy 110bd3055f95e67a55648fd84a125e939293115171bRomain Guy friend bool operator==(const Matrix4& a, const Matrix4& b) { 111bd3055f95e67a55648fd84a125e939293115171bRomain Guy return !memcmp(&a.data[0], &b.data[0], 16 * sizeof(float)); 112bd3055f95e67a55648fd84a125e939293115171bRomain Guy } 113bd3055f95e67a55648fd84a125e939293115171bRomain Guy 114bd3055f95e67a55648fd84a125e939293115171bRomain Guy friend bool operator!=(const Matrix4& a, const Matrix4& b) { 115bd3055f95e67a55648fd84a125e939293115171bRomain Guy return !(a == b); 116bd3055f95e67a55648fd84a125e939293115171bRomain Guy } 117bd3055f95e67a55648fd84a125e939293115171bRomain Guy 1187ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void loadIdentity(); 11908ae317c21ec3086b5017672bba87420cc38a407Romain Guy 1207ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void load(const float* v); 1217ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void load(const Matrix4& v); 1227ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void load(const SkMatrix& v); 12308ae317c21ec3086b5017672bba87420cc38a407Romain Guy 124079ba2c85b15e882629b8d188f5fbdb42f7f8eeaRomain Guy void loadInverse(const Matrix4& v); 125079ba2c85b15e882629b8d188f5fbdb42f7f8eeaRomain Guy 1267ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void loadTranslate(float x, float y, float z); 1277ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void loadScale(float sx, float sy, float sz); 128807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy void loadSkew(float sx, float sy); 1298ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy void loadRotate(float angle); 1307ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void loadRotate(float angle, float x, float y, float z); 1317ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void loadMultiply(const Matrix4& u, const Matrix4& v); 13208ae317c21ec3086b5017672bba87420cc38a407Romain Guy 1337ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void loadOrtho(float left, float right, float bottom, float top, float near, float far); 13408ae317c21ec3086b5017672bba87420cc38a407Romain Guy 135f6bed4f12a2c975678fc0bdea15054ab169aafb5Romain Guy uint8_t getType() const; 1368ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy 1377ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void multiply(const Matrix4& v) { 1387ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4 u; 1397ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy u.loadMultiply(*this, v); 1407ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy load(u); 1417ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 14208ae317c21ec3086b5017672bba87420cc38a407Romain Guy 143ddb80bebb0776e6d852aab6e8bba5d5591847a55Romain Guy void multiply(float v); 144ddb80bebb0776e6d852aab6e8bba5d5591847a55Romain Guy 145f57776b2d195f0937906eb88b777bb55ccc36967Chris Craik void translate(float x, float y, float z = 0) { 146f6bed4f12a2c975678fc0bdea15054ab169aafb5Romain Guy if ((getType() & sGeometryMask) <= kTypeTranslate) { 1474c2547fa9244e78115cde0a259291053108c3dc7Romain Guy data[kTranslateX] += x; 1484c2547fa9244e78115cde0a259291053108c3dc7Romain Guy data[kTranslateY] += y; 149f57776b2d195f0937906eb88b777bb55ccc36967Chris Craik data[kTranslateZ] += z; 1504c2547fa9244e78115cde0a259291053108c3dc7Romain Guy } else { 1514c2547fa9244e78115cde0a259291053108c3dc7Romain Guy // Doing a translation will only affect the translate bit of the type 1524c2547fa9244e78115cde0a259291053108c3dc7Romain Guy // Save the type 153f6bed4f12a2c975678fc0bdea15054ab169aafb5Romain Guy uint8_t type = mType; 1544c2547fa9244e78115cde0a259291053108c3dc7Romain Guy 1554c2547fa9244e78115cde0a259291053108c3dc7Romain Guy Matrix4 u; 156f57776b2d195f0937906eb88b777bb55ccc36967Chris Craik u.loadTranslate(x, y, z); 1574c2547fa9244e78115cde0a259291053108c3dc7Romain Guy multiply(u); 1584c2547fa9244e78115cde0a259291053108c3dc7Romain Guy 1594c2547fa9244e78115cde0a259291053108c3dc7Romain Guy // Restore the type and fix the translate bit 1604c2547fa9244e78115cde0a259291053108c3dc7Romain Guy mType = type; 1614c2547fa9244e78115cde0a259291053108c3dc7Romain Guy if (data[kTranslateX] != 0.0f || data[kTranslateY] != 0.0f) { 1624c2547fa9244e78115cde0a259291053108c3dc7Romain Guy mType |= kTypeTranslate; 1634c2547fa9244e78115cde0a259291053108c3dc7Romain Guy } else { 1644c2547fa9244e78115cde0a259291053108c3dc7Romain Guy mType &= ~kTypeTranslate; 1654c2547fa9244e78115cde0a259291053108c3dc7Romain Guy } 1664c2547fa9244e78115cde0a259291053108c3dc7Romain Guy } 1677ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 16808ae317c21ec3086b5017672bba87420cc38a407Romain Guy 1697ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void scale(float sx, float sy, float sz) { 1707ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4 u; 1717ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy u.loadScale(sx, sy, sz); 1727ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy multiply(u); 1737ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 17408ae317c21ec3086b5017672bba87420cc38a407Romain Guy 175807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy void skew(float sx, float sy) { 176807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy Matrix4 u; 177807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy u.loadSkew(sx, sy); 178807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy multiply(u); 179807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy } 180807daf7df615b60ce6fc41355aabe3aa353cebabRomain Guy 1817ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void rotate(float angle, float x, float y, float z) { 1827ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy Matrix4 u; 1837ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy u.loadRotate(angle, x, y, z); 1847ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy multiply(u); 1857ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy } 18608ae317c21ec3086b5017672bba87420cc38a407Romain Guy 1878ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy /** 1888ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy * If the matrix is identity or translate and/or scale. 1898ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy */ 190710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik bool isSimple() const; 1918ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy bool isPureTranslate() const; 192710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik bool isIdentity() const; 193a3dc55f83ab583e0a66b893c71b849afa046770aRomain Guy bool isPerspective() const; 1948ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy bool rectToRect() const; 195d965bc5823d878a3fd056b8a95fb4eb578ed3fe4Chris Craik bool positiveScale() const; 1966620c6d413f972819fada92b574f0fa9e96d36c1Romain Guy 197710f46d9d6a5bf9ea1c1833384caf61e1934124fChris Craik bool changesBounds() const; 198e8cb9c14309b0f01c0159efdf9a7198f44a62642Romain Guy 1997ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void copyTo(float* v) const; 2007ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void copyTo(SkMatrix& v) const; 20108ae317c21ec3086b5017672bba87420cc38a407Romain Guy 202b79a3e301a8d89b9e1b1f6f3d7fd6aa56610a6f0Chris Craik float mapZ(const Vector3& orig) const; 203f57776b2d195f0937906eb88b777bb55ccc36967Chris Craik void mapPoint3d(Vector3& vec) const; 204f57776b2d195f0937906eb88b777bb55ccc36967Chris Craik void mapPoint(float& x, float& y) const; // 2d only 205f57776b2d195f0937906eb88b777bb55ccc36967Chris Craik void mapRect(Rect& r) const; // 2d only 2069d5316e3f56d138504565ff311145ac01621dff4Romain Guy 207624234f69b2a4781d24f3e4c6ae6450729e38397Romain Guy float getTranslateX() const; 208624234f69b2a4781d24f3e4c6ae6450729e38397Romain Guy float getTranslateY() const; 209bd6b79b40247aea7bfe13d0831c6c0472df6c636Romain Guy 2103b753829ae858d424fe109f714745379a6daf455Romain Guy void decomposeScale(float& sx, float& sy) const; 2113b753829ae858d424fe109f714745379a6daf455Romain Guy 2127ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy void dump() const; 21308ae317c21ec3086b5017672bba87420cc38a407Romain Guy 214c74f45a334f0e3725c23cdd270cbcb0efac4ea75Romain Guy static const Matrix4& identity(); 215c74f45a334f0e3725c23cdd270cbcb0efac4ea75Romain Guy 216f6a11b8a9e25ff9861bbba19251bea84d8a5daf2Romain Guyprivate: 217f6bed4f12a2c975678fc0bdea15054ab169aafb5Romain Guy mutable uint8_t mType; 218af28b514964861d81b48902f942f706050936d38Romain Guy 21908ae317c21ec3086b5017672bba87420cc38a407Romain Guy inline float get(int i, int j) const { 220c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy return data[i * 4 + j]; 22108ae317c21ec3086b5017672bba87420cc38a407Romain Guy } 22208ae317c21ec3086b5017672bba87420cc38a407Romain Guy 22308ae317c21ec3086b5017672bba87420cc38a407Romain Guy inline void set(int i, int j, float v) { 2247ae7ac48aa2b53453c9805075171ecd5bcafd7deRomain Guy data[i * 4 + j] = v; 22508ae317c21ec3086b5017672bba87420cc38a407Romain Guy } 2268ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy 227f6bed4f12a2c975678fc0bdea15054ab169aafb5Romain Guy uint8_t getGeometryType() const; 2288ce00301a023eecaeb8891ce906f67b513ebb42aRomain Guy 22908ae317c21ec3086b5017672bba87420cc38a407Romain Guy}; // class Matrix4 23008ae317c21ec3086b5017672bba87420cc38a407Romain Guy 23108ae317c21ec3086b5017672bba87420cc38a407Romain Guy/////////////////////////////////////////////////////////////////////////////// 23208ae317c21ec3086b5017672bba87420cc38a407Romain Guy// Types 23308ae317c21ec3086b5017672bba87420cc38a407Romain Guy/////////////////////////////////////////////////////////////////////////////// 23408ae317c21ec3086b5017672bba87420cc38a407Romain Guy 23508ae317c21ec3086b5017672bba87420cc38a407Romain Guytypedef Matrix4 mat4; 23608ae317c21ec3086b5017672bba87420cc38a407Romain Guy 2379d5316e3f56d138504565ff311145ac01621dff4Romain Guy}; // namespace uirenderer 23808ae317c21ec3086b5017672bba87420cc38a407Romain Guy}; // namespace android 23908ae317c21ec3086b5017672bba87420cc38a407Romain Guy 2405b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#endif // ANDROID_HWUI_MATRIX_H 241