Open 3D Engine ScriptCanvas Gem API Reference
23.05.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
|
EditorGraph is the editor version of the ScriptCanvas::Graph component that is activated when executing the script canvas engine. More...
#include <EditorGraph.h>
Inherits ScriptCanvas::Graph, Handler, Handler, Handler, Handler, Handler, Handler, MultiHandler, Handler, and Handler.
Classes | |
struct | LiveSlotInfo |
struct | ReplacementInfo |
Public Types | |
enum | UpgradeRequest { IfOutOfDate, Forced } |
Public Member Functions | |
AZ_COMPONENT (EditorGraph,"{4D755CA9-AB92-462C-B24F-0B3376F19967}", ScriptCanvas::Graph) | |
m_variableCounter (0) | |
m_graphCanvasSceneEntity (nullptr) | |
m_ignoreSaveRequests (false) | |
m_graphCanvasSaveVersion (GraphCanvas::EntitySaveDataContainer::CurrentVersion) | |
m_upgradeSM (this) | |
void | Activate () override |
void | Deactivate () override |
AZ::u32 | GetNewVariableCounter () override |
void | ReleaseVariableCounter (AZ::u32 variableCounter) override |
void | RequestUndoPoint () override |
void | RequestPushPreventUndoStateUpdate () override |
void | RequestPopPreventUndoStateUpdate () override |
void | TriggerUndo () override |
void | TriggerRedo () override |
void | EnableNodes (const AZStd::unordered_set< GraphCanvas::NodeId > &nodeIds) override |
void | DisableNodes (const AZStd::unordered_set< GraphCanvas::NodeId > &nodeIds) override |
GraphCanvas::NodePropertyDisplay * | CreateDataSlotPropertyDisplay (const AZ::Uuid &dataType, const AZ::EntityId &nodeId, const AZ::EntityId &slotId) const override |
GraphCanvas::NodePropertyDisplay * | CreatePropertySlotPropertyDisplay (const AZ::Crc32 &propertyId, const AZ::EntityId &nodeId, const AZ::EntityId &slotId) const override |
void | DisconnectConnection (const GraphCanvas::ConnectionId &connectionId) override |
bool | CreateConnection (const GraphCanvas::ConnectionId &connectionId, const GraphCanvas::Endpoint &sourcePoint, const GraphCanvas::Endpoint &targetPoint) override |
bool | IsValidConnection (const GraphCanvas::Endpoint &sourcePoint, const GraphCanvas::Endpoint &targetPoint) const override |
AZStd::string | GetDataTypeString (const AZ::Uuid &typeId) override |
void | OnRemoveUnusedNodes () override |
void | OnRemoveUnusedElements () override |
bool | AllowReset (const GraphCanvas::Endpoint &endpoint) const override |
void | ResetSlotToDefaultValue (const GraphCanvas::Endpoint &endpoint) override |
void | ResetReference (const GraphCanvas::Endpoint &endpoint) override |
void | ResetProperty (const GraphCanvas::NodeId &nodeId, const AZ::Crc32 &propertyId) override |
void | RemoveSlot (const GraphCanvas::Endpoint &endpoint) override |
bool | IsSlotRemovable (const GraphCanvas::Endpoint &endpoint) const override |
bool | ConvertSlotToReference (const GraphCanvas::Endpoint &endpoint, bool isNewSlot=false) override |
bool | CanConvertSlotToReference (const GraphCanvas::Endpoint &endpoint, bool isNewSlot=false) override |
GraphCanvas::CanHandleMimeEventOutcome | CanHandleReferenceMimeEvent (const GraphCanvas::Endpoint &endpoint, const QMimeData *mimeData) override |
bool | HandleReferenceMimeEvent (const GraphCanvas::Endpoint &endpoint, const QMimeData *mimeData) override |
bool | CanPromoteToVariable (const GraphCanvas::Endpoint &endpoint, bool isNewSlot=false) const override |
bool | PromoteToVariableAction (const GraphCanvas::Endpoint &endpoint, bool isNewSlot=false) override |
bool | SynchronizeReferences (const GraphCanvas::Endpoint &sourceEndpoint, const GraphCanvas::Endpoint &targetEndpoint) override |
bool | ConvertSlotToValue (const GraphCanvas::Endpoint &endpoint) override |
bool | CanConvertSlotToValue (const GraphCanvas::Endpoint &endpoint) override |
GraphCanvas::CanHandleMimeEventOutcome | CanHandleValueMimeEvent (const GraphCanvas::Endpoint &endpoint, const QMimeData *mimeData) override |
bool | HandleValueMimeEvent (const GraphCanvas::Endpoint &endpoint, const QMimeData *mimeData) override |
GraphCanvas::SlotId | RequestExtension (const GraphCanvas::NodeId &nodeId, const GraphCanvas::ExtenderId &extenderId, GraphModelRequests::ExtensionRequestReason) override |
void | ExtensionCancelled (const GraphCanvas::NodeId &nodeId, const GraphCanvas::ExtenderId &extenderId) override |
void | FinalizeExtension (const GraphCanvas::NodeId &nodeId, const GraphCanvas::ExtenderId &extenderId) override |
bool | ShouldWrapperAcceptDrop (const GraphCanvas::NodeId &wrapperNode, const QMimeData *mimeData) const override |
void | AddWrapperDropTarget (const GraphCanvas::NodeId &wrapperNode) override |
void | RemoveWrapperDropTarget (const GraphCanvas::NodeId &wrapperNode) override |
void | OnEntitiesSerialized (GraphCanvas::GraphSerialization &serializationTarget) override |
void | OnEntitiesDeserialized (const GraphCanvas::GraphSerialization &serializationSource) override |
void | OnPreNodeDeleted (const AZ::EntityId &nodeId) override |
void | OnPreConnectionDeleted (const AZ::EntityId &nodeId) override |
void | OnUnknownPaste (const QPointF &scenePos) override |
void | OnSelectionChanged () override |
void | PostDeletionEvent () override |
void | PostCreationEvent () override |
void | OnPasteBegin () override |
void | OnPasteEnd () override |
void | OnViewRegistered () override |
void | OnGraphCanvasNodeCreated (const AZ::EntityId &nodeId) override |
NodeCreationNotifications. | |
void | CreateGraphCanvasScene () override |
void | ClearGraphCanvasScene () override |
void | DisplayGraphCanvasScene () override |
bool | UpgradeGraph (SourceHandle source, UpgradeRequest upgradeRequest, const UpgradeGraphConfig &upgradeConfig) |
void | ConnectGraphCanvasBuses () |
void | DisconnectGraphCanvasBuses () |
void | OnSystemTick () override |
void | OnGraphCanvasSceneVisible () override |
GraphCanvas::GraphId | GetGraphCanvasGraphId () const override |
AZStd::unordered_map < AZ::EntityId, GraphCanvas::EntitySaveDataContainer * > | GetGraphCanvasSaveData () override |
void | UpdateGraphCanvasSaveData (const AZStd::unordered_map< AZ::EntityId, GraphCanvas::EntitySaveDataContainer * > &saveData) override |
NodeIdPair | CreateCustomNode (const AZ::Uuid &typeId, const AZ::Vector2 &position) override |
void | AddCrcCache (const AZ::Crc32 &crcValue, const AZStd::string &cacheString) override |
void | RemoveCrcCache (const AZ::Crc32 &crcValue) override |
AZStd::string | DecodeCrc (const AZ::Crc32 &crcValue) override |
void | ClearHighlights () override |
void | HighlightMembersFromTreeItem (const GraphCanvas::GraphCanvasTreeItem *treeItem) override |
void | HighlightVariables (const AZStd::unordered_set< ScriptCanvas::VariableId > &variableIds) override |
void | HighlightNodes (const AZStd::vector< NodeIdPair > &nodes) override |
AZStd::vector< NodeIdPair > | GetNodesOfType (const ScriptCanvas::NodeTypeIdentifier &) override |
AZStd::vector< NodeIdPair > | GetVariableNodes (const ScriptCanvas::VariableId &) override |
void | RemoveUnusedVariables () override |
bool | CanConvertVariableNodeToReference (const GraphCanvas::NodeId &nodeId) override |
bool | ConvertVariableNodeToReference (const GraphCanvas::NodeId &nodeId) override |
bool | ConvertReferenceToVariableNode (const GraphCanvas::Endpoint &endpoint) override |
void | QueueVersionUpdate (const AZ::EntityId &graphCanvasNodeId) override |
bool | CanExposeEndpoint (const GraphCanvas::Endpoint &endpoint) override |
ScriptCanvas::Endpoint | ConvertToScriptCanvasEndpoint (const GraphCanvas::Endpoint &endpoint) const override |
GraphCanvas::Endpoint | ConvertToGraphCanvasEndpoint (const ScriptCanvas::Endpoint &endpoint) const override |
bool | OnVersionConversionBegin (ScriptCanvas::Node &node) |
void | OnVersionConversionEnd (ScriptCanvas::Node &node) |
void | OnSaveDataDirtied (const AZ::EntityId &savedElement) override |
bool | NeedsSaveConversion () const |
void | ConvertSaveFormat () |
void | ConstructSaveData () |
void | OnToastInteraction () override |
void | OnToastDismissed () override |
void | OnUndoRedoEnd () override |
void | ReportError (const ScriptCanvas::Node &node, const AZStd::string &errorSource, const AZStd::string &errorMessage) override |
const GraphStatisticsHelper & | GetNodeUsageStatistics () const |
![]() | |
AZ_COMPONENT (Graph,"{C3267D77-EEDC-490E-9E42-F1D1F473E184}") | |
Graph (const ScriptCanvasId &executionId=AZ::Entity::MakeId()) | |
void | Init () override |
void | Activate () override |
void | Deactivate () override |
const AZStd::vector< AZ::EntityId > | GetNodesConst () const |
AZStd::unordered_set < AZ::Entity * > & | GetNodeEntities () |
const AZStd::unordered_set < AZ::Entity * > & | GetNodeEntities () const |
const ScriptCanvas::ScriptCanvasId & | GetScriptCanvasId () const |
void | MarkVersion () |
const VersionData & | GetVersion () const |
bool | HasDeprecatedNode () const |
void | Parse (ValidationResults &validationResults) |
bool | AddNode (const AZ::EntityId &) override |
bool | RemoveNode (const AZ::EntityId &nodeId) override |
Node * | FindNode (AZ::EntityId nodeID) const override |
AZStd::vector< AZ::EntityId > | GetNodes () const override |
Slot * | FindSlot (const Endpoint &endpoint) const override |
bool | AddConnection (const AZ::EntityId &) override |
void | RemoveAllConnections () |
bool | RemoveConnection (const AZ::EntityId &connectionId) override |
AZStd::vector< AZ::EntityId > | GetConnections () const override |
AZStd::vector< Endpoint > | GetConnectedEndpoints (const Endpoint &firstEndpoint) const override |
AZStd::pair < EndpointMapConstIterator, EndpointMapConstIterator > | GetConnectedEndpointIterators (const Endpoint &endpoint) const override |
bool | IsEndpointConnected (const Endpoint &endpoint) const override |
bool | FindConnection (AZ::Entity *&connectionEntity, const Endpoint &firstEndpoint, const Endpoint &otherEndpoint) const override |
bool | Connect (const AZ::EntityId &sourceNodeId, const SlotId &sourceSlotId, const AZ::EntityId &targetNodeId, const SlotId &targetSlotId) override |
bool | Disconnect (const AZ::EntityId &sourceNodeId, const SlotId &sourceSlotId, const AZ::EntityId &targetNodeId, const SlotId &targetSlotId) override |
bool | ConnectByEndpoint (const Endpoint &sourceEndpoint, const Endpoint &targetEndpoint) override |
AZ::Outcome< void, AZStd::string > | CanCreateConnectionBetween (const Endpoint &sourceEndpoint, const Endpoint &targetEndpoint) const override |
AZ::Outcome< void, AZStd::string > | CanConnectionExistBetween (const Endpoint &sourceEndpoint, const Endpoint &targetEndpoint) const override |
bool | DisconnectByEndpoint (const Endpoint &sourceEndpoint, const Endpoint &targetEndpoint) override |
bool | DisconnectById (const AZ::EntityId &connectionId) override |
bool | AddDependentAsset (AZ::EntityId nodeId, const AZ::TypeId assetType, const AZ::Data::AssetId assetId) override |
bool | RemoveDependentAsset (AZ::EntityId nodeId) override |
AZ::Entity * | GetGraphEntity () const override |
Graph * | GetGraph () override |
GraphData * | GetGraphData () override |
const GraphData * | GetGraphDataConst () const override |
VariableData * | GetVariableData () override |
const VariableData * | GetVariableDataConst () const override |
bool | AddGraphData (const GraphData &) override |
void | RemoveGraphData (const GraphData &) override |
bool | IsBatchAddingGraphData () const override |
AZStd::unordered_set < AZ::Entity * > | CopyItems (const AZStd::unordered_set< AZ::Entity * > &entities) override |
void | AddItems (const AZStd::unordered_set< AZ::Entity * > &graphField) override |
void | RemoveItems (const AZStd::unordered_set< AZ::Entity * > &graphField) override |
void | RemoveItems (const AZStd::vector< AZ::Entity * > &graphField) |
AZStd::unordered_set < AZ::Entity * > | GetItems () const override |
bool | AddItem (AZ::Entity *itemRef) override |
bool | RemoveItem (AZ::Entity *itemRef) override |
void | ValidateGraph (ValidationResults &validationEvents) override |
void | ReportValidationResults (ValidationResults &) override |
AZStd::pair < ScriptCanvas::ScriptCanvasId, ValidationResults > | GetValidationResults () override |
template<typename NodeType > | |
AZStd::vector< const NodeType * > | GetNodesOfType () const |
void | MarkOwnership (ScriptCanvas::ScriptCanvasData &owner) |
ScriptCanvas::DataPtr | GetOwnership () const |
void | ClearScriptEventExtension () |
bool | IsScriptEventExtension () const |
void | MarkScriptEventExtension () |
Static Public Member Functions | |
static ScriptCanvas::DataPtr | Create () |
static void | Reflect (AZ::ReflectContext *context) |
static const char * | GetMimeType () |
static const char * | GetWrappedNodeGroupingMimeType () |
static void | GetProvidedServices (AZ::ComponentDescriptor::DependencyArrayType &provided) |
static void | GetRequiredServices ([[maybe_unused]] AZ::ComponentDescriptor::DependencyArrayType &required) |
static void | GetIncompatibleServices (AZ::ComponentDescriptor::DependencyArrayType &incompatible) |
![]() | |
static void | Reflect (AZ::ReflectContext *context) |
Public Attributes | |
__pad0__: ScriptCanvas::Graph(scriptCanvasId) | |
EditorGraphUpgradeMachine | m_upgradeSM |
![]() | |
friend | Node |
Protected Types | |
enum | FixConnections { No, Yes } |
using | LiveSlotStates = AZStd::vector< LiveSlotInfo > |
using | ReplacementInfoByNode = AZStd::unordered_map< AZ::EntityId, ReplacementInfo > |
using | NodesById = AZStd::unordered_map< AZ::EntityId, ScriptCanvas::Node * > |
Protected Member Functions | |
void | PostRestore (const UndoData &restoredData) override |
void | UnregisterToast (const AzToolsFramework::ToastId &toastId) |
EditorGraph (const EditorGraph &)=delete | |
void | DisplayUpdateToast () |
AZ::EntityId | ConvertToScriptCanvasNodeId (const GraphCanvas::NodeId &nodeId) const |
GraphCanvas::NodePropertyDisplay * | CreateDisplayPropertyForSlot (const AZ::EntityId &scriptCanvasNodeId, const ScriptCanvas::SlotId &scriptCanvasSlotId) const |
void | SignalDirty () |
void | HighlightNodesByType (const ScriptCanvas::NodeTypeIdentifier &nodeTypeIdentifier) |
void | HighlightEBusNodes (const ScriptCanvas::EBusBusId &busId, const ScriptCanvas::EBusEventId &eventId) |
void | HighlightScriptEventNodes (const ScriptCanvas::EBusBusId &busId, const ScriptCanvas::EBusEventId &eventId) |
void | HighlightScriptCanvasEntity (const AZ::EntityId &scriptCanvasId) |
AZ::EntityId | FindGraphCanvasSlotId (const AZ::EntityId &graphCanvasNodeId, const ScriptCanvas::SlotId &slotId) |
bool | ConfigureConnectionUserData (const ScriptCanvas::Endpoint &sourceEndpoint, const ScriptCanvas::Endpoint &targetEndpoint, GraphCanvas::ConnectionId connectionId) |
void | HandleQueuedUpdates () |
bool | IsNodeVersionConverting (const AZ::EntityId &graphCanvasNodeId) const |
void | HandleFunctionDefinitionExtension (ScriptCanvas::Node *node, GraphCanvas::SlotId graphCanvasSlotId, const GraphCanvas::NodeId &nodeId) |
AZ::Outcome< LiveSlotInfo, AZStd::string > | ConvertToLiveStateInfo (const ScriptCanvas::Node &node, const ScriptCanvas::Slot &slot) const |
AZ::Outcome < ScriptCanvas::Node *, AZStd::string > | ReplaceLiveNode (ScriptCanvas::Node &, ScriptCanvas::NodeReplacementConfiguration &) |
AZ::Outcome< LiveSlotStates, AZStd::string > | GetSlotState (const ScriptCanvas::Node &node) const |
LiveSlotInfo * | FindMatchingSlotState (ScriptCanvas::Node &node, ScriptCanvas::Slot &slot, LiveSlotStates &slotState) const |
AZ::Outcome< void, AZStd::string > | UpdateSlotConnections (ScriptCanvas::Node &node, ScriptCanvas::Slot &slot, const ScriptCanvas::NodeReplacementConfiguration &nodeConfig, LiveSlotInfo &slotInfo, const ReplacementInfoByNode &ainfoByOldNode) |
AZ::Outcome< void, AZStd::string > | UpdateSlotDatum (ScriptCanvas::Node &node, ScriptCanvas::Slot &slot, LiveSlotInfo &slotInfo) |
AZ::Outcome< void, AZStd::string > | UpdateSlotState (ScriptCanvas::Node &node, ScriptCanvas::Slot &slot, const ScriptCanvas::NodeReplacementConfiguration &nodeConfig, LiveSlotStates &slotState, const ReplacementInfoByNode &infoByOldNode, FixConnections fixConnections) |
AZ::Outcome< void, AZStd::string > | UpdateSlotState (ScriptCanvas::Node &node, const ScriptCanvas::NodeReplacementConfiguration &nodeConfig, LiveSlotStates &slotState, const ReplacementInfoByNode &infoByOldNode, FixConnections fixConnections) |
void | RefreshVariableReferences (const ScriptCanvas::VariableId &variableId) override |
![]() | |
void | PostActivate () |
void | ValidateVariables (ValidationResults &validationResults) |
void | ValidateScriptEvents (ValidationResults &validationResults) |
bool | ValidateConnectionEndpoints (const AZ::EntityId &connectionRef, const AZStd::unordered_set< AZ::EntityId > &nodeRefs) |
AZ::Outcome< void, AZStd::vector < ValidationStruct > > | ValidateNode (AZ::Entity *nodeEntity, ValidationResults &validationEvents) const |
AZ::Outcome< void, ValidationStruct > | ValidateConnection (AZ::Entity *connection) const |
bool | IsInDataFlowPath (const Node *sourceNode, const Node *targetNode) const |
void | RefreshConnectionValidity (bool warnOnRemoval=false) |
AZ::Data::AssetId | GetAssetId () const override |
GraphIdentifier | GetGraphIdentifier () const override |
AZStd::string | GetAssetName () const override |
AZ::EntityId | GetRuntimeEntityId () const override |
VariableId | FindAssetVariableIdByRuntimeVariableId (VariableId runtimeId) const override |
AZ::EntityId | FindAssetNodeIdByRuntimeNodeId (AZ::EntityId editorNode) const override |
AZ::EntityId | FindRuntimeNodeIdByAssetNodeId (AZ::EntityId runtimeNode) const override |
void | RefreshVariableReferences (const VariableId &) override |
const GraphVariableMapping * | GetVariables () const override |
GraphVariable * | FindVariable (AZStd::string_view propName) override |
GraphVariable * | FindVariableById (const VariableId &variableId) override |
Data::Type | GetVariableType (const VariableId &variableId) const |
AZStd::string_view | GetVariableName (const VariableId &variableId) const |
bool | IsGraphObserved () const override |
void | SetIsGraphObserved (bool isObserved) override |
const AZStd::unordered_map < AZ::EntityId, Node * > & | GetNodeMapping () const |
void | VersioningRemoveSlot (ScriptCanvas::Node &scriptCanvasNode, const SlotId &slotId) |
Protected Attributes | |
AZStd::unordered_map < AzToolsFramework::ToastId, AZ::EntityId > | m_toastNodeIds |
bool | m_allowVersionUpdate = false |
AZStd::unordered_set < AZ::EntityId > | m_queuedConvertingNodes |
AZStd::unordered_set < AZ::EntityId > | m_convertingNodes |
AZStd::unordered_multimap < AZ::EntityId, ScriptCanvas::SlotId > | m_versionedSlots |
AZStd::unordered_set < AZStd::string > | m_updateStrings |
AZ::u32 | m_variableCounter |
AZ::EntityId | m_wrapperNodeDropTarget |
VariableComboBoxDataModel | m_variableDataModel |
WrappedNodeGroupingMap | m_wrappedNodeGroupings |
AZStd::vector< AZ::EntityId > | m_lastGraphCanvasCreationGroup |
AZ::Entity * | m_graphCanvasSceneEntity |
GraphCanvas::EntitySaveDataContainer::VersionInformation | m_graphCanvasSaveVersion |
AZStd::unordered_map < AZ::EntityId, GraphCanvas::EntitySaveDataContainer * > | m_graphCanvasSaveData |
AZStd::unordered_map < AZ::Crc32, CRCCache > | m_crcCacheMap |
AZStd::unordered_set < GraphCanvas::GraphicsEffectId > | m_highlights |
GraphCanvas::NodeFocusCyclingHelper | m_focusHelper |
GraphStatisticsHelper | m_statisticsHelper |
UndoHelper | m_undoHelper |
bool | m_ignoreSaveRequests |
bool | m_saveFormatConverted = true |
Defaults to true to signal that this graph does not have the GraphCanvas stuff intermingled. | |
SourceHandle | m_assetId |
![]() | |
GraphData | m_graphData |
AZ::Data::AssetType | m_assetType |
ScriptCanvas::ScriptCanvasData * | m_owner |
Additional Inherited Members | |
![]() | |
static void | GetDependentServices (AZ::ComponentDescriptor::DependencyArrayType &dependent) |
static void | GetIncompatibleServices (AZ::ComponentDescriptor::DependencyArrayType &incompatible) |
static void | GetProvidedServices (AZ::ComponentDescriptor::DependencyArrayType &provided) |
EditorGraph is the editor version of the ScriptCanvas::Graph component that is activated when executing the script canvas engine.