Moved all headers from 'PolyVoxCore' to 'PolyVox', as we no longer have the core/util distinction.

include/PolyVox/Impl/Utility.h

@@ -0,0 +1,93 @@
+/*******************************************************************************
+Copyright (c) 2005-2009 David Williams
+
+This software is provided 'as-is', without any express or implied
+warranty. In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+    1. The origin of this software must not be misrepresented; you must not
+    claim that you wrote the original software. If you use this software
+    in a product, an acknowledgment in the product documentation would be
+    appreciated but is not required.
+
+    2. Altered source versions must be plainly marked as such, and must not be
+    misrepresented as being the original software.
+
+    3. This notice may not be removed or altered from any source
+    distribution. 	
+*******************************************************************************/
+
+#ifndef __PolyVox_Utility_H__
+#define __PolyVox_Utility_H__
+
+#include "PolyVox/Impl/TypeDef.h"
+
+#include <cstdint>
+
+namespace PolyVox
+{
+	inline bool isPowerOf2(uint32_t uInput)
+	{
+		if (uInput == 0)
+			return false;
+		else
+			return ((uInput & (uInput - 1)) == 0);
+	}
+
+	//Note: this function only works for inputs which are a power of two and not zero
+	//If this is not the case then the output is undefined.
+	inline uint8_t logBase2(uint32_t uInput)
+	{
+		//Release mode validation
+		if (uInput == 0)
+		{
+			POLYVOX_THROW(std::invalid_argument, "Cannot compute the log of zero.");
+		}
+		if (!isPowerOf2(uInput))
+		{
+			POLYVOX_THROW(std::invalid_argument, "Input must be a power of two in order to compute the log.");
+		}
+
+		uint32_t uResult = 0;
+		while ((uInput >> uResult) != 0)
+		{
+			++uResult;
+		}
+		return static_cast<uint8_t>(uResult - 1);
+	}
+
+	// http://graphics.stanford.edu/~seander/bithacks.html#RoundUpPowerOf2
+	inline uint32_t upperPowerOfTwo(uint32_t v)
+	{
+		v--;
+		v |= v >> 1;
+		v |= v >> 2;
+		v |= v >> 4;
+		v |= v >> 8;
+		v |= v >> 16;
+		v++;
+		return v;
+	}
+
+	inline int32_t roundTowardsNegInf(float r)
+	{
+		return (r >= 0.0) ? static_cast<int32_t>(r) : static_cast<int32_t>(r - 1.0f);
+	}
+
+	inline int32_t roundToNearestInteger(float r)
+	{
+		return (r >= 0.0) ? static_cast<int32_t>(r + 0.5f) : static_cast<int32_t>(r - 0.5f);
+	}
+
+	template <typename Type>
+	inline Type clamp(const Type& value, const Type& low, const Type& high)
+	{
+		return (std::min)(high, (std::max)(low, value));
+	}
+}
+
+#endif