unreal.InterpToMovementComponent

class unreal.InterpToMovementComponent(outer=None, name='None')

Bases: unreal.MovementComponent

Move the root component between a series of points over a given time * see: UMovementComponent

C++ Source:

  • Module: Engine

  • File: InterpToMovementComponent.h

Editor Properties: (see get_editor_property/set_editor_property)

  • asset_user_data (Array(AssetUserData)): [Read-Write] Asset User Data: Array of user data stored with the component

  • auto_activate (bool): [Read-Write] Auto Activate: Whether the component is activated at creation or must be explicitly activated.

  • auto_register_physics_volume_updates (bool): [Read-Write] Auto Register Physics Volume Updates: If true, then applies the value of bComponentShouldUpdatePhysicsVolume to the UpdatedComponent. If false, will not change bShouldUpdatePhysicsVolume on the UpdatedComponent at all. see: bComponentShouldUpdatePhysicsVolume

  • auto_register_updated_component (bool): [Read-Write] Auto Register Updated Component: If true, registers the owner’s Root component as the UpdatedComponent if there is not one currently assigned.

  • auto_update_tick_registration (bool): [Read-Write] Auto Update Tick Registration: If true, whenever the updated component is changed, this component will enable or disable its tick dependent on whether it has something to update. This will NOT enable tick at startup if bAutoActivate is false, because presumably you have a good reason for not wanting it to start ticking initially.

  • behaviour_type (InterpToBehaviourType): [Read-Write] Behaviour Type: Movement behaviour of the component

  • can_ever_affect_navigation (bool): [Read-Write] Can Ever Affect Navigation: Whether this component can potentially influence navigation

  • check_if_still_in_world (bool): [Read-Write] Check if Still in World: Do we want this comp to perform CheckStillInWorld checks?

  • component_should_update_physics_volume (bool): [Read-Write] Component Should Update Physics Volume: If true, enables bShouldUpdatePhysicsVolume on the UpdatedComponent during initialization from SetUpdatedComponent(), otherwise disables such updates. Only enabled if bAutoRegisterPhysicsVolumeUpdates is true. WARNING: UpdatePhysicsVolume is potentially expensive if overlap events are also disabled because it requires a separate query against all physics volumes in the world.

  • component_tags (Array(Name)): [Read-Write] Component Tags: Array of tags that can be used for grouping and categorizing. Can also be accessed from scripting.

  • constrain_to_plane (bool): [Read-Write] Constrain to Plane: If true, movement will be constrained to a plane. see: PlaneConstraintNormal, PlaneConstraintOrigin, PlaneConstraintAxisSetting

  • control_points (Array(InterpControlPoint)): [Read-Write] Control Points: List of control points to visit.

  • duration (float): [Read-Write] Duration: How long to take to move from the first point to the last (or vice versa)

  • editable_when_inherited (bool): [Read-Write] Editable when Inherited: True if this component can be modified when it was inherited from a parent actor class

  • force_sub_stepping (bool): [Read-Write] Force Sub Stepping: If true, forces sub-stepping to break up movement into discrete smaller steps to improve accuracy of the trajectory. Objects that move in a straight line typically do not need to set this, as movement always uses continuous collision detection (sweeps) so collision is not missed. Sub-stepping is automatically enabled when under the effects of gravity or when homing towards a target. see: MaxSimulationTimeStep, MaxSimulationIterations

  • is_editor_only (bool): [Read-Write] Is Editor Only: If true, the component will be excluded from non-editor builds

  • max_simulation_iterations (int32): [Read-Write] Max Simulation Iterations: Max number of iterations used for each discrete simulation step. Increasing this value can address issues with fast-moving objects or complex collision scenarios, at the cost of performance.

    WARNING: if (MaxSimulationTimeStep * MaxSimulationIterations) is too low for the min framerate, the last simulation step may exceed MaxSimulationTimeStep to complete the simulation. see: MaxSimulationTimeStep, bForceSubStepping

  • max_simulation_time_step (float): [Read-Write] Max Simulation Time Step: Max time delta for each discrete simulation step. Lowering this value can address issues with fast-moving objects or complex collision scenarios, at the cost of performance.

    WARNING: if (MaxSimulationTimeStep * MaxSimulationIterations) is too low for the min framerate, the last simulation step may exceed MaxSimulationTimeStep to complete the simulation. see: MaxSimulationIterations, bForceSubStepping

  • on_component_activated (ActorComponentActivatedSignature): [Read-Write] On Component Activated: Called when the component has been activated, with parameter indicating if it was from a reset

  • on_component_deactivated (ActorComponentDeactivateSignature): [Read-Write] On Component Deactivated: Called when the component has been deactivated

  • on_interp_to_reverse (OnInterpToReverseDelegate): [Read-Write] On Interp to Reverse: Called when InterpTo impacts something and reverse is enabled.

  • on_interp_to_stop (OnInterpToStopDelegate): [Read-Write] On Interp to Stop: Called when InterpTo has come to a stop.

  • on_reset_delegate (OnInterpToResetDelegate): [Read-Write] On Reset Delegate: Called when InterpTo reached the end and reset back to start .

  • on_wait_begin_delegate (OnInterpToWaitBeginDelegate): [Read-Write] On Wait Begin Delegate: Called when InterpTo has come to a stop but will resume when possible.

  • on_wait_end_delegate (OnInterpToWaitEndDelegate): [Read-Write] On Wait End Delegate: Called when InterpTo has resumed following a stop.

  • pause_on_impact (bool): [Read-Write] Pause on Impact: If true, will pause movement on impact. If false it will behave as if the end of the movement range was reached based on the BehaviourType.

  • plane_constraint_axis_setting (PlaneConstraintAxisSetting): [Read-Write] Plane Constraint Axis Setting: Setting that controls behavior when movement is restricted to a 2D plane defined by a specific axis/normal, so that movement along the locked axis is not be possible. see: SetPlaneConstraintAxisSetting

  • plane_constraint_normal (Vector): [Read-Write] Plane Constraint Normal: The normal or axis of the plane that constrains movement, if bConstrainToPlane is enabled. If for example you wanted to constrain movement to the X-Z plane (so that Y cannot change), the normal would be set to X=0 Y=1 Z=0. This is recalculated whenever PlaneConstraintAxisSetting changes. It is normalized once the component is registered with the game world. see: bConstrainToPlane, SetPlaneConstraintNormal(), SetPlaneConstraintFromVectors()

  • plane_constraint_origin (Vector): [Read-Write] Plane Constraint Origin: The origin of the plane that constrains movement, if plane constraint is enabled. This defines the behavior of snapping a position to the plane, such as by SnapUpdatedComponentToPlane(). see: bConstrainToPlane, SetPlaneConstraintOrigin().

  • primary_component_tick (ActorComponentTickFunction): [Read-Write] Primary Component Tick: Main tick function for the Component

  • replicates (bool): [Read-Write] Replicates: Is this component currently replicating? Should the network code consider it for replication? Owning Actor must be replicating first!

  • snap_to_plane_at_start (bool): [Read-Write] Snap to Plane at Start: If true and plane constraints are enabled, then the updated component will be snapped to the plane when first attached.

  • sweep (bool): [Read-Write] Sweep: If true, will sweep for blocking collision during movement. If false, it will simply teleport to the next position and ignore collision.

  • teleport_type (TeleportType): [Read-Write] Teleport Type: Physics teleport type.

  • tick_before_owner (bool): [Read-Write] Tick Before Owner: If true, after registration we will add a tick dependency to tick before our owner (if we can both tick). This is important when our tick causes an update in the owner’s position, so that when the owner ticks it uses the most recent position without lag. Disabling this can improve performance if both objects tick but the order of ticks doesn’t matter.

  • update_only_if_rendered (bool): [Read-Write] Update Only if Rendered: If true, skips TickComponent() if UpdatedComponent was not recently rendered.

  • updated_component (SceneComponent): [Read-Write] Updated Component: The component we move and update. If this is null at startup and bAutoRegisterUpdatedComponent is true, the owning Actor’s root component will automatically be set as our UpdatedComponent at startup. see: bAutoRegisterUpdatedComponent, SetUpdatedComponent(), UpdatedPrimitive

  • updated_primitive (PrimitiveComponent): [Read-Write] Updated Primitive: UpdatedComponent, cast as a UPrimitiveComponent. May be invalid if UpdatedComponent was null or not a UPrimitiveComponent.

  • velocity (Vector): [Read-Write] Velocity: Current velocity of updated component.

add_control_point_position(pos, position_is_relative=True) None

Add a control point that represents a position.

Parameters
  • pos (Vector) –

  • position_is_relative (bool) –

property behaviour_type

[Read-Write] Behaviour Type: Movement behaviour of the component

Type

(InterpToBehaviourType)

property check_if_still_in_world

[Read-Write] Check if Still in World: Do we want this comp to perform CheckStillInWorld checks?

Type

(bool)

property control_points

[Read-Write] Control Points: List of control points to visit.

Type

(Array(InterpControlPoint))

property duration

[Read-Write] Duration: How long to take to move from the first point to the last (or vice versa)

Type

(float)

finalise_control_points() None

Initialise the control points array. Call after adding control points if they are add after begin play .

property force_sub_stepping

[Read-Write] Force Sub Stepping: If true, forces sub-stepping to break up movement into discrete smaller steps to improve accuracy of the trajectory. Objects that move in a straight line typically do not need to set this, as movement always uses continuous collision detection (sweeps) so collision is not missed. Sub-stepping is automatically enabled when under the effects of gravity or when homing towards a target. see: MaxSimulationTimeStep, MaxSimulationIterations

Type

(bool)

property max_simulation_iterations

[Read-Write] Max Simulation Iterations: Max number of iterations used for each discrete simulation step. Increasing this value can address issues with fast-moving objects or complex collision scenarios, at the cost of performance.

