Files
UnrealEngineUWP/Engine/Source/Editor/LevelEditor/Public/LevelEditorSubsystem.h
Max Chen eaa52d8bf2 Editor: Added utility functions for viewports
GetViewports, GetActiveViewport, SetAllowsCinematicControl, GetAllowsCinematicControl.

PilotLevelActor, EjectPilotLevelActor, EditorSetGameView, EditorGetGameView now take an optional config key to indicate which viewport should be set/get. Default is none, which acts on the active viewport (no change in existing behavior)

#jira UE-108941
#rb brooke.hubert

[CL 15522119 by Max Chen in ue5-main branch]
2021-02-24 17:53:02 -04:00

121 lines
4.8 KiB
C++

// Copyright Epic Games, Inc. All Rights Reserved.
#pragma once
#include "CoreMinimal.h"
#include "EditorSubsystem.h"
#include "LevelEditorSubsystem.generated.h"
struct FToolMenuContext;
/**
* ULevelEditorSubsystem
* Subsystem for exposing Level Editor related functionality to scripts
*/
UCLASS()
class LEVELEDITOR_API ULevelEditorSubsystem : public UEditorSubsystem
{
GENERATED_BODY()
public:
virtual void Initialize(FSubsystemCollectionBase& Collection) override;
virtual void Deinitialize() override;
void ExtendQuickActionMenu();
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta=(DevelopmentOnly))
void PilotLevelActor(AActor* ActorToPilot, FName ViewportConfigKey = NAME_None);
void PilotLevelActor(const FToolMenuContext& InContext);
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
void EjectPilotLevelActor(FName ViewportConfigKey = NAME_None);
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
void EditorPlaySimulate();
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
void EditorInvalidateViewports();
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
void EditorSetGameView(bool bGameView, FName ViewportConfigKey = NAME_None);
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
bool EditorGetGameView(FName ViewportConfigKey = NAME_None);
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
void EditorRequestEndPlay();
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
bool IsInPlayInEditor() const;
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
TArray<FName> GetViewportConfigKeys();
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
FName GetActiveViewportConfigKey();
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
void SetAllowsCinematicControl(bool bAllow, FName ViewportConfigKey = NAME_None);
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility", meta = (DevelopmentOnly))
bool GetAllowsCinematicControl(FName ViewportConfigKey = NAME_None);
/**
* Close the current Persistent Level (without saving it). Create a new blank Level and save it. Load the new created level.
* @param AssetPath Asset Path of where the level will be saved.
* ie. /Game/MyFolder/MyAsset
* @return True if the operation succeeds.
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
bool NewLevel(const FString& AssetPath);
/**
* Close the current Persistent Level (without saving it). Create a new Level base on another level and save it. Load the new created level.
* @param AssetPath Asset Path of where the level will be saved.
* ie. /Game/MyFolder/MyAsset
* @param TemplateAssetPath Level to be used as Template.
* ie. /Game/MyFolder/MyAsset
* @return True if the operation succeeds.
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
bool NewLevelFromTemplate(const FString& AssetPath, const FString& TemplateAssetPath);
/**
* Close the current Persistent Level (without saving it). Loads the specified level.
* @param AssetPath Asset Path of the level to be loaded.
* ie. /Game/MyFolder/MyAsset
* @return True if the operation succeeds.
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
bool LoadLevel(const FString& AssetPath);
/**
* Saves the specified Level. Must already be saved at lease once to have a valid path.
* @return True if the operation succeeds.
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
bool SaveCurrentLevel();
/**
* Saves all Level currently loaded by the World Editor.
* @return True if the operation succeeds.
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
bool SaveAllDirtyLevels();
/**
* Set the current level used by the world editor.
* If more than one level shares the same name, the first one encounter of that level name will be used.
* @param LevelName The name of the Level the actor belongs to (same name as in the ContentBrowser).
* @return True if the operation succeeds.
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
bool SetCurrentLevelByName(FName LevelName);
/**
* Get the current level used by the world editor.
* @return The current level
*/
UFUNCTION(BlueprintCallable, Category = "Editor Scripting | Level Utility")
ULevel* GetCurrentLevel();
};