C++复刻维基百科2×2 BMP示例文件无法打开求助

Hey there! It’s super frustrating when your hex matches the example but the file still won’t open—let’s break down the most likely culprits and fix this.

Common Pitfalls to Check #

1. You’re Writing in Text Mode (Not Binary) #

This is the #1 mistake when generating binary files in C++. By default, ofstream uses text mode, which automatically converts certain bytes (like 0x0A to Windows-style line endings 0x0D 0x0A) and corrupts your BMP’s binary structure.

Fix: Always open your file in binary mode:

ofstream bitmap("output.bmp", ios::binary);

2. Missing Row Padding #

BMP requires each pixel row to be padded to a multiple of 4 bytes. For your 2×2 24-bit BMP:

• Each pixel is 3 bytes (R, G, B), so 2 pixels = 6 bytes per row
• 6 isn’t divisible by 4, so you need 2 bytes of padding (all 0x00) at the end of each row
• Without this padding, the pixel data is misaligned, and image viewers can’t parse the file correctly.

3. Endianness Errors in Multi-Byte Header Fields #

BMP uses little-endian byte order for all multi-byte values (file size, width, height, etc.). Even if your individual bytes look right, if you’ve ordered them incorrectly (big-endian instead of little-endian), the header values will be garbage to image software.

For example, the total file size of the 2×2 example is 66 bytes (0x42). In the header, this should be stored as:

0x42, 0x00, 0x00, 0x00 // Little-endian: least significant byte first

Not the reverse (0x00, 0x00, 0x00, 0x42), which would represent a huge file size that viewers can’t handle.

4. Incomplete or Incorrect DIB Header #

You mentioned the 14-byte BM header, but BMP also requires a 40-byte DIB (Device-Independent Bitmap) header right after it. If this header is missing, or fields like bit depth (should be 24 for the example) or compression mode (0 for uncompressed) are wrong, viewers will reject the file.

Corrected Code Example #

Here’s a complete snippet that generates the valid 2×2 BMP from the example:

#include <iostream>
#include <fstream>
using namespace std;

int main() {
    // Open file in BINARY mode
    ofstream bitmap("2x2.bmp", ios::binary);
    if (!bitmap) {
        cerr << "Couldn't open file!" << endl;
        return 1;
    }

    // 14-byte BM Header
    unsigned char bm_header[14] = {
        0x42, 0x4D,         // Signature "BM"
        0x42, 0x00, 0x00, 0x00, // File size (66 bytes)
        0x00, 0x00,         // Reserved
        0x00, 0x00,         // Reserved
        0x36, 0x00, 0x00, 0x00  // Offset to pixel data (54 bytes)
    };

    // 40-byte DIB Header
    unsigned char dib_header[40] = {
        0x28, 0x00, 0x00, 0x00, // Header size (40 bytes)
        0x02, 0x00, 0x00, 0x00, // Width (2 pixels)
        0x02, 0x00, 0x00, 0x00, // Height (2 pixels, positive = bottom-up)
        0x01, 0x00,         // Planes (1)
        0x18, 0x00,         // Bit depth (24 bits)
        0x00, 0x00, 0x00, 0x00, // Compression (0 = none)
        0x10, 0x00, 0x00, 0x00, // Image size (16 bytes: 2 rows * (6 + 2) bytes)
        0x13, 0x0B, 0x00, 0x00, // XPelsPerMeter (72 DPI)
        0x13, 0x0B, 0x00, 0x00, // YPelsPerMeter (72 DPI)
        0x00, 0x00, 0x00, 0x00, // Colors used (0 = all)
        0x00, 0x00, 0x00, 0x00  // Important colors (0 = all)
    };

    // Pixel data + padding
    // Row 1 (bottom row in image): Blue, Green
    unsigned char row1[8] = {0x00, 0x00, 0xFF, 0x00, 0xFF, 0x00, 0x00, 0x00};
    // Row 2 (top row in image): Red, White
    unsigned char row2[8] = {0xFF, 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0x00, 0x00};

    // Write all components to file
    bitmap.write(reinterpret_cast<char*>(bm_header), 14);
    bitmap.write(reinterpret_cast<char*>(dib_header), 40);
    bitmap.write(reinterpret_cast<char*>(row1), 8);
    bitmap.write(reinterpret_cast<char*>(row2), 8);

    bitmap.close();
    cout << "2x2 BMP generated successfully!" << endl;
    return 0;
}

Final Checks #

• After running this code, open the file in a hex editor and compare it directly to the example to confirm alignment.
• Make sure you’re not accidentally modifying the byte arrays elsewhere in your code (e.g., overflowing buffers).

内容的提问来源于stack exchange，提问作者Jarom Allen