vec4.h
1 /*
2 ** UICore
3 ** Copyright (c) 1997-2015 The UICore Team
4 **
5 ** This software is provided 'as-is', without any express or implied
6 ** warranty. In no event will the authors be held liable for any damages
7 ** arising from the use of this software.
8 **
9 ** Permission is granted to anyone to use this software for any purpose,
10 ** including commercial applications, and to alter it and redistribute it
11 ** freely, subject to the following restrictions:
12 **
13 ** 1. The origin of this software must not be misrepresented; you must not
14 ** claim that you wrote the original software. If you use this software
15 ** in a product, an acknowledgment in the product documentation would be
16 ** appreciated but is not required.
17 ** 2. Altered source versions must be plainly marked as such, and must not be
18 ** misrepresented as being the original software.
19 ** 3. This notice may not be removed or altered from any source distribution.
20 **
21 ** Note: Some of the libraries UICore may link to may have additional
22 ** requirements or restrictions.
23 **
24 ** File Author(s):
25 **
26 ** Magnus Norddahl
27 ** Mark Page
28 ** Harry Storbacka
29 */
30 
31 #pragma once
32 
33 #include <cmath>
34 #include "vec2.h"
35 #include "vec3.h"
36 
37 namespace uicore
38 {
39  template<typename Type>
40  class Vec2;
41 
42  template<typename Type>
43  class Vec3;
44 
45  template<typename Type>
46  class Vec4;
47 
48  template<typename Type>
49  class Mat2;
50 
51  template<typename Type>
52  class Mat3;
53 
54  template<typename Type>
55  class Mat4;
56 
57  template<typename Type>
58  class Sizex;
59 
60  template<typename Type>
61  class Pointx;
62 
68  template<typename Type>
69  class Vec4
70  {
71  public:
72  typedef Type datatype;
73 
74  Type x;
75  Type y;
76  Type z;
77  Type w;
78 
79  Vec4() : x(0), y(0), z(0), w(0) { }
80  explicit Vec4(const Type &scalar) : x(scalar), y(scalar), z(scalar), w(scalar) { }
81  explicit Vec4(const Vec2<Type> &copy, const Type &p3, const Type &p4) { x = copy.x; y = copy.y; z = p3; w = p4; }
82  explicit Vec4(const Vec2<Type> &copy, const Vec2<Type> &copy34) { x = copy.x; y = copy.y; z = copy34.x; w = copy34.y; }
83  explicit Vec4(const Vec3<Type> &copy, const Type &p4) { x = copy.x; y = copy.y; z = copy.z; w = p4; }
84  explicit Vec4(const Type &p1, const Type &p2, const Type &p3, const Type &p4) : x(p1), y(p2), z(p3), w(p4) { }
85  explicit Vec4(const Type &p1, const Type &p2, const Vec2<Type> &copy34) : x(p1), y(p2), z(copy34.x), w(copy34.y) { }
86  explicit Vec4(const Type *array_xyzw) : x(array_xyzw[0]), y(array_xyzw[1]), z(array_xyzw[2]), w(array_xyzw[3]) { }
87 
93  static Vec4<Type> normalize3(const Vec4<Type> &vector);
94 
100  static Vec4<Type> normalize4(const Vec4<Type> &vector);
101 
109  static Type dot3(const Vec4<Type>& vector1, const Vec4<Type>& vector2) { return vector1.x*vector2.x + vector1.y*vector2.y + vector1.z*vector2.z; }
110 
118  static Type dot4(const Vec4<Type>& vector1, const Vec4<Type>& vector2) { return vector1.x*vector2.x + vector1.y*vector2.y + vector1.z*vector2.z + vector1.w*vector2.w; }
119 
125  static Vec4<Type> cross3(const Vec4<Type>& vector1, const Vec4<Type>& vector2);
126 
136  static Vec4<Type> rotate3(const Vec4<Type>& vector, Type angle, const Vec4<Type>& axis);
137 
144  static Vec4<Type> round(const Vec4<Type>& vector);
145 
151  static bool is_equal(const Vec4<Type> &first, const Vec4<Type> &second, Type epsilon)
152  {
153  Type diff_x = second.x - first.x; Type diff_y = second.y - first.y; Type diff_z = second.z - first.z; Type diff_w = second.w - first.w;
154  return (diff_x >= -epsilon && diff_x <= epsilon && diff_y >= -epsilon && diff_y <= epsilon && diff_z >= -epsilon && diff_z <= epsilon && diff_w >= -epsilon && diff_w <= epsilon);
155  }
156 
157  void set_xy(const Vec2<Type> &new_v) { x = new_v.x; y = new_v.y; }
158  void set_zw(const Vec2<Type> &new_v) { z = new_v.x; w = new_v.y; }
159 
165  Type length3() const;
166 
172  Type length4() const;
173 
179 
185 
192  Type dot3(const Vec4<Type>& vector) const { return x*vector.x + y*vector.y + z*vector.z; }
193 
200  Type dot4(const Vec4<Type>& vector) const { return x*vector.x + y*vector.y + z*vector.z + w*vector.w; }
201 
207  Type angle3(const Vec4<Type>& vector) const;
208 
214  Type distance3(const Vec4<Type>& vector) const;
215 
221  Type distance4(const Vec4<Type>& vector) const;
222 
229  Vec4<Type> &cross3(const Vec4<Type>& vector);
230 
239  Vec4<Type> &rotate3(Type angle, const Vec4<Type>& axis);
240 
246  Vec4<Type> &round();
247 
252  bool is_equal(const Vec4<Type> &other, Type epsilon) const { return Vec4<Type>::is_equal(*this, other, epsilon); }
253 
255  void operator += (const Vec4<Type>& vector) { x += vector.x; y += vector.y; z += vector.z; w += vector.w; }
256 
258  void operator += (Type value) { x += value; y += value; z += value; w += value; }
259 
261  void operator -= (const Vec4<Type>& vector) { x -= vector.x; y -= vector.y; z -= vector.z; w -= vector.w; }
262 
264  void operator -= (Type value) { x -= value; y -= value; z -= value; w -= value; }
265 
267  Vec4<Type> operator - () const { return Vec4<Type>(-x, -y, -z, -w); }
268 
270  void operator *= (const Vec4<Type>& vector) { x *= vector.x; y *= vector.y; z *= vector.z; w *= vector.w; }
271 
273  void operator *= (Type value) { x *= value; y *= value; z *= value; w *= value; }
274 
276  void operator /= (const Vec4<Type>& vector) { x /= vector.x; y /= vector.y; z /= vector.z; w /= vector.w; }
277 
279  void operator /= (Type value) { x /= value; y /= value; z /= value; w /= value; }
280 
282  Vec4<Type> &operator = (const Vec4<Type>& vector) { x = vector.x; y = vector.y; z = vector.z; w = vector.w; return *this; }
283 
285  bool operator == (const Vec4<Type>& vector) const { return ((x == vector.x) && (y == vector.y) && (z == vector.z) && (w == vector.w)); }
286 
288  bool operator != (const Vec4<Type>& vector) const { return ((x != vector.x) || (y != vector.y) || (z != vector.z) || (w != vector.w)); }
289 
291  bool operator < (const Vec4<Type>& vector) const { return w < vector.w || (w == vector.w && (z < vector.z || (z == vector.z && (y < vector.y || (y == vector.y && x < vector.x))))); }
292  };
293 
295  template<typename Type>
296  Vec4<Type> operator + (const Vec4<Type>& v1, const Vec4<Type>& v2) { return Vec4<Type>(v1.x + v2.x, v1.y + v2.y, v1.z + v2.z, v1.w + v2.w); }
297 
299  template<typename Type>
300  Vec4<Type> operator + (Type s, const Vec4<Type>& v) { return Vec4<Type>(s + v.x, s + v.y, s + v.z, s + v.w); }
301 
303  template<typename Type>
304  Vec4<Type> operator + (const Vec4<Type>& v, Type s) { return Vec4<Type>(v.x + s, v.y + s, v.z + s, v.w + s); }
305 
307  template<typename Type>
308  Vec4<Type> operator - (const Vec4<Type>& v1, const Vec4<Type>& v2) { return Vec4<Type>(v1.x - v2.x, v1.y - v2.y, v1.z - v2.z, v1.w - v2.w); }
309 
311  template<typename Type>
312  Vec4<Type> operator - (Type s, const Vec4<Type>& v) { return Vec4<Type>(s - v.x, s - v.y, s - v.z, s - v.w); }
313 
315  template<typename Type>
316  Vec4<Type> operator - (const Vec4<Type>& v, Type s) { return Vec4<Type>(v.x - s, v.y - s, v.z - s, v.w - s); }
317 
319  template<typename Type>
320  Vec4<Type> operator * (const Vec4<Type>& v1, const Vec4<Type>& v2) { return Vec4<Type>(v1.x * v2.x, v1.y * v2.y, v1.z * v2.z, v1.w * v2.w); }
321 
323  template<typename Type>
324  Vec4<Type> operator * (Type s, const Vec4<Type>& v) { return Vec4<Type>(s * v.x, s * v.y, s * v.z, s * v.w); }
325 
327  template<typename Type>
328  Vec4<Type> operator * (const Vec4<Type>& v, Type s) { return Vec4<Type>(v.x * s, v.y * s, v.z * s, v.w * s); }
329 
331  template<typename Type>
332  Vec4<Type> operator / (const Vec4<Type>& v1, const Vec4<Type>& v2) { return Vec4<Type>(v1.x / v2.x, v1.y / v2.y, v1.z / v2.z, v1.w / v2.w); }
333 
335  template<typename Type>
336  Vec4<Type> operator / (Type s, const Vec4<Type>& v) { return Vec4<Type>(s / v.x, s / v.y, s / v.z, s / v.w); }
337 
339  template<typename Type>
340  Vec4<Type> operator / (const Vec4<Type>& v, Type s) { return Vec4<Type>(v.x / s, v.y / s, v.z / s, v.w / s); }
341 
342  template<typename Type>
343  Vec4<Type> operator * (const Vec4<Type>& v, const Mat4<Type>& matrix)
344  {
345  return Vec4<Type>(
346  matrix[0 * 4 + 0] * v.x + matrix[0 * 4 + 1] * v.y + matrix[0 * 4 + 2] * v.z + matrix[0 * 4 + 3] * v.w,
347  matrix[1 * 4 + 0] * v.x + matrix[1 * 4 + 1] * v.y + matrix[1 * 4 + 2] * v.z + matrix[1 * 4 + 3] * v.w,
348  matrix[2 * 4 + 0] * v.x + matrix[2 * 4 + 1] * v.y + matrix[2 * 4 + 2] * v.z + matrix[2 * 4 + 3] * v.w,
349  matrix[3 * 4 + 0] * v.x + matrix[3 * 4 + 1] * v.y + matrix[3 * 4 + 2] * v.z + matrix[3 * 4 + 3] * v.w);
350  }
351 
352  template<typename Type>
353  Vec4<Type> operator * (const Mat4<Type>& matrix, const Vec4<Type>& v)
354  {
355  return Vec4<Type>(
356  matrix[0 * 4 + 0] * v.x + matrix[1 * 4 + 0] * v.y + matrix[2 * 4 + 0] * v.z + matrix[3 * 4 + 0] * v.w,
357  matrix[0 * 4 + 1] * v.x + matrix[1 * 4 + 1] * v.y + matrix[2 * 4 + 1] * v.z + matrix[3 * 4 + 1] * v.w,
358  matrix[0 * 4 + 2] * v.x + matrix[1 * 4 + 2] * v.y + matrix[2 * 4 + 2] * v.z + matrix[3 * 4 + 2] * v.w,
359  matrix[0 * 4 + 3] * v.x + matrix[1 * 4 + 3] * v.y + matrix[2 * 4 + 3] * v.z + matrix[3 * 4 + 3] * v.w);
360  }
361 
362  template<typename Type>
363  inline Type Vec4<Type>::length3() const { return (Type)floor(sqrt(float(x*x + y*y + z*z)) + 0.5f); }
364 
365  template<>
366  inline double Vec4<double>::length3() const { return sqrt(x*x + y*y + z*z); }
367 
368  template<>
369  inline float Vec4<float>::length3() const { return sqrt(x*x + y*y + z*z); }
370 
371  template<typename Type>
372  inline Type Vec4<Type>::length4() const { return (Type)floor(sqrt(float(x*x + y*y + z*z + w*w)) + 0.5f); }
373 
374  template<>
375  inline double Vec4<double>::length4() const { return sqrt(x*x + y*y + z*z + w*w); }
376 
377  template<>
378  inline float Vec4<float>::length4() const { return sqrt(x*x + y*y + z*z + w*w); }
379 
381  typedef Vec4<char> Vec4b;
385  typedef Vec4<int> Vec4i;
388 }
2D vector
Definition: line.h:43
Type x
Definition: vec3.h:74
3D vector
Definition: line_ray.h:43
Type x
Definition: vec4.h:74
Vec4< Type > & operator=(const Vec4< Type > &vector)
= operator.
Definition: vec4.h:282
Vec4(const Vec2< Type > &copy, const Vec2< Type > &copy34)
Definition: vec4.h:82
Type x
Definition: vec2.h:75
static Vec4< Type > cross3(const Vec4< Type > &vector1, const Vec4< Type > &vector2)
Calculate the cross product between two vectors (not taking into account the w ordinate).
void operator+=(const Vec4< Type > &vector)
+= operator.
Definition: vec4.h:255
*Type length3() const
Returns the length (magnitude) of this vector (not taking into account the w ordinate).
Definition: vec4.h:363
Vec2< Type > operator-(const Vec2< Type > &v1, const Vec2< Type > &v2)
operator.
Definition: vec2.h:272
static Type dot4(const Vec4< Type > &vector1, const Vec4< Type > &vector2)
Dot products between two vectors (taking into account the w ordinate).
Definition: vec4.h:118
Vec4< Type > & round()
Rounds all components on this vector.
static Vec4< Type > rotate3(const Vec4< Type > &vector, Type angle, const Vec4< Type > &axis)
Rotate a vector around an axis. Same as glRotate[f|d](angle, a);.
Vec4(const Type &scalar)
Definition: vec4.h:80
Vec2< Type > operator+(const Vec2< Type > &v1, const Vec2< Type > &v2)
operator.
Definition: vec2.h:260
Type z
Definition: vec3.h:76
*Type length4() const
Returns the length (magnitude) of this vector (taking into account the w ordinate).
Definition: vec4.h:372
Vec4(const Type &p1, const Type &p2, const Type &p3, const Type &p4)
Definition: vec4.h:84
Vec4(const Type &p1, const Type &p2, const Vec2< Type > &copy34)
Definition: vec4.h:85
void set_zw(const Vec2< Type > &new_v)
Definition: vec4.h:158
Type datatype
Definition: vec4.h:72
Type y
Definition: vec2.h:76
static bool is_equal(const Vec4< Type > &first, const Vec4< Type > &second, Type epsilon)
Returns true if equal within the bounds of an epsilon.
Definition: vec4.h:151
static Type dot3(const Vec4< Type > &vector1, const Vec4< Type > &vector2)
Dot products between two vectors (not taking into account the w ordinate).
Definition: vec4.h:109
Vec4< Type > & normalize3()
Normalizes this vector (not taking into account the w ordinate)
Vec4(const Vec2< Type > &copy, const Type &p3, const Type &p4)
Definition: vec4.h:81
Type y
Definition: vec4.h:75
Vec4()
Definition: vec4.h:79
Type w
Definition: vec4.h:77
Vec2< Type > operator/(const Vec2< Type > &v1, const Vec2< Type > &v2)
/ operator.
Definition: vec2.h:296
Type distance3(const Vec4< Type > &vector) const
Calculate the distance between this vector and an other vector (not taking into account the w ordinat...
Type dot3(const Vec4< Type > &vector) const
Dot products this vector with an other vector (not taking into account the w ordinate).
Definition: vec4.h:192
bool operator!=(const Vec4< Type > &vector) const
!= operator.
Definition: vec4.h:288
Vec4(const Vec3< Type > &copy, const Type &p4)
Definition: vec4.h:83
Vec4< Type > operator-() const
operator.
Definition: vec4.h:267
Type dot4(const Vec4< Type > &vector) const
Dot products this vector with an other vector (taking into account the w ordinate).
Definition: vec4.h:200
Vec2< Type > operator*(const Vec2< Type > &v1, const Vec2< Type > &v2)
operator.
Definition: vec2.h:284
Type y
Definition: vec3.h:75
Type z
Definition: vec4.h:76
void operator*=(const Vec4< Type > &vector)
*= operator.
Definition: vec4.h:270
void set_xy(const Vec2< Type > &new_v)
Definition: vec4.h:157
Type angle3(const Vec4< Type > &vector) const
Calculate the angle between this vector and an other vector (not taking into account the w ordinate)...
Vec4< Type > & normalize4()
Normalizes this vector (taking into account the w ordinate)
bool is_equal(const Vec4< Type > &other, Type epsilon) const
Returns true if equal within the bounds of an epsilon.
Definition: vec4.h:252
Definition: Application/application.h:35
void operator/=(const Vec4< Type > &vector)
/= operator.
Definition: vec4.h:276
4D matrix
Definition: mat2.h:47
4D vector
Definition: size.h:44
Vec4(const Type *array_xyzw)
Definition: vec4.h:86
void operator-=(const Vec4< Type > &vector)
-= operator.
Definition: vec4.h:261
Type distance4(const Vec4< Type > &vector) const
Calculate the distance between this vector and an other vector (taking into account the w ordinate)...
bool operator==(const Vec4< Type > &vector) const
== operator.
Definition: vec4.h:285