Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
C++ library that converts Qt supported images to OpenGL raw format.
C++ CMake Other
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

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 current release is glraw-1.0.3.

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:

Something went wrong with that request. Please try again.