Image to Bitmap Converter

How to Use

• Select Display Resolution: Choose a preset resolution from the dropdown or select "custom" to enter width and height manually.
• Select Image: Click "Select an image file" and choose the image you want to convert.
• Adjust Brightness: Use the "Brightness Adjust" slider to change the overall brightness before dithering. Observe the "Converted Image" preview.
• Generate Code: Click the "Generate Arduino Code" button.
• Copy Code: The Arduino code (a byte array) will appear below. Click the icon to copy it to your clipboard.
• Use in Arduino: Paste the code into your Arduino sketch. Include it like any other PROGMEM data and use it with your display library (e.g., u8g2.drawXBMP()). See sample code below.

Optional:

• Dithering Method: Select threshold, Bayer, Floyd-Steinberg, or halftone method.
• Magnify: Click the icon below either image to see a larger, pixelated view. Click the background of the enlarged view to close it.
• Swap Bits: Check the "Swap bits (U8g2 LSB)" box if your display or U8g2 setup requires Least Significant Bit first byte order. Leave unchecked for standard Most Significant Bit first.
• Invert Colors: Check the "Invert Colors (W↔B)" box to make black pixels white and white pixels black in the final output data.

Sample Arduino Code (U8g2 Library)

This example shows how to use the generated bitmap with the popular U8g2 library.

#include <Arduino.h>
#include <U8g2lib.h>

#ifdef U8X8_HAVE_HW_SPI
#include <SPI.h>
#endif
#ifdef U8X8_HAVE_HW_I2C
#include <Wire.h>
#endif


// Include the generated bitmap header file
// Make sure this file is in the same directory as your .ino file,
// or provide the correct path.
#include "bitmap.h" // <-- RENAME THIS to match the generated code's filename suggestion

// Example for SSD1306 I2C display (replace with your display constructor)
U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE);

// OLED TEXT ROW number, vertical position
const byte ROW[5] = {0, 15, 31, 47, 63};

void setup(void) {
  Serial.begin(115200);
  u8g2.begin();
  Serial.println("u8g2 started");  
}

void loop(void) {
  u8g2.clearBuffer(); // clear the internal memory

  // Draw the bitmap at position (0, 0)
  // u8g2.drawXBMP(x_pos, y_pos, bitmap_width, bitmap_height, bitmap_data);
  // Use the width and height mentioned in the generated code comments.
  // NOTE: U8g2's drawXBMP expects MSB first data format.
  // If you checked "Swap bits (U8g2 LSB)", the generated data is LSB first.
  // U8g2 doesn't have a built-in function for LSB-first XBMP directly.
  // You might need a custom drawing function or ensure your U8g2 mode matches the data.
  // For standard usage with drawXBMP, leave "Swap bits" UNCHECKED.
  // The "Invert Colors" option affects the data itself, drawXBMP will draw it as is.
  u8g2.drawXBMP(0, 0, 128, 64, your_image_bitmap); // <-- Use the array name from generated code
  Serial.println("Code working!");
  u8g2.sendBuffer(); // transfer internal memory to the display
  delay(5000);
}
            

Note: U8g2's `drawXBMP` function typically expects MSB-first data. If you enable the "Swap bits (U8g2 LSB)" option, the generated data will be LSB-first. You would need a custom drawing routine or a specific U8g2 setup that expects LSB-first data to use it correctly. For standard `drawXBMP`, leave the swap option unchecked. The "Invert Colors" option modifies the bitmap data itself; `drawXBMP` will render the inverted image if the option was checked during generation.