resources — Ресурси

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

Шляхи до файлів є відносними до директорії, в якій знаходиться скрипт.

Приклад:

1let face = resources.load_image("face.bmp", display.color565(0, 0, 0));
2display.draw_image(face, 50, 80);
3
4let music = resources.load_audio("song.mod");
5audio.play(music);
6
7// Після використання — звільніть пам'ять
8resources.delete(face);
9resources.delete(music);

Функції

resources.load_image(path[, transparencyColor[, pivotX, pivotY]])

Завантажує BMP-зображення з SD-картки.

Arguments:

  • path (string()) – Шлях до файлу (відносний до директорії скрипта).

  • transparencyColor (number()) – (необов’язково) Колір прозорості (RGB565). За замовчуванням: немає.

  • pivotX (number()) – (необов’язково) X координата точки обертання.

  • pivotY (number()) – (необов’язково) Y координата точки обертання.

Повертає:

Об’єкт {width, height, pointer} або undefined при помилці.

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

object

resources.rotate_image(image, angle, blankColor)

Повертає повернуту копію зображення.

Arguments:

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

  • angle (number()) – Кут обертання.

  • blankColor (number()) – Колір для незаповнених пікселів.

Повертає:

Нове зображення {width, height, pointer}.

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

object

resources.flip_image_x(image)

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

Arguments:

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

Повертає:

Нове зображення {width, height, pointer}.

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

object

resources.flip_image_y(image)

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

Arguments:

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

Повертає:

Нове зображення {width, height, pointer}.

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

object

resources.load_audio(path)

Завантажує аудіо-файл з SD-картки.

Підтримувані формати: .mod, .wav, .mp3, .aac, .flac.

Arguments:

  • path (string()) – Шлях до файлу (відносний до директорії скрипта).

Повертає:

Об’єкт {size, type, pointer} або undefined при помилці.

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

object

resources.delete(resource)

Звільняє пам’ять, виділену для ресурсу (зображення або звук). Якщо звук зараз відтворюється — зупиняє його.

Arguments:

  • resource (object()) – Об’єкт ресурсу для видалення.

resources.read_file(path)

Зчитує текстовий файл з SD-картки.

Arguments:

  • path (string()) – Шлях до файлу (відносний до директорії скрипта).

Повертає:

Вміст файлу як рядок або undefined при помилці.

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

string

resources.write_file(path, content)

Записує текст у файл на SD-картці.

Arguments:

  • path (string()) – Шлях до файлу (відносний до директорії скрипта).

  • content (string()) – Текст для запису.