display — Дисплей

Основні функції для роботи з дисплеєм.

Приклад:

 1display.set_cursor(0, 0);
 2display.print("Hello, world!");
 3
 4let color = display.color565(255, 0, 0);
 5display.draw_line(0, 0, 100, 100, color);
 6
 7let face = resources.load_image("face.bmp", display.color565(0, 0, 0));
 8display.draw_image(face, 50, 80);
 9
10display.fill_rect(0, 0, 100, 100, color);
11display.queue_draw();

Константи

display.width

Ширина полотна у пікселях (number).

display.height

Висота полотна у пікселях (number).

Об’єкт colors містить стандартні кольори у форматі RGB565:

  • colors.black, colors.white, colors.red, colors.green, colors.blue

  • colors.cyan, colors.magenta, colors.yellow

  • colors.midnight_blue, colors.orange_red

Функції

display.color565(r, g, b)

Конвертує колір з формату RGB888 (0–255) у RGB565.

Arguments:

  • r (number()) – Червоний компонент (0–255).

  • g (number()) – Зелений компонент (0–255).

  • b (number()) – Синій компонент (0–255).

Повертає:

Колір у форматі RGB565.

Тип повернення:

number

display.set_cursor(x, y)

Встановлює позицію текстового курсора.

Arguments:

  • x (number()) – Координата X.

  • y (number()) – Координата Y.

display.set_font(name)

Встановлює шрифт. Доступні шрифти: "4x6", "5x7", "5x8", "6x12", "6x13", "7x13", "8x13", "9x15", "10x20".

Arguments:

  • name (string()) – Назва шрифту.

display.set_text_size(size)

Встановлює множник розміру тексту.

Arguments:

  • size (number()) – Множник розміру.

display.set_text_color(fg[, bg])

Встановлює колір тексту.

Arguments:

  • fg (number()) – Колір переднього плану (RGB565).

  • bg (number()) – (необов’язково) Колір фону (RGB565).

display.set_text_bound(x, y, w, h)

Встановлює обмежувальний прямокутник для тексту.

Arguments:

  • x (number()) – Координата X.

  • y (number()) – Координата Y.

  • w (number()) – Ширина.

  • h (number()) – Висота.

display.print(...)

Виводить текст на полотні в позиції курсора. Приймає довільну кількість аргументів (рядки або числа).

display.fill_screen(color)

Заповнює весь екран заданим кольором.

Arguments:

  • color (number()) – Колір (RGB565).

display.draw_pixel(x, y, color)

Малює один піксель.

Arguments:

  • x (number()) – Координата X.

  • y (number()) – Координата Y.

  • color (number()) – Колір (RGB565).

display.draw_line(x0, y0, x1, y1, color)

Малює лінію між двома точками.

Arguments:

  • x0 (number()) – X початку.

  • y0 (number()) – Y початку.

  • x1 (number()) – X кінця.

  • y1 (number()) – Y кінця.

  • color (number()) – Колір (RGB565).

display.draw_rect(x, y, w, h, color)

Малює контур прямокутника.

display.fill_rect(x, y, w, h, color)

Малює заповнений прямокутник.

display.draw_circle(x, y, r, color)

Малює контур кола.

Arguments:

  • x (number()) – Координата X центру.

  • y (number()) – Координата Y центру.

  • r (number()) – Радіус.

  • color (number()) – Колір (RGB565).

display.fill_circle(x, y, r, color)

Малює заповнене коло.

display.draw_triangle(x0, y0, x1, y1, x2, y2, color)

Малює контур трикутника.

display.fill_triangle(x0, y0, x1, y1, x2, y2, color)

Малює заповнений трикутник.

display.draw_ellipse(x, y, rx, ry, color)

Малює контур еліпса.

Arguments:

  • x (number()) – Координата X центру.

  • y (number()) – Координата Y центру.

  • rx (number()) – Горизонтальний радіус.

  • ry (number()) – Вертикальний радіус.

  • color (number()) – Колір (RGB565).

display.fill_ellipse(x, y, rx, ry, color)

Малює заповнений еліпс.

display.draw_arc(x, y, r1, r2, startAngle, endAngle, color)

Малює контур дуги.

Arguments:

  • x (number()) – Координата X центру.

  • y (number()) – Координата Y центру.

  • r1 (number()) – Внутрішній радіус.

  • r2 (number()) – Зовнішній радіус.

  • startAngle (number()) – Початковий кут.

  • endAngle (number()) – Кінцевий кут.

  • color (number()) – Колір (RGB565).

display.fill_arc(x, y, r1, r2, startAngle, endAngle, color)

Малює заповнену дугу.

display.draw_image(image, x, y)

Малює зображення в заданій позиції.

Arguments:

  • image (object()) – Об’єкт зображення (з resources.load_image()).

  • x (number()) – Координата X.

  • y (number()) – Координата Y.

display.draw_image_transformed(image, x, y, transform)

Малює зображення з 2D-трансформацією.

Arguments:

  • image (object()) – Об’єкт зображення.

  • x (number()) – Координата X.

  • y (number()) – Координата Y.

  • transform (object()) – Об’єкт трансформації (з transforms).

display.queue_draw()

Надсилає вміст полотна на фізичний дисплей. Викликайте цю функцію після завершення малювання кожного кадру.