4. Вращение объектов окружения

Ещё одним препятствием, характерным для жанра «платформер», являются вращающиеся объекты, такие как поворачивающаяся платформа, по которой нужно постоянно бежать, или планка, перемещающаяся вперёд и назад, через которую требуется перепрыгивать.

Вторым компонентом преобразования объекта является его вращение, и объектом можно манипулировать, поворачивая его вокруг оси. Существует несколько различных способов создавать уникальные препятствия в стиле платформера, используя вращение, и в этом разделе вы освоите их программирование.

Создание вращающихся объектов окружения

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

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

   Verse

        # A prop that rotates by an additional rotation or rotates to match
        # a Creative prop's rotation.
        rotating_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(3 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 }
   
        AdditionalRotationTip<localizes>:message = "The rotation to apply to the RootProp."
        ShouldRotateForeverTip<localizes>:message = "Whether the RootProp should rotate forever."
        MatchRotationTargetTip<localizes>:message = "The optional prop whose rotation the RootProp should rotate to. Use this if you do not want to set an Additional Rotation."
   
        # A prop that rotates by an additional rotation or rotates to match
   
   Expand code Copy full snippet(12 lines long)

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

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

      Verse

                               # The additional rotation to apply to the RootProp.
                               @editable {ToolTip := AdditionalRotationTip}
                               AdditionalRotation:rotation = rotation{}
      

      Copy full snippet(3 lines long)

   2. Редактируемая переменная типа logic с названием ShouldRotateForever. Определяет, должен ли объект окружения продолжать вращаться, не возвращаясь в исходное состояние.

      Verse

       # Whether the RootProp should rotate forever.
       @editable {ToolTip := ShouldRotateForeverTip}
       ShouldRotateForever:logic = true
      

      Copy full snippet(3 lines long)

   3. Редактируемая переменная creative_prop типа option с названием MatchRotationTarget. Если ваш объект окружения должен поворачиваться в положение вращения другого объекта, вы можете установить это значение вместо использования AdditionalRotation.

      Verse

       # The optional prop whose rotation RootProp should rotate to match. Use this if you
       # do not want to set an additional rotation.
       @editable {ToolTip := MatchRotationTargetTip}
       MatchRotationTarget:?creative_prop = false
      

      Copy full snippet(4 lines long)

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

      Verse

       # The rotation the prop is currently rotating toward.
       var TargetRotation:rotation = rotation{}
      

      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 }
   
        AdditionalRotationTip<localizes>:message = "The rotation to apply to the RootProp."
        ShouldRotateForeverTip<localizes>:message = "Whether the RootProp should rotate forever."
        MatchRotationTargetTip<localizes>:message = "The optional prop whose rotation the RootProp should rotate to. Use this if you do not want to set an Additional Rotation."
   
        # A prop that rotates by an additional rotation or rotates to match
   
   Expand code Copy full snippet(28 lines long)

5. Поскольку мы уже определили функцию Move(), которая перемещает объект окружения в movable_prop, её можно переопределить в этом классе. Переопределите функцию Move() в классе rotating_prop. В функции Move() сначала нужно проверить, задана ли цель MatchRotationTarget, и сохранить её в переменной RotationToMatch. Если да, установим вращение TargetRotation равным RotationToMatch. В противном случае установим его равным AdditionalRotation.

   Verse

        # Rotate the RootProp by applying the TargetRotation, or toward the MoveTarget if one is set.
        Move<override>()<suspends>:void=
   
            # Set the TargetRotation to the MoveTarget's rotation if the MoveTarget is set.
            if:
                RotationToMatch := MatchRotationTarget?.GetTransform().Rotation
            then:
                set TargetRotation = RotationToMatch
            else:
                set TargetRotation = AdditionalRotation

   Copy full snippet(10 lines long)

6. Как и в случае с translating_prop, зададим режим воспроизведения анимации. Инициализируем новую переменную animation_mode, назовём её AnimationMode и присвоим ей значение animation_mode.OneShot. Это означает, что анимация остановится, как только объект достигнет цели. Если объект окружения не должен вращаться бесконечно либо перемещаться один раз и останавливаться, задайте режим анимации «пинг-понг». С помощью режима «пинг-понг» можно создавать объекты, которые циклически перемещаются туда и обратно, такие как стрелка метронома или мост, который постоянно поднимается и опускается.

   Verse

        # Set the default animation mode to play.
        # The OneShot animation mode will play the animation once.
        var AnimationMode:animation_mode := animation_mode.OneShot
   
        # If the RootProp should not reset and not stop when it finishes rotating,
        # set the animation mode to PingPong.
        if:
            not ShouldRotateForever? and not MoveOnceAndStop?
        then:
            set AnimationMode = animation_mode.PingPong

   Copy full snippet(10 lines long)

   Если для ShouldReset задано значение false, а для ShouldRotateForever — true, то объект окружения будет сохранять положение после каждой анимации, продолжая перемещаться при каждом выполнении Move() в цикле.

7. Получим целевое вращение объекта окружения и сохраним его в новой переменной RotateByMoveRotation, вызвав RotateBy() для StartingTransform и передав TargetRotation. Затем вызовем MoveToEase(). Готовая функция Move() должна выглядеть следующим образом:

   Verse

        # Rotate the RootProp by applying the TargetRotation, or toward the MoveTarget if one is set.
        Move<override>()<suspends>:void=
   
            # Set the TargetRotation to the MoveTarget's rotation if the MoveTarget is set.
            if:
                RotationToMatch := MatchRotationTarget?.GetTransform().Rotation
            then:
                set TargetRotation = RotationToMatch
            else:
                set TargetRotation = AdditionalRotation
   
   Expand code Copy full snippet(24 lines long)

8. В классе устройства prop_animator добавьте новый редактируемый массив элементов rotating_prop с названием RotatingProps. Добавим в 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."
   
        # Coordinates moving props through animation by calling each prop's Setup() method.
        prop_animator := class(creative_device):
   
   
   Expand code Copy full snippet(29 lines long)

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

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

Вернувшись в редактор, удалите некоторые объекты окружения после участка переносимых объектов, чтобы создать ещё одну пропасть. Добавьте на уровень Основание поворотного стола FG01 и Двойную вращающуюся планку (малую) FG01. Назовите основание RotatingBase, а планку — Spinning Bar. Установите планку над основанием и разместите оба объекта окружения над пропастью.

Настройка вращающихся объектов окружения. Вращающаяся планка и вращающееся основание поворачиваются в одном направлении с разной скоростью.

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

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

Далее

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

• 

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

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

Полный код

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

rotating_prop.verse

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

AdditionalRotationTip<localizes>:message = "The rotation to apply to the RootProp."
ShouldRotateForeverTip<localizes>:message = "Whether the RootProp should rotate forever."
MatchRotationTargetTip<localizes>:message = "The optional prop whose rotation the RootProp should rotate to. Use this if you do not want to set an Additional Rotation."

# A prop that rotates by an additional rotation or rotates to match

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."

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