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

2706 lines
126 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_TextureFormat_h
#define Magnum_GL_TextureFormat_h
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/*
This file is part of Magnum.
Updated copyright year.
6 years ago
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019,
Updated copyright year.
4 years ago
2020, 2021, 2022 Vladimír Vondruš <mosra@centrum.cz>
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
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.
*/
/** @file
Split the OpenGL layer out, pt 4: new Magnum::GL namespace. At the moment just the GL library itself w/o the tests, and without backwards compatibility aliases. The following types were left in the root namespace, despite being in the GL/ directory, as they will get moved back soon: * Image, CompressedImage and their dimensional typedefs * ImageView, CompressedImageView and their dimensional typedefs * PixelStorage Not PixelFormat etc., that one will stay in the GL namespace and a completely new PixelFormat enum will be provided in the root namespace.
8 years ago
* @brief Enum @ref Magnum::GL::TextureFormat
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
#include "Magnum/Magnum.h"
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/OpenGL.h"
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
#include "Magnum/GL/visibility.h"
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
GL: properly include a header for the deprecation macro.
7 years ago
#ifdef MAGNUM_BUILD_DEPRECATED
#include <Corrade/Utility/Macros.h>
#endif
Split the OpenGL layer out, pt 4: new Magnum::GL namespace. At the moment just the GL library itself w/o the tests, and without backwards compatibility aliases. The following types were left in the root namespace, despite being in the GL/ directory, as they will get moved back soon: * Image, CompressedImage and their dimensional typedefs * ImageView, CompressedImageView and their dimensional typedefs * PixelStorage Not PixelFormat etc., that one will stay in the GL namespace and a completely new PixelFormat enum will be provided in the root namespace.
8 years ago
namespace Magnum { namespace GL {
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
@brief Internal texture format
Updated and improved ColorFormat, ColorType and TextureFormat enum docs. Finishing promises made in #31.
13 years ago
In most cases you may want to use @ref TextureFormat::R8 (for grayscale
textures), @ref TextureFormat::RGB8 or @ref TextureFormat::RGBA8. The matching
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
color format is then @ref PixelFormat::Red, @ref PixelFormat::RGB or
@ref PixelFormat::RGBA along with @ref PixelType::UnsignedByte. See
Updated and improved ColorFormat, ColorType and TextureFormat enum docs. Finishing promises made in #31.
13 years ago
documentation of these values for possible limitations when using OpenGL ES 2.0
or WebGL.
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
@see @ref textureFormat(), @ref hasTextureFormat(), @ref Texture,
@ref CubeMapTexture, @ref CubeMapTextureArray
Documentation updates for the new theme in the root namespace. Also adding search keywords for hopefully all OpenGL APIs.
8 years ago
@m_enum_values_as_keywords
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
enum class TextureFormat: GLenum {
First-class WebGL support, part 7: reduced color formats.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Documented texture formats disallowed in *Texture::setStorage().
13 years ago
* Red component, normalized unsigned, size implementation-dependent. Not
* allowed in unemulated @ref Texture::setStorage() "*Texture::setStorage()"
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* calls, in that case use @ref TextureFormat::R8 "TextureFormat::R8"
* instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
* @requires_gles30 Extension @gl_extension{EXT,texture_rg} in OpenGL ES
First-class WebGL support, part 7: reduced color formats.
11 years ago
* 2.0.
* @requires_webgl20 Not available in WebGL 1.0, see @ref TextureFormat::Luminance
* for an alternative.
doc: strict ordering of sections in detailed documentation. It makes sense, but this ordering also helps to avoid bug in Doxygen 1.8.6+ which merges next non-xrefitem section with the previous one (so e.g. the TODO list contained the following @see block, which is not desired).
12 years ago
* @deprecated_gl Prefer to use the exactly specified version of this
Cleaned up old Doxygen workarounds.
11 years ago
* format, e.g. @ref TextureFormat::R8.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
Red = GL_RED,
#else
Red = GL_RED_EXT,
#endif
/**
* Red component, normalized unsigned byte.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
* @requires_gles30 Extension @gl_extension{EXT,texture_rg} and
* @gl_extension{EXT,texture_storage} in OpenGL ES 2.0. For texture
Cleaned up old Doxygen workarounds.
11 years ago
* storage only, for image specification use @ref TextureFormat::Red
* instead.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Not available in WebGL 1.0, see @ref TextureFormat::Luminance
* for an alternative.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
#ifndef MAGNUM_TARGET_GLES2
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
R8 = GL_R8,
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
#else
R8 = GL_R8_EXT,
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#endif
/**
* Red and green component, normalized unsigned, size
Documented texture formats disallowed in *Texture::setStorage().
13 years ago
* implementation-dependent. Not allowed in unemulated
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* @ref Texture::setStorage() "*Texture::setStorage()" calls, in that case
* use @ref TextureFormat::RG8 "TextureFormat::RG8" instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
* @requires_gles30 Extension @gl_extension{EXT,texture_rg} in OpenGL ES
First-class WebGL support, part 7: reduced color formats.
11 years ago
* 2.0.
* @requires_webgl20 Not available in WebGL 1.0, see
* @ref TextureFormat::LuminanceAlpha for an alternative.
doc: strict ordering of sections in detailed documentation. It makes sense, but this ordering also helps to avoid bug in Doxygen 1.8.6+ which merges next non-xrefitem section with the previous one (so e.g. the TODO list contained the following @see block, which is not desired).
12 years ago
* @deprecated_gl Prefer to use the exactly specified version of this
Cleaned up old Doxygen workarounds.
11 years ago
* format, e.g. @ref TextureFormat::RG8.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
RG = GL_RG,
#else
RG = GL_RG_EXT,
#endif
/**
* Red and green component, each normalized unsigned byte.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
* @requires_gles30 Extension @gl_extension{EXT,texture_rg} and
* @gl_extension{EXT,texture_storage} in OpenGL ES 2.0. For texture
Cleaned up old Doxygen workarounds.
11 years ago
* storage only, for image specification use @ref TextureFormat::RG
* instead.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Not available in WebGL 1.0, see
* @ref TextureFormat::LuminanceAlpha for an alternative.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
#ifndef MAGNUM_TARGET_GLES2
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RG8 = GL_RG8,
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
#else
RG8 = GL_RG8_EXT,
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: put extension docs to proper enum value. It's relevant to the generic RGB/RGBA format, not the sized 16F formats that aren't available in WebGL 1 anyway.
7 years ago
* RGB, type/size implementation-dependent. Not allowed in unemulated
* @ref Texture::setStorage() "*Texture::setStorage()" calls, in
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
* that case use @ref TextureFormat::RGB8 "TextureFormat::RGB8" instead. On
* desktop OpenGL this format is meant to be used for
* @ref PixelFormat::BGR as well.
Doc++
8 years ago
* @requires_gl Can't be used as a render target in OpenGL ES or WebGL. See
* @ref TextureFormat::RGBA for an alternative.
Separated deprecated API and deprecated GL API in the docs. New code may not use deprecated API, but for some reasons (support for old GL versions) might use deprecated GL API.
13 years ago
* @deprecated_gl Prefer to use the exactly specified version of this
Cleaned up old Doxygen workarounds.
11 years ago
* format, e.g. @ref TextureFormat::RGB8.
GL: put extension docs to proper enum value. It's relevant to the generic RGB/RGBA format, not the sized 16F formats that aren't available in WebGL 1 anyway.
7 years ago
* @requires_webgl20 Extension @webgl_extension{OES,texture_half_float_linear}
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* for filtering @ref PixelType::Half textures using
GL: put extension docs to proper enum value. It's relevant to the generic RGB/RGBA format, not the sized 16F formats that aren't available in WebGL 1 anyway.
7 years ago
* @ref SamplerFilter::Linear in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB = GL_RGB,
First-class WebGL support, part 7: reduced color formats.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
* RGB, each component normalized unsigned byte. On desktop OpenGL this
* format is meant to be used for @ref PixelFormat::BGRA as well.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,required_internalformat}
* (for image specification) or @gl_extension{EXT,texture_storage}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* (for texture storage) in OpenGL ES 2.0. Use @ref TextureFormat::RGB
* otherwise.
* @requires_webgl20 Not available in WebGL 1.0, use
* @ref TextureFormat::RGB instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
RGB8 = GL_RGB8,
#else
RGB8 = GL_RGB8_OES,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: put extension docs to proper enum value. It's relevant to the generic RGB/RGBA format, not the sized 16F formats that aren't available in WebGL 1 anyway.
7 years ago
* RGBA, type/size implementation-dependent. Not allowed in unemulated
* @ref Texture::setStorage() "*Texture::setStorage()" calls, in that case
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
* use @ref TextureFormat::RGBA8 "TextureFormat::RGBA8" instead. On desktop
* OpenGL this format is meant to be used for @ref PixelFormat::BGRA as
* well, however on OpenGL ES you're required to use
* @ref TextureFormat::BGRA for BGRA pixel formats.
Separated deprecated API and deprecated GL API in the docs. New code may not use deprecated API, but for some reasons (support for old GL versions) might use deprecated GL API.
13 years ago
* @deprecated_gl Prefer to use the exactly specified version of this
Cleaned up old Doxygen workarounds.
11 years ago
* format, e.g. @ref TextureFormat::RGBA8.
GL: put extension docs to proper enum value. It's relevant to the generic RGB/RGBA format, not the sized 16F formats that aren't available in WebGL 1 anyway.
7 years ago
* @requires_webgl20 Extension @webgl_extension{OES,texture_half_float_linear}
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* for filtering @ref PixelType::Half textures using
GL: put extension docs to proper enum value. It's relevant to the generic RGB/RGBA format, not the sized 16F formats that aren't available in WebGL 1 anyway.
7 years ago
* @ref SamplerFilter::Linear in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA = GL_RGBA,
First-class WebGL support, part 7: reduced color formats.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
* RGBA, each component normalized unsigned byte. On desktop OpenGL this
* format is meant to be used with @ref PixelFormat::BGRA as well, however
* on OpenGL ES you're required to use @ref TextureFormat::BGRA8 for BGRA
* pixel formats.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,required_internalformat}
* (for image specification) or @gl_extension{EXT,texture_storage}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* (for texture storage) in OpenGL ES 2.0. Use @ref TextureFormat::RGBA
* otherwise.
* @requires_webgl20 Not available in WebGL 1.0, use
* @ref TextureFormat::RGBA instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
RGBA8 = GL_RGBA8,
#else
RGBA8 = GL_RGBA8_OES,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
GL: hook up EXT_texture_sRGB_RG8 for desktop GL as well. Was browsing the extension registry looking for something else and found this instead. It used to be ES catching up with desktop, now it's the other way around.
4 years ago
#if !defined(MAGNUM_TARGET_WEBGL) && !defined(MAGNUM_TARGET_GLES2)
GL: reorganize sRGB TextureFormat values to be together with the 8bit ones. These do not belong into the "weird formats" section at the end.
7 years ago
/**
* sRGB-encoded red component, normalized unsigned byte.
* @requires_extension Extension @gl_extension{EXT,texture_sRGB_R8}
GL: TextureFormat::SR[G]8 aren't supposed to be available on ES2.
5 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_sRGB_R8}
GL: reorganize sRGB TextureFormat values to be together with the 8bit ones. These do not belong into the "weird formats" section at the end.
7 years ago
* @requires_gles One- and two-component sRGB texture formats are not
* available in WebGL, use @ref TextureFormat::SRGB8 or
* @ref TextureFormat::SRGB8Alpha8
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
* @m_since{2019,10}
GL: reorganize sRGB TextureFormat values to be together with the 8bit ones. These do not belong into the "weird formats" section at the end.
7 years ago
*/
SR8 = GL_SR8_EXT,
/**
* sRGB-encoded red and green component, normalized unsigned byte.
GL: hook up EXT_texture_sRGB_RG8 for desktop GL as well. Was browsing the extension registry looking for something else and found this instead. It used to be ES catching up with desktop, now it's the other way around.
4 years ago
* @requires_extension Extension @gl_extension{EXT,texture_sRGB_RG8}
GL: TextureFormat::SR[G]8 aren't supposed to be available on ES2.
5 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_sRGB_RG8}
GL: reorganize sRGB TextureFormat values to be together with the 8bit ones. These do not belong into the "weird formats" section at the end.
7 years ago
* @requires_gles One- and two-component sRGB texture formats are not
* available in WebGL, use @ref TextureFormat::SRGB8 or
GL: hook up EXT_texture_sRGB_RG8 for desktop GL as well. Was browsing the extension registry looking for something else and found this instead. It used to be ES catching up with desktop, now it's the other way around.
4 years ago
* @ref TextureFormat::SRGB8Alpha8 instead.
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
* @m_since{2019,10}
GL: reorganize sRGB TextureFormat values to be together with the 8bit ones. These do not belong into the "weird formats" section at the end.
7 years ago
*/
SRG8 = GL_SRG8_EXT,
#endif
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2)
/**
* sRGB, normalized unsigned, size implementation-dependent. Not allowed in
* unemulated @ref Texture::setStorage() "*Texture::setStorage()" calls, in
* that case use @ref TextureFormat::SRGB8 "TextureFormat::SRGB8" instead.
* @requires_es_extension Extension @gl_extension{EXT,sRGB} in OpenGL ES 2.0.
* Use @ref TextureFormat::SRGB8 in OpenGL ES 3.0 instead.
* @requires_webgl_extension Extension @webgl_extension{EXT,sRGB} in WebGL
* 1.0. Use @ref TextureFormat::SRGB8 in WebGL 2.0 instead.
* @deprecated_gl Prefer to use the exactly specified version of this
* format, i.e. @ref TextureFormat::SRGB8.
*/
#ifndef MAGNUM_TARGET_GLES
SRGB = GL_SRGB,
#else
SRGB = GL_SRGB_EXT,
#endif
#endif
#ifndef MAGNUM_TARGET_GLES2
/**
* sRGB, each component normalized unsigned byte.
* @requires_gles30 Use @ref TextureFormat::SRGB in OpenGL ES 2.0 instead.
* @requires_gl Can't be used as render target in OpenGL ES. Use
* @ref TextureFormat::SRGB8Alpha8 instead.
* @requires_webgl20 Use @ref TextureFormat::SRGB in WebGL 1.0 instead.
*/
SRGB8 = GL_SRGB8, /* NV_sRGB_formats has this on ES2, but meh */
#endif
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2)
/**
* sRGB + linear alpha, normalized unsigned, size implementation-dependent.
* Not allowed in unemulated @ref Texture::setStorage() "*Texture::setStorage()"
* calls, in that case use @ref TextureFormat::SRGB8Alpha8 "TextureFormat::SRGB8Alpha8"
* instead.
* @requires_es_extension Extension @gl_extension{EXT,sRGB} in OpenGL ES
* 2.0. Use @ref TextureFormat::SRGB8Alpha8 in OpenGL ES 3.0 instead.
* @requires_webgl_extension Extension @webgl_extension{EXT,sRGB} in WebGL
* 1.0. Use @ref TextureFormat::SRGB8Alpha8 in WebGL 2.0 instead.
* @deprecated_gl Prefer to use the exactly specified version of this
* format, i.e. @ref TextureFormat::SRGB8Alpha8.
*/
#ifndef MAGNUM_TARGET_GLES
SRGBAlpha = GL_SRGB_ALPHA,
#else
SRGBAlpha = GL_SRGB_ALPHA_EXT,
#endif
#endif
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
/**
* sRGB + linear alpha, each component normalized unsigned byte.
* @requires_gles30 Extension @gl_extension{EXT,sRGB} and
* @gl_extension{EXT,texture_storage}, only for
* @ref Texture::setStorage() "*Texture::setStorage()" calls,
* otherwise use @ref TextureFormat::SRGBAlpha in OpenGL ES 2.0
* instead.
* @requires_webgl20 Use @ref TextureFormat::SRGBAlpha in WebGL 1.0 instead.
*/
#ifndef MAGNUM_TARGET_GLES2
SRGB8Alpha8 = GL_SRGB8_ALPHA8,
#else
SRGB8Alpha8 = GL_SRGB8_ALPHA8_EXT, /* Not in spec, works at least on NV */
#endif
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#ifndef MAGNUM_TARGET_GLES2
/**
* Red component, normalized signed byte.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
Clarified which texture formats can be linearly filtered.
9 years ago
* @requires_gl Can't be used as render target in OpenGL ES. Use
* @ref TextureFormat::RGB8I instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only unsigned formats are available in OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only unsigned formats are available in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R8Snorm = GL_R8_SNORM,
/**
* Red and green component, each normalized signed byte.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
Clarified which texture formats can be linearly filtered.
9 years ago
* @requires_gl Can't be used as render target in OpenGL ES. Use
* @ref TextureFormat::RGB8I instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only unsigned formats are available in OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only unsigned formats are available in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG8Snorm = GL_RG8_SNORM,
/**
* RGB, each component normalized signed byte.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
Clarified which texture formats can be linearly filtered.
9 years ago
* @requires_gl Can't be used as render target in OpenGL ES. Use
* @ref TextureFormat::RGB8I instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only unsigned formats are available in OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only unsigned formats are available in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB8Snorm = GL_RGB8_SNORM,
/**
* RGBA, each component normalized signed byte.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
Clarified which texture formats can be linearly filtered.
9 years ago
* @requires_gl Can't be used as render target in OpenGL ES. Use
* @ref TextureFormat::RGB8I instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only unsigned formats are available in OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only unsigned formats are available in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA8Snorm = GL_RGBA8_SNORM,
Minor cleanup in image and texture format enums. Removed hierarchic and confusing `#ifdef`s.
13 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
#ifndef MAGNUM_TARGET_GLES2
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* Red component, normalized unsigned short.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles30 Only byte-sized normalized formats are available in
* OpenGL ES 2.0
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
R16 = GL_R16,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
R16 = GL_R16_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* Red and green component, each normalized unsigned short.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RG16 = GL_RG16,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
RG16 = GL_RG16_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGB, each component normalized unsigned short.
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RGB16 = GL_RGB16,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
RGB16 = GL_RGB16_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGBA, each component normalized unsigned short.
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RGBA16 = GL_RGBA16,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
RGBA16 = GL_RGBA16_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* Red component, normalized signed short.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
R16Snorm = GL_R16_SNORM,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
R16Snorm = GL_R16_SNORM_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* Red and green component, each normalized signed short.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RG16Snorm = GL_RG16_SNORM,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
RG16Snorm = GL_RG16_SNORM_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGB, each component normalized signed short.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RGB16Snorm = GL_RGB16_SNORM,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
RGB16Snorm = GL_RGB16_SNORM_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGBA, each component normalized signed short.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl31 Extension @gl_extension{EXT,texture_snorm}
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
* @requires_gles31 Only byte-sized normalized formats are available in
* OpenGL ES 3.0 and older; not defined on ES2
* @requires_es_extension OpenGL ES 3.1 and @gl_extension{EXT,texture_norm16}
GL: EXT_texture_norm16 is not on WebGL 1 anymore. It got changed shortly after the original implementation in 083ecf72b8a3de8b92cd2df2a597722a636c19da to be WebGL 2 only.
5 years ago
* @requires_webgl_extension WebGL 2.0 and extension
* @webgl_extension{EXT,texture_norm16}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
RGBA16Snorm = GL_RGBA16_SNORM,
GL: implement EXT_texture_norm16 ES and WebGL extension.
6 years ago
#else
RGBA16Snorm = GL_RGBA16_SNORM_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#endif
Minor cleanup in image and texture format enums. Removed hierarchic and confusing `#ifdef`s.
13 years ago
#ifndef MAGNUM_TARGET_GLES2
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red component, non-normalized unsigned byte. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R8UI = GL_R8UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red and green component, each non-normalized unsigned byte. Can't be
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG8UI = GL_RG8UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGB, each component non-normalized unsigned byte. Can't be filtered
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB8UI = GL_RGB8UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGBA, each component non-normalized unsigned byte. Can't be filtered
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA8UI = GL_RGBA8UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red component, non-normalized signed byte. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R8I = GL_R8I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red and green component, each non-normalized signed byte. Can't be
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG8I = GL_RG8I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGB, each component non-normalized signed byte. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB8I = GL_RGB8I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGBA, each component non-normalized signed byte. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA8I = GL_RGBA8I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red component, non-normalized unsigned short. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R16UI = GL_R16UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red and green component, each non-normalized unsigned short. Can't be
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG16UI = GL_RG16UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGB, each component non-normalized unsigned short. Can't be filtered
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB16UI = GL_RGB16UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGBA, each component non-normalized unsigned short. Can't be filtered
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA16UI = GL_RGBA16UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red component, non-normalized signed short. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R16I = GL_R16I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red and green component, each non-normalized signed short. Can't be
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG16I = GL_RG16I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGB, each component non-normalized signed short. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB16I = GL_RGB16I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGBA, each component non-normalized signed short. Can't be filtered
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA16I = GL_RGBA16I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red component, non-normalized unsigned int. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R32UI = GL_R32UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red and green component, each non-normalized unsigned int. Can't be
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG32UI = GL_RG32UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGB, each component non-normalized unsigned int. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB32UI = GL_RGB32UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGBA, each component non-normalized unsigned int. Can't be filtered
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA32UI = GL_RGBA32UI,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red component, non-normalized signed int. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R32I = GL_R32I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* Red and green component, each non-normalized signed int. Can't be
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG32I = GL_RG32I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGB, each component non-normalized signed int. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB32I = GL_RGB32I,
/**
Clarified which texture formats can be linearly filtered.
9 years ago
* RGBA, each component non-normalized signed int. Can't be filtered using
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_integer}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA32I = GL_RGBA32I,
/**
* Red component, half float.
doc: another day, another heap of Doxygen fun.
6 years ago
* @see @ref Magnum::Half "Half", @ref Math::packHalf(),
* @ref Math::unpackHalf()
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::Red / @ref TextureFormat::Luminance
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* in combination with @ref PixelType::Half
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* (@gl_extension2{OES,texture_half_float,OES_texture_float}) in OpenGL
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension2{OES,texture_half_float_linear,OES_texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear in OpenGL ES 2.0.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{EXT,color_buffer_half_float} to
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* use as a render target. Use @ref TextureFormat::R16UI or
* @ref TextureFormat::R16I instead if not available.
* @requires_webgl20 Use @ref TextureFormat::Red / @ref TextureFormat::Luminance
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* in combination with @ref PixelType::Half (@webgl_extension{OES,texture_half_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in WebGL 1.0.
* @requires_webgl20 Extension @webgl_extension{OES,texture_half_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear in WebGL 1.0.
GL: fix EXT_color_buffer_half_float to be presennt also in WebGL 2. It was mistakenly thought to be replaced by the EXT_color_buffer_float (which replaces WEBGL_color_buffer_float and in addition lists both 16- and 32-bit float variants). But since there are still those stupid patents for rendering to 32-bit float attachments, certain hardware supports only rendering to 16-bit and not 32-bit, so the "superset" extension isn't enough to be able to discover which hardware can render to half-floats. Also updated (hopefully all) docs to list this extension as being an option on WebGL 2 as well.
4 years ago
* @requires_webgl_extension Extension
* @webgl_extension{EXT,color_buffer_half_float} or
* @webgl_extension{EXT,color_buffer_float} to use as a render target
* in WebGL 2.0; use @ref TextureFormat::R16UI or
* @ref TextureFormat::R16I instead if not available. Only three-
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* and four-component half-float texture formats can be used as
* a render target in WebGL 1.0, see @ref TextureFormat::RGBA16F for
* more information.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R16F = GL_R16F,
/**
* Red and green component, each half float.
doc: another day, another heap of Doxygen fun.
6 years ago
* @see @ref Magnum::Half "Half", @ref Math::packHalf(),
* @ref Math::unpackHalf()
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::RG / @ref TextureFormat::LuminanceAlpha
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* in combination with @ref PixelType::Half
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* (@gl_extension2{OES,texture_half_float,OES_texture_float}) in OpenGL
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension2{OES,texture_half_float_linear,OES_texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear in OpenGL ES 2.0.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{EXT,color_buffer_half_float} to
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* use as a render target in OpenGL ES. Use @ref TextureFormat::RG16UI
* or @ref TextureFormat::RG16I instead if not available.
* @requires_webgl20 Use @ref TextureFormat::RG / @ref TextureFormat::LuminanceAlpha
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* in combination with @ref PixelType::Half (@webgl_extension{OES,texture_half_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in WebGL 1.0 instead.
* @requires_webgl20 Extension @webgl_extension{OES,texture_half_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear in WebGL 1.0.
GL: fix EXT_color_buffer_half_float to be presennt also in WebGL 2. It was mistakenly thought to be replaced by the EXT_color_buffer_float (which replaces WEBGL_color_buffer_float and in addition lists both 16- and 32-bit float variants). But since there are still those stupid patents for rendering to 32-bit float attachments, certain hardware supports only rendering to 16-bit and not 32-bit, so the "superset" extension isn't enough to be able to discover which hardware can render to half-floats. Also updated (hopefully all) docs to list this extension as being an option on WebGL 2 as well.
4 years ago
* @requires_webgl_extension Extension
* @webgl_extension{EXT,color_buffer_half_float} or
* @webgl_extension{EXT,color_buffer_float} to use as a render target
* in WebGL 2.0; use @ref TextureFormat::RG16UI or
* @ref TextureFormat::RG16I instead if not available. Only three-
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* and four-component half-float texture formats can be used as
* a render target in WebGL 1.0, see @ref TextureFormat::RGBA16F for
* more information.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG16F = GL_RG16F,
/**
* RGB, each component half float.
doc: another day, another heap of Doxygen fun.
6 years ago
* @see @ref Magnum::Half "Half", @ref Math::packHalf(),
* @ref Math::unpackHalf()
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::RGB in combination with
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* @ref PixelType::Half (@gl_extension2{OES,texture_half_float,OES_texture_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in OpenGL ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension2{OES,texture_half_float_linear,OES_texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear in OpenGL ES 2.0.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl20 Use @ref TextureFormat::RGB in combination with
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* @ref PixelType::Half (@webgl_extension{OES,texture_half_float}) in
* WebGL 1.0 instead.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gl Can't be used as a render target in OpenGL ES or WebGL 2.0.
* Use @ref TextureFormat::RGBA16F instead. Use @ref TextureFormat::RGB
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* in combination with @ref PixelType::Half
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* (@webgl_extension{EXT,color_buffer_half_float}) in WebGL 1.0
* instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB16F = GL_RGB16F,
/**
* RGBA, each component half float.
doc: another day, another heap of Doxygen fun.
6 years ago
* @see @ref Magnum::Half "Half", @ref Math::packHalf(),
* @ref Math::unpackHalf()
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::RGBA in combination with
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* @ref PixelType::Half (@gl_extension2{OES,texture_half_float,OES_texture_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in OpenGL ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension2{OES,texture_half_float_linear,OES_texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{EXT,color_buffer_half_float} to
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* use as a render target in OpenGL ES. Use @ref TextureFormat::RGBA16UI
* or @ref TextureFormat::RGBA16I instead if not available.
* @requires_webgl20 Use @ref TextureFormat::RGBA in combination with
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* @ref PixelType::Half (@webgl_extension{OES,texture_half_float}) in
* WebGL 1.0 instead.
GL: fix EXT_color_buffer_half_float to be presennt also in WebGL 2. It was mistakenly thought to be replaced by the EXT_color_buffer_float (which replaces WEBGL_color_buffer_float and in addition lists both 16- and 32-bit float variants). But since there are still those stupid patents for rendering to 32-bit float attachments, certain hardware supports only rendering to 16-bit and not 32-bit, so the "superset" extension isn't enough to be able to discover which hardware can render to half-floats. Also updated (hopefully all) docs to list this extension as being an option on WebGL 2 as well.
4 years ago
* @requires_webgl_extension Extension
* @webgl_extension{EXT,color_buffer_half_float} or
* @webgl_extension{EXT,color_buffer_float} to use as a render target
* in WebGL 2.0. Use @ref TextureFormat::RGBA16UI or
* @ref TextureFormat::RGBA16I instead if not available. Use
GL: rename PixelType::HalfFloat and Attribute::DataType::HalfFloat to Half. For consistency with the Half type we use elsewhere. The old enums are still available, but deprecated and scheduled for removal.
6 years ago
* @ref TextureFormat::RGBA in combination with @ref PixelType::Half
GL: fix EXT_color_buffer_half_float to be presennt also in WebGL 2. It was mistakenly thought to be replaced by the EXT_color_buffer_float (which replaces WEBGL_color_buffer_float and in addition lists both 16- and 32-bit float variants). But since there are still those stupid patents for rendering to 32-bit float attachments, certain hardware supports only rendering to 16-bit and not 32-bit, so the "superset" extension isn't enough to be able to discover which hardware can render to half-floats. Also updated (hopefully all) docs to list this extension as being an option on WebGL 2 as well.
4 years ago
* (@webgl_extension{EXT,color_buffer_half_float}) in WebGL 1.0
* instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA16F = GL_RGBA16F,
/**
* Red component, float.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::Red / @ref TextureFormat::Luminance
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* in combination with @ref PixelType::Float (@gl_extension{OES,texture_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in OpenGL ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{EXT,color_buffer_float} to use as
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* a render target. Use @ref TextureFormat::R32UI or
* @ref TextureFormat::R32I instead if not available.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_es_extension Extension @gl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl20 Use @ref TextureFormat::Red / @ref TextureFormat::Luminance
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* in combination with @ref PixelType::Float (@webgl_extension{OES,texture_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in WebGL 1.0 instead.
* @requires_webgl_extension Extension @webgl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl_extension Extension @webgl_extension{EXT,color_buffer_float}
* to use as a render target in WebGL 2.0; use @ref TextureFormat::R32UI
* or @ref TextureFormat::R32I instead if not available. Only three-
* and four-component half-float texture formats can be used as
* a render target in WebGL 1.0. See @ref TextureFormat::RGBA32F for
* more information.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
R32F = GL_R32F,
/**
* Red and green component, each float.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg} and @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::RG / @ref TextureFormat::LuminanceAlpha
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* in combination with @ref PixelType::Float (@gl_extension{OES,texture_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in OpenGL ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{EXT,color_buffer_float} to use as
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* a render target. Use @ref TextureFormat::RG32UI or
* @ref TextureFormat::RG32I instead if not available.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_es_extension Extension @gl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl20 Use @ref TextureFormat::RG / @ref TextureFormat::LuminanceAlpha
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* in combination with @ref PixelType::Float (@webgl_extension{OES,texture_float})
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* in WebGL 1.0 instead.
* @requires_webgl_extension Extension @webgl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl_extension Extension @webgl_extension{EXT,color_buffer_float}
* to use as a render target in WebGL 2.0; use @ref TextureFormat::RG32UI
* or @ref TextureFormat::RG32I instead if not available. Only three-
* and four-component half-float texture formats can be used as
* a render target in WebGL 1.0. See @ref TextureFormat::RGBA32F for
* more information.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RG32F = GL_RG32F,
/**
* RGB, each component float.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::RGB in combination with
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* @ref PixelType::Float (@gl_extension{OES,texture_float}) in OpenGL
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_es_extension Extension @gl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl20 Use @ref TextureFormat::RGB in combination with
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* @ref PixelType::Float (@webgl_extension{OES,texture_float}) in
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* WebGL 1.0 instead.
* @requires_webgl_extension Extension @webgl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gl Can't be used as a render target in OpenGL ES or WebGL 2.0.
* Use @ref TextureFormat::RGBA32F instead. Use @ref TextureFormat::RGB
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* in combination with @ref PixelType::Float
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* (@webgl_extension{WEBGL,color_buffer_float}) in WebGL 1.0 instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB32F = GL_RGB32F,
/**
* RGBA, each component float.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_float}
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_gles30 Use @ref TextureFormat::RGBA in combination with
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* @ref PixelType::Float (@gl_extension{OES,texture_float}) in OpenGL
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* ES 2.0 instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_es_extension Extension @gl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{EXT,color_buffer_float} to
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* use as a render target in OpenGL ES. Use @ref TextureFormat::RGBA32UI
* or @ref TextureFormat::RGBA32I instead if not available.
* @requires_webgl20 Use @ref TextureFormat::RGBA in combination with
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* @ref PixelType::Float (@webgl_extension{OES,texture_float}) in
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* WebGL 1.0 instead.
* @requires_webgl_extension Extension @webgl_extension{OES,texture_float_linear}
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* for filtering using @ref SamplerFilter::Linear.
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* @requires_webgl_extension Extension @webgl_extension{EXT,color_buffer_float}
* to use as a render target in WebGL 2.0. Use @ref TextureFormat::RGBA32UI
* or @ref TextureFormat::RGBA32I instead if not available. Use
doc: fix mismatched enum value links. Doxygen 1.8.17 *finally* fixes enum value linking and so linking to Enum::Value via TotallyArbitraryString::Value no longer works. That uncovered a ton of documentation errors. A welcome improvement, for once.
6 years ago
* @ref TextureFormat::RGBA in combination with @ref PixelType::Float
Clarified filtering and renderability of floating-point formats. * Half-floats and floats are usable in ES2 / WebGL 1 (they weren't by mistake) -- just use OES_texture_float or OES_texture_half_float. * Half-floats are linearly filterable in ES3 / WebGL 2 and OES_texture_half_float_linear makes it possible in ES2 / WebGL 1. * Floats are not linearly filterable, not even in ES3 (they were by mistake) -- one needs OES_texture_float_linear for that. * Neither floats nor half-floats are renderable in ES < 3.2 -- one needs EXT_color_buffer_half_float or EXT_color_buffer_float for that. The former is available for example on iOS, the latter is apparently only on NV cards. Both are builtin in ES 3.2, EXT_color_buffer_float depends in ES3, so half-floats are the only possible format to render to in ES2. * Rendering to floats in WebGL is slightly more complicated -- unlike with OpenGL ES 2 it's possible to render to floats in WebGL 1 using WEBGL_color_buffer_float. There's another WebGL 1 extension called EXT_color_buffer_half_float and they are both replaced with EXT_color_buffer_float in WebGL 2. And, as a cherry on top, GPH (formerly SGI) has patents on most of these, which is probably why the support for them is so spotty.
9 years ago
* (@webgl_extension{WEBGL,color_buffer_float}) in WebGL 1.0 instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA32F = GL_RGBA32F,
#endif
Added ES2-only support for GL_LUMINANCE{,_ALPHA}. It is deprecated, but many ES2 implementations don't support EXT_texture_rg, thus this is the only way to have single- and two-component textures without wasting precious memory. The enum value isn't exposed on desktop OpenGL and ES3. GL_ALPHA is not supported, as it doesn't bring any new functionality (it is also single-component and thus can be interchanged with GL_LUMINANCE).
13 years ago
#if defined(MAGNUM_TARGET_GLES2) || defined(DOXYGEN_GENERATING_OUTPUT)
/**
* Luminance, normalized unsigned, single value used for all RGB channels.
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* Size implementation-dependent. Not allowed in unemulated
* @ref Texture::setStorage() "*Texture::setStorage()" calls.
doc: rename \requires_gles20 to \requires_gles20_only. So it's clearer it doesn't mean "GLES 2.0 and everything above", like all other \requires_foo commands.
5 years ago
* @requires_gles20_only Not available in OpenGL ES 3.0, WebGL 2.0 or
* desktop OpenGL. Use @ref TextureFormat::R8 instead.
doc: strict ordering of sections in detailed documentation. It makes sense, but this ordering also helps to avoid bug in Doxygen 1.8.6+ which merges next non-xrefitem section with the previous one (so e.g. the TODO list contained the following @see block, which is not desired).
12 years ago
* @deprecated_gl Included for compatibility reasons only, use
Cleaned up old Doxygen workarounds.
11 years ago
* @ref TextureFormat::R8 instead.
Added ES2-only support for GL_LUMINANCE{,_ALPHA}. It is deprecated, but many ES2 implementations don't support EXT_texture_rg, thus this is the only way to have single- and two-component textures without wasting precious memory. The enum value isn't exposed on desktop OpenGL and ES3. GL_ALPHA is not supported, as it doesn't bring any new functionality (it is also single-component and thus can be interchanged with GL_LUMINANCE).
13 years ago
*/
Luminance = GL_LUMINANCE,
/**
* Floating-point luminance and alpha channel. First value is used for all
* RGB channels, second value is used for alpha channel. Size
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* implementation-dependent. Not allowed in unemulated
* @ref Texture::setStorage() "*Texture::setStorage()" calls.
doc: rename \requires_gles20 to \requires_gles20_only. So it's clearer it doesn't mean "GLES 2.0 and everything above", like all other \requires_foo commands.
5 years ago
* @requires_gles20_only Not available in OpenGL ES 3.0, WebGL 2.0 or
* desktop OpenGL. Use @ref TextureFormat::RG8 instead.
doc: strict ordering of sections in detailed documentation. It makes sense, but this ordering also helps to avoid bug in Doxygen 1.8.6+ which merges next non-xrefitem section with the previous one (so e.g. the TODO list contained the following @see block, which is not desired).
12 years ago
* @deprecated_gl Included for compatibility reasons only, use
Cleaned up old Doxygen workarounds.
11 years ago
* @ref TextureFormat::RG8 instead.
Added ES2-only support for GL_LUMINANCE{,_ALPHA}. It is deprecated, but many ES2 implementations don't support EXT_texture_rg, thus this is the only way to have single- and two-component textures without wasting precious memory. The enum value isn't exposed on desktop OpenGL and ES3. GL_ALPHA is not supported, as it doesn't bring any new functionality (it is also single-component and thus can be interchanged with GL_LUMINANCE).
13 years ago
*/
LuminanceAlpha = GL_LUMINANCE_ALPHA,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
Added ES2-only support for GL_LUMINANCE{,_ALPHA}. It is deprecated, but many ES2 implementations don't support EXT_texture_rg, thus this is the only way to have single- and two-component textures without wasting precious memory. The enum value isn't exposed on desktop OpenGL and ES3. GL_ALPHA is not supported, as it doesn't bring any new functionality (it is also single-component and thus can be interchanged with GL_LUMINANCE).
13 years ago
#ifndef MAGNUM_TARGET_GLES
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
/**
* RGB, normalized unsigned, red and green component 3bit, blue 2bit.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Packed 8bit types are not available in OpenGL ES or WebGL.
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
*/
GL: TextureFormat::R3B3G2 had a typo in the name. Use R3G3B2 instead. The íold name is preserved for compatibility, but marked as deprecated and scheduled for removal in a future release.
7 years ago
R3G3B2 = GL_R3_G3_B2,
#ifdef MAGNUM_BUILD_DEPRECATED
/** RGB, normalized unsigned, red and green component 3bit, blue 2bit.
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
* @m_deprecated_since{2019,10} This one had a misleading typo in the name,
* use @ref TextureFormat::R3G3B2 instead.
GL: TextureFormat::R3B3G2 had a typo in the name. Use R3G3B2 instead. The íold name is preserved for compatibility, but marked as deprecated and scheduled for removal in a future release.
7 years ago
*/
R3B3G2 CORRADE_DEPRECATED_ENUM("use R3G3B2 instead") = R3G3B2,
#endif
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGB, each component normalized unsigned 4bit.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Packed 12bit types are not available in OpenGL ES or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB4 = GL_RGB4,
/**
* RGB, each component normalized unsigned 5bit.
Cleaned up old Doxygen workarounds.
11 years ago
* @requires_gl Use @ref TextureFormat::RGB5A1 or @ref TextureFormat::RGB565
First-class WebGL support, part 7: reduced color formats.
11 years ago
* in OpenGL ES or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB5 = GL_RGB5,
#endif
/**
* RGB, normalized unsigned, red and blue component 5bit, green 6bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,required_internalformat}
* (for image specification) or @gl_extension{EXT,texture_storage}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* (for texture storage) in OpenGL ES 2.0.
* @requires_webgl20 Not available in WebGL 1.0, see @ref TextureFormat::RGB
* for an alternative.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB565 = GL_RGB565,
Try to not use MAGNUM_TARGET_GLES3. It's confusing and should be removed (what if we have ES4?).
11 years ago
#if !defined(MAGNUM_TARGET_GLES) || (defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGB, each component normalized unsigned 10bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_es_extension Extension @gl_extension{EXT,texture_type_2_10_10_10_REV}
* and either @gl_extension{OES,required_internalformat} (for image
* specification) or @gl_extension{EXT,texture_storage} (for texture
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* storage) in OpenGL ES 2.0. Included for compatibility reasons only,
Cleaned up old Doxygen workarounds.
11 years ago
* use @ref TextureFormat::RGB10A2 in OpenGL ES 3.0 instead.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gles Not available in WebGL, use @ref TextureFormat::RGB10A2
* instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES
RGB10 = GL_RGB10,
#else
RGB10 = GL_RGB10_EXT,
#endif
Disable TextureFormat::RGB10 for ES3. It was defined in OES_required_internalformat which I don't want to support in ES3+.
12 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#ifndef MAGNUM_TARGET_GLES
/**
* RGB, each component normalized unsigned 12bit.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Packed 36bit types are not available in OpenGL ES or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB12 = GL_RGB12,
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
#ifndef MAGNUM_TARGET_GLES2
/**
* RGB, float, red and green component 11bit, blue 10bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,packed_float}
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
GL: fix EXT_color_buffer_half_float to be presennt also in WebGL 2. It was mistakenly thought to be replaced by the EXT_color_buffer_float (which replaces WEBGL_color_buffer_float and in addition lists both 16- and 32-bit float variants). But since there are still those stupid patents for rendering to 32-bit float attachments, certain hardware supports only rendering to 16-bit and not 32-bit, so the "superset" extension isn't enough to be able to discover which hardware can render to half-floats. Also updated (hopefully all) docs to list this extension as being an option on WebGL 2 as well.
4 years ago
* @requires_webgl_extension Extension
* @webgl_extension{EXT,color_buffer_float} to use as a render target
* in WebGL 2.0.
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
*/
R11FG11FB10F = GL_R11F_G11F_B10F,
/**
* RGB, unsigned with exponent, each RGB component 9bit, exponent 5bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_shared_exponent}
Cleaned up old Doxygen workarounds.
11 years ago
* @requires_gles30 Use @ref TextureFormat::RGB in OpenGL ES 2.0 instead.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Use @ref TextureFormat::RGB in WebGL 1.0 instead.
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
*/
RGB9E5 = GL_RGB9_E5,
#endif
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGBA, normalized unsigned, each component 2bit.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Packed 8bit types are not available in OpenGL ES or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA2 = GL_RGBA2,
#endif
/**
* RGBA, normalized unsigned, each component 4bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,required_internalformat}
* (for image specification) or @gl_extension{EXT,texture_storage}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* (for texture storage) in OpenGL ES 2.0. Use @ref TextureFormat::RGBA
* otherwise.
* @requires_webgl20 Not available in WebGL 1.0, use @ref TextureFormat::RGBA
* instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA4 = GL_RGBA4,
/**
* RGBA, normalized unsigned, each RGB component 5bit, alpha 1bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,required_internalformat}
* (for image specification) or @gl_extension{EXT,texture_storage}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* (for texture storage) in OpenGL ES 2.0. Use @ref TextureFormat::RGBA
* otherwise.
* @requires_webgl20 Not available in WebGL 1.0, use @ref TextureFormat::RGBA
* instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB5A1 = GL_RGB5_A1,
First-class WebGL support, part 7: reduced color formats.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
* RGBA, normalized unsigned, each RGB component 10bit, alpha 2bit.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{EXT,texture_type_2_10_10_10_REV}
* and either @gl_extension{OES,required_internalformat} (for image
* specification) or @gl_extension{EXT,texture_storage} (for texture
First-class WebGL support, part 7: reduced color formats.
11 years ago
* storage) in OpenGL ES 2.0.
* @requires_webgl20 Not available in WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
RGB10A2 = GL_RGB10_A2,
#else
RGB10A2 = GL_RGB10_A2_EXT,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#ifndef MAGNUM_TARGET_GLES2
/**
* RGBA, non-normalized unsigned, each RGB component 10bit, alpha 2bit.
Split the OpenGL layer out, pt 12: generic sampler state. The Sampler class was split into GL::Sampler (which is now mostly just a placeholder for implementing OpenGL sampler objects), pairs of generic / GL-specific SamplerFormat / GL::SamplerFormat, SamplerMipmap / GL::SamplerMipmap, SamplerWrapping / GL::SamplerWrapping enums and the GL-specific GL::SamplerCompareMode, GL::SamplerCompareFunction, GL::SamplerDepthStencilMode enums. The old Sampler class is marked as deprecated and aliases its enum to the generic enums (or to the GL-specific ones in case the generic versions are not available).
8 years ago
* Can't be filtered using @ref SamplerFilter::Linear.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl33 Extension @gl_extension{ARB,texture_rgb10_a2ui}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only normalized integral formats are available in
* OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only normalized integral formats are available in
* WebGL 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGB10A2UI = GL_RGB10_A2UI,
#endif
#ifndef MAGNUM_TARGET_GLES
/**
* RGBA, each component normalized unsigned 12bit.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Packed 48bit types are not available in OpenGL ES or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
RGBA12 = GL_RGBA12,
#endif
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
#if defined(DOXYGEN_GENERATING_OUTPUT) || (defined(MAGNUM_TARGET_GLES) && !defined(MAGNUM_TARGET_WEBGL))
/**
* BGRA, type/size implementation-dependent. Not allowed in unemulated
* @ref Texture::setStorage() "*Texture::setStorage()" calls, in that case
* use @ref TextureFormat::RGBA8 "TextureFormat::RGBA8" instead.
* @deprecated_gl Prefer to use the exactly specified version of this
* format, e.g. @ref TextureFormat::BGRA8.
* @requires_gles Not available on desktop OpenGL -- there it's perfectly
* legal to use @ref TextureFormat::RGBA in combination with
* @ref PixelFormat::BGRA.
* @requires_es_extension Extension @gl_extension{APPLE,texture_format_BGRA8888}
* or @gl_extension{EXT,texture_format_BGRA8888}
* @requires_gles Only RGBA component ordering is available in WebGL.
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
* @m_since{2019,10}
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
*/
BGRA = GL_BGRA_EXT,
/**
* BGRA, each component normalized unsigned byte.
* @requires_gles Not available on desktop OpenGL -- there it's perfectly
* legal to use @ref TextureFormat::RGBA8 in combination with
* @ref PixelFormat::BGRA.
* @requires_es_extension Extension @gl_extension{APPLE,texture_format_BGRA8888}. There are no signed
* normalized, integral or floating-point types with BGRA ordering.
* @requires_gles Only RGBA component ordering is available in WebGL.
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
* @m_since{2019,10}
GL: add ES-only TextureFormat::BGRA[8]. And clarify their purpose. This was an accidental ommision, as there's no need for such a thing on desktop.
7 years ago
*/
BGRA8 = GL_BGRA8_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#ifndef MAGNUM_TARGET_GLES
/**
Compressed formats are not available for multisample textures.
12 years ago
* Compressed red channel, normalized unsigned. **Not available on
* multisample textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Generic texture compression is not available in OpenGL ES
* or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
CompressedRed = GL_COMPRESSED_RED,
/**
Compressed formats are not available for multisample textures.
12 years ago
* Compressed red and green channel, normalized unsigned. **Not available
* on multisample textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,texture_rg}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Generic texture compression is not available in OpenGL ES
* or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
CompressedRG = GL_COMPRESSED_RG,
/**
Compressed formats are not available for multisample textures.
12 years ago
* Compressed RGB, normalized unsigned. **Not available on multisample
* textures.**
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Generic texture compression is not available in OpenGL ES
* or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
CompressedRGB = GL_COMPRESSED_RGB,
/**
Compressed formats are not available for multisample textures.
12 years ago
* Compressed RGBA, normalized unsigned. **Not available on multisample
* textures.**
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl Generic texture compression is not available in OpenGL ES
* or WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
CompressedRGBA = GL_COMPRESSED_RGBA,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#if !defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: add an important bit of tribal knowledge.
7 years ago
* RGTC compressed red channel, normalized unsigned. Equivalent to the old
* @def_gl{COMPRESSED_LUMINANCE_LATC1_EXT} from
* @gl_extension{EXT,texture_compression_latc}, only using the red channel
* instead of all three. **Available only on 2D, 2D array, cube map and
* cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_rgtc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_rgtc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Minor color/texture format fixes. Just fooling around. Also, I hate random four-letter abbreviations.
12 years ago
CompressedRedRgtc1 = GL_COMPRESSED_RED_RGTC1,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedRedRgtc1 = GL_COMPRESSED_RED_RGTC1_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: add an important bit of tribal knowledge.
7 years ago
* RGTC compressed red and green channel, normalized unsigned. Equivalent
* to the old @def_gl{COMPRESSED_LUMINANCE_ALPHA_LATC2_EXT} from
* @gl_extension{EXT,texture_compression_latc}, only using the red and
* green channel instead of all four. **Available only on 2D, 2D array,
* cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_rgtc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_rgtc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
CompressedRGRgtc2 = GL_COMPRESSED_RG_RGTC2,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedRGRgtc2 = GL_COMPRESSED_RED_GREEN_RGTC2_EXT, /*?!*/
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: add an important bit of tribal knowledge.
7 years ago
* RGTC compressed red channel, normalized signed. Equivalent to the old
* @def_gl{COMPRESSED_SIGNED_LUMINANCE_LATC1_EXT} from
* @gl_extension{EXT,texture_compression_latc}, only using the red channel
* instead of all three. **Available only on 2D, 2D array, cube map and
* cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_rgtc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_rgtc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
CompressedSignedRedRgtc1 = GL_COMPRESSED_SIGNED_RED_RGTC1,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedSignedRedRgtc1 = GL_COMPRESSED_SIGNED_RED_RGTC1_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
GL: add an important bit of tribal knowledge.
7 years ago
* RGTC compressed red and green channel, normalized signed. Equivalent
* to the old @def_gl{COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2_EXT} from
* @gl_extension{EXT,texture_compression_latc}, only using the red and
* green channel instead of all four. **Available only on 2D, 2D array,
* cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_rgtc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_rgtc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
CompressedSignedRGRgtc2 = GL_COMPRESSED_SIGNED_RG_RGTC2,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedSignedRGRgtc2 = GL_COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT, /*?!*/
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Compressed image support, part 4: updated format documentation.
11 years ago
* BPTC compressed RGB, unsigned float. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl42 Extension @gl_extension{ARB,texture_compression_bptc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_bptc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_bptc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedRGBBptcUnsignedFloat = GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedRGBBptcUnsignedFloat = GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* BPTC compressed RGB, signed float. **Available only on 2D, 3D, 2D array,
* cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl42 Extension @gl_extension{ARB,texture_compression_bptc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_bptc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_bptc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedRGBBptcSignedFloat = GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedRGBBptcSignedFloat = GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Compressed image support, part 4: updated format documentation.
11 years ago
* BPTC compressed RGBA, normalized unsigned. **Available only on 2D, 3D,
* 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl42 Extension @gl_extension{ARB,texture_compression_bptc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_bptc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_bptc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedRGBABptcUnorm = GL_COMPRESSED_RGBA_BPTC_UNORM,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedRGBABptcUnorm = GL_COMPRESSED_RGBA_BPTC_UNORM_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Compressed image support, part 4: updated format documentation.
11 years ago
* BPTC compressed sRGBA, normalized unsigned. **Available only on 2D, 3D,
* 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl42 Extension @gl_extension{ARB,texture_compression_bptc}
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
* @requires_es_extension OpenGL ES 3.0 and extension
* @gl_extension{EXT,texture_compression_bptc}
* @requires_webgl_extension Extension
* @webgl_extension{EXT,texture_compression_bptc}. Unlike the OpenGL
* ES variant, this extension doesn't require WebGL 2.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#ifndef MAGNUM_TARGET_GLES
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedSRGBAlphaBptcUnorm = GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM,
Added BC4, BC5, BC6H and BC7 compression formats. Those are now also available under WebGL 1/2 and OpenGL ES 3.O (strangely not OpenGL ES 2.0) under EXT_texture_compression_{rgtc,bptc}. The GL names are extra weird-ass now that all other APIs use the BC names.
7 years ago
#else
CompressedSRGBAlphaBptcUnorm = GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM_EXT,
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* ETC2 compressed RGB, normalized unsigned. **Available only on 2D, 2D
* array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedRGB8Etc2 = GL_COMPRESSED_RGB8_ETC2,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedRGB8Etc2 = 0x9274,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* ETC2 compressed sRGB, normalized unsigned. **Available only on 2D, 2D
* array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedSRGB8Etc2 = GL_COMPRESSED_SRGB8_ETC2,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedSRGB8Etc2 = 0x9275,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* ETC2 compressed RGB with punchthrough (single-bit) alpha, normalized
* unsigned. **Available only on 2D, 2D array, cube map and cube map array
* textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedRGB8PunchthroughAlpha1Etc2 = GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedRGB8PunchthroughAlpha1Etc2 = 0x9276,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* ETC2 compressed sRGB with punchthrough (single-bit) alpha, normalized
* unsigned. **Available only on 2D, 2D array, cube map and cube map array
* textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedSRGB8PunchthroughAlpha1Etc2 = GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedSRGB8PunchthroughAlpha1Etc2 = 0x9277,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* ETC2/EAC compressed RGBA, normalized unsigned. **Available only on 2D,
* 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedRGBA8Etc2Eac = GL_COMPRESSED_RGBA8_ETC2_EAC,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedRGBA8Etc2Eac = 0x9278,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* ETC2/EAC compressed sRGB with alpha, normalized unsigned. **Available
* only on 2D, 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedSRGB8Alpha8Etc2Eac = GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedSRGB8Alpha8Etc2Eac = 0x9279,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* EAC compressed red channel, normalized unsigned. **Available only on 2D,
* 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedR11Eac = GL_COMPRESSED_R11_EAC,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedR11Eac = 0x9270,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* EAC compressed red channel, normalized signed. **Available only on 2D,
* 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedSignedR11Eac = GL_COMPRESSED_SIGNED_R11_EAC,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedSignedR11Eac = 0x9271,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* EAC compressed red and green channel, normalized unsigned. **Available
* only on 2D, 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedRG11Eac = GL_COMPRESSED_RG11_EAC,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedRG11Eac = 0x9272,
#endif
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
/**
* EAC compressed red and green channel, normalized signed. **Available
* only on 2D, 2D array, cube map and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl43 Extension @gl_extension{ARB,ES3_compatibility}
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
* @requires_gles30 Extension @m_class{m-doc-external} [ANGLE_compressed_texture_etc](https://chromium.googlesource.com/angle/angle/+/master/extensions/ANGLE_compressed_texture_etc.txt)
* in OpenGL ES 2.0.
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_etc}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
*/
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#ifndef MAGNUM_TARGET_GLES2
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
CompressedSignedRG11Eac = GL_COMPRESSED_SIGNED_RG11_EAC,
GL: support {ANGLE,WEBGL}_compressed_texture_etc.
4 years ago
#else
/* ANGLE_compressed_texture_etc is not listed in gl_angle_ext.xml so we
have to hardcode; on ES3 (and thus WebGL 2) it's in the core header */
CompressedSignedRG11Eac = 0x9273,
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
#endif
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
/**
S3TC really is *not* supported on 3D textures.
11 years ago
* S3TC DXT1 compressed RGB. **Available only on 2D, 2D array, cube map and
* cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
GL: recognizing {EXT,ANGLE}_texture_compression_dxt{1,3,5} extensions. This makes it possible to test S3TC code paths on SwiftShader as well.
7 years ago
* or @gl_extension{EXT,texture_compression_dxt1}
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc},
* @gl_extension{EXT,texture_compression_dxt1} or
* @gl_extension2{ANGLE,texture_compression_dxt1,ANGLE_texture_compression_dxt}
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc}
*/
CompressedRGBS3tcDxt1 = GL_COMPRESSED_RGB_S3TC_DXT1_EXT,
Added sRGB variants of BC1/BC2/BC3 compression formats.
7 years ago
/**
* S3TC DXT1 compressed sRGB. **Available only for 2D, 2D array, cube map
* and cube map array textures.**
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc_srgb}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc_srgb}
*/
CompressedSRGBS3tcDxt1 = GL_COMPRESSED_SRGB_S3TC_DXT1_EXT,
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
/**
S3TC really is *not* supported on 3D textures.
11 years ago
* S3TC DXT1 compressed RGBA. **Available only on 2D, 2D array, cube map
* and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
GL: recognizing {EXT,ANGLE}_texture_compression_dxt{1,3,5} extensions. This makes it possible to test S3TC code paths on SwiftShader as well.
7 years ago
* or @gl_extension{EXT,texture_compression_dxt1}
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc},
* @gl_extension{EXT,texture_compression_dxt1} or
* @gl_extension2{ANGLE,texture_compression_dxt1,ANGLE_texture_compression_dxt}
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc}
*/
CompressedRGBAS3tcDxt1 = GL_COMPRESSED_RGBA_S3TC_DXT1_EXT,
Added sRGB variants of BC1/BC2/BC3 compression formats.
7 years ago
/**
* S3TC DXT1 compressed sRGB + linear alpha. **Available only for 2D, 2D
* array, cube map and cube map array textures.**
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc_srgb}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc_srgb}
*/
CompressedSRGBAlphaS3tcDxt1 = GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT,
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
/**
S3TC really is *not* supported on 3D textures.
11 years ago
* S3TC DXT3 compressed RGBA. **Available only on 2D, 2D array, cube map
* and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc}
GL: recognizing {EXT,ANGLE}_texture_compression_dxt{1,3,5} extensions. This makes it possible to test S3TC code paths on SwiftShader as well.
7 years ago
* or @gl_extension2{ANGLE,texture_compression_dxt3,ANGLE_texture_compression_dxt}
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc}
*/
CompressedRGBAS3tcDxt3 = GL_COMPRESSED_RGBA_S3TC_DXT3_EXT,
Added sRGB variants of BC1/BC2/BC3 compression formats.
7 years ago
/**
* S3TC DXT3 compressed sRGB + linear alpha. **Available only for 2D, 2D
* array, cube map and cube map array textures.**
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc_srgb}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc_srgb}
*/
CompressedSRGBAlphaS3tcDxt3 = GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT,
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
/**
S3TC really is *not* supported on 3D textures.
11 years ago
* S3TC DXT5 compressed RGBA. **Available only on 2D, 2D array, cube map
* and cube map array textures.**
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc}
GL: recognizing {EXT,ANGLE}_texture_compression_dxt{1,3,5} extensions. This makes it possible to test S3TC code paths on SwiftShader as well.
7 years ago
* or @gl_extension2{ANGLE,texture_compression_dxt5,ANGLE_texture_compression_dxt}
Compressed image support, part 5: added EXT_texture_compression_s3tc. And related WebGL extension. Why the hell do they need their own naming again?!
11 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc}
*/
CompressedRGBAS3tcDxt5 = GL_COMPRESSED_RGBA_S3TC_DXT5_EXT,
Added sRGB variants of BC1/BC2/BC3 compression formats.
7 years ago
/**
* S3TC DXT5 compressed sRGB + linear alpha. **Available only for 2D, 2D
* array, cube map and cube map array textures.**
* @requires_extension Extension @gl_extension{EXT,texture_compression_s3tc}
* @requires_es_extension Extension @gl_extension{EXT,texture_compression_s3tc_srgb}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_s3tc_srgb}
*/
CompressedSRGBAlphaS3tcDxt5 = GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT,
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 4x4 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc4x4 = GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc4x4 = GL_COMPRESSED_RGBA_ASTC_4x4,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 4x4 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc4x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc4x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 5x4 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc5x4 = GL_COMPRESSED_RGBA_ASTC_5x4_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc5x4 = GL_COMPRESSED_RGBA_ASTC_5x4,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 5x4 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc5x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc5x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 5x5 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc5x5 = GL_COMPRESSED_RGBA_ASTC_5x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc5x5 = GL_COMPRESSED_RGBA_ASTC_5x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 5x5 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc5x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc5x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 6x5 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc6x5 = GL_COMPRESSED_RGBA_ASTC_6x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc6x5 = GL_COMPRESSED_RGBA_ASTC_6x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 6x5 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc6x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc6x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 6x6 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc6x6 = GL_COMPRESSED_RGBA_ASTC_6x6_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc6x6 = GL_COMPRESSED_RGBA_ASTC_6x6,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 6x6 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc6x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc6x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 8x5 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc8x5 = GL_COMPRESSED_RGBA_ASTC_8x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc8x5 = GL_COMPRESSED_RGBA_ASTC_8x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 8x5 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc8x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc8x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 8x6 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc8x6 = GL_COMPRESSED_RGBA_ASTC_8x6_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc8x6 = GL_COMPRESSED_RGBA_ASTC_8x6,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 8x6 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc8x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc8x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 8x8 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc8x8 = GL_COMPRESSED_RGBA_ASTC_8x8_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc8x8 = GL_COMPRESSED_RGBA_ASTC_8x8,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 8x8 blocks. **Available only on 2D,
* 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc8x8 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc8x8 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 10x5 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc10x5 = GL_COMPRESSED_RGBA_ASTC_10x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc10x5 = GL_COMPRESSED_RGBA_ASTC_10x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 10x5 blocks. **Available only on
* 2D, 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc10x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc10x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 10x6 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc10x6 = GL_COMPRESSED_RGBA_ASTC_10x6_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc10x6 = GL_COMPRESSED_RGBA_ASTC_10x6,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 10x6 blocks. **Available only on
* 2D, 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc10x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc10x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 10x8 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc10x8 = GL_COMPRESSED_RGBA_ASTC_10x8_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc10x8 = GL_COMPRESSED_RGBA_ASTC_10x8,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 10x8 blocks. **Available only on
* 2D, 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc10x8 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc10x8 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 10x10 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc10x10 = GL_COMPRESSED_RGBA_ASTC_10x10_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc10x10 = GL_COMPRESSED_RGBA_ASTC_10x10,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 10x10 blocks. **Available only on
* 2D, 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc10x10 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc10x10 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 12x10 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc12x10 = GL_COMPRESSED_RGBA_ASTC_12x10_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc12x10 = GL_COMPRESSED_RGBA_ASTC_12x10,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 12x10 blocks. **Available only on
* 2D, 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc12x10 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc12x10 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed RGBA with 12x12 blocks. **Available only on 2D, 3D, 2D
* array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedRGBAAstc12x12 = GL_COMPRESSED_RGBA_ASTC_12x12_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedRGBAAstc12x12 = GL_COMPRESSED_RGBA_ASTC_12x12,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
/**
* ASTC compressed sRGB with alpha with 12x12 blocks. **Available only on
* 2D, 3D, 2D array, cube map and cube map array textures.**
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_extension Extension @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @gl_extension2{KHR,texture_compression_astc_ldr,KHR_texture_compression_astc_hdr}
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_sliced_3d}
* for 3D textures
GL: fixed broken links to extensions. These were originally working around some inconsistencies in the upstream naming, but that's fixed since.
7 years ago
* @requires_es_extension Extension @gl_extension{KHR,texture_compression_astc_hdr}
Compressed image support, part 11: support ASTC formats.
11 years ago
* for 3D textures and HDR profile
GL: recognize KHR_texture_compression_astc_sliced_3d.
7 years ago
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_astc},
* 2D and cube map textures only
Compressed image support, part 11: support ASTC formats.
11 years ago
*/
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2) || defined(MAGNUM_TARGET_WEBGL)
Compressed image support, part 11: support ASTC formats.
11 years ago
CompressedSRGB8Alpha8Astc12x12 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR,
GL: remove redundant defines to slim the GL headers a bit. What the hell, why does the ASTC HDR extension add *the exact same* defines as the LDR one.
7 years ago
#else
CompressedSRGB8Alpha8Astc12x12 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12,
#endif
Compressed image support, part 11: support ASTC formats.
11 years ago
ASTC: the pain never ends (3D formats). GL has an extension, but only for ES, not on desktop. Vulkan has nothing yet (due to there being just ARM that implements it, no other vendor), except those being listed in a KTX format specification.
7 years ago
#if defined(DOXYGEN_GENERATING_OUTPUT) || (defined(MAGNUM_TARGET_GLES) && !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL))
/**
* 3D ASTC compressed RGBA with 3x3x3 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc3x3x3 = GL_COMPRESSED_RGBA_ASTC_3x3x3_OES,
/**
* 3D ASTC compressed sRGB with alpha with 3x3x3 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc3x3x3 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_3x3x3_OES,
/**
* 3D ASTC compressed RGBA with 4x3x3 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc4x3x3 = GL_COMPRESSED_RGBA_ASTC_4x3x3_OES,
/**
* 3D ASTC compressed sRGB with alpha with 4x3x3 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc4x3x3 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x3x3_OES,
/**
* 3D ASTC compressed RGBA with 4x4x3 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc4x4x3 = GL_COMPRESSED_RGBA_ASTC_4x4x3_OES,
/**
* 3D ASTC compressed sRGB with alpha with 4x4x3 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc4x4x3 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4x3_OES,
/**
* 3D ASTC compressed RGBA with 4x4x4 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc4x4x4 = GL_COMPRESSED_RGBA_ASTC_4x4x4_OES,
/**
* 3D ASTC compressed sRGB with alpha with 4x4x4 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc4x4x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4x4_OES,
/**
* 3D ASTC compressed RGBA with 5x4x4 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc5x4x4 = GL_COMPRESSED_RGBA_ASTC_5x4x4_OES,
/**
* 3D ASTC compressed sRGB with alpha with 5x4x4 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc5x4x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4x4_OES,
/**
* 3D ASTC compressed RGBA with 5x5x4 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc5x5x4 = GL_COMPRESSED_RGBA_ASTC_5x5x4_OES,
/**
* 3D ASTC compressed sRGB with alpha with 5x5x4 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc5x5x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5x4_OES,
/**
* 3D ASTC compressed RGBA with 5x5x5 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc5x5x5 = GL_COMPRESSED_RGBA_ASTC_5x5x5_OES,
/**
* 3D ASTC compressed sRGB with alpha with 5x5x5 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc5x5x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5x5_OES,
/**
* 3D ASTC compressed RGBA with 6x5x5 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc6x5x5 = GL_COMPRESSED_RGBA_ASTC_6x5x5_OES,
/**
* 3D ASTC compressed sRGB with alpha with 6x5x5 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc6x5x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5x5_OES,
/**
* 3D ASTC compressed RGBA with 6x6x5 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc6x6x5 = GL_COMPRESSED_RGBA_ASTC_6x6x5_OES,
/**
* 3D ASTC compressed sRGB with alpha with 6x6x5 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc6x6x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6x5_OES,
/**
* 3D ASTC compressed RGBA with 6x6x6 blocks. **Available only on 3D
* textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedRGBAAstc6x6x6 = GL_COMPRESSED_RGBA_ASTC_6x6x6_OES,
/**
* 3D ASTC compressed sRGB with alpha with 6x6x6 blocks. **Available only
* on 3D textures.**
*
* @requires_gles30 Not defined on desktop OpenGL, WebGL or OpenGL ES 2.0.
* @requires_es_extension Extension @gl_extension{OES,texture_compression_astc}
*/
CompressedSRGB8Alpha8Astc6x6x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6x6_OES,
#endif
Support for PVRTC compressed pixel format.
7 years ago
#if defined(DOXYGEN_GENERATING_OUTPUT) || defined(MAGNUM_TARGET_GLES)
/**
* PVRTC compressed RGB, normalized unsigned byte with 2 bits per pixel.
* **Available only on 2D, 3D, 2D array, cube map and cube map array
* textures.**
* @requires_gles Not available on desktop OpenGL.
* @requires_es_extension Extension @gl_extension{IMG,texture_compression_pvrtc}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_pvrtc}
*/
CompressedRGBPvrtc2bppV1 = GL_COMPRESSED_RGB_PVRTC_2BPPV1_IMG,
#ifndef MAGNUM_TARGET_WEBGL
/**
* PVRTC compressed sRGB, normalized unsigned byte with 2 bits per pixel.
* **Available only on 2D, 3D, 2D array, cube map and cube map array
* textures.**
* @requires_gles Not available on desktop OpenGL or WebGL.
* @requires_es_extension Extension @gl_extension{EXT,pvrtc_sRGB}
*/
CompressedSRGBPvrtc2bppV1 = GL_COMPRESSED_SRGB_PVRTC_2BPPV1_EXT,
#endif
/**
* PVRTC compressed RGBA, normalized unsigned byte with 2 bits per pixel.
* **Available only on 2D, 3D, 2D array, cube map and cube map array
* textures.**
* @requires_gles Not available on desktop OpenGL.
* @requires_es_extension Extension @gl_extension{IMG,texture_compression_pvrtc}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_pvrtc}
*/
CompressedRGBAPvrtc2bppV1 = GL_COMPRESSED_RGBA_PVRTC_2BPPV1_IMG,
#ifndef MAGNUM_TARGET_WEBGL
/**
* PVRTC compressed sRGB + linear alpha, normalized unsigned byte with 2
* bits per pixel. **Available only on 2D, 3D, 2D array, cube map and cube
* map array textures.**
* @requires_gles Not available on desktop OpenGL or WebGL.
* @requires_es_extension Extension @gl_extension{EXT,pvrtc_sRGB}
*/
CompressedSRGBAlphaPvrtc2bppV1 = GL_COMPRESSED_SRGB_ALPHA_PVRTC_2BPPV1_EXT,
#endif
/**
* PVRTC compressed RGB, normalized unsigned byte with 4 bits per pixel.
* **Available only on 2D, 3D, 2D array, cube map and cube map array
* textures.**
* @requires_gles Not available on desktop OpenGL.
* @requires_es_extension Extension @gl_extension{IMG,texture_compression_pvrtc}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_pvrtc}
*/
CompressedRGBPvrtc4bppV1 = GL_COMPRESSED_RGB_PVRTC_4BPPV1_IMG,
#ifndef MAGNUM_TARGET_WEBGL
/**
* PVRTC compressed sRGB, normalized unsigned byte with 4 bits per pixel.
* **Available only on 2D, 3D, 2D array, cube map and cube map array
* textures.**
* @requires_gles Not available on desktop OpenGL or WebGL.
* @requires_es_extension Extension @gl_extension{EXT,pvrtc_sRGB}
*/
CompressedSRGBPvrtc4bppV1 = GL_COMPRESSED_SRGB_PVRTC_4BPPV1_EXT,
#endif
/**
* PVRTC compressed RGBA, normalized unsigned byte with 4 bits per pixel.
* **Available only on 2D, 3D, 2D array, cube map and cube map array
* textures.**
* @requires_gles Not available on desktop OpenGL.
* @requires_es_extension Extension @gl_extension{IMG,texture_compression_pvrtc}
* @requires_webgl_extension Extension @webgl_extension{WEBGL,compressed_texture_pvrtc}
*/
CompressedRGBAPvrtc4bppV1 = GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
#ifndef MAGNUM_TARGET_WEBGL
/**
* PVRTC compressed sRGB + linear alpha, normalized unsigned byte with 4
* bits per pixel. **Available only on 2D, 3D, 2D array, cube map and cube
* map array textures.**
* @requires_gles Not available on desktop OpenGL or WebGL.
* @requires_es_extension Extension @gl_extension{EXT,pvrtc_sRGB}
*/
CompressedSRGBAlphaPvrtc4bppV1 = GL_COMPRESSED_SRGB_ALPHA_PVRTC_4BPPV1_EXT,
#endif
/* PVRTC2 variants not listed as PVRTC is mainly on Apple hardware but
Metal doesn't support it and it doesn't have a WebGL equiv either. */
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Depth component, size implementation-dependent. Not supported in 3D
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* textures. Not allowed in unemulated @ref Texture::setStorage()
* "*Texture::setStorage()" calls, in that case use e.g.
* @ref TextureFormat::DepthComponent24 "TextureFormat::DepthComponent24" instead.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,depth_texture} or
* @gl_extension{ANGLE,depth_texture} in OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Extension @webgl_extension{WEBGL,depth_texture} in
* WebGL 1.0.
doc: strict ordering of sections in detailed documentation. It makes sense, but this ordering also helps to avoid bug in Doxygen 1.8.6+ which merges next non-xrefitem section with the previous one (so e.g. the TODO list contained the following @see block, which is not desired).
12 years ago
* @deprecated_gl Prefer to use the exactly specified version of this
Cleaned up old Doxygen workarounds.
11 years ago
* format, e.g. @ref TextureFormat::DepthComponent24.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
DepthComponent = GL_DEPTH_COMPONENT,
First-class WebGL support, part 7: reduced color formats.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Depth component, 16bit. Not supported in 3D textures.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,depth_texture} or
* @gl_extension{ANGLE,depth_texture} and either
* @gl_extension{OES,required_internalformat} (for image
* specification) or @gl_extension{EXT,texture_storage} (for texture
First-class WebGL support, part 7: reduced color formats.
11 years ago
* storage) in OpenGL ES 2.0. Use @ref TextureFormat::DepthComponent
* otherwise.
* @requires_webgl20 Not available in WebGL 1.0, use
* @ref TextureFormat::DepthComponent instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
DepthComponent16 = GL_DEPTH_COMPONENT16,
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Depth component, 24bit. Not supported in 3D textures.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,required_internalformat},
* @gl_extension{OES,depth_texture} and @gl_extension{OES,depth24} in
First-class WebGL support, part 7: reduced color formats.
11 years ago
* OpenGL ES 2.0. Use @ref TextureFormat::DepthComponent otherwise.
* @requires_webgl20 Not available in WebGL 1.0, use
* @ref TextureFormat::DepthComponent instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
DepthComponent24 = GL_DEPTH_COMPONENT24,
#else
DepthComponent24 = GL_DEPTH_COMPONENT24_OES,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
First-class WebGL support, part 7: reduced color formats.
11 years ago
#ifndef MAGNUM_TARGET_WEBGL
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Depth component, 32bit. Not supported in 3D textures.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_es_extension Extension @gl_extension{OES,depth_texture} or
* @gl_extension{ANGLE,depth_texture} and @gl_extension{OES,depth32}
* and @gl_extension{OES,required_internalformat} (for image
* specification) or @gl_extension{EXT,texture_storage} (for texture
First-class WebGL support, part 7: reduced color formats.
11 years ago
* storage) in OpenGL ES 2.0.
* @requires_gles Not available in WebGL.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
OpenGL ES 2.0 and 3.0 share the same extension list. Until recently (or maybe not too recently) ES3 extension header was "currently empty", now the extension header is shared with ES2. It's nice to finally get rid of all the weird ifndefs.
13 years ago
#ifndef MAGNUM_TARGET_GLES
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
DepthComponent32 = GL_DEPTH_COMPONENT32,
#else
DepthComponent32 = GL_DEPTH_COMPONENT32_OES,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#ifndef MAGNUM_TARGET_GLES2
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Depth component, 32bit float. Not supported in 3D textures.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,depth_buffer_float}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only integral depth textures are available in OpenGL ES
* 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only integral depth textures are available in WebGL
* 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
DepthComponent32F = GL_DEPTH_COMPONENT32F,
#endif
Implemented OES_texture_stencil8 AEP extension.
11 years ago
#ifndef MAGNUM_TARGET_WEBGL
Support for ARB_texture_stencil8.
13 years ago
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Stencil index, 8bit. Not supported in 3D textures.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl44 Extension @gl_extension{ARB,texture_stencil8}
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{OES,texture_stencil8}
Implemented OES_texture_stencil8 AEP extension.
11 years ago
* @requires_gles Only available as renderbuffer format in WebGL.
Support for ARB_texture_stencil8.
13 years ago
*/
StencilIndex8 = GL_STENCIL_INDEX8,
#endif
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* Depth and stencil component, size implementation-dependent. Not
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* supported in 3D textures. Not allowed in unemulated
* @ref Texture::setStorage() "*Texture::setStorage()" calls, in that case
* use e.g. @ref TextureFormat::Depth24Stencil8 "TextureFormat::Depth24Stencil8"
* instead.
Implementation of ARB_stencil_texturing.
12 years ago
* @see @ref Texture::setDepthStencilMode() "*Texture::setDepthStencilMode()"
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gles30 Extension @gl_extension{OES,packed_depth_stencil} or
* @gl_extension{ANGLE,depth_texture} in OpenGL ES 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Extension @webgl_extension{WEBGL,depth_texture} in
* WebGL 1.0.
doc: strict ordering of sections in detailed documentation. It makes sense, but this ordering also helps to avoid bug in Doxygen 1.8.6+ which merges next non-xrefitem section with the previous one (so e.g. the TODO list contained the following @see block, which is not desired).
12 years ago
* @deprecated_gl Prefer to use exactly specified version of this format,
Cleaned up old Doxygen workarounds.
11 years ago
* e.g. @ref TextureFormat::Depth24Stencil8.
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
*/
#ifndef MAGNUM_TARGET_GLES2
DepthStencil = GL_DEPTH_STENCIL,
#else
First-class WebGL support, part 7: reduced color formats.
11 years ago
/* Using OES version even though WebGL 1.0 *has* DEPTH_STENCIL constant,
because there are no such headers for it */
Reorganize TextureFormat enum a bit. Special RGB values together, RGBA values together, Depth values together, DepthStencil values together. Left sized internal formats in the same order, though.
13 years ago
DepthStencil = GL_DEPTH_STENCIL_OES,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* 24bit depth and 8bit stencil component. Not supported in 3D textures.
Implementation of ARB_stencil_texturing.
12 years ago
* @see @ref Texture::setDepthStencilMode() "*Texture::setDepthStencilMode()"
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,framebuffer_object}
* @requires_gles30 Extension @gl_extension{OES,packed_depth_stencil} or
* @gl_extension{ANGLE,depth_texture} and either
* @gl_extension{OES,required_internalformat} (for image
* specification) or @gl_extension{EXT,texture_storage} (for texture
First-class WebGL support, part 7: reduced color formats.
11 years ago
* storage) in OpenGL ES 2.0.
* @requires_webgl20 Use @ref TextureFormat::DepthStencil in WebGL 1.0
* instead.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
#ifdef MAGNUM_TARGET_GLES2
Depth24Stencil8 = GL_DEPTH24_STENCIL8_OES
#else
Depth24Stencil8 = GL_DEPTH24_STENCIL8,
#endif
First-class WebGL support, part 7: reduced color formats.
11 years ago
#endif
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#ifndef MAGNUM_TARGET_GLES2
/**
Documented internal formats unsupported in 3D textures.
13 years ago
* 32bit float depth component and 8bit stencil component. Not supported in
* 3D textures.
Implementation of ARB_stencil_texturing.
12 years ago
* @see @ref Texture::setDepthStencilMode() "*Texture::setDepthStencilMode()"
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @requires_gl30 Extension @gl_extension{ARB,depth_buffer_float}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
* @requires_gles30 Only integral depth textures are available in OpenGL ES
* 2.0.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Only integral depth textures are available in WebGL
* 1.0.
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
*/
Depth32FStencil8 = GL_DEPTH32F_STENCIL8
#endif
};
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
/**
@brief Check availability of a sized generic texture format
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
@m_since{2019,10}
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
Some OpenGL targets don't support sized texture formats at all (OpenGL ES 2.0
and WebGL 1.0), some targets miss some variants (for example OpenGL ES doesn't
have any 8-bit packed formats) Returns @cpp false @ce if current target can't
support such format, @cpp true @ce otherwise. Expects
@ref isPixelFormatImplementationSpecific() returns @cpp false @ce for given
@p format as OpenGL pixel format enum values usually can't be used to specify
internal texture format as well.
For OpenGL ES 2.0 (and WebGL 1.0) targets in particular the mapping is very
complex and instead of using this function it's recommend to do the mapping
manually based on whether @ref Texture::setImage() or
@ref Texture::setStorage() is used and whether @gl_extension{EXT,texture_storage}
and other format-specific extensions are supported.
@note Support of some formats depends on presence of a particular OpenGL
extension. Such check is outside of the scope of this function and you are
expected to verify extension availability before using such format.
@see @ref textureFormat(), @ref hasPixelFormat(),
@ref hasCompressedPixelFormat()
*/
MAGNUM_GL_EXPORT bool hasTextureFormat(Magnum::PixelFormat format);
/**
@brief Convert a generic pixel format to sized OpenGL texture format
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
@m_since{2019,10}
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
Not all sized texture formats may be available on all targets and this function
expects that given format is available on the target. See @ref hasTextureFormat()
for more information about checking availability of given format. Expects
@ref isPixelFormatImplementationSpecific() returns @cpp false @ce for given
@p format as OpenGL pixel format enum values usually can't be used to specify
internal texture format as well.
For OpenGL ES 2.0 (and WebGL 1.0) targets in particular the mapping is very
complex and instead of using this function it's recommend to do the mapping
manually based on whether @ref Texture::setImage() or
@ref Texture::setStorage() is used and whether @gl_extension{EXT,texture_storage}
and other format-specific extensions are supported.
@see @ref pixelType(), @ref compressedPixelFormat()
*/
MAGNUM_GL_EXPORT TextureFormat textureFormat(Magnum::PixelFormat format);
/**
@brief Check availability of a generic compressed texture format
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
@m_since{2019,10}
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
Some OpenGL targets don't support all generic pixel formats (for example PVRTC
compression might not be available on desktop OpenGL). Returns @cpp false @ce
if current target can't support such format, @cpp true @ce otherwise. Moreover,
returns @cpp true @ce also for all formats that are
@ref isCompressedPixelFormatImplementationSpecific(). The @p format value is
expected to be valid. This is different from
@ref hasTextureFormat(Magnum::PixelFormat), where the mapping of an
implementation-specific pixel format to an OpenGL texture format can't be
performed.
@note Support of some formats depends on presence of a particular OpenGL
extension. Such check is outside of the scope of this function and you are
expected to verify extension availability before using such format.
@see @ref textureFormat(), @ref hasCompressedPixelFormat(),
@ref hasPixelFormat()
*/
MAGNUM_GL_EXPORT bool hasTextureFormat(Magnum::CompressedPixelFormat format);
/**
@brief Convert generic compressed pixel format to OpenGL texture format
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
@m_since{2019,10}
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
In case @ref isCompressedPixelFormatImplementationSpecific() returns
@cpp false @ce for @p format, maps it to a corresponding OpenGL pixel format.
In case @ref isCompressedPixelFormatImplementationSpecific() returns
@cpp true @ce, assumes @p format stores OpenGL-specific pixel format and
returns @ref compressedPixelFormatUnwrap() cast to @ref GL::TextureFormat. This
is different from @ref textureFormat(Magnum::PixelFormat), where the mapping of
an implementation-specific pixel format to an OpenGL texture format can't be
performed.
Not all generic pixel formats may be available on all targets and this function
expects that given format is available on the target. Use @ref hasTextureFormat()
to query availability of given format.
@see @ref compressedPixelFormat(), @ref pixelFormat()
*/
MAGNUM_GL_EXPORT TextureFormat textureFormat(Magnum::CompressedPixelFormat format);
doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.
7 years ago
/**
@debugoperatorenum{TextureFormat}
@m_since{2019,10}
*/
GL: added hasTextureFormat() and textureFormat() helpers.
7 years ago
MAGNUM_GL_EXPORT Debug& operator<<(Debug& debug, TextureFormat value);
GL: removed deprecated aliases to GL functionality in the root namespace. Deprecated for 2018.04, it's been almost a year since. Whoever is using Magnum regularly updated already, and who not can always upgrade gradually (2018.02, 2018.04, 2018.10, 2019.01 etc.).
7 years ago
}}
Moved texture and image formats out of the classes. Advantages: * The enums were large (600-800 lines) and they polluted the header, now they are in separate files (except for BufferTexture, which has the enum small enough to be left in the same file). * Image classes now don't need to include OpenGL headers, as they were needed only for the enum values. With advantage of C++11's forward enum declarations there is no need to include the enum headers anywhere in implementation, only when particular values are needed. * The values are now less verbose: AbstractTexture::InternalFormat::RGB8 // before TextureFormat::RGB8 // now * Resolved another "trivial choice" problem (thanks @JanDupal for introducing this term to me): how to specify the format if there are ten ways to do it (some being massively confusing): Image2D::Format f = AbstractImage::Format::RGB; // too long... Image2D::Format f = Image3D::Format::RGBA; // why 3D? this works? Image2D::Format f = BufferImage1D::Format::RGBA; // wat? It is even worse (and more verbose) with textures: Texture2D::InternalFormat f = CubeMapTextureArray::InternalFormat::RGB8; // this is allowed? To have consistent naming this change was done also with BufferTexture::InternalFormat (now BufferTextureFormat), although there were no trivial choice issues and the enum isn't too large. But at least it is now less typing.
13 years ago
#endif