unreal.CustomizableObjectInstance

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

Bases: Object

Customizable Object Instance

C++ Source:

  • Plugin: Mutable

  • Module: CustomizableObject

  • File: CustomizableObjectInstance.h

Editor Properties: (see get_editor_property/set_editor_property)

  • begin_destroy_delegate (BeginDestroyDelegate): [Read-Write] Broadcast when UObject::BeginDestroy is being called.

  • begin_update_delegate (BeginUpdateDelegate): [Read-Write] Broadcast at the beginning of an Instance update.

  • skeletal_meshes (Array[SkeletalMesh]): [Read-Only] The generated skeletal meshes for this Instance, one for each component

  • texture_parameter_declarations (Array[Texture2D]): [Read-Write] Textures used in the Texture Parameters.

  • updated_delegate (ObjectInstanceUpdatedDelegate): [Read-Write] Broadcast when the Customizable Object Instance is updated.

add_value_to_float_range(param_name) → int32

Increases the range of values of the float with ParamName, returns the index of the new float value, -1 otherwise. The added value is initialized with 0.5f and is the last one of the range.

Parameters:

param_name (str) –

Return type:

int32

add_value_to_int_range(param_name) → int32

Increases the range of values of the integer with ParamName, returns the index of the new integer value, -1 otherwise. The added value is initialized with the first integer option and is the last one of the range.

Parameters:

param_name (str) –

Return type:

int32

add_value_to_projector_range(param_name) → int32

Increases the range of values of the projector with ParamName, returns the index of the new projector value, -1 otherwise. The added value is initialized with the default projector as set up in the editor and is the last one of the range.

Parameters:

param_name (str) –

Return type:

int32

property begin_destroy_delegate: BeginDestroyDelegate

[Read-Write] Broadcast when UObject::BeginDestroy is being called.

Type:

(BeginDestroyDelegate)

property begin_update_delegate: BeginUpdateDelegate

[Read-Write] Broadcast at the beginning of an Instance update.

Type:

(BeginUpdateDelegate)

clone() → CustomizableObjectInstance

Clones the instance creating a new identical transient instance.

Return type:

CustomizableObjectInstance

clone_static(outer) → CustomizableObjectInstance

Clones the instance creating a new identical static instance.

Parameters:

outer (Object) –

Return type:

CustomizableObjectInstance

create_multi_layer_projector(projector_param_name) → bool

Given Multilayer Projector name, create a new Multilayer Projector Helper (if non-existent). See FMultilayerProjector.

Parameters:

projector_param_name (Name) –

Returns:

ture if successfully created (or was already created).

Return type:

bool

find_bool_parameter_name_index(param_name) → int32

Finds in BoolParameters a parameter with name ParamName, returns the index if found, -1 otherwise

Parameters:

param_name (str) –

Return type:

int32

find_float_parameter_name_index(param_name) → int32

Finds in FloatParameters a parameter with name ParamName, returns the index if found, -1 otherwise

Parameters:

param_name (str) –

Return type:

int32

find_int_parameter_name_index(param_name) → int32

Finds in IntParameters a parameter with name ParamName, returns the index if found, -1 otherwise

Parameters:

param_name (str) –

Return type:

int32

find_projector_parameter_name_index(param_name) → int32

Finds in ProjectorParameters a parameter with name ParamName, returns the index if found, -1 otherwise

Parameters:

param_name (str) –

Return type:

int32

find_vector_parameter_name_index(param_name) → int32

Finds in VectorParameters a parameter with name ParamName, returns the index if found, -1 otherwise

Parameters:

param_name (str) –

Return type:

int32

for_each_anim_instance(component_index, delegate) → None

For Each Anim Instance

Parameters:
get_anim_bp(component_index, slot_index)

Returns the animation BP for the parameter component and slot, gathered from all the meshes that compose this instance

Parameters:

  • component_index (int32) –

  • slot_index (int32) –

Return type:

type(Class)

get_animation_gameplay_tags() → GameplayTagContainer

Get Animation Gameplay Tags

Return type:

GameplayTagContainer

get_bool_parameter_selected_option(bool_param_name) → bool

Sets the bool value “BoolValue” of a bool parameter with name “BoolParamName”

Parameters:

bool_param_name (str) –

Return type:

bool

get_bool_parameters() → Array[CustomizableObjectBoolParameterValue]

Get Bool Parameters

Return type:

Array[CustomizableObjectBoolParameterValue]

get_build_parameter_decorations() → bool

Get Build Parameter Decorations

Return type:

bool

get_color_parameter_selected_option(color_param_name) → LinearColor

Gets the value of a color parameter with name “ColorParamName”

Parameters:

color_param_name (str) –

Return type:

LinearColor

get_current_state() → str

Get Current State

Return type:

str

get_customizable_object() → CustomizableObject

Get the current CustomizableObject

Return type:

CustomizableObject

get_float_parameter_selected_option(float_param_name, range_index=-1) → float

Gets the value of a float parameter with name “FloatParamName”

Parameters:

  • float_param_name (str) –

  • range_index (int32) –

Return type:

float

get_float_parameters() → Array[CustomizableObjectFloatParameterValue]

Get Float Parameters

Return type:

Array[CustomizableObjectFloatParameterValue]

get_int_parameter_selected_option(param_name, range_index=-1) → str

DEPRECATED: Use the method in the CustomizableObject instead which takes an index among all parameters Gets the Name of the option at position K in the list of available options for the int parameter. Useful to enumerate the int parameter’s possible options (Ex: “Hat1”, “Hat2”, “Cap”, “Nothing”) const FString& GetIntParameterAvailableOption(int32 IntParamIndex, int32 K);

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

str

get_int_parameters() → Array[CustomizableObjectIntParameterValue]

Get Int Parameters

Return type:

Array[CustomizableObjectIntParameterValue]

get_parameter_description(param_name, desc_index) → Texture2D

Returns de description texture (ex: color bar) for this parameter and DescIndex This will only be valid if bBuildParameterDecorations was set to true before the last update.

Parameters:

  • param_name (str) –

  • desc_index (int32) –

Return type:

Texture2D

get_projector_angle(param_name, range_index=-1) → float

Get the current cylindrical projector angle for the parameter with the given name

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

float

get_projector_direction(param_name, range_index=-1) → Vector

Get the current projector direction vector for the parameter with the given name

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

Vector

get_projector_parameter_type(param_name, range_index=-1) → CustomizableObjectProjectorType

Get the current projector type for the parameter with the given name

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

CustomizableObjectProjectorType

get_projector_parameters() → Array[CustomizableObjectProjectorParameterValue]

Get Projector Parameters

Return type:

Array[CustomizableObjectProjectorParameterValue]

get_projector_position(param_name, range_index=-1) → Vector

Get the current projector position for the parameter with the given name

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

Vector

get_projector_scale(param_name, range_index=-1) → Vector

Get the current projector scale for the parameter with the given name

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

Vector

get_projector_up(param_name, range_index=-1) → Vector

Get the current projector up vector for the parameter with the given name

Parameters:

  • param_name (str) –

  • range_index (int32) –

Return type:

Vector

get_projector_value(projector_param_name, range_index=-1) -> (out_pos=Vector, out_direction=Vector, out_up=Vector, out_scale=Vector, out_angle=float, out_type=CustomizableObjectProjectorType)

Get the projector values of a projector parameter with index “ProjectorParamIndex”

Parameters:

  • projector_param_name (str) –

  • range_index (int32) –

Returns:

out_pos (Vector):

out_direction (Vector):

out_up (Vector):

out_scale (Vector):

out_angle (float):

out_type (CustomizableObjectProjectorType):

Return type:

tuple

get_projector_value_range(param_name) → int32

Get Projector Value Range

Parameters:

param_name (str) –

Return type:

int32

get_skeletal_mesh(component_index=0) → SkeletalMesh

Get Skeletal Mesh

Parameters:

component_index (int32) –

Return type:

SkeletalMesh

get_texture_parameter_selected_option_t(texture_param_name, range_index=-1) → Texture2D

Gets the texture of a texture parameter with name “TextureParamName”.

Parameters:

  • texture_param_name (str) –

  • range_index (int32) –

Return type:

Texture2D

get_texture_parameters() → Array[CustomizableObjectTextureParameterValue]

Get Texture Parameters

Return type:

Array[CustomizableObjectTextureParameterValue]

get_vector_parameters() → Array[CustomizableObjectVectorParameterValue]

Get Vector Parameters

Return type:

Array[CustomizableObjectVectorParameterValue]

has_any_parameters() → bool

See FCustomizableObjectInstanceDescriptor::HasAnyParameters.

Return type:

bool

has_any_skeletal_mesh() → bool

Has Any Skeletal Mesh

Return type:

bool

is_param_multidimensional(param_name) → bool

Is Param Multidimensional

Parameters:

param_name (str) –

Return type:

bool

is_parameter_relevant(param_name) → bool

! This is only valid if bBuildParameterDecorations has been set before the last update.

Parameters:

param_name (str) –

Return type:

bool

multilayer_projector_create_layer(projector_param_name, index) → None

See FMultilayerProjector::CreateLayer.

Parameters:

  • projector_param_name (Name) –

  • index (int32) –

multilayer_projector_create_virtual_layer(projector_param_name, id) → None

See FMultilayerProjector::VirtualLayer.

Parameters:

  • projector_param_name (Name) –

  • id (Name) –

multilayer_projector_find_or_create_virtual_layer(projector_param_name, id) → MultilayerProjectorVirtualLayer

See FMultilayerProjector::FindOrCreateVirtualLayer.

Parameters:

  • projector_param_name (Name) –

  • id (Name) –

Return type:

MultilayerProjectorVirtualLayer

multilayer_projector_get_layer(projector_param_name, index) → MultilayerProjectorLayer

See FMultilayerProjector::GetLayer.

Parameters:

  • projector_param_name (Name) –

  • index (int32) –

