OLED display built-ins

The Zen OLED is 128 x 64 monochrome pixels. Valid coordinates are X 0..127 and Y 0..63. Draw only when a screen or value changes; repeated full-screen work in every VM cycle can make the script unresponsive.

cls_oled

Compiler category: Leds Backing opcode: clsOled

Fills the complete display with one color.

Syntax

cls_oled(color);

Parameters

• color: OLED_BLACK (0) or OLED_WHITE (1).

Returns

Nothing.

Example

init {
    cls_oled(OLED_BLACK);
}

---

pixel_oled

Compiler category: Console I/O Functions Backing opcode: pixelOled

Sets one pixel.

Syntax

pixel_oled(x, y, color);

Parameters

• x: 0..127.

• y: 0..63.

• color: OLED_BLACK or OLED_WHITE.

Returns

Nothing.

Example

int oled_dirty = TRUE;

main {
    if(oled_dirty) {
        cls_oled(OLED_BLACK);
        pixel_oled(64, 32, OLED_WHITE);
        oled_dirty = FALSE;
    }
}

---

line_oled

Compiler category: Console I/O Functions Backing opcode: lineOled

Draws a line between two points.

Syntax

line_oled(x, y, to_x, to_y, thickness, color);

Parameters

• x, to_x: 0..127.

• y, to_y: 0..63.

• thickness: 1..127.

• color: OLED_BLACK or OLED_WHITE.

Returns

Nothing.

Example

init {
    cls_oled(OLED_BLACK);
    line_oled(0, 63, 127, 0, 1, OLED_WHITE);
}

---

rect_oled

Compiler category: Console I/O Functions Backing opcode: rectOled

Draws a rectangle outline or a filled rectangle.

Syntax

rect_oled(x, y, width, height, fill, color);

Parameters

• x: 0..127.

• y: 0..63.

• width: 1..128.

• height: 1..64.

• fill: TRUE for filled or FALSE for outline.

• color: OLED_BLACK or OLED_WHITE.

Returns

Nothing.

Example

init {
    cls_oled(OLED_BLACK);
    rect_oled(4, 4, 120, 56, FALSE, OLED_WHITE);
}

Keep the full rectangle within the display: x + width <= 128 and y + height <= 64.

---

circle_oled

Compiler category: Console I/O Functions Backing opcode: circleOled

Draws a circle outline or a filled circle.

Syntax

circle_oled(x, y, radius, fill, color);

Parameters

• x: center X, 0..127.

• y: center Y, 0..63.

• radius: 1..63.

• fill: TRUE or FALSE.

• color: OLED_BLACK or OLED_WHITE.

Returns

Nothing.

Example

init {
    cls_oled(OLED_BLACK);
    circle_oled(64, 32, 18, TRUE, OLED_WHITE);
}

Choose a center and radius that do not push the intended drawing outside the screen.

---

putc_oled

Compiler category: Leds Backing opcode: putcOled

Writes one ASCII/glyph byte into the OLED text buffer. It does not draw until puts_oled is called.

Syntax

putc_oled(position, ascii_code);

Parameters

• position: buffer position 1..18 on the current 32-bit target.

• ascii_code: supported byte 32..136.

Returns

Nothing.

Example

init {
    putc_oled(1, ASCII_UPPER_H);
    putc_oled(2, ASCII_UPPER_I);
}

---

puts_oled

Compiler category: Leds Backing opcode: putsOled

Draws buffered characters using a built-in OLED font.

Syntax

puts_oled(x, y, font, length, color);

Parameters

• x: 0..127.

• y: 0..63.

• font: OLED_FONT_SMALL, OLED_FONT_MEDIUM, or OLED_FONT_LARGE.

• length: 1..18 on the current 32-bit target.

• color: OLED_BLACK or OLED_WHITE.

Returns

Nothing.

Example

init {
    cls_oled(OLED_BLACK);
    putc_oled(1, ASCII_UPPER_H);
    putc_oled(2, ASCII_UPPER_I);
    puts_oled(8, 8, OLED_FONT_MEDIUM, 2, OLED_WHITE);
}

The large font cannot render every special glyph. Compile and device-test the selected byte/font combination.

---

image_oled

Compiler category: Console I/O Functions Backing opcode: imageOled

Draws a packed monochrome const image record.

Syntax

image_oled(x, y, color, clear_background, image_address);

Parameters

• x: 0..127.

• y: 0..63.

• color: OLED_BLACK or OLED_WHITE.

• clear_background: TRUE to clear the image rectangle before drawing.

• image_address: addr(ImageName) or a valid image-row address.

Returns

Nothing.

Example

const image FRAME_ICON = {
    8, 8,
    0xFF, 0x81, 0x81, 0x81,
    0x81, 0x81, 0x81, 0xFF
};

init {
    cls_oled(OLED_BLACK);
    image_oled(60, 28, OLED_WHITE, TRUE, addr(FRAME_ICON));
}

The data begins with width and height, followed by exactly ceil(width * height / 8) packed pixel bytes.

---

print

Compiler category: Leds Backing opcode: printf

Draws a const string using a built-in font. print is the current 32-bit name; printf is retained only as a deprecated compatibility alias.

Syntax

print(x, y, font, color, string_address);

Parameters

• x: 0..127.

• y: 0..63.

• font: OLED_FONT_SMALL, OLED_FONT_MEDIUM, or OLED_FONT_LARGE.

• color: OLED_BLACK or OLED_WHITE.

• string_address: addr(StringName) or a valid string-row address.

Returns

Nothing.

Example

const string READY_TEXT = "READY";

int oled_dirty = TRUE;

main {
    if(oled_dirty) {
        cls_oled(OLED_BLACK);
        print(30, 22, OLED_FONT_MEDIUM, OLED_WHITE, addr(READY_TEXT));
        oled_dirty = FALSE;
    }
}

Use a declared const string; a bare string literal is not a runtime address argument.

---

Custom button badge example

int oled_dirty = TRUE;

main {
    if(oled_dirty) {
        cls_oled(OLED_BLACK);
        circle_oled(64, 32, 12, TRUE, OLED_WHITE);
        putc_oled(1, ASCII_UPPER_A);
        puts_oled(61, 27, OLED_FONT_SMALL, 1, OLED_BLACK);
        oled_dirty = FALSE;
    }
}

This builds a reusable visual button from a circle and one buffered character. Keep drawing separate from menu state mutation so viewing a page cannot accidentally change or save settings.

Back to the additional built-in index