display: Дисплей

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

Приклад:

 1display.set_cursor(0, 0)
 2display.print("Hello,", "world!", 69, 420, "nice")
 3
 4local color = display.color565(255, 0, 0)
 5display.draw_line(0, 0, 100, 100, color)
 6
 7local 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)
11
12display.queue_draw()
class display
width: integer

ширина дисплею в пікселях

height: integer

висота дисплею в пікселях

static color565(r, g, b)

Повертає 16-бітне значення кольору

Наприклад, display.color565(255, 0, 0) поверне 63488, що відповідає червоному кольору. Це потрібно, оскільки дисплей Лілки працює з 16-бітними кольорами (5-6-5), а не з 24-бітними (8-8-8).

Всі функції, що приймають аргумент color, очікують, що він буде саме 16-бітним числом.

Parameters:
  • r (integer) – червоний (0-255)

  • g (integer) – зелений (0-255)

  • b (integer) – синій (0-255)

Returns:

16-бітне значення кольору (5-6-5)

Return type:

integer

Usage:

1local color = display.color565(255, 0, 0)
2display.draw_line(0, 0, 100, 100, color)
static set_cursor(x, y)

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

Позиція курсора використовується для виведення тексту на екран.

Parameters:
  • x (integer) – координата x

  • y (integer) – координата y

static set_font(font)

Встановлює шрифт для виведення тексту.

Шрифт, який буде використовуватися для виведення тексту.

Доступні шрифти:

Parameters:

font (str)

Usage:

1display.set_font("6x13")
2display.set_cursor(8, 32)
3display.print("Привіт,")
4display.set_cursor(8, 64)
5display.set_font("10x20")
6display.print("Лілка!")
static set_text_size(size)

Встановлює масштаб тексту.

Якщо цей параметр дорівнює 1, текст виводиться в масштабі 1:1. Якщо 2, то кожен піксель тексту буде займати 2x2 пікселі на екрані, і так далі.

Parameters:

size (integer) – масштаб тексту

static print(...)

Виводить текст на екран.

Parameters:

vararg (any) – значення для виведення

Usage:

1display.set_cursor(8, 32)
2display.print("Hello,", "world!", 69, 420, "nice")
static fill_screen(color)

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

Parameters:

color (integer) – Колір (5-6-5)

Usage:

1display.fill_screen(display.color565(255, 0, 0)) -- заповнює екран червоним кольором
static draw_pixel(x, y, color)

Малює піксель на екрані.

Parameters:
  • x (integer) – координата x

  • y (integer) – координата y

  • color (integer) – Колір (5-6-5)

static draw_line(x1, y1, x2, y2, color)

Малює лінію на екрані.

Parameters:
  • x1 (integer) – координата x початку лінії

  • y1 (integer) – координата y початку лінії

  • x2 (integer) – координата x кінця лінії

  • y2 (integer) – координата y кінця лінії

  • color (integer) – Колір (5-6-5)

Usage:

1display.draw_line(0, 0, 100, 100, display.color565(255, 0, 0)) -- малює червону лінію від (0, 0) до (100, 100)
static draw_rect(x, y, w, h, color)

Малює контур прямокутника з координатами (x, y), розмірами (w, h) та кольором color.

Parameters:
  • x (integer) – координата x початку прямокутника

  • y (integer) – координата y початку прямокутника

  • w (integer) – ширина прямокутника

  • h (integer) – висота прямокутника

  • color (integer) – Колір (5-6-5)

static fill_rect(x, y, w, h, color)

Малює заповнений прямокутник з координатами (x, y), розмірами (w, h) та кольором color.

Parameters:
  • x (integer) – координата x початку прямокутника

  • y (integer) – координата y початку прямокутника

  • w (integer) – ширина прямокутника

  • h (integer) – висота прямокутника

  • color (integer) – Колір (5-6-5)

static draw_circle(x, y, r, color)

Малює контур кола з центром в точці (x, y), радіусом r та кольором color.

Parameters:
  • x (integer) – координата x центру кола

  • y (integer) – координата y центру кола

  • r (integer) – радіус кола

  • color (integer) – Колір (5-6-5)

static fill_circle(x, y, r, color)

Малює заповнене коло з центром в точці (x, y), радіусом r та кольором color.

Parameters:
  • x (integer) – координата x центру кола

  • y (integer) – координата y центру кола

  • r (integer) – радіус кола

  • color (integer) – Колір (5-6-5)

