ST_AudioControlSettings.h

// Copyright (c) 2025 Aaron Trotter (ShaderTech). All Rights Reserved.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Engine/DeveloperSettings.h"
#include "ST_AudioControlSettings.generated.h"

 // ENUMS

UENUM(BlueprintType)
enum class EMIDIType : uint8
{
    Both    UMETA(DisplayName = "Both"),    
    Input   UMETA(DisplayName = "Input"),   
    Output  UMETA(DisplayName = "Output"),  
    None    UMETA(DisplayName = "None")     
};

UENUM(BlueprintType)
enum class ELEDColourFormat : uint8
{
    RGB     UMETA(DisplayName = "RGB"),     
    RGBA    UMETA(DisplayName = "RGBA"),    
    BGRA    UMETA(DisplayName = "BGRA")     
};

UENUM(BlueprintType)
enum class ELEDAlphaMapping : uint8
{
    None        UMETA(DisplayName = "No Alpha (full transparency)"),
    Linear      UMETA(DisplayName = "Linear (direct multiplication)"),
    Logarithmic UMETA(DisplayName = "Logarithmic (smooth, uniform)"),
    Gamma       UMETA(DisplayName = "Gamma (corrected for display)")
};

// STRUCTS

USTRUCT(BlueprintType)
struct FMIDIRanges
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "MIDI")
    FIntPoint ControlChangeRange = FIntPoint::ZeroValue; 
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "MIDI")
    FIntPoint PitchBendRange = FIntPoint::ZeroValue;      
};

USTRUCT(BlueprintType)
struct FST_AudioController
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ShaderTech")
    UObject* Controller = nullptr; 
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ShaderTech")
    FName Name = ""; 
 
    bool operator==(const FST_AudioController& Other) const
    {
        return Name == Other.Name;
    }
 
    bool operator!=(const FST_AudioController& Other) const
    {
        return !operator==(Other);
    }
};

USTRUCT(BlueprintType)
struct FST_MIDIDeviceController : public FST_AudioController
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "MIDI")
    EMIDIType MIDIType = EMIDIType::None; 
};

USTRUCT(BlueprintType)
struct FST_OSController : public FST_AudioController
{
    GENERATED_BODY()
};

USTRUCT(BlueprintType)
struct FST_SocketController : public FST_AudioController
{
    GENERATED_BODY()
};

USTRUCT(BlueprintType)
struct FST_DMXController : public FST_AudioController
{
    GENERATED_BODY()
};

USTRUCT(BlueprintType)
struct FLEDConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    ELEDColourFormat ColourFormat = ELEDColourFormat::RGB;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    ELEDAlphaMapping AlphaMapping = ELEDAlphaMapping::Logarithmic;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, EditCondition = "AlphaMapping == ELEDAlphaMapping::Gamma", Tooltip = "A value of 2.2 matches most screens (sRGB) and ensures correct brightness and color perception."))
    float GammaFactor = 2.2f;
};

USTRUCT(BlueprintType)
struct FAudioControlLEDConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "LED", meta = (SessionRestartRequired))
    FIntPoint LEDResolution = FIntPoint(1, 1);
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "LED", meta = (SessionRestartRequired))
    FIntPoint PrevisResolution = FIntPoint(1, 1);
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "LED")
    FLEDConfig LEDConfig;
};

USTRUCT(BlueprintType)
struct FST_DMXAttribute
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX")
    FName Name = "";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX")
    int32 Value = 0;
};

USTRUCT(BlueprintType)
struct FDMXMatLEDConfig : public FAudioControlLEDConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX", meta = (SessionRestartRequired))
    TSoftObjectPtr<class UMaterialInterface> LEDMaterial = nullptr;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX")
    bool bKeepStateOnEndPlay = false;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX")
    TArray<FST_DMXAttribute> DMXAttributes;
};

USTRUCT(BlueprintType)
struct FArtNetConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired))
    bool bArtNetEnabled = true;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired))
    FString SocketDescription = "ST_Socket";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired))
    FString IpAddress = "";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired))
    int32 Port = 0;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired, Tooltip = "Receive buffer size in bytes (default is 64KB on Windows)."))
    int32 ReceieveBufferSize = 65536;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired, Tooltip = "Send buffer size in bytes (default is 64KB on Windows)."))
    int32 SendBufferSize = 65536;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ArtNet", meta = (SessionRestartRequired, Tooltip = "Send Buffer Overhead will be culled when true and fragmented when false."))
    bool bCullOverhead = false;
};

