corrected include guards, added comments

include/ACGL/ACGL.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_HH
-#define ACGL_HH
+#ifndef ACGL_ACGL_HH
+#define ACGL_ACGL_HH
 
 /*
  * Include this in all ACGL (header)-files. It will include stuff that is used in
@@ -12,6 +12,8 @@
    * the used datatypes
    * macros and defines used at compile-time
    * logging
+ *
+ * Also the librarys init function is defined here.
  */
 
 #include <ACGL/Base/CompileTimeSettings.hh>
@@ -21,9 +23,15 @@
 namespace ACGL
 {
 
+/*
+ * This should get called as soon as a valid OpenGL context exists,
+ * it will init glew (if used).
+ * Call this before calling any OpenGL functions or OpenGL related
+ * ACGL stuff.
+ */
 void init(void);
     
 };
 
-#endif // ACGL_HH
+#endif // ACGL_ACGL_HH
 

include/ACGL/Base/CompileTimeSettings.hh

@@ -3,11 +3,11 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef COMPILETIMESETTINGS_HH
-#define COMPILETIMESETTINGS_HH
+#ifndef ACGL_BASE_COMPILETIMESETTINGS_HH
+#define ACGL_BASE_COMPILETIMESETTINGS_HH
 
 /*
- * OpenGL error checking
+ * OpenGL error checking defines
  *
  * By default, only critical errors will get checked in release build
  * and critical&common in debug build.
@@ -71,5 +71,5 @@
 
 
 
-#endif // COMPILETIMESETTINGS_HH
+#endif // ACGL_BASE_COMPILETIMESETTINGS_HH
 

include/ACGL/Base/FileHelpers.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_UTILS_FILEHELPERS_HH
-#define ACGL_UTILS_FILEHELPERS_HH
+#ifndef ACGL_BASE_FILEHELPERS_HH
+#define ACGL_BASE_FILEHELPERS_HH
 
 #include <string>
 #include <vector>

include/ACGL/Base/FileOperations.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_UTILS_FILEOPERATIONS_HH
-#define ACGL_UTILS_FILEOPERATIONS_HH
+#ifndef ACGL_BASE_FILEOPERATIONS_HH
+#define ACGL_BASE_FILEOPERATIONS_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -21,4 +21,4 @@ namespace FileOperations
 } // Base
 } // ACGL
 
-#endif
+#endif // ACGL_BASE_FILEOPERATIONS_HH

include/ACGL/Base/Settings.hh

@@ -6,6 +6,11 @@
 #ifndef ACGL_BASE_FRAMEWORKSETTINGS_HH
 #define ACGL_BASE_FRAMEWORKSETTINGS_HH
 
+/*
+ * This class manages a few runtime settings for the application which can change the
+ * behavior of the ACGL library.
+ */
+
 #include <ACGL/ACGL.hh>
 #include <ACGL/Base/Singleton.hh>
 #include <string>

include/ACGL/Base/Singleton.hh

@@ -3,8 +3,13 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef SINGLETON_HH
-#define SINGLETON_HH
+#ifndef ACGL_BASE_SINGLETON_HH
+#define ACGL_BASE_SINGLETON_HH
+
+/*
+ * A very simple Singleton as a template.
+ * Not thread save etc.
+ */
 
 #include <ACGL/ACGL.hh>
 #include <tr1/memory>

include/ACGL/Base/StringOperations.hh

@@ -3,8 +3,13 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_UTILS_STRINGOPERATIONS_HH
-#define ACGL_UTILS_STRINGOPERATIONS_HH
+#ifndef ACGL_BASE_STRINGOPERATIONS_HH
+#define ACGL_BASE_STRINGOPERATIONS_HH
+
+/*
+ * Provides a set of primitive functions which operate on std::strings which are
+ * used at multiple points within the library.
+ */
 
 #include <ACGL/ACGL.hh>
 
@@ -43,4 +48,4 @@ namespace StringOperations
 } // Base
 } // ACGL
 
-#endif // ACGL_UTILS_STRINGOPERATIONS_HH
+#endif // ACGL_BASE_STRINGOPERATIONS_HH

include/ACGL/Math/Constants.hh

