BlueprintActorFactory.h

Go to the documentation of this file.

// Copyright (c) 2026 Computer Vision Center (CVC) at the Universitat Autonoma
// de Barcelona (UAB).
//
// This work is licensed under the terms of the MIT license.
// For a copy, see <https://opensource.org/licenses/MIT>.
 
#pragma once
 
#include "Carla/Actor/ActorSpawnResult.h"
#include "Carla/Actor/CarlaActorFactory.h"
#include "Carla/Actor/BlueprintParameters.h"
 
#include <util/ue-header-guard-begin.h>
#include "Json.h"
#include "JsonUtilities.h"
#include <util/ue-header-guard-end.h>
 
#include "BlueprintActorFactory.generated.h"
 
UCLASS()
class CARLA_API ABlueprintActorFactory : public ACarlaActorFactory
{
    GENERATED_BODY()
 
    /// Retrieve the definitions of the static mesh actor
    virtual TArray<FActorDefinition> GetDefinitions() override;
 
    virtual FActorSpawnResult SpawnActor(
        const FTransform &SpawnAtTransform,
        const FActorDescription &ActorDescription) override;
 
public:
    UFUNCTION(BlueprintCallable, Category = "BlueprintActorFactory")
    static void SaveBlueprintParametersArrayToFile(const TArray<FBlueprintParameters> &BlueprintParamsArray, const FString &FileName);
    UFUNCTION(BlueprintCallable, Category = "BlueprintActorFactory")
    static void LoadBlueprintParametersArrayFromFile(const FString &FileName, TArray<FBlueprintParameters> &OutBlueprintParamsArray);
 
    UFUNCTION(BlueprintImplementableEvent, Category = "BlueprintActorFactory")
    bool PostProcessBlueprint(AActor* SpawnedActor, const FActorDescription& BlueprintParams);
 
private:
    static TSharedPtr<FJsonObject> FBlueprintParametersToJsonObject(const FBlueprintParameters& BlueprintParams);
    static FString FBlueprintParametersArrayToJson(const TArray<FBlueprintParameters>& BlueprintParamsArray);
    static bool JsonToFBlueprintParameters(const TSharedPtr<FJsonObject> JsonObject, FBlueprintParameters& OutBlueprintParams);
    static bool JsonToFBlueprintParametersArray(const FString& JsonString, TArray<FBlueprintParameters>& OutBlueprintParamsArray);
 
    virtual void ReleaseContentPack(const FString &MountPoint) override;
 
protected:
    // Transient: GetDefinitions() rebuilds these from the JSON catalogs every
    // episode, and a saved copy bakes a stale catalog into the map.
    UPROPERTY(EditAnywhere, Transient)
    TArray<FActorDefinition> Definitions;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Transient)
    TArray<FBlueprintParameters> BlueprintsParams;
};