aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/libraries/irrlicht-1.8.1/include/dimension2d.h
blob: 13addb4ba59a0d7366c84304d153eeada01b70c5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
// Copyright (C) 2002-2012 Nikolaus Gebhardt
// This file is part of the "Irrlicht Engine".
// For conditions of distribution and use, see copyright notice in irrlicht.h

#ifndef __IRR_DIMENSION2D_H_INCLUDED__
#define __IRR_DIMENSION2D_H_INCLUDED__

#include "irrTypes.h"
#include "irrMath.h" // for irr::core::equals()

namespace irr
{
namespace core
{
	template <class T>
	class vector2d;

	//! Specifies a 2 dimensional size.
	template <class T>
	class dimension2d
	{
		public:
			//! Default constructor for empty dimension
			dimension2d() : Width(0), Height(0) {}
			//! Constructor with width and height
			dimension2d(const T& width, const T& height)
				: Width(width), Height(height) {}

			dimension2d(const vector2d<T>& other); // Defined in vector2d.h

			//! Use this constructor only where you are sure that the conversion is valid.
			template <class U>
			explicit dimension2d(const dimension2d<U>& other) :
				Width((T)other.Width), Height((T)other.Height) { }

			template <class U>
			dimension2d<T>& operator=(const dimension2d<U>& other)
			{
				Width = (T) other.Width;
				Height = (T) other.Height;
				return *this;
			}


			//! Equality operator
			bool operator==(const dimension2d<T>& other) const
			{
				return core::equals(Width, other.Width) &&
						core::equals(Height, other.Height);
			}

			//! Inequality operator
			bool operator!=(const dimension2d<T>& other) const
			{
				return ! (*this == other);
			}

			bool operator==(const vector2d<T>& other) const;  // Defined in vector2d.h

			bool operator!=(const vector2d<T>& other) const
			{
				return !(*this == other);
			}

			//! Set to new values
			dimension2d<T>& set(const T& width, const T& height)
			{
				Width = width;
				Height = height;
				return *this;
			}

			//! Divide width and height by scalar
			dimension2d<T>& operator/=(const T& scale)
			{
				Width /= scale;
				Height /= scale;
				return *this;
			}

			//! Divide width and height by scalar
			dimension2d<T> operator/(const T& scale) const
			{
				return dimension2d<T>(Width/scale, Height/scale);
			}

			//! Multiply width and height by scalar
			dimension2d<T>& operator*=(const T& scale)
			{
				Width *= scale;
				Height *= scale;
				return *this;
			}

			//! Multiply width and height by scalar
			dimension2d<T> operator*(const T& scale) const
			{
				return dimension2d<T>(Width*scale, Height*scale);
			}

			//! Add another dimension to this one.
			dimension2d<T>& operator+=(const dimension2d<T>& other)
			{
				Width += other.Width;
				Height += other.Height;
				return *this;
			}

			//! Add two dimensions
			dimension2d<T> operator+(const dimension2d<T>& other) const
			{
				return dimension2d<T>(Width+other.Width, Height+other.Height);
			}

			//! Subtract a dimension from this one
			dimension2d<T>& operator-=(const dimension2d<T>& other)
			{
				Width -= other.Width;
				Height -= other.Height;
				return *this;
			}

			//! Subtract one dimension from another
			dimension2d<T> operator-(const dimension2d<T>& other) const
			{
				return dimension2d<T>(Width-other.Width, Height-other.Height);
			}

			//! Get area
			T getArea() const
			{
				return Width*Height;
			}

			//! Get the optimal size according to some properties
			/** This is a function often used for texture dimension
			calculations. The function returns the next larger or
			smaller dimension which is a power-of-two dimension
			(2^n,2^m) and/or square (Width=Height).
			\param requirePowerOfTwo Forces the result to use only
			powers of two as values.
			\param requireSquare Makes width==height in the result
			\param larger Choose whether the result is larger or
			smaller than the current dimension. If one dimension
			need not be changed it is kept with any value of larger.
			\param maxValue Maximum texturesize. if value > 0 size is
			clamped to maxValue
			\return The optimal dimension under the given
			constraints. */
			dimension2d<T> getOptimalSize(
					bool requirePowerOfTwo=true,
					bool requireSquare=false,
					bool larger=true,
					u32 maxValue = 0) const
			{
				u32 i=1;
				u32 j=1;
				if (requirePowerOfTwo)
				{
					while (i<(u32)Width)
						i<<=1;
					if (!larger && i!=1 && i!=(u32)Width)
						i>>=1;
					while (j<(u32)Height)
						j<<=1;
					if (!larger && j!=1 && j!=(u32)Height)
						j>>=1;
				}
				else
				{
					i=(u32)Width;
					j=(u32)Height;
				}

				if (requireSquare)
				{
					if ((larger && (i>j)) || (!larger && (i<j)))
						j=i;
					else
						i=j;
				}

				if ( maxValue > 0 && i > maxValue)
					i = maxValue;

				if ( maxValue > 0 && j > maxValue)
					j = maxValue;

				return dimension2d<T>((T)i,(T)j);
			}

			//! Get the interpolated dimension
			/** \param other Other dimension to interpolate with.
			\param d Value between 0.0f and 1.0f.
			\return Interpolated dimension. */
			dimension2d<T> getInterpolated(const dimension2d<T>& other, f32 d) const
			{
				f32 inv = (1.0f - d);
				return dimension2d<T>( (T)(other.Width*inv + Width*d), (T)(other.Height*inv + Height*d));
			}


			//! Width of the dimension.
			T Width;
			//! Height of the dimension.
			T Height;
	};

	//! Typedef for an f32 dimension.
	typedef dimension2d<f32> dimension2df;
	//! Typedef for an unsigned integer dimension.
	typedef dimension2d<u32> dimension2du;

	//! Typedef for an integer dimension.
	/** There are few cases where negative dimensions make sense. Please consider using
		dimension2du instead. */
	typedef dimension2d<s32> dimension2di;


} // end namespace core
} // end namespace irr

#endif