[dali_1.0.1] Merge branch 'tizen'
[platform/core/uifw/dali-core.git] / dali / public-api / common / constants.h
1 #ifndef __DALI_CONSTANTS_H__
2 #define __DALI_CONSTANTS_H__
3
4 /*
5  * Copyright (c) 2014 Samsung Electronics Co., Ltd.
6  *
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  *
11  * http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  *
19  */
20
21 // EXTERNAL INCLUDES
22 #include <math.h> // M_PI
23
24 // INTERNAL INCLUDES
25 #include <dali/public-api/math/vector2.h>
26 #include <dali/public-api/math/vector3.h>
27 #include <dali/public-api/math/vector4.h>
28 #include <dali/public-api/math/radian.h>
29
30 namespace Dali DALI_IMPORT_API
31 {
32
33 /**
34  * @brief ParentOrigin constants
35  *
36  * Note that for 2D layouting, the typical Z position is 0.5f (not 0.0f)
37  */
38 namespace ParentOrigin
39 {
40 extern const Vector3 DEFAULT; ///< TOP_LEFT
41
42 extern const float TOP;    ///< 0.0f
43 extern const float BOTTOM; ///< 1.0f
44 extern const float LEFT;   ///< 0.0f
45 extern const float RIGHT;  ///< 1.0f
46 extern const float MIDDLE; ///< 0.5f
47
48 extern const Vector3 BACK_TOP_LEFT;      ///< 0.0f, 0.0f, 0.0f
49 extern const Vector3 BACK_TOP_CENTER;    ///< 0.5f, 0.0f, 0.0f
50 extern const Vector3 BACK_TOP_RIGHT;     ///< 1.0f, 0.0f, 0.0f
51 extern const Vector3 BACK_CENTER_LEFT;   ///< 0.0f, 0.5f, 0.0f
52 extern const Vector3 BACK_CENTER;        ///< 0.5f, 0.5f, 0.0f
53 extern const Vector3 BACK_CENTER_RIGHT;  ///< 1.0f, 0.5f, 0.0f
54 extern const Vector3 BACK_BOTTOM_LEFT;   ///< 0.0f, 1.0f, 0.0f
55 extern const Vector3 BACK_BOTTOM_CENTER; ///< 0.5f, 1.0f, 0.0f
56 extern const Vector3 BACK_BOTTOM_RIGHT;  ///< 1.0f, 1.0f, 0.0f
57
58 extern const Vector3 TOP_LEFT;           ///< 0.0f, 0.0f, 0.5f
59 extern const Vector3 TOP_CENTER;         ///< 0.5f, 0.0f, 0.5f
60 extern const Vector3 TOP_RIGHT;          ///< 1.0f, 0.0f, 0.5f
61 extern const Vector3 CENTER_LEFT;        ///< 0.0f, 0.5f, 0.5f
62 extern const Vector3 CENTER;             ///< 0.5f, 0.5f, 0.5f
63 extern const Vector3 CENTER_RIGHT;       ///< 1.0f, 0.5f, 0.5f
64 extern const Vector3 BOTTOM_LEFT;        ///< 0.0f, 1.0f, 0.5f
65 extern const Vector3 BOTTOM_CENTER;      ///< 0.5f, 1.0f, 0.5f
66 extern const Vector3 BOTTOM_RIGHT;       ///< 1.0f, 1.0f, 0.5f
67
68 extern const Vector3 FRONT_TOP_LEFT;     ///< 0.0f, 0.0f, 1.0f
69 extern const Vector3 FRONT_TOP_CENTER;   ///< 0.5f, 0.0f, 1.0f
70 extern const Vector3 FRONT_TOP_RIGHT;    ///< 1.0f, 0.0f, 1.0f
71 extern const Vector3 FRONT_CENTER_LEFT;  ///< 0.0f, 0.5f, 1.0f
72 extern const Vector3 FRONT_CENTER;       ///< 0.5f, 0.5f, 1.0f
73 extern const Vector3 FRONT_CENTER_RIGHT; ///< 1.0f, 0.5f, 1.0f
74 extern const Vector3 FRONT_BOTTOM_LEFT;  ///< 0.0f, 1.0f, 1.0f
75 extern const Vector3 FRONT_BOTTOM_CENTER;///< 0.5f, 1.0f, 1.0f
76 extern const Vector3 FRONT_BOTTOM_RIGHT; ///< 1.0f, 1.0f, 1.0f
77
78 }
79
80 /**
81  * @brief AnchorPoint constants
82  *
83  * Note that for 2D layouting, the typical Z position is 0.5f (not 0.0f)
84  */
85 namespace AnchorPoint
86 {
87 extern const float TOP;    ///< 0.0f
88 extern const float BOTTOM; ///< 1.0f
89 extern const float LEFT;   ///< 0.0f
90 extern const float RIGHT;  ///< 1.0f
91 extern const float MIDDLE; ///< 0.5f
92
93 extern const Vector3 DEFAULT; ///< CENTER
94
95 extern const Vector3 BACK_TOP_LEFT;      ///< 0.0f, 0.0f, 0.0f
96 extern const Vector3 BACK_TOP_CENTER;    ///< 0.5f, 0.0f, 0.0f
97 extern const Vector3 BACK_TOP_RIGHT;     ///< 1.0f, 0.0f, 0.0f
98 extern const Vector3 BACK_CENTER_LEFT;   ///< 0.0f, 0.5f, 0.0f
99 extern const Vector3 BACK_CENTER;        ///< 0.5f, 0.5f, 0.0f
100 extern const Vector3 BACK_CENTER_RIGHT;  ///< 1.0f, 0.5f, 0.0f
101 extern const Vector3 BACK_BOTTOM_LEFT;   ///< 0.0f, 1.0f, 0.0f
102 extern const Vector3 BACK_BOTTOM_CENTER; ///< 0.5f, 1.0f, 0.0f
103 extern const Vector3 BACK_BOTTOM_RIGHT;  ///< 1.0f, 1.0f, 0.0f
104
105 extern const Vector3 TOP_LEFT;           ///< 0.0f, 0.0f, 0.5f
106 extern const Vector3 TOP_CENTER;         ///< 0.5f, 0.0f, 0.5f
107 extern const Vector3 TOP_RIGHT;          ///< 1.0f, 0.0f, 0.5f
108 extern const Vector3 CENTER_LEFT;        ///< 0.0f, 0.5f, 0.5f
109 extern const Vector3 CENTER;             ///< 0.5f, 0.5f, 0.5f
110 extern const Vector3 CENTER_RIGHT;       ///< 1.0f, 0.5f, 0.5f
111 extern const Vector3 BOTTOM_LEFT;        ///< 0.0f, 1.0f, 0.5f
112 extern const Vector3 BOTTOM_CENTER;      ///< 0.5f, 1.0f, 0.5f
113 extern const Vector3 BOTTOM_RIGHT;       ///< 1.0f, 1.0f, 0.5f
114
115 extern const Vector3 FRONT_TOP_LEFT;     ///< 0.0f, 0.0f, 1.0f
116 extern const Vector3 FRONT_TOP_CENTER;   ///< 0.5f, 0.0f, 1.0f
117 extern const Vector3 FRONT_TOP_RIGHT;    ///< 1.0f, 0.0f, 1.0f
118 extern const Vector3 FRONT_CENTER_LEFT;  ///< 0.0f, 0.5f, 1.0f
119 extern const Vector3 FRONT_CENTER;       ///< 0.5f, 0.5f, 1.0f
120 extern const Vector3 FRONT_CENTER_RIGHT; ///< 1.0f, 0.5f, 1.0f
121 extern const Vector3 FRONT_BOTTOM_LEFT;  ///< 0.0f, 1.0f, 1.0f
122 extern const Vector3 FRONT_BOTTOM_CENTER;///< 0.5f, 1.0f, 1.0f
123 extern const Vector3 FRONT_BOTTOM_RIGHT; ///< 1.0f, 1.0f, 1.0f
124 }
125
126
127 /**
128  * @brief Color Constants.
129  *
130  * Color is represented by the Vector4 class (see vector4.h).
131  */
132 namespace Color
133 {
134 extern const Vector4 BLACK;       ///< Pure black (0.0f, 0.0f, 0.0f, 1.0f);
135 extern const Vector4 WHITE;       ///< Pure white (1.0f, 1.0f, 1.0f, 1.0f);
136
137 extern const Vector4 RED;         ///< Pure red   (1.0f, 0.0f, 0.0f, 1.0f);
138 extern const Vector4 GREEN;       ///< Pure green (0.0f, 1.0f, 0.0f, 1.0f);
139 extern const Vector4 BLUE;        ///< Pure blue  (0.0f, 0.0f, 1.0f, 1.0f);
140
141 extern const Vector4 YELLOW;      ///< Pure yellow  (1.0f, 1.0f, 0.0f, 1.0f);
142 extern const Vector4 MAGENTA;     ///< Pure magenta (1.0f, 0.0f, 1.0f, 1.0f);
143 extern const Vector4 CYAN;        ///< Pure cyan    (0.0f, 1.0f, 1.0f, 1.0f);
144
145 extern const Vector4 TRANSPARENT; ///< Black transparent (0.0f, 0.0f, 0.0f, 0.0f);
146
147 } // namespace Color
148
149 /**
150  * @brief Math constants
151  */
152 namespace Math
153 {
154 extern const float MACHINE_EPSILON_0;      ///< Epsilon for values near zero
155 extern const float MACHINE_EPSILON_1;      ///< Epsilon for values near 1
156 extern const float MACHINE_EPSILON_10;     ///< Epsilon for values near 10
157 extern const float MACHINE_EPSILON_100;    ///< Epsilon for values near 100
158 extern const float MACHINE_EPSILON_1000;   ///< Epsilon for values near 1000
159 extern const float MACHINE_EPSILON_10000;  ///< Epsilon for values near 10000
160
161 // float is preferred to double for performance on ARM targets
162 const float PI   = static_cast<float>(M_PI);   ///< Constant representing PI
163 const float PI_2 = static_cast<float>(M_PI_2); ///< Constant representing PI/2
164 const float PI_4 = static_cast<float>(M_PI_4); ///< Constant representing PI/4
165
166 } // namespace Math
167
168 /**
169  * @brief String Constants
170  */
171 namespace String
172 {
173 extern const std::string EMPTY; ///< The empty string
174 }
175
176 } // namespace Dali
177
178 #endif // __DALI_CONSTANTS_H__