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

На предыдущем шаге мы создали объекты, которые одновременно перемещаются, вращаются и изменяют свои размеры. Однако при анимации объектов окружения, которые перемещаются несколькими способами одновременно, нужно обратить внимание на некоторые важные моменты.

Поскольку контроллер анимации может одновременно воспроизводить только одну анимацию, не получится осуществлять перемещение, вращение и масштабирование в отдельных анимациях. Для этих анимаций также необходимо несколько опорных кадров, поскольку может потребоваться повернуть объект окружения несколько раз в одной анимации. Поскольку необходимо построить все опорные кадры заранее, также требуется рассчитать положение, вращение и масштаб в каждой точке трансформации объекта окружения. Что произойдёт, если объект окружения должен совершить нецелое число оборотов? Как вы будете обрабатывать ситуацию с половиной оборота?

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

Создание анимаций, которые обеспечивают перемещение, вращение и масштабирование

Выполните следующие шаги, чтобы собрать отдельные элементы воедино:

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

   Verse

        # A prop that translates, rotates, and scales to a destination using animation.
        animating_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 }
   
        RotationRateTip<localizes>:message := "The time it takes to make one AdditionalRotation in seconds."
        UseEasePerKeyframeTip<localizes>:message := "Whether this prop should use the MoveEaseType for each keyframe. False will use the Linear ease type on each frame."
   
        # A prop that translates, rotates, and scales to a destination using animation.
        animating_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(10 lines long)

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

   1. Редактируемое вращение с названием AdditionalRotation. Это вращение, применяемое к RootProp в каждом ключевом кадре.

      Verse

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

      Copy full snippet(3 lines long)

   2. Редактируемая переменная типа float с названием RotationRate. Это время в секундах, необходимое для совершения одного вращения AdditionalRotation.

      Verse

       # The time it takes to make one AdditionalRotation in seconds.
       @editable {ToolTip := RotationRateTip}
       var RotationRate:float = 1.0
      

      Copy full snippet(3 lines long)

   3. Редактируемая переменная типа logic с названием UseEasePerKeyFrame. Определяет, будет ли в каждом опорном кадре применяться интерполяция типа MoveEaseType. В данном примере при установке значения false в каждом опорном кадре по умолчанию будет применяться линейная интерполяция.

      Verse

       # Whether this prop should use the MoveEaseType per each frame of animation.
       # Setting this to false will use the linear MoveEaseType on each frame.
       @editable
       UseEasePerKeyframe:logic = true
      

      Copy full snippet(4 lines long)

   4. Редактируемый массив элементов creative_prop с названием MoveTargets. Существуют различные объекты окружения творческого режима, к которым будет перемещаться корневой объект окружения.

      Verse

       # The Creative prop target for the RootProp to move toward.
       @editable {ToolTip := MoveTargetsTip}
       var MoveTargets:[]creative_prop = array{}
      

      Copy full snippet(3 lines long)

   5. Переменная типа transform с названием TargetTransform. Это целевое преобразование, в которое в данный момент переходит корневой объект окружения.

      Verse

       # The transform the prop is currently targeting.
       var TargetTransform:transform = transform{}
      

      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 }
   
        RotationRateTip<localizes>:message := "The time it takes to make one AdditionalRotation in seconds."
        UseEasePerKeyframeTip<localizes>:message := "Whether this prop should use the MoveEaseType for each keyframe. False will use the Linear ease type on each frame."
   
        # A prop that translates, rotates, and scales to a destination using animation.
        animating_prop<public> := class<concrete>(movable_prop):
   
   Expand code Copy full snippet(32 lines long)

5. Переопределите функцию Move() в классе animating_prop. Затем в выражении for переберём все элементы MoveTarget в массиве MoveTargets. Проверьте, является ли действительным каждый элемент MoveTarget, и если да, установим TargetTransform равным преобразованию MoveTarget.

   Verse

        # Move and rotate the RootProp toward the MoveTarget, or MoveTransform if one is set.
        Move<override>()<suspends>:void=
   
            # Move to each target in the MoveTargets array.
            for:
                MoveTarget:MoveTargets
            do:
   
                # Set the TargetTransformto the MoveTarget if the
                # MoveTarget is set. Otherwise set it to the MoveTransform.
   
   Expand code Copy full snippet(14 lines long)