@@ -3,8 +3,14 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef AE_CONSTANTS_H
-#define AE_CONSTANTS_H
+#ifndef ACGL_MATH_CONSTANTS_HH
+#define ACGL_MATH_CONSTANTS_HH
+
+/*
+ * Some mathmatical constants, for example readable degree to rad conversion.
+ *
+ * DON'T INCLUDE THIS DIRECTLY! Include <ACGL/Math.hh> instead!
+ */
 
 #include <ACGL/ACGL.hh>
 
@@ -16,10 +22,10 @@ namespace Math{
 namespace Constants{
 
 //some important constants
-const float   INF_FLOAT = std::numeric_limits<float>::infinity();
+const float   INF_FLOAT  = std::numeric_limits<float>::infinity();
 const double  INF_DOUBLE = std::numeric_limits<double>::infinity();
-const int_t   INF_INT = std::numeric_limits<int_t>::infinity();
-const short_t INF_SHORT = std::numeric_limits<short_t>::infinity();
+const int_t   INF_INT    = std::numeric_limits<int_t>::infinity();
+const short_t INF_SHORT  = std::numeric_limits<short_t>::infinity();
 
 template<typename T> inline T INF(void) { return T(); }
 template<> inline float   INF<float>   (void) { return INF_FLOAT; }
@@ -67,4 +73,4 @@ template<> inline double RED_TO_DEG<double>(void) { return RAD_TO_DEG_DOUBLE; }
 } // Math
 } // ACGL
 
-#endif // AECONSTANTS_H
+#endif // ACGL_MATH_CONSTANTS_HH

include/ACGL/Math/Functions.hh

@@ -6,12 +6,22 @@
 #ifndef ACGL_MATH_FUNCTIONS_HH
 #define ACGL_MATH_FUNCTIONS_HH
 
+/*
+ * Some basic math functions.
+ *
+ * DON'T INCLUDE THIS DIRECTLY! Include <ACGL/Math.hh> instead!
+ */
+
 #include <ACGL/ACGL.hh>
 #include <ACGL/Math/Constants.hh>
 
 #include <cmath>
 #include <limits>
 
+/*
+ * Swizzling has to be defined before the glm.hpp gets first included, no not forget
+ * this, you should never include glm yourself, but include always our ACGL/Math.hh!
+ */
 #define GLM_SWIZZL
 #include <glm/glm.hpp>
 
@@ -120,4 +130,4 @@ inline glm::mat3 normalMatrix(const glm::mat4& matrix)
 } // Math
 } // ACGL
 
-#endif
+#endif // ACGL_MATH_FUNCTIONS_HH

include/ACGL/Math/Math.hh

@@ -13,6 +13,9 @@
  * This library has the advantage that it was designed to mimic the
  * syntax of GLSL for datatypes (vectors, matrices etc.) as well as functions.
  * It also supports swizzling similar to GLSL.
+ *
+ * Swizzling has to be defined before the glm.hpp gets first included, no not forget
+ * this, you should never include glm yourself, but include always our ACGL/Math.hh!
  */
 #define GLM_SWIZZL
 #include <glm/glm.hpp>
@@ -21,4 +24,4 @@
 #include <ACGL/Math/Constants.hh>
 #include <ACGL/Math/Functions.hh>
 
-#endif
+#endif // ACGL_MATH_HH

include/ACGL/OpenGL/Controller.hh

@@ -3,8 +3,13 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_CONTROLLER_HH
-#define ACGL_CONTROLLER_HH
+#ifndef ACGL_OPENGL_CONTROLLER_HH
+#define ACGL_OPENGL_CONTROLLER_HH
+
+/*
+ * A shortcut to include all controller of OpenGL objects.
+ * Will also include the objects themself!
+ */
 
 #include <ACGL/ACGL.hh>
 
@@ -24,4 +29,4 @@
 #include <ACGL/OpenGL/Controller/ArrayBufferControl.hh>
 #include <ACGL/OpenGL/Controller/ElementArrayBufferControl.hh>
 
-#endif // ACGL_CONTROLLER_HH
+#endif // ACGL_OPENGL_CONTROLLER_HH

