SimpleShader3 now uses the corresponding program when resetting the transformation matrix. This is needed if mixing draw calls with the objects library and using another shader program (such as through FontUtils)
v 6.1.0.0 - 22 May 2026
All logging can go to terminal and save to file for review after program completion
v 6.0.5.0 - 21 May 2026
Using unsigned int consistently
Separate Engine window resize and framebuffer resize
v 6.0.4.1 - 08 Apr 2026
Teapot approximates tangent vectors when partial derivatives are zero to avoid an invalid surface normal
v 6.0.4.0 - 07 Apr 2026
Option to enable multisampling when creating an OpenGLEngine
v 6.0.3.0 - 30 Mar 2026
Using inline globals, instead of static globals, to ensure one instance exists across multiple translation units
v 6.0.2.0 - 04 Mar 2026
Can query Camera view direction
Perspective Cameras default FOV is now correctly PI/2 radians (not 45 degrees as function expects radians)
Suppress OpenGL error if ModelLoader attempts to specify vertex locations for negative locations. Only sets vertex attribute points for non-negative locations.
v 6.0.1.1 - 26 Jan 2026
Fixed ShaderUtils displaying UBOs in correct shaders
Fixed UniformBufferObject name c-strings
Fixed all instances of strncpy to set null terminator after copy
v 6.0.1.0 - 21 Jan 2026
Expanded UniformBufferObject uniform types
v 6.0.0.0 - 21 Jan 2026
MD5Materials can be read from a PATH location
Expanded UBO support to more cleanly set uniforms within buffer block
teapot supports normal mapping
OpenGLEngine times startup and shutdown steps and reports time spent
sphere, cylinder, cone, disk, torus supports normal mapping
OBJ models can auto-generate tangents for normal mapping
Fixed bug for shader introspection displaying uniform array names
FontUtils and Font class added to simplify the process of rendering text to the screen
OpenGLEngine sets FontUtils window size and stores framebuffer size
OpenGLEngine measures frame time
v 5.25.0.0 - 09 Dec 2025
MD5Models support normal mapping
v 5.24.0.0 - 08 Dec 2025
MD5Models can read *.mtr file and apply shaders for diffuse, specular, normal, and height maps
v 5.23.1.1 - 14 Nov 2025
Patching included examples
v 5.23.1.0 - 14 Nov 2025
OpenGLEngine stores the version requested and actually created
v 5.23.0.0 - 11 Nov 2025
Need to define CSCI441_OPENGL_ENGINE_IMPLEMENTATION for building
v 5.22.0.0 - 06 Nov 2025
MD5Model can hold multiple animations to toggle between
v 5.21.1.0 - 31 Oct 2025
ShaderProgramPipeline can hold a Compute Shader Program
If ShaderProgram doesn't link, still print final bottom header line
v 5.21.0.0 - 29 Oct 2025
Need to define CSCI441_TEXTURE_UTILS_IMPLEMENTATION for building
Revamping numbering to MAJOR.MINOR.REVISION.PATCH
v 5.20.0 - 24 Oct 2025
Need to define CSCI441_SCREENSHOT_IMPLEMENTATION for building
v 5.19.1 - 17 Oct 2025
Patched OpenGLEngine to avoid redefinition errors
v 5.19.0 - 14 Oct 2025
OpenGLEngine has built-in utility to save screenshot of internal viewport
v 5.18.0 - 14 Oct 2025
ShaderUtils prints shader program output information if using version 4.3+
Cylinder and Cone texture coords wrap outward textures
v 5.17.0 - 06 Oct 2025
ShaderProgram can validate if program is ready to execute in current state
ShaderProgram can query fragment output color bindings
Fixed recently introduced error of OpenGL3DEngine expecting a PerspectiveCamera object
v 5.16.0 - 02 Oct 2025
MD5Model can bind diffuse, specular, normal, and height maps
Added constants file to track library information
v 5.15.0 - 01 Oct 2025
Added ability for SimpleShader to delete its internal program
Implemented MD5Model move operation
Fixed memory leaks and other memory errors within MD5Model
Fixed bug in SimpleShader were deleting vertexArray didn't clear map entry
v 5.13.0 - 09 Sep 2025
Examples can build against GLEW or GLAD
UniformBufferObject cannot be copied but can be moved
Cleaned up ModelLoader material memory leak
ModelLoader cannot be copied but can be moved
ShaderProgramPipeline cannot be copied but can be moved
ShaderProgram uses OpenGL types
ShaderProgram internal improvements
ShaderProgram cannot be copied but can be moved
ComputeShaderProgram cannot be copied but can be moved
Cameras can be copied and moved
Fixed bug in MD5Camera update frame orientation calculation
Fixed bug in MD5Camera copy operation
objects.hpp: Fixed bug where deleting VAO/VBO only deletes from GPU and does not clear internal maps. if delete occurs mid-program, next call will now properly recreate vao/vbo
Fixed bug OpenGLEngine where destructor calling shutdown() does nothing
OpenGLEngines cannot be copied but can be moved
Do not allow MD5Models to be copied nor moved
v 5.12.0 - 05 Sep 2025
SimpleShader no longer assumes VAOD and VBOD are the same value
SimpleShader supports deleting Vertex Arrays
v 5.11.1 - 02 Sep 2025
Fixed bug that glGetProgramResource is only defined for version 4.3+
v 5.11.0 - 02 Sep 2025
Fixed small memory leaks with ShaderUtils
Adding subroutine helper functions to ShaderProgram
Fixed bug of materials.hpp not checking for GLEW inclusion
Internal improvements (using OpenGL types in ShaderUtils)
Fixed bug of atomic counter shader debug information printing
v 5.10.1 - 29 Aug 2025
Fixed bug registering debug callback for OpenGL 4.3+
v 5.10.0 - 26 Aug 2025
Added OpenGLEngine::mReloadShaders() which internally calls mCleanupShaders() and mReloadShaders() to hot load new shader files while program is running. Will need to be used with care and could lead to additional VAO/Uniform errors if program interface changes.
v 5.9.2 - 26 Aug 2025
Apply snprintf() patch to ComputerShaderProgram()
v 5.9.1 - 26 Aug 2025
Only create shader handle if shader source successfully read from file
v 5.9.0 - 29 Oct 2024
Merged fix to use snprintf() and remove build warnings
TextureUtils::loadAndRegisterTexture() added flags to toggle mipmaps and anisotropic filtering
ModelLoader::_loadObjFile() checks if current face has texture coordinates in addition to entire model
v 5.6.0 - 24 Oct 2024
Fixed GPU memory leak of not deleting cube IBOs
Add CSCI441::OpenGLUtils::checkOpenGLError() method to check the error queue
When requesting an OpenGL 4.3+ debug context, register debug callback
v 5.5.0 - 18 Oct 2024
TextureUtils::loadAndRegister2DTexture() can silence error message
MD5Model silences all but final texture fail messages during load
ShaderProgram uses glm::value_ptr() for passing vectors and matrices to program uniforms
Include glad/gl.h in materials.hpp for GLfloat to exist if file included on its own
Patched bug with objects.hpp wire objects not resetting the polygon mode back for the front_and_back properly
v 5.4.1 - 26 Aug 2024
Updated README
v 5.4.0 - 26 Aug 2024
Updated glm dependency to v1.0.1
Added half sphere and dome to HUD example
Fixed shader uniform debug output typos
OpenGLUtils: Does not print full list of extensions with OpenGL statistics, created a separate function that can be called for full listing
MD5Camera: fixed bug where inverseQ normalization was being discarded and not set
MD5Model: added GLM_ENABLE_EXPERIMENTAL for quaternion header to match GLM v1.0.1
OrthographicCamera: fixed bug where _updateProjectionMatrix was not declared inline
v 5.3.0 - 16 Aug 2024
Removed [[nodiscard]] from ModelLoader::draw() to silence warnings. Currently, method always returns true so the return value isn't applicable.
Changed format of extensions listing header
Added abstract PerspectiveCamera class to house aspect ratio, field of view, near/far clip planes. When any is updated, the perspective projection matrix is recomputed
Added abstract OrthographicCamera class to house left, right, bottom, top, near, far clip planes
v 5.2.0 - 15 Aug 2024
OpenGLEngine tracks the state of the Caps Lock and Num Lock keys during key callbacks
OpenGL queries checks Point Size Range
Added functions to convert material float arrays into a glm object
Use glm::value_ptr() instead of &[0] to access beginning of data array
Query all available OpenGL extensions
Display the list in OpenGLUtils when printing info
Store a set of available extensions in OpenGLEngine to do a quick boolean query to check if a specific extension exists
Moved revision history into dedicated changelog file
Replacing cmath dependency with glm references (PI specifically)
Warnings removed
v 4.9.1 - 20 Sep 2023
Fixed Doxygen version number
v 4.9.0 - 20 Sep 2023
Fixed aspect ratio calculation in OpenGL3DEngine
Fixed MD5Model destruction if error loading model
Removed internal references to glUniform*() and replaced with glProgramUniform*() to not change bound program state
Cleaned up documentation
v 4.8.0 - 14 Sep 2023
OpenGL3DEngine can handle events that have an effect on the arcball camera movement
v 4.7.0 - 07 Sep 2023
Big3 implemented on classes as appropriate
Classes and methods open/close as appropriate
v 4.6.1 - 06 Sep 2023
Cannot copy MD5 Models
v 4.6.0 - 06 Sep 2023
Created MD5Model class to load, display, and animate md5mesh + md5anim files
Deleted copy constructor and copy assignment operator for ShaderProgram and ComputeShaderProgram to prevent shader program objects from being copied and then deallocated on the GPU
TextureUtils::loadAndRegisterTexture() now has a trailing parameter to specify if the image should be flipped when loaded or not (defaults to flip = true)
v 4.5.0 - 31 Aug 2023
Camera stores projection matrix along with view matrix
ArcballCam, FixedCam, FreeCam operate with perspective projections
MD5Camera class loads and steps through frames of md5camera file
MD5Camera operates with perspective projection
v 4.4.0 - 29 Aug 2023
ShaderProgram::getProgramStages() returns GLbitfield of shader stages
v 4.3.0 - 25 Aug 2023
Improved and consistent web documentation using a consistent style for all public facing classes and members, methods, and namespaces
Minor performance improvements
v 4.2.0 - 25 Aug 2023
setupGLEW() and cleanupGLEW() made private members of OpenGLEngine
Improving web documentation using a consistent style
v 4.1.1 - 24 Aug 2023
Cleaned up order of includes
Fixed publishing to GitHub pages
v 4.1.0 - 24 Aug 2023
Improving web documentation using a consistent style
v 4.0.0 - 21 Aug 2023
Refactored protected class member naming scheme from _xyz to mXyz
Improving web documentation
v 3.12.1 - 18 Aug 2023
Improving web documentation
v 3.12.0 - 18 Aug 2023
Consistently use only single precision and GLfloat typedef for OS X Metal compatibility
v 3.11.0 - 20 Apr 2023
Fixed renaming bug in ModelLoader _AUTO_GEN_NORMALS and properly initialize to false
Removed memory leaks in object generation of cylinder, disk, sphere, and torus
v 3.10.2 - 26 Oct 2022
Cleaned up Camera class warnings
Replaced OpenGL3DEngine internal arcball implementation with ArcballCam object
v 3.10.1 - 09 Sep 2022
Camera::_clampCameraPhi() explicitly checking against floats instead of double
v 3.10.0 - 06 Aug 2022
Added capability for ShaderProgram to write to/load from binary - if supported by driver
ModelLoader no longer internal applies using namespace std; and qualifies all STL types
v 3.9.0 - 05 Nov 2021
ModelLoader can query number of vertices and indices within model
TextureUtils load method will roll back to ppm loader if stb_image fails to load ppm
Reversed top fan winding order for spheres
v 3.8.0 - 07 Oct 2021
Resolved Issue #2 for OBJ files with negative indices. The negative indices weren't unique and needed to offset before caching
v 3.7.1 - 07 Oct 2021
Fixed get polygon mode bug where it returns two values
Objects and Teapot only enable attribute locations if they are not -1. Prevents an invalid enum error
v 3.7.0 - 06 Oct 2021
Improved encapsulation of Arcball radius modification
Drawing objects now resets glPolygonMode to previous value instead of just forcing GL_FILL
When deleting a Shader Program, check the deletion status
Adding 3D texture coordinates to indexed cube and adding entry point to explicitly drawCubeMap()
Corrected normals for indexed cube
Changed object and teapot internal variables from static to inline to support multi-compilation and single use across multiple contexts
v 3.6.0 - 15 Sep 2021
Created a concrete ArcBall Cam implementation
v 3.5.0 - 13 Sep 2021
Added full getter suite to Camera class
v 3.4.1 - 10 Sep 2021
Fixed bug within SimpleShader when the SimpleShader was used split across multiple class objects
v 3.4.0 - 08 Sep 2021
Created a concrete Fixed Camera implementation that can be positioned but doesn't move
Fixed FreeCam being included across multiple object files
v 3.3.0 - 06 Sep 2021
Created an abstract Camera class to store parameters and to make camera objects
Created a concrete FreeCam implementation
v 3.2.1 - 31 Aug 2021
Reworked SimpleShader::popTransformation() to always re-multiply the model matrix and not use the inverse calculation to avoid precision errors
v 3.2.0 - 30 Aug 2021
Cleaning up code style
Removed deprecated functions in ShaderUtils
Removed printLog() in ShaderUtils forcing explicit use of printShaderLog(), printProgramLog(), printProgramPipelineLog()
Removed loadBMP() and loadTGA() in TextureUtils. Use stb_image library instead
Improved efficiency of setting VBO attribute locations for teapot
Sidestepped the precision error in SimpleShader2 (and therefore SimpleShader3) when popping and multiplying by the inverse by adding a resetTransformationMatrix() method which clears the stack and sets the model matrix to the identity
v 3.1.0 - 21 May 2021
Removed all ShaderProgram::setUniform(). Use ShaderProgram::setProgramUniform() instead.
v 3.0.0 - 21 May 2021
Reworked ModelLoader.hpp to first set attribute locations then specify the shader handle. This allows for the model to be used with separable programs and shader pipelines.