6. Вернитесь в файл movement_behaviors и добавьте новый метод с названием BuildMovingAnimationKeyframes(). Эта функция создаёт и возвращает массив опорных кадров, которые анимируют перемещение и вращение объекта окружения в целевое преобразование. Функция принимает несколько параметров из animating_prop — MoveDuration, RotationRate, AdditionalRotation, OriginalTransform (начальное преобразование объекта окружения), TargetTransform, MoveEaseType и новую переменную типа logic с названием UseEasePerKeyframe. Последняя переменная определяет, будет ли использоваться MoveEaseType для каждого ключевого кадра. Сигнатура вашей функции должна выглядеть следующим образом:

   Verse

        # Builds an array of keyframes that animate movement and rotation from the OriginalTransform to the TargetTransform.
        BuildMovingAnimationKeyframes(MoveDuration:float, RotationRate:float, AdditionalRotation:rotation, OriginalTransform:transform, TargetTransform:transform,MoveEaseType:move_to_ease_type, UseEasePerKeyframe:logic):[]keyframe_delta=
   

   Copy full snippet(2 lines long)

7. В BuildMovingAnimationKeyframes() инициализируем следующие переменные:

   1. Массив переменных типа keyframe_delta с именем Keyframes. Это массив, возвращаемый в конце.

      Verse

       # The array of keyframes to return.
       var KeyFrames:[]keyframe_delta = array{}
      

      Copy full snippet(2 lines long)

   2. Переменная типа float с названием TotalTime. Это общее время воспроизведения анимации к данному моменту.

      Verse

       # The total amount of time spent animating.
       var TotalTime:float = 0.0
      

      Copy full snippet(2 lines long)

   3. Две переменные типа transform с названиями StartTransform и EndTransform. Это начальное и конечное преобразования объекта окружения в начале и в конце каждого опорного кадра. Инициализируем обе переменные значением OriginalTransform.

      Verse

       # The starting transform for building keyframes. This is the
       # transform of the RootProp at the start of each keyframe.
       var StartTransform:transform = OriginalTransform
      
       # The ending transform for building keyframes. This is the
       # transform of the RootProp at the end of each keyframe.
       var EndTransform:transform = OriginalTransform
      

      Copy full snippet(7 lines long)

   4. Переменная типа rotation с названием RotationToApply, инициализируемая значением AdditionalRotation. Это фактическое вращение, которое будет применяться к объекту окружения в каждом опорном кадре. Обычно это AdditionalRotation, но если нужно выполнить поворот на дробное число оборотов, нужно изменить это значение.

      Verse

       # The actual rotation to apply to the RootProp. Usually this is the
       # AdditionalRotation, but will change in cases with fractional rotations.
       var RotationToApply:rotation = AdditionalRotation
      

      Copy full snippet(3 lines long)

   5. Переменная типа float с названием AnimationTime. Это продолжительность каждого опорного кадра в секундах. Инициализируем её значением 1.0 / RotationRate, так как RootProp должен совершать RotationRate вращений в секунду.

      Verse

       # The time it takes for each keyframe of animation to complete.
       # This is initialized to 1.0/Rotation rate since the RootProp needs to make a
       # RotationRate number of rotations per second.
       var AnimationTime:float = 1.0 / RotationRate
      

      Copy full snippet(4 lines long)

   6. Переменная типа float с названием TotalRotations. Это общее количество оборотов, которое нужно совершить на протяжении всей анимации, и инициализация происходит со значением MoveDuration * RotationRate. Используется переменная типа float, а не int, потому что это необходимо для ситуаций, когда нужно сделать неполное вращение, например в конце анимации.

      Verse

       # The total number of rotations to make.
       TotalRotations:float = MoveDuration * RotationRate
      

      Copy full snippet(2 lines long)

   7. Переменная типа float с названием TimePerRotation. Это время в секундах, необходимое для совершения одного вращения. Теперь функция должна выглядеть следующим образом:

      Verse

       # Builds an array of keyframes that animate movement and rotation from the OriginalTransform to the TargetTransform.
       BuildMovingAnimationKeyframes(MoveDuration:float, RotationRate:float, AdditionalRotation:rotation, OriginalTransform:transform, TargetTransform:transform,MoveEaseType:move_to_ease_type, UseEasePerKeyframe:logic):[]keyframe_delta=
      
           # The array of keyframes to return.
           var KeyFrames:[]keyframe_delta = array{}
      
           # The total amount of time spent animating.
           var TotalTime:float = 0.0
      
           # The starting transform for building keyframes. This is the
      
      Expand code Copy full snippet(31 lines long)