include/ACGL/OpenGL/Controller/ArrayBufferControl.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_ARRAYBUFFERCONTROL_HH
-#define ACGL_RESOURCE_ARRAYBUFFERCONTROL_HH
+#ifndef ACGL_OPENGL_CONTROLLER_ARRAYBUFFERCONTROL_HH
+#define ACGL_OPENGL_CONTROLLER_ARRAYBUFFERCONTROL_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -88,4 +88,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_ARRAYBUFFERCONTROL_HH

include/ACGL/OpenGL/Controller/ElementArrayBufferControl.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_ELEMENTARRAYBUFFERCONTROL_HH
-#define ACGL_RESOURCE_ELEMENTARRAYBUFFERCONTROL_HH
+#ifndef ACGL_OPENGL_CONTROLLER_ELEMENTARRAYBUFFERCONTROL_HH
+#define ACGL_OPENGL_CONTROLLER_ELEMENTARRAYBUFFERCONTROL_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -78,4 +78,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_ELEMENTARRAYBUFFERCONTROL_HH

include/ACGL/OpenGL/Controller/FrameBufferControl.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_FRAMEBUFFERCONTROL_HH
-#define ACGL_RESOURCE_FRAMEBUFFERCONTROL_HH
+#ifndef ACGL_OPENGL_CONTROLLER_FRAMEBUFFERCONTROL_HH
+#define ACGL_OPENGL_CONTROLLER_FRAMEBUFFERCONTROL_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -76,4 +76,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_FRAMEBUFFERCONTROL_HH

include/ACGL/OpenGL/Controller/RenderBufferControl.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_RENDERBUFFERCONTROL_HH
-#define ACGL_RESOURCE_RENDERBUFFERCONTROL_HH
+#ifndef ACGL_OPENGL_CONTROLLER_RENDERBUFFERCONTROL_HH
+#define ACGL_OPENGL_CONTROLLER_RENDERBUFFERCONTROL_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -59,4 +59,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_RENDERBUFFERCONTROL_HH

include/ACGL/OpenGL/Controller/ShaderControlFile.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_SHADERCONTROLFILE_HH
-#define ACGL_RESOURCE_SHADERCONTROLFILE_HH
+#ifndef ACGL_OPENGL_CONTROLLER_SHADERCONTROLFILE_HH
+#define ACGL_OPENGL_CONTROLLER_SHADERCONTROLFILE_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -51,4 +51,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_SHADERCONTROLFILE_HH

include/ACGL/OpenGL/Controller/ShaderProgramControlAutoFiles.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_SHADERPROGRAMCONTROLAUTOFILES_HH
-#define ACGL_RESOURCE_SHADERPROGRAMCONTROLAUTOFILES_HH
+#ifndef ACGL_OPENGL_CONTROLLER_SHADERPROGRAMCONTROLAUTOFILES_HH
+#define ACGL_OPENGL_CONTROLLER_SHADERPROGRAMCONTROLAUTOFILES_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -39,4 +39,4 @@ public:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_SHADERPROGRAMCONTROLAUTOFILES_HH

include/ACGL/OpenGL/Controller/TextureControl.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_TEXTURECONTROL_HH
-#define ACGL_RESOURCE_TEXTURECONTROL_HH
+#ifndef ACGL_OPENGL_CONTROLLER_TEXTURECONTROL_HH
+#define ACGL_OPENGL_CONTROLLER_TEXTURECONTROL_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -90,4 +90,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_TEXTURECONTROL_HH

include/ACGL/OpenGL/Controller/TextureControlFileJPG.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_TEXTURECONTROLFILEJPG_HH
-#define ACGL_RESOURCE_TEXTURECONTROLFILEJPG_HH
+#ifndef ACGL_OPENGL_CONTROLLER_TEXTURECONTROLFILEJPG_HH
+#define ACGL_OPENGL_CONTROLLER_TEXTURECONTROLFILEJPG_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -57,4 +57,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_TEXTURECONTROLFILEJPG_HH

include/ACGL/OpenGL/Controller/VertexBufferControl.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_VERTEXBUFFERCONTROL_HH
-#define ACGL_RESOURCE_VERTEXBUFFERCONTROL_HH
+#ifndef ACGL_OPENGL_CONTROLLER_VERTEXBUFFERCONTROL_HH
+#define ACGL_OPENGL_CONTROLLER_VERTEXBUFFERCONTROL_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -85,4 +85,4 @@ protected:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_VERTEXBUFFERCONTROL_HH