Return type:

MultilayerProjectorLayer

multilayer_projector_get_virtual_layer(projector_param_name, id) → MultilayerProjectorVirtualLayer

See FMultilayerProjector::GetVirtualLayer.

Parameters:

  • projector_param_name (Name) –

  • id (Name) –

Return type:

MultilayerProjectorVirtualLayer

multilayer_projector_get_virtual_layers(projector_param_name) → Array[Name]

See FMultilayerProjector::GetVirtualLayers.

Parameters:

projector_param_name (Name) –

Return type:

Array[Name]

multilayer_projector_num_layers(projector_param_name) → int32

See FMultilayerProjector::NumLayers.

Parameters:

projector_param_name (Name) –

Return type:

int32

multilayer_projector_remove_layer_at(projector_param_name, index) → None

See FMultilayerProjector::RemoveLayerAt.

Parameters:

  • projector_param_name (Name) –

  • index (int32) –

multilayer_projector_remove_virtual_layer(projector_param_name, id) → None

See FMultilayerProjector::RemoveVirtualLayer.

Parameters:

  • projector_param_name (Name) –

  • id (Name) –

multilayer_projector_update_layer(projector_param_name, index, layer) → None

See FMultilayerProjector::UpdateLayer.

Parameters:
multilayer_projector_update_virtual_layer(projector_param_name, id, layer) → None

See FMultilayerProjector::UpdateVirtualLayer.

Parameters:
remove_multilayer_projector(projector_param_name) → None

Given Multilayer Projector name, remove a Multilayer Projector Helper. See FMultilayerProjector.

Parameters:

projector_param_name (Name) –

remove_value_from_float_range(param_name) → int32

Remove the last of the float range of values from the parameter ParamName, returns the index of the last valid float, -1 if no values left.

Parameters:

param_name (str) –

Return type:

int32

remove_value_from_int_range(param_name) → int32

Remove the last of the integer range of values from the parameter ParamName, returns the index of the last valid integer, -1 if no values left.

Parameters:

param_name (str) –

Return type:

int32

remove_value_from_projector_range(param_name) → int32

Remove the last of the projector range of values from the parameter ParamName, returns the index of the last valid projector, -1 if no values left.

Parameters:

param_name (str) –

Return type:

int32

set_bool_parameter_selected_option(bool_param_name, bool_value) → None

Sets the bool value “BoolValue” of a bool parameter with name “BoolParamName”

Parameters:

  • bool_param_name (str) –

  • bool_value (bool) –

set_build_parameter_decorations(value) → None

Set Build Parameter Decorations

Parameters:

value (bool) –

set_color_parameter_selected_option(color_param_name, color_value) → None

Sets the color value “ColorValue” of a color parameter with index “ColorParamIndex”

Parameters:
set_current_state(state_name) → None

Set Current State

Parameters:

state_name (str) –

set_float_parameter_selected_option(float_param_name, float_value, range_index=-1) → None

Sets the float value “FloatValue” of a float parameter with index “FloatParamIndex”

Parameters:

  • float_param_name (str) –

  • float_value (float) –

  • range_index (int32) –

set_int_parameter_selected_option(param_name, selected_option_name, range_index=-1) → None

Sets the selected option of an int parameter, by the option’s name

Parameters:

  • param_name (str) –

  • selected_option_name (str) –

  • range_index (int32) –

set_object(object) → None

Set Object

Parameters:

object (CustomizableObject) –

set_projector_value(projector_param_name, out_pos, out_direction, out_up, out_scale, out_angle, range_index=-1) → None

Sets the projector values of a projector parameter with index “ProjectorParamIndex”

Parameters:

  • projector_param_name (str) –

  • out_pos (Vector) –

  • out_direction (Vector) –

  • out_up (Vector) –

  • out_scale (Vector) –

  • out_angle (float) –

  • range_index (int32) –

set_random_values() → None

! Set random values to the parameters. Useful for testing only.

set_replace_physics_assets(replace_enabled) → None

Enable physics asset replacement so that generated skeletal meshes have the merged physics assets of their skeletal mesh parts and reference mesh

Parameters:

replace_enabled (bool) –

set_texture_parameter_selected_option_t(texture_param_name, texture_value, range_index=-1) → None

Sets the texture “Texture” of a texture parameter with index “TextureParamIndex”.

Parameters:

  • texture_param_name (str) –

  • texture_value (Texture2D) –

  • range_index (int32) –

set_vector_parameter_selected_option(vector_param_name, vector_value) → None

Sets the vector value “VectorValue” of a bool parameter with index “VectorParamIndex”

Parameters:
update_skeletal_mesh_async(ignore_close_dist=False, force_high_priority=False) → None

Update Skeletal Mesh Async

Parameters:

  • ignore_close_dist (bool) –

  • force_high_priority (bool) –

property updated_delegate: ObjectInstanceUpdatedDelegate

[Read-Write] Broadcast when the Customizable Object Instance is updated.

Type:

(ObjectInstanceUpdatedDelegate)