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

1763 lines
81 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.
7 years ago
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019
Happy new year too.
12 years ago
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
*/
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"
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
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.
@see @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
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
#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
/**
* 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
/**
Documented texture formats disallowed in *Texture::setStorage().
13 years ago
* RGB, normalized unsigned, size implementation-dependent. Not allowed in
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* unemulated @ref Texture::setStorage() "*Texture::setStorage()" calls, in
* that case use @ref TextureFormat::RGB8 "TextureFormat::RGB8" instead.
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.
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
/**
* RGB, each 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_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
/**
Documented texture formats disallowed in *Texture::setStorage().
13 years ago
* RGBA, normalized unsigned, size implementation-dependent. Not allowed in
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* unemulated @ref Texture::setStorage() "*Texture::setStorage()" calls, in
* that case use @ref TextureFormat::RGBA8 "TextureFormat::RGBA8" instead.
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.
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
/**
* RGBA, each 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_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
#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
#ifndef MAGNUM_TARGET_GLES
/**
* 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}
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_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
R16 = GL_R16,
/**
* 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}
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_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
RG16 = GL_RG16,
/**
* RGB, each component normalized unsigned short.
* @requires_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
RGB16 = GL_RGB16,
/**
* RGBA, each component normalized unsigned short.
* @requires_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
RGBA16 = GL_RGBA16,
/**
* 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}
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_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
R16Snorm = GL_R16_SNORM,
/**
* 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}
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_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
RG16Snorm = GL_RG16_SNORM,
/**
* 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}
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_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
RGB16Snorm = GL_RGB16_SNORM,
/**
* 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}
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_gl Only byte-sized normalized formats are available in OpenGL
First-class WebGL support, part 7: reduced color formats.
11 years ago
* ES and 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
*/
RGBA16Snorm = GL_RGBA16_SNORM,
#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.
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
* @see @ref 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
* in combination with @ref PixelFormat::HalfFloat
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
* in combination with @ref PixelFormat::HalfFloat (@webgl_extension{OES,texture_half_float})
* 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.
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::R16UI
* or @ref TextureFormat::R16I 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::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.
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
* @see @ref 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
* in combination with @ref PixelFormat::HalfFloat
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
* in combination with @ref PixelFormat::HalfFloat (@webgl_extension{OES,texture_half_float})
* 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.
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::RG16UI
* or @ref TextureFormat::RG16I 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::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.
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
* @see @ref 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
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @ref PixelFormat::HalfFloat (@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
* @ref PixelFormat::HalfFloat (@webgl_extension{OES,texture_half_float})
* 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.
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
* in combination with @ref PixelFormat::HalfFloat
* (@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.
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
* @see @ref 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
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @ref PixelFormat::HalfFloat (@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
* @ref PixelFormat::HalfFloat (@webgl_extension{OES,texture_half_float})
* 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.
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::RGBA16UI
* or @ref TextureFormat::RGBA16I instead if not available. Use
* @ref TextureFormat::RGBA in combination with @ref PixelFormat::HalfFloat
* (@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
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* in combination with @ref PixelFormat::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
* in combination with @ref PixelFormat::Float (@webgl_extension{OES,texture_float})
* 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
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* in combination with @ref PixelFormat::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
* in combination with @ref PixelFormat::Float (@webgl_extension{OES,texture_float})
* 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
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @ref PixelFormat::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
* @ref PixelFormat::Float (@webgl_extension{OES,texture_float}) 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_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
* in combination with @ref PixelFormat::Float
* (@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
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
* @ref PixelFormat::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
* @ref PixelFormat::Float (@webgl_extension{OES,texture_float}) 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::RGBA32UI
* or @ref TextureFormat::RGBA32I instead if not available. Use
* @ref TextureFormat::RGBA in combination with @ref PixelFormat::Float
* (@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.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gles20 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.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gles20 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
*/
R3B3G2 = GL_R3_G3_B2,
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.
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
Don't expose EXT_sRGB on ES3/WebGL2 builds. It is superseded by core functionality. The only annoyance is that you need to use TextureFormat::SRGB in ES2 and TextureFormat::SRGB8 in ES3, but that's with many other formats anyway. Also apparently the unsized format is still allowed in core desktop GL, which is a shame.
11 years ago
#if !defined(MAGNUM_TARGET_GLES) || defined(MAGNUM_TARGET_GLES2)
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
/**
Enabled TextureFormat::R8 and RG8 on ES2, clarified the docs. There's much more to fix.
12 years ago
* 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.
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,sRGB} in OpenGL ES 2.0.
Don't expose EXT_sRGB on ES3/WebGL2 builds. It is superseded by core functionality. The only annoyance is that you need to use TextureFormat::SRGB in ES2 and TextureFormat::SRGB8 in ES3, but that's with many other formats anyway. Also apparently the unsized format is still allowed in core desktop GL, which is a shame.
11 years ago
* 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.
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, i.e. @ref TextureFormat::SRGB8.
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_GLES
SRGB = GL_SRGB,
#else
SRGB = GL_SRGB_EXT,
#endif
Don't expose EXT_sRGB on ES3/WebGL2 builds. It is superseded by core functionality. The only annoyance is that you need to use TextureFormat::SRGB in ES2 and TextureFormat::SRGB8 in ES3, but that's with many other formats anyway. Also apparently the unsized format is still allowed in core desktop GL, which is a shame.
11 years ago
#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
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
#if !(defined(MAGNUM_TARGET_WEBGL) && defined(MAGNUM_TARGET_GLES2))
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
/**
* sRGB, each 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_gles30 Extension @gl_extension{EXT,sRGB} and
* @gl_extension{EXT,texture_storage}, only for
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
* @ref Texture::setStorage() "*Texture::setStorage()" calls,
* otherwise use @ref TextureFormat::SRGB in OpenGL ES 2.0 instead.
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::SRGB8Alpha8 instead.
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_webgl20 Use @ref TextureFormat::SRGB 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
*/
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
#ifndef MAGNUM_TARGET_GLES2
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
SRGB8 = GL_SRGB8,
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
#else
SRGB8 = 0x8C41, /* Not in any spec, but seems to work at least on NV */
#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
#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
Don't expose EXT_sRGB on ES3/WebGL2 builds. It is superseded by core functionality. The only annoyance is that you need to use TextureFormat::SRGB in ES2 and TextureFormat::SRGB8 in ES3, but that's with many other formats anyway. Also apparently the unsized format is still allowed in core desktop GL, which is a shame.
11 years ago
#if !defined(MAGNUM_TARGET_GLES) || 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
/**
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
* 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.
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,sRGB} in OpenGL ES
Don't expose EXT_sRGB on ES3/WebGL2 builds. It is superseded by core functionality. The only annoyance is that you need to use TextureFormat::SRGB in ES2 and TextureFormat::SRGB8 in ES3, but that's with many other formats anyway. Also apparently the unsized format is still allowed in core desktop GL, which is a shame.
11 years ago
* 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.
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, i.e. @ref TextureFormat::SRGB8Alpha8.
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
SRGBAlpha = GL_SRGB_ALPHA,
#else
SRGBAlpha = GL_SRGB_ALPHA_EXT,
#endif
Don't expose EXT_sRGB on ES3/WebGL2 builds. It is superseded by core functionality. The only annoyance is that you need to use TextureFormat::SRGB in ES2 and TextureFormat::SRGB8 in ES3, but that's with many other formats anyway. Also apparently the unsized format is still allowed in core desktop GL, which is a shame.
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
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 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
/**
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
* sRGB + linear alpha, each 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_gles30 Extension @gl_extension{EXT,sRGB} and
* @gl_extension{EXT,texture_storage}, only for
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
* @ref Texture::setStorage() "*Texture::setStorage()" calls,
* otherwise use @ref TextureFormat::SRGBAlpha in OpenGL ES 2.0
First-class WebGL support, part 7: reduced color formats.
11 years ago
* instead.
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
* @requires_webgl20 Use @ref TextureFormat::SRGBAlpha 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
*/
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 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
SRGB8Alpha8 = GL_SRGB8_ALPHA8,
Fix the ability to create sRGB textures on ES2/WebGL1. Since 98a676ef653fc956b375712bc7765e622a6dd2e9, on ES2 and WebGL1 the Texture::setStorage() emulation passes the pixel format to both <format> and <internalFormat> of glTexImage() APIs. On desktop the go-to way to create a sRGB texture is by passing GL_SRGB to <internalFormat> and GL_RGB to <format>, but here GL_RGB was passed to both and thus the information about sRGB was lost. With the new PixelFormat::SRGB and PixelFormat::SRGBAlpha enums that are present only on ES2/WebGL1 this case is fixed -- sRGB texture format will get translated to sRGB pixel format and that used for both <format> and <internalFormat>. Another case is when EXT_texture_storage is available -- passing unsized GL_SRGB_EXT or GL_SRGB_ALPHA_EXT to glTexStorageEXT() is an error and there's apparently no mention of this in any extension, making it impossible to create sRGB textures using EXT_texture_storage. I bit the bullet and tried passing the (numerical value of) GL_SRGB8 and GL_SRGB8_ALPHA8 to it. At least on my NV it worked, so I enabled these two in TextureFormat for ES2. No EXT_texture_storage is on WebGL1, so they are only on ES2. These two sized TextureFormat::SRGB8 and TextureFormat::SRGB8Alpha8 formats are translated to GL_SRGB and GL_SRGB_ALPHA and so using them unconditionally for all platforms (except WebGL1) "just works".
9 years ago
#else
SRGB8Alpha8 = GL_SRGB8_ALPHA8_EXT, /* Not in spec, works at least on NV */
#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
#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,
/**
Compressed image support, part 4: updated format documentation.
11 years ago
* RGTC 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_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
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
*/
Minor color/texture format fixes. Just fooling around. Also, I hate random four-letter abbreviations.
12 years ago
CompressedRedRgtc1 = GL_COMPRESSED_RED_RGTC1,
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
* RGTC 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_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl RGTC 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
*/
CompressedRGRgtc2 = GL_COMPRESSED_RG_RGTC2,
/**
Compressed image support, part 4: updated format documentation.
11 years ago
* RGTC 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_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl RGTC 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
*/
CompressedSignedRedRgtc1 = GL_COMPRESSED_SIGNED_RED_RGTC1,
/**
Compressed image support, part 4: updated format documentation.
11 years ago
* RGTC 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_gl30 Extension @gl_extension{EXT,texture_compression_rgtc}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl RGTC 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
*/
CompressedSignedRGRgtc2 = GL_COMPRESSED_SIGNED_RG_RGTC2,
/**
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}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl BPTC 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
*/
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedRGBBptcUnsignedFloat = GL_COMPRESSED_RGB_BPTC_UNSIGNED_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
/**
Compressed image support, part 4: updated format documentation.
11 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}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl BPTC 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
*/
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedRGBBptcSignedFloat = GL_COMPRESSED_RGB_BPTC_SIGNED_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
/**
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}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl BPTC 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
*/
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedRGBABptcUnorm = GL_COMPRESSED_RGBA_BPTC_UNORM,
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}
First-class WebGL support, part 7: reduced color formats.
11 years ago
* @requires_gl BPTC 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
*/
Remove obsolete glLoadGen-related workarounds.
13 years ago
CompressedSRGBAlphaBptcUnorm = GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM,
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
#ifndef MAGNUM_TARGET_GLES2
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedRGB8Etc2 = GL_COMPRESSED_RGB8_ETC2,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedSRGB8Etc2 = GL_COMPRESSED_SRGB8_ETC2,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedRGB8PunchthroughAlpha1Etc2 = GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedSRGB8PunchthroughAlpha1Etc2 = GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedRGBA8Etc2Eac = GL_COMPRESSED_RGBA8_ETC2_EAC,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedSRGB8Alpha8Etc2Eac = GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedR11Eac = GL_COMPRESSED_R11_EAC,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedSignedR11Eac = GL_COMPRESSED_SIGNED_R11_EAC,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedRG11Eac = GL_COMPRESSED_RG11_EAC,
/**
* 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}
Compressed image support, part 10: support ETC2/EAC formats.
11 years ago
* @requires_gles30 ETC2 texture compression is not available in OpenGL ES
* 2.0.
*/
CompressedSignedRG11Eac = GL_COMPRESSED_SIGNED_RG11_EAC,
#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: 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}
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,
/**
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: 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}
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,
/**
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}
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,
/**
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}
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,
Compressed image support, part 11: support ASTC formats.
11 years ago
#ifndef MAGNUM_TARGET_WEBGL
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc4x4 = GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc4x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc5x4 = GL_COMPRESSED_RGBA_ASTC_5x4_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc5x4 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc5x5 = GL_COMPRESSED_RGBA_ASTC_5x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc5x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc6x5 = GL_COMPRESSED_RGBA_ASTC_6x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc6x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc6x6 = GL_COMPRESSED_RGBA_ASTC_6x6_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc6x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc8x5 = GL_COMPRESSED_RGBA_ASTC_8x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc8x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc8x6 = GL_COMPRESSED_RGBA_ASTC_8x6_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc8x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc8x8 = GL_COMPRESSED_RGBA_ASTC_8x8_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc8x8 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc10x5 = GL_COMPRESSED_RGBA_ASTC_10x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc10x5 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc10x6 = GL_COMPRESSED_RGBA_ASTC_10x6_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc10x6 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc10x8 = GL_COMPRESSED_RGBA_ASTC_10x8_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc10x8 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc10x10 = GL_COMPRESSED_RGBA_ASTC_10x10_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc10x10 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc12x10 = GL_COMPRESSED_RGBA_ASTC_12x10_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc12x10 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedRGBAAstc12x12 = GL_COMPRESSED_RGBA_ASTC_12x12_KHR,
/**
* 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}
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}
* @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
* @requires_gles ASTC texture compression is not available in WebGL.
*/
CompressedSRGB8Alpha8Astc12x12 = GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR,
#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: 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