Open 3D Engine AzToolsFramework API Reference 23.10.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
Public Member Functions | Static Public Member Functions | List of all members
AzToolsFramework::Prefab::PrefabConversionUtils::WorldEditorOnlyEntityHandler Class Reference

#include <WorldEditorOnlyEntityHandler.h>

Inherits AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler.

Public Member Functions

 AZ_CLASS_ALLOCATOR (WorldEditorOnlyEntityHandler, AZ::SystemAllocator)
 
 AZ_RTTI (AzToolsFramework::Prefab::PrefabConversionUtils::WorldEditorOnlyEntityHandler, "{55587AE2-B583-48E4-9634-6BFACF6CBF04}", EditorOnlyEntityHandler)
 
bool IsEntityUniquelyForThisHandler (AZ::Entity *entity) const override
 
Result HandleEditorOnlyEntities (const AzToolsFramework::EntityList &entities, const AzToolsFramework::EntityIdSet &editorOnlyEntityIds, AZ::SerializeContext &serializeContext) override
 
- Public Member Functions inherited from AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler
 AZ_CLASS_ALLOCATOR (EditorOnlyEntityHandler, AZ::SystemAllocator)
 
 AZ_RTTI (AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler, "{C420F65D-18AE-4CAF-BB18-70FA4FE73243}")
 
virtual bool IsEntityUniquelyForThisHandler (AZ::Entity *entity) const =0
 
virtual void AddEditorOnlyEntity (AZ::Entity *editorOnlyEntity, AZStd::unordered_set< AZ::EntityId > &editorOnlyEntities)
 
virtual Result HandleEditorOnlyEntities (const EntityList &, const EntityIdSet &, AZ::SerializeContext &)
 

Static Public Member Functions

static void FixTransformRelationships (const AzToolsFramework::EntityList &entities, const AzToolsFramework::EntityIdSet &editorOnlyEntityIds)
 
- Static Public Member Functions inherited from AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler
static Result ValidateReferences (const EntityList &entities, const EntityIdSet &editorOnlyEntityIds, AZ::SerializeContext &serializeContext)
 

Additional Inherited Members

- Public Types inherited from AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler
using Result = AZ::Outcome< void, AZStd::string >
 

Detailed Description

EditorOnlyEntity handler for world entities.

  • Fixes up transform relationships so entities removed mid-hierarchy still result in valid runtime transform relationships and correct relative transforms.
  • Validates that no editor entities are referenced by non-editor entities.

Member Function Documentation

◆ HandleEditorOnlyEntities()

Result AzToolsFramework::Prefab::PrefabConversionUtils::WorldEditorOnlyEntityHandler::HandleEditorOnlyEntities ( const AzToolsFramework::EntityList &  ,
const AzToolsFramework::EntityIdSet &  ,
AZ::SerializeContext &   
)
overridevirtual

This handler is responsible for making any necessary modifications to other entities in the Prefab prior to the removal of all editor-only entities. After this callback returns, editor-only entities will be removed from the Prefab. See WorldEditorOnlyEntityHandler below for an example of processing and validation that occurs for standard world entities.

Parameters
entitiesa list of all entities in the Prefab, including those marked as editor-only.
editorOnlyEntityIdsa precomputed set containing Ids for all entities within the 'entities' list that were marked as editor-only.
serializeContextuseful to inspect entity data for validation purposes.

Reimplemented from AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler.

◆ IsEntityUniquelyForThisHandler()

bool AzToolsFramework::Prefab::PrefabConversionUtils::WorldEditorOnlyEntityHandler::IsEntityUniquelyForThisHandler ( AZ::Entity *  entity) const
overridevirtual

Implements AzToolsFramework::Prefab::PrefabConversionUtils::EditorOnlyEntityHandler.

The documentation for this class was generated from the following file: