GL.h

Go to the documentation of this file.

/*
 *  Copyright (c) 2000-2022 Inria
 *  All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *
 *  * Redistributions of source code must retain the above copyright notice,
 *  this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright notice,
 *  this list of conditions and the following disclaimer in the documentation
 *  and/or other materials provided with the distribution.
 *  * Neither the name of the ALICE Project-Team nor the names of its
 *  contributors may be used to endorse or promote products derived from this
 *  software without specific prior written permission.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *  POSSIBILITY OF SUCH DAMAGE.
 *
 *  Contact: Bruno Levy
 *
 *     https://www.inria.fr/fr/bruno-levy
 *
 *     Inria,
 *     Domaine de Voluceau,
 *     78150 Le Chesnay - Rocquencourt
 *     FRANCE
 *
 */
 
#ifndef GEOGRAM_GFX_BASIC_GL
#define GEOGRAM_GFX_BASIC_GL
 
#ifdef GEO_DEBUG
#define GEO_DEBUG_GL
#endif
 
#include <geogram_gfx/basic/common.h>
#include <geogram_gfx/api/defs.h>
 
 
#if defined(GEO_OS_EMSCRIPTEN)
#  define GLFW_INCLUDE_ES2
#  include <GLFW/glfw3.h>
#  define GL_GLEXT_PROTOTYPES
#  include <GLES2/gl2ext.h>
#  define GL_INVALID_INDEX GLuint(-1)
typedef double GLdouble;
#  define glGenVertexArrays glGenVertexArraysOES
#  define glBindVertexArray glBindVertexArrayOES
#  define glDeleteVertexArrays glDeleteVertexArraysOES
#  define GEO_GL_ES2
#  define GEO_GL_NO_DOUBLES
#elif defined(GEO_OS_ANDROID)
#  include <GLES3/gl3.h>
#  include <GLES3/gl31.h>
#  include <GLES3/gl32.h>
#  define GEO_GL_TEXTURE_3D
#  define GEO_GL_ES2
#  define GEO_GL_150
#  define GEO_GL_NO_DOUBLES
#else
#  include <geogram_gfx/third_party/glad/glad.h>
#  define GEO_GL_TEXTURE_3D
#  define GEO_GL_150
#  define GEO_GL_440
#  define GEO_GL_ES2
#endif
 
#include <geogram_gfx/GLUP/GLUP.h>
#include <geogram/basic/geometry.h>
 
// Some defines missing in Emscripten GL headers
#if defined(GEO_OS_EMSCRIPTEN) || defined(GEO_OS_ANDROID)
#   ifndef GL_RGB8
#   define GL_RGB8 0x8051
#   endif
 
#   ifndef GL_RGBA8
#   define GL_RGBA8 0x8058
#   endif
 
#   ifndef GL_R16F
#   define GL_R16F 0x822D
#   endif
 
#   ifndef GL_R32F
#   define GL_R32F 0x822E
#   endif
 
#   ifndef GL_RED
#   define GL_RED 0x1903
#   endif
 
#   ifndef GL_R8
#   define GL_R8 0x8229
#   endif
 
#   ifndef GL_R16
#   define GL_R16 0x822A
#   endif
 
#   ifndef GL_DEPTH_COMPONENT24
#   define GL_DEPTH_COMPONENT24 0x81A6
#   endif
 
#endif
 
namespace GEO {
 
    namespace GL {
        void GEOGRAM_GFX_API initialize();
 
        void GEOGRAM_GFX_API terminate();
    }
 
 
    inline void glupVertex(const vec2& v) {
        glupVertex2dv(v.data());
    }
 
    inline void glupVertex(const vec3& v) {
        glupVertex3dv(v.data());
    }
 
    inline void glupVertex(const vec4& v) {
        glupVertex4dv(v.data());
    }
 
    inline void glupColor(const vec3& v) {
        glupColor3dv(v.data());
    }
 
    inline void glupColor(const vec4& v) {
        glupColor4dv(v.data());
    }
 
 
    inline void glupTexCoord(const vec2& v) {
        glupTexCoord2dv(v.data());
    }
 
    inline void glupTexCoord(const vec3& v) {
        glupTexCoord3dv(v.data());
    }
 
    inline void glupTexCoord(const vec4& v) {
        glupTexCoord4dv(v.data());
    }
 
    inline void glupTranslate(const vec3& v) {
        glupTranslated(v.x, v.y, v.z);
    }
 
    void GEOGRAM_GFX_API glupMapTexCoords1d(
        double minval, double maxval, index_t mult=1
    );
 
    void GEOGRAM_GFX_API glupMultMatrix(const mat4& m);
 
    void GEOGRAM_GFX_API glupLoadMatrix(const mat4& m);
 
    GLint64 GEOGRAM_GFX_API get_size_of_bound_buffer_object(GLenum target);
 
    void GEOGRAM_GFX_API update_buffer_object(
        GLuint& buffer_id, GLenum target, size_t new_size, const void* data
    );
 
    void GEOGRAM_GFX_API stream_buffer_object(
        GLuint& buffer_id, GLenum target, size_t new_size, const void* data
    );
 
 
    void GEOGRAM_GFX_API update_or_check_buffer_object(
        GLuint& buffer_id, GLenum target, size_t new_size, const void* data,
        bool update
    );
 
    void GEOGRAM_GFX_API check_gl(
        const char* file, int line, bool warning_only=false
    );
 
    void GEOGRAM_GFX_API clear_gl_error_flags(const char* file, int line);
 
    void GEOGRAM_GFX_API draw_unit_textured_quad(bool BW=false);
 
#ifdef GEO_DEBUG_GL
#   define GEO_CHECK_GL() ::GEO::check_gl(__FILE__,__LINE__)
#else
#   define GEO_CHECK_GL()
#endif
 
    /***********************************************************/
 
    void GEOGRAM_GFX_API glTexImage2Dxpm(char const* const* xpm_data);
 
}
 
#endif