OpenGL Image (GLI) is a header only C++ image library for graphics software.
GLI provides classes and functions to load image files (KTX and DDS), facilitate graphics APIs texture creation, compare textures, access texture texels, sample textures, convert textures, generate mipmaps, etc.
This library works perfectly with OpenGL or Vulkan but it also ensures interoperability with other third party libraries and SDK. It is a good candidate for software rendering (raytracing / rasterisation), image processing, image based software testing or any development context that requires a simple and convenient image library.
GLI is written in C++11. It is a platform independent library with no dependence and it supports the following compilers:
- Apple Clang 5.0 and higher
- GCC 4.6 and higher
- Intel C++ Composer XE 2013 and higher
- LLVM 3.2 and higher
- Visual C++ 2010 and higher
- Any conform C++11 compiler
For more information about GLI, please have a look at the manual and the API reference documentation. The source code and the documentation are licensed under the Happy Bunny License (Modified MIT) or the MIT License.
Thanks for contributing to the project by submitting issues for bug reports and feature requests. Any feedback is welcome at [email protected].
#include <gli/gli.hpp>
GLuint CreateTexture(char const* Filename)
{
gli::texture Texture = gli::load(Filename);
if(Texture.empty())
return 0;
gli::gl GL(gli::gl::PROFILE_GL33);
gli::gl::format const Format = GL.translate(Texture.format(), Texture.swizzles());
GLenum Target = GL.translate(Texture.target());
assert(gli::is_compressed(Texture.format()) && Target == gli::TARGET_2D);
GLuint TextureName = 0;
glGenTextures(1, &TextureName);
glBindTexture(Target, TextureName);
glTexParameteri(Target, GL_TEXTURE_BASE_LEVEL, 0);
glTexParameteri(Target, GL_TEXTURE_MAX_LEVEL, static_cast<GLint>(Texture.levels() - 1));
glTexParameteriv(Target, GL_TEXTURE_SWIZZLE_RGBA, &Format.Swizzles[0]);
glTexStorage2D(Target, static_cast<GLint>(Texture.levels()), Format.Internal, Extent.x, Extent.y);
for(std::size_t Level = 0; Level < Texture.levels(); ++Level)
{
glm::tvec3<GLsizei> Extent(Texture.extent(Level));
glCompressedTexSubImage2D(
Target, static_cast<GLint>(Level), 0, 0, Extent.x, Extent.y,
Format.Internal, static_cast<GLsizei>(Texture.size(Level)), Texture.data(0, 0, Level));
}
return TextureName;
}
Lastest release
Project Health
Service | System | Compiler | Status |
---|---|---|---|
Travis CI | Linux 64 bits | Clang 3.4, Clang 3.8, GCC 4.9 | |
AppVeyor | Windows 32 and 64 | Visual Studio 2013 |
Release notes
GLI 0.8.3.0 - 2017-XX-XX
Features:
- Added decompression and sampling of DXT1, DXT3, DXT5, ATI1N and ATI2N #110 #119
- Added depth and stencil format queries #119
- Added texture_grad to samplers
Fixes:
- Fixed R8 SRGB #120
GLI 0.8.2.0 - 2016-11-13
Features:
- Extend flip() for S3TC compressed textures #94
- Added format property queries #102
Improvements:
- Fixed texture operator=
- Added initial manual
Fixes:
- Fixed ATI2N swizzle parameters #121
GLI 0.8.1.1 - 2016-09-11
Improvements:
- Updated GLM to 0.9.8.0 release
Fixes:
- Fixed KTX cube maps saving
- Fixed texture::clear build
GLI 0.8.1.0 - 2016-03-16
Features:
- Added texture copy, no allocation involved, only transfer
- Added sub-image copy
- Added non-member clear
- Added make_texture* helper functions
Improvements:
- Added compressed npot textures support #73
- Added image access cache to generic textures
- Added luminance alpha format translation to OpenGL 3.3+ through RG swizzling. #93
- Improved performance when sampling using mipmaps
- Improved nearest filter without border using texture_lod performance (~2.5x faster with texture2d)
- Improved texture::data() (~18x with cube array, ~68x with 2D)
- Improved texture::size() (~3.1x with cube array, ~3.9x with 2D)
- Improved simultanous texture::size() and texture::extent() calls (~2.1x with cube array, ~2.3x with 2D)
Fixes:
- Fixed DX10 DDS saving of 3D textures #91
- Fixed BGRX translation with PROFILE_GL33 profile #92
- Fixed DDS9 loading of 3D texture detected as 2D texture #93
GLI 0.8.0.0 - 2016-02-16
Features:
- Added texture swizzle support #79
- Added texture memory swizzle support
- Added texture conversion from any uncompressed format to any uncompressed format
- Added texture lod
- Added texture mipmaps generation for uncompressed formats
- Added support for load and store
- Added support for many new formats
- Added sampler 1D, 2D, 3D, array and cube map
- Added sampler texel fetch and texel write
- Added sampler clear
- Added transform algorithm to compute arithmetic between texels
- Added reduce algorithm to compare all texels within an image
Improvements:
- Reordered formats to match Vulkan formats
- Improved OpenGL translation with for multiple profiles: KTX, ES2.0, ES3.0, GL3.2 and GL3.3
- Improved Doxygen documentation
Fixes:
- Fixed PVRTC2 support
- Fixed luminance and alpha translation to OpenGL #56
- Fixed DXGI_FORMAT_B8G8R8X8_UNORM_SRGB support #59
- Fixed FORMAT_RGBA8_UNORM DDS loading using DDPF_RGBA mode #60
- Fixed handling of DDS DDPF_ALPHAPIXELS #68
- Fixed images, better matching names and formats #78 #81 #80
- Fixed BC4U and BC5U files generated from MS DDS loader #82
Work in progress:
- Added KMG container support and spec proposal
GLI 0.7.0.0 - 2015-09-01
- Added KTX loading and saving
- Added gli::load for generic file loading, either DDS or KTX files depending on filename extensions
- Added gli::save for generic file saving, either DDS or KTX files depending on filename extensions
- Added texture views using different texture format, including compressed texture formats
- Added fine granularity includes
- Improved API documentation
- Much faster texture comparisons is non optimal cases. (Measured ~21x faster on Intel IVB)
- Explicitly handling of texture targets: fixed various cases of cubemap and texture arrays failing to load with DDS
- Fixed GCC build
- Fixed warnings
- Fixed saved DDS header size on #52
GLI 0.6.1.1 - 2015-07-18
- Updated API documentation
- Fixed link error
GLI 0.6.1.0 - 2015-07-18
- Fixed interface inconsistencies
- Improved clear(), data() and size() performance using caching
- Removed internal dependence to std::fstream
- Added FORMAT_BGRX8_UNORM and FORMAT_BGRX8_SRGB support #48, #43
- Improved FORMAT_RGB8_UNORM loading
GLI 0.6.0.0 - 2015-06-28
- Large refactoring
- Added loading DDS from memory
- Added saving DDS to memory
- Improved DDS coverage for R, RG, RGB and RGBA formats
- Added DDS ASTC, PVRTC, ATC and ETC support
- Added DDS alpha, luminance and alpha luminance support
- Added PVRTC2, ETC2 and EAC formats
GLI 0.5.1.1 - 2014-01-20
- Fixed swizzled RGB channel when reading back a DDS
- Fixed getMask* link error
GLI 0.5.1.0 - 2014-01-18
- Added flip function
- Added level_count function
- Fixed interaction with std::map (#33)
- Added texelFetch and texelWrite functions
GLI 0.5.0.0 - 2013-11-24
- Essencially a rewrite of the library
- Added explicit copies
- Added single memory allocation per texture storage
- Added texture views
- Added texture copies
- Added comparison operators
- Added clear
GLI 0.4.1.0: 2013-03-10
- Added DDS saving
- Fixed GCC build
- Fixed XCode build
GLI 0.4.0.0: 2013-01-28
- Large API refactoring
- Performance improvements at loading: 50x in debug and 50% in release build
- Added texture2DArray
- Added textureCube and textureCubeArray
- Added texture3D
- Added texture1D and texture1DArray
- Improved DDS loading support
GLI 0.3.0.3: 2011-04-05
- Fixed bugs
GLI 0.3.0.2: 2011-02-08
- Fixed bugs
GLI 0.3.0.1: 2010-10-15
- Fixed bugs
GLI 0.3.0.0: 2010-10-01
- Added DDS10 load and store (BC1 - BC7)
- Added extension system
- Added automatic OpenGL texture object creation from file
GLI 0.2.2.0: 2010-09-07
- Added DDS exporter
GLI 0.2.1.1: 2010-05-12
- Fixed GCC build
GLI 0.2.1.0: 2010-02-15
- Added texelWrite function
- Fixed Visual Studio 2010 warnings
- Added readme.txt and copying.txt
GLI 0.2.0.0: 2010-01-10
- Updated API
- Removed Boost dependency
GLI 0.1.1.0: 2009-09-18
- Fixed DDS loader
- Added RGB8 to DDS loader
- Added component swizzle operation
- Added 32 bits integer components support
- Fixed texel fetch
GLI 0.1.0.0: 2009-03-28
- Added TGA loader
- Added DDS loader
- Added duplicate, crop, partial copy
- Added mipmaps generation.