WARNING: if (MaxSimulationTimeStep * MaxSimulationIterations) is too low for the min framerate, the last simulation step may exceed MaxSimulationTimeStep to complete the simulation. see: MaxSimulationTimeStep, bForceSubStepping

Type

(int32)

property max_simulation_time_step

[Read-Write] Max Simulation Time Step: Max time delta for each discrete simulation step. Lowering this value can address issues with fast-moving objects or complex collision scenarios, at the cost of performance.

WARNING: if (MaxSimulationTimeStep * MaxSimulationIterations) is too low for the min framerate, the last simulation step may exceed MaxSimulationTimeStep to complete the simulation. see: MaxSimulationIterations, bForceSubStepping

Type

(float)

property on_interp_to_reverse

[Read-Write] On Interp to Reverse: Called when InterpTo impacts something and reverse is enabled.

Type

(OnInterpToReverseDelegate)

property on_interp_to_stop

[Read-Write] On Interp to Stop: Called when InterpTo has come to a stop.

Type

(OnInterpToStopDelegate)

property on_reset_delegate

[Read-Write] On Reset Delegate: Called when InterpTo reached the end and reset back to start .

Type

(OnInterpToResetDelegate)

property on_wait_begin_delegate

[Read-Write] On Wait Begin Delegate: Called when InterpTo has come to a stop but will resume when possible.

Type

(OnInterpToWaitBeginDelegate)

property on_wait_end_delegate

[Read-Write] On Wait End Delegate: Called when InterpTo has resumed following a stop.

Type

(OnInterpToWaitEndDelegate)

property pause_on_impact

[Read-Write] Pause on Impact: If true, will pause movement on impact. If false it will behave as if the end of the movement range was reached based on the BehaviourType.

Type

(bool)

reset_control_points() None

Clear the control points array and set to stopped.

restart_movement(initial_direction=1.000000) None

Reset to start. Sets time to zero and direction to 1.

Parameters

initial_direction (float) –

stop_simulating(hit_result) None

Clears the reference to UpdatedComponent, fires stop event, and stops ticking.

Parameters

hit_result (HitResult) –

property sweep

[Read-Write] Sweep: If true, will sweep for blocking collision during movement. If false, it will simply teleport to the next position and ignore collision.

Type

(bool)

property teleport_type

[Read-Write] Teleport Type: Physics teleport type.

Type

(TeleportType)