1. Epic GamesDeveloper
  3. UDMXEntityFixturePatch

UDMXEntityFixturePatch

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

API > API/Plugins > API/Plugins/DMXRuntime > API/Plugins/DMXRuntime/Library

Inheritance Hierarchy

References

   
Module DMXRuntime
Header /Engine/Plugins/VirtualProduction/DMX/DMXEngine/Source/DMXRuntime/Public/Library/DMXEntityFixturePatch.h
Include #include "Library/DMXEntityFixturePatch.h"

Syntax

UCLASS (BlueprintType, Blueprintable, Meta=(DisplayName="DMX Fixture Patch"))  
class UDMXEntityFixturePatch :  
    public UDMXEntity ,  
    public FTickableGameObject

Remarks

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.

Variables

  Type Name Description
Protected variable UProperty Category, EditAnywhere, Meta BlueprintReadOnly int32 ActiveMode The Index of the Mode in the Fixture Type the Patch uses
Public variable UProperty Category, EditAnywhere BlueprintReadOnly bool bReceiveDMXInEditor If true, the patch receives dmx and raises the OnFixturePatchReceivedDMX event in editor.
Public variable UProperty Category, EditAnywhere BlueprintReadOnly TArray< FName > CustomTags Custom tags for filtering patches
Protected variable UProperty Category, EditAnywhere BlueprintReadWrite FTransform DefaultTransform The transform used when the DMX Library is spawned in a level.
Public variable UProperty Category, EditAnywhere BlueprintReadOnly FLinearColor EditorColor Color when displayed in the fixture patch editor
Protected variable UProperty Category BlueprintReadOnly visibleanywhere int32 FixtureID The Fixture ID of this patch
Protected variable UProperty Category, Meta BlueprintReadOnly visibleanywhere FGuid MVRFixtureUUID The MVR Fixture UUID
Public variable UProperty Category BlueprintAssignable FDMXOnFixturePatchReceivedDMXDelegate OnFixturePatchReceivedDMX Broadcasts when the patch received dmx
Protected variable UProperty Category, Meta BlueprintReadWrite blueprintsetter, visibledefaultsonly TObjectPtr< UDMXEntityFixtureType > ParentFixtureTypeTemplate The Fixture Type that defines the DMX channel layout of this Fixture Patch
Protected variable UProperty Category, EditAnywhere, Meta BlueprintReadOnly int32 StartingChannel Starting Channel of the Patch
Protected variable UProperty Category, EditAnywhere, Meta BlueprintReadOnly int32 UniverseID The local universe of the patch

Constructors

  Type Name Description
Public function    

Functions

  Type Name Description
Public function Const UFunction BlueprintPure, Category bool

ContainsAttribute ( FDMXAttributeName FunctionAttribute
)

 Returns true if the Fixture Patch contains the specified attribute and can use it to send and receive DMX
Public function Const UFunction BlueprintPure, Category TMap< int32, uint8 > Converts a map of Attribute Names with their DMX values to a map of DMX channels and with their DMX Values.
Public function Const UFunction BlueprintPure, Category, Meta TMap< FDMXAttributeName, int32 > DEPRECATED 4.27
Public function Const UFunction BlueprintPure, Category TMap< FDMXAttributeName, int32 >

ConvertToValidMap ( const TMap< FDMXAttributeName, int32 >& FunctionMap
)

 Removes any Attribute Name that can not be sent or received by a Fixture Patch from an Attribute Name to DMX Value Map
Public function Static UFunction BlueprintCallable, Category UDMXEntityFixturePatch *

CreateFixturePatchInLibrary ( FDMXEntityFixturePatchConstructionParams ConstructionParams,
const FString& DesiredName,
bool bMarkDMXLibraryDirty
)

 Creates a new Fixture Patch in the DMX Library using the specified Fixture Type
Public function Const bool

FindFixtureID ( int32& OutFixtureID
)

 Tries to find the fixture ID of the patch.
Public function void

GenerateFixtureID ( int32 DesiredFixtureID
)

 Generates a unique Fixture ID for this patch.
Public function Const const FDMXFixtureMode * Returns the active mode, or nullptr if there is no valid active mode
Public function Const int32 Returns the index of the Mode the Patch uses from its Fixture Type
Public function Static FName  
Public function Const UFunction BlueprintPure, Category TArray< FDMXAttributeName > Returns an array of attributes for the currently active mode.
Public function UFunction BlueprintCallable, Category bool Gets all matrix cells
Public function Const UFunction BlueprintPure, Category TMap< FDMXAttributeName, int32 > Returns a map of Attributes and their assigned channels
Public function Const UFunction BlueprintPure, Category TMap< FDMXAttributeName, int32 > Returns a map of function names and default values.
Public function Const const FDMXFixtureFunction * Returns the function currently mapped to the passed in Attribute, if any.
Public function Const UFunction BlueprintPure, Category TMap< FDMXAttributeName, FDMXFixtureFunction > Returns a map of attributes and function names.
Public function Const UFunction BlueprintPure, Category TMap< FDMXAttributeName, EDMXFixtureSignalFormat > Returns a map of function names and their Data Types.
Public function void