Здесь много параметров, которые нужно отслеживать, поэтому ниже приведён пример расчёта, в котором RotationRate имеет значение 2,5, а MoveDuration — значение 5,0.

    Rotation Rate = 2.5 rotations/second

    Move Duration = 5.0 seconds

    Animation Time = 
        1.0 seconds/Rotation Rate = 
        1.0/2.5 = 0.4 seconds

    Total Rotations = 
        Move Duration /Rotation Rate = 

При RotationRate 2,5 и MoveDuration 5,0 всего будет 12,5 оборота, каждый из которых будет занимать 0,4 секунды. Это означает, что в конце анимации нужно будет сделать ещё половину вращения Также можно заметить, что время воспроизведения анимации совпадает с продолжительностью одного вращения. Это почти всегда так, за исключением случаев, когда нужно сделать меньше полного вращения. Несмотря на то что изначально эти переменные совпадают, нужно будет отслеживать их обе, чтобы затем производить некоторые расчёты.

Создание опорных кадров в цикле

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

1. Добавьте выражение loop в BuildMovingAnimationKeyframes(). В каждой итерации цикла будем создавать новый опорный кадр и добавлять его в массив опорных кадров. В начале цикла обновляем переменную TotalTime, увеличивая её на TimePerRotation.

   Verse

        # Build each keyframe of animation and add it to the Keyframes array.
        # The loop breaks when the TotalTime goes past the MoveDuration.
        loop:
            # Add the TimePerRotation to the TotalTime.
            set TotalTime += TimePerRotation
   

   Copy full snippet(5 lines long)

2. Создаём EndTransform — преобразование, в котором должен находиться объект окружения в конце опорного кадра. Задайте для EndTransform новое преобразование со следующими параметрами:

   1. Запишем в Translation результат вызова Lerp() между OriginalTransform и TargetTransform. Функция Lerp() принимает два значения и коэффициент линейной интерполяции в диапазоне от 0,0 до 1,0. Затем она рассчитывает новое значение где-то между двумя базовыми значениями с учётом коэффициента линейной интерполяции. Чем ближе коэффициент линейной интерполяции к 1,0, тем ближе будет преобразование к TargetTransform, и наоборот.

      Verse

       # Build the ending transform for the RootProp to move to.
       set EndTransform = transform:
           # Use Lerp() to find how far between the StartingTransform and the TargetTransform the RootProp should translate.
           # Do the same for scale, and rotate the starting transform by the RotationToApply.
           # The Lerp Parameter is based on the total number of rotations since the RootProp should guarantee that it makes
           # at least that many rotations over the whole animation.
           Translation := Lerp(OriginalTransform.Translation, TargetTransform.Translation, (TotalTime * RotationRate) / (TotalRotations))
      

      Copy full snippet(7 lines long)

   2. Запишем в Rotation результат выполнения функции MakeShortestRotationBetween(), в которую передаются вращение исходного преобразования и вращение исходного преобразования, повёрнутого на RotationToApply.

      Verse

       Translation := Lerp(OriginalTransform.Translation, TargetTransform.Translation, (TotalTime * RotationRate) / (TotalRotations))
       Rotation := MakeShortestRotationBetween(OriginalTransform.Rotation, OriginalTransform.Rotation.RotateBy(RotationToApply))~~~
      

      Copy full snippet(2 lines long)

   3. Запишем в Translation результат вызова Lerp() между OriginalTransform.Scale и TargetTransform.Scale. Помните, что это масштаб, до которого следует масштабировать объект окружения, а не величина, на которую его необходимо масштабировать. Готовый объект EndTransform должен выглядеть следующим образом:

      Verse

       # Build the ending transform for the RootProp to move to.
       set EndTransform = transform:
           # Use Lerp() to find how far between the StartingTransform and the TargetTransform the RootProp should translate.
           # Do the same for scale, and find the shortest rotation between the original transform and a rotation to apply to it.
           Translation := Lerp(OriginalTransform.Translation, TargetTransform.Translation, LerpParameter)  
           Rotation := MakeShortestRotationBetween(OriginalTransform.Rotation, OriginalTransform.Rotation.RotateBy(RotationToApply))   
           Scale := Lerp(OriginalTransform.Scale, TargetTransform.Scale, LerpParameter)    
      

      Copy full snippet(7 lines long)

