unreal.DMXSubsystem

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

Bases: unreal.EngineSubsystem

UDMXSubsystem Collections of DMX context blueprint subsystem functions and internal functions for DMX K2Nodes

C++ Source:

• Plugin: DMXEngine

• Module: DMXRuntime

• File: DMXSubsystem.h

Editor Properties: (see get_editor_property/set_editor_property)

• on_protocol_received (ProtocolReceivedDelegate): [Read-Write] On Protocol Received deprecated: WARNING: This can execute faster than tick leading to possible blueprint performance issues. Use DMXComponent’s OnFixturePatchReceived event or GetRawBuffer instead.

bytes_to_int(bytes, use_lsb=False) → int32

Return integer given an array of bytes. Up to the first 4 bytes in the array will be used for the conversion.

Parameters

• bytes (Array(uint8)) –

• use_lsb (bool) – Least Significant Byte mode makes the individual bytes (channels) of the function be interpreted with the first bytes being the lowest part of the number. Most Fixtures use MSB (Most Significant Byte).

Returns

Return type

int32

bytes_to_normalized_value(bytes, use_lsb=False) → float

Return normalized value given an array of bytes. Up to the first 4 bytes in the array will be used for the conversion.

Parameters

• bytes (Array(uint8)) –

• use_lsb (bool) – Least Significant Byte mode makes the individual bytes (channels) of the function be interpreted with the first bytes being the lowest part of the number. Most Fixtures use MSB (Most Significant Byte).

Returns

Return type

float

get_all_controllers_in_library(dmx_library)

Return reference to array of Controller objects in library.

Parameters

dmx_library (DMXLibrary) –

Returns

Return type

Array(DMXEntityController)

get_all_dmx_libraries()

Return reference to array of DMX Library objects.

Returns

Return type

Array(DMXLibrary)

get_all_fixture_types_in_library(dmx_library)

Return reference to array of Fixture Types objects in library.

Parameters

dmx_library (DMXLibrary) –

Returns

Return type

Array(DMXEntityFixtureType)

get_all_fixtures_in_library(dmx_library)

Return reference to array of Fixture Patch objects in library.

Parameters

dmx_library (DMXLibrary) –

Returns

Return type

Array(DMXEntityFixturePatch)

get_all_fixtures_in_universe(dmx_library, universe_id)

Return reference to array of Fixture Patch objects in a given universe.

Parameters

• dmx_library (DMXLibrary) –

• universe_id (int32) –

Returns

out_result (Array(DMXEntityFixturePatch)):

Return type

Array(DMXEntityFixturePatch)

get_all_fixtures_of_category(dmx_library, category)

Return reference to array of Fixture Patch objects of a given category.

Parameters

• dmx_library (DMXLibrary) –

• category (DMXFixtureCategory) –

Returns

out_result (Array(DMXEntityFixturePatch)):

Return type

Array(DMXEntityFixturePatch)

get_all_fixtures_of_type(fixture_type)

Return reference to array of Fixture Patch objects of a given type.

Parameters

fixture_type (DMXEntityFixtureTypeRef) –

Returns

out_result (Array(DMXEntityFixturePatch)):

Return type

Array(DMXEntityFixturePatch)

get_all_fixtures_with_tag(dmx_library, custom_tag)

Return reference to array of Fixture Patch objects with a given tag.

Parameters

• dmx_library (DMXLibrary) –

• custom_tag (Name) –

Returns

Return type

Array(DMXEntityFixturePatch)

get_all_matrix_cells(fixture_patch) → Array(DMXCell) or None

Get array of all cells and associated data. deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetAllMatrixCells instead

Parameters

fixture_patch (DMXEntityFixturePatch) –

Returns

cells (Array(DMXCell)):

Return type

Array(DMXCell) or None

get_all_matrix_pixels(fixture_patch)

deprecated: ‘get_all_matrix_pixels’ was renamed to ‘get_all_matrix_cells’.

