libcdhorizon

C library used to glitch images with the help of libgoimg and LuaJIT.

Driver program

A driver program is included to play around with the library. The build script compiles both the library and the driver program. You can obtain the driver program's usage (from the library's root path) with:

$ ./driver/cdhorizon

The possible output format strings are:

• farbfeld
• PNG
• JPEG

Dependencies

• libgoimg
• LuaJIT
• libjpeg (optional)
• libpng (optional)

Building

Building this project requires tup. Compile the library with:

$ ./make build

To change the compilation flags, create a tup.config file with the following content:

CONFIG_CC=...
CONFIG_CFLAGS=...
CONFIG_LDFLAGS=...

If you want libpng and/or libjpeg support on the driver program, creating this file with the appropriate CONFIG_LDFLAGS is required. If you're just building the library, you can ignore this step.

Lua API

Identifier	Arguments	Return	Description
horizon.getpixel	x, y	pixel	Returns a table with the RGB color components of the specified pixel.
horizon.setpixel	x, y, pixel	N/A	Takes an input table with the RGB components of the pixel to set.
horizon.width	N/A	width	Constant value of the width of the input image.
horizon.height	N/A	height	Constant value of the height of the input image.
horizon.params	N/A	params	Returns a dynamic table with user defined script param values.

Some examples can be found at glitchers/. The file glitchers/id.lua creates an exact replica of the input image, so it is a fine template for new scripts.