Skip to content

C++ library that converts Qt supported images to OpenGL raw format.

License

Notifications You must be signed in to change notification settings

cginternals/glraw

Repository files navigation

glraw logo

glraw is an utility that converts Qt-supported images into an OpenGL-compatible raw format. glraw reduces the process of loading textures at run-time to a minimum: A file-content dump into GPU memory. glraw is a cross-platform library licenced under the MIT license.

The latest release is glraw-1.0.3.

Project Health (master)

Service System Compiler Targets Status
Jenkins Ubuntu 14.04 GCC 4.8 all Build Status
Jenkins Ubuntu 14.04 GCC 4.9 all Build Status
Jenkins Ubuntu 14.04 GCC 5.3 all Build Status
Jenkins Ubuntu 14.04 Clang 3.5 all Build Status
Jenkins OS X 10.10 Clang 3.5 - Build Status
Jenkins Windows 8.1 MSVC 2013 Update 5 all, install Build Status
Jenkins Windows 8.1 MSVC 2015 Update 1 all, install Build Status

Features

With glraw you can preconvert your texture assets and load them without the need of any image library. The generated raw files can easily be read. For this, glraw also provides a minimal Raw-File reader that you can either source-copy or integrate as C++ library into your project. Image to OpenGL texture conversion can be done either by glraws command line interface, e.g., within an existing tool-chain, or at run-time with glraw linked as asset library (requires linking Qt).

Using the command line interface to create, e.g., an uncompressed 8bit rgb-texture looks like this: >glraw-cmd -f GL_RGB -t GL_UNSIGNED_BYTE image.png

When converting an input image, glraw allows basic operations on the input-image and gives you full control over format and type of your targeted asset specification:

  • Output format and type: Choose either a format and a type (e.g., GL_RGB and GL_UNSIGNED_BYTE) or one of the supported compressed formats (e.g., GL_COMPRESSED_RGBA_S3TC_DXT3_EXT).

  • Mirroring: Mirror images horizontally or vertically.

  • Scaling: Scale your images either to a choosen size in pixels or by a factor.

  • Arbitrary image processing: Provide your own GLSL shader for, e.g., blurring, sharpening, color conversion, or data encoding.

  • Extensible file header: glraw supports two formats:

    • .raw as a true raw format, where all asset meta information is either encoded in the file name or aggreed with the importer.
    • .glraw, which extends the raw data by an arbitrary file header of binary key-value pairs (e.g., width, height, compression).

Further Reading

Status

build status (@hourly for master): status

Dependencies

The following dev-libraries and programs need to be provided for correct project configuration: