6. 移動、回転、スケールを組み合わせる

移動、回転、スケールする上記のオブジェクトでは、3 つすべてを同時に行っています。 ただし、同時に複数の方法で移動する小道具用のアニメーションを作成する際に考慮すべき、いくつかの重要な課題があります。

アニメーション コントローラーが一度に再生できるアニメーションは 1 つだけであるため、移動、回転、スケールを個別のアニメーションで行うことはできません。 また、小道具をアニメーションごとに複数回回転させることもできるよう、それらのアニメーションでは複数のキーフレームが必要です。 すべてのキーフレームを事前に作成しておく必要があるため、小道具の経路の各ポイントで位置、回転、スケールを計算する必要もあります。 小道具で均等な量の回転が作成されない場合はどうなるでしょうか。 半回転はどのように処理するのでしょうか。

この後のセクションでは多数の数学演算を伴いますが、セクションが終わるまでに、小道具を複数のポイントに移動、回転、スケールでき、複雑で動的で楽しい (これが最も重要) プラットフォームの課題を作成して、理想の Fall Guys コースを構築できるようになります。

移動、回転、スケールするアニメーションを作成する

以下の手順に従って、1 つにまとめ始めます。

1. Verse Explorer を使用して、movable_prop を継承する animating_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 という編集可能な rotation。 これは、キーフレームごとに 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. RotationRate という編集可能な float 値。 これは、AdditionalRotation を 1 回行うのにかかる時間 (秒) です。

      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. UseEasePerKeyFrame という編集可能な logic。 これは、各キーフレームで補間に 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. MoveTargets という、creative_prop の編集可能な配列。 これらは、ルート小道具が移動先にすることができるクリエイティブの小道具です。

      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. TargetTransform という transform 変数。 これは、ルート小道具が現在移動先にしているトランスフォームです。

      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. animating_prop クラスの Move() 関数をオーバーライドします。 そして、for 式内で、MoveTargets 配列の各 MoveTarget をイテレートします。 各 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、および UseEasePerKeyframe という新しい logic 値です。 この logic 値によって、各キーフレームで 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. Keyframes という keyframe_delta の変数配列。 これは、終了時に返す配列です。

      Verse

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

      Copy full snippet(2 lines long)

   2. TotalTime という float 変数。 これは、これまでにアニメートに費やした合計時間です。

      Verse

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

      Copy full snippet(2 lines long)

   3. StartTransform と EndTransform という 2 つの transform 変数。 これらはそれぞれ、各キーフレームの開始時と終了時の、小道具の開始トランスフォームと終了トランスフォームです。 どちらも 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. RotationToApply という rotation 変数。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. AnimationTime という float 変数。 これは、各キーフレームの所要時間 (秒) です。 RootProp では 1 秒あたり RotationRate 個の回転を作成する必要があるため、この値を 1.0 / 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. TotalRotations という float 値。 これは、アニメーション全体で作成される回転の総数であり、MoveDuration * RotationRate に初期化されています。 これが int ではなく float である理由は、アニメーションの終了時などで 1 回転を作成する必要がない場合に対処するためです。

      Verse

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

      Copy full snippet(2 lines long)

   7. TimePerRotation という float 値。 これは、1 つの回転が完了するのにかかる時間 (秒) です。 この関数は次のようになっています。

      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 つの半回転を余分に作成する必要があることになります。 また、AnimationTime と TimePerRotation の時間が同じであることもわかります。 1 回転未満の回転を作成する必要がある場合を除いて、ほとんどの場合にそうなります。 それらが最初は同じ値であっても、どちらの変数も追跡して、後で数学演算を処理する必要があります。

ループ内でキーフレームを作成する

