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