#pragma once #include enum class BmpReaderError : uint8_t { Ok = 0, FileInvalid, SeekStartFailed, NotBMP, DIBTooSmall, BadPlanes, UnsupportedBpp, UnsupportedCompression, BadDimensions, ImageTooLarge, PaletteTooLarge, SeekPixelDataFailed, BufferTooSmall, OomRowBuffer, ShortReadRow, }; class Bitmap { public: static const char* errorToString(BmpReaderError err); explicit Bitmap(FsFile& file) : file(file) {} ~Bitmap(); BmpReaderError parseHeaders(); BmpReaderError readRow(uint8_t* data, uint8_t* rowBuffer, int rowY) const; BmpReaderError rewindToData() const; int getWidth() const { return width; } int getHeight() const { return height; } bool isTopDown() const { return topDown; } bool hasGreyscale() const { return bpp > 1; } int getRowBytes() const { return rowBytes; } private: static uint16_t readLE16(FsFile& f); static uint32_t readLE32(FsFile& f); FsFile& file; int width = 0; int height = 0; bool topDown = false; uint32_t bfOffBits = 0; uint16_t bpp = 0; int rowBytes = 0; uint8_t paletteLum[256] = {}; // Floyd-Steinberg dithering state (mutable for const methods) mutable int16_t* errorCurRow = nullptr; mutable int16_t* errorNextRow = nullptr; mutable int lastRowY = -1; // Track row progression for error propagation };