BMP implementation in C

C is one cool and important language. CPython and Unix are based on it, the Mars Curiosity rover is run by it and even the GCC C compiler itself is written in C. However, as C is some years old by now, it lacks a lot of higher-level features most modern languages possess, being more down to the silicon, as the cool kids say. Concepts like pointer manipulation, bit fiddling and its string implementation — just to name a few — are at times cumbersome, insecure and error-prone; nevertheless is there a certain appeal to writing in C.

Being only one abstraction level away from Assembly — which itself is only one abstraction level above raw byte code — and having access to file manipulation down to the individual bit, I set out to write a Microsoft Bitmap (.bmp) implementation in pure C. As Microsoft’s standard for this image file format is quite feature-rich, I decided to focus on the bar minimum — a bitmap with 24-bit color depth (three colors, one byte per), one color plane, no compression, no palette and 300 DPI.
My Bitmap implementation supports both reading and writing .bmp files, as well as generating some test images — including a Mandelbrot Set fractal renderer, of course. Implementation source code can be downloaded (bmp.c) or seen below.

Mandelbrot Set fractal
A Mandelbrot Set fractal rendering.

Implementing a file format requires knowing its specification. Although it is not the best article I have ever seen, this Wikipedia article gave me some insights. The missing pieces were reverse engineered using Adobe Photoshop CC and the HxD hex editor.
The following is a snippet of the implementation’s savebmp function (full source code listed below). It illustrates the Bitmap file’s byte layout only showing the file header, omitting a lengthy data part concatenated to the header. S, K, W, H and B are all byte arrays of length four (little-endian format) which contain the file’s total size, the bitmap data offset (which is constant, since the header is always exactly 54 bytes large), the image’s dimensions (horizontal and vertical) and the bitmap data’s section’s size, respectively.

/*  bitmap file header  */
0x42, 0x4D,             // BM
S[0], S[1], S[2], S[3], // file size
0x00, 0x00, 0x00, 0x00, // unused
K[0], K[1], K[2], K[3], // bitmap data offset
/*      DIB header      */
0x28, 0x00, 0x00, 0x00, // DIB size
W[0], W[1], W[2], W[3], // pixel width
H[0], H[1], H[2], H[3], // pixel height
0x01, 0x00,             // one color plane
0x18, 0x00,             // 24 bit color depth
0x00, 0x00, 0x00, 0x00, // no compression
B[0], B[1], B[2], B[3], // bitmap data size
0x23, 0x2E, 0x00, 0x00, // 300 DPI (horizontal)
0x23, 0x2E, 0x00, 0x00, // 300 DPI (vertical)
0x00, 0x00, 0x00, 0x00, // no palette
0x00, 0x00, 0x00, 0x00  // color importance
/*  data bytes follow   */

Key bytes to note are the first two identifying the file type (the ASCII-encoded letters BM) and the DPI bytes, 0x23, 0x2E, which indicate 0x00002E23 = 11811 pixels per meter in both the horizontal and vertical direction. Converting from pixels per meter to dots per inch results in 11811 / (1 meter / 1 inch) = 11811 * 127 / 5000 = 300 DPI (roughly).
Most values are represented using four bytes in little-endian format. Translating an 32-bit integer into four little-endian formatted bytes can be achieved as follows.

/* unsigned 32-bit integer */
unsigned int n = 0b10100100010000100000100000010000;
/*                 < m sig><sm sig><sl sig>< l sig> */

/* byte (unsigned char) array of size four */
unsigned char N[4] = {          
	(n & 0xff000000) >>  0, // most significant byte
	(n & 0x00ff0000) >>  8, // second most significant byte
	(n & 0x0000ff00) >> 16, // second least significant byte
	(n & 0x000000ff) >> 24  // least significant byte

Other than rendering a fractal, I also implemented three nested loops which output an image containing every possible color exactly once ((2**8)**3 = 16777216 pixels in total).

All sixteen million colors
All sixteen million colors in one image.

An image’s data type is implemented as a struct image which contains three variables — width and height, two integers specifying the image’s dimensions, and *px, a pointer to an one-dimensional integer array of size width*height which holds the entire image data.
Defined functions are listed ahead.

  • image * readbmp(char []);
    • Reads an image specified by a file name. If reading fails, a NULL pointer is returned.
  • void savebmp(image *, char []);
    • Saves given image to a file with specified name.
  • image * newimage (int, int);
    • Returns a pointer to an image struct with specified dimensions (image will be filled with nothing but black pixels).
  • void freeimage (image *);
    • Frees an image struct’s memory.
  • int getpx (image *, int, int);
    • Returns the pixel color at specified coordinates.
  • void setpx (image *, int, int, int);
    • Sets the pixel color at specified coordinates.
  • void fill (image *, int);
    • Fills a given image with a given color (all pixels are set to specified color).
  • int color(byte, byte, byte);
    • Returns a 32-bit integer representing a color specified by three bytes (byte is defined through typedef unsigned char byte;).
  • int hsl (double, double, double);
    • Returns a 32-bit integer representing a color specified by three doubles in the HSL color format.

Images shown in this post were converted to .png files as WordPress does not allow .bmp file uploads; the raw pixel data should, however, be identical.

/* ================================================== *
 *                GENERAL INFORMATION                 *
 * ================================================== *
 * Bitmap file format implementation in C.            *
 * Supported functionality: 24-bit color depth image  *
 *  struct, reading and writing .bmp files and simple *
 *  image manipulation.                               *
 * Supported color formats: RGB and HSL.              *
 * Additional functionality: Mandelbrot Set fractal   *
 *  rendering.                                        *
 *                                                    *
 * Author: Jonathan Frech                             *
 *                                                    *
 * Edit history: 23rd, 24th, 27th, 28th, 29th, 30th   *
 *  of June, 1st, 2nd, 3rd, 10th, 11th, 13th, 14th,   *
 *  15th, 16th, 17th, 18th, 19th, 20th, 25th, 26th,   *
 *  27th, 29th of July, 11th, 16th of August, 17th,   *
 *  18th, 19th of October 2017                        */
/* ================================================== *
 *                    COMPILATION                     *
 * ================================================== *
 * $ rm bmp; gcc bmp.c -lm -o bmp; ./bmp              */

Continue reading


FS Letters II

Improving my first version – FS Letters – I changed a core behavior. Instead of going thru the whole file system, saving it, interpreting it and then displaying it, I now went for a dynamic approach. As the filesystem gets checked (60 times per second), the screen is also updating. This makes for both a more efficient (no freeze!) and a much nicer program. If the program is done checking the file system, the text ‘done’ will appear in the screen’s caption.

The First Example The Second Example The Third Example

# Python 2.7.7 Code
# Pygame 1.9.1 (for Python 2.7.7)
# Jonathan Frech 18th of June, 2015

Continue reading

FS Letters

This program goes through all the filenames from every user (it is made for Macintosh), checks the filename and counts the individual letters. Those letters are then displayed on the screen, the most common ones big and bright and the least common ones dark and small. The letters will appear in a random order.

How to use

If you start the program, a black screen will appear. Press ‘space’ and the screen will get red and begin to fade. After the screen is faded out, it gets black and the program freezes (checks your whole filesystem). After this freeze the above mentioned happens (check images below).

The First ExampleThe Second ExampleThe Third Example

# Python 2.7.7 Code
# Pygame 1.9.1 (for Python 2.7.7)
# Jonathan Frech 9th of April, 2015

Continue reading