5. Масштабирование объектов окружения

Иногда в платформерах встречаются препятствия, которые меняют свои размеры. Это могут быть платформы, которые увеличиваются и уменьшаются либо становятся выше или ниже по какой-то оси. Когда размеры объекта меняются таким образом, это называется изменением его масштаба.

Масштаб объекта — это набор коэффициентов, на которые умножаются его исходные размеры по каждой оси. Обычно объекты имеют масштаб вида {X := 1.0, Y := 1.0, Z := 1.0}. Если удвоить значение Z масштаба объекта, последний станет в два раза выше. Если его уменьшить в два раза, объект станет вдвое ниже.

Масштабирование — это заключительная часть процесса преобразования. В этом разделе вы узнаете, как создавать увеличивающиеся и уменьшающиеся объекты, управляя их масштабом.

Создание масштабируемых объектов окружения

Чтобы создать код, масштабирующий объекты окружения, выполните следующие шаги:

1. Создайте новый класс Verse, наследующийся от movable_prop, с помощью проводника Verse и назовите его scaling_prop. Добавьте спецификатор <concrete> в этот класс, чтобы вывести его свойства в интерфейс UEFN.

   Verse

        # A prop that scales toward either a given scale or a Creative prop's scale.
        scaling_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(2 lines long)

2. Добавьте выражения using { /Fortnite.com/Devices/CreativeAnimation } и using { /UnrealEngine.com/Temporary/SpatialMath } в начало файла, чтобы импортировать эти модули. Они потребуются для анимирования вашего объекта окружения. Также ниже приведены подсказки, используемые в данном разделе.

   Verse

        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Devices/CreativeAnimation }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/SpatialMath }
   
        MatchScaleTargetTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."
   
        # A prop that scales toward either a given scale or a Creative prop's scale.
        scaling_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(9 lines long)

3. В начале определения класса scaling_prop добавьте следующие поля:

   1. Редактируемый массив элементов типа vector3 с названием ScaleTargets. Это значения масштаба, в соответствии с которыми объект окружения будет увеличиваться или уменьшаться. После выполнения функции Move() масштаб объекта окружения будет умножен на это значение.

      Verse

       # The array of vector3 targets for the RootProp to scale to.
       @editable {ToolTip := MoveTargetsTip}
       var ScaleTargets:[]vector3= array{}
      

      Copy full snippet(3 lines long)

   2. Редактируемая переменная creative_prop типа option с названием MatchScaleTarget. Если ваш объект окружения должен масштабироваться до масштаба другого объекта, вы можете установить это значение вместо использования ScaleTargets. Например, это может быть удобно, если нужно создать ряд платформ, которые увеличиваются до одинакового размера перед возвратом в исходное положение.

      Verse

       # The optional Creative prop for the RootProp to match scale to.
       @editable {ToolTip := MatchScaleTargetTip}
       var MatchScaleTarget:?creative_prop = false
      

      Copy full snippet(3 lines long)

   3. Переменная типа rotation с названием TargetScale. Это значение масштаба, до которого в настоящее время масштабируется объект окружения.

      Verse

       # The scale the prop is currently targeting.
       var TargetScale:vector3 = vector3{}
      

      Copy full snippet(2 lines long)

4. Окончательное определение класса должно выглядеть следующим образом:

   Verse

        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Devices/CreativeAnimation }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/SpatialMath }
   
        MatchScaleTargetTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."
   
        # A prop that scales towards either a given scale or a creative prop's scale.
        scaling_prop<public> := class<concrete>(movable_prop):
   
   
   Expand code Copy full snippet(20 lines long)

5. Поскольку мы уже определили функцию Move(), которая перемещает объект окружения в movable_prop, её можно переопределить в этом классе. Переопределите функцию Move() в классе scaling_prop. В функции Move() сначала нужно проверить, задана ли цель MatchScaleTarget, и сохранить её в переменной ScaleToMatch. Если да, то устанавливаем TargetScale равным ScaleToMatch, после чего вызываем функцию MoveToEase(), передав в неё параметры TargetScale, MoveDuration, MoveEaseType и animation_mode.OneShot. Это функция MoveToEase(), перегруженная ранее, которая изменяет только масштаб.

   Verse

        # Scale the RootProp toward the ScaleTarget, or MatchScaleTarget if one is set.
        Move<override>()<suspends>:void=
            # Set the TargetScale to the MatchScaleTarget if it is set.
            if:
                ScaleToMatch := MatchScaleTarget?.GetTransform().Scale
            then:
                set TargetScale = ScaleToMatch
   
                # Call MoveToEase to start scaling the prop. The OneShot animation mode will play the animation once.
                RootProp.MoveToEase(MoveDuration, TargetScale, MoveEaseType, animation_mode.OneShot)

   Copy full snippet(10 lines long)

