Upload Dithered Image Data

Uploads pre-processed, dithered raw image data for fast, direct-to-screen rendering. This is an advanced feature.

The data is stored in a dedicated directory (not in galleries). The device parses and refreshes the screen immediately upon upload. If uploaded during slideshow mode, the next slideshow cycle is postponed by 5 minutes (300s).

Resolution must match the screen's current physical resolution exactly, or the device will error.

  • e.g. EL073TF1 portrait (rotation 1 or 3): 480 x 800
  • e.g. EL073TF1 landscape (rotation 0 or 2): 800 x 480

Color palette (6 colors):

ColorIndexBinary (3-bit)
Black0000
White1001
Red2010
Green3011
Blue4100
Yellow5101

3-bit packing format: Each pixel is represented by 3 bits. Every 3 bytes (24 bits) encode 8 pixels. Pixels are scanned left-to-right, top-to-bottom. Their 3-bit values are concatenated into a continuous bit stream, then split into bytes.

Example: 9 pixels with colors [Red, Yellow, Green, White, Red, Black, White, White, ...]:

  • Bit stream: 010 101 011 001 010 000 001 001 ...
  • Byte 1: 01010101 = 0x55
  • Byte 2: 10010100 = 0x94
  • Byte 3: 00001001 = 0x09

Data size comparison (e.g. 13.3" screen 1200x1600):

  • Uncompressed (1 byte/pixel): 1,920,000 bytes (~1.92 MB)
  • 3-bit packed: (1200 × 1600 × 3) / 8 = 720,000 bytes (~703 KB)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

A unique name for the data file.

Body Params
file

The binary data of the dithered image.

Response
200

Dithered image data uploaded successfully.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!