include/ACGL/OpenGL/Controller/VertexBufferControlFileOBJ.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_VERTEXBUFFERCONTROLFILEOBJ_HH
-#define ACGL_RESOURCE_VERTEXBUFFERCONTROLFILEOBJ_HH
+#ifndef ACGL_OPENGL_CONTROLLER_VERTEXBUFFERCONTROLFILEOBJ_HH
+#define ACGL_OPENGL_CONTROLLER_VERTEXBUFFERCONTROLFILEOBJ_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -41,4 +41,4 @@ public:
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_CONTROLLER_VERTEXBUFFERCONTROLFILEOBJ_HH

include/ACGL/OpenGL/GL.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_GL_HH
-#define ACGL_GL_HH
+#ifndef ACGL_OPENGL_GL_HH
+#define ACGL_OPENGL_GL_HH
 
 /*
  * This simple OpenGL wrapper is used to include OpenGL and GLEW
@@ -89,4 +89,4 @@
 	#include <QtOpenGL/qgl.h>
 #endif // USE_QT
 
-#endif // ACGL_GL_HH
+#endif // ACGL_OPENGL_GL_HH

include/ACGL/OpenGL/Managers.hh

@@ -3,8 +3,13 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_MANAGER_HH
-#define ACGL_MANAGER_HH
+#ifndef ACGL_OPENGL_MANAGER_HH
+#define ACGL_OPENGL_MANAGER_HH
+
+/*
+ * A shortcut to include all manager of OpenGL objects.
+ * Will also include the Objects & Controllers!
+ */
 
 #include <ACGL/ACGL.hh>
 
@@ -39,10 +44,11 @@ typedef Resource::NameManager<ElementArrayBuffer> ElementArrayBufferNameManager;
 } // OpenGL
 } // ACGL
 
+//note: when we start having managers for non-OpenGL objects we should move this ;-)
 #define ACGL_FOR_EACH_RESOURCE(MANAGER,RESOURCE,ELEMENT) \
     for(ACGL::Resource::MANAGER<RESOURCE>::ResourceContainer::const_iterator ELEMENT = ACGL::Resource::MANAGER<RESOURCE>::the()->begin(); \
         ELEMENT != MANAGER<RESOURCE>::the()->end(); \
         ++ELEMENT)
 
 
-#endif // ACGL_MANAGER_HH
+#endif // ACGL_OPENGL_MANAGER_HH

include/ACGL/OpenGL/Objects.hh

@@ -3,8 +3,12 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_OBJECTS_HH
-#define ACGL_OBJECTS_HH
+#ifndef ACGL_OPENGL_OBJECTS_HH
+#define ACGL_OPENGL_OBJECTS_HH
+
+/*
+ * A shortcut to include all OpenGL objects.
+ */
 
 #include <ACGL/ACGL.hh>
 
@@ -18,4 +22,4 @@
 #include <ACGL/OpenGL/Objects/ElementArrayBuffer.hh>
 
 
-#endif // ACGL_OBJECTS_HH
+#endif // ACGL_OPENGL_OBJECTS_HH

include/ACGL/OpenGL/Objects/ArrayBuffer.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_ARRAYBUFFER_HH
-#define ACGL_RESOURCE_ARRAYBUFFER_HH
+#ifndef ACGL_OPENGL_OBJECTS_ARRAYBUFFER_HH
+#define ACGL_OPENGL_OBJECTS_ARRAYBUFFER_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -185,4 +185,4 @@ typedef std::tr1::shared_ptr<ArrayBuffer> SharedArrayBuffer;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_ARRAYBUFFER_HH
+#endif // ACGL_OPENGL_OBJECTS_ARRAYBUFFER_HH

include/ACGL/OpenGL/Objects/ElementArrayBuffer.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_ELEMENTBUFFERDATA_HH
-#define ACGL_RESOURCE_ELEMENTBUFFERDATA_HH
+#ifndef ACGL_OPENGL_OBJECTS_ELEMENTBUFFERDATA_HH
+#define ACGL_OPENGL_OBJECTS_ELEMENTBUFFERDATA_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -126,4 +126,4 @@ typedef std::tr1::shared_ptr<ElementArrayBuffer> SharedElementArrayBuffer;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_ELEMENTBUFFERDATA_HH
+#endif // ACGL_OPENGL_OBJECTS_ELEMENTBUFFERDATA_HH

