Skip to content

Class IScholaActuator

Class IScholaActuator

  • Defined in File ActuatorInterface.h

Inheritance Relationships

Derived Types

class IScholaActuator

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

Dependencies: FPoint, FSpace

Interface for actuator components that receive and execute agent actions.

This interface provides methods for defining the action space and processing actions from reinforcement learning agents. Can be implemented in both C++ and Blueprints.

Subclassed by UMovementInputActuator, URotationActuator, UTeleportActuator


Public Functions

SymbolDetails
InitActuatorInitialize the actuator component.
InitActuator_ImplementationDefault implementation of InitActuator (no-op).
GetActionSpaceReturn the actuator definition (the action space) as an instanced FSpace struct.
GetActionSpace_ImplementationDefault C++ implementation returns a default box space.
TakeActionApply an action to the actuator provided as an instanced FPoint struct.
TakeAction_ImplementationDefault C++ implementation is a no-op.

InitActuator

void InitActuator()

Initialize the actuator component.

Called once to set up the actuator. Override this method to perform any necessary initialization such as caching references or validating configuration.

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

InitActuator_Implementation

inline virtual void InitActuator_Implementation()

Default implementation of InitActuator (no-op).

Attributes: inline, virtual

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

GetActionSpace

void GetActionSpace(FInstancedStruct &OutActionSpace) const

Return the actuator definition (the action space) as an instanced FSpace struct.

This method defines what actions are valid for this actuator. The returned space describes the structure, dimensionality, and bounds of the action space. BlueprintNativeEvent so Blueprints can override; C++ classes can implement the _Implementation.

Parameters

OutActionSpace – [out] The action space definition to be populated

#DirectionNameTypeDescription
1OutActionSpaceFInstancedStruct &The action space definition to be populated

Attributes: const

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

GetActionSpace_Implementation

inline virtual void
GetActionSpace_Implementation(FInstancedStruct &OutActionSpace) const

Default C++ implementation returns a default box space.

Parameters

OutActionSpace – [out] The action space definition to be populated

#DirectionNameTypeDescription
1OutActionSpaceFInstancedStruct &The action space definition to be populated

Attributes: inline, const, virtual

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

TakeAction

void TakeAction(const FInstancedStruct &InAction)

Apply an action to the actuator provided as an instanced FPoint struct.

This method receives an action from a brain/policy and applies it to the environment. The action format must match the action space returned by GetActionSpace. BlueprintNativeEvent so Blueprints can override; C++ classes can implement the _Implementation.

Parameters

InAction – [in] The action to apply, must be compatible with this actuator’s action space

#DirectionNameTypeDescription
1InActionconst FInstancedStruct &The action to apply, must be compatible with this actuator’s action space

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

TakeAction_Implementation

inline virtual void TakeAction_Implementation(const FInstancedStruct &InAction)

Default C++ implementation is a no-op.

Parameters

InAction – [in] The action to apply (unused in default implementation)

#DirectionNameTypeDescription
1InActionconst FInstancedStruct &The action to apply (unused in default implementation)

Attributes: inline, virtual

Source: Source/Schola/Interactors/Public/ActuatorInterface.h


Public Static Functions

SymbolDetails
Execute_GetActionSpaceStatic helper to execute GetActionSpace with typed parameters.
Execute_TakeActionStatic helper to execute TakeAction with typed parameters.

Execute_GetActionSpace

static inline void
Execute_GetActionSpace(const UObject *Obj,
TInstancedStruct<FSpace> &OutActionSpace)

Static helper to execute GetActionSpace with typed parameters.

Parameters

  • Obj – [in] The object implementing this interface

  • OutActionSpace – [out] The action space to be populated

#DirectionNameTypeDescription
1Objconst UObject *The object implementing this interface
2OutActionSpaceTInstancedStruct< FSpace > &The action space to be populated

Attributes: inline, static

Source: Source/Schola/Interactors/Public/ActuatorInterface.h

Execute_TakeAction

static inline void Execute_TakeAction(UObject *Obj,
const TInstancedStruct<FPoint> &InAction)

Static helper to execute TakeAction with typed parameters.

Parameters

  • Obj – [inout] The object implementing this interface

  • InAction – [in] The action to apply

#DirectionNameTypeDescription
1ObjUObject *The object implementing this interface
2InActionconst TInstancedStruct< FPoint > &The action to apply

Attributes: inline, static

Source: Source/Schola/Interactors/Public/ActuatorInterface.h