I3DHUtilities.h Source File

I3DHUtilities.h Source File#

instant3Dhub: I3DHUtilities.h Source File
instant3Dhub
 
#pragma once
 
#include "CoreMinimal.h"
 
#include "I3DHDataTypes.h"
#include "I3DHError.h"
#include "I3DHVersion.h"
 
#include "Kismet/BlueprintFunctionLibrary.h"
 
#include "I3DHUtilities.generated.h"
 
class AI3DHConnector;
UCLASS()
class INSTANT3DHUB_API UI3DHUtilities : public UBlueprintFunctionLibrary
{
    GENERATED_BODY()
 
public:
public:
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities")
    static float GetOriginalToUnrealScale();
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities")
    static const FMatrix& GetOriginalToUnrealMatrix();
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities")
    static const FMatrix& GetUnrealToOriginalMatrix();
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities")
    static const FMatrix& GetOriginalToUnrealNormalMatrix();
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities")
    static const FMatrix& GetUnrealToOriginalNormalMatrix();
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static UPARAM(DisplayName = "Unreal Transform") FMatrix ConvertTransformOriginalToUnreal(const FMatrix& OriginalTransform);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static UPARAM(DisplayName = "Original Transform") FMatrix ConvertTransformUnrealToOriginal(const FMatrix& UnrealTransform);
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities", meta = (DisplayName = "Convert Transform Original to Unreal (Pure)"))
    static UPARAM(DisplayName = "Unreal Transform") FMatrix ConvertTransformOriginalToUnrealPure(const FMatrix& OriginalTransform);
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities", meta = (DisplayName = "Convert Transform Unreal to Original (Pure)"))
    static UPARAM(DisplayName = "Original Transform") FMatrix ConvertTransformUnrealToOriginalPure(const FMatrix& UnrealTransform);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static UPARAM(DisplayName = "Unreal Volume") FBox ConvertVolumeOriginalToUnreal(const FBox& OriginalVolume);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static UPARAM(DisplayName = "Original Volume") FBox ConvertVolumeUnrealToOriginal(const FBox& UnrealVolume);
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities", meta = (DisplayName = "Convert Volume Original to Unreal (Pure)"))
    static UPARAM(DisplayName = "Unreal Volume") FBox ConvertVolumeOriginalToUnrealPure(const FBox& OriginalVolume);
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities", meta = (DisplayName = "Convert Volume Unreal to Original (Pure)"))
    static UPARAM(DisplayName = "Original Volume") FBox ConvertVolumeUnrealToOriginalPure(const FBox& UnrealVolume);
 
public:
    UFUNCTION(BlueprintCallable, meta = (AutoCreateRefTerm = "Color"), Category = "{instant3Dhub}|Utilities")
    static FString UEColorToWebvisAppearanceURI(const FLinearColor& Color, EAppearanceURIMode Mode);
    UFUNCTION(BlueprintCallable, meta = (AutoCreateRefTerm = "InURI"), Category = "{instant3Dhub}|Utilities")
    static bool WebvisAppearanceURIToUEColor(const FString& InURI, FLinearColor& OutColor, EAppearanceURIMode& OutMode);
 
public:
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static bool AnalyzeHitResult(const struct FHitResult& HitResult, FI3DHHitResult& OutI3DHHitResult, bool bRequestDetailNode = false);
 
public:
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static FPlane MakePlaneFromClipPlaneActor(const AActor* ClipPlaneActor);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static bool ClipLineSegmentByPlane(UPARAM(ref) FVector& Start, UPARAM(ref) FVector& End, const FPlane& Plane);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities", meta = (DefaultToSelf = "HubConnector"))
    static bool ClipLineSegmentByMainClipPlane(AI3DHConnector* HubConnector, UPARAM(ref) FVector& Start, UPARAM(ref) FVector& End);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities", meta = (DefaultToSelf = "HubConnector"))
    static bool ClipLineSegmentByClipPlanes(AI3DHConnector* HubConnector, UPARAM(ref) FVector& Start, UPARAM(ref) FVector& End);
 
public:
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities")
    static bool IsWithEditor();
    UFUNCTION(BlueprintPure, Category = "{instant3Dhub}|Utilities", meta = (WorldContext = "WorldContextObject"))
    static bool IsEditorStandaloneGame(const UObject* WorldContextObject);
    UFUNCTION(BlueprintCallable, Category = "{instant3Dhub}|Utilities")
    static TMap<FString, FString> GetURLQueryParams(const FString& URL);
 
    // These functions cannot be exposed via UFUNCTION because of the callback parameter.
    // Instead, they have matching async blueprint nodes declared in I3DHAppUtilitiesNodes.h.
public:
    static constexpr FStringView URNPrefixView = TEXTVIEW("urn:");
    static constexpr FStringView SeparatorView = TEXTVIEW(":");
    static bool IsURN(const FStringView URI)
    {
        return URI.StartsWith(URNPrefixView, ESearchCase::IgnoreCase);
    }
    static FString ExtractNamespaceIdentifier(FStringView URI);
    static bool IsValidNamespaceIdentifier(FStringView NamespaceIdentifier, FString* OutValidationError = nullptr);
    static bool IsReservedNamespaceIdentifier(FStringView NamespaceIdentifier, FString* OutValidationError = nullptr);
    static FStringView GetNamespaceSpecificString(const FStringView URN, const FStringView NamespaceIdentifier)
    {
        constexpr int32 URNPrefixLen = URNPrefixView.Len();
        const int32 NamespaceIdentifierLen = NamespaceIdentifier.Len();
        constexpr int32 SeparatorLen = SeparatorView.Len();
        return URN.RightChop(URNPrefixLen + NamespaceIdentifierLen + SeparatorLen);
    }
    static void FindFirstUnselectedAncestor(TSharedPtr<class FI3DHConnectorAPI> API, int32 NodeId, TUniqueFunction<void(int32 AncestorId, EI3DHErrorCode ErrorCode)> OnComplete);
 
private:
    static void FindFirstUnselectedAncestor_GameThread(TSharedPtr<class FI3DHConnectorAPI> API, int32 CurrentNodeId, bool IsCurrentNodeSelected, TUniqueFunction<void(int32 AncestorId, EI3DHErrorCode ErrorCode)> OnComplete);
};