get_all_universes_in_controller(dmx_library, controller_name)

Return reference to array of Fixture Patch objects in a given controller.

Parameters

• dmx_library (DMXLibrary) –

• controller_name (str) –

Returns

out_result (Array(int32)):

Return type

Array(int32)

get_attribute_label(attribute_name) → Name

Gets the FName for a FDMXAttributeName, since structs can’t have UFUCNTIONS to create a getter

Parameters

attribute_name (DMXAttributeName) – the struct we want to grab the name from

Returns

FName the name of the AttributeName

Return type

Name

get_cell_attributes(fixture_patch) → Array(DMXAttributeName) or None

Get all attributes for the fixture patch. deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetCellAttributes instead

Parameters

fixture_patch (DMXEntityFixturePatch) –

Returns

cell_attributes (Array(DMXAttributeName)):

Return type

Array(DMXAttributeName) or None

get_controller_by_name(dmx_library, name) → DMXEntityController

Return reference to Controller object with a given name.

Parameters

• dmx_library (DMXLibrary) –

• name (str) –

Returns

Return type

DMXEntityController

get_fixture_attributes(fixture_patch, dmx_buffer)

Return map with all DMX functions and their associated values given DMX buffer and desired universe.

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• dmx_buffer (Array(uint8)) –

Returns

out_result (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32)

get_fixture_by_name(dmx_library, name) → DMXEntityFixturePatch

Return reference to Fixture Patch object with a given name.

Parameters

• dmx_library (DMXLibrary) –

• name (str) –

Returns

Return type

DMXEntityFixturePatch

get_fixture_type_by_name(dmx_library, name) → DMXEntityFixtureType

Return reference to Fixture Type object with a given name.

Parameters

• dmx_library (DMXLibrary) –

• name (str) –

Returns

Return type

DMXEntityFixtureType

get_matrix_cell(fixture_patch, coordinate) → DMXCell or None

Cell coordinate X/Y deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetMatrixCell instead

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• coordinate (IntPoint) –

Returns

cell (DMXCell):

Return type

DMXCell or None

