godot_voxel/doc/classes/VoxelGeneratorGraph.xml
Marc Gilleron d5a69003c3 Add missing classes and run doctool (doctool has issues though)
VoxelGeneratorHeightmap.height_range is wrong in the doc.
VoxelTool lost all default values in doc.
These are likely Godot bugs...
2021-11-06 02:04:16 +00:00

323 lines
11 KiB
XML

<?xml version="1.0" encoding="UTF-8" ?>
<class name="VoxelGeneratorGraph" inherits="VoxelGenerator" version="3.5">
<brief_description>
Graph-based generator for smooth voxel worlds.
</brief_description>
<description>
Generates SDF voxel data from a graph of per-voxel operations.
The graph must be created, compiled, and only then blocks can be generated.
Warning: methods to modify the graph should only be called from the main thread.
</description>
<tutorials>
</tutorials>
<methods>
<method name="add_connection">
<return type="void" />
<argument index="0" name="src_node_id" type="int" />
<argument index="1" name="src_port_index" type="int" />
<argument index="2" name="dst_node_id" type="int" />
<argument index="3" name="dst_port_index" type="int" />
<description>
</description>
</method>
<method name="bake_sphere_bumpmap">
<return type="void" />
<argument index="0" name="im" type="Image" />
<argument index="1" name="ref_radius" type="float" />
<argument index="2" name="sdf_min" type="float" />
<argument index="3" name="sdf_max" type="float" />
<description>
</description>
</method>
<method name="bake_sphere_normalmap">
<return type="void" />
<argument index="0" name="im" type="Image" />
<argument index="1" name="ref_radius" type="float" />
<argument index="2" name="strength" type="float" />
<description>
</description>
</method>
<method name="can_connect" qualifiers="const">
<return type="bool" />
<argument index="0" name="src_node_id" type="int" />
<argument index="1" name="src_port_index" type="int" />
<argument index="2" name="dst_node_id" type="int" />
<argument index="3" name="dst_port_index" type="int" />
<description>
Tests if two ports can be connected together.
</description>
</method>
<method name="clear">
<return type="void" />
<description>
Erases all nodes and connections from the graph.
</description>
</method>
<method name="compile">
<return type="Dictionary" />
<description>
Compiles the graph so it can be used to generate blocks.
If it succeeds, the returned result is a dictionary with the following layout:
[codeblock]
{
"success": true
}
[/codeblock]
If it fails, the returned result may contain a message and the ID of a graph node that could be the cause:
[codeblock]
{
"success": false,
"node_id": int,
"message": String
}
[/codeblock]
The node ID will be -1 if the error is not about a particular node.
</description>
</method>
<method name="create_node">
<return type="int" />
<argument index="0" name="type_id" type="int" enum="VoxelGeneratorGraph.NodeTypeID" />
<argument index="1" name="position" type="Vector2" />
<argument index="2" name="id" type="int" default="0" />
<description>
Creates a graph node of a given type at a specific visual position. That position does not affect how the graph will perform, however it helps organizing nodes.
An optional ID can be specified. If left to 0, the ID will be generated.
This function then returns the ID of the node, which may be useful to modify other properties of the node later.
</description>
</method>
<method name="debug_analyze_range" qualifiers="const">
<return type="Vector2" />
<argument index="0" name="min_pos" type="Vector3" />
<argument index="1" name="max_pos" type="Vector3" />
<description>
</description>
</method>
<method name="debug_load_waves_preset">
<return type="void" />
<description>
</description>
</method>
<method name="debug_measure_microseconds_per_voxel">
<return type="float" />
<argument index="0" name="use_singular_queries" type="bool" />
<description>
</description>
</method>
<method name="find_node_by_name" qualifiers="const">
<return type="int" />
<argument index="0" name="name" type="String" />
<description>
</description>
</method>
<method name="generate_single">
<return type="float" />
<argument index="0" name="arg0" type="Vector3" />
<description>
</description>
</method>
<method name="get_connections" qualifiers="const">
<return type="Array" />
<description>
</description>
</method>
<method name="get_node_default_input" qualifiers="const">
<return type="Variant" />
<argument index="0" name="node_id" type="int" />
<argument index="1" name="input_index" type="int" />
<description>
</description>
</method>
<method name="get_node_gui_position" qualifiers="const">
<return type="Vector2" />
<argument index="0" name="node_id" type="int" />
<description>
</description>
</method>
<method name="get_node_ids" qualifiers="const">
<return type="PoolIntArray" />
<description>
</description>
</method>
<method name="get_node_param" qualifiers="const">
<return type="Variant" />
<argument index="0" name="node_id" type="int" />
<argument index="1" name="param_index" type="int" />
<description>
</description>
</method>
<method name="get_node_type_count" qualifiers="const">
<return type="int" />
<description>
</description>
</method>
<method name="get_node_type_id" qualifiers="const">
<return type="int" enum="VoxelGeneratorGraph.NodeTypeID" />
<argument index="0" name="node_id" type="int" />
<description>
</description>
</method>
<method name="get_node_type_info" qualifiers="const">
<return type="Dictionary" />
<argument index="0" name="type_id" type="int" />
<description>
</description>
</method>
<method name="remove_connection">
<return type="void" />
<argument index="0" name="src_node_id" type="int" />
<argument index="1" name="src_port_index" type="int" />
<argument index="2" name="dst_node_id" type="int" />
<argument index="3" name="dst_port_index" type="int" />
<description>
</description>
</method>
<method name="remove_node">
<return type="void" />
<argument index="0" name="node_id" type="int" />
<description>
</description>
</method>
<method name="set_node_default_input">
<return type="void" />
<argument index="0" name="node_id" type="int" />
<argument index="1" name="input_index" type="int" />
<argument index="2" name="value" type="Variant" />
<description>
</description>
</method>
<method name="set_node_gui_position">
<return type="void" />
<argument index="0" name="node_id" type="int" />
<argument index="1" name="position" type="Vector2" />
<description>
</description>
</method>
<method name="set_node_param">
<return type="void" />
<argument index="0" name="node_id" type="int" />
<argument index="1" name="param_index" type="int" />
<argument index="2" name="value" type="Variant" />
<description>
</description>
</method>
<method name="set_node_param_null">
<return type="void" />
<argument index="0" name="node_id" type="int" />
<argument index="1" name="param_index" type="int" />
<description>
</description>
</method>
</methods>
<members>
<member name="debug_block_clipping" type="bool" setter="set_debug_clipped_blocks" getter="is_debug_clipped_blocks" default="false">
</member>
<member name="sdf_clip_threshold" type="float" setter="set_sdf_clip_threshold" getter="get_sdf_clip_threshold" default="1.5">
</member>
<member name="subdivision_size" type="int" setter="set_subdivision_size" getter="get_subdivision_size" default="16">
</member>
<member name="use_optimized_execution_map" type="bool" setter="set_use_optimized_execution_map" getter="is_using_optimized_execution_map" default="true">
</member>
<member name="use_subdivision" type="bool" setter="set_use_subdivision" getter="is_using_subdivision" default="true">
</member>
<member name="use_xz_caching" type="bool" setter="set_use_xz_caching" getter="is_using_xz_caching" default="true">
</member>
</members>
<signals>
<signal name="node_name_changed">
<argument index="0" name="node_id" type="int" />
<description>
</description>
</signal>
</signals>
<constants>
<constant name="NODE_CONSTANT" value="0" enum="NodeTypeID">
</constant>
<constant name="NODE_INPUT_X" value="1" enum="NodeTypeID">
</constant>
<constant name="NODE_INPUT_Y" value="2" enum="NodeTypeID">
</constant>
<constant name="NODE_INPUT_Z" value="3" enum="NodeTypeID">
</constant>
<constant name="NODE_OUTPUT_SDF" value="4" enum="NodeTypeID">
</constant>
<constant name="NODE_ADD" value="5" enum="NodeTypeID">
</constant>
<constant name="NODE_SUBTRACT" value="6" enum="NodeTypeID">
</constant>
<constant name="NODE_MULTIPLY" value="7" enum="NodeTypeID">
</constant>
<constant name="NODE_DIVIDE" value="8" enum="NodeTypeID">
</constant>
<constant name="NODE_SIN" value="9" enum="NodeTypeID">
</constant>
<constant name="NODE_FLOOR" value="10" enum="NodeTypeID">
</constant>
<constant name="NODE_ABS" value="11" enum="NodeTypeID">
</constant>
<constant name="NODE_SQRT" value="12" enum="NodeTypeID">
</constant>
<constant name="NODE_FRACT" value="13" enum="NodeTypeID">
</constant>
<constant name="NODE_STEPIFY" value="14" enum="NodeTypeID">
</constant>
<constant name="NODE_WRAP" value="15" enum="NodeTypeID">
</constant>
<constant name="NODE_MIN" value="16" enum="NodeTypeID">
</constant>
<constant name="NODE_MAX" value="17" enum="NodeTypeID">
</constant>
<constant name="NODE_DISTANCE_2D" value="18" enum="NodeTypeID">
</constant>
<constant name="NODE_DISTANCE_3D" value="19" enum="NodeTypeID">
</constant>
<constant name="NODE_CLAMP" value="20" enum="NodeTypeID">
</constant>
<constant name="NODE_MIX" value="21" enum="NodeTypeID">
</constant>
<constant name="NODE_REMAP" value="22" enum="NodeTypeID">
</constant>
<constant name="NODE_SMOOTHSTEP" value="23" enum="NodeTypeID">
</constant>
<constant name="NODE_CURVE" value="24" enum="NodeTypeID">
</constant>
<constant name="NODE_SELECT" value="25" enum="NodeTypeID">
</constant>
<constant name="NODE_NOISE_2D" value="26" enum="NodeTypeID">
</constant>
<constant name="NODE_NOISE_3D" value="27" enum="NodeTypeID">
</constant>
<constant name="NODE_IMAGE_2D" value="28" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_PLANE" value="29" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_BOX" value="30" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_SPHERE" value="31" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_TORUS" value="32" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_PREVIEW" value="33" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_SPHERE_HEIGHTMAP" value="34" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_SMOOTH_UNION" value="35" enum="NodeTypeID">
</constant>
<constant name="NODE_SDF_SMOOTH_SUBTRACT" value="36" enum="NodeTypeID">
</constant>
<constant name="NODE_NORMALIZE_3D" value="37" enum="NodeTypeID">
</constant>
<constant name="NODE_FAST_NOISE_2D" value="38" enum="NodeTypeID">
</constant>
<constant name="NODE_FAST_NOISE_3D" value="39" enum="NodeTypeID">
</constant>
<constant name="NODE_FAST_NOISE_GRADIENT_2D" value="40" enum="NodeTypeID">
</constant>
<constant name="NODE_FAST_NOISE_GRADIENT_3D" value="41" enum="NodeTypeID">
</constant>
<constant name="NODE_OUTPUT_WEIGHT" value="42" enum="NodeTypeID">
</constant>
<constant name="NODE_TYPE_COUNT" value="43" enum="NodeTypeID">
</constant>
</constants>
</class>