CSCI441 OpenGL Library 6.1.3.0
CS@Mines CSCI441 Computer Graphics Course Library
Loading...
Searching...
No Matches
OpenGLUtils.hpp
Go to the documentation of this file.
1
15#ifndef CSCI441_OPENGL_UTILS_H
16#define CSCI441_OPENGL_UTILS_H
17
18#include "constants.h"
19#include "LogUtils.hpp"
20
21#ifdef CSCI441_USE_GLEW
22 #include <GL/glew.h>
23#else
24 #include <glad/gl.h>
25#endif
26
27#include <glm/glm.hpp>
28
29#include <cstdlib> // for atoi()
30
31//**********************************************************************************
32
37namespace CSCI441 {
41 inline constexpr glm::vec3 X_AXIS( 1.0f, 0.0f, 0.0f );
45 inline constexpr glm::vec3 Y_AXIS( 0.0f, 1.0f, 0.0f );
49 inline constexpr glm::vec3 Z_AXIS( 0.0f, 0.0f, 1.0f );
53 [[maybe_unused]] inline constexpr glm::vec3 X_AXIS_POS = X_AXIS;
57 [[maybe_unused]] inline constexpr glm::vec3 Y_AXIS_POS = Y_AXIS;
61 [[maybe_unused]] inline constexpr glm::vec3 Z_AXIS_POS = Z_AXIS;
65 [[maybe_unused]] inline constexpr glm::vec3 X_AXIS_NEG( -1.0f, 0.0f, 0.0f );
69 [[maybe_unused]] inline constexpr glm::vec3 Y_AXIS_NEG( 0.0f, -1.0f, 0.0f );
73 [[maybe_unused]] inline constexpr glm::vec3 Z_AXIS_NEG( 0.0f, 0.0f, -1.0f );
74
79 namespace OpenGLUtils {
83 void printOpenGLInfo();
87 [[maybe_unused]] void printOpenGLExtensions();
94 [[maybe_unused]] void checkOpenGLErrors(const char * str = "");
95
101 [[maybe_unused]] const char* openGLErrorMessage(GLenum err);
102
108 [[maybe_unused]] const char* debugSourceToString(GLenum source);
114 [[maybe_unused]] const char* debugTypeToString(GLenum type);
120 [[maybe_unused]] const char* debugSeverityToString(GLenum severity);
121 };
122
123}
124
125//**********************************************************************************
126//**********************************************************************************
127// Internal definitions
128
129namespace CSCI441_INTERNAL {
130 void printOpenGLParamHeader(int MAJOR, int MINOR );
131 void printOpenGLParamIndexed(const char *FORMAT, GLenum name, GLuint index );
132 void printOpenGLParam(const char *FORMAT, GLenum name );
133 void printOpenGLParamf(const char *FORMAT, GLenum name );
134 void printOpenGLParam2(const char *FORMAT, GLenum name );
135 void printOpenGLParam2f(const char *FORMAT, GLenum name );
136 [[maybe_unused]] void printOpenGLParam3(const char *FORMAT, GLenum name );
137 void printOpenGLParam4(const char *FORMAT, GLenum name );
138}
139
140//**********************************************************************************
141//**********************************************************************************
142// Outward facing function implementations
143
144inline void CSCI441::OpenGLUtils::printOpenGLInfo() {
145 GLint major = 0, minor = 0, numExtensions = 0;
146 glGetIntegerv(GL_MAJOR_VERSION, &major);
147 glGetIntegerv(GL_MINOR_VERSION, &minor);
148 glGetIntegerv(GL_NUM_EXTENSIONS, &numExtensions);
149
150 CSCI441::LogUtils::log("\n[INFO]: /--------------------------------------------------------\\\n" );
151 CSCI441::LogUtils::log("[INFO]: | OpenGL Information |\n" );
152 CSCI441::LogUtils::log("[INFO]: |--------------------------------------------------------|\n" );
153 CSCI441::LogUtils::log("[INFO]: | OpenGL Version: %35s |\n", glGetString(GL_VERSION) );
154 CSCI441::LogUtils::log("[INFO]: | OpenGL Renderer: %35s |\n", glGetString(GL_RENDERER) );
155 CSCI441::LogUtils::log("[INFO]: | OpenGL Vendor: %35s |\n", glGetString(GL_VENDOR) );
156 CSCI441::LogUtils::log("[INFO]: | Shading Version: %35s |\n", glGetString(GL_SHADING_LANGUAGE_VERSION) );
157 CSCI441::LogUtils::log("[INFO]: | Number of Extensions: %30d |\n", numExtensions );
158
159 if( (major >= 2 && minor >= 0) || major > 2 ) {
160 CSCI441_INTERNAL::printOpenGLParamHeader( 2, 0 );
161 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Color Attachments: %26d |\n", GL_MAX_COLOR_ATTACHMENTS );
162 CSCI441_INTERNAL::printOpenGLParam2f("[INFO]: | Point Size Range: %24.2f %8.2f |\n", GL_POINT_SIZE_RANGE );
163 CSCI441_INTERNAL::printOpenGLParamf( "[INFO]: | Point Size Granularity: %27.4f |\n", GL_POINT_SIZE_GRANULARITY );
164 CSCI441_INTERNAL::printOpenGLParam2f("[INFO]: | Line Width Smoothed Range: %15.2f %8.2f |\n", GL_SMOOTH_LINE_WIDTH_RANGE );
165 CSCI441_INTERNAL::printOpenGLParamf( "[INFO]: | Line Width Smoothed Granularity: %18.4f |\n", GL_SMOOTH_LINE_WIDTH_GRANULARITY );
166 CSCI441_INTERNAL::printOpenGLParam2f("[INFO]: | Line Width Aliased Range: %16.2f %8.2f |\n", GL_ALIASED_LINE_WIDTH_RANGE );
167 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max Texture Size: %33d |\n", GL_MAX_TEXTURE_SIZE );
168 }
169
170 if( (major >= 2 && minor >= 1) || major > 2 ) {
171 CSCI441_INTERNAL::printOpenGLParamHeader( 2, 1 );
172 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Attributes: %26d |\n", GL_MAX_VERTEX_ATTRIBS );
173 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Uniforms: %28d |\n", GL_MAX_VERTEX_UNIFORM_COMPONENTS );
174 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Textures: %28d |\n", GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS );
175 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Outputs: %29d |\n", GL_MAX_VERTEX_OUTPUT_COMPONENTS );
176 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Inputs: %28d |\n", GL_MAX_FRAGMENT_INPUT_COMPONENTS );
177 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Uniforms: %26d |\n", GL_MAX_FRAGMENT_UNIFORM_COMPONENTS );
178 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Textures: %26d |\n", GL_MAX_TEXTURE_IMAGE_UNITS );
179 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Draw Buffers: %31d |\n", GL_MAX_DRAW_BUFFERS );
180 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Textures Combined: %26d |\n", GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS );
181 }
182
183 if( (major >= 3 && minor >= 0) || major > 3 ) {
184 CSCI441_INTERNAL::printOpenGLParamHeader( 3, 0 );
185 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Transform Feedback Buffers: %17d |\n", GL_MAX_TRANSFORM_FEEDBACK_BUFFERS );
186 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Transform Separate Attributes: %14d |\n", GL_MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS );
187 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Transform Separate Components: %14d |\n", GL_MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS );
188 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Transform Interleaved Buffers: %14d |\n", GL_MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS );
189 }
190
191 if( (major >= 3 && minor >= 1) || major > 3 ) {
192 CSCI441_INTERNAL::printOpenGLParamHeader( 3, 1 );
193 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Uniform Blocks: %20d |\n", GL_MAX_FRAGMENT_UNIFORM_BLOCKS );
194 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Uniform Blocks: %22d |\n", GL_MAX_VERTEX_UNIFORM_BLOCKS );
195 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max Uniform Blocks Size: %20d bytes |\n", GL_MAX_UNIFORM_BLOCK_SIZE );
196 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Combined Uniform Blocks: %20d |\n", GL_MAX_COMBINED_UNIFORM_BLOCKS );
197 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Uniform Bindings: %27d |\n", GL_MAX_UNIFORM_BUFFER_BINDINGS );
198 }
199
200 if( (major >= 3 && minor >= 2) || major > 3 ) {
201 CSCI441_INTERNAL::printOpenGLParamHeader( 3, 2 );
202 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Uniforms: %26d |\n", GL_MAX_GEOMETRY_UNIFORM_COMPONENTS );
203 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Uniform Blocks: %20d |\n", GL_MAX_GEOMETRY_UNIFORM_BLOCKS );
204 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Textures: %26d |\n", GL_MAX_GEOMETRY_TEXTURE_IMAGE_UNITS );
205 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Inputs: %28d |\n", GL_MAX_GEOMETRY_INPUT_COMPONENTS );
206 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Output Vertices: %19d |\n", GL_MAX_GEOMETRY_OUTPUT_VERTICES );
207 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Total Output Components: %11d |\n", GL_MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS );
208 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Outputs: %27d |\n", GL_MAX_GEOMETRY_OUTPUT_COMPONENTS );
209 }
210
211 if( (major >= 4 && minor >= 0) || major > 4 ) {
212 CSCI441_INTERNAL::printOpenGLParamHeader( 4, 0 );
213 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Patch Vertices: %29d |\n", GL_MAX_PATCH_VERTICES );
214 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tessellation Level: %25d |\n", GL_MAX_TESS_GEN_LEVEL );
215 CSCI441_INTERNAL::printOpenGLParam4("[INFO]: | Default Tessellation Outer Levels: %7d %2d %2d %2d |\n", GL_PATCH_DEFAULT_OUTER_LEVEL );
216 CSCI441_INTERNAL::printOpenGLParam2("[INFO]: | Default Tessellation Inner Levels: %13d %2d |\n", GL_PATCH_DEFAULT_INNER_LEVEL );
217 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Inputs: %24d |\n", GL_MAX_GEOMETRY_INPUT_COMPONENTS );
218 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Uniforms: %22d |\n", GL_MAX_TESS_CONTROL_UNIFORM_COMPONENTS );
219 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Uniform Blocks: %16d |\n", GL_MAX_TESS_CONTROL_UNIFORM_BLOCKS );
220 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Textures: %22d |\n", GL_MAX_TESS_CONTROL_TEXTURE_IMAGE_UNITS );
221 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Outputs: %23d |\n", GL_MAX_TESS_CONTROL_OUTPUT_COMPONENTS );
222 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Inputs: %21d |\n", GL_MAX_TESS_EVALUATION_INPUT_COMPONENTS );
223 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Uniforms: %19d |\n", GL_MAX_TESS_EVALUATION_UNIFORM_COMPONENTS );
224 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Uniform Blocks: %13d |\n", GL_MAX_TESS_EVALUATION_UNIFORM_BLOCKS );
225 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Textures: %19d |\n", GL_MAX_TESS_EVALUATION_TEXTURE_IMAGE_UNITS );
226 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Outputs: %20d |\n", GL_MAX_TESS_EVALUATION_OUTPUT_COMPONENTS );
227 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Invocations: %23d |\n", GL_MAX_GEOMETRY_SHADER_INVOCATIONS );
228 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Streams: %29d |\n", GL_MAX_VERTEX_STREAMS );
229 }
230
231 if( (major >= 4 && minor >= 2) || major > 4 ) {
232 CSCI441_INTERNAL::printOpenGLParamHeader( 4, 2 );
233 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Atomic Counters: %21d |\n", GL_MAX_VERTEX_ATOMIC_COUNTERS );
234 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Atomic Counters: %15d |\n", GL_MAX_TESS_CONTROL_ATOMIC_COUNTERS );
235 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Atomic Counters: %12d |\n", GL_MAX_TESS_EVALUATION_ATOMIC_COUNTERS );
236 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Atomic Counters: %19d |\n", GL_MAX_GEOMETRY_ATOMIC_COUNTERS );
237 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Atomic Counters: %19d |\n", GL_MAX_FRAGMENT_ATOMIC_COUNTERS );
238 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Combined Atomic Counters: %19d |\n", GL_MAX_COMBINED_ATOMIC_COUNTERS );
239 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Atomic Counter Buffers: %14d |\n", GL_MAX_VERTEX_ATOMIC_COUNTER_BUFFERS );
240 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Atomic Counter Buffers: %8d |\n", GL_MAX_TESS_CONTROL_ATOMIC_COUNTER_BUFFERS );
241 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Atomic Counter Buffers: %5d |\n", GL_MAX_TESS_EVALUATION_ATOMIC_COUNTER_BUFFERS );
242 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Atomic Counter Buffers: %12d |\n", GL_MAX_GEOMETRY_ATOMIC_COUNTER_BUFFERS );
243 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Atomic Counter Buffers: %12d |\n", GL_MAX_FRAGMENT_ATOMIC_COUNTER_BUFFERS );
244 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Combined Atomic Counter Buffers: %12d |\n", GL_MAX_COMBINED_ATOMIC_COUNTER_BUFFERS );
245 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Atomic Counter Buffer Bindings: %13d |\n", GL_MAX_ATOMIC_COUNTER_BUFFER_BINDINGS );
246 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max Atomic Counter Buffer Size: %17d |\n", GL_MAX_ATOMIC_COUNTER_BUFFER_SIZE );
247 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Image Uniforms: %22d |\n", GL_MAX_VERTEX_IMAGE_UNIFORMS );
248 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Image Uniforms: %16d |\n", GL_MAX_TESS_CONTROL_IMAGE_UNIFORMS );
249 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Image Uniforms: %13d |\n", GL_MAX_TESS_EVALUATION_IMAGE_UNIFORMS );
250 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Image Uniforms: %20d |\n", GL_MAX_GEOMETRY_IMAGE_UNIFORMS );
251 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Image Uniforms: %20d |\n", GL_MAX_FRAGMENT_IMAGE_UNIFORMS );
252 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Combined Image Uniforms: %20d |\n", GL_MAX_IMAGE_UNITS );
253 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Shader Storage Buffer Bindings: %13d |\n", GL_MAX_SHADER_STORAGE_BUFFER_BINDINGS );
254 }
255
256 if( (major >= 4 && minor >= 3) || major > 4 ) {
257 CSCI441_INTERNAL::printOpenGLParamHeader( 4, 3 );
258 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Uniforms: %27d |\n", GL_MAX_COMPUTE_UNIFORM_COMPONENTS );
259 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Uniform Blocks: %21d |\n", GL_MAX_COMPUTE_UNIFORM_BLOCKS );
260 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Textures: %27d |\n", GL_MAX_COMPUTE_TEXTURE_IMAGE_UNITS );
261 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Image Uniforms: %21d |\n", GL_MAX_COMPUTE_IMAGE_UNIFORMS );
262 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Atomic Counters: %20d |\n", GL_MAX_COMPUTE_ATOMIC_COUNTERS );
263 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Atomic Counter Buffers: %13d |\n", GL_MAX_COMPUTE_ATOMIC_COUNTER_BUFFERS );
264
265 CSCI441_INTERNAL::printOpenGLParamIndexed("[INFO]: | Max # Work Groups Per Dispatch: %6d", GL_MAX_COMPUTE_WORK_GROUP_COUNT, 0 );
266 CSCI441_INTERNAL::printOpenGLParamIndexed(" %6d", GL_MAX_COMPUTE_WORK_GROUP_COUNT, 1 );
267 CSCI441_INTERNAL::printOpenGLParamIndexed(" %6d |\n", GL_MAX_COMPUTE_WORK_GROUP_COUNT, 2 );
268
269 CSCI441_INTERNAL::printOpenGLParamIndexed("[INFO]: | Max Work Groups Size: %16d", GL_MAX_COMPUTE_WORK_GROUP_SIZE, 0 );
270 CSCI441_INTERNAL::printOpenGLParamIndexed(" %6d", GL_MAX_COMPUTE_WORK_GROUP_SIZE, 1 );
271 CSCI441_INTERNAL::printOpenGLParamIndexed(" %6d |\n", GL_MAX_COMPUTE_WORK_GROUP_SIZE, 2 );
272
273 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Invocations Per Work Group: %18d |\n", GL_MAX_COMPUTE_WORK_GROUP_INVOCATIONS );
274 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max Total Storage Size: %22d bytes |\n", GL_MAX_COMPUTE_SHARED_MEMORY_SIZE );
275 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Vertex Shader Storage Blocks: %15d |\n", GL_MAX_VERTEX_SHADER_STORAGE_BLOCKS );
276 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Control Shader Storage Blocks: %9d |\n", GL_MAX_TESS_CONTROL_SHADER_STORAGE_BLOCKS );
277 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Tess Evaluation Shader Storage Blocks: %6d |\n", GL_MAX_TESS_EVALUATION_SHADER_STORAGE_BLOCKS );
278 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Geometry Shader Storage Blocks: %13d |\n", GL_MAX_GEOMETRY_SHADER_STORAGE_BLOCKS );
279 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Fragment Shader Storage Blocks: %13d |\n", GL_MAX_FRAGMENT_SHADER_STORAGE_BLOCKS );
280 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Compute Shader Storage Blocks: %14d |\n", GL_MAX_COMPUTE_SHADER_STORAGE_BLOCKS );
281 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Combined Shader Storage Blocks: %13d |\n", GL_MAX_COMBINED_SHADER_STORAGE_BLOCKS );
282 CSCI441_INTERNAL::printOpenGLParam( "[INFO]: | Max # Combined Shader Output Resources: %11d |\n", GL_MAX_COMBINED_SHADER_OUTPUT_RESOURCES );
283 }
284
285 CSCI441::LogUtils::log("[INFO]: \\--------------------------------------------------------/\n\n");
286}
287
288[[maybe_unused]]
289inline void CSCI441::OpenGLUtils::printOpenGLExtensions() {
290 GLint numExtensions = 0;
291 glGetIntegerv(GL_NUM_EXTENSIONS, &numExtensions);
292
293 CSCI441::LogUtils::log("[INFO]: Number of Extensions: %4d\n", numExtensions );
294 for (int i = 0; i < numExtensions; i++) {
295 CSCI441::LogUtils::log("[INFO]: Extension #%3d: %s \n", (i+1), glGetStringi(GL_EXTENSIONS, i) );
296 }
297}
298
299[[maybe_unused]]
300inline void CSCI441::OpenGLUtils::checkOpenGLErrors(const char * const str) {
301 GLenum err;
302 while( (err = glGetError()) != GL_NO_ERROR ) {
303 CSCI441::LogUtils::logError( "[ERROR %s]: OpenGL Error (%d): %s\n", str, err, CSCI441::OpenGLUtils::openGLErrorMessage(err) );
304 }
305}
306
307inline const char* CSCI441::OpenGLUtils::openGLErrorMessage(const GLenum err) {
308 switch(err) {
309 case GL_NO_ERROR: return "No error";
310 case GL_INVALID_ENUM: return "Invalid enum";
311 case GL_INVALID_VALUE: return "Invalid value";
312 case GL_INVALID_OPERATION: return "Invalid operation";
313 case GL_STACK_OVERFLOW: return "Stack overflow";
314 case GL_STACK_UNDERFLOW: return "Stack underflow";
315 case GL_OUT_OF_MEMORY: return "Out of memory";
316 case GL_INVALID_FRAMEBUFFER_OPERATION: return "Invalid framebuffer operation";
317 case GL_CONTEXT_LOST: return "Context lost";
318 default: return "Unknown";
319 }
320}
321
322[[maybe_unused]]
323inline const char* CSCI441::OpenGLUtils::debugSourceToString(const GLenum source) {
324 switch(source) {
325 case GL_DEBUG_SOURCE_API: return "API";
326 case GL_DEBUG_SOURCE_WINDOW_SYSTEM: return "Window System";
327 case GL_DEBUG_SOURCE_SHADER_COMPILER: return "Shader Compiler";
328 case GL_DEBUG_SOURCE_THIRD_PARTY: return "Third Party";
329 case GL_DEBUG_SOURCE_APPLICATION: return "Application";
330 case GL_DEBUG_SOURCE_OTHER: return "Other";
331 default: return "Unknown";
332 }
333}
334
335[[maybe_unused]]
336inline const char* CSCI441::OpenGLUtils::debugTypeToString(const GLenum type) {
337 switch(type) {
338 case GL_DEBUG_TYPE_ERROR: return "Error";
339 case GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR: return "Deprecated Behavior";
340 case GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR: return "Undefined Behavior";
341 case GL_DEBUG_TYPE_PORTABILITY: return "Portability";
342 case GL_DEBUG_TYPE_PERFORMANCE: return "Performance";
343 case GL_DEBUG_TYPE_MARKER: return "Marker";
344 case GL_DEBUG_TYPE_PUSH_GROUP: return "Push Group";
345 case GL_DEBUG_TYPE_POP_GROUP: return "Pop Group";
346 case GL_DEBUG_TYPE_OTHER: return "Other";
347 default: return "Unknown";
348 }
349}
350
351[[maybe_unused]]
352inline const char* CSCI441::OpenGLUtils::debugSeverityToString(const GLenum severity) {
353 switch(severity) {
354 case GL_DEBUG_SEVERITY_HIGH: return "High";
355 case GL_DEBUG_SEVERITY_MEDIUM: return "Medium";
356 case GL_DEBUG_SEVERITY_LOW: return "Low";
357 case GL_DEBUG_SEVERITY_NOTIFICATION: return "Notification";
358 default: return "Unknown";
359 }
360}
361
362//**********************************************************************************
363//**********************************************************************************
364// Internal function implementations
365
366inline void CSCI441_INTERNAL::printOpenGLParamHeader( const int MAJOR, const int MINOR ) {
367 CSCI441::LogUtils::log("[INFO]: >--------------------------------------------------------<\n" );
368 CSCI441::LogUtils::log("[INFO]: | OpenGL %d.%d Settings |\n", MAJOR, MINOR );
369 CSCI441::LogUtils::log("[INFO]: |--------------------------------------------------------|\n" );
370}
371
372inline void CSCI441_INTERNAL::printOpenGLParamIndexed(const char * const FORMAT, const GLenum name, const GLuint index ) {
373 GLint value = 0;
374 glGetIntegeri_v( name, index, &value );
375 CSCI441::LogUtils::log(FORMAT, value );
376}
377
378inline void CSCI441_INTERNAL::printOpenGLParam(const char * const FORMAT, const GLenum name ) {
379 GLint value = 0;
380 glGetIntegerv( name, &value );
381 CSCI441::LogUtils::log(FORMAT, value );
382}
383
384inline void CSCI441_INTERNAL::printOpenGLParamf(const char * const FORMAT, const GLenum name ) {
385 GLfloat value = 0;
386 glGetFloatv( name, &value );
387 CSCI441::LogUtils::log(FORMAT, value );
388}
389
390inline void CSCI441_INTERNAL::printOpenGLParam2(const char * const FORMAT, const GLenum name ) {
391 GLint values[2] = {0,0};
392 glGetIntegerv( name, values );
393 CSCI441::LogUtils::log(FORMAT, values[0], values[1] );
394}
395
396inline void CSCI441_INTERNAL::printOpenGLParam2f(const char * const FORMAT, const GLenum name ) {
397 GLfloat values[2] = {0,0};
398 glGetFloatv( name, values );
399 CSCI441::LogUtils::log(FORMAT, values[0], values[1] );
400}
401
402[[maybe_unused]]
403inline void CSCI441_INTERNAL::printOpenGLParam3(const char * const FORMAT, const GLenum name ) {
404 GLint values[3] = {0,0,0};
405 glGetIntegerv( name, values );
406 CSCI441::LogUtils::log(FORMAT, values[0], values[1], values[2] );
407}
408
409inline void CSCI441_INTERNAL::printOpenGLParam4(const char * const FORMAT, const GLenum name ) {
410 GLint values[4] = {0,0,0,0};
411 glGetIntegerv( name, values );
412 CSCI441::LogUtils::log(FORMAT, values[0], values[1], values[2], values[3] );
413}
414
415#endif // CSCI441_OPENGL_UTILS_H
CSCI441::OpenGLUtils::openGLErrorMessage
const char * openGLErrorMessage(GLenum err)
Converts error value to string representation.
Definition: OpenGLUtils.hpp:307
CSCI441::OpenGLUtils::printOpenGLInfo
void printOpenGLInfo()
Prints information about our OpenGL context.
Definition: OpenGLUtils.hpp:144
CSCI441::OpenGLUtils::debugSeverityToString
const char * debugSeverityToString(GLenum severity)
Converts debug severity value to string representation.
Definition: OpenGLUtils.hpp:352
CSCI441::OpenGLUtils::checkOpenGLErrors
void checkOpenGLErrors(const char *str="")
Checks if there are any OpenGL errors, printing them if so, and clearing the error flag.
Definition: OpenGLUtils.hpp:300
CSCI441::OpenGLUtils::printOpenGLExtensions
void printOpenGLExtensions()
Prints the list of available extensions.
Definition: OpenGLUtils.hpp:289
CSCI441::OpenGLUtils::debugTypeToString
const char * debugTypeToString(GLenum type)
Converts debug type value to string representation.
Definition: OpenGLUtils.hpp:336
CSCI441::OpenGLUtils::debugSourceToString
const char * debugSourceToString(GLenum source)
Converts debug source value to string representation.
Definition: OpenGLUtils.hpp:323
CSCI441::LogUtils::log
void log(const char *MSG,...)
log a message to both the standard output stream and file
Definition: LogUtils.hpp:116
CSCI441::LogUtils::logError
void logError(const char *MSG,...)
log a message to both the standard error stream and file
Definition: LogUtils.hpp:128
CSCI441
CSCI441 Helper Functions for OpenGL.
Definition: ArcballCam.hpp:17
CSCI441::X_AXIS
constexpr glm::vec3 X_AXIS(1.0f, 0.0f, 0.0f)
constant for positive X_AXIS
CSCI441::Y_AXIS_NEG
constexpr glm::vec3 Y_AXIS_NEG(0.0f, -1.0f, 0.0f)
constant for negative Y_AXIS
CSCI441::Y_AXIS_POS
constexpr glm::vec3 Y_AXIS_POS
alias for constant for positive Y_AXIS
Definition: OpenGLUtils.hpp:57
CSCI441::Z_AXIS
constexpr glm::vec3 Z_AXIS(0.0f, 0.0f, 1.0f)
constant for positive Z_AXIS
CSCI441::Z_AXIS_NEG
constexpr glm::vec3 Z_AXIS_NEG(0.0f, 0.0f, -1.0f)
constant for negative Z_AXIS
CSCI441::X_AXIS_POS
constexpr glm::vec3 X_AXIS_POS
alias for constant for positive X_AXIS
Definition: OpenGLUtils.hpp:53
CSCI441::Y_AXIS
constexpr glm::vec3 Y_AXIS(0.0f, 1.0f, 0.0f)
constant for positive Y_AXIS
CSCI441::Z_AXIS_POS
constexpr glm::vec3 Z_AXIS_POS
alias for constant for positive Z_AXIS
Definition: OpenGLUtils.hpp:61
CSCI441::X_AXIS_NEG
constexpr glm::vec3 X_AXIS_NEG(-1.0f, 0.0f, 0.0f)
constant for negative X_AXIS
OpenGLUtils
contains OpenGL Utility functions
Generated by doxygen 1.9.6