unreal.DMXEntityFixturePatch

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

Bases: unreal.DMXEntity

A DMX fixture patch that can be patch to channels in a DMX Universe via the DMX Library Editor.

Use in DMXComponent or call SetReceiveDMXEnabled with ‘true’ to enable receiving DMX.

C++ Source:

  • Plugin: DMXEngine

  • Module: DMXRuntime

  • File: DMXEntityFixturePatch.h

Editor Properties: (see get_editor_property/set_editor_property)

  • active_mode (int32): [Read-Write] The fixture type mode the patch should use

  • auto_assign_address (bool): [Read-Write] Auto-assign address from drag/drop list order and available channels

  • custom_tags (Array(Name)): [Read-Write] Custom tags for filtering patches

  • editor_color (LinearColor): [Read-Write] Color when displayed in the fixture patch editor

  • manual_starting_address (int32): [Read-Write] Starting channel for when auto-assign address is false

  • name (str): [Read-Write] Name

  • on_fixture_patch_received_dmx (DMXOnFixturePatchReceivedDMXDelegate): [Read-Write] Broadcasts when the patch received dmx

  • parent_fixture_type_template (DMXEntityFixtureType): [Read-Only] Property to point to the template parent fixture for details panel purposes

  • receive_dmx_in_editor (bool): [Read-Write] If true, the patch receives dmx and raises the OnFixturePatchReceivedDMX event in editor. Note: DMXComponent does not support this. To receive the patch in editor, drag out from the patch and bind its OnFixturePatchReceivedDMX event.

  • universe_id (int32): [Read-Write] The local universe of the patch

property active_mode

[Read-Only] The fixture type mode the patch should use

Type

(int32)

property auto_assign_address

[Read-Only] Auto-assign address from drag/drop list order and available channels

Type

(bool)

contains_attribute(function_attribute) → bool

Return if fixture contains function.

Parameters

function_attribute (DMXAttributeName) –

Returns

Return type

bool

convert_attribute_map_to_raw_map(function_map)

Return map of function channels and their values. Functions outside the Active Mode’s channel span range are ignored.

Parameters

function_map (Map(DMXAttributeName, int32)) –

Returns

Return type

Map(int32, uint8)

convert_raw_map_to_attribute_map(raw_map)

Given a <Channel Index -> Raw Value> map , return map of function names and their values.

Parameters

raw_map (Map(int32, uint8)) –

Returns

Return type

Map(DMXAttributeName, int32)

convert_to_valid_map(function_map)

Return a map that is valid for this fixture.

Parameters

function_map (Map(DMXAttributeName, int32)) –

Returns

Return type

Map(DMXAttributeName, int32)

property custom_tags

[Read-Only] Custom tags for filtering patches

Type

(Array(Name))

property editor_color

[Read-Only] Color when displayed in the fixture patch editor

Type

(LinearColor)

get_all_attributes_in_active_mode()

Return an array of valid attributes for the currently active mode. Attributes outside the Active Mode’s channel span range are ignored.

Returns

Return type

Array(DMXAttributeName)

get_all_matrix_cells() → Array(DMXCell) or None

Get array of all cells and associated data.

Returns

cells (Array(DMXCell)):

Return type

Array(DMXCell) or None

get_attribute_channel_assignments()

Return map of Attributes and their assigned channels

Returns

Return type

Map(DMXAttributeName, int32)

get_attribute_default_map()

Return map of function names and default values. Functions outside the Active Mode’s channel span range are ignored.

Returns

Return type

Map(DMXAttributeName, int32)

get_attribute_functions_map()

Return map of attributes and function names. Attributes outside the Active Mode’s channel span range are ignored.

Returns

Return type

Map(DMXAttributeName, DMXFixtureFunction)

get_attribute_signal_formats()

Return map of function names and their Data Types. Functions outside the Active Mode’s channel span range are ignored.

Returns

Return type

Map(DMXAttributeName, DMXFixtureSignalFormat)

get_attribute_value(attribute) -> (int32, success=bool)

Retrieve the value of an Attribute. Will fail and return 0 if the Attribute doesn’t exist.

Parameters

attribute (DMXAttributeName) – The Attribute to try to get the value from.

Returns

The value of the Function mapped to the selected Attribute, if found.

success (bool): Whether the Attribute was found in this Fixture Patch

Return type

bool

get_attributes_values()

Returns the value of each attribute, or zero if no value was ever received.

Returns

attributes_values (Map(DMXAttributeName, int32)): Out: Resulting map of Attributes with their values

Return type

Map(DMXAttributeName, int32)

get_cell_attributes() → Array(DMXAttributeName) or None

Get all attributes for the fixture patch.

Returns

cell_attributes (Array(DMXAttributeName)):

Return type

