GFXprim is simple modular 2D bitmap graphics library with emphasis on speed and correctness. It comes batteries included, but free from bloat.

It includes:

One of the key points of the library are code generators. Most of the graphics operations are written using CCT templating engine which is used to create specialized C code. So, for an example, once you add pixel definition into configuration file, creating specialized filters, loaders and conversions to other pixel formats is just a matter of typing make rebuild.

The Core of the library contains a minimal amount of code to define interfaces that are shared between all parts of the library.

The most important part of the core is the gp_pixmap structure that represents an in-memory pixmap.

The Core also contains generated code for basic operations such as gp_get_pixel, gp_put_pixel and optimized functions for writing continous lines of pixels gp_write_pixels that are a base for the more complex drawing primitives in GFX or for the graphics operations in Filters.

Blits are functions used to copy part of one bitmap into another bitmap. The blits be also used for primitive bitmap pixel type conversions (i.e. RGB888 vs BGR888).

Progress Callback is an interface that allows you to monitor progress of an operation. It is mainly used in loaders and filters. Generally, any operation that is not very quick takes an optional pointer to a progress-callback that allows your program to monitor and possibly abort the operation.

The Debug interface is used as a unified facility to print debug messages, control debug level, etc.

There is also support for Gamma correction. Unfortunatelly not all parts of library use it at the moment.

And last but not least: Core is a home for some common macros that are used from different parts of the library.

Gfx is part of the library that implements basic graphics primitives such as lines, circles, polygons, etc. Classical primitives are nearly finished. Work on anti-aliased primitives has been started.

The Text part of the library implements basic support for printing text into a bitmap. There are two bitmap fonts compiled directly into the library and we support True Type fonts through FreeType (so far ASCII printable characters only).

Loaders are the part that is resposible for loading and saving images into various standard formats (PNG, JPEG, GIF, TIFF, BMP, PNM, etc…).

Filters are the part of the library that implements bitmap image filters.

Backends together with Input form an API for drawing on screen (or into a window) and for getting keystrokes/mouse coordinates. So far we support X11, the Linux framebuffer, SDL and AALib as graphics backends.

There is also a virtual backend used for testing. This allows you to create a backend of any pixel type on the top of other backends.

Python bindings currently cover most of the library, there is (work in progress) documentation for Core, Gfx, Loaders, Filters and Backends.