gli

Other source code

GLI 0.8.2.0

Download

gli

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 6.0 and higher
GCC 4.7 and higher
Intel C++ Composer XE 2013 and higher
LLVM 3.4 and higher
Visual C++ 2013 and higher
Any 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 pull requests.

#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.9, Clang 7, Clang 9, Clang 10, GCC 4.8, GCC 7.4, GCC 9, GCC 10
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