3. Теперь, когда конечное преобразование определено, пришло время создать опорный кадр! Процедура почти такая же, как для функции MoveToEase() выше. Создадим новую переменную типа keyframe_delta с именем KeyFrame. Определим DeltaLocation как разницу между переносом в конечном и начальном преобразованиях. Определим DeltaRotation как вращение в конечном преобразовании. Поскольку нам требуется рассчитать изменение масштаба, определим DeltaScale как результат деления масштаба в конечном преобразовании на масштаб в начальном преобразовании. В качестве Time будем использовать AnimationTime, а в качестве InterpolationType — результат выполнения выражения if. Если UseEasePerKeyframe имеет значение true, используем MoveEaseType. В противном случае будем использовать линейный тип. Выражение опорного кадра должно выглядеть следующим образом:

   Verse

        # Build the animation keyframe to animate the RootProp.
        Keyframe := keyframe_delta:
            DeltaLocation := EndTransform.Translation - StartTransform.Translation,
            DeltaRotation := EndTransform.Rotation,
            DeltaScale := EndTransform.Scale/StartTransform.Scale,
            Time := AnimationTime,
            # Use the MoveEaseType for interpolation if UseEasePerKeyframe is true,
            # otherwise use the Linear movement type.
            Interpolation :=
                if:
   
   Expand code Copy full snippet(15 lines long)

4. Созданный опорный кадр можно добавить в массив Keyframes. Затем установим преобразование StartTransform равным EndTransform, чтобы обновить его для следующего ключевого кадра. Наконец, если TotalTime теперь больше, чем MoveDuration, нужно выйти из цикла.

   Verse

        # Add the new keyframe to the KeyFrames array, and set the
        # StartTransform to the EndTransform.
        set Keyframes += array{Keyframe}
        set StartTransform = EndTransform
        # Break out of the loop if the TotalTime passes the MoveDuration.
        if:
            TotalTime >= MoveDuration
        then:
            break
   

   Copy full snippet(9 lines long)

