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.
5815 Commits
21 Branches
19 Tags
70 MiB
Tree: d863fbee30
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'd863fbee30'
${ noResults }
magnum/src/Magnum/GL/Implementation/FramebufferState.h

124 lines
5.6 KiB
Raw Normal View History Unescape

Split the OpenGL layer out, pt 1: moving files to a new location. Minimal updates (just the include guards) so Git is hopefully able to detect the rename and track the history properly. Everything except Magnum::GL doesn't compile now.
8 years ago
#ifndef Magnum_GL_Implementation_FramebufferState_h
#define Magnum_GL_Implementation_FramebufferState_h
Tracking framebuffer binding.
14 years ago
/*
This file is part of Magnum.
Updated copyright year.
8 years ago
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018
Happy new year too.
12 years ago
Vladimír Vondruš <mosra@centrum.cz>
Relicensing to MIT/Expat license, part 2: headers.
13 years ago
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.
Tracking framebuffer binding.
14 years ago
*/
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
#include <string>
#include <vector>
Split the OpenGL layer out, pt 1: moving files to a new location. Minimal updates (just the include guards) so Git is hopefully able to detect the rename and track the history properly. Everything except Magnum::GL doesn't compile now.
8 years ago
#include "Magnum/GL/Framebuffer.h"
Tracking framebuffer binding.
14 years ago
Fix memory corruption on MSVC. I can't believe that you can just forget to include some file and it will SILENTLY PASS and then crashes horribly at runtime because each translation unit thought that given member function pointer had completely different size. THIS IS NOT ACCEPTABLE.
11 years ago
#ifdef _MSC_VER
/* Otherwise the member function pointers will have different size based on
whether the header was included or not. CAUSES SERIOUS MEMORY CORRUPTION AND
IS NOT CAUGHT BY ANY WARNING WHATSOEVER! AARGH! */
Split the OpenGL layer out, pt 1: moving files to a new location. Minimal updates (just the include guards) so Git is hopefully able to detect the rename and track the history properly. Everything except Magnum::GL doesn't compile now.
8 years ago
#include "Magnum/GL/Renderbuffer.h"
Fix memory corruption on MSVC. I can't believe that you can just forget to include some file and it will SILENTLY PASS and then crashes horribly at runtime because each translation unit thought that given member function pointer had completely different size. THIS IS NOT ACCEPTABLE.
11 years ago
#endif
Tracking framebuffer binding.
14 years ago
namespace Magnum { namespace Implementation {
struct FramebufferState {
Don't use zero-sized viewport as disengaged state. Zero-sized viewport is perfectly valid state and it causes assertion failures on contexts without default framebuffer (e.g. WindowlessCglApplication).
11 years ago
constexpr static const Range2Di DisengagedViewport{{}, {-1, -1}};
MSVC 2015 compatibility: in-class init of constexpr is not implemented. Breaks backward compatibility in one place, but I think that feature wasn't widely used anyway so I'm not fixing that.
11 years ago
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
explicit FramebufferState(Context& context, std::vector<std::string>& extensions);
Ability to reset internal state tracker.
12 years ago
void reset();
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Full ARB_direct_state_access support in framebuffers. In comparison to EXT_DSA, ARB_DSA also knows how to blit and invalidate without binding, yay!
12 years ago
void(*blitImplementation)(AbstractFramebuffer&, AbstractFramebuffer&, const Range2Di&, const Range2Di&, FramebufferBlitMask, FramebufferBlitFilter);
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#endif
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
GLenum(AbstractFramebuffer::*checkStatusImplementation)(FramebufferTarget);
Implemented glClearBuffer() APIs from GL 3.0 / GLES 3.0. According to my browser, glClear() can't be used to clear integer framebuffers, so this APIs are needed.
9 years ago
#ifndef MAGNUM_TARGET_GLES2
void(AbstractFramebuffer::*clearIImplementation)(GLenum, GLint, const GLint*);
void(AbstractFramebuffer::*clearUIImplementation)(GLenum, GLint, const GLuint*);
void(AbstractFramebuffer::*clearFImplementation)(GLenum, GLint, const GLfloat*);
void(AbstractFramebuffer::*clearFIImplementation)(GLenum, GLfloat, GLint);
#endif
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
void(AbstractFramebuffer::*drawBuffersImplementation)(GLsizei, const GLenum*);
Clarified and updated *Framebuffer::mapForDraw() implementations. In OpenGL ES 2.0 there is EXT_draw_buffers, which I overlooked somehow, so I added it to extension list and included in the implementation. It combines NV_draw_buffers and NV_fbo_color_attachments, so the implementation now selects one of the two based on which extension is supported, preferring the EXT one. Updated the documentation to be less confusing, fixed extension links. Also the single-output mapForDraw() is not handled separately on ES anymore and just calls DrawBuffers implementation with single parameter, resulting in less generated code. EXT_draw_buffers can also be called on default framebuffer and apparently in ES there is no way to map front framebuffer for drawing, so I removed it from the DefaultFramebuffer::DrawAttachment enum.
11 years ago
#ifndef MAGNUM_TARGET_GLES
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
void(AbstractFramebuffer::*drawBufferImplementation)(GLenum);
Clarified and updated *Framebuffer::mapForDraw() implementations. In OpenGL ES 2.0 there is EXT_draw_buffers, which I overlooked somehow, so I added it to extension list and included in the implementation. It combines NV_draw_buffers and NV_fbo_color_attachments, so the implementation now selects one of the two based on which extension is supported, preferring the EXT one. Updated the documentation to be less confusing, fixed extension links. Also the single-output mapForDraw() is not handled separately on ES anymore and just calls DrawBuffers implementation with single parameter, resulting in less generated code. EXT_draw_buffers can also be called on default framebuffer and apparently in ES there is no way to map front framebuffer for drawing, so I removed it from the DefaultFramebuffer::DrawAttachment enum.
11 years ago
#endif
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
void(AbstractFramebuffer::*readBufferImplementation)(GLenum);
Implemented *Framebuffer::copyImage() and copySubImage(). Default, ARB_DSA and EXT_DSA paths.
10 years ago
#endif
#ifndef MAGNUM_TARGET_GLES
void(*copySub1DImplementation)(const Range2Di&, AbstractTexture&, Int, Int);
#endif
void(*copySub2DImplementation)(const Range2Di&, AbstractTexture&, GLenum, Int, const Vector2i&);
void(*copySubCubeMapImplementation)(const Range2Di&, AbstractTexture&, GLenum, Int, const Vector2i&);
#if !(defined(MAGNUM_TARGET_GLES2) && defined(MAGNUM_TARGET_WEBGL))
void(*copySub3DImplementation)(const Range2Di&, AbstractTexture&, Int, const Vector3i&);
#endif
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Proper no-op fallback for *Framebuffer::invalidate*(). The documentation of ARB_invalidate_subdata mentions that all the functions are really just a hint for the implementation to make some performance optimizations and they are not affecting behavior at all. So it's perfectly fine to do nothing if the extension is not supported. I didn't do this originally as I mistakenly thought that invalidating depth buffer would somehow behave the same as clearing it, but that's not the case.
12 years ago
void(AbstractFramebuffer::*invalidateImplementation)(GLsizei, const GLenum*);
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#endif
There is glDiscardSubFramebuffer() in EXT_discard_framebuffer. The relevant functions are now a no-op on ES2.
12 years ago
#ifndef MAGNUM_TARGET_GLES2
Proper no-op fallback for *Framebuffer::invalidate*(). The documentation of ARB_invalidate_subdata mentions that all the functions are really just a hint for the implementation to make some performance optimizations and they are not affecting behavior at all. So it's perfectly fine to do nothing if the extension is not supported. I didn't do this originally as I mistakenly thought that invalidating depth buffer would somehow behave the same as clearing it, but that's not the case.
12 years ago
void(AbstractFramebuffer::*invalidateSubImplementation)(GLsizei, const GLenum*, const Range2Di&);
There is glDiscardSubFramebuffer() in EXT_discard_framebuffer. The relevant functions are now a no-op on ES2.
12 years ago
#endif
Fix internal framebuffer binding on WebGL. For some weird reason this was failing only on the Viewer example and not anywhere else. Huh.
11 years ago
#if defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
Simplified *Framebuffer::bind() functionality. This was a leftover from some not-well-thought-out design decision. The function is now used exclusively for binding for draw, as all framebuffer reading functions (blit(), read()) are doing the read binding internally. Moreover it required the user to be extra careful on ES2, because in many cases there are no separate binding points for reading and drawing. The function is now parameter-less and always bind the framebuffer for drawing. The logic for internal binding was also simplified and on ES2 there are separate implementations for single/separate binding points. For *Framebuffer::checkStatus() the documentation was updated to explain the meaning of the parameter on ES2 implementation. Also removed the need for FramebufferTarget::ReadDraw binding, as it was rather confusing. Old *Framebuffer::bind(FramebufferTarget) is now just an alias to the parameter-less function, ignoring the parameter. Along with FramebufferTarget::ReadDraw it is marked as deprecated and will be removed in some future release.
11 years ago
void(AbstractFramebuffer::*bindImplementation)(FramebufferTarget);
FramebufferTarget(AbstractFramebuffer::*bindInternalImplementation)();
#endif
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
ARB_direct_state_access support for creating framebuffers.
12 years ago
void(Framebuffer::*createImplementation)();
Added Framebuffer::detach().
11 years ago
void(Framebuffer::*renderbufferImplementation)(Framebuffer::BufferAttachment, GLuint);
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
#ifndef MAGNUM_TARGET_GLES
Better texture attaching in Framebuffer. The previous way was half-working at best, as it handled array textures improperly. Now there is overload for each texture type. The old way with attachTexture*D() is marked as deprecated and will be removed in future release.
12 years ago
void(Framebuffer::*texture1DImplementation)(Framebuffer::BufferAttachment, GLuint, GLint);
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
#endif
void(Framebuffer::*texture2DImplementation)(Framebuffer::BufferAttachment, GLenum, GLuint, GLint);
Fix Framebuffer::attachCubeMapTexture() behaving as a layered attachment. The DSA function does not accept any texture target parameter so the cube map texture was bound as a whole (and thus behaving as a layered attachment) instead of just a single face. Thanks to @chpatrick for the report.
11 years ago
void(Framebuffer::*textureCubeMapImplementation)(Framebuffer::BufferAttachment, GLenum, GLuint, GLint);
Support for layered texture attachments in Framebuffer. I.e. rendering to a layer addressed by `gl_Layer` in geometry shader.
11 years ago
#if !defined(MAGNUM_TARGET_WEBGL) && !defined(MAGNUM_TARGET_GLES2)
void(Framebuffer::*textureImplementation)(Framebuffer::BufferAttachment, GLuint, GLint);
#endif
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Better texture attaching in Framebuffer. The previous way was half-working at best, as it handled array textures improperly. Now there is overload for each texture type. The old way with attachTexture*D() is marked as deprecated and will be removed in future release.
12 years ago
void(Framebuffer::*textureLayerImplementation)(Framebuffer::BufferAttachment, GLuint, GLint, GLint);
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#endif
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
ARB_direct_state_access support for creating renderbuffers.
12 years ago
void(Renderbuffer::*createRenderbufferImplementation)();
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
void(Renderbuffer::*renderbufferStorageImplementation)(RenderbufferFormat, const Vector2i&);
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
void(Renderbuffer::*renderbufferStorageMultisampleImplementation)(GLsizei, RenderbufferFormat, const Vector2i&);
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
#endif
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
Pixel storage support, part 2: renamed ColorFormat to PixelFormat etc. Yeah, sorry, I know, the enums are renamed for second or third time in a row, first they were Image::Format, then ImageFormat, then ColorFormat and now PixelFormat. But this time it's final and last time they are renamed and now everything is finally consistent: * ColorFormat::DepthComponent -- depth is not a color, thus PixelFormat::DepthComponent makes a lot more sense. * There will be PixelStorage classes, which will be stored in images alonside PixelFormat/PixelType enums, making everything nicely aligned. * The GL documentation about glTexImage2D() etc. denotes the <format> and <type> parameters as format and type of *pixel* data, so now we are _finally_ consistent with the official naming. I wonder why did I not choose PixelFormat originally. Anyway, the old <Magnum/ColorFormat.h> header, ColorFormat, ColorType and CompressedColorFormat types are now aliases to the new ones, are marked as deprecated and will be removed in some future release (as always, I'm waiting at least six months before removing the deprecated functionality).
11 years ago
void(*readImplementation)(const Range2Di&, PixelFormat, PixelType, std::size_t, GLvoid*);
Moved global data from framebuffer classes to per-context state. On the way to unify and reduce the "Using optional features" messages.
12 years ago
Tracking currently bound renderbuffer.
14 years ago
GLuint readBinding, drawBinding, renderbufferBinding;
First-class WebGL support, part 5: reduced framebuffer functionality.
11 years ago
GLint maxDrawBuffers, maxColorAttachments, maxRenderbufferSize;
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
GLint maxSamples;
#endif
Framebuffer-related limit queries. Also printing the values in magnum-info.
13 years ago
#ifndef MAGNUM_TARGET_GLES
GLint maxDualSourceDrawBuffers;
#endif
Using Range2D instead of Rectangle everywhere. Encourages vectorization and generic usage even more. Some functions were rewritten to make use of the new features, resulting in shorter and more readable code. This also fixes the annoying naming collision with WINAPI Rectangle() function. The old Rectangle is now subclass of Range2D, is marked as deprecated and will be removed in future release.
13 years ago
Range2Di viewport;
Framebuffer-related limit queries. Also printing the values in magnum-info.
13 years ago
Vector2i maxViewportSize;
Tracking framebuffer binding.
14 years ago
};
}}
#endif