include/ACGL/OpenGL/Objects/FrameBuffer.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_FRAMEBUFFER_HH
-#define ACGL_RESOURCE_FRAMEBUFFER_HH
+#ifndef ACGL_OPENGL_OBJECTS_FRAMEBUFFER_HH
+#define ACGL_OPENGL_OBJECTS_FRAMEBUFFER_HH
 
 /*
  * This FrameBuffer class encapsulates an OpenGL frame buffer object (FBO).
@@ -251,4 +251,4 @@ typedef std::tr1::shared_ptr<FrameBuffer> SharedFrameBuffer;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_FRAMEBUFFER_HH
+#endif // ACGL_OPENGL_OBJECTS_FRAMEBUFFER_HH

include/ACGL/OpenGL/Objects/RenderBuffer.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_RENDERBUFFER_HH
-#define ACGL_RESOURCE_RENDERBUFFER_HH
+#ifndef ACGL_OPENGL_OBJECTS_RENDERBUFFER_HH
+#define ACGL_OPENGL_OBJECTS_RENDERBUFFER_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -72,4 +72,4 @@ typedef std::tr1::shared_ptr<RenderBuffer> SharedRenderBuffer;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_FRAMEBUFFER_HH
+#endif // ACGL_OPENGL_OBJECTS_RENDERBUFFER_HH

include/ACGL/OpenGL/Objects/Shader.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_SHADER_HH
-#define ACGL_RESOURCE_SHADER_HH
+#ifndef ACGL_OPENGL_OBJECTS_SHADER_HH
+#define ACGL_OPENGL_OBJECTS_SHADER_HH
 
 #include <vector>
 #include <string>
@@ -92,4 +92,4 @@ typedef std::tr1::shared_ptr<Shader> SharedShader;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_SHADER_HH
+#endif // ACGL_OPENGL_OBJECTS_SHADER_HH

include/ACGL/OpenGL/Objects/ShaderProgram.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_SHADERPROGRAM_HH
-#define ACGL_RESOURCE_SHADERPROGRAM_HH
+#ifndef ACGL_OPENGL_OBJECTS_SHADERPROGRAM_HH
+#define ACGL_OPENGL_OBJECTS_SHADERPROGRAM_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -121,4 +121,4 @@ typedef std::tr1::shared_ptr<ShaderProgram> SharedShaderProgram;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_SHADERPROGRAM_HH
+#endif // ACGL_OPENGL_OBJECTS_SHADERPROGRAM_HH

include/ACGL/OpenGL/Objects/Texture.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_TEXTURE_HH
-#define ACGL_RESOURCE_TEXTURE_HH
+#ifndef ACGL_OPENGL_OBJECTS_TEXTURE_HH
+#define ACGL_OPENGL_OBJECTS_TEXTURE_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -252,4 +252,4 @@ typedef std::tr1::shared_ptr<Texture> SharedTexture;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_TEXTURE_HH
+#endif // ACGL_OPENGL_OBJECTS_TEXTURE_HH

include/ACGL/OpenGL/Objects/Uniform.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_UNIFORM_HH
-#define ACGL_RESOURCE_UNIFORM_HH
+#ifndef ACGL_OPENGL_OBJECTS_UNIFORM_HH
+#define ACGL_OPENGL_OBJECTS_UNIFORM_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -93,4 +93,4 @@ public:
 } // ACGL
 */
 
-#endif // ACGL_RESOURCE_SHADERPROGRAM_HH
+#endif // ACGL_OPENGL_OBJECTS_UNIFORM_HH

include/ACGL/OpenGL/Objects/VertexBuffer.hh

@@ -3,8 +3,8 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_RESOURCE_VERTEXBUFFER_HH
-#define ACGL_RESOURCE_VERTEXBUFFER_HH
+#ifndef ACGL_OPENGL_OBJECTS_VERTEXBUFFER_HH
+#define ACGL_OPENGL_OBJECTS_VERTEXBUFFER_HH
 
 #include <ACGL/ACGL.hh>
 
@@ -140,4 +140,4 @@ typedef std::tr1::shared_ptr<VertexBuffer> SharedVertexBuffer;
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_RESOURCE_VERTEXBUFFER_HH
+#endif // ACGL_OPENGL_OBJECTS_VERTEXBUFFER_HH