GetAttributesValues ( TMap< FDMXAttributeName, int32 >& AttributesValues
)

 DEPRECATED 5.5, renamed to GetAttributeValues.
Public function UFunction BlueprintCallable, Category int32

GetAttributeValue ( FDMXAttributeName Attribute,
bool& bSuccess
)

 Retrieves the value of an Attribute. Will fail and return 0 if the Attribute doesn't exist.
Public function UFunction BlueprintCallable, Category void

GetAttributeValues ( TMap< FDMXAttributeName, int32 >& AttributeValues
)

 Returns the value of each attribute, or zero if no value was ever received.
Public function UFunction BlueprintCallable, Category bool

GetCellAttributes ( TArray< FDMXAttributeName >& CellAttributes
)

 Gets all attributes names of a cell
Public function Const UFunction BlueprintPure, Category 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
Public function Const const TArray< FName > & Returns custom tags defined for the patch
Public function Const const FTransform & Returns The transform used when the DMX Library is spawned in a level.
Public function Static FName  
Public function Const UFunction BlueprintPure, Category int32 Returns the last channel of the patch
Public function Const int32 Returns the MVR Fixture ÎD of this patch
Public function Static FName  
Public function Const UDMXEntityFixtureType * Gets the parent fixture type this was constructed from
Public function Const const FDMXSignalSharedPtr & Returns the last received DMX signal.
Public function UFunction BlueprintCallable, Category bool

GetMatrixCell ( const FIntPoint& CellCoordinate,
FDMXCell& Cell
)

 Gets the cell corresponding to the passed in coordinate
Public function UFunction BlueprintCallable, Category bool

GetMatrixCellChannelsAbsolute ( const FIntPoint& CellCoordinate,
TMap< FDMXAttributeName, int32 >& AttributeChannelMap
)

 Gets the absolute starting channel of each cell attribute at given coordinate
Public function UFunction BlueprintCallable, Category bool

GetMatrixCellChannelsAbsoluteWithValidation ( const FIntPoint& InCellCoordinate,
TMap< FDMXAttributeName, int32 >& OutAttributeChannelMap
)

 Validates and gets the absolute starting channel of each cell attribute at given coordinate
Public function UFunction BlueprintCallable, Category bool

GetMatrixCellChannelsRelative ( const FIntPoint& CellCoordinate,
TMap< FDMXAttributeName, int32 >& AttributeChannelMap
)

 Gets the starting channel of each cell attribute at given coordinate, relative to the Starting Channel of the patch.
Public function UFunction BlueprintCallable, Category bool

GetMatrixCellValues ( const FIntPoint& CellCoordinate,
TMap< FDMXAttributeName, int32 >& ValuePerAttribute
)

 Gets the DMX Cell value using matrix coordinates
Public function Const UFunction BlueprintPure, Category bool

GetMatrixProperties ( FDMXFixtureMatrix& MatrixProperties
)

 Gets the Matrix Fixture properties, returns false if the patch is not using a matrix fixture
Public function Const const FGuid & Returns the MVR Fixture UUIDs of this patch
Public function Static FName  
Public function void DEPRECATED 5.5, renamed to GetNormalizedAttributeValues.
Public function UFunction BlueprintCallable, Category, Meta float

GetNormalizedAttributeValue ( FDMXAttributeName Attribute,
bool& bSuccess
)

 Retrieves the normalized value of an Attribute.
Public function UFunction BlueprintCallable, Category void Returns the normalized value of each attribute, or zero if no value was ever received.
Public function UFunction BlueprintCallable, Category bool

GetNormalizedMatrixCellValues ( const FIntPoint& CellCoordinate,
TMap< FDMXAttributeName, float >& NormalizedValuePerAttribute
)

 Gets the DMX Cell value using matrix coordinates.