6. Если масштаб MatchScaleTarget не задан, нужно будет перебрать элементы массива ScaleTargets. В выражении for переберём все элементы ScaleTarget в массиве ScaleTargets, установив масштаб TargetScale равным ScaleTarget. Затем вызовем MoveToEase(), передав те же значения, что и раньше. Готовая функция Move() должна выглядеть следующим образом:

   Verse

        # Scale the RootProp toward the ScaleTarget, or MatchScaleTarget if one is set.
        Move<override>()<suspends>:void=
   
            # Set the TargetScale to the MatchScaleTarget if it is set.
            if:
                ScaleToMatch := MatchScaleTarget?.GetTransform().Scale
            then:
                set TargetScale = ScaleToMatch
   
                # Call MoveToEase to start scaling the prop. The OneShot animation mode will play the animation once.
   
   Expand code Copy full snippet(20 lines long)

7. В классе устройства prop_animator добавим новый редактируемый массив элементов scaling_prop с названием ScalingProps. Добавим в OnBegin() ещё одно выражение for, в котором будут перебираться все вращаемые объекты окружения и для них будет вызываться функция Setup(). Обновлённый класс prop_animator должен выглядеть следующим образом:

   Verse

        using { /Fortnite.com/Devices }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/Diagnostics }
   
        TranslatingPropsTip<localizes>:message = "The props that translate (move) using animation."
        RotatingPropsTip<localizes>:message = "The props that rotate using animation."
        ScalingPropsTip<localizes>:message = "The props that scale using animation."
   
        # Coordinates moving props through animation by calling each prop's Setup() method.
        prop_animator := class(creative_device):
   
   Expand code Copy full snippet(39 lines long)

8. Сохраните свой код и скомпилируйте его.

Привязка объектов окружения к устройствам

Вернувшись в редактор, удалите некоторые объекты окружения после участка вращающихся объектов, но перед поднятыми блоками, чтобы создать ещё одну пропасть. Добавьте на уровень Боксёрскую перчатку FG01. Назовите перчатку ScalingGlove. Разместите перчатку посередине пропасти и поверните её так, чтобы она была обращена вверх.

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

На панели Структура выберите свой prop_animator и добавьте в массив ScalingProps элемент, соответствующий перчатке. Задайте следующие параметры объекта окружения:

Примените изменения и посмотрите, как поведут себя объекты окружения! Поэкспериментируйте со значениями масштаба, чтобы получить разные размеры, а также попробуйте масштабировать другие объекты окружения, чтобы создать другие сценарии!

Далее

В следующем разделе мы объединим перемещение, вращение и масштабирование, чтобы создать объекты окружения, способные выполнять все три операции преобразования!

• 

  6. Объединение перемещения, вращения и масштабирования

  Пришло время объединить разные аспекты движения объектов окружения с помощью Verse, чтобы создать полосу препятствий Fall Guys.

Полный код

Ниже приведён полный код, написанный в этом разделе:

scaling_prop.verse

using { /Fortnite.com/Devices }
using { /Fortnite.com/Devices/CreativeAnimation }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/SpatialMath }

MatchScaleTargetTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."

# A prop that scales towards either a given scale or a creative prop's scale.
scaling_prop<public> := class<concrete>(movable_prop):

prop_animator.verse

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

TranslatingPropsTip<localizes>:message = "The props that translate (move) using animation."
RotatingPropsTip<localizes>:message = "The props that rotate using animation."
ScalingPropsTip<localizes>:message = "The props that scale using animation."

# Coordinates moving props through animation by calling each prop's Setup() method.
prop_animator := class(creative_device):