Gfxprim is simple modular 2D bitmap graphics library with emphasis on speed and correctness.

One of the key points of the library are code generators. Most of the graphics operations are written using Jinja 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.

Core of the library contains minimal amount of code to define interface that is shared between all parts of the library.

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

The Core also contains generated code for basic operations such as GP_GetPixel and GP_PutPixel and optimized functions for writing continous line of pixels GP_WritePixels that are base for the more complex drawing primitives in GFX or for 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 really quick takes optional pointer to progress callback that allows your program to monitor and possibly abort the operation.

Debug interface is used as 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. Clasicall primitives are nearly finished. Work on anti aliased primitives has been started.

Text part of the library implements basic support for printing text into the 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 part that is resposible for loading and saving images into various standard formats (PNG, JPEG, GIF, TIFF, BMP, PNM, etc…).

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

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

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

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