Navigation
API > API/Plugins > API/Plugins/MetasoundEngine
Inheritance Hierarchy
- UObjectBase
- UObjectBaseUtility
- UObject
- UMetaSoundBuilderBase
- UMetaSoundPatchBuilder
- UMetaSoundSourceBuilder
References
| Module | MetasoundEngine |
| Header | /Engine/Plugins/Runtime/Metasound/Source/MetasoundEngine/Public/MetasoundBuilderSubsystem.h |
| Include | #include "MetasoundBuilderSubsystem.h" |
Syntax
UCLASS (Abstract)
class UMetaSoundBuilderBase : public UObject
Remarks
Base implementation of MetaSound builder
Variables
| Type | Name | Description | |
|---|---|---|---|
| bool | bIsAttached | ||
| FNameFMetasoundFrontendLiteralEMetaSoundBuilderResult bool | bIsConstructorInput | ||
| FNameFMetasoundFrontendLiteralEMetaSoundBuilderResult bool | bIsConstructorOutput | ||
| FMetaSoundFrontendDocumentBuilder | Builder | ||
| const FMetaSoundBuilderNodeInputHandle &InputHandle | const | ||
| FName | DataType | ||
| EMetaSoundBuilderResultFName | DataType | ||
| FNameFMetasoundFrontendLiteral | DefaultValue | ||
| FName | InputName | ||
| int32 | MajorVersion | ||
| EMetaSoundBuilderResultint32 | MajorVersion | ||
| FName | OutputName | ||
| FNameEMetaSoundBuilderResult & | OutResult | ||
| int32EMetaSoundBuilderResult & | OutResult | ||
| EMetaSoundBuilderResult & | OutResult | ||
| FNameFMetasoundFrontendLiteralEMetaSoundBuilderResult & | OutResult |
Functions
| Type | Name | Description | |
|---|---|---|---|
| void | AddInterface
(
FName InterfaceName, |
Adds an interface registered with the given name to the graph, adding associated input and output nodes. | |
| TScriptInterface< IMetaSoundDocumentInterface > | Build
(
UObject* Parent, |
||
| UClassType & | BuildInternal
(
UObject* Parent, |
Runs build, conforming the document and corresponding object data on a MetaSound UObject to that managed by this builder. | |
| void | ConnectNodeInputToGraphInput
(
FName GraphInputName, |
Connects a given node input to the graph input with the given name. | |
| void | ConnectNodeOutputToGraphOutput
(
FName GraphOutputName, |
Connects a given node output to the graph output with the given name. | |
| void | ConnectNodes
(
constFMetaSoundBuilderNodeOutputHandle& NodeOutputHandle, |
Connects node output to a node input. | |
| void | ConnectNodesByInterfaceBindings
(
constFMetaSoundNodeHandle& FromNodeHandle, |
Connects two nodes using defined MetaSound Interface Bindings registered with the MetaSound Interface registry. | |
| void | ConvertFromPreset
(
EMetaSoundBuilderResult& OutResult |
Converts this preset to a fully accessible MetaSound; sets result to succeeded if it was converted successfully and failed if it was not. | |
| void | ConvertToPreset
(
constTScriptInterface< IMetaSoundDocumentInterface >& ReferencedNodeClass, |
Convert this builder to a MetaSound source preset with the given referenced source builder. | |
| void | Creates a FrontendBuilder wrapping the transient MetaSound object of the class supported by the given subsystem builder (See GetBuilderUClass). | ||
| UMetaSoundBuilderDocument * | |||
| void | DisconnectNodeInput
(
constFMetaSoundBuilderNodeInputHandle& NodeInputHandle, |
Removes connection to a given node input. Returns success if connection was removed, failed if not. | |
| void | DisconnectNodeOutput
(
constFMetaSoundBuilderNodeOutputHandle& NodeOutputHandle, |
Removes all connections from a given node output. Returns success if all connections were removed, failed if not. | |
| void | DisconnectNodes
(
constFMetaSoundBuilderNodeOutputHandle& NodeOutputHandle, |
Disconnects node output to a node input. Returns success if connection was removed, failed if not. | |
| void | DisconnectNodesByInterfaceBindings
(
constFMetaSoundNodeHandle& FromNodeHandle, |
Disconnects two nodes using defined MetaSound Interface Bindings registered with the MetaSound Interface registry. | |
| constUClass & | Returns the base MetaSound UClass the builder is operating on. | ||
| constFMetaSoundFrontendDocumentBuilder & | |||
| FMetasoundFrontendLiteral | GetNodeInputClassDefault
(
constFMetaSoundBuilderNodeInputHandle& InputHandle, |
Returns node input's class literal value if set, otherwise fails and returns default literal. | |
| void | GetNodeInputData
(
constFMetaSoundBuilderNodeInputHandle& InputHandle, |
Returns node input's data if valid (including things like name and datatype). | |
| FMetasoundFrontendLiteral | GetNodeInputDefault
(
constFMetaSoundBuilderNodeInputHandle& InputHandle, |
Returns node input's literal value if set on graph, otherwise fails and returns default literal. | |
| bool | GetNodeInputIsConstructorPin
(
constFMetaSoundBuilderNodeInputHandle& InputHandle |
Returns whether the given node input is a constructor pin. | |
| void | GetNodeOutputData
(
constFMetaSoundBuilderNodeOutputHandle& OutputHandle, |
Returns node output's data if valid (including things like name and datatype). | |
| bool | GetNodeOutputIsConstructorPin
(
constFMetaSoundBuilderNodeOutputHandle& OutputHandle |
Returns whether the given node output is a constructor pin. | |
| UObject * | Return the asset referenced by this preset builder. Returns nullptr if the builder is not a preset. | ||
| FMetasoundFrontendClassName | Returns the document's root graph class name. | ||
| void | |||
| void | Initializes and ensures all nodes have a position (required prior to exporting to an asset if expected to be viewed in the editor). | ||
| void | |||
| bool | IsPreset () |
Returns whether this is a preset. | |
| void | RegisterGraphIfOutstandingTransactions
(
UObject& InMetaSound |
Only registers provided MetaSound's graph class and referenced graphs recursively if it has yet to be registered or if it has an attached builder reporting outstanding transactions that have yet to be registered. | |
| void | ReloadCache
(
bool bPrimeCache |
Primarily used by editor transaction stack to avoid corruption when object is changed outside of the builder API. | |
| void | RemoveGraphInput
(
FName Name, |
Removes graph input if it exists; sets result to succeeded if it was removed and failed if it was not. | |
| void | RemoveGraphOutput
(
FName Name, |
Removes graph output if it exists; sets result to succeeded if it was removed and failed if it was not. | |
| void | RemoveInterface
(
FName InterfaceName, |
Removes the interface with the given name from the builder's MetaSound. | |
| void | RemoveNode
(
constFMetaSoundNodeHandle& NodeHandle, |
Removes node and any associated connections from the builder's MetaSound. | |
| void | RemoveNodeInputDefault
(
constFMetaSoundBuilderNodeInputHandle& InputHandle, |
Removes node input literal default if set, reverting the value to be whatever the node class defaults the value to. | |
| void | RenameRootGraphClass
(
constFMetasoundFrontendClassName& InName |
Rename the document's root graph class with a guid and optional namespace and variant. | |
| void | Sets the author of the MetaSound. | ||
| void | SetGraphInputDefault
(
FName InputName, |
Sets the input node's default value, overriding the default provided by the referenced graph if the graph is a preset. | |
| void | SetNodeInputDefault
(
constFMetaSoundBuilderNodeInputHandle& NodeInputHandle, |
Sets the node's input default value (used if no connection to the given node input is present) | |
| void | SetNodeLocation
(
constFMetaSoundNodeHandle& InNodeHandle, |
||
UPARAM
(
DisplayName |
Returns node inputs by the given DataType (ex. "Audio", "Trigger", "String", "Bool", "Float", "Int32", etc.). | ||
UPARAM
(
DisplayName |
Returns node output by the given name. | ||
UPARAM
(
DisplayName |
Returns all node outputs. | ||
UPARAM
(
DisplayName |
Returns node outputs by the given DataType (ex. "Audio", "Trigger", "String", "Bool", "Float", "Int32", etc.). | ||
UPARAM
(
DisplayName |
|||
UPARAM
(
DisplayName |
Returns output's parent node if the input is valid, otherwise returns invalid node handle. | ||
UPARAM
(
DisplayName |
Returns input's parent node if the input is valid, otherwise returns invalid node handle. | ||
UPARAM
(
DisplayName |
Returns output's parent node if the input is valid, otherwise returns invalid node handle. | ||
UPARAM
(
DisplayName |
Returns all node inputs. | ||
UPARAM
(
DisplayName |
Returns if a given interface is declared. | ||
UPARAM
(
DisplayName |
Returns if a given node output and node input are connected. | ||
UPARAM
(
DisplayName |
|||
UPARAM
(
DisplayName |
Returns node input by the given name if it exists, or an invalid handle if not found. | ||
UPARAM
(
DisplayName |
Returns whether node output exists. | ||
UPARAM
(
DisplayName |
Returns graph input node by the given name if it exists, or an invalid handle if not found. | ||
UPARAM
(
DisplayName |
Returns if a given node input has connections. | ||
UPARAM
(
DisplayName |
Returns whether node input exists. | ||
UPARAM
(
DisplayName |
Returns whether node exists. | ||
UPARAM
(
DisplayName |
Connects a given node's inputs to all graph inputs for shared interfaces implemented on both the node's referenced class and the builder's MetaSound graph. Returns outputs of connected input nodes. | ||
UPARAM
(
DisplayName |
Connects a given node's outputs to all graph outputs for shared interfaces implemented on both the node's referenced class and the builder's MetaSound graph. Returns inputs of connected output nodes. | ||
UPARAM
(
DisplayName |
|||
UPARAM
(
DisplayName |
Adds node referencing the highest native class version of the given class name to the document. | ||
UPARAM
(
DisplayName |
Adds a node to the graph using the provided MetaSound asset as its defining NodeClass. | ||
UPARAM
(
DisplayName |
Adds a graph output node with the given name, DataType, and sets output node's input to default value. | ||
UPARAM
(
DisplayName |
Adds a graph input node with the given name, DataType, and sets the graph input to default value. | ||
UPARAM
(
DisplayName |
Returns graph output node by the given name if it exists, or an invalid handle if not found. | ||
UPARAM
(
DisplayName |
Returns if a given node output is connected. | ||
| void | UpdateDependencyClassNames
(
constTMap< FMetasoundFrontendClassName, FMetasoundFrontendClassName >& OldToNewReferencedClassNames |
Update dependency class names given a map of old to new referenced class names. |
Overridden from UObject
| Type | Name | Description | |
|---|---|---|---|
| void | BeginDestroy () |
Called before destroying the object. |