AnimatedSprite2D

public StringName Animation { get; set; }

Имя выбранного клипа. Смена имени выбирает начальный кадр по направлению текущего проигрывания: первый при прямом, последний при обратном. Это не самостоятельная команда Play и не универсальный сброс к нулю.

public string Autoplay { get; set; }

Ключ анимации, воспроизводимой при загрузке сцены.

public bool Centered { get; set; }

Если true, текстура будет центрирована. Примечание: В играх с пиксельной эстетикой текстуры могут выглядеть деформированными при центрировании. Это вызвано их положением между пикселями. Чтобы предотвратить это, установите это свойство на false или рассмотрите возможность включения ProjectSettings.rendering/2d/snap/snap_2d_vertices_to_pixel и ProjectSettings.rendering/2d/snap/snap_2d_transforms_to_pixel.

public bool FlipH { get; set; }

Если true, текстура отражена по горизонтали.

public bool FlipV { get; set; }

Если true, текстура отражена по вертикали.

public int Frame { get; set; }

Индекс отображаемого кадра. Присваивание также задаёт FrameProgress: 1 при отрицательном GetPlayingSpeed, иначе 0, в том числе на паузе. Чтобы сохранить заданную долю, используйте SetFrameAndProgress.

public float FrameProgress { get; set; }

Доля текущего кадра: при прямом ходе обычно растёт от 0 до 1, при обратном уменьшается от 1 до 0. Явно присвоенное значение не ограничивается этим диапазоном автоматически. Для обычного позиционирования передавайте [0,1].

public Vector2 Offset { get; set; }

Смещение текстуры.

public float SpeedScale { get; set; }

Множитель скорости Entity. Направление задаёт знак произведения SpeedScale и customSpeed из Play. Ноль замораживает продвижение без команды Pause. Stop сохраняет SpeedScale. Это не FPS клипа.

public SpriteFrames SpriteFrames { get; set; }

Источник кадров и клипов. Назначение другого ресурса останавливает воспроизведение и сбрасывает курсор; повторное назначение того же экземпляра ничего не сбрасывает. Изменения общего ресурса видны другим его пользователям.

public float GetPlayingSpeed();

Возвращает произведение SpeedScale и customSpeed при включённом проигрывании, иначе 0. В значение не входят FPS клипа и относительная длительность кадра.

public bool IsPlaying();

Проверяет флаг проигрывания, а не изменение картинки. При нулевом SpeedScale, customSpeed или FPS результат может оставаться true. Pause, Stop и завершение однократного клипа выключают проигрывание.

public void Pause();

Выключает проигрывание, сохраняя Frame и FrameProgress. Play того же клипа продолжает с этого места, но использует множитель customSpeed нового вызова. GetPlayingSpeed на паузе возвращает 0.

public void Play(StringName name = null, float customSpeed = 1f, bool fromEnd = false);

Запускает существующий непустой клип. Смена имени устанавливает начало или конец по fromEnd. Для того же имени возобновляет курсор после Pause; каждый вызов заменяет customSpeed. Для явного перезапуска используйте Stop, затем Play.

public void PlayBackwards(StringName name = null);

Сокращение Play(name, -1, true). Ожидаемый обратный ход получается при положительном SpeedScale; отрицательный SpeedScale меняет знак произведения обратно. После паузы тот же клип может продолжиться с сохранённого места.

public void SetFrameAndProgress(int frame, float progress);

Явно задаёт индекс и долю кадра, не меняя флаг проигрывания. При существующем клипе индекс ограничивается допустимыми кадрами; progress не ограничивается автоматически.

public void Stop();

Выключает проигрывание, сбрасывает Frame и FrameProgress в 0 и customSpeed в 1. Сохраняет SpeedScale и выбранное имя Animation. Для сохранения курсора используйте Pause.

public event Action AnimationChanged;

Вызывается при изменении AnimatedSprite2D.Animation.

public event Action AnimationFinished;

Уведомляет о достижении конца однократного клипа при прямом ходе или начала при обратном. Проигрывание при этом ставится на паузу у границы. Для циклов используйте AnimationLooped; ожидание этого события у бесконечного цикла не завершится на очередном обороте.

public event Action AnimationLooped;

Уведомляет о переходе через границу циклического клипа. Для Pingpong переход меняет направление, для Linear начинает новый проход. Это не AnimationFinished и не самостоятельное игровое событие.

public event Action FrameChanged;

Уведомление спрайта об изменении кадра, в том числе при ручной установке курсора. Не используйте как счётчик кадров экрана или гарантию одного игрового эффекта на действие.

public event Action SpriteFramesChanged;

Вызывается при изменении AnimatedSprite2D.SpriteFrames.