#Bumpy - mucking around with the BMP headers of yore

This repo maps out what I have found in my various dalliances with either BMP, or one of the other weird BMP-derivatives I've found (WLT, SHG, etc). It's extremely incomplete.

If you know of any corners in the BMP format or have any historical links, I'd love to hear about them.

#Usage

Make some bmps in different versions using imagemagick:

convert -type Palette /path/to/clippy.png BMP2:/tmp/clippy-bmpv2.bmp
convert -type Palette /path/to/clippy.png BMP3:/tmp/clippy-bmpv3.bmp
convert -type Palette /path/to/clippy.png BMP:/tmp/clippy-bmpv5.bmp

As a CLI:

$ go install go.shabbyrobe.org/bumpy/cmd/bumpy@latest

$ bumpy hdr /path/to/clippy-bmpv2.bmp
(bumpy.BitmapHeader) {
 FileHeader: (bumpy.FileHeader) {
  Kind: (bumpy.HeaderKind) BM,
  FileSize: (uint32) 31706,
  Reserved1: (uint16) 0,
  Reserved2: (uint16) 0,
  PixOffset: (uint32) 794
 },
 Header: (*bumpy.BitmapCore)(0xc0000b0050)({
  DIBSize: (bumpy.DIBSize) 12,
  Width: (int16) 181,
  Height: (int16) 168,
  ColorPlanes: (uint16) 1,
  BitsPerPixel: (uint16) 8
 })
}
(bumpy.Regions) {
 ColorTable: (bumpy.Region) {
  Start: (int64) 26,
  End: (int64) 794
 },
 Profile: (bumpy.Region) {
  Start: (int64) 0,
  End: (int64) 0
 },
 PixData: (bumpy.Region) {
  Start: (int64) 794,
  End: (int64) 31706
 }
}

#Links

• http://fileformats.archiveteam.org/wiki/BMP#Windows_BMP_v2_2
• https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wmf/
• https://github.com/jsummers/bmpsuite
• https://winprotocoldoc.blob.core.windows.net/productionwindowsarchives/MS-WMF/%5bMS-WMF%5d-210407.pdf
• https://web.archive.org/web/20110710100252/http://msdn.microsoft.com/en-us/library/dd371828(v=VS.85).aspx
• https://web.archive.org/web/20141224112131/http://netghost.narod.ru/gff/graphics/summary/micbmp.htm
• https://web.archive.org/web/20150111053239/http://msdn.microsoft.com/en-us/library/dd183388(v=vs.85).aspx
• https://web.archive.org/web/20150127132443/https://forums.adobe.com/message/3272950
• https://web.archive.org/web/20150503064056/https://msdn.microsoft.com/en-us/library/dd183377(v=VS.85).aspx
• https://web.archive.org/web/20150503064150/https://msdn.microsoft.com/en-us/library/dd371833(v=VS.85).aspx

#Expectation management

This is a tool I hack on for my own amusement in an ad-hoc fashion. No stability guarantees are made, the code is not guaranteed to work, and anything may be changed, renamed or removed at any time as I see fit.

If you wish to use any of this, I strongly recommend you copy-paste pieces as-needed (including tests and license/attribution) into your own project, or fork it for your own purposes.

Bug reports are welcome, feature requests discouraged, and code contributions will not be accepted.

#License

bumpy is Copyright Blake Williams code@shabbyrobe.org 2025. It is licensed under a 3-clause BSD license.