Added BufferMapper class

Used to map/unmap a buffer automatically and provide a RAII
exception-safe class


Former-commit-id: 2a4fd2e19ce3531639a86520876a3615846b27f4

include/Nazara/Utility/BufferMapper.hpp

@@ -0,0 +1,34 @@
+// Copyright (C) 2012 Jérôme Leclercq
+// This file is part of the "Nazara Engine - Utility module"
+// For conditions of distribution and use, see copyright notice in Config.hpp
+
+#pragma once
+
+#ifndef NAZARA_BUFFERMAPPER_HPP
+#define NAZARA_BUFFERMAPPER_HPP
+
+#include <Nazara/Utility/Enums.hpp>
+
+template<class T>
+class NzBufferMapper
+{
+	public:
+		NzBufferMapper(T* buffer, nzBufferAccess access, unsigned int offset = 0, unsigned int length = 0);
+		NzBufferMapper(T& buffer, nzBufferAccess access, unsigned int offset = 0, unsigned int length = 0);
+		NzBufferMapper(const T* buffer, nzBufferAccess access, unsigned int offset = 0, unsigned int length = 0);
+		NzBufferMapper(const T& buffer, nzBufferAccess access, unsigned int offset = 0, unsigned int length = 0);
+		~NzBufferMapper();
+
+		const T* GetBuffer() const;
+		void* GetPointer() const;
+
+		void Unmap();
+
+	private:
+		const T* m_buffer;
+		void* m_ptr;
+};
+
+#include <Nazara/Utility/BufferMapper.inl>
+
+#endif // NAZARA_BUFFERMAPPER_HPP

include/Nazara/Utility/BufferMapper.inl

@@ -0,0 +1,67 @@
+// Copyright (C) 2012 Jérôme Leclercq
+// This file is part of the "Nazara Engine - Core module"
+// For conditions of distribution and use, see copyright notice in Config.hpp
+
+// http://www.easyrgb.com/index.php?X=MATH
+
+#include <Nazara/Utility/BufferMapper.hpp>
+#include <Nazara/Core/Error.hpp>
+#include <Nazara/Core/Debug.hpp>
+
+template<typename T>
+NzBufferMapper<T>::NzBufferMapper(T* buffer, nzBufferAccess access, unsigned int offset, unsigned int length) :
+m_buffer(buffer)
+{
+	m_ptr = buffer->Map(access, offset, length);
+	if (!m_ptr)
+		NazaraError("Failed to map buffer"); ///TODO: Unexpected
+}
+
+template<typename T>
+NzBufferMapper<T>::NzBufferMapper(T& buffer, nzBufferAccess access, unsigned int offset, unsigned int length) :
+NzBufferMapper(&buffer, access, offset, length)
+{
+}
+
+template<typename T>
+NzBufferMapper<T>::NzBufferMapper(const T* buffer, nzBufferAccess access, unsigned int offset, unsigned int length) :
+m_buffer(buffer)
+{
+	m_ptr = buffer->Map(access, offset, length);
+	if (!m_ptr)
+		NazaraError("Failed to map buffer"); ///TODO: Unexpected
+}
+
+template<typename T>
+NzBufferMapper<T>::NzBufferMapper(const T& buffer, nzBufferAccess access, unsigned int offset, unsigned int length) :
+NzBufferMapper(&buffer, access, offset, length)
+{
+}
+
+template<typename T>
+NzBufferMapper<T>::~NzBufferMapper()
+{
+	if (m_buffer)
+		m_buffer->Unmap();
+}
+
+template<typename T>
+const T* NzBufferMapper<T>::GetBuffer() const
+{
+	return m_buffer;
+}
+
+template<typename T>
+void* NzBufferMapper<T>::GetPointer() const
+{
+	return m_ptr;
+}
+
+template<typename T>
+void NzBufferMapper<T>::Unmap()
+{
+	m_buffer->Unmap();
+	m_buffer = nullptr;
+}
+
+#include <Nazara/Core/DebugOff.hpp>