5. Необходимо рассмотреть важный пограничный случай — что произойдёт, когда нужно сделать меньше полного вращения? Поскольку к TimePerRotation добавляется TotalTime, это означает, что в начале цикла значение TotalTime может оказаться больше, чем MoveDuration. В этом случае необходимо обработать оставшееся время и совершить неполное вращение, установив более короткое время анимации, чтобы учесть разницу. Выполните следующие шаги, чтобы корректно обрабатывать такую ситуацию:

   1. В начале цикла, после обновления TotalTime, начните выражение if. Внутри него инициализируйте переменную LeftoverTime и задайте для неё результат вычитания TotalTime и MoveDuration, проверив, не превышает ли он значение 0,0. Это выражение присваивает значение переменной LeftoverTime только в том случае, если сравнение даёт результат true.

      Verse

       loop:
           # Add the TimePerRotation to the TotalTime.
           set TotalTime += TimePerRotation
           if:
               # If the TotalTime is greater than the MoveDuration, the final keyframe needs
               # to be shortened. This means making a fraction of a rotation.
               LeftoverTime := TotalTime - MoveDuration > 0.0
      

      Copy full snippet(7 lines long)

   2. Чтобы узнать, какую часть полного оборота нужно совершить, инициализируем новую переменную Roation Fraction и зададим ей значение, равное разности TimePerRotation и LeftoverTime, разделённой на TimePerRotation.

      Verse

       if:
           # If the TotalTime is greater than the MoveDuration, the final keyframe needs
           # to be shortened. This means making a fraction of a rotation.
           LeftoverTime := TotalTime - MoveDuration > 0.0
      
           # The fraction of a rotation to make.
           RotationFraction := (TimePerRotation - LeftoverTime)/TimePerRotation
      

      Copy full snippet(7 lines long)

   3. Чтобы создать изменённое вращение на основе RotationFraction, используем Slerp[]. Это версия функции Lerp(), которая выполняет сферическую интерполяцию и имеет аналогичные параметры. Она находит кратчайшее вращение между двумя разными положениями вращения и возвращает его на основе параметра линейной интерполяции. Вызовем Slerp[], выполнив интерполяцию между IdentityRotation() и IdentityRotation(), повёрнутым с помощью RotationToApply, используя RotationFraction в качестве параметра. Здесь мы используем IdentityRotation(), потому что вас интересует только то, какую часть оборота нужно совершить, а не конечный поворот, который должен быть установлен в EndTransform.

      Verse

       set TotalTime += TimePerRotation
       if:
           # If the TotalTime is greater than the MoveDuration, the final keyframe needs
           # to be shortened. This means making a fraction of a rotation.
           LeftoverTime := TotalTime - MoveDuration > 0.0
      
           # The fraction of a rotation to make.
           RotationFraction := (TimePerRotation - LeftoverTime)/TimePerRotation
      
           # Make a modified fractional rotation by using Slerp(). The Slerp() function does spherical interpolation
      
      Expand code Copy full snippet(12 lines long)

   4. Определив все эти параметры, установим RotationToApply равным ModifiedRotation, умножим AnimationTime на RotationFraction, чтобы узнать, насколько нужно сократить анимацию, и, наконец, установим TotalTime равным MoveDuration, поскольку это время не должно быть больше использовавшегося при расчёте EndTransform.

      Verse

           ModifiedRotation := Slerp[IdentityRotation(),  IdentityRotation().RotateBy(RotationToApply), RotationFraction]
       then:
           # Set the RotationToApply to the modified rotation, and multiply the animation time by
           # the RotationFraction to get the modified animation time.
           set RotationToApply = ModifiedRotation
           set AnimationTime = AnimationTime * RotationFraction
           # Since the TotalTime should not go past the MoveDuration,
           # set TotalTime to MoveDuration.
           set TotalTime = MoveDuration
      

      Copy full snippet(9 lines long)

6. В самом конце функции, после блока loop, вернём массив Keyframes. Готовая функция BuildMovingAnimationKeyframes() должна выглядеть следующим образом:

   Verse

        # Builds an array of keyframes that animate movement and rotation from the OriginalTransform to the TargetTransform.
        BuildMovingAnimationKeyframes(MoveDuration:float, RotationRate:float, AdditionalRotation:rotation, OriginalTransform:transform, TargetTransform:transform,MoveEaseType:move_to_ease_type, UseEasePerKeyframe:logic):[]keyframe_delta=
   		
            # The array of keyframes to return.
            var Keyframes:[]keyframe_delta = array{}
   		
            # The total amount of time spent animating.
            var TotalTime:float = 0.0
   		
            # The starting transform for building keyframes. This is the
   
   Expand code Copy full snippet(97 lines long)

7. Теперь, когда мы определили логику создания опорных кадров, пора анимировать их. Будем использовать отдельную функцию для создания и вызова анимации. Добавьте новую функцию BuildAndPlayAnimation() в класс animating_prop. Добавьте к этой функции модификатор <suspends>, чтобы она могла вызывать другие асинхронные функции.

   Verse

        # Builds an animation from an array of keyframes, then calls MoveToEase()
        # to animate the prop.
        BuildAndPlayAnimation()<suspends>:void=

   Copy full snippet(3 lines long)

