PropertyTweener
Настройка команды PropertyTweener в последовательности Tween.
Получайте PropertyTweener через TweenProperty() у валидного Tween; прямой конструктор недопустим. Команда уже добавлена в родителя. Настраивайте её до обработки; fluent-методы возвращают тот же wrapper, не независимую копию.
По умолчанию origin читается при старте; FromCurrent сохраняет значение момента создания команды, а From задаёт его явно. CustomInterpolator получает уже обработанный easing progress. При AsRelative с задержкой и изменением origin подтверждён дефект сохранения прежнего финала; условия описаны у AsRelative/SetDelay.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
PropertyTweenerКонструктор
public PropertyTweener();Не вызывайте new PropertyTweener(): native-конструктор выдаёт ошибку. Создайте через Tween.TweenProperty на валидном Tween; это команда последовательности, не самостоятельный таймер/анимация.
Методы7
AsRelativePropertyTweener
public PropertyTweener AsRelative();Трактует значение TweenProperty как смещение от начального, а не абсолютную цель. Для origin=2 и offset=3 финал равен 5. В текущей реализации сочетание с SetDelay и автоматическим пересчитыванием изменённого origin имеет дефект: старт после задержки обновляет origin, но оставляет финал, рассчитанный раньше. При внешнем изменении цели во время задержки не рассчитывайте на новый origin+offset; для фиксированного origin задайте From/FromCurrent.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.
FromPropertyTweener
public PropertyTweener From(Variant value);Фиксирует явное начальное значение и отключает автоматическое чтение текущего свойства на старте. Тип должен соответствовать конечному значению. Не записывает это значение в объект немедленно: изменение произойдёт при шаге. Проверено изменение объекта между настройкой и стартом.
| Имя | Тип | По умолчанию |
|---|---|---|
value | Variant | — |
valueФиксированный origin совместимого Variant-типа, не величина смещения.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.
FromCurrentPropertyTweener
public PropertyTweener FromCurrent();Оставляет origin, захваченный при создании PropertyTweener, и отключает последующее resample. В 1.0.0 сам вызов не читает свойство заново. Если объект изменился после TweenProperty, FromCurrent не означает «возьми новое значение сейчас». Для этого передайте явно прочитанное значение в From либо создайте команду в нужный момент.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.
SetCustomInterpolatorPropertyTweener
public PropertyTweener SetCustomInterpolator(Callable interpolatorMethod);Задаёт Callable с одним числовым progress-аргументом и float/double-результатом (Variant.Float). Progress уже прошёл Transition/Ease; не применяйте ту же кривую повторно случайно. Результат задаёт вес интерполяции, не готовое значение свойства, и не ограничивается этим методом до 0…1. В конце вызывается функция от 1: если она возвращает 0.5, свойство заканчивает на середине, а не принудительно на finalVal. Неверные типы callback здесь не исполнялись.
| Имя | Тип | По умолчанию |
|---|---|---|
interpolatorMethod | Callable | — |
interpolatorMethodCallable: один numeric progress → float/double weight; не void и не int-result.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.
SetDelayPropertyTweener
public PropertyTweener SetDelay(double delay);Задаёт задержку до изменения свойства в секундах времени Tween; сама анимация затем идёт duration. При default resample начальное свойство читается на пересечении задержки; From/FromCurrent фиксируют origin раньше. При AsRelative изменение origin в задержке не пересчитывает ранее рассчитанный финал — подтверждённый дефект 1.0.0. Настраивайте до начала; это не sleep и не изменение всех команд.
| Имя | Тип | По умолчанию |
|---|---|---|
delay | double | — |
delayНеотрицательная конечная задержка в секундах времени Tween.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.
SetEasePropertyTweener
public PropertyTweener SetEase(Tween.EaseType ease);Задаёт easing только этой команды, переопределяя default родителя. Настраивайте после фабричного создания и до обработки. Не меняет длительность и не перенастраивает соседние команды.
| Имя | Тип | По умолчанию |
|---|---|---|
ease | Tween.EaseType | — |
easeДопустимый EaseType для этой команды.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.
SetTransPropertyTweener
public PropertyTweener SetTrans(Tween.TransitionType trans);Задаёт transition только этой команды. Уже захваченные default родителя можно переопределить здесь; настройки соседей не меняются. Проверена Quad с Ease.In на половине длительности.
| Имя | Тип | По умолчанию |
|---|---|---|
trans | Tween.TransitionType | — |
transДопустимый TransitionType для этой команды.
PropertyTweenerТот же объект команды для настройки; не новая независимая копия. From может дать null при недопустимом состоянии/типе.