get_matrix_cell_channels_absolute(fixture_patch, coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetMatrixCellChannelsAbsolute instead

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• coordinate (IntPoint) –

Returns

attribute_channel_map (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_cell_channels_relative(fixture_patch, coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetMatrixCellChannelsRelative instead

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• coordinate (IntPoint) –

Returns

attribute_channel_map (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_cell_value(fixture_patch, coordinate) → Map(DMXAttributeName, int32) or None

Cell coordinate X/Y deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetMatrixCellValues instead

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• coordinate (IntPoint) –

Returns

attribute_value_map (Map(DMXAttributeName, int32)):

Return type

Map(DMXAttributeName, int32) or None

get_matrix_pixel(fixture_patch, coordinate)

deprecated: ‘get_matrix_pixel’ was renamed to ‘get_matrix_cell’.

get_matrix_pixel_channels_absolute(fixture_patch, coordinate)

deprecated: ‘get_matrix_pixel_channels_absolute’ was renamed to ‘get_matrix_cell_channels_absolute’.

get_matrix_pixel_channels_relative(fixture_patch, coordinate)

deprecated: ‘get_matrix_pixel_channels_relative’ was renamed to ‘get_matrix_cell_channels_relative’.

get_matrix_pixel_value(fixture_patch, coordinate)

deprecated: ‘get_matrix_pixel_value’ was renamed to ‘get_matrix_cell_value’.

get_matrix_properties(fixture_patch) → DMXFixtureMatrix or None

Get Matrix Fixture properties deprecated: Deprecated 4.26. DMXEntityFixurePatch::GetMatrixProperties instead

Parameters

fixture_patch (DMXEntityFixturePatch) –

Returns

matrix_properties (DMXFixtureMatrix):

Return type

DMXFixtureMatrix or None

get_normalized_attribute_value(fixture_patch, function_attribute, value) → float

Return the normalized value of an Int value from a Fixture Patch function.

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• function_attribute (DMXAttributeName) –

• value (int32) –

Returns

The normalized value of the passed in Int using the Function’s signal format. -1.0 if the Function is not found in the Fixture Patch.

Return type

float

get_pixel_attributes(fixture_patch)

deprecated: ‘get_pixel_attributes’ was renamed to ‘get_cell_attributes’.

get_raw_buffer(selected_protocol, remote_universe)

Return byte array from the DMX buffer given a universe.

Parameters

• selected_protocol (DMXProtocolName) –

• remote_universe (int32) –

Returns

dmx_buffer (Array(uint8)):

Return type

Array(uint8)

int_to_normalized_value(value, signal_format) → float

Return the normalized value of an Int value from the specified Signal Format.

Parameters

• value (int32) –

• signal_format (DMXFixtureSignalFormat) –

Returns

Return type

float

classmethod int_value_to_bytes(value, signal_format, use_lsb=False)

Return the Bytes format of Value in the desired Signal Format.

Parameters

• value (int32) –

• signal_format (DMXFixtureSignalFormat) –

• use_lsb (bool) – Least Significant Byte mode makes the individual bytes (channels) of the function be interpreted with the first bytes being the lowest part of the number. Most Fixtures use MSB (Most Significant Byte).

Returns

bytes (Array(uint8)):

Return type

Array(uint8)

normalized_value_to_bytes(value, signal_format, use_lsb=False)

Return the Bytes format of Value in the desired Signal Format.

Parameters

• value (float) –

• signal_format (DMXFixtureSignalFormat) –

• use_lsb (bool) – Least Significant Byte mode makes the individual bytes (channels) of the function be interpreted with the first bytes being the lowest part of the number. Most Fixtures use MSB (Most Significant Byte).

Returns

bytes (Array(uint8)):

Return type

Array(uint8)

property on_protocol_received

[Read-Write] On Protocol Received deprecated: WARNING: This can execute faster than tick leading to possible blueprint performance issues. Use DMXComponent’s OnFixturePatchReceived event or GetRawBuffer instead.

Type

(ProtocolReceivedDelegate)

pixel_distribution_sort(distribution, num_x_panels, num_y_panels, unordered_list)

deprecated: ‘pixel_distribution_sort’ was renamed to ‘pixel_mapping_distribution_sort’.

pixel_mapping_distribution_sort(distribution, num_x_panels, num_y_panels, unordered_list)

Sort an array according to the selected distribution pattern.

Parameters

• distribution (DMXPixelMappingDistribution) –

• num_x_panels (int32) –

• num_y_panels (int32) –

• unordered_list (Array(int32)) –

Returns

out_sorted_list (Array(int32)):

Return type

Array(int32)

send_dmx(fixture_patch, attribute_map) → DMXSendResult

Send DMX using function names and integer values.

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• attribute_map (Map(DMXAttributeName, int32)) –

Returns

out_result (DMXSendResult):

Return type

DMXSendResult

send_dmx_raw(selected_protocol, remote_universe, address_value_map) → DMXSendResult

Send DMX using channel and raw values. NOTE: Universe Index cannot be lower than 0.

Parameters

• selected_protocol (DMXProtocolName) –

• remote_universe (int32) –

• address_value_map (Map(int32, uint8)) –

Returns

out_result (DMXSendResult):

Return type

DMXSendResult

set_matrix_cell_value(fixture_patch, coordinate, attribute, value) → bool

Cell coordinate X/Y deprecated: Deprecated 4.26. DMXEntityFixurePatch::SendMatrixCellValue instead

Parameters

• fixture_patch (DMXEntityFixturePatch) –

• coordinate (IntPoint) –

• attribute (DMXAttributeName) –

• value (int32) –

Returns

Return type

bool

set_matrix_pixel(fixture_patch, coordinate, attribute, value)

deprecated: ‘set_matrix_pixel’ was renamed to ‘set_matrix_cell_value’.