では、作成しましょう。 以下の手順に従って、キーフレームを作成するループをセットアップします。

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 を、OriginalTransform と TargetTransform の間で Lerp() を呼び出した結果に設定します。 Lerp() 関数は、2 つの値と LerpRatio (0.0 ～ 1.0 の範囲の値) を受け取ります。 LerpRatio に基づいて 2 値の間に新しい値を生成します。 LerpRatio が 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 を、元のトランスフォームの回転および RotationToApply によって回転された元のトランスフォームを渡した、MakeShortestRotationBetween() の結果に設定します。

      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. Scale を、OriginalTransform.Scale と TargetTransform.Scale の間で Lerp() を呼び出した結果に設定します。 これは小道具のスケールを合わせるスケールであり、必要なスケールの倍率ではないことに注意してください。 完全な 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. 考慮すべき重要なエッジケースとして、1 回転未満の回転を作成する場合があります。 TimePerRotation を TotalTime に追加しているため、ループの開始時に TotalTime が MoveDuration よりも大きくなっている可能性があります。 この状況では、差分に相当する、短いアニメーション時間で、残り時間を調整して 1 回転未満の回転にする必要があります。 この状況に対応するために次の手順を実行します。

   1. ループの先頭に戻り、TotalTime を更新した後で、if 式を開始します。 その中で、変数 LeftoverTime を初期化し、TotalTime から MoveDuration を除算した結果に一致するように設定して、それが 0.0 より大きいかどうかをチェックします。 比較結果が true であれば、この式は LeftoverTime を代入するだけです。

      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. どの程度の部分回転にする必要があるのかを知るには、新しい変数 RotationFraction を初期化し、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() の別バージョンであり、球面線形補間を処理し、同様のパラメータを取ります。 2 つの異なる回転から最短の回転を見つけ、線形補間パラメータに基づく回転を返します。 Slerp[] を呼び出し、IdentityRotation() と、RotationToApply によって回転した IdentityRotation() の間を、線形補間パラメータとして 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. この関数の最後で、ループの後で、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() 内で、Keyframes という新しい keyframe_delta 配列を初期化します。 そして、Keyframes を、BuildMovingAnimationKeyframes() を呼び出した結果に設定します。 RootProp.GetTransform() を開始トランスフォームとして使用します。これは、Move() 呼び出しごとに小道具の位置が変わるためです。 animation_mode 変数を animation_mode.OneShot に初期化し、Keyframes 配列と AnimationMode を渡して、MoveToEase() を呼び出します。

   完全な 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() 内に戻り、TargetTransform を移動ターゲット トランスフォームに設定した後で、BuildAndPlayAnimation() を呼び出します。

   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)

留意が必要な場合がもう 1 つあります。 移動ターゲットを何も設定しない場合に何が起きるでしょう。 この状況では、小道具はその場で回転を続け、新しい目的地に移動しません。 これに対応するには、Move() 関数の先頭に if 式を追加します。 その 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 内で、MoveAndRotateProps という animating_prop の編集可能な配列を追加します。 OnBegin() 内のもう一方の for 式内で、Setup() を呼び出すことによって、MoveAndRotateProps の各小道具を初期化します。 完全な 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 SpinningBar Double S と FG01 Hover Platform M をもう一つ、レベルに追加します。 それらを SpinningMovingBar と TranslatingPlatform という名前にし、FG01 Button Bulb 小道具をいくつか追加します。これらは、各小道具の移動先ターゲットになります。 これらを PlatformTarget という名前にします。 割れ目の上にプラットフォームとバーを配置し、プラットフォームの移動先とするターゲットを配置します。 この例では、スピンするバーが左右に動き、プラットフォームは前後に動きます。

スピンするバーと移動するプラットフォームのセットアップ。 矢印はそれぞれの小道具が移動する方向を示しています。 スピンするバーとプラットフォームはどちらも前後に動き、回転するバーは動くときにスピンします。

アウトライナー内で prop animator を選択します。 スピンするバーの AnimatingProps に配列要素を追加します。 それぞれの値を次のように設定します。

移動するプラットフォームの TranslatingProps に配列要素をもう一つ追加します。 MoveTargets をプラットフォーム ターゲットに割り当て、RootProp を TranslatingPlatform に割り当てます。

[Launch Session (セッションを開始)] をクリックして、完成した障害物コースを試走しましょう。

応用編

完成です。 これで Verse を使用して Fall Guys の独自の障害物コースを作成するすべてが揃いました。

ここに示したコードを使用して、自分の体験でクリエイティブの小道具をアニメートし、Fall Guys プロジェクトを超えるものも生み出すことができます。

ここで学習したことを活かして以下を試してみてください。

• さまざまな方向に回転する障害物、またはキーフレームにわたってランダムに回転する障害物を作成します。

• プレイヤーがその上に立つか一定の距離に近づいたときにのみ、アクティブ化される障害物を作成します。

• 一定時間が経過すると消えるプラットフォーム、またはプレイヤーが長く留まっていると危険な場所に移動させるプラットフォームを作成する方法を考え出します。

完全なコード

このセクションで作成した完全なコード、および animating_prop のリファクタリング例を以下に示します。

movable_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):

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

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