1. Epic GamesDeveloper
  3. UCharacterTrajectoryComponent

UCharacterTrajectoryComponent

Component for generating trajectories usable by Motion Matching.

API > API/Plugins > API/Plugins/MotionTrajectory

Inheritance Hierarchy

References

   
Module MotionTrajectory
Header /Engine/Plugins/Experimental/Animation/MotionTrajectory/Source/MotionTrajectory/Public/CharacterTrajectoryComponent.h
Include #include "CharacterTrajectoryComponent.h"

Syntax

UCLASS&40;Blueprintable, BlueprintType, Meta&61;&40;BlueprintSpawnableComponent&41;, Experimental&41;  
class UCharacterTrajectoryComponent : public UActorComponent

Remarks

Component for generating trajectories usable by Motion Matching. This component generates trajectories from ACharacter. This is intended to provide an example and starting point for using Motion Matching with a common setup using the default UCharacterMovementComponent. It is expected work flow to extend or replace this component for projects that use a custom movement component or custom movement modes.

Variables

  Type Name Description
Protected variable UProperty Category, EditDefaultsOnly BlueprintReadOnly bool bAutoUpdateTrajectory By default the component will always update trajectory.
Protected variable UProperty TObjectPtr< UCharacterMovementComponent > CharacterMovementComponent  
Protected variable FRotator DesiredControllerRotationLastUpdate  
Protected variable FQuat ForwardFacingCS Forward axis for the SkeletalMeshComponent. It's common for skeletal mesh and animation data to not be X forward.
Protected variable UProperty Category, EditDefaultsOnly BlueprintReadOnly float HistoryLengthSeconds This should generally match the longest history required by a Motion Matching Database in the project.
Protected variable UProperty Category, EditDefaultsOnly, Meta BlueprintReadOnly int32 HistorySamplesPerSecond Higher values will cost more storage and processing time, but give higher accuracy.
Protected variable UProperty Category, EditDefaultsOnly BlueprintReadOnly float MaxControllerRotationRate Maximum controller rotation rate in degrees per second used to clamp the character owner controller desired rotation to generate the prediction trajectory.
Protected variable int32 NumHistorySamples  
Protected variable UProperty Category, EditDefaultsOnly BlueprintReadOnly float PredictionLengthSeconds This should match the longest trajectory prediction required by a Motion Matching Database in the project.
Protected variable UProperty Category, EditDefaultsOnly, Meta BlueprintReadOnly int32 PredictionSamplesPerSecond Higher values will cost more storage and processing time, but give higher accuracy.
Protected variable UProperty Category, EditDefaultsOnly BlueprintReadOnly float RotateTowardsMovementSpeed If the character is forward facing (i.e. bOrientRotationToMovement is true), this controls how quickly the trajectory will rotate to face acceleration.
Protected variable float SecondsPerHistorySample  
Protected variable float SecondsPerPredictionSample  
Protected variable UProperty TObjectPtr< USkeletalMeshComponent > SkelMeshComponent  
Protected variable UProperty Category BlueprintReadOnly Transient FPoseSearchQueryTrajectory Trajectory Trajectory stored in world space so it can be directly passed to Motion Matching.

Constructors

  Type Name Description
Public function  

UCharacterTrajectoryComponent ( const FObjectInitializer& ObjectInitializer
)

  

Functions

  Type Name Description
Protected function FRotator

CalculateControllerRotationRate ( float DeltaSeconds,
bool bShouldRemainVertical
)

  
Public function Const UFunction Category blueprintnativeevent FRotator This can be used to override the facing used for trajectory calculation.
Public function Virtual Const FRotator This can be used to override the facing used for trajectory calculation.
Protected function UFunction void

OnMovementUpdated ( float DeltaSeconds,
FVector OldLocation,
FVector OldVelocity
)

  
Protected function void

UpdateHistory ( float DeltaSeconds
)

  
Protected function void

UpdatePrediction ( const FVector& PositionWS,
const FQuat& FacingWS,
const FVector& VelocityWS,
const FVector& AccelerationWS,
const FRotator& ControllerRotationRate
)

  
Public function UFunction BlueprintCallable, Category void

UpdateTrajectory ( float DeltaSeconds
)

 This can be called when bAutoUpdateTrajectory is false to manually control when trajectory updates.

Overridden from UActorComponent

  Type Name Description
Public function Virtual void Begins Play for the component.
Public function Virtual void Initializes the component.
Public function Virtual void Handle this component being Uninitialized.

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page