1. Epic GamesDeveloper
  3. FIKRetargetOpBase

FIKRetargetOpBase

This is the base class for defining operations that live in the retargeter "op" stack.

API > API/Plugins > API/Plugins/IKRig

This is the base class for defining operations that live in the retargeter "op" stack. These operations are executed in order by calling the virtual Run() function on each one in order. The Run() function takes an input pose on the source skeletal mesh and affects the output pose on the target mesh. NOTE: any user defined settings associated with a retarget op must be aggregated into a custom UStruct derived from FIKRetargetOpSettingsBase This ensures that the settings are user editable in the details panel with full undo/redo support and serialization.

   
Name FIKRetargetOpBase
Type struct
Header File /Engine/Plugins/Animation/IKRig/Source/IKRig/Public/Retargeter/IKRetargetOps.h
Include Path #include "Retargeter/IKRetargetOps.h"

Syntax

USTRUCT (BlueprintType )  
struct FIKRetargetOpBase

Derived Classes

FIKRetargetOpBase derived class hierarchy

Destructors

Name Remarks Include Path Unreal Specifiers

virtual ~FIKRetargetOpBase()

   Retargeter/IKRetargetOps.h  

Variables

Protected

Name Type Remarks Include Path Unreal Specifiers
bIsEnabled bool When false, execution of this op is skipped Retargeter/IKRetargetOps.h  
Name FName The text label given to the op, used to refer to it from script Retargeter/IKRetargetOps.h  
ParentOpName FName (optional) some ops are considered as a group, this is the name of the group parent Retargeter/IKRetargetOps.h  

Functions

Public

Name Remarks Include Path Unreal Specifiers

virtual void AnimGraphEvaluateAnyThread ( FPoseContext& Output
)

 (optional) override to get any data from the anim graph as it's evaluating. Retargeter/IKRetargetOps.h  

virtual void AnimGraphPreUpdateMainThread ( USkeletalMeshComponent& SourceMeshComponent,
USkeletalMeshComponent& TargetMeshComponent
)

 (optional) override to get any data from the source or target skeletal mesh component NOTE: this is called during AnimGraph::PreUpdate() which runs on the main thread, use caution. Retargeter/IKRetargetOps.h  

virtual bool AreChainSettingsAtDefault ( const FName& InChainName
)

 (optional) override to support "Reset to Default" UI for chains Retargeter/IKRetargetOps.h  

virtual bool CanHaveChildOps()

 (optional) ops can optionally behave as a 'parent' where child ops must be executed first. Retargeter/IKRetargetOps.h  

virtual void CollectRetargetedBones ( TSet< int32 >& OutRetargetedBones
) const

 (optional) override and add any bones that your op modifies to the output TSet of bone indices Add indices of any bone that this op modifies. Retargeter/IKRetargetOps.h  

void CopySettingsRaw ( const FIKRetargetOpSettingsBase* InSettings,
const TArray< FName >& InPropertiesToIgnore
)

 Wholesale copy all settings from the input settings into this op. Retargeter/IKRetargetOps.h  

virtual void DebugDraw ( FPrimitiveDrawInterface* InPDI,
const FTransform& InComponentTransform,
const double InComponentScale,
const FIKRetargetDebugDrawState& InEditorState
) const

 (optional) override to draw debug info into the editor viewport when the Op is selected Retargeter/IKRetargetOps.h  

virtual FRetargetChainMapping * GetChainMapping()

 (optional) ops can optionally store their own chain mapping, this allows outside systems to query/edit it. Retargeter/IKRetargetOps.h  

virtual const UIKRigDefinition * GetCustomTargetIKRig()

 (optional) override and supply the target IK Rig this op references NOTE: The retarget processor will resolve the bone chains in the rig so that they can be queried by the op. Retargeter/IKRetargetOps.h  

FName GetDefaultName()

 Get the nice name to display in the viewport (defaults to "DisplayName" UStruct metadata) Retargeter/IKRetargetOps.h  

FName GetName()

 Get the name of this op (may be customized by user) Retargeter/IKRetargetOps.h  

FName GetParentOpName()

 Get the name of the op this op is parented to (None for root level ops) Retargeter/IKRetargetOps.h  

virtual const UScriptStruct * GetParentOpType()

 (optional) ops can optionally behave as a 'child' where they can be parented to ops of the type returned by this function. Retargeter/IKRetargetOps.h  

virtual FIKRetargetOpSettingsBase * GetSettings()

 (required) override and return a pointer to the settings struct used by this operation Retargeter/IKRetargetOps.h  

virtual const UScriptStruct * GetSettingsType()

 (required) override and return the type used to house the settings for this operation Retargeter/IKRetargetOps.h  

