unreal.TargetingSelectionTask_Trace

class unreal.TargetingSelectionTask_Trace(outer: Object | None = None, name: Name | str = 'None')

Bases: TargetingTask

class: UTargetingSelectionTask_Trace Selection task that can perform a synchronous or asynchronous trace (line/sweep) to find all targets up to the first blocking hit (or its end point).

C++ Source:

  • Plugin: TargetingSystem

  • Module: TargetingSystem

  • File: TargetingSelectionTask_Trace.h

Editor Properties: (see get_editor_property/set_editor_property)

  • collision_profile_name (CollisionProfileName): [Read-Write] The collision profile name to use instead of trace channel (does not work for async traces)

  • complex_trace (bool): [Read-Write] Indicates the trace should perform a complex trace

  • default_source_offset (Vector): [Read-Write] The default source location offset used by GetSourceOffset

  • default_swept_trace_box_half_extent_x (ScalableFloat): [Read-Write] The default swept extents used by GetSweptTraceExtents when the trace type is set to Box

  • default_swept_trace_box_half_extent_y (ScalableFloat): [Read-Write] The default swept extents used by GetSweptTraceBoxHalfExtents when the trace type is set to Box

  • default_swept_trace_box_half_extent_z (ScalableFloat): [Read-Write] The default swept extents used by GetSweptTraceBoxHalfExtents when the trace type is set to Box

  • default_swept_trace_capsule_half_height (ScalableFloat): [Read-Write] The default swept trace radius used by GetSweptTraceRadius when the trace type is set to Capsule

  • default_swept_trace_radius (ScalableFloat): [Read-Write] The default swept trace radius used by GetSweptTraceRadius when the trace type is set to Sphere or Capsule

  • default_swept_trace_rotation (Rotator): [Read-Write] The default swept rotation (relative to the trace direction) used by GetSweptTraceRotation when the trace type is set to Capsule or Box

  • default_trace_length (ScalableFloat): [Read-Write] The default trace length to use if GetTraceLength is not overridden by a child

  • explicit_trace_direction (Vector): [Read-Write] An explicit trace direction to use (default uses pawn control rotation or actor forward vector in GetTraceDirection)

  • ignore_instigator_actor (bool): [Read-Write] Indicates the trace should ignore the source actor

  • ignore_source_actor (bool): [Read-Write] Indicates the trace should ignore the source actor

  • trace_channel (TraceTypeQuery): [Read-Write] The trace channel to use

  • trace_type (TargetingTraceType): [Read-Write] The trace type (i.e. shape) to use

get_additional_actors_to_ignore(targeting_handle) Array[Actor]

Native Event to get additional actors the Trace should ignore

Parameters:

targeting_handle (TargetingRequestHandle) –

Returns:

out_additional_actors_to_ignore (Array[Actor]):

Return type:

Array[Actor]

get_source_location(targeting_handle) Vector

Native Event to get the source location for the Trace

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

Vector

get_source_offset(targeting_handle) Vector

Native Event to get a source location offset for the Trace

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

Vector

get_swept_trace_box_half_extents(targeting_handle) Vector

Native Event to get the swept box trace half extents (only called if TraceType = ETargetingTraceType::Box)

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

Vector

get_swept_trace_capsule_half_height(targeting_handle) float

Native Event to get the swept trace capsule’s half height (only called if TraceType = ETargetingTraceType::Capsule)

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

float

get_swept_trace_radius(targeting_handle) float

Native Event to get the swept trace radius (only called if TraceType = ETargetingTraceType::Sphere or TraceType = ETargetingTraceType::Capsule)

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

float

get_swept_trace_rotation(targeting_handle) Rotator
Native Event to get the swept trace rotation relative to trace direction

(only called if TraceType = ETargetingTraceType::Capsule or TraceType = ETargetingTraceType::Box)

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

Rotator

get_trace_direction(targeting_handle) Vector

Native Event to get the direction for the Trace

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

Vector

get_trace_length(targeting_handle) float

Native Event to get the length for the Trace

Parameters:

targeting_handle (TargetingRequestHandle) –

Return type:

float