sprite.md 3.7 KB


title: Компонент Sprite

brief: Данное руководство описывает, как отображать 2D изображения и анимацию с помощью компонента Sprite.

Компонент Sprite

Компонент Sprite --- это простое изображение или мултикадровая анимация, отображаемая на экране.

sprite{srcset="images/graphics/[email protected] 2x"}

Спрайт может брать графику либо из атласа, либо из источника тайлов.

Свойства спрайта

Помимо свойств Id, Position и Rotation существуют следующие специфические свойства компонента:

Image : Ресурс Atlas или Tile Source, используемый в спрайте.

Default Animation : Анимация, используемая для спрайта.

Material : Материал, используемый для рендеринга спрайта.

Blend Mode : Режим наложения, используемый при рендеринге спрайта.

Режим наложения

:blend-modes

Манипулирование при выполнении

Спрайтами можно манипулировать во время выполнения с помощью ряда различных функций и свойств (обращайтесь к документации по API). Функции:

  • sprite.play_flipbook() --- воспроизводит анимации в спрайте.
  • sprite.set_hflip() и sprite.set_vflip() --- задает горизонтальное и вертикальное переворачивание в анимации спрайта.

Спрайт также имеет ряд различных свойств, которыми можно манипулировать с помощью go.get() и go.set():

cursor : Нормализованный курсор анимации (number).

image : Изображение спрайта (hash). Его можно изменить с помощью свойства атласа или источника тайлов и go.set(). За примером обращайтесь к справочнику по API.

material : Материал спрайта (hash). Его можно изменить с помощью свойства материала и go.set(). За примером обращайтесь к справочнику по API.

playback_rate : Скорость воспроизведения анимации (number).

scale : Неравномерный масштаб спрайта (vector3).

size : Размер спрайта (vector3) (READ ONLY).

:Slice-9

Константы материала

{% include shared/material-constants.md component='sprite' variable='tint' %}

tint : Цветовой оттенок спрайта (vector4). Для представления оттенка с компонентами x, y, z и w, соответствующими красному, зеленому, синему и альфа оттенкам, используется тип vector4.

Конфигурация проекта

В файле game.project имеются несколько настроек проекта, относящихся к спрайтам.