Public function Static FDMXOnFixturePatchChangedDelegate & Returns a delegate that is and should be broadcast whenever a Fixture Type changed
Public function Static FName  
Public function Const UFunction BlueprintPure, Category, Meta TArray< UDMXEntityController * > DEPRECATED 4.27
Public function Const UFunction BlueprintPure, Category, Meta int32 DEPRECATED 4.27
Public function Const UFunction BlueprintCallable, Category int32 Return the starting channel
Public function Static FName  
Protected function Virtual Const TStatId  
Protected function Virtual Const ETickableTickType  
Public function Const int32 Returns the universe ID of the patch
Public function Static FName Property name getters.
Public function Const UFunction BlueprintPure, Category, Meta bool

IsInControllerRange ( const UDMXEntityController* InController
)

 DEPRECATED 4.27
Public function Const UFunction BlueprintPure, Category, Meta bool

IsInControllersRange ( const TArray< UDMXEntityController* >& InControllers
)

 DEPRECATED 4.27
Public function Const UFunction BlueprintPure, Category bool

IsMapValid ( const TMap< FDMXAttributeName, int32 >& FunctionMap
)

 Returns true if the Fixture Patch contains all Attributes in an Attribute Name to DMX Value Map.
Protected function Virtual Const bool  
Protected function Virtual Const bool  
Public function void Rebuilds the cache.
Public function Static UFunction BlueprintCallable, Category void Removes a fixture patch from the DMX Library
Public function UFunction BlueprintCallable, Category void Sends the default value for all attributes, including matrix attributes.
Public function UFunction BlueprintCallable, Category void

SendDMX ( TMap< FDMXAttributeName, int32 > AttributeMap
)

 Send DMX using attribute names and integer values.
Public function UFunction BlueprintCallable, Category bool

SendMatrixCellValue ( const FIntPoint& CellCoordinate,
const FDMXAttributeName& Attribute,
int32 Value
)

 Sends the DMX value of the Attribute to specified matrix coordinates
Public function UFunction BlueprintCallable, Category, Meta bool

SendMatrixCellValueWithAttributeMap ( const FIntPoint& CellCoordinate,
const FDMXAttributeName& Attribute,
int32 Value,
const TMap< FDMXAttributeName, int32 >& InAttributeNameChannelMap
)

 Sends the DMX value of the Attribute to specified matrix coordinates with given Attribute Name Channel Map
Public function UFunction BlueprintCallable, Category bool

SendNormalizedMatrixCellValue ( const FIntPoint& CellCoordinate,
const FDMXAttributeName& Attribute,
float RelativeValue
)

 Maps the normalized value to the Attribute's full value range and sends it to specified matrix coordinates
Public function UFunction BlueprintCallable, Category void Sends zeroes for all attributes, including matrix attributes.
Public function bool

SetActiveModeIndex ( int32 NewActiveModeIndex
)

 Sets the index of the Mode the Patch uses from its Fixture Type
Public function void

SetDefaultTransform ( const FTransform& NewDefaultTransform
)

 Sets The transform used when the DMX Library is spawned in a level.
Public function UFunction BlueprintCallable, Category void Sets the fixture type this is using
Public function UFunction BlueprintCallable, Category void

SetStartingChannel ( int32 NewStartingChannel
)

 Sets the starting channel of the Fixture Patch.
Public function UFunction BlueprintCallable, Category void

SetUniverseID ( int32 NewUniverseID
)

 Sets the Universe ID of the patch
Protected function Virtual void

Tick ( float DeltaTime
)

  
Public function void Called from Fixture Type to keep ActiveMode in valid range when Modes are removed from the Type

Overridden from UDMXEntity

  Type Name Description
Public function Virtual Const bool

IsValidEntity ( FText& OutReason
)

 Checks for Entity correctness for usability with protocols.

Overridden from UObject

  Type Name Description
Public function Virtual bool

Modify ( bool bAlwaysMarkDirty
)

 Note that the object will be modified.
Protected function Virtual void This alternate version of PostEditChange is called when properties inside structs are modified.
Protected function Virtual void

PostEditChangeProperty ( FPropertyChangedEvent& PropertyChangedEvent
)

 Called when a property on this object has been modified externally
Protected function Virtual void Called after the C++ constructor and after the properties have been initialized, including those loaded from config.
Protected function Virtual void Do any object-specific cleanup required immediately after loading an object.
Protected function Virtual void Handles reading, writing, and reference collecting using FArchive.

Constants

Name Description
OnFixturePatchChangedDelegate Delegate broadcast when a Fixture Patch changed

Deprecated Variables

  Type Name Description
Protected variable UProperty Meta int32 AutoStartingAddress_DEPRECATED DEPRECATED 5.1
Protected variable UProperty Meta bool bAutoAssignAddress_DEPRECATED DEPRECATED 5.1
Protected variable UProperty Meta int32 ManualStartingAddress_DEPRECATED DEPRECATED 5.1

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page