include/ACGL/OpenGL/Tools.hh

@@ -3,8 +3,13 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_GLUTILS_TOOLS_HH
-#define ACGL_GLUTILS_TOOLS_HH
+#ifndef ACGL_OPENGL_TOOLS_HH
+#define ACGL_OPENGL_TOOLS_HH
+
+/*
+ * Some OpeGL related helper functions.
+ * All the error checking functions are in here.
+ */
 
 #include <ACGL/ACGL.hh>
 #include <ACGL/OpenGL/GL.hh>
@@ -113,5 +118,5 @@ inline bool   openGLErrorOccuredDummy() { return false; }
 } // OpenGL
 } // ACGL
 
-#endif // ACGL_GLUTILS_TOOLS_HH
+#endif // ACGL_OPENGL_TOOLS_HH
 

include/ACGL/Resource/BasicController.hh

@@ -6,6 +6,13 @@
 #ifndef ACGL_RESOURCE_BASICCONTROLLER_HH
 #define ACGL_RESOURCE_BASICCONTROLLER_HH
 
+/*
+ * Base class for all controllers.
+ *
+ * Controllers can provide more flexible ways of creating objects, they are also
+ * making managers more flexibe.
+ */
+
 #include <tr1/memory>
 
 #include <ACGL/ACGL.hh>

include/ACGL/Scene/Camera.hh

@@ -3,8 +3,12 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_GLUTILS_CAMERA_HH
-#define ACGL_GLUTILS_CAMERA_HH
+#ifndef ACGL_SCENE_CAMERA_HH
+#define ACGL_SCENE_CAMERA_HH
+
+/*
+ * A generic camera class.
+ */
 
 #include <ACGL/ACGL.hh>
 #include <ACGL/Math/Math.hh>
@@ -143,4 +147,4 @@ private:
 } // Scene
 } // ACGL
 
-#endif // ACGL_GLUTILS_CAMERA_HH
+#endif // ACGL_SCENE_CAMERA_HH

include/ACGL/Scene/CoordinateSystem.hh

@@ -3,8 +3,13 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_GLUTILS_COORDINATESYSTEM_HH
-#define ACGL_GLUTILS_COORDINATESYSTEM_HH
+#ifndef ACGL_SCENE_COORDINATESYSTEM_HH
+#define ACGL_SCENE_COORDINATESYSTEM_HH
+
+/*
+ * The coordinate system can be used to draw a simple grid to visualize the
+ * worlds coordinate system. Drawing itself is not implemented here!
+ */
 
 #include <ACGL/ACGL.hh>
 #include <ACGL/Math/Math.hh>
@@ -59,4 +64,4 @@ private:
 } // Scene
 } // ACGL
 
-#endif // ACGL_GLUTILS_COORDINATESYSTEM_HH
+#endif // ACGL_SCENE_COORDINATESYSTEM_HH

include/ACGL/Scene/MatrixStack.hh

@@ -3,8 +3,16 @@
 // All rights reserved.                                                       //
 ////////////////////////////////////////////////////////////////////////////////
 
-#ifndef ACGL_GLUTILS_MATRIXSTACK_HH
-#define ACGL_GLUTILS_MATRIXSTACK_HH
+#ifndef ACGL_SCENE_MATRIXSTACK_HH
+#define ACGL_SCENE_MATRIXSTACK_HH
+
+/*
+ * A matrix stack that can mimic the old OpenGL matrix stack. It is only based on
+ * glm, so it can be used without OpenGL easily.
+ *
+ * You can create as many independent stacks as you like or just use the
+ * pre-defined ModelViewMatrixStack singleton.
+ */
 
 #include <ACGL/ACGL.hh>
 #include <ACGL/Base/Singleton.hh>
@@ -108,4 +116,4 @@ typedef Base::Singleton< MatrixStack > ModelViewMatrixStack;
 } // Scene
 } // ACGL
 
-#endif // ACGL_GLUTILS_MATRIXSTACK_HH
+#endif // ACGL_SCENE_MATRIXSTACK_HH

include/ACGL/Types.hh

@@ -28,4 +28,4 @@ typedef uint64_t ulong_t;
 
 } // ACGL