virtual const UScriptStruct * GetType()

 (required) override and return the type of this op (the derived subclass) Retargeter/IKRetargetOps.h  

virtual FText GetWarningMessage()

 (optional) override to display a warning message in the op stack Retargeter/IKRetargetOps.h  

virtual bool Initialize ( const FIKRetargetProcessor& InProcessor,
const FRetargetSkeleton& InSourceSkeleton,
const FTargetSkeleton& InTargetSkeleton,
const FIKRetargetOpBase* InParentOp,
FIKRigLogger& Log
)

 (optional) override to cache internal data when initializing the processor NOTE: you must set bIsInitialized to true to inform the retargeter that this op is ok to execute. Retargeter/IKRetargetOps.h  

bool IsEnabled()

 Get if this op is enabled Retargeter/IKRetargetOps.h  

bool IsInitialized()

 Return true if this op is initialized and ready to run Retargeter/IKRetargetOps.h  

virtual bool IsSingleton()

 (optional) return true to disallow multiple copies of this op in the stack Retargeter/IKRetargetOps.h  

virtual void OnAddedToStack ( const UIKRetargeter* InRetargetAsset,
const FIKRetargetOpBase* InParentOp
)

 (optional) override to automate initial setup after being added to the stack Retargeter/IKRetargetOps.h  

virtual void OnParentReinitPropertyEdited ( const FIKRetargetOpBase& InParentOp,
const FPropertyChangedEvent* InPropertyChangedEvent
)

 (optional) override to allow ops to react when a property marked "ReinitializeOnEdit" on the parent op is modified NOTE: InPropertyChangedEvent will be null at load time giving op a chance to clean based on parent state. Retargeter/IKRetargetOps.h  

virtual void OnPlaybackReset()

 (optional) override to reset any internal state when animation playback is reset or stopped (ie, springs / dampers etc) Retargeter/IKRetargetOps.h  

virtual void OnReinitPropertyEdited ( const FPropertyChangedEvent* InPropertyChangedEvent
)

 (optional) override to allow ops to react when a property marked "ReinitializeOnEdit" is modified NOTE: this is called before Initialize() is called again to give op a chance to auto-configure itself based on its new state NOTE: this is called in several places where InPropertyChangedEvent may be null Retargeter/IKRetargetOps.h  

virtual void OnTargetChainRenamed ( const FName InOldChainName,
const FName InNewChainName
)

 (optional) implement this if the op stores chain settings by name to allow the settings to be maintained after a chain is renamed NOTE: this is only called when the target IK Rig this op references has a chain that is renamed. Retargeter/IKRetargetOps.h  

virtual void PostInitialize ( const FIKRetargetProcessor& InProcessor,
const FRetargetSkeleton& InSourceSkeleton,
const FTargetSkeleton& InTargetSkeleton,
FIKRigLogger& InLog
)

 (optional) a second pass of initialization that ops can use after Op::Initialize() is called on all ops. Retargeter/IKRetargetOps.h  

virtual void ResetChainSettingsToDefault ( const FName& InChainName
)

 (optional) override to support resetting all settings for a given chain Retargeter/IKRetargetOps.h  

virtual void Run ( FIKRetargetProcessor& InProcessor,
const double InDeltaTime,
const TArray< FTransform >& InSourceGlobalPose,
TArray< FTransform >& OutTargetGlobalPose
)

 (optional) override to evaluate this operation and modify the output pose Retargeter/IKRetargetOps.h  

void SetEnabled ( const bool bEnabled
)

 Turn this operation on/off (will be skipped during execution if disabled) Retargeter/IKRetargetOps.h  

void SetName ( const FName InName
)

 Set the name of this op NOTE: InName is assumed to be unique in the stack (this constraint is enforced when setting the name from the controller) Retargeter/IKRetargetOps.h  

void SetParentOpName ( const FName InName
)

 Set the name of the op this op is "parented" to. Retargeter/IKRetargetOps.h  

virtual void SetSettings ( const FIKRetargetOpSettingsBase* InSettings
)

 (optional) override to react when settings are applied at runtime NOTE: This is called while the Op is running AFTER Initialize() so it up to the Op author to copy only those settings which are safe to be updated while the op is running. Retargeter/IKRetargetOps.h  

Static

Name Remarks Include Path Unreal Specifiers

static void CopyStructProperties ( const UStruct* InStructType,
const void* InSrcStruct,
void* InOutDestStruct,
const TArray< FName >& InPropertiesToIgnore
)

 A convenience function to copy all properties from one struct to another while ignoring some Retargeter/IKRetargetOps.h  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page