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)

28.5" Canvas (EL285TW2)

The 28.5" Canvas uses a 4-bit format with panel color codes. The 3-bit format and the 0–5 palette indexes above do not apply to this model.

  • Resolution: always 2160 × 3060 (portrait), regardless of the device's rotation setting. For a landscape hang, rotate the image to portrait before packing.
  • Scan order: top to bottom, left to right within each row.
  • Packing: 4 bits per pixel, 2 pixels per byte. The high 4 bits are the left pixel, the low 4 bits are the right pixel. No header, no padding.
  • Data size: exactly (2160 × 3060) / 2 = 3,304,800 bytes. Data of any other length is discarded and the screen is not refreshed.

Color codes:

CodeColorCodeColor
0x1Black0x8Cyan
0x2White0x9Yellow-green
0x3Yellow0xATeal
0x4Red0xBDark blue
0x5Orange0xCLight blue
0x6Blue0xDPurple
0x7Green0xEPink

Code 0x0 leaves the pixel unchanged from the previous image.

Example: first byte for a row starting [White, Red, ...] = 0x24.

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!