reckfellENGINE

PropertyTweener

Настройка команды PropertyTweener в последовательности Tween.

На этой странице
class PropertyTweenerReckfellSharpНаследует Tweener

Получайте PropertyTweener через TweenProperty() у валидного Tween; прямой конструктор недопустим. Команда уже добавлена в родителя. Настраивайте её до обработки; fluent-методы возвращают тот же wrapper, не независимую копию.

По умолчанию origin читается при старте; FromCurrent сохраняет значение момента создания команды, а From задаёт его явно. CustomInterpolator получает уже обработанный easing progress. При AsRelative с задержкой и изменением origin подтверждён дефект сохранения прежнего финала; условия описаны у AsRelative/SetDelay.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Конструкторы1

PropertyTweenerКонструктор
# PropertyTweener
C#
public PropertyTweener();

Не вызывайте new PropertyTweener(): native-конструктор выдаёт ошибку. Создайте через Tween.TweenProperty на валидном Tween; это команда последовательности, не самостоятельный таймер/анимация.

Методы7

AsRelativePropertyTweener
# AsRelative
C#
public PropertyTweener AsRelative();

Трактует значение TweenProperty как смещение от начального, а не абсолютную цель. Для origin=2 и offset=3 финал равен 5. В текущей реализации сочетание с SetDelay и автоматическим пересчитыванием изменённого origin имеет дефект: старт после задержки обновляет origin, но оставляет финал, рассчитанный раньше. При внешнем изменении цели во время задержки не рассчитывайте на новый origin+offset; для фиксированного origin задайте From/FromCurrent.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

FromPropertyTweener
# From
C#
public PropertyTweener From(Variant value);

Фиксирует явное начальное значение и отключает автоматическое чтение текущего свойства на старте. Тип должен соответствовать конечному значению. Не записывает это значение в объект немедленно: изменение произойдёт при шаге. Проверено изменение объекта между настройкой и стартом.

Параметры
ИмяТипПо умолчанию
valueVariant—
value

Фиксированный origin совместимого Variant-типа, не величина смещения.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

FromCurrentPropertyTweener
# FromCurrent
C#
public PropertyTweener FromCurrent();

Оставляет origin, захваченный при создании PropertyTweener, и отключает последующее resample. В 1.0.0 сам вызов не читает свойство заново. Если объект изменился после TweenProperty, FromCurrent не означает «возьми новое значение сейчас». Для этого передайте явно прочитанное значение в From либо создайте команду в нужный момент.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

SetCustomInterpolatorPropertyTweener
# SetCustomInterpolator
C#
public PropertyTweener SetCustomInterpolator(Callable interpolatorMethod);

Задаёт Callable с одним числовым progress-аргументом и float/double-результатом (Variant.Float). Progress уже прошёл Transition/Ease; не применяйте ту же кривую повторно случайно. Результат задаёт вес интерполяции, не готовое значение свойства, и не ограничивается этим методом до 0…1. В конце вызывается функция от 1: если она возвращает 0.5, свойство заканчивает на середине, а не принудительно на finalVal. Неверные типы callback здесь не исполнялись.

Параметры
ИмяТипПо умолчанию
interpolatorMethodCallable—
interpolatorMethod

Callable: один numeric progress → float/double weight; не void и не int-result.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

SetDelayPropertyTweener
# SetDelay
C#
public PropertyTweener SetDelay(double delay);

Задаёт задержку до изменения свойства в секундах времени Tween; сама анимация затем идёт duration. При default resample начальное свойство читается на пересечении задержки; From/FromCurrent фиксируют origin раньше. При AsRelative изменение origin в задержке не пересчитывает ранее рассчитанный финал — подтверждённый дефект 1.0.0. Настраивайте до начала; это не sleep и не изменение всех команд.

Параметры
ИмяТипПо умолчанию
delaydouble—
delay

Неотрицательная конечная задержка в секундах времени Tween.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

SetEasePropertyTweener
# SetEase
C#
public PropertyTweener SetEase(Tween.EaseType ease);

Задаёт easing только этой команды, переопределяя default родителя. Настраивайте после фабричного создания и до обработки. Не меняет длительность и не перенастраивает соседние команды.

Параметры
ИмяТипПо умолчанию
easeTween.EaseType—
ease

Допустимый EaseType для этой команды.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

SetTransPropertyTweener
# SetTrans
C#
public PropertyTweener SetTrans(Tween.TransitionType trans);

Задаёт transition только этой команды. Уже захваченные default родителя можно переопределить здесь; настройки соседей не меняются. Проверена Quad с Ease.In на половине длительности.

Параметры
ИмяТипПо умолчанию
transTween.TransitionType—
trans

Допустимый TransitionType для этой команды.

Возвращает PropertyTweener

Тот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.

Документация Reckfell EngineНаверх ↑
БЫСТРЫЙ ПЕРЕХОДНачало работыEntity и иерархияC# & .NET 10Сцены и префабы
Руководства и полный API Reckfell K
reckfellENGINE
RECKFELL ACCOUNT

Вход в аккаунт

Войдите в аккаунт Reckfell.

Один аккаунт для всей платформы Reckfell.