Arduino:Библиотеки/Sprite

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.



Библиотека Sprite[1]

Это библиотека, позволяющая создавая спрайтовые изображения, которые затем используются библиотекой Matrix.

Скачать библиотеку можно здесь.

Функции

Создание экземпляра класса

Функция

Sprite(width, height)

используется, чтобы создать экземпляр класса Sprite, и с его помощью создавать спрайтовые изображения, которые затем используются библиотекой Matrix. Первый аргумент – это ширина спрайта в пикселях, второй – высота спрайта в пикселях. Эта функция ничего не возвращает.

Пример использования:

Sprite wave = Sprite(8, 4).

Эта функция может быть также представлена в виде

Sprite(width, height, row1, row2, ...)

, тем самым позволяя сохранить в объекте Sprite данные для какого либо спрайтового изображения. То есть третий, четвертый и так далее аргументы – это ряды пикселей, формирующие спрайтовое изображение. Наличие или отсутствие пикселя в определенной позиции задается бинарным значением – «1» или «0».

Пример использования:

Sprite wave = Sprite(
  8, 4,
  B00011000,
  B00100100,
  B01000010,
  B10000001
);

width()

Функция

width()

возвращает ширину спрайта в пикселях. Тип возвращаемого значения – int.

Пример использования:

wave.width().

height()

Функция

height()

возвращает высоту спрайта в пикселях. Тип возвращаемого значения – int.

Пример использования:

wave.height()

write()

Функция

write(x, y, value)

используется, чтобы рисовать и стирать отдельные пиксели. Первый аргумент – это координата пикселя по оси X, второй – по оси Y, а третий отвечает за то, что именно нужно сделать с пикселем – нарисовать (1) или стереть (0). Эта функция ничего не возвращает.

Пример использования:

wave.write(i, j, 0)

read()

Функция

read(x, y)

возвращает значение, хранящееся у спрайта в координатах X и Y. Соответственно, первый аргумент – это координата по оси X, а второй – по оси Y. Тип возвращаемого значения – int.

Пример использования:

wave.read(i, j).

См.также

Внешние ссылки