Array(DMXAttributeName) or None

get_channel_span() → int32

Returns the number of channels this Patch occupies with the Fixture functions from its Active Mode or 0 if the patch has no valid Active Mode.

Returns

Return type

int32

get_ending_channel() → int32

Get Ending Channel

Returns

Return type

int32

get_matrix_cell(cell_coordinate) → DMXCell or None

Cell coordinate X/Y

Parameters

cell_coordinate (IntPoint) –

Returns

cell (DMXCell):

Return type

DMXCell or None

get_matrix_cell_channels_absolute(cell_coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y

Parameters

cell_coordinate (IntPoint) –

Returns

attribute_channel_map (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_cell_channels_absolute_with_validation(cell_coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y

Parameters

cell_coordinate (IntPoint) –

Returns

out_attribute_channel_map (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_cell_channels_relative(cell_coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y

Parameters

cell_coordinate (IntPoint) –

Returns

attribute_channel_map (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_cell_values(cell_coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y

Parameters

cell_coordinate (IntPoint) –

Returns

value_per_attribute (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_properties() → DMXFixtureMatrix or None

Get Matrix Fixture properties

Returns

matrix_properties (DMXFixtureMatrix):

Return type

DMXFixtureMatrix or None

get_normalized_attribute_value(attribute) -> (float, success=bool)

Retrieve the normalized value of an Attribute. Will fail and return 0 if the Attribute doesn’t exist. deprecated: Deprecated 4.26. Use GetNormalizedAttributeValue instead. Note, new method returns normalized values!

Parameters

attribute (DMXAttributeName) – The Attribute to try to get the value from.

Returns

The value of the Function mapped to the selected Attribute, if found.

success (bool): Whether the Attribute was found in this Fixture Patch

Return type

bool

get_normalized_attributes_values() → DMXNormalizedAttributeValueMap

Returns the normalized value of each attribute, or zero if no value was ever received.

Returns

normalized_attributes_values (DMXNormalizedAttributeValueMap):

Return type

DMXNormalizedAttributeValueMap

get_normalized_matrix_cell_values(cell_coordinate) → Map(DMXAttributeName, float) or None

Cell coordinate X/Y

Parameters

cell_coordinate (IntPoint) –

Returns

normalized_value_per_attribute (Map(DMXAttributeName, float)):

Return type

Map(DMXAttributeName, float) or None

get_relevant_controllers()

Get Relevant Controllers deprecated: Deprecated 4.27. Controllers are replaced with DMX Ports.

Returns

Return type

Array(DMXEntityController)

get_remote_universe() → int32

Get Remote Universe deprecated: Deprecated 4.27. Controllers are replaced with DMX Ports.

Returns

Return type

int32

get_starting_channel() → int32

Return the active starting channel, evaluated after checking if Auto-Assignment is activated.

Returns

Return type

int32

is_in_controller_range(controller) → bool

Is in Controller Range deprecated: Deprecated 4.27. Controllers are replaced with DMX Ports.

Parameters

controller (DMXEntityController) –

Returns

Return type

bool

is_in_controllers_range(controllers) → bool

Is in Controllers Range deprecated: Deprecated 4.27. Controllers are replaced with DMX Ports.

Parameters

controllers (Array(DMXEntityController)) –

Returns

Return type

bool

is_map_valid(function_map) → bool

Return if given function map is valid for this fixture.

Parameters

function_map (Map(DMXAttributeName, int32)) –

Returns

Return type

bool

property on_fixture_patch_received_dmx

[Read-Write] Broadcasts when the patch received dmx

Type

(DMXOnFixturePatchReceivedDMXDelegate)

property parent_fixture_type_template

[Read-Only] Property to point to the template parent fixture for details panel purposes

Type

(DMXEntityFixtureType)

property receive_dmx_in_editor

[Read-Only] If true, the patch receives dmx and raises the OnFixturePatchReceivedDMX event in editor. Note: DMXComponent does not support this. To receive the patch in editor, drag out from the patch and bind its OnFixturePatchReceivedDMX event.

Type

(bool)

send_dmx(attribute_map) → None

Send DMX using attribute names and integer values.

Parameters

attribute_map (Map(DMXAttributeName, int32)) –

send_matrix_cell_value(cell_coordinate, attribute, value) → bool

Cell coordinate X/Y

Parameters
Returns

Return type

bool

send_matrix_cell_value_with_attribute_map(cell_coordinate, attribute, value, attribute_name_channel_map) → bool

Cell coordinate X/Y

Parameters
Returns

Return type

bool

send_normalized_matrix_cell_value(cell_coordinate, attribute, relative_value) → bool

Cell coordinate X/Y

Parameters
Returns

Return type

bool

property universe_id

[Read-Only] The local universe of the patch

Type

(int32)