resources - Ресурси

Функції для роботи з ресурсами (зображеннями, звуками тощо).

Приклад:

1local face = resources.load_image("face.bmp", display.color565(0, 0, 0))
2display.draw_image(face, 50, 80)
class resources
static load_image(filename, transparent_color?, pivotX?, pivotY?)

Завантажує BMP-зображення і повертає таблицю з ідентифікатором зображення (а також з його розмірами), яку можна використовувати для малювання зображення на екрані.

Ця таблиця містить наступні поля:

  • width: ширина зображення

  • height: висота зображення

  • pointer: внутрішній ідентифікатор зображення

Parameters:

  • filename (str) – шлях до файлу зображення .BMP (відносно місця знаходження скрипта, що виконується)

  • transparent_color? (integer) – колір, який буде використаний для прозорості (5-6-5). Якщо цей параметр не вказаний, зображення буде виводитись без прозорості

  • pivotX? (integer) – X-координата центру зображення (за замовчуванням це середина зображення)

  • pivotY? (integer) – Y-координата центру зображення (за замовчуванням це середина зображення)

Return type:

table

Usage:

1local face = resources.load_image("face.bmp", display.color565(0, 0, 0))
2print(face.width, face.height) -- Виведе розміри зображення
3display.draw_image(face, 50, 80) -- Виведе зображення на екран у позицію (50, 80)
static rotate_image(image, angle, blank_color)

Повертає зображення на певну кількість градусів за годинниковою стрілкою навколо його центру.

Parameters:

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

  • angle (integer) – кут (в градусах)

  • blank_color (integer) – колір для пікселів, які залишаться незаповненими

static flip_image_x(image)

Відображає зображення горизонтально. Зручно використовувати для платформерів, де герой може рухатись вліво та вправо.

Parameters:

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

static flip_image_y(image)

Відображає зображення вертикально.

Parameters:

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

static read_file(filename)

Читає вміст файлу і повертає його як текст.

Parameters:

filename (str) – шлях до файлу (відносно місця знаходження скрипта, що виконується)

Return type:

str

Usage:

1local content = resources.read_file("file.txt")
2print(content) -- Виведе вміст файлу
static write_file(filename, content)

Записує текст у файл.

Parameters:

  • filename (str) – шлях до файлу (відносно місця знаходження скрипта, що виконується)

  • content (str) – текст, який буде записаний у файл

Usage:

1resources.write_file("file.txt", "Hello, world!")