unreal.PCapPropComponent

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

Bases: ActorComponent

A component for use in Motion Capture props. Accepts data as either a LiveLink Transform Role or an Animation Role. If the Live Link data is in the Animation role, this component will take the root bone transform and apply that transform to the owning actor’s root component. Can be applied to Static Meshes, Skeletal Meshes and Blueprint constructions. Transform data can be offset in the component’s local space. If this component is driving a Skeletal Mesh component and is receiving Live Link Animation data the full bone hierarchy will be applied.

C++ Source:

  • Plugin: PerformanceCaptureWorkflow

  • Module: PerformanceCaptureWorkflow

  • File: PCapPropComponent.h

Editor Properties: (see get_editor_property/set_editor_property)

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

  • asset_user_data_editor_only (Array[AssetUserData]): [Read-Write] Array of user data stored with the component

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

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

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

  • controlled_component (ComponentReference): [Read-Write] Scene Component driven by the LiveLink data. Defaults to Root component of the owning actor.

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

  • evaluate_live_link (bool): [Read-Write] Should LiveLink Subject data be evaluated.

  • is_controlled_by_sequencer (bool): [Read-Write] Overrides all LiveLink data and offset transform. Must be manually set on possessable bindings.

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

  • offset_transform (Transform): [Read-Write] Offset the incoming LiveLink Transform data in the local space of the controlled component.

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

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

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

  • replicate_using_registered_sub_object_list (bool): [Read-Write] When true the replication system will only replicate the registered subobjects list When false the replication system will instead call the virtual ReplicateSubObjects() function where the subobjects need to be manually replicated.

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

  • spawning_data_asset (Name): [Read-Write] The package name of the spawning data asset, if there is one.

  • subject_name (LiveLinkSubjectName): [Read-Write] LiveLink Subject Name. Must have either Animation Role Type.

get_controlled_component() → SceneComponent

Returns the component controlled by this component. Can return null.

Return type:

SceneComponent

Get the LiveLink Evaluation State. Subject must have the Animation Role Type.

Returns:

bool Is LiveLink data being evaluated.

Return type:

bool

Get the LiveLink Subject Name.

Returns:

FLiveLinkSubjectName Current LiveLink Subject.

Return type:

LiveLinkSubjectName

property is_controlled_by_sequencer: bool

[Read-Only] Overrides all LiveLink data and offset transform. Must be manually set on possessable bindings.

Type:

(bool)

property offset_transform: Transform

[Read-Only] Offset the incoming LiveLink Transform data in the local space of the controlled component.

Type:

(Transform)

set_controlled_component(component) → None

Sets the component controlled by this component. Component must be within the same actor as this Prop component.

Parameters:

component (SceneComponent)

Set the LiveLink data to update the Skeletal Mesh pose.

Parameters:

evaluate_link_link (bool) – Drive or pause the Controlled Mesh from LiveLink Subject data.

Set Live Link Subject

Parameters:

subject (LiveLinkSubjectName)

set_offset_transform(new_offset) → None

Update the local space offset to this prop’s Live Link pose.

Parameters:

new_offset (Transform) – Offset Transform.

property spawning_data_asset: Name

[Read-Only] The package name of the spawning data asset, if there is one.

Type:

(Name)