static draw_triangle(x1, y1, x2, y2, x3, y3, color)

Малює контур трикутника з вершинами в точках (x1, y1), (x2, y2), (x3, y3) та кольором color.

Parameters:
  • x1 (integer) – координата x першої точки

  • y1 (integer) – координата y першої точки

  • x2 (integer) – координата x другої точки

  • y2 (integer) – координата y другої точки

  • x3 (integer) – координата x третьої точки

  • y3 (integer) – координата y третьої точки

  • color (integer) – Колір (5-6-5)

static fill_triangle(x1, y1, x2, y2, x3, y3, color)

Малює заповнений трикутник з вершинами в точках (x1, y1), (x2, y2), (x3, y3) та кольором color.

Parameters:
  • x1 (integer) – координата x першої точки

  • y1 (integer) – координата y першої точки

  • x2 (integer) – координата x другої точки

  • y2 (integer) – координата y другої точки

  • x3 (integer) – координата x третьої точки

  • y3 (integer) – координата y третьої точки

  • color (integer) – Колір (5-6-5)

static draw_elipse(x, y, rx, ry, color)

Малює контур еліпса з центром в точці (x, y), радіусами rx та ry та кольором color.

Parameters:
  • x (integer) – координата x центру еліпса

  • y (integer) – координата y центру еліпса

  • rx (integer) – радіус еліпса по осі x

  • ry (integer) – радіус еліпса по осі y

  • color (integer) – Колір (5-6-5)

static fill_elipse(x, y, rx, ry, color)

Малює заповнений еліпс з центром в точці (x, y), радіусами rx та ry та кольором color.

Parameters:
  • x (integer) – координата x центру еліпса

  • y (integer) – координата y центру еліпса

  • rx (integer) – радіус еліпса по осі x

  • ry (integer) – радіус еліпса по осі y

  • color (integer) – Колір (5-6-5)

static draw_arc(x, y, r1, r2, start_angle, end_angle, color)

Малює контур дуги з центром в точці (x, y), зовнішнім радіусом r1, внутрішнім радіусом r2, початковим кутом start_angle, кінцевим кутом end_angle та кольором color.

Parameters:
  • x (integer) – координата x центру дуги

  • y (integer) – координата y центру дуги

  • r1 (integer) – зовнішній радіус дуги

  • r2 (integer) – внутрішній радіус дуги

  • start_angle (integer) – початковий кут дуги (в градусах)

  • end_angle (integer) – кінцевий кут дуги (в градусах)

  • color (integer) – Колір (5-6-5)

static fill_arc(x, y, r1, r2, start_angle, end_angle, color)

Малює заповнену дугу з центром в точці (x, y), зовнішнім радіусом r1, внутрішнім радіусом r2, початковим кутом start_angle, кінцевим кутом end_angle та кольором color.

Parameters:
  • x (integer) – координата x центру дуги

  • y (integer) – координата y центру дуги

  • r1 (integer) – зовнішній радіус дуги

  • r2 (integer) – внутрішній радіус дуги

  • start_angle (integer) – початковий кут дуги (в градусах)

  • end_angle (integer) – кінцевий кут дуги (в градусах)

  • color (integer) – Колір (5-6-5)

static draw_image(image, x, y)

Малює зображення на екрані.

Parameters:
  • image (table) – ідентифікатор зображення

  • x (integer) – координата x лівого верхнього кута зображення

  • y (integer) – координата y лівого верхнього кута зображення

Usage:

1local image = resource.load_image("face.bmp", display.color565(0, 0, 0))
2display.draw_image(image, 50, 80) -- малює зображення в точці (50, 80)
static draw_image_transformed(image, x, y, transform)

Малює зображення на екрані з перетворенням.

Parameters:
  • image (table) – ідентифікатор зображення

  • x (integer) – координата x лівого верхнього кута зображення

  • y (integer) – координата y лівого верхнього кута зображення

  • transform (Transform) – перетворення

Usage:

1local image = resource.load_image("face.bmp", display.color565(0, 0, 0))
2local transform = transforms.new()
3transform = transform:rotate(45)
4display.draw_image(image, 50, 80, transform) -- малює зображення в точці (50, 80) з перетвореннями
static queue_draw()

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

Попередження

Ми не радимо використовувати цю функцію. Вона викликається автоматично після кожного виконання lilka.draw(). Вам слід писати весь код малювання всередині своєї функції lilka.draw(), а цю функцію використовувати лише для тестування простих програм.

Return type:

nil