/** * Copyright (c) 2006-2014 LOVE Development Team * * This software is provided 'as-is', without any express or implied * warranty. In no event will the authors be held liable for any damages * arising from the use of this software. * * Permission is granted to anyone to use this software for any purpose, * including commercial applications, and to alter it and redistribute it * freely, subject to the following restrictions: * * 1. The origin of this software must not be misrepresented; you must not * claim that you wrote the original software. If you use this software * in a product, an acknowledgment in the product documentation would be * appreciated but is not required. * 2. Altered source versions must be plainly marked as such, and must not be * misrepresented as being the original software. * 3. This notice may not be removed or altered from any source distribution. **/ #ifndef LOVE_GRAPHICS_OPENGL_OPENGL_H #define LOVE_GRAPHICS_OPENGL_OPENGL_H #include "GLee.h" // LOVE #include "graphics/Color.h" #include "graphics/Texture.h" #include "common/Matrix.h" // C++ #include #include // The last argument to AttribPointer takes a buffer offset casted to a pointer. #define BUFFER_OFFSET(i) ((char *) NULL + (i)) namespace love { namespace graphics { namespace opengl { /** * Thin layer between OpenGL and the rest of the program. * Internally shadows some OpenGL context state for improved efficiency and * accuracy (compared to glGet etc.) * A class is more convenient and readable than plain namespaced functions, but * typically only one OpenGL object should be used (singleton.) **/ class OpenGL { public: // OpenGL GPU vendors. enum Vendor { VENDOR_ATI_AMD, VENDOR_NVIDIA, VENDOR_INTEL, VENDOR_MESA_SOFT, // Software renderer. VENDOR_APPLE, // Software renderer. VENDOR_MICROSOFT, // Software renderer. VENDOR_UNKNOWN }; // Vertex attributes used in shaders by LOVE. The values map to OpenGL // generic vertex attribute indices, when applicable. // LOVE uses the old hard-coded attribute APIs for positions, colors, etc. // (for now.) enum VertexAttrib { // Instance ID when pseudo-instancing is used. ATTRIB_PSEUDO_INSTANCE_ID = 1, ATTRIB_MAX_ENUM }; // A rectangle representing an OpenGL viewport or a scissor box. struct Viewport { int x, y; int w, h; Viewport() : x(0), y(0), w(0), h(0) {} Viewport(int _x, int _y, int _w, int _h) : x(_x), y(_y), w(_w), h(_h) {} bool operator == (const Viewport &rhs) const { return x == rhs.x && y == rhs.y && w == rhs.w && h == rhs.h; } }; struct BlendState { GLenum srcRGB, srcA; GLenum dstRGB, dstA; GLenum func; }; struct { std::vector transform; std::vector projection; } matrices; class TempTransform { public: TempTransform(OpenGL &gl) : gl(gl) { gl.pushTransform(); } ~TempTransform() { gl.popTransform(); } Matrix &get() { return gl.getTransform(); } private: OpenGL ≷ }; OpenGL(); /** * Initializes some required context state based on current and default * OpenGL state. Call this directly after creating an OpenGL context! **/ void initContext(); /** * Marks current context state as invalid and deletes OpenGL objects owned * by this class instance. Call this directly before potentially deleting * an OpenGL context! **/ void deInitContext(); void pushTransform(); void popTransform(); Matrix &getTransform(); /** * Set up necessary state (LOVE-provided shader uniforms, etc.) for drawing. * This *MUST* be called directly before OpenGL drawing functions. **/ void prepareDraw(); /** * glDrawArraysInstanced with a pseudo-instancing fallback. **/ void drawArraysInstanced(GLenum mode, GLint first, GLsizei count, GLsizei primcount); /** * glDrawElementsInstanced with a pseudo-instancing fallback. **/ void drawElementsInstanced(GLenum mode, GLsizei count, GLenum type, const void *indices, GLsizei primcount); /** * Sets the current constant color. **/ void setColor(const Color &c); /** * Gets the current constant color. **/ Color getColor() const; /** * Sets the current clear color for all framebuffer objects. **/ void setClearColor(const Color &c); /** * Gets the current clear color. **/ Color getClearColor() const; /** * Sets the OpenGL rendering viewport to the specified rectangle. * The y-coordinate starts at the top. **/ void setViewport(const Viewport &v); /** * Gets the current OpenGL rendering viewport rectangle. **/ Viewport getViewport() const; /** * Sets the scissor box to the specified rectangle. * The y-coordinate starts at the top and is flipped internally. **/ void setScissor(const Viewport &v); /** * Gets the current scissor box (regardless of whether scissoring is enabled.) **/ Viewport getScissor() const; /** * Sets blending functionality. * Note: This does not globally enable or disable blending. **/ void setBlendState(const BlendState &blend); /** * Gets the currently set blending functionality. **/ BlendState getBlendState() const; /** * Helper for setting the active texture unit. * * @param textureunit Index in the range of [0, maxtextureunits-1] **/ void setTextureUnit(int textureunit); /** * Helper for binding an OpenGL texture. * Makes sure we aren't redundantly binding textures. **/ void bindTexture(GLuint texture); /** * Helper for binding a texture to a specific texture unit. * * @param textureunit Index in the range of [0, maxtextureunits-1] * @param restoreprev Restore previously bound texture unit when done. **/ void bindTextureToUnit(GLuint texture, int textureunit, bool restoreprev); /** * Helper for deleting an OpenGL texture. * Cleans up if the texture is currently bound. **/ void deleteTexture(GLuint texture); /** * Sets the texture filter mode for the currently bound texture. * Returns the actual amount of anisotropic filtering set. **/ float setTextureFilter(graphics::Texture::Filter &f); /** * Returns the texture filter mode for the currently bound texture. **/ graphics::Texture::Filter getTextureFilter(); /** * Sets the texture wrap mode for the currently bound texture. **/ void setTextureWrap(const graphics::Texture::Wrap &w); /** * Returns the texture wrap mode for the currently bound texture. **/ graphics::Texture::Wrap getTextureWrap(); /** * Returns the maximum supported width or height of a texture. **/ int getMaxTextureSize() const; /** * Returns the maximum supported number of simultaneous render targets. **/ int getMaxRenderTargets() const; /** * Get the GPU vendor of this OpenGL context. **/ Vendor getVendor() const; // Get human-readable strings for debug info. static const char *debugSeverityString(GLenum severity); static const char *debugSourceString(GLenum source); static const char *debugTypeString(GLenum type); private: void initVendor(); void initOpenGLFunctions(); void initMaxValues(); void initMatrices(); void createDefaultTexture(); bool contextInitialized; float maxAnisotropy; int maxTextureSize; int maxRenderTargets; Vendor vendor; // Tracked OpenGL state. struct { // Current constant color. Color color; Color clearColor; // Texture unit state (currently bound texture for each texture unit.) std::vector textureUnits; // Currently active texture unit. int curTextureUnit; Viewport viewport; Viewport scissor; BlendState blend; // The last ID value used for pseudo-instancing. int lastPseudoInstanceID; Matrix lastProjectionMatrix; Matrix lastTransformMatrix; } state; }; // OpenGL // OpenGL class instance singleton. extern OpenGL gl; } // opengl } // graphics } // love #endif // LOVE_GRAPHICS_OPENGL_OPENGL_H