USTRUCT(BlueprintType)
struct FDMXConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX")
    FArtNetConfig ArtNetConfig;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "DMX")
    FDMXMatLEDConfig DMXMatLEDConfig;
};

USTRUCT(BlueprintType)
struct FOSCMatLEDConfig : public FAudioControlLEDConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    TSoftObjectPtr<class UMaterialInterface> LEDMaterial = nullptr;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    FString Address = "/MatLED";
};

USTRUCT(BlueprintType)
struct FOSConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC")
    FOSCMatLEDConfig OSCMatLEDConfig;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    bool bOSCEnabled = true;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    FString SendIpAddress = "127.0.0.1";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    int32 SendPort = 8000;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    FString SendClientName = "ST_SendOSCClient";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    FString ReceiveIpAddress = "127.0.0.1";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    int32 ReceivePort = 8000;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "OSC", meta = (SessionRestartRequired))
    FString ReceiveClientName = "ST_ReceiveOSCClient";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, Tooltip = "Receive buffer size in bytes (default is 64KB on Windows)."))
    int32 ReceieveBufferSize = 65536;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, Tooltip = "Send buffer size in bytes (default is 64KB on Windows)."))
    int32 SendBufferSize = 65536;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, Tooltip = "Send Buffer Overhead will be culled when true and fragmented when false."))
    bool bCullOverhead = false;
};

USTRUCT(BlueprintType)
struct FSocketRTLEDConfig : public FAudioControlLEDConfig
{
    GENERATED_BODY()
};

USTRUCT(BlueprintType)
struct FSocketMatLEDConfig : public FAudioControlLEDConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    TSoftObjectPtr<class UMaterialInterface> LEDMaterial = nullptr;
};

USTRUCT(BlueprintType)
struct FUDPConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    bool bUDPEnabled = true;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    FString SocketDescription = "ST_Socket";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    FString IpAddress = "";
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired))
    int32 Port = 0;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, Tooltip = "Receive buffer size in bytes (default is 64KB on Windows)."))
    int32 ReceieveBufferSize = 65536;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, Tooltip = "Send buffer size in bytes (default is 64KB on Windows)."))
    int32 SendBufferSize = 65536;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP", meta = (SessionRestartRequired, Tooltip = "Send Buffer Overhead will be culled when true and fragmented when false."))
    bool bCullOverhead = false;
};

USTRUCT(BlueprintType)
struct FSocketConfig
{
    GENERATED_BODY()
 
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP")
    FUDPConfig UDPConfig;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP")
    FSocketRTLEDConfig SocketRTLEDConfig;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "UDP")
    FSocketMatLEDConfig SocketMatLEDConfig;
};

// SETTINGS CLASS
 
#if WITH_EDITOR
DECLARE_MULTICAST_DELEGATE_TwoParams(FOnPostEditChangePropertyDelegate_ACS, UObject*, FPropertyChangedEvent&);
#endif

UCLASS(Config = ST_VJMaster, DefaultConfig, meta = (DisplayName = "ST Audio Control"))
class ST_AUDIOCONTROL_API UST_AudioControlSettings : public UDeveloperSettings
{
    GENERATED_BODY()
 
public:
    UFUNCTION(BlueprintPure, Category = "ShaderTech|AudioControl")
    static const UST_AudioControlSettings* GetST_AudioControlSettings()
    {
        return GetDefault<UST_AudioControlSettings>();
    }
 
#if WITH_EDITOR
    inline static FOnPostEditChangePropertyDelegate_ACS OnPostEditChangeProperty;
 
    virtual void PostEditChangeProperty(FPropertyChangedEvent& PropertyChangedEvent) override
    {
        Super::PostEditChangeProperty(PropertyChangedEvent);
        OnPostEditChangeProperty.Broadcast(this, PropertyChangedEvent);
    }
#endif
 
    UPROPERTY(config, EditAnywhere, BlueprintReadOnly, Category = "UDP")
    FSocketConfig SocketConfig;
 
    UPROPERTY(config, EditAnywhere, BlueprintReadOnly, Category = "OSC")
    FOSConfig OSConfig;
 
    UPROPERTY(config, EditAnywhere, BlueprintReadOnly, Category = "DMX")
    FDMXConfig DMXConfig;
 
protected:
    virtual FName GetCategoryName() const override
    {
        return TEXT("ShaderTech");
    }
};