7adf4cc9b5
For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
167 lines
6.7 KiB
XML
167 lines
6.7 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="VisualScriptCustomNode" inherits="VisualScriptNode" version="4.0">
|
|
<brief_description>
|
|
A scripted Visual Script node.
|
|
</brief_description>
|
|
<description>
|
|
A custom Visual Script node which can be scripted in powerful ways.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="_get_caption" qualifiers="virtual">
|
|
<return type="String" />
|
|
<description>
|
|
Return the node's title.
|
|
</description>
|
|
</method>
|
|
<method name="_get_category" qualifiers="virtual">
|
|
<return type="String" />
|
|
<description>
|
|
Return the node's category.
|
|
</description>
|
|
</method>
|
|
<method name="_get_input_value_port_count" qualifiers="virtual">
|
|
<return type="int" />
|
|
<description>
|
|
Return the count of input value ports.
|
|
</description>
|
|
</method>
|
|
<method name="_get_input_value_port_hint" qualifiers="virtual">
|
|
<return type="int" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified input port's hint. See the [enum @GlobalScope.PropertyHint] hints.
|
|
</description>
|
|
</method>
|
|
<method name="_get_input_value_port_hint_string" qualifiers="virtual">
|
|
<return type="String" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified input port's hint string.
|
|
</description>
|
|
</method>
|
|
<method name="_get_input_value_port_name" qualifiers="virtual">
|
|
<return type="String" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified input port's name.
|
|
</description>
|
|
</method>
|
|
<method name="_get_input_value_port_type" qualifiers="virtual">
|
|
<return type="int" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified input port's type. See the [enum Variant.Type] values.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_sequence_port_count" qualifiers="virtual">
|
|
<return type="int" />
|
|
<description>
|
|
Return the amount of output [b]sequence[/b] ports.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_sequence_port_text" qualifiers="virtual">
|
|
<return type="String" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified [b]sequence[/b] output's name.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_value_port_count" qualifiers="virtual">
|
|
<return type="int" />
|
|
<description>
|
|
Return the amount of output value ports.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_value_port_hint" qualifiers="virtual">
|
|
<return type="int" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified output port's hint. See the [enum @GlobalScope.PropertyHint] hints.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_value_port_hint_string" qualifiers="virtual">
|
|
<return type="String" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified output port's hint string.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_value_port_name" qualifiers="virtual">
|
|
<return type="String" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified output port's name.
|
|
</description>
|
|
</method>
|
|
<method name="_get_output_value_port_type" qualifiers="virtual">
|
|
<return type="int" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Return the specified output port's type. See the [enum Variant.Type] values.
|
|
</description>
|
|
</method>
|
|
<method name="_get_text" qualifiers="virtual">
|
|
<return type="String" />
|
|
<description>
|
|
Return the custom node's text, which is shown right next to the input [b]sequence[/b] port (if there is none, on the place that is usually taken by it).
|
|
</description>
|
|
</method>
|
|
<method name="_get_working_memory_size" qualifiers="virtual">
|
|
<return type="int" />
|
|
<description>
|
|
Return the size of the custom node's working memory. See [method _step] for more details.
|
|
</description>
|
|
</method>
|
|
<method name="_has_input_sequence_port" qualifiers="virtual">
|
|
<return type="bool" />
|
|
<description>
|
|
Return whether the custom node has an input [b]sequence[/b] port.
|
|
</description>
|
|
</method>
|
|
<method name="_step" qualifiers="virtual">
|
|
<return type="Variant" />
|
|
<argument index="0" name="inputs" type="Array" />
|
|
<argument index="1" name="outputs" type="Array" />
|
|
<argument index="2" name="start_mode" type="int" />
|
|
<argument index="3" name="working_mem" type="Array" />
|
|
<description>
|
|
Execute the custom node's logic, returning the index of the output sequence port to use or a [String] when there is an error.
|
|
The [code]inputs[/code] array contains the values of the input ports.
|
|
[code]outputs[/code] is an array whose indices should be set to the respective outputs.
|
|
The [code]start_mode[/code] is usually [constant START_MODE_BEGIN_SEQUENCE], unless you have used the [code]STEP_*[/code] constants.
|
|
[code]working_mem[/code] is an array which can be used to persist information between runs of the custom node.
|
|
When returning, you can mask the returned value with one of the [code]STEP_*[/code] constants.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<constants>
|
|
<constant name="START_MODE_BEGIN_SEQUENCE" value="0" enum="StartMode">
|
|
The start mode used the first time when [method _step] is called.
|
|
</constant>
|
|
<constant name="START_MODE_CONTINUE_SEQUENCE" value="1" enum="StartMode">
|
|
The start mode used when [method _step] is called after coming back from a [constant STEP_PUSH_STACK_BIT].
|
|
</constant>
|
|
<constant name="START_MODE_RESUME_YIELD" value="2" enum="StartMode">
|
|
The start mode used when [method _step] is called after resuming from [constant STEP_YIELD_BIT].
|
|
</constant>
|
|
<constant name="STEP_PUSH_STACK_BIT" value="16777216">
|
|
Hint used by [method _step] to tell that control should return to it when there is no other node left to execute.
|
|
This is used by [VisualScriptCondition] to redirect the sequence to the "Done" port after the [code]true[/code]/[code]false[/code] branch has finished execution.
|
|
</constant>
|
|
<constant name="STEP_GO_BACK_BIT" value="33554432">
|
|
Hint used by [method _step] to tell that control should return back, either hitting a previous [constant STEP_PUSH_STACK_BIT] or exiting the function.
|
|
</constant>
|
|
<constant name="STEP_NO_ADVANCE_BIT" value="67108864">
|
|
</constant>
|
|
<constant name="STEP_EXIT_FUNCTION_BIT" value="134217728">
|
|
Hint used by [method _step] to tell that control should stop and exit the function.
|
|
</constant>
|
|
<constant name="STEP_YIELD_BIT" value="268435456">
|
|
Hint used by [method _step] to tell that the function should be yielded.
|
|
Using this requires you to have at least one working memory slot, which is used for the [VisualScriptFunctionState].
|
|
</constant>
|
|
</constants>
|
|
</class>
|