ic
/
magnum
mirror of https://github.com/mosra/magnum.git
6
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
11051 Commits
21 Branches
19 Tags
70 MiB
 
 
 
 
 
Tree: 6236ebaa68
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '6236ebaa68'
${ noResults }
magnum/src/Magnum/GL/Renderer.h

2481 lines
105 KiB
Raw Blame History

#ifndef Magnum_GL_Renderer_h
#define Magnum_GL_Renderer_h
/*
This file is part of Magnum.
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019,
2020, 2021, 2022, 2023 Vladimír Vondruš <mosra@centrum.cz>
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
*/
/** @file
* @brief Class @ref Magnum::GL::Renderer
*/
#include <Corrade/Containers/EnumSet.h>
#include "Magnum/Magnum.h"
#include "Magnum/GL/GL.h"
#include "Magnum/GL/OpenGL.h"
#include "Magnum/GL/visibility.h"
#ifdef MAGNUM_BUILD_DEPRECATED
#include <Corrade/Utility/Macros.h>
#endif
namespace Magnum { namespace GL {
namespace Implementation { struct RendererState; }
/** @nosubgrouping
@brief Global renderer configuration
@todo @gl_extension{ARB,viewport_array}
@todo `GL_POINT_SIZE_GRANULARITY`, `GL_POINT_SIZE_RANGE` (?)
@todo `GL_STEREO`, `GL_DOUBLEBUFFER` (?)
*/
class MAGNUM_GL_EXPORT Renderer {
friend Context;
friend Implementation::RendererState;
public:
Renderer() = delete;
/**
* @brief Affected polygon facing for culling, stencil operations and masks
*
* @see @ref setFaceCullingMode(),
* @ref setStencilFunction(PolygonFacing, StencilFunction, Int, UnsignedInt),
* @ref setStencilOperation(PolygonFacing, StencilOperation, StencilOperation, StencilOperation),
* @ref setStencilMask(PolygonFacing, UnsignedInt)
* @m_enum_values_as_keywords
*/
enum class PolygonFacing: GLenum {
Front = GL_FRONT, /**< Front-facing polygons */
Back = GL_BACK, /**< Back-facing polygons */
FrontAndBack = GL_FRONT_AND_BACK /**< Front- and back-facing polygons */
};
/** @{ @name Renderer features */
/**
* @brief Feature
*
* All features are disabled by default unless specified otherwise.
* @see @ref enable(), @ref disable(), @ref setFeature()
* @m_enum_values_as_keywords
*/
enum class Feature: GLenum {
#ifndef MAGNUM_TARGET_WEBGL
/**
* Disable all rendering operations.
*
* @requires_extension OpenGL 3.0 and extension
* @gl_extension{INTEL,blackhole_render}
* @requires_es_extension Extension
* @gl_extension{INTEL,blackhole_render}
* @requires_gles Blackhole render is not available in WebGL.
* @m_since_latest
*/
BlackholeRender = GL_BLACKHOLE_RENDER_INTEL,
#endif
#ifndef MAGNUM_TARGET_WEBGL
/**
* Coherent advanced blending. Enabled by default if desktop/ES
* extension @gl_extension2{KHR,blend_equation_advanced_coherent,KHR_blend_equation_advanced}
* is available. See @ref blendBarrier() for more information.
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_gles Enabled by default on WebGL if the
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
* is available.
*/
BlendAdvancedCoherent = GL_BLEND_ADVANCED_COHERENT_KHR,
#endif
/**
* Blending
* @see @ref setBlendEquation(), @ref setBlendFunction(),
* @ref setBlendColor()
*/
Blending = GL_BLEND,
#if !(defined(MAGNUM_TARGET_GLES2) && defined(MAGNUM_TARGET_WEBGL))
/**
* Clip geometry against user-defined half-space 0. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 0.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance0 = GL_CLIP_DISTANCE0,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance0 = GL_CLIP_DISTANCE0_APPLE,
#else
ClipDistance0 = GL_CLIP_DISTANCE0_EXT,
#endif
/**
* Clip against user-defined half-space 1. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 1.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance1 = GL_CLIP_DISTANCE1,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance1 = GL_CLIP_DISTANCE1_APPLE,
#else
ClipDistance1 = GL_CLIP_DISTANCE1_EXT,
#endif
/**
* Clip against user-defined half-space 2. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 2.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance2 = GL_CLIP_DISTANCE2,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance2 = GL_CLIP_DISTANCE2_APPLE,
#else
ClipDistance2 = GL_CLIP_DISTANCE2_EXT,
#endif
/**
* Clip against user-defined half-space 3. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 3.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance3 = GL_CLIP_DISTANCE3,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance3 = GL_CLIP_DISTANCE3_APPLE,
#else
ClipDistance3 = GL_CLIP_DISTANCE3_EXT,
#endif
/**
* Clip against user-defined half-space 4. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 4.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance4 = GL_CLIP_DISTANCE4,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance4 = GL_CLIP_DISTANCE4_APPLE,
#else
ClipDistance4 = GL_CLIP_DISTANCE4_EXT,
#endif
/**
* Clip against user-defined half-space 5. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 5.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance5 = GL_CLIP_DISTANCE5,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance5 = GL_CLIP_DISTANCE5_APPLE,
#else
ClipDistance5 = GL_CLIP_DISTANCE5_EXT,
#endif
/**
* Clip against user-defined half-space 6. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 6.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance6 = GL_CLIP_DISTANCE6,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance6 = GL_CLIP_DISTANCE6_APPLE,
#else
ClipDistance6 = GL_CLIP_DISTANCE6_EXT,
#endif
/**
* Clip against user-defined half-space 7. This enables
* use of the @glsl gl_ClipDistance[] @ce /
* @glsl gl_CullDistance[] @ce GLSL builtin at index 7.
* @see @ref maxClipDistances(), @ref maxCullDistances(),
* @ref maxCombinedClipAndCullDistances()
* @requires_gl30 Shader-defined clip distances are not available
* in OpenGL 2.1.
* @requires_es_extension Extension
* @gl_extension{APPLE,clip_distance} or
* @gl_extension{EXT,clip_cull_distance}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{WEBGL,clip_cull_distance} (originally
* named `EXT_clip_cull_distance`)
* @m_since{2020,06}
*/
#ifndef MAGNUM_TARGET_GLES
ClipDistance7 = GL_CLIP_DISTANCE7,
#elif defined(MAGNUM_TARGET_GLES2)
ClipDistance7 = GL_CLIP_DISTANCE7_APPLE,
#else
ClipDistance7 = GL_CLIP_DISTANCE7_EXT,
#endif
#endif
#ifndef MAGNUM_TARGET_WEBGL
/**
* Debug output. Disabled by default unless the GL context was
* created with debug output enabled.
* @see @ref DebugOutput, @ref Feature::DebugOutputSynchronous,
* @ref Platform::Sdl2Application::GLConfiguration::Flag::Debug "Platform::*Application::GLConfiguration::Flag::Debug"
* @requires_gl43 Extension @gl_extension{KHR,debug}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,debug}
* @requires_gles Debug output is not available in WebGL.
*/
#ifndef MAGNUM_TARGET_GLES2
DebugOutput = GL_DEBUG_OUTPUT,
#else
DebugOutput = GL_DEBUG_OUTPUT_KHR,
#endif
/**
* Synchronous debug output. Has effect only if
* @ref Feature::DebugOutput is enabled.
* @see @ref DebugMessage
* @requires_gl43 Extension @gl_extension{KHR,debug}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,debug}
* @requires_gles Debug output is not available in WebGL.
*/
#ifndef MAGNUM_TARGET_GLES2
DebugOutputSynchronous = GL_DEBUG_OUTPUT_SYNCHRONOUS,
#else
DebugOutputSynchronous = GL_DEBUG_OUTPUT_SYNCHRONOUS_KHR,
#endif
#endif
/**
* Depth clamping. If enabled, ignores near and far clipping plane.
* @requires_gl32 Extension @gl_extension{ARB,depth_clamp}
* @requires_es_extension Extension @gl_extension{EXT,depth_clamp}
* @requires_webgl_extension Extension @webgl_extension{EXT,depth_clamp}
*/
#ifndef MAGNUM_TARGET_GLES
DepthClamp = GL_DEPTH_CLAMP,
#else
DepthClamp = GL_DEPTH_CLAMP_EXT,
#endif
/**
* Depth test
* @see @ref setClearDepth(), @ref setDepthFunction(),
* @ref setDepthMask()
*/
DepthTest = GL_DEPTH_TEST,
Dithering = GL_DITHER, /**< Dithering. Enabled by default. */
/**
* Back face culling
* @see @ref setFrontFace()
*/
FaceCulling = GL_CULL_FACE,
#ifndef MAGNUM_TARGET_WEBGL
/**
* Perform sRGB conversion of values written to sRGB framebuffers.
* Disabled by default on desktop GL, enabled by default on OpenGL
* ES.
* @requires_gl30 Extension @gl_extension{ARB,framebuffer_sRGB}
* @requires_es_extension @gl_extension{EXT,sRGB_write_control}. If
* the extension is not present, there's no ability to turn
* the sRGB conversion off.
* @requires_gles WebGL has no ability to turn the sRGB conversion
* off.
*/
#ifndef MAGNUM_TARGET_GLES
FramebufferSrgb = GL_FRAMEBUFFER_SRGB,
#else
FramebufferSrgb = GL_FRAMEBUFFER_SRGB_EXT,
#endif
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* Logical operation
* @see @ref setLogicOperation()
* @requires_gl Logical operations on framebuffer are not
* available in OpenGL ES and WebGL.
*/
LogicOperation = GL_COLOR_LOGIC_OP,
/**
* Multisampling. Enabled by default. Note that the actual presence
* of this feature in default framebuffer depends on context
* configuration, see for example @ref Platform::Sdl2Application::GLConfiguration::setSampleCount().
* @requires_gl Always enabled in OpenGL ES and WebGL.
*/
Multisampling = GL_MULTISAMPLE,
#endif
/**
* Offset filled polygons
* @see @ref Feature::PolygonOffsetLine, @ref Feature::PolygonOffsetPoint,
* @ref setPolygonOffset()
*/
PolygonOffsetFill = GL_POLYGON_OFFSET_FILL,
/**
* Offset lines. Note that this affects only filled polygons
* rendered with @ref setPolygonMode() set to
* @ref PolygonMode::Line, not actual line primitives.
* @see @ref Feature::PolygonOffsetFill, @ref Feature::PolygonOffsetPoint,
* @ref setPolygonOffset()
* @requires_es_extension Extension @gl_extension{NV,polygon_offset}
* or @m_class{m-doc-external} [ANGLE_polygon_mode](https://chromium.googlesource.com/angle/angle/+/HEAD/extensions/ANGLE_polygon_mode.txt)
* @requires_webgl_extension Extension @webgl_extension{WEBGL,polygon_mode}.
* Note that this extension is only implemented since
* Emscripten 3.1.66 and thus it's not even advertised on
* older versions.
*/
#ifndef MAGNUM_TARGET_GLES
PolygonOffsetLine = GL_POLYGON_OFFSET_LINE,
#elif !defined(MAGNUM_TARGET_WEBGL)
PolygonOffsetLine = GL_POLYGON_OFFSET_LINE_NV,
#else
PolygonOffsetLine = GL_POLYGON_OFFSET_LINE_WEBGL,
#endif
#ifndef MAGNUM_TARGET_WEBGL
/**
* Offset points. Note that this affects only filled polygons
* rendered with @ref setPolygonMode() set to
* @ref PolygonMode::Point, not actual point primitives.
* @see @ref Feature::PolygonOffsetFill, @ref Feature::PolygonOffsetLine,
* @ref setPolygonOffset()
* @requires_es_extension Extension @gl_extension{NV,polygon_offset}
* @requires_gles Only @ref Feature::PolygonOffsetFill and
* @ref Feature::PolygonOffsetPoint is available in WebGL.
*/
#ifndef MAGNUM_TARGET_GLES
PolygonOffsetPoint = GL_POLYGON_OFFSET_POINT,
#else
PolygonOffsetPoint = GL_POLYGON_OFFSET_POINT_NV,
#endif
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* Programmable point size. If enabled, the point size is taken
* from vertex/geometry shader builtin @glsl gl_PointSize @ce.
* @see @ref setPointSize()
* @m_keywords{gl_PointSize}
* @requires_gl Always enabled on OpenGL ES and WebGL.
*/
ProgramPointSize = GL_PROGRAM_POINT_SIZE,
#endif
#ifndef MAGNUM_TARGET_GLES2
/**
* Discard primitives before rasterization.
* @requires_gl30 Extension @gl_extension{EXT,transform_feedback}
* @requires_gles30 Transform feedback is not available in OpenGL
* ES 2.0.
* @requires_webgl20 Transform feedback is not available in WebGL
* 1.0.
*/
RasterizerDiscard = GL_RASTERIZER_DISCARD,
#endif
/**
* Transforms a fragment's alpha value into a coverage value to
* determine its contribution to the final pixel value in a
* multisampled framebuffer.
* @m_since_latest
* @see @ref Feature::SampleAlphaToOne,
* @ref Feature::SampleCoverage, @ref setSampleCoverage()
*/
SampleAlphaToCoverage = GL_SAMPLE_ALPHA_TO_COVERAGE,
#ifndef MAGNUM_TARGET_GLES
/**
* Replaces each sample alpha value by the maximum representable
* alpha value.
* @m_since_latest
* @see @ref Feature::SampleAlphaToCoverage,
* @ref Feature::SampleCoverage, @ref setSampleCoverage()
* @requires_gl Sample alpha to one is not available in OpenGL ES
* and WebGL.
*/
SampleAlphaToOne = GL_SAMPLE_ALPHA_TO_ONE,
#endif
/**
* Combines the fragment coverage with the coverage value set in
* @ref setSampleCoverage().
* @m_since_latest
* @see @ref Feature::SampleAlphaToCoverage,
* @ref Feature::SampleAlphaToOne
*/
SampleCoverage = GL_SAMPLE_COVERAGE,
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* Sample shading.
* @see @ref setMinSampleShading()
* @requires_gl40 Extension @gl_extension{ARB,sample_shading}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a}
* / @gl_extension{OES,sample_shading}
* @requires_gles30 Sample shading is not defined in OpenGL ES 2.0.
* @requires_gles Sample shading is not available in WebGL.
*/
SampleShading = GL_SAMPLE_SHADING,
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* Seamless cube map texture.
* @see @ref CubeMapTexture, @ref CubeMapTextureArray
* @requires_gl32 Extension @gl_extension{ARB,seamless_cube_map}
* @requires_gl Not available in OpenGL ES 2.0 and WebGL 1.0,
* always enabled in OpenGL ES 3.0 and WebGL 2.0.
*/
SeamlessCubeMapTexture = GL_TEXTURE_CUBE_MAP_SEAMLESS,
#endif
/**
* Scissor test
* @see @ref setScissor()
*/
ScissorTest = GL_SCISSOR_TEST,
/**
* Stencil test
* @see @ref setClearStencil(), @ref setStencilFunction(),
* @ref setStencilOperation(), @ref setStencilMask()
*/
StencilTest = GL_STENCIL_TEST
};
/**
* @brief Line width range
*
* The result is cached, repeated queries don't result in repeated
* OpenGL calls. Note that lines wider than @cpp 1.0f @ce are supported
* only when the context is not forward-compatible. Smooth lines are
* @ref opengl-unsupported "not supported by design".
* @see @ref setLineWidth(), @fn_gl{Get} with
* @def_gl_keyword{ALIASED_LINE_WIDTH_RANGE}
*/
static Range1D lineWidthRange();
/**
* @brief Enable a feature
*
* @see @ref disable(), @ref setFeature(), @fn_gl_keyword{Enable}
*/
static void enable(Feature feature);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Enable a feature for given draw buffer
* @param feature Feature to enable
* @param drawBuffer Draw buffer index
* @m_since{2020,06}
*
* @see @ref disable(Feature, UnsignedInt),
* @ref setFeature(Feature, UnsignedInt, bool),
* @ref GL-Framebuffer-usage-multiple-outputs,
* @fn_gl2_keyword{Enablei,Enable}
* @requires_gl30 Extension @gl_extension{EXT,draw_buffers2}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void enable(Feature feature, UnsignedInt drawBuffer);
#endif
/**
* @brief Disable a feature
*
* @see @ref enable(), @ref setFeature(), @fn_gl_keyword{Disable}
*/
static void disable(Feature feature);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Disable a feature for given draw buffer
* @param feature Feature to disable
* @param drawBuffer Draw buffer index
* @m_since{2020,06}
*
* @see @ref enable(Feature, UnsignedInt),
* @ref setFeature(Feature, UnsignedInt, bool),
* @ref GL-Framebuffer-usage-multiple-outputs
* @fn_gl2_keyword{Disablei,Disable}
* @requires_gl30 Extension @gl_extension{EXT,draw_buffers2}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void disable(Feature feature, UnsignedInt drawBuffer);
#endif
/**
* @brief Enable or disable a feature
*
* Convenience equivalent to the following:
*
* @snippet GL.cpp Renderer-setFeature
*
* Prefer to use @ref enable() and @ref disable() directly to avoid
* unnecessary branching.
*/
static void setFeature(Feature feature, bool enabled);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Enable or disable a feature for given draw buffer
* @param feature Feature to toggle
* @param drawBuffer Draw buffer index
* @param enabled Enable or disable
*
* @see @ref enable(Feature, UnsignedInt),
* @ref disable(Feature, UnsignedInt),
* @ref GL-Framebuffer-usage-multiple-outputs
* @requires_gl30 Extension @gl_extension{EXT,draw_buffers2}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void setFeature(Feature feature, UnsignedInt drawBuffer, bool enabled);
#endif
/**
* @brief Hint
*
* @see @ref setHint()
* @m_enum_values_as_keywords
* @todo other hints
*/
enum class Hint: GLenum {
/**
* Accuracy of derivative calculation in fragment shader.
* @requires_gles30 Extension @gl_extension{OES,standard_derivatives}
* in OpenGL ES 2.0.
* @requires_webgl20 Extension @webgl_extension{OES,standard_derivatives}
* in WebGL 1.0.
*/
#ifndef MAGNUM_TARGET_GLES2
FragmentShaderDerivative = GL_FRAGMENT_SHADER_DERIVATIVE_HINT,
#else
FragmentShaderDerivative = GL_FRAGMENT_SHADER_DERIVATIVE_HINT_OES,
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* Quality and performance of texture image compression.
* @requires_gl On-the-fly texture image compression is not
* available in OpenGL ES.
*/
TextureCompression = GL_TEXTURE_COMPRESSION_HINT
#endif
};
/**
* @brief Hint mode
*
* @see @ref setHint()
* @m_enum_values_as_keywords
*/
enum class HintMode: GLenum {
Fastest = GL_FASTEST, /**< Most efficient option. */
Nicest = GL_NICEST, /**< Most correct or highest quality option. */
DontCare = GL_DONT_CARE /**< No preference. */
};
/**
* @brief Set hint
*
* Initial value is @ref HintMode::DontCare for all targets.
* @see @fn_gl_keyword{Hint}
*/
static void setHint(Hint target, HintMode mode);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Clearing values */
/**
* @brief Set clear color
*
* Initial value is @cpp 0x1f1f1f_rgbf @ce.
* @see @ref Framebuffer::clearColor() "*Framebuffer::clearColor()",
* @fn_gl_keyword{ClearColor}
* @deprecated_gl Prefer to use @ref Framebuffer::clearColor() "*Framebuffer::clearColor()"
* instead of @ref setClearColor() and
* @ref AbstractFramebuffer::clear() as it leads to less state
* changes.
*/
static void setClearColor(const Color4& color);
#ifndef MAGNUM_TARGET_GLES
/**
* @brief Set clear depth
*
* Initial value is @cpp 1.0 @ce. If the
* @gl_extension{NV,depth_buffer_float} desktop extension is available,
* the function uses the
* @fn_gl_extension_keyword{ClearDepthd,NV,depth_buffer_float} API
* which doesn't clamp the input to the @f$ [0, 1] @f$ range.
* @see @ref Feature::DepthTest, @ref AbstractFramebuffer::clearDepth(),
* @ref AbstractFramebuffer::clearDepthStencil(),
* @ref setDepthRange(), @fn_gl_keyword{ClearDepth}
* @requires_gl See @ref setClearDepth(Float), which is available in
* OpenGL ES and WebGL.
* @deprecated_gl Prefer to use @ref AbstractFramebuffer::clearDepth()
* / @ref AbstractFramebuffer::clearDepthStencil() instead of
* @ref setClearDepth() and @ref AbstractFramebuffer::clear() as
* it leads to less state changes.
*/
static void setClearDepth(Double depth);
#endif
/**
* @overload
*
* Initial value is @cpp 1.0f @ce. If the
* @gl_extension{NV,depth_buffer_float} desktop extension is available,
* the function behaves exactly as @ref setClearDepth(Double) for
* consistent clamping behavior between the two overloads. Otherwise,
* if OpenGL ES, OpenGL 4.1 or extension
* @gl_extension{ARB,ES2_compatibility} is available, this function
* uses the @fn_gl2_keyword{ClearDepthf,ClearDepth} API. Otherwise it
* behaves exactly as @ref setClearDepth(Double).
* @see @ref Feature::DepthTest, @ref AbstractFramebuffer::clearDepth(),
* @ref AbstractFramebuffer::clearDepthStencil(),
* @ref setDepthRange()
* @deprecated_gl Prefer to use @ref AbstractFramebuffer::clearDepth()
* / @ref AbstractFramebuffer::clearDepthStencil() instead of
* @ref setClearDepth() and @ref AbstractFramebuffer::clear() as
* it leads to less state changes.
*/
static void setClearDepth(Float depth);
/**
* @brief Set clear stencil
*
* Initial value is @cpp 0 @ce.
* @see @ref Feature::StencilTest, @ref AbstractFramebuffer::clearStencil(),
* @ref AbstractFramebuffer::clearDepthStencil(),
* @fn_gl_keyword{ClearStencil}
* @deprecated_gl Prefer to use @ref AbstractFramebuffer::clearStencil()
* / @ref AbstractFramebuffer::clearDepthStencil() instead of
* @ref setClearStencil() and @ref AbstractFramebuffer::clear() as
* it leads to less state changes.
*/
static void setClearStencil(Int stencil);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Polygon drawing settings */
/**
* @brief Front facing polygon winding
*
* @see @ref setFrontFace()
* @m_enum_values_as_keywords
*/
enum class FrontFace: GLenum {
/** Counterclockwise polygons are front facing (default). */
CounterClockWise = GL_CCW,
/** Clockwise polygons are front facing. */
ClockWise = GL_CW
};
/**
* @brief Set front-facing polygon winding
*
* Initial value is @ref FrontFace::CounterClockWise.
* @see @ref setFaceCullingMode(), @fn_gl_keyword{FrontFace}
*/
static void setFrontFace(FrontFace mode);
/**
* @brief Which polygon facing to cull
*
* Initial value is @ref PolygonFacing::Back. If set to both front and
* back, only points and lines are drawn.
* @see @ref Feature::FaceCulling, @ref setFrontFace(),
* @fn_gl_keyword{CullFace}
*/
static void setFaceCullingMode(PolygonFacing mode);
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* @brief Provoking vertex
*
* @see @ref setProvokingVertex()
* @m_enum_values_as_keywords
* @requires_gl32 Extension @gl_extension{ARB,provoking_vertex}. Older
* versions behave always like @ref ProvokingVertex::LastVertexConvention.
* @requires_es_extension OpenGL ES 3.0 and extension
* @m_class{m-doc-external} [ANGLE_provoking_vertex](https://chromium.googlesource.com/angle/angle/+/main/extensions/ANGLE_provoking_vertex.txt).
* Without the extension behaves always like
* @ref ProvokingVertex::LastVertexConvention.
* @requires_gles WebGL behaves always like
* @ref ProvokingVertex::LastVertexConvention.
*/
enum class ProvokingVertex: GLenum {
/** Use first vertex of each polygon. */
#ifndef MAGNUM_TARGET_GLES
FirstVertexConvention = GL_FIRST_VERTEX_CONVENTION,
#else
FirstVertexConvention = GL_FIRST_VERTEX_CONVENTION_ANGLE,
#endif
/** Use last vertex of each polygon (default). */
#ifndef MAGNUM_TARGET_GLES
LastVertexConvention = GL_LAST_VERTEX_CONVENTION
#else
LastVertexConvention = GL_LAST_VERTEX_CONVENTION_ANGLE
#endif
};
/**
* @brief Set provoking vertex
*
* Initial value is @ref ProvokingVertex::LastVertexConvention.
* @see @fn_gl_keyword{ProvokingVertex}
* @requires_gl32 Extension @gl_extension{ARB,provoking_vertex}. Older
* versions behave always like the default.
* @requires_es_extension OpenGL ES 3.0 and extension
* @m_class{m-doc-external} [ANGLE_provoking_vertex](https://chromium.googlesource.com/angle/angle/+/main/extensions/ANGLE_provoking_vertex.txt)
* @requires_gles WebGL behaves always like the default.
*/
static void setProvokingVertex(ProvokingVertex mode);
#endif
/**
* @brief Polygon mode
*
* @see @ref setPolygonMode()
* @m_enum_values_as_keywords
* @requires_es_extension Extension @gl_extension{NV,polygon_mode} or
* @m_class{m-doc-external} [ANGLE_polygon_mode](https://chromium.googlesource.com/angle/angle/+/HEAD/extensions/ANGLE_polygon_mode.txt).
* Otherwise behaves always like @ref PolygonMode::Fill. See
* @ref Mesh::setPrimitive() for a possible workaround.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,polygon_mode}.
* Note that this extension is only implemented since Emscripten
* 3.1.66 and thus it's not even advertised on older versions.
* Otherwise behaves always like @ref PolygonMode::Fill. See
* @ref Mesh::setPrimitive() for a possible workaround.
*/
enum class PolygonMode: GLenum {
/**
* Interior of the polygon is filled (default).
*/
#ifndef MAGNUM_TARGET_GLES
Fill = GL_FILL,
#elif !defined(MAGNUM_TARGET_WEBGL)
Fill = GL_FILL_NV,
#else
Fill = GL_FILL_WEBGL,
#endif
/**
* Boundary edges are filled. See also @ref setLineWidth().
*/
#ifndef MAGNUM_TARGET_GLES
Line = GL_LINE,
#elif !defined(MAGNUM_TARGET_WEBGL)
Line = GL_LINE_NV,
#else
Line = GL_LINE_WEBGL,
#endif
#ifndef MAGNUM_TARGET_WEBGL
/**
* Starts of boundary edges are drawn as points. See also
* @ref setPointSize().
* @requires_es_extension Extension @gl_extension{NV,polygon_mode},
* not available with @m_class{m-doc-external} [ANGLE_polygon_mode](https://chromium.googlesource.com/angle/angle/+/HEAD/extensions/ANGLE_polygon_mode.txt)
* @requires_gles Not available in @webgl_extension{WEBGL,polygon_mode}
*/
#ifndef MAGNUM_TARGET_GLES
Point = GL_POINT
#else
Point = GL_POINT_NV
#endif
#endif
};
/**
* @brief Set polygon drawing mode
*
* Initial value is @ref PolygonMode::Fill.
* @see @fn_gl_keyword{PolygonMode}
* @requires_es_extension Extension @gl_extension{NV,polygon_mode} or
* @m_class{m-doc-external} [ANGLE_polygon_mode](https://chromium.googlesource.com/angle/angle/+/HEAD/extensions/ANGLE_polygon_mode.txt).
* Otherwise behaves always like the default. See
* @ref Mesh::setPrimitive() for possible workaround.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,polygon_mode}.
* Note that this extension is only implemented since Emscripten
* 3.1.66 and thus it's not even advertised on older versions.
* Otherwise behaves always like the default. See
* @ref Mesh::setPrimitive() for possible workaround.
*/
static void setPolygonMode(PolygonMode mode);
/**
* @brief Set polygon offset
* @param factor Scale factor
* @param units Offset units
*
* @see @ref Feature::PolygonOffsetFill, @ref Feature::PolygonOffsetLine,
* @ref Feature::PolygonOffsetPoint, @fn_gl{PolygonOffset}
*/
static void setPolygonOffset(Float factor, Float units);
/**
* @brief Set line width
*
* Initial value is @cpp 1.0f @ce. Note that on contexts that are
* @ref Context::Flag::ForwardCompatible the max supported value is
* @cpp 1.0f @ce --- request a non-forward-compatible context to get
* wide lines on supported hardware.
* @see @ref lineWidthRange(), @fn_gl_keyword{LineWidth}
*/
static void setLineWidth(Float width);
#ifndef MAGNUM_TARGET_GLES
/**
* @brief Set point size
*
* Initial value is @cpp 1.0f @ce.
* @see @ref Feature::ProgramPointSize, @fn_gl_keyword{PointSize}
* @m_keywords{gl_PointSize}
* @requires_gl Use `gl_PointSize` builtin vertex shader variable in
* OpenGL ES and WebGL instead.
*/
static void setPointSize(Float size);
#endif
/**
* @brief Set sample coverage parameters
* @m_since_latest
*
* Initial value is @cpp 1.0f @ce and @cpp false @ce.
* @see @ref Feature::SampleCoverage, @fn_gl_keyword{SampleCoverage}
*/
static void setSampleCoverage(Float value, bool invert);
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* @brief Set min sample shading value
*
* @see @ref Feature::SampleShading, @fn_gl_keyword{MinSampleShading}
* @requires_gl40 Extension @gl_extension{ARB,sample_shading}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{OES,sample_shading}
* @requires_gles30 Sample shading is not defined in OpenGL ES 2.0.
* @requires_gles Sample shading is not available in WebGL.
*/
static void setMinSampleShading(Float value);
#endif
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* @brief Max supported component patch vertex count
* @m_since{2020,06}
*
* The result is cached, repeated queries don't result in repeated
* OpenGL calls. If neither @gl_extension{ARB,tessellation_shader} (part
* of OpenGL 4.0) nor @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,tessellation_shader} ES extension is available,
* returns @cpp 0 @ce.
* @see @fn_gl{Get} with @def_gl_keyword{MAX_PATCH_VERTICES}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles Tessellation shaders are not available in WebGL.
*/
static UnsignedInt maxPatchVertexCount();
/**
* @brief Set tessellation patch vertex count
* @m_since{2020,06}
*
* Specifies number of vertices that will be used to make up a single
* tessellation patch primitive.
* @see @ref maxPatchVertexCount(),
* @fn_gl_keyword{PatchParameter} with @def_gl{PATCH_VERTICES}
* @requires_gl40 Extension @gl_extension{ARB,tessellation_shader}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,tessellation_shader}
* @requires_gles Tessellation shaders are not available in WebGL.
*/
static void setPatchVertexCount(UnsignedInt count);
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* @brief Set default patch inner tessellation level
* @m_since{2020,06}
*
* When no tessellation control shader is present, specifies the
* default inner tessellation levels to be used.
* @see @fn_gl_keyword{PatchParameter} with
* @def_gl{PATCH_DEFAULT_INNER_LEVEL}
* @requires_gl40 Extension @gl_extension{ARB,tessellation_shader}
* @requires_gl A tessellation control shader has to be always present
* in OpenGL ES.
*/
static void setPatchDefaultInnerLevel(const Vector2& levels);
/**
* @brief Set default patch outer tessellation level
* @m_since{2020,06}
*
* When no tessellation control shader is present, specifies the
* default outer tessellation levels to be used.
* @see @fn_gl_keyword{PatchParameter} with
* @def_gl{PATCH_DEFAULT_OUTER_LEVEL}
* @requires_gl40 Extension @gl_extension{ARB,tessellation_shader}
* @requires_gl A tessellation control shader has to be always present
* in OpenGL ES.
*/
static void setPatchDefaultOuterLevel(const Vector4& levels);
#endif
#if !(defined(MAGNUM_TARGET_GLES2) && defined(MAGNUM_TARGET_WEBGL))
/**
* @brief Max supported clip distance count
* @m_since{2020,06}
*
* The result is cached, repeated queries don't result in repeated
* OpenGL calls. If neither OpenGL 3.0 nor
* @gl_extension{APPLE,clip_distance} /
* @gl_extension{EXT,clip_cull_distance} ES extension nor
* @webgl_extension{WEBGL,clip_cull_distance} WebGL extension
* (originally named `EXT_clip_cull_distance`) is available, returns
* @cpp 0 @ce.
* @see @fn_gl{Get} with @def_gl_keyword{MAX_CLIP_DISTANCES}
* @requires_webgl20 Not defined in WebGL 1.0 builds.
*/
static UnsignedInt maxClipDistances();
#endif
#ifndef MAGNUM_TARGET_GLES2
/**
* @brief Max supported cull distance count
* @m_since{2020,06}
*
* The result is cached, repeated queries don't result in repeated
* OpenGL calls. If neither @gl_extension{ARB,cull_distance} (part of
* OpenGL 4.5) nor @gl_extension{EXT,clip_cull_distance} ES /
* @webgl_extension{WEBGL,clip_cull_distance} WebGL extension
* (originally named `EXT_clip_cull_distance`) is available, returns
* @cpp 0 @ce.
* @see @fn_gl{Get} with @def_gl_keyword{MAX_CULL_DISTANCES}
* @requires_gles30 Not defined in OpenGL ES 2.0 builds.
* @requires_webgl20 Not defined in WebGL 1.0 builds.
*/
static UnsignedInt maxCullDistances();
/**
* @brief Max supported combined clip and cull distance count
* @m_since{2020,06}
*
* The result is cached, repeated queries don't result in repeated
* OpenGL calls. If neither @gl_extension{ARB,cull_distance} (part of
* OpenGL 4.5) nor @gl_extension{EXT,clip_cull_distance} ES /
* @webgl_extension{WEBGL,clip_cull_distance} WebGL extension
* (originally named `EXT_clip_cull_distance`) is available, returns
* @cpp 0 @ce.
* @see @fn_gl{Get} with @def_gl_keyword{MAX_COMBINED_CLIP_AND_CULL_DISTANCES}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_webgl20 Not defined in WebGL 1.0 builds.
*/
static UnsignedInt maxCombinedClipAndCullDistances();
#endif
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Scissor operations */
/**
* @brief Set scissor rectangle
*
* Initial value is set to cover whole window.
* @see @ref Feature::ScissorTest, @fn_gl_keyword{Scissor}
*/
static void setScissor(const Range2Di& rectangle);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Stencil operations */
/**
* @brief Stencil function
*
* @see @ref setStencilFunction(), @ref DepthFunction
* @m_enum_values_as_keywords
*/
enum class StencilFunction: GLenum {
Never = GL_NEVER, /**< Never pass the test. */
Always = GL_ALWAYS, /**< Always pass the test. */
Less = GL_LESS, /**< Pass when reference value is less than buffer value. */
LessOrEqual = GL_LEQUAL, /**< Pass when reference value is less than or equal to buffer value. */
Equal = GL_EQUAL, /**< Pass when reference value is equal to buffer value. */
NotEqual = GL_NOTEQUAL, /**< Pass when reference value is not equal to buffer value. */
GreaterOrEqual = GL_GEQUAL, /**< Pass when reference value is greater than or equal to buffer value. */
Greater = GL_GREATER /**< Pass when reference value is greater than buffer value. */
};
/**
* @brief Stencil operation
*
* @see @ref setStencilOperation()
* @m_enum_values_as_keywords
*/
enum class StencilOperation: GLenum {
Keep = GL_KEEP, /**< Keep the current value. */
Zero = GL_ZERO, /**< Set the stencil buffer value to @cpp 0 @ce. */
/**
* Set the stencil value to reference value specified by
* @ref setStencilFunction().
*/
Replace = GL_REPLACE,
/**
* Increment the current stencil buffer value, clamp to maximum
* possible value on overflow.
*/
Increment = GL_INCR,
/**
* Increment the current stencil buffer value, wrap to zero on
* overflow.
*/
IncrementWrap = GL_INCR_WRAP,
/**
* Increment the current stencil buffer value, clamp to minimum
* possible value on underflow.
*/
Decrement = GL_DECR,
/**
* Decrement the current stencil buffer value, wrap to maximum
* possible value on underflow.
*/
DecrementWrap = GL_DECR_WRAP,
/**
* Bitwise invert the current stencil buffer value.
*/
Invert = GL_INVERT
};
/**
* @brief Set stencil function
* @param facing Affected polygon facing
* @param function Stencil function. Initial value is
* @ref StencilFunction::Always.
* @param referenceValue Reference value. Initial value is @cpp 0 @ce.
* @param mask Mask for both reference and buffer value.
* Initial value is all @cpp 1 @ce s.
*
* @see @ref Feature::StencilTest, @ref setStencilFunction(StencilFunction, Int, UnsignedInt),
* @ref setStencilOperation(), @fn_gl{StencilFuncSeparate}
* @requires_gles In WebGL the reference value and mask must be the
* same for both front and back polygon facing.
*/
static void setStencilFunction(PolygonFacing facing, StencilFunction function, Int referenceValue, UnsignedInt mask);
/**
* @brief Set stencil function
*
* The same as @ref setStencilFunction(PolygonFacing, StencilFunction, Int, UnsignedInt)
* with @p facing set to @ref PolygonFacing::FrontAndBack.
* @see @ref Feature::StencilTest, @ref setStencilOperation(),
* @fn_gl_keyword{StencilFunc}
*/
static void setStencilFunction(StencilFunction function, Int referenceValue, UnsignedInt mask);
/**
* @brief Set stencil operation
* @param facing Affected polygon facing
* @param stencilFail Action when stencil test fails
* @param depthFail Action when stencil test passes, but depth
* test fails
* @param depthPass Action when both stencil and depth test
* pass
*
* Initial value for all fields is @ref StencilOperation::Keep.
* @see @ref Feature::StencilTest, @ref setStencilOperation(StencilOperation, StencilOperation, StencilOperation),
* @ref setStencilFunction(), @fn_gl_keyword{StencilOpSeparate}
*/
static void setStencilOperation(PolygonFacing facing, StencilOperation stencilFail, StencilOperation depthFail, StencilOperation depthPass);
/**
* @brief Set stencil operation
*
* The same as @ref setStencilOperation(PolygonFacing, StencilOperation, StencilOperation, StencilOperation)
* with @p facing set to @ref PolygonFacing::FrontAndBack.
* @see @ref Feature::StencilTest, @ref setStencilFunction(),
* @fn_gl_keyword{StencilOp}
*/
static void setStencilOperation(StencilOperation stencilFail, StencilOperation depthFail, StencilOperation depthPass);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Depth testing and clip control */
/**
* @brief Clip origin
* @m_since_latest
*
* @see @ref setClipControl()
* @m_enum_values_as_keywords
* @requires_gl45 Extension @gl_extension{ARB,clip_control}
* @requires_es_extension Extension @gl_extension{EXT,clip_control}
* @requires_webgl_extension Extension @webgl_extension{EXT,clip_control}.
* Note that this extension is only implemented since Emscripten
* 3.1.66 and thus it's not even advertised on older versions.
*/
enum class ClipOrigin: GLenum {
/** Lower left */
#ifndef MAGNUM_TARGET_GLES
LowerLeft = GL_LOWER_LEFT,
#else
LowerLeft = GL_LOWER_LEFT_EXT,
#endif
/** Upper left */
#ifndef MAGNUM_TARGET_GLES
UpperLeft = GL_UPPER_LEFT,
#else
UpperLeft = GL_UPPER_LEFT_EXT,
#endif
};
/**
* @brief Clip depth
* @m_since_latest
*
* @see @ref setClipControl()
* @m_enum_values_as_keywords
* @requires_gl45 Extension @gl_extension{ARB,clip_control}
* @requires_es_extension Extension @gl_extension{EXT,clip_control}
* @requires_webgl_extension Extension @webgl_extension{EXT,clip_control}.
* Note that this extension is only implemented since Emscripten
* 3.1.66 and thus it's not even advertised on older versions.
*/
enum class ClipDepth: GLenum {
/** -1 to 1 */
#ifndef MAGNUM_TARGET_GLES
NegativeOneToOne = GL_NEGATIVE_ONE_TO_ONE,
#else
NegativeOneToOne = GL_NEGATIVE_ONE_TO_ONE_EXT,
#endif
/** 0 to 1 */
#ifndef MAGNUM_TARGET_GLES
ZeroToOne = GL_ZERO_TO_ONE,
#else
ZeroToOne = GL_ZERO_TO_ONE_EXT,
#endif
};
/**
* @brief Depth function
*
* @see @ref setDepthFunction()
*/
typedef StencilFunction DepthFunction;
/**
* @brief Set depth function
*
* Initial value is @ref DepthFunction::Less.
* @see @ref Feature::DepthTest, @fn_gl_keyword{DepthFunc}
*/
static void setDepthFunction(DepthFunction function);
#ifndef MAGNUM_TARGET_GLES
/**
* @brief Set depth range
* @m_since_latest
*
* Initial value is @cpp 0.0 @ce and @cpp 1.0 @ce. If the
* @gl_extension{NV,depth_buffer_float} desktop extension is available,
* the function uses the
* @fn_gl_extension_keyword{DepthRanged,NV,depth_buffer_float} API
* which doesn't clamp the input to the @f$ [0, 1] @f$ range.
* @see @fn_gl_keyword{DepthRange}
* @requires_gl See @ref setClearDepth(Float), which is available in
* OpenGL ES and WebGL.
*/
static void setDepthRange(Double near, Double far);
#endif
/**
* @overload
* @m_since_latest
*
* Initial value is @cpp 0.0 @ce and @cpp 1.0 @ce. If the
* @gl_extension{NV,depth_buffer_float} desktop extension is available,
* the function behaves exactly as @ref setDepthRange(Double, Double)
* for consistent clamping behavior between the two overloads.
* Otherwise, if OpenGL ES, OpenGL 4.1 or extension
* @gl_extension{ARB,ES2_compatibility} is available, this function
* uses the @fn_gl2_keyword{DepthRangef,DepthRange} API. Otherwise it
* behaves exactly as @ref setDepthRange(Double, Double).
*/
static void setDepthRange(Float near, Float far);
/**
* @brief Set clipping behavior
* @m_since_latest
*
* Initial value is @ref ClipOrigin::LowerLeft and
* @ref ClipDepth::NegativeOneToOne.
* @see @fn_gl_keyword{ClipControl}
* @requires_gl45 Extension @gl_extension{ARB,clip_control}
* @requires_es_extension Extension @gl_extension{EXT,clip_control}
* @requires_webgl_extension Extension @webgl_extension{EXT,clip_control}.
* Note that this extension is only implemented since Emscripten
* 3.1.66 and thus it's not even advertised on older versions.
*/
static void setClipControl(ClipOrigin origin, ClipDepth depth);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Masking writes */
/**
* @brief Mask color writes
* @param allowRed Allow red channel to be written
* @param allowGreen Allow green channel to be written
* @param allowBlue Allow blue channel to be written
* @param allowAlpha Allow alpha channel to be written
*
* Set to @cpp false @ce to disallow writing to given color channel.
* Initial values are all @cpp true @ce.
* @see @ref setDepthMask(), @ref setStencilMask(),
* @fn_gl_keyword{ColorMask}
*/
static void setColorMask(GLboolean allowRed, GLboolean allowGreen, GLboolean allowBlue, GLboolean allowAlpha);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Mask color writes for given draw buffer
* @param drawBuffer Draw buffer index
* @param allowRed Allow red channel to be written
* @param allowGreen Allow green channel to be written
* @param allowBlue Allow blue channel to be written
* @param allowAlpha Allow alpha channel to be written
* @m_since{2020,06}
*
* @see @ref GL-Framebuffer-usage-multiple-outputs,
* @fn_gl2_keyword{ColorMaski,ColorMask}
* @requires_gl30 Extension @gl_extension{EXT,draw_buffers2}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void setColorMask(UnsignedInt drawBuffer, GLboolean allowRed, GLboolean allowGreen, GLboolean allowBlue, GLboolean allowAlpha);
#endif
/**
* @brief Mask depth writes
*
* Set to @cpp false @ce to disallow writing to depth buffer. Initial
* value is @cpp true @ce.
* @see @ref setColorMask(), @ref setStencilMask(),
* @fn_gl_keyword{DepthMask}
*/
static void setDepthMask(GLboolean allow);
/**
* @brief Mask stencil writes
*
* Set given bit to @cpp 0 @ce to disallow writing stencil value for
* given faces to it. Initial value is all @cpp 1 @ce s.
*
* @see @ref setStencilMask(UnsignedInt), @ref setColorMask(),
* @ref setDepthMask(), @fn_gl_keyword{StencilMaskSeparate}
* @requires_gles In WebGL the mask must be the same for both front and
* back polygon facing.
*/
static void setStencilMask(PolygonFacing facing, UnsignedInt allowBits);
/**
* @brief Mask stencil writes
*
* The same as calling @ref setStencilMask(PolygonFacing, UnsignedInt)
* with `facing` set to @ref PolygonFacing::FrontAndBack.
* @see @fn_gl_keyword{StencilMask}
*/
static void setStencilMask(UnsignedInt allowBits);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/**
* @{ @name Blending
*
* You have to enable @ref Feature::Blending first.
*/
/**
* @brief Blend equation
*
* @see @ref setBlendEquation()
* @m_enum_values_as_keywords
*/
enum class BlendEquation: GLenum {
Add = GL_FUNC_ADD, /**< `source + destination` */
Subtract = GL_FUNC_SUBTRACT, /**< `source - destination` */
ReverseSubtract = GL_FUNC_REVERSE_SUBTRACT, /**< `destination - source` */
/**
* `min(source, destination)`
* @requires_gles30 Extension @gl_extension{EXT,blend_minmax} in
* OpenGL ES 2.0.
* @requires_webgl20 Extension @webgl_extension{EXT,blend_minmax}
* in WebGL 1.0.
*/
#ifndef MAGNUM_TARGET_GLES2
Min = GL_MIN,
#else
Min = GL_MIN_EXT,
#endif
/**
* `max(source, destination)`
* @requires_gles30 Extension @gl_extension{EXT,blend_minmax} in
* OpenGL ES 2.0.
* @requires_webgl20 Extension @webgl_extension{EXT,blend_minmax}
* in WebGL 1.0.
*/
#ifndef MAGNUM_TARGET_GLES2
Max = GL_MAX,
#else
Max = GL_MAX_EXT,
#endif
/**
* Multiply. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Multiply = GL_MULTIPLY_KHR,
/**
* Screen. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Screen = GL_SCREEN_KHR,
/**
* Overlay. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Overlay = GL_OVERLAY_KHR,
/**
* Darken. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Darken = GL_DARKEN_KHR,
/**
* Lighten. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Lighten = GL_LIGHTEN_KHR,
/**
* Color dodge. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
ColorDodge = GL_COLORDODGE_KHR,
/**
* Color burn. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
ColorBurn = GL_COLORBURN_KHR,
/**
* Hard light. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
HardLight = GL_HARDLIGHT_KHR,
/**
* Soft light. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
SoftLight = GL_SOFTLIGHT_KHR,
/**
* Difference. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Difference = GL_DIFFERENCE_KHR,
/**
* Exclusion. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
Exclusion = GL_EXCLUSION_KHR,
/**
* HSL hue. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
HslHue = GL_HSL_HUE_KHR,
/**
* HSL saturation. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
HslSaturation = GL_HSL_SATURATION_KHR,
/**
* HSL color. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
HslColor = GL_HSL_COLOR_KHR,
/**
* HSL luminosity. Not accepted as separate parameters in
* @ref setBlendEquation(BlendEquation, BlendEquation), only in
* @ref setBlendEquation(BlendEquation).
* @see @ref blendBarrier()
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
*/
HslLuminosity = GL_HSL_LUMINOSITY_KHR,
#ifdef Magnum_British_h
ColourDodge = ColorDodge,
ColourBurn = ColorBurn,
HslColour = HslColor
#endif
};
/**
* @brief Blend function
*
* @see @ref setBlendFunction()
* @m_enum_values_as_keywords
*/
enum class BlendFunction: GLenum {
/** Zero (@f$ RGB = (0.0, 0.0, 0.0); A = 0.0 @f$) */
Zero = GL_ZERO,
/** One (@f$ RGB = (1.0, 1.0, 1.0); A = 1.0 @f$) */
One = GL_ONE,
/**
* Constant color (@f$ RGB = (R_c, G_c, B_c); A = A_c @f$)
*
* @see @ref setBlendColor()
*/
ConstantColor = GL_CONSTANT_COLOR,
/**
* One minus constant color (@f$ RGB = (1.0 - R_c, 1.0 - G_c, 1.0 - B_c); A = 1.0 - A_c @f$)
*
* @see @ref setBlendColor()
*/
OneMinusConstantColor = GL_ONE_MINUS_CONSTANT_COLOR,
/**
* Constant alpha (@f$ RGB = (A_c, A_c, A_c); A = A_c @f$)
*
* @see @ref setBlendColor()
*/
ConstantAlpha = GL_CONSTANT_ALPHA,
/**
* One minus constant alpha (@f$ RGB = (1.0 - A_c, 1.0 - A_c, 1.0 - A_c); A = 1.0 - A_c @f$)
*
* @see @ref setBlendColor()
*/
OneMinusConstantAlpha = GL_ONE_MINUS_CONSTANT_ALPHA,
/** Source color (@f$ RGB = (R_{s0}, G_{s0}, B_{s0}); A = A_{s0} @f$) */
SourceColor = GL_SRC_COLOR,
/**
* Second source color (@f$ RGB = (R_{s1}, G_{s1}, B_{s1}); A = A_{s1} @f$)
*
* @see @ref AbstractShaderProgram::bindFragmentDataLocationIndexed()
* @requires_gl33 Extension @gl_extension{ARB,blend_func_extended}
* @requires_es_extension Extension
* @gl_extension{EXT,blend_func_extended}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_func_extended}
*/
#ifndef MAGNUM_TARGET_GLES
SecondSourceColor = GL_SRC1_COLOR,
#else
SecondSourceColor = GL_SRC1_COLOR_EXT,
#endif
/**
* One minus source color (@f$ RGB = (1.0 - R_{s0}, 1.0 - G_{s0}, 1.0 - B_{s0}); A = 1.0 - A_{s0} @f$)
*/
OneMinusSourceColor = GL_ONE_MINUS_SRC_COLOR,
/**
* One minus second source color (@f$ RGB = (1.0 - R_{s1}, 1.0 - G_{s1}, 1.0 - B_{s1}); A = 1.0 - A_{s1} @f$)
*
* @see @ref AbstractShaderProgram::bindFragmentDataLocationIndexed()
* @requires_gl33 Extension @gl_extension{ARB,blend_func_extended}
* @requires_es_extension Extension
* @gl_extension{EXT,blend_func_extended}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_func_extended}
*/
#ifndef MAGNUM_TARGET_GLES
OneMinusSecondSourceColor = GL_ONE_MINUS_SRC1_COLOR,
#else
OneMinusSecondSourceColor = GL_ONE_MINUS_SRC1_COLOR_EXT,
#endif
/** Source alpha (@f$ RGB = (A_{s0}, A_{s0}, A_{s0}); A = A_{s0} @f$) */
SourceAlpha = GL_SRC_ALPHA,
/**
* Saturate source alpha (@f$ RGB = (f, f, f); A = 1.0; f = min(A_s, 1.0 - A_d) @f$)
*
* Can be used only in source parameter of @ref setBlendFunction().
*/
SourceAlphaSaturate = GL_SRC_ALPHA_SATURATE,
/**
* Second source alpha (@f$ RGB = (A_{s1}, A_{s1}, A_{s1}); A = A_{s1} @f$)
*
* @see @ref AbstractShaderProgram::bindFragmentDataLocationIndexed()
* @requires_gl33 Extension @gl_extension{ARB,blend_func_extended}
* @requires_es_extension Extension
* @gl_extension{EXT,blend_func_extended}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_func_extended}
*/
#ifndef MAGNUM_TARGET_GLES
SecondSourceAlpha = GL_SRC1_ALPHA,
#else
SecondSourceAlpha = GL_SRC1_ALPHA_EXT,
#endif
/**
* One minus source alpha (@f$ RGB = (1.0 - A_{s0}, 1.0 - A_{s0}, 1.0 - A_{s0}); A = 1.0 - A_{s0} @f$)
*/
OneMinusSourceAlpha = GL_ONE_MINUS_SRC_ALPHA,
/**
* One minus second source alpha (@f$ RGB = (1.0 - A_{s1}, 1.0 - A_{s1}, 1.0 - A_{s1}); A = 1.0 - A_{s1} @f$)
*
* @see @ref AbstractShaderProgram::bindFragmentDataLocationIndexed()
* @requires_gl33 Extension @gl_extension{ARB,blend_func_extended}
* @requires_es_extension Extension
* @gl_extension{EXT,blend_func_extended}
* @requires_webgl_extension Extension
* @webgl_extension{WEBGL,blend_func_extended}
*/
#ifndef MAGNUM_TARGET_GLES
OneMinusSecondSourceAlpha = GL_ONE_MINUS_SRC1_ALPHA,
#else
OneMinusSecondSourceAlpha = GL_ONE_MINUS_SRC1_ALPHA_EXT,
#endif
/** Destination color (@f$ RGB = (R_d, G_d, B_d); A = A_d @f$) */
DestinationColor = GL_DST_COLOR,
/**
* One minus source color (@f$ RGB = (1.0 - R_d, 1.0 - G_d, 1.0 - B_d); A = 1.0 - A_d @f$)
*/
OneMinusDestinationColor = GL_ONE_MINUS_DST_COLOR,
/** Destination alpha (@f$ RGB = (A_d, A_d, A_d); A = A_d @f$) */
DestinationAlpha = GL_DST_ALPHA,
/**
* One minus source alpha (@f$ RGB = (1.0 - A_d, 1.0 - A_d, 1.0 - A_d); A = 1.0 - A_d @f$)
*/
OneMinusDestinationAlpha = GL_ONE_MINUS_DST_ALPHA,
#ifdef Magnum_British_h
ConstantColour = ConstantColor,
OneMinusConstantColour = OneMinusConstantColor,
SourceColour = SourceColor,
SecondSourceColour = SecondSourceColor,
OneMinusSourceColour = OneMinusSourceColor,
OneMinusSecondSourceColour = OneMinusSecondSourceColor,
DestinationColour = DestinationColor,
OneMinusDestinationColour = OneMinusDestinationColor
#endif
};
/**
* @brief Set blend equation
* @param equation Blend equation
*
* How to combine source color (pixel value) with destination color
* (framebuffer). Initial value is @ref BlendEquation::Add.
* @see @ref Feature::Blending, @ref setBlendEquation(BlendEquation, BlendEquation),
* @ref setBlendFunction(), @ref setBlendColor(),
* @fn_gl_keyword{BlendEquation}
*/
static void setBlendEquation(BlendEquation equation);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Set blend equation for given draw buffer
* @param drawBuffer Draw buffer index
* @param equation Blend equation
* @m_since{2020,06}
*
* @see @ref GL-Framebuffer-usage-multiple-outputs,
* @fn_gl2_keyword{BlendEquationi,BlendEquation}
* @requires_gl40 Extension @gl_extension{ARB,draw_buffers_blend}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void setBlendEquation(UnsignedInt drawBuffer, BlendEquation equation);
#endif
/**
* @brief Set blend equation separately for RGB and alpha components
* @param rgb Blend equation for RGB components
* @param alpha Blend equation for the alpha component
*
* See @ref setBlendEquation(BlendEquation) for more information.
* @see @ref Feature::Blending, @ref setBlendFunction(),
* @ref setBlendColor(), @fn_gl_keyword{BlendEquationSeparate}
*/
static void setBlendEquation(BlendEquation rgb, BlendEquation alpha);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Set blend equation for given draw buffer separately for RGB and alpha components
* @param drawBuffer Draw buffer index
* @param rgb Blend equation for RGB components
* @param alpha Blend equation for the alpha component
* @m_since{2020,06}
*
* @see @ref GL-Framebuffer-usage-multiple-outputs,
* @fn_gl2_keyword{BlendEquationSeparatei,BlendEquationSeparate}
* @requires_gl40 Extension @gl_extension{ARB,draw_buffers_blend}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void setBlendEquation(UnsignedInt drawBuffer, BlendEquation rgb, BlendEquation alpha);
#endif
/**
* @brief Set blend function
* @param source How the source blending factor is computed
* from pixel value. Initial value is @ref BlendFunction::One.
* @param destination How the destination blending factor is
* computed from framebuffer. Initial value is @ref BlendFunction::Zero.
*
* @m_keyword{Alpha blending,,}
* @m_keywords{Blending Transparency}
*
* Common setup for alpha blending is the following, depending on
* whether your colors / textures have a [premultiplied alpha](https://developer.nvidia.com/content/alpha-blending-pre-or-not-pre)
* (RGB channels always less than or equal to the alpha) or not:
*
* @snippet GL.cpp Renderer-setBlendFunction
*
* Note that in 3D you need to sort and render transparent objects
* back-to-front after all opaque objects in order for them to appear
* correctly. Alternatively, builtin shaders such as
* @ref Shaders::FlatGL or @ref Shaders::PhongGL support alpha masking,
* which works without alpha blending enabled and doesn't require depth
* sorting.
* @see @ref Feature::Blending, @ref setBlendFunction(BlendFunction, BlendFunction, BlendFunction, BlendFunction),
* @ref setBlendEquation(), @ref setBlendColor(),
* @fn_gl_keyword{BlendFunc}
* @requires_gles In WebGL, constant color and constant alpha cannot be
* used together as source and destination factors.
*/
static void setBlendFunction(BlendFunction source, BlendFunction destination);
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* @brief Set blend function for given draw buffer
* @param drawBuffer Draw buffer index
* @param source How the source blending factor is computed
* from pixel value
* @param destination How the destination blending factor is
* computed from framebuffer
* @m_since{2020,06}
*
* See @ref setBlendFunction(BlendFunction, BlendFunction) for more
* information.
* @see @ref GL-Framebuffer-usage-multiple-outputs,
* @fn_gl2_keyword{BlendFunci,BlendFunc}
* @requires_gl40 Extension @gl_extension{ARB,draw_buffers_blend}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void setBlendFunction(UnsignedInt drawBuffer, BlendFunction source, BlendFunction destination);
#endif
/**
* @brief Set blend function separately for RGB and alpha components
*
* See @ref setBlendFunction(BlendFunction, BlendFunction) for more
* information.
* @see @ref Feature::Blending, @ref setBlendEquation(),
* @ref setBlendColor(), @fn_gl_keyword{BlendFuncSeparate}
*/
static void setBlendFunction(BlendFunction sourceRgb, BlendFunction destinationRgb, BlendFunction sourceAlpha, BlendFunction destinationAlpha);
/**
* @brief Set blend function for given draw buffer separately for RGB and alpha components
* @param drawBuffer Draw buffer index
* @param sourceRgb How the source blending factor is computed
* from pixel value for RGB components
* @param sourceAlpha How the source blending factor is computed
* from pixel value for the alpha component
* @param destinationRgb How the destination blending factor is
* computed from framebuffer for RGB components
* @param destinationAlpha How the destination blending factor is
* computed from framebuffer for the alpha component
* @m_since{2020,06}
*
* See @ref setBlendFunction(BlendFunction, BlendFunction) for more
* information.
* @see @ref GL-Framebuffer-usage-multiple-outputs,
* @fn_gl2_keyword{BlendFuncSeparatei,BlendFuncSeparate}
* @requires_gl40 Extension @gl_extension{ARB,draw_buffers_blend}
* @requires_gles32 Extension @gl_extension{EXT,draw_buffers_indexed}
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{OES,draw_buffers_indexed} (originally named
* `EXT_draw_buffers_indexed`)
*/
static void setBlendFunction(UnsignedInt drawBuffer, BlendFunction sourceRgb, BlendFunction destinationRgb, BlendFunction sourceAlpha, BlendFunction destinationAlpha);
/**
* @brief Set blend color
*
* Sets constant color used in @ref setBlendFunction() by
* @ref BlendFunction::ConstantColor, @ref BlendFunction::OneMinusConstantColor,
* @ref BlendFunction::ConstantAlpha and @ref BlendFunction::OneMinusConstantAlpha.
* @see @ref Feature::Blending, @ref setBlendEquation(),
* @ref setBlendFunction(), @fn_gl_keyword{BlendColor}
*/
static void setBlendColor(const Color4& color);
#ifndef MAGNUM_TARGET_WEBGL
/**
* @brief Blend barrier
*
* Specifies a boundary between passes when using advanced blend
* equations to ensure that each sample in the framebuffer is not
* touched more than once.
*
* This is needed either when desktop/ES extension
* @gl_extension2{KHR,blend_equation_advanced_coherent,KHR_blend_equation_advanced}
* is not available or when @gl_extension2{KHR,blend_equation_advanced_coherent,KHR_blend_equation_advanced}
* is available and @ref Feature::BlendAdvancedCoherent is turned off.
* @see @ref BlendEquation, @fn_gl_extension_keyword{BlendBarrier,KHR,blend_equation_advanced}
* @requires_extension Extension @gl_extension{KHR,blend_equation_advanced}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,blend_equation_advanced}
* @requires_gles Enabled by default on WebGL if the
* @webgl_extension{WEBGL,blend_equation_advanced_coherent}
* is available.
*/
static void blendBarrier() { glBlendBarrierKHR(); }
#endif
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
#ifndef MAGNUM_TARGET_GLES
/** @{ @name Logical operation */
/**
* @brief Logical operation
*
* @see @ref setLogicOperation()
* @m_enum_values_as_keywords
* @requires_gl Logical operations on framebuffer are not available in
* OpenGL ES and WebGL.
*/
enum class LogicOperation: GLenum {
Clear = GL_CLEAR, /**< @cpp 0 @ce <b></b> */
Set = GL_SET, /**< @cpp 1 @ce <b></b> */
Copy = GL_COPY, /**< `source` */
CopyInverted = GL_COPY_INVERTED,/**< `~source` */
Noop = GL_NOOP, /**< `destination` */
Invert = GL_INVERT, /**< `~destination` */
And = GL_AND, /**< `source & destination` */
AndReverse = GL_AND_REVERSE, /**< `source & ~destination` */
AndInverted = GL_AND_INVERTED, /**< `~source & destination` */
Nand = GL_NAND, /**< `~(source & destination)` */
Or = GL_OR, /**< `source | destination` */
OrReverse = GL_OR_REVERSE, /**< `source | ~destination` */
OrInverted = GL_OR_INVERTED, /**< `~source | destination` */
Nor = GL_NOR, /**< `~(source | destination)` */
Xor = GL_XOR, /**< `source ^ destination` */
Equivalence = GL_EQUIV /**< `~(source ^ destination)` */
};
/**
* @brief Set logical operation
*
* @see @ref Feature::LogicOperation, @fn_gl_keyword{LogicOp}
* @requires_gl Logical operations on framebuffer are not available in
* OpenGL ES and WebGL.
*/
static void setLogicOperation(LogicOperation operation);
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
#endif
/** @{ @name Renderer synchronization */
/**
* @brief Flush the pipeline
*
* @see @ref finish(), @fn_gl_keyword{Flush}
*/
static void flush() { glFlush(); }
/**
* @brief Finish the pipeline
*
* Blocks until all commands in the pipeline are finished.
* @see @ref flush(), @fn_gl_keyword{Finish}
*/
static void finish() { glFinish(); }
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* @brief Memory barrier
*
* @see @ref MemoryBarriers, @ref setMemoryBarrier(),
* @ref setMemoryBarrierByRegion()
* @m_enum_values_as_keywords
* @requires_gl42 Extension @gl_extension{ARB,shader_image_load_store}
* @requires_gles31 Shader image load/store is not available in OpenGL
* ES 3.0 and older.
* @requires_gles Shader image load/store is not available in WebGL.
*/
enum class MemoryBarrier: GLbitfield {
/** Vertex data */
VertexAttributeArray = GL_VERTEX_ATTRIB_ARRAY_BARRIER_BIT,
/** Vertex indices */
ElementArray = GL_ELEMENT_ARRAY_BARRIER_BIT,
/** Uniforms */
Uniform = GL_UNIFORM_BARRIER_BIT,
/** Texture fetches */
TextureFetch = GL_TEXTURE_FETCH_BARRIER_BIT,
/** Shader image access */
ShaderImageAccess = GL_SHADER_IMAGE_ACCESS_BARRIER_BIT,
/** Indirect command data */
Command = GL_COMMAND_BARRIER_BIT,
/** Pixel buffer data */
PixelBuffer = GL_PIXEL_BUFFER_BARRIER_BIT,
/** Texture updates */
TextureUpdate = GL_TEXTURE_UPDATE_BARRIER_BIT,
/** Buffer updates */
BufferUpdate = GL_BUFFER_UPDATE_BARRIER_BIT,
/** Framebuffer operations */
Framebuffer = GL_FRAMEBUFFER_BARRIER_BIT,
/** Transform feedback data */
TransformFeedback = GL_TRANSFORM_FEEDBACK_BARRIER_BIT,
/** Atomic counters */
AtomicCounter = GL_ATOMIC_COUNTER_BARRIER_BIT,
/**
* Shader storage data
* @requires_gl43 Extension @gl_extension{ARB,shader_storage_buffer_object}
* @requires_gles31 Shader storage is not available in OpenGL ES
* 3.0 and older.
* @requires_gles Shader storage is not available in WebGL.
*/
ShaderStorage = GL_SHADER_STORAGE_BARRIER_BIT
};
/**
* @brief Memory barriers
*
* @see @ref setMemoryBarrier(), @ref setMemoryBarrierByRegion()
* @requires_gl42 Extension @gl_extension{ARB,shader_image_load_store}
* @requires_gles31 Shader image load/store is not available in OpenGL
* ES 3.0 and older.
* @requires_gles Shader image load/store is not available in WebGL.
*/
typedef Containers::EnumSet<MemoryBarrier
#ifndef DOXYGEN_GENERATING_OUTPUT
, GL_VERTEX_ATTRIB_ARRAY_BARRIER_BIT|GL_ELEMENT_ARRAY_BARRIER_BIT|GL_UNIFORM_BARRIER_BIT|GL_TEXTURE_FETCH_BARRIER_BIT|GL_SHADER_IMAGE_ACCESS_BARRIER_BIT|GL_COMMAND_BARRIER_BIT|GL_PIXEL_BUFFER_BARRIER_BIT|GL_TEXTURE_UPDATE_BARRIER_BIT|GL_BUFFER_UPDATE_BARRIER_BIT|GL_FRAMEBUFFER_BARRIER_BIT|GL_TRANSFORM_FEEDBACK_BARRIER_BIT|GL_ATOMIC_COUNTER_BARRIER_BIT|GL_ATOMIC_COUNTER_BARRIER_BIT
#endif
> MemoryBarriers;
/**
* @brief Set memory barrier
*
* Calling the function ensures that operations on particular data
* after the barrier will reflect all data modifications before the
* barrier.
* @see @ref setMemoryBarrierByRegion(), @fn_gl_keyword{MemoryBarrier}
* @requires_gl42 Extension @gl_extension{ARB,shader_image_load_store}
* @requires_gles31 Shader load/store is not available in OpenGL ES 3.0 and older.
* @requires_gles Shader load/store is not available in WebGL.
*/
static void setMemoryBarrier(MemoryBarriers barriers);
/**
* @brief Set memory barrier by region
*
* Behaves as @ref setMemoryBarrier(), except that the region is
* narrowed around area affected by particular fragment shader, thus
* only the fragment shader-related barries are supported:
*
* - @ref MemoryBarrier::AtomicCounter
* - @ref MemoryBarrier::Framebuffer
* - @ref MemoryBarrier::ShaderImageAccess
* - @ref MemoryBarrier::ShaderStorage
* - @ref MemoryBarrier::TextureFetch
* - @ref MemoryBarrier::Uniform
*
* @see @fn_gl_keyword{MemoryBarrierByRegion}
* @requires_gl45 Extension @gl_extension{ARB,ES3_1_compatibility}
* @requires_gles31 Shader load/store is not available in OpenGL ES 3.0
* and older.
* @requires_gles Shader load/store is not available in WebGL.
*/
static void setMemoryBarrierByRegion(MemoryBarriers barriers) {
glMemoryBarrierByRegion(GLbitfield(barriers));
}
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* @brief Set texture barrier
*
* Calling the function ensures that texel fetches in drawing
* operations after the barrier will reflect texel writes before the
* barrier.
* @see @fn_gl_keyword{TextureBarrier}
* @requires_gl45 Extension @gl_extension{ARB,texture_barrier}
* @requires_gl Texture barrier is not available in OpenGL ES or WebGL.
*/
static void setTextureBarrier() {
glTextureBarrier();
}
#endif
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
/** @{ @name Renderer management */
/**
* @brief Error status
*
* @see @ref error()
* @m_enum_values_as_keywords
*/
enum class Error: GLenum {
/** No error has been recorded */
NoError = GL_NO_ERROR,
/** An unacceptable value specified for enumerated argument */
InvalidEnum = GL_INVALID_ENUM,
/** A numeric argument is out of range */
InvalidValue = GL_INVALID_VALUE,
/** The specified operation is not allowed in the current state */
InvalidOperation = GL_INVALID_OPERATION,
/**
* The framebuffer object is not complete.
* @see @ref DefaultFramebuffer::checkStatus(),
* @ref Framebuffer::checkStatus()
* @requires_gl30 Extension @gl_extension{ARB,framebuffer_object}
*/
InvalidFramebufferOperation = GL_INVALID_FRAMEBUFFER_OPERATION,
/** There is not enough memory left to execute the command. */
OutOfMemory = GL_OUT_OF_MEMORY,
#ifndef MAGNUM_TARGET_WEBGL
/**
* Given operation would cause an internal stack to underflow.
* @see @ref DebugGroup
* @requires_gl43 Extension @gl_extension{KHR,debug}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,debug}
* @requires_gles Debug output is not available in WebGL.
*/
#ifndef MAGNUM_TARGET_GLES2
StackUnderflow = GL_STACK_UNDERFLOW,
#else
StackUnderflow = GL_STACK_UNDERFLOW_KHR,
#endif
/**
* Given operation would cause an internal stack to overflow.
* @see @ref DebugGroup
* @requires_gl43 Extension @gl_extension{KHR,debug}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{KHR,debug}
* @requires_gles Debug output is not available in WebGL.
*/
#ifndef MAGNUM_TARGET_GLES2
StackOverflow = GL_STACK_OVERFLOW
#else
StackOverflow = GL_STACK_OVERFLOW_KHR
#endif
#endif
};
/**
* @brief Error status
*
* Returns error flag, if any set. If there aren't any more error
* flags, returns @ref Error::NoError. Thus this function should be
* always called in a loop until it returns @ref Error::NoError.
* @see @fn_gl_keyword{GetError}
*/
static Error error() { return static_cast<Error>(glGetError()); }
#ifndef MAGNUM_TARGET_WEBGL
/**
* @brief Graphics reset notification strategy
*
* @see @ref resetNotificationStrategy()
* @requires_gles Graphics reset notification is not available in
* WebGL.
*/
enum class ResetNotificationStrategy: GLint {
/**
* No reset notification, thus @ref graphicsResetStatus() will
* always return @ref GraphicsResetStatus::NoError. However this
* doesn't mean that the context cannot be lost.
*/
#ifndef MAGNUM_TARGET_GLES
NoResetNotification = GL_NO_RESET_NOTIFICATION_ARB,
#else
NoResetNotification = GL_NO_RESET_NOTIFICATION_EXT,
#endif
/**
* Graphics reset will result in context loss, cause of the reset
* can be queried with @ref graphicsResetStatus().
* @requires_extension Extension @gl_extension{ARB,robustness}
* @requires_es_extension Extension @gl_extension{EXT,robustness}
*/
#ifndef MAGNUM_TARGET_GLES
LoseContextOnReset = GL_LOSE_CONTEXT_ON_RESET_ARB
#else
LoseContextOnReset = GL_LOSE_CONTEXT_ON_RESET_EXT
#endif
};
/**
* @brief Graphics reset notification strategy
*
* The result is cached, repeated queries don't result in repeated
* OpenGL calls. If OpenGL extension @gl_extension{ARB,robustness} or ES
* extension @gl_extension{EXT,robustness} is not available, this
* function always returns @ref ResetNotificationStrategy::NoResetNotification.
*
* For the reset notification to work, additionally to the extension
* support the context must be created with
* @ref Platform::Sdl2Application::GLConfiguration::Flag::RobustAccess "Platform::*Application::GLConfiguration::Flag::RobustAccess"
* flag.
*
* @see @ref graphicsResetStatus(), @fn_gl_keyword{Get} with
* @def_gl_keyword{RESET_NOTIFICATION_STRATEGY_ARB}
* @requires_gles Graphics reset notification is not available in
* WebGL.
*/
static ResetNotificationStrategy resetNotificationStrategy();
/**
* @brief Graphics reset status
*
* @see @ref resetNotificationStrategy(), @ref graphicsResetStatus()
* @m_enum_values_as_keywords
* @requires_gles Graphics reset notification is not available in
* WebGL.
*/
enum class GraphicsResetStatus: GLenum {
/** No reset occurred since last call. */
NoError = GL_NO_ERROR,
/**
* Reset attributable to the current context has been detected.
* @requires_extension Extension @gl_extension{ARB,robustness}
* @requires_es_extension Extension @gl_extension{EXT,robustness}
*/
#ifndef MAGNUM_TARGET_GLES
GuiltyContextReset = GL_GUILTY_CONTEXT_RESET_ARB,
#else
GuiltyContextReset = GL_GUILTY_CONTEXT_RESET_EXT,
#endif
/**
* Reset not attributable to the current context has been detected.
* @requires_extension Extension @gl_extension{ARB,robustness}
* @requires_es_extension Extension @gl_extension{EXT,robustness}
*/
#ifndef MAGNUM_TARGET_GLES
InnocentContextReset = GL_INNOCENT_CONTEXT_RESET_ARB,
#else
InnocentContextReset = GL_INNOCENT_CONTEXT_RESET_EXT,
#endif
/**
* Reset with unknown cause has been detected.
* @requires_extension Extension @gl_extension{ARB,robustness}
* @requires_es_extension Extension @gl_extension{EXT,robustness}
*/
#ifndef MAGNUM_TARGET_GLES
UnknownContextReset = GL_UNKNOWN_CONTEXT_RESET_ARB
#else
UnknownContextReset = GL_UNKNOWN_CONTEXT_RESET_EXT
#endif
};
/**
* @brief Check graphics reset status
*
* Reset causes all context state to be lost. If OpenGL extension
* @gl_extension{ARB,robustness} or ES extension @gl_extension{EXT,robustness}
* is not available, this function always returns @ref GraphicsResetStatus::NoError.
*
* For the reset notification to work, additionally to the extension
* support the context must be created with
* @ref Platform::Sdl2Application::GLConfiguration::Flag::RobustAccess "Platform::*Application::GLConfiguration::Flag::RobustAccess"
* flag.
*
* If the reset occurs, @gl_extension{ARB,robustness_isolation}
* extension is supported and context is created with
* @ref Platform::Sdl2Application::GLConfiguration::Flag::ResetIsolation "Platform::*Application::GLConfiguration::Flag::ResetIsolation",
* advertised support for @gl_extension{ARB,robustness_application_isolation}
* indicates that no other application on the system will be affected
* by the graphics reset. Advertised support for
* @gl_extension{ARB,robustness_share_group_isolation} indicates that no
* other share group will be affected by the graphics reset.
* @see @ref resetNotificationStrategy(),
* @fn_gl_extension_keyword{GetGraphicsResetStatus,ARB,robustness}
* @requires_gles Graphics reset notification is not available in
* WebGL.
*/
static GraphicsResetStatus graphicsResetStatus();
#endif
/* Since 1.8.17, the original short-hand group closing doesn't work
anymore. FFS. */
/**
* @}
*/
private:
static void MAGNUM_GL_LOCAL initializeContextBasedFunctionality();
static MAGNUM_GL_LOCAL Range1D lineWidthRangeImplementationDefault();
#ifndef MAGNUM_TARGET_GLES
static MAGNUM_GL_LOCAL Range1D lineWidthRangeImplementationMesaForwardCompatible();
#endif
/* These have to be compatible with direct pointers to the GL functions
which need a __stdcall on Windows to compile properly on 32 bits */
#ifndef MAGNUM_TARGET_GLES
static void APIENTRY MAGNUM_GL_LOCAL clearDepthfImplementationNV(GLfloat depth);
static void APIENTRY MAGNUM_GL_LOCAL clearDepthfImplementationDefault(GLfloat depth);
static void APIENTRY MAGNUM_GL_LOCAL depthRangefImplementationNV(GLfloat near, GLfloat far);
static void APIENTRY MAGNUM_GL_LOCAL depthRangefImplementationDefault(GLfloat near, GLfloat far);
#endif
#ifndef MAGNUM_TARGET_WEBGL
static GLenum APIENTRY MAGNUM_GL_LOCAL graphicsResetStatusImplementationDefault();
#endif
};
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
CORRADE_ENUMSET_OPERATORS(Renderer::MemoryBarriers)
#endif
/** @debugoperatorclassenum{Renderer,Renderer::Error} */
MAGNUM_GL_EXPORT Debug& operator<<(Debug& debug, Renderer::Error value);
#ifndef MAGNUM_TARGET_WEBGL
/** @debugoperatorclassenum{Renderer,Renderer::ResetNotificationStrategy} */
MAGNUM_GL_EXPORT Debug& operator<<(Debug& debug, Renderer::ResetNotificationStrategy value);
/** @debugoperatorclassenum{Renderer,Renderer::GraphicsResetStatus} */
MAGNUM_GL_EXPORT Debug& operator<<(Debug& debug, Renderer::GraphicsResetStatus value);
#endif
}}
#endif