LoadBMP is a single-header C library for loading and saving BMP image files.
LoadBMP has no no dependencies besides the standard C libraries
stdlib.h, string.h and stdio.h.
LoadBMP uses raw buffers and support RGB (LOADBMP_RGB) and RGBA (LOADBMP_RGBA) formats.
The order is RGBRGBRGB... or RGBARGBARGBA..., from top left
to bottom right, without any padding.
The format ultimately only affects the size and layout of the pixel buffer.
Thereby when loading a BMP and selecting LOADBMP_RGBA, an alpha value of 255 is added.
When saving the BMP the knowledge of an alpha value is only used to be able
to skip it and properly index the colors.
unsigned char *pixels = NULL;
unsigned int width, height;
unsigned int err = loadbmp_decode_file("image.bmp", &pixels, &width, &height, LOADBMP_RGBA);
if (err)
printf("LoadBMP Load Error: %u\n", err);
// Remember to free the pixel data when it isn't needed anymore.
free(pixels);unsigned char *pixels = ...;
unsigned int width, height;
unsigned int err = loadbmp_encode_file("image.bmp", pixels, width, height, LOADBMP_RGBA);
if (err)
printf("LoadBMP Load Error: %u\n", err);Feel free to use the issue tracker, for reporting bugs, submitting patches or requesting features.
Before submitting bugs, make sure that you're using the latest version of LoadBMP.
Copyright (c) 2016 Christian Vallentin <[email protected]>
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not
be misrepresented as being the original software.
3. This notice may not be removed or altered from any source
distribution.