8. В BuildAndPlayAnimation() инициализируем новый массив типа keyframe_delta с названием Keyframes. Затем присвоим массиву Keyframes результат вызова BuildMovingAnimationKeyframes(). Используйте RootProp.GetTransform() в качестве начального преобразования, поскольку положение объекта окружения будет меняться между вызовами Move(). Инициализируем переменную animation_mode значением animation_mode.OneShot и вызовем функцию MoveToEase(), передав в неё массив Keyframes и AnimationMode.

   Готовая функция BuildAndPlayAnimation() должна выглядеть следующим образом:

   Verse

    # Builds an animation from an array of keyframes, then calls MoveToEase()
    # to animate the prop.
    BuildAndPlayAnimation()<suspends>:void=
        var Keyframes:[]keyframe_delta = array{}
   
        # Build the animation, using the RootProp as the target transform.
        set Keyframes = BuildMovingAnimationKeyframes(MoveDuration, RotationRate, AdditionalRotation, RootProp.GetTransform(), TargetTransform, MoveEaseType, UseEasePerKeyframe)
   
        # Set the animation mode to OneShot.
        var AnimationMode:animation_mode := animation_mode.OneShot
   
   Expand code Copy full snippet(13 lines long)

9. Вернувшись в Move(), вызовем BuildAndPlayAnimation() предварительно установив преобразование TargetTransform равным преобразованию целей перемещения.

   Verse

        # Move to each target in the MoveTargets array.
        for:
            MoveTarget:MoveTargets
        do:
            # Set the TargetTransform to the MoveTarget if the
            # MoveTarget is set. Otherwise set it to the MoveTransform.
            if:
                MoveTarget.IsValid[]
            then:
                set TargetTransform = MoveTarget.GetTransform()
   
   Expand code Copy full snippet(12 lines long)

Необходимо рассмотреть ещё один случай. Что произойдёт, если цели перемещения не установлены? В такой ситуации объект окружения будет вращаться на месте, не перемещаясь в новое место назначения. Чтобы решить эту проблему, добавьте выражение if в начало функции Move(). В выражении if проверим, выполняется ли условие MoveTargets.Length = 0, и если да, установим TargetTransform равным преобразованию корневого объекта окружения. Затем вызовем BuildAndPlayAnimation(). Таким образом, анимация объекта окружения продолжится, даже если цель перемещения не задана. Готовая анимация Move() должна выглядеть следующим образом:

    # Move and rotate the RootProp toward the MoveTarget, or MoveTransform if one is set.
    Move<override>()<suspends>:void=
        # If there are no targets to move to, this prop will rotate in place.
        if:
            MoveTargets.Length = 0
        then:
            set TargetTransform = RootProp.GetTransform()

            # Build and play the animation.
            BuildAndPlayAnimation()

Теперь нужно добавить ссылку на animating_prop в классе prop_animator. В prop_animator добавьте редактируемый массив animating_prop с названием MoveAndRotateProps. В OnBegin(), в другом выражении for, инициализируйте каждый объект окружения в MoveAndRotateProps, вызвав Setup(). Готовый класс prop_animator должен выглядеть следующим образом:

    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."
    AnimatingPropsTip<localizes>:message = "The props that both move and rotate using animation."

    # Coordinates moving props through animation by calling each movable_prop's Setup() method.

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

Ура, код готов! Теперь свяжем всё воедино.

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

EasingCategory<localizes>:message := "These control the type of movement easing applied to the prop."
LogicCategory<localizes>:message := "These control different aspects of the prop's logic."
PropsCategory<localizes>:message := "These are the props that move associated with this device."
RotationCategory<localizes>:message := "These control how the prop rotates."
TimingCategory<localizes>:message := "These control the timing of parts of the prop's movmement."

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

Вернувшись в редактор, удалите часть полосы после участка вращающихся объектов, чтобы создать пропасть перед конечной целью. Добавьте на уровень объекты Двойная вращающаяся планка (малая) FG01 и Аэроплатформа (средняя) FG01. Назовите их ConstantMovingBar и TranslatingPlatform, а затем добавьте несколько объектов окружения Кнопка-луковица FG01, которые будут целями, к которым будет перемещаться каждый объект. Назовите их PlatformTarget. Поместите платформы и планку над пропастью и убедитесь, что цели размещены там, куда должны перемещаться платформы. В нашем примере вращающаяся планка перемещается из стороны в сторону, а платформа перемещается вперёд и назад.

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

Выберите свой prop_animator на панели Структура. Добавьте в массив AnimatingProps элемент, соответствующий вращающейся планке. Задайте следующие значения параметров:

Добавьте в массив TranslatingProps ещё один элемент, соответствующий перемещающейся платформе. Назначьте MoveTargets в качестве целей платформы, а RootProp в качестве TranslatingPlatform.

Нажмите Запуск сеанса и попробуйте пройти свою полосу препятствий!

Самостоятельная работа

Вот и всё! Теперь у вас есть всё, что нужно, чтобы создать собственную полосу препятствий Fall Guys с помощью Verse!

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

Используя полученные знания, попробуйте сделать следующее:

• Создавайте препятствия, вращающиеся в разных направлениях или случайным образом в разных опорных кадрах.

• Создайте препятствия, которые активируются только тогда, когда игрок встаёт на них или приближается к ним на определённое расстояние.

• Придумайте, как сделать так, чтобы платформы исчезали по истечении определённого времени или перемещали игрока в опасные места, если он остаётся на этих платформах слишком долго.

Полный код

Ниже приведён полный код, созданный в этом разделе, включая пример перепроектирования для animating_prop.

moveable_prop.verse

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

MoveDurationTip<localizes>:message = "The amount of time the prop takes to move to its destination."
MoveEaseTypeTip<localizes>:message = "The animation easing applied to the movement."
MoveEndDelayTip<localizes>:message = "The delay after the movement finishes."
MoveOnceAndStopTip<localizes>:message = "Whether the RootProp should stop in place after it finishes moving."
MoveStartDelayTip<localizes>:message = "The delay before the movement starts."
MoveTargetsTip<localizes>:message = "The array of CreativeProp to move toward. These targets can be children of the RootProp."

translating_prop.verse

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

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

# A prop that moves (translates) toward either a Creative prop target
# or a position in world space.
translating_prop<public> := class<concrete>(movable_prop):

rotation_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

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 toward either a given scale or a Creative prop's scale.
scaling_prop<public> := class<concrete>(movable_prop):
    # The array of vector3 targets for the RootProp to scale to.

animating_prop.verse

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

RotationRateTip<localizes>:message := "The time it takes to make one AdditionalRotation in seconds."
UseEasePerKeyframeTip<localizes>:message := "Whether this prop should use the MoveEaseType for each keyframe. False will use the Linear ease type on each frame."

# A prop that translates, rotates, and scales to a destination using animation.
animating_prop<public> := class<concrete>(movable_prop):

movement_behaviors.verse

# This file stores functions common to animating Creative props using keyframes.
# It also defines the move_to_ease_type enum to help in building animations.

using { /Fortnite.com/Devices }
using { /UnrealEngine.com/Temporary/SpatialMath }
using { /Fortnite.com/Characters}
using { /Fortnite.com/Devices/CreativeAnimation }

# Represents the different movement easing types.
move_to_ease_type<public> := enum {Linear, Ease, EaseIn, EaseOut, EaseInOut}

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."
MoveAndRotatePropsTip<localizes>:message = "The props that both move and rotate using animation."

# Coordinates moving props through animation by calling each moveable_prop's Setup() method.

animating_props.verse (пример перепроектирования animating_prop)

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

EasingCategory<localizes>:message := "These control the type of movement easing applied to the prop."
LogicCategory<localizes>:message := "These control different aspects of the prop's logic."
PropsCategory<localizes>:message := "These are the props that move associated with this device."
RotationCategory<localizes>:message := "These control how the prop rotates."
TimingCategory<localizes>:message := "These control the timing of parts of the prop's movmement."