The typical workflow for ImageConverter 565 v2.3 involves three stages:
#include #include // Include your converted image file header #include "my_converted_image.h" #define TFT_CS 10 #define TFT_DC 9 #define TFT_RST 8 Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_RST); void setup() tft.begin(); tft.setRotation(1); // Clear screen to black tft.fillScreen(ILI9341_BLACK); // Draw the RGB565 image array to the screen // Arguments: (x, y, width, height, data_array) tft.drawRGBBitmap(0, 0, (const uint16_t*)my_image_data, 320, 240); void loop() // Your main code here Use code with caution.
Because the images are already in raw format, the microcontroller does not need to decompress JPG or PNG files on the fly. It can read the data and send it directly to the display, enabling high-speed animations and fast screen refreshes. imageconverter 565 v2.3
| Metric | Source (24-bit BMP) | Raw RGB565 Output | RLE Compressed RGB565 (v2.3) | | :--- | :--- | :--- | :--- | | | 230,400 Bytes | 153,600 Bytes | ~48,000 Bytes (varies by complexity) | | RAM Requirement | High | Medium | Low (Streamed) | | Flash Utilization | N/A | 150 KB | ~47 KB | | Load Time (SPI) | N/A | 120ms | 85ms |
Once you have generated your .c or .h file, copy it into your microcontroller project directory. Below is a structural example of how the array looks and how it is called using a standard display library: The typical workflow for ImageConverter 565 v2
solves this bottleneck. Originally developed by Henning Karlsen as part of the widely used UTFT Library ecosystem , this specialized tool bypasses runtime decoding. It pre-converts standard images into raw, hardware-ready data arrays. What is RGB565 and Why is it Necessary?
: Ideal for loading larger images directly from an SD card to save space in your code. Set Target Platform | Metric | Source (24-bit BMP) | Raw
Converting 24-bit color to 16-bit color can sometimes cause "banding" artifacts in gradients. Version 2.3 utilizes optimized dithering algorithms to smooth out transitions, ensuring your converted graphics look as close to the original source as possible. 2. Multi-Format Output Support