summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/classes/AStar.xml4
-rw-r--r--doc/classes/Animation.xml28
-rw-r--r--doc/classes/AnimationPlayer.xml40
-rw-r--r--doc/classes/AnimationTreePlayer.xml90
-rw-r--r--doc/classes/Array.xml10
-rw-r--r--doc/classes/CanvasItem.xml28
-rw-r--r--doc/classes/ConcavePolygonShape2D.xml1
-rw-r--r--doc/classes/CubeMap.xml29
-rw-r--r--doc/classes/EditorFileSystem.xml2
-rw-r--r--doc/classes/EditorPlugin.xml22
-rw-r--r--doc/classes/EditorResourceConversionPlugin.xml2
-rw-r--r--doc/classes/EditorSceneImporter.xml95
-rw-r--r--doc/classes/FileDialog.xml3
-rw-r--r--doc/classes/HTTPClient.xml104
-rw-r--r--doc/classes/HTTPRequest.xml23
-rw-r--r--doc/classes/IP.xml14
-rw-r--r--doc/classes/IP_Unix.xml2
-rw-r--r--doc/classes/KinematicBody.xml12
-rw-r--r--doc/classes/Mesh.xml4
-rw-r--r--doc/classes/MeshInstance.xml7
-rw-r--r--doc/classes/Node.xml2
-rw-r--r--doc/classes/PhysicsServer.xml40
-rw-r--r--doc/classes/PopupMenu.xml32
-rw-r--r--doc/classes/Rect2.xml6
-rw-r--r--doc/classes/RigidBody.xml21
-rw-r--r--doc/classes/SurfaceTool.xml2
-rw-r--r--doc/classes/TextEdit.xml11
-rw-r--r--doc/classes/Texture.xml10
-rw-r--r--doc/classes/TileMap.xml32
-rw-r--r--doc/classes/TileSet.xml4
-rw-r--r--doc/classes/VisualServer.xml284
31 files changed, 775 insertions, 189 deletions
diff --git a/doc/classes/AStar.xml b/doc/classes/AStar.xml
index eefdf4d7a7..e0e3261edf 100644
--- a/doc/classes/AStar.xml
+++ b/doc/classes/AStar.xml
@@ -13,7 +13,7 @@
</demos>
<methods>
<method name="_compute_cost" qualifiers="virtual">
- <return type="void">
+ <return type="float">
</return>
<argument index="0" name="from_id" type="int">
</argument>
@@ -24,7 +24,7 @@
</description>
</method>
<method name="_estimate_cost" qualifiers="virtual">
- <return type="void">
+ <return type="float">
</return>
<argument index="0" name="from_id" type="int">
</argument>
diff --git a/doc/classes/Animation.xml b/doc/classes/Animation.xml
index c3933443a0..93b01a466b 100644
--- a/doc/classes/Animation.xml
+++ b/doc/classes/Animation.xml
@@ -30,6 +30,16 @@
Clear the animation (clear all tracks and reset all).
</description>
</method>
+ <method name="copy_track">
+ <return type="void">
+ </return>
+ <argument index="0" name="track" type="int">
+ </argument>
+ <argument index="1" name="to_animation" type="Animation">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="find_track" qualifiers="const">
<return type="int">
</return>
@@ -244,6 +254,14 @@
Insert a generic key in a given track.
</description>
</method>
+ <method name="track_is_enabled" qualifiers="const">
+ <return type="bool">
+ </return>
+ <argument index="0" name="idx" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="track_is_imported" qualifiers="const">
<return type="bool">
</return>
@@ -293,6 +311,16 @@
Remove a key by position (seconds) in a given track.
</description>
</method>
+ <method name="track_set_enabled">
+ <return type="void">
+ </return>
+ <argument index="0" name="idx" type="int">
+ </argument>
+ <argument index="1" name="enabled" type="bool">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="track_set_imported">
<return type="void">
</return>
diff --git a/doc/classes/AnimationPlayer.xml b/doc/classes/AnimationPlayer.xml
index 3b1ce37619..d61211bb6b 100644
--- a/doc/classes/AnimationPlayer.xml
+++ b/doc/classes/AnimationPlayer.xml
@@ -74,20 +74,6 @@
Returns the name of [code]animation[/code] or empty string if not found.
</description>
</method>
- <method name="get_anim_length" qualifiers="const">
- <return type="float">
- </return>
- <description>
- Get the length (in seconds) of the currently playing animation.
- </description>
- </method>
- <method name="get_anim_position" qualifiers="const">
- <return type="float">
- </return>
- <description>
- Get the position (in seconds) of the currently playing animation.
- </description>
- </method>
<method name="get_animation" qualifiers="const">
<return type="Animation">
</return>
@@ -115,11 +101,18 @@
Get the blend time (in seconds) between two animations, referenced by their names.
</description>
</method>
- <method name="get_current_animation" qualifiers="const">
- <return type="String">
+ <method name="get_current_animation_length" qualifiers="const">
+ <return type="float">
</return>
<description>
- Returns the name of the currently playing animation.
+ Get the length (in seconds) of the currently playing animation.
+ </description>
+ </method>
+ <method name="get_current_animation_position" qualifiers="const">
+ <return type="float">
+ </return>
+ <description>
+ Get the position (in seconds) of the currently playing animation.
</description>
</method>
<method name="has_animation" qualifiers="const">
@@ -217,15 +210,6 @@
Specify a blend time (in seconds) between two animations, referenced by their names.
</description>
</method>
- <method name="set_current_animation">
- <return type="void">
- </return>
- <argument index="0" name="anim" type="String">
- </argument>
- <description>
- Set the current animation (even if no playback occurs). Using set_current_animation() and set_active() are similar to calling play().
- </description>
- </method>
<method name="stop">
<return type="void">
</return>
@@ -250,8 +234,10 @@
<member name="autoplay" type="String" setter="set_autoplay" getter="get_autoplay">
The name of the animation to play when the scene loads. Default value: [code]""[/code].
</member>
+ <member name="current_animation" type="String" setter="set_current_animation" getter="get_current_animation">
+ The name of the current animation. Default value: [code]""[/code].
+ </member>
<member name="playback_default_blend_time" type="float" setter="set_default_blend_time" getter="get_default_blend_time">
- The default time in which to blend animations. Ranges from 0 to 4096 with 0.01 precision. Default value: [code]0[/code].
</member>
<member name="playback_process_mode" type="int" setter="set_animation_process_mode" getter="get_animation_process_mode" enum="AnimationPlayer.AnimationProcessMode">
The process notification in which to update animations. Default value: [enum ANIMATION_PROCESS_IDLE].
diff --git a/doc/classes/AnimationTreePlayer.xml b/doc/classes/AnimationTreePlayer.xml
index 4fb33eb5a3..ecd1f81951 100644
--- a/doc/classes/AnimationTreePlayer.xml
+++ b/doc/classes/AnimationTreePlayer.xml
@@ -4,7 +4,7 @@
Animation Player that uses a node graph for the blending.
</brief_description>
<description>
- Animation Player that uses a node graph for the blending. This kind of player is very useful when animating character or other skeleton based rigs, because it can combine several animations to form a desired pose.
+ A node graph tool for blending multiple animations bound to an [AnimationPlayer]. Especially useful for animating characters or other skeleton-based rigs. It can combine several animations to form a desired pose.
</description>
<tutorials>
</tutorials>
@@ -19,7 +19,7 @@
<argument index="1" name="id" type="String">
</argument>
<description>
- Add a node of a given type in the graph with given id.
+ Adds a [code]type[/code] node to the graph with name [code]id[/code].
</description>
</method>
<method name="advance">
@@ -28,6 +28,7 @@
<argument index="0" name="delta" type="float">
</argument>
<description>
+ Shifts position in the animation timeline. Delta is the time in seconds to shift.
</description>
</method>
<method name="animation_node_get_animation" qualifiers="const">
@@ -36,7 +37,7 @@
<argument index="0" name="id" type="String">
</argument>
<description>
- Returns an animation given its name.
+ Returns the [AnimationPlayer]'s animation bound to the [code]AnimationTreePlayer[/code]'s animation node with name [code]id[/code].
</description>
</method>
<method name="animation_node_get_master_animation" qualifiers="const">
@@ -45,6 +46,7 @@
<argument index="0" name="id" type="String">
</argument>
<description>
+ Returns the name of the [member master_player]'s animation bound to this animation node.
</description>
</method>
<method name="animation_node_set_animation">
@@ -55,7 +57,7 @@
<argument index="1" name="animation" type="Animation">
</argument>
<description>
- Set the animation for an animation node.
+ Binds a new animation from the [member master_player] to the [code]AnimationTreePlayer[/code]'s animation node with name [code]id[/code].
</description>
</method>
<method name="animation_node_set_filter_path">
@@ -68,6 +70,7 @@
<argument index="2" name="enable" type="bool">
</argument>
<description>
+ If [code]enable[/code] is [code]true[/code], the animation node with ID [code]id[/code] turns off the track modifying the property at [code]path[/code]. The modified node's children continue to animate.
</description>
</method>
<method name="animation_node_set_master_animation">
@@ -78,6 +81,7 @@
<argument index="1" name="source" type="String">
</argument>
<description>
+ Binds the animation named [code]source[/code] from [member master_player] to the animation node [code]id[/code]. Recalculates caches.
</description>
</method>
<method name="are_nodes_connected" qualifiers="const">
@@ -123,6 +127,7 @@
<argument index="2" name="enable" type="bool">
</argument>
<description>
+ If [code]enable[/code] is [code]true[/code], the blend2 node with ID [code]id[/code] turns off the track modifying the property at [code]path[/code]. The modified node's children continue to animate.
</description>
</method>
<method name="blend3_node_get_amount" qualifiers="const">
@@ -189,18 +194,6 @@
Disconnects nodes connected to [code]id[/code] at the specified input slot.
</description>
</method>
- <method name="get_base_path" qualifiers="const">
- <return type="NodePath">
- </return>
- <description>
- </description>
- </method>
- <method name="get_master_player" qualifiers="const">
- <return type="NodePath">
- </return>
- <description>
- </description>
- </method>
<method name="get_node_list">
<return type="PoolStringArray">
</return>
@@ -208,13 +201,6 @@
Returns a PoolStringArray containing the name of all nodes.
</description>
</method>
- <method name="is_active" qualifiers="const">
- <return type="bool">
- </return>
- <description>
- Returns whether this AnimationTreePlayer is active.
- </description>
- </method>
<method name="mix_node_get_amount" qualifiers="const">
<return type="float">
</return>
@@ -423,6 +409,7 @@
<argument index="2" name="enable" type="bool">
</argument>
<description>
+ If [code]enable[/code] is [code]true[/code], the oneshot node with ID [code]id[/code] turns off the track modifying the property at [code]path[/code]. The modified node's children continue to animate.
</description>
</method>
<method name="oneshot_node_start">
@@ -440,13 +427,14 @@
<argument index="0" name="id" type="String">
</argument>
<description>
- Stops a OneShot node given its name.
+ Stops the OneShot node with name [code]id[/code].
</description>
</method>
<method name="recompute_caches">
<return type="void">
</return>
<description>
+ Manually recalculates the cache of track information generated from animation nodes. Needed when external sources modify the animation nodes' state.
</description>
</method>
<method name="remove_node">
@@ -455,6 +443,7 @@
<argument index="0" name="id" type="String">
</argument>
<description>
+ Removes the animation node with name [code]id[/code].
</description>
</method>
<method name="reset">
@@ -464,39 +453,13 @@
Resets this AnimationTreePlayer.
</description>
</method>
- <method name="set_active">
- <return type="void">
- </return>
- <argument index="0" name="enabled" type="bool">
- </argument>
- <description>
- Sets whether this AnimationTreePlayer is active. AnimationTreePlayer will start processing if set to active.
- </description>
- </method>
- <method name="set_base_path">
- <return type="void">
- </return>
- <argument index="0" name="path" type="NodePath">
- </argument>
- <description>
- Sets base path of this AnimationTreePlayer.
- </description>
- </method>
- <method name="set_master_player">
- <return type="void">
- </return>
- <argument index="0" name="nodepath" type="NodePath">
- </argument>
- <description>
- </description>
- </method>
<method name="timescale_node_get_scale" qualifiers="const">
<return type="float">
</return>
<argument index="0" name="id" type="String">
</argument>
<description>
- Returns time scale value of a TimeScale node given its name.
+ Returns time scale value of the TimeScale node with name [code]id[/code].
</description>
</method>
<method name="timescale_node_set_scale">
@@ -507,7 +470,7 @@
<argument index="1" name="scale" type="float">
</argument>
<description>
- Sets time scale value of a TimeScale node given its name and value.
+ Sets the time scale of the TimeScale node with name [code]id[/code] to [code]scale[/code].
</description>
</method>
<method name="timeseek_node_seek">
@@ -518,7 +481,7 @@
<argument index="1" name="seconds" type="float">
</argument>
<description>
- Sets time seek value of a TimeSeek node given its name and value.
+ Sets the time seek value of the TimeSeek node with name [code]id[/code] to [code]seconds[/code]
</description>
</method>
<method name="transition_node_delete_input">
@@ -529,6 +492,7 @@
<argument index="1" name="input_idx" type="int">
</argument>
<description>
+ Deletes the input at [code]input_idx[/code] for the transition node with name [code]id[/code].
</description>
</method>
<method name="transition_node_get_current" qualifiers="const">
@@ -537,6 +501,7 @@
<argument index="0" name="id" type="String">
</argument>
<description>
+ Returns the index of the currently evaluated input for the transition node with name [code]id[/code].
</description>
</method>
<method name="transition_node_get_input_count" qualifiers="const">
@@ -545,6 +510,7 @@
<argument index="0" name="id" type="String">
</argument>
<description>
+ Returns the number of inputs for the transition node with name [code]id[/code].
</description>
</method>
<method name="transition_node_get_xfade_time" qualifiers="const">
@@ -553,6 +519,7 @@
<argument index="0" name="id" type="String">
</argument>
<description>
+ Returns the cross fade time for the transition node with name [code]id[/code].
</description>
</method>
<method name="transition_node_has_input_auto_advance" qualifiers="const">
@@ -563,6 +530,7 @@
<argument index="1" name="input_idx" type="int">
</argument>
<description>
+ Returns [code]true[/code] if the input at [code]input_idx[/code] on transition node with name [code]id[/code] is set to automatically advance to the next input upon completion.
</description>
</method>
<method name="transition_node_set_current">
@@ -573,6 +541,7 @@
<argument index="1" name="input_idx" type="int">
</argument>
<description>
+ The transition node with name [code]id[/code] sets its current input at [code]input_idx[/code].
</description>
</method>
<method name="transition_node_set_input_auto_advance">
@@ -585,6 +554,7 @@
<argument index="2" name="enable" type="bool">
</argument>
<description>
+ The transition node with name [code]id[/code] advances to its next input automatically when the input at [code]input_idx[/code] completes.
</description>
</method>
<method name="transition_node_set_input_count">
@@ -595,6 +565,7 @@
<argument index="1" name="count" type="int">
</argument>
<description>
+ Resizes the number of inputs available for the transition node with name [code]id[/code].
</description>
</method>
<method name="transition_node_set_xfade_time">
@@ -605,11 +576,22 @@
<argument index="1" name="time_sec" type="float">
</argument>
<description>
+ The transition node with name [code]id[/code] sets its cross fade time to [code]time_sec[/code].
</description>
</method>
</methods>
<members>
+ <member name="active" type="bool" setter="set_active" getter="is_active">
+ If [code]true[/code] the [code]AnimationTreePlayer[/code] is able to play animations. Default value: [code]false[/code].
+ </member>
+ <member name="base_path" type="NodePath" setter="set_base_path" getter="get_base_path">
+ The node from which to relatively access other nodes. Default value: [code]".."[/code].
+ </member>
+ <member name="master_player" type="NodePath" setter="set_master_player" getter="get_master_player">
+ The path to the [AnimationPlayer] from which this [code]AnimationTreePlayer[/code] binds animations to animation nodes.
+ </member>
<member name="playback_process_mode" type="int" setter="set_animation_process_mode" getter="get_animation_process_mode" enum="AnimationTreePlayer.AnimationProcessMode">
+ The thread in which to update animations. Default value: [enum ANIMATION_PROCESS_IDLE].
</member>
</members>
<constants>
@@ -644,8 +626,10 @@
Transition node.
</constant>
<constant name="ANIMATION_PROCESS_PHYSICS" value="0" enum="AnimationProcessMode">
+ Process animation during the physics process. This is especially useful when animating physics bodies.
</constant>
<constant name="ANIMATION_PROCESS_IDLE" value="1" enum="AnimationProcessMode">
+ Process animation during the idle process.
</constant>
</constants>
</class>
diff --git a/doc/classes/Array.xml b/doc/classes/Array.xml
index a7f9a6e09c..9445a1732e 100644
--- a/doc/classes/Array.xml
+++ b/doc/classes/Array.xml
@@ -284,6 +284,16 @@
</argument>
<description>
Sort the array using a custom method and return reference to the array. The arguments are an object that holds the method and the name of such method. The custom method receives two arguments (a pair of elements from the array) and must return true if the first argument is less than the second, and return false otherwise. Note: you cannot randomize the return value as the heapsort algorithm expects a deterministic result. Doing so will result in unexpected behavior.
+ [codeblock]
+ class MyCustomSorter:
+ static func sort(a, b):
+ if a[0] &lt; b[0]:
+ return true
+ return false
+
+ var my_items = [[5, "Potato"], [9, "Rice"], [4, "Tomato"]]
+ my_items.sort_custom(MyCustomSorter, "sort")
+ [/codeblock]
</description>
</method>
</methods>
diff --git a/doc/classes/CanvasItem.xml b/doc/classes/CanvasItem.xml
index 4a567981e6..cf0b482b07 100644
--- a/doc/classes/CanvasItem.xml
+++ b/doc/classes/CanvasItem.xml
@@ -88,6 +88,34 @@
Draw a line from a 2D point to another, with a given color and width. It can be optionally antialiased.
</description>
</method>
+ <method name="draw_multiline">
+ <return type="void">
+ </return>
+ <argument index="0" name="points" type="PoolVector2Array">
+ </argument>
+ <argument index="1" name="color" type="Color">
+ </argument>
+ <argument index="2" name="width" type="float" default="1.0">
+ </argument>
+ <argument index="3" name="antialiased" type="bool" default="false">
+ </argument>
+ <description>
+ </description>
+ </method>
+ <method name="draw_multiline_colors">
+ <return type="void">
+ </return>
+ <argument index="0" name="points" type="PoolVector2Array">
+ </argument>
+ <argument index="1" name="colors" type="PoolColorArray">
+ </argument>
+ <argument index="2" name="width" type="float" default="1.0">
+ </argument>
+ <argument index="3" name="antialiased" type="bool" default="false">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="draw_polygon">
<return type="void">
</return>
diff --git a/doc/classes/ConcavePolygonShape2D.xml b/doc/classes/ConcavePolygonShape2D.xml
index 1910b1d62d..1d2aabd6ea 100644
--- a/doc/classes/ConcavePolygonShape2D.xml
+++ b/doc/classes/ConcavePolygonShape2D.xml
@@ -15,6 +15,7 @@
</methods>
<members>
<member name="segments" type="PoolVector2Array" setter="set_segments" getter="get_segments">
+ The array of points that make up the [code]ConcavePolygonShape2D[/code]'s line segments.
</member>
</members>
<constants>
diff --git a/doc/classes/CubeMap.xml b/doc/classes/CubeMap.xml
index a7857dba78..30022efd38 100644
--- a/doc/classes/CubeMap.xml
+++ b/doc/classes/CubeMap.xml
@@ -4,7 +4,7 @@
A CubeMap is a 6 sided 3D texture.
</brief_description>
<description>
- A CubeMap is a 6 sided 3D texture typically used for faking reflections. It can be used to make an object look as if it's reflecting its surroundings. This usually delivers much better performance than other reflection methods.
+ A 6-sided 3D texture typically used for faking reflections. It can be used to make an object look as if it's reflecting its surroundings. This usually delivers much better performance than other reflection methods.
</description>
<tutorials>
</tutorials>
@@ -15,13 +15,14 @@
<return type="int">
</return>
<description>
+ Returns the render flags for the [code]CubeMap[/code]. See the [code]FLAG_*[/code] constants for details.
</description>
</method>
<method name="get_height" qualifiers="const">
<return type="int">
</return>
<description>
- Returns the CubeMap's height.
+ Returns the [code]CubeMap[/code]'s height.
</description>
</method>
<method name="get_side" qualifiers="const">
@@ -30,14 +31,14 @@
<argument index="0" name="side" type="int" enum="CubeMap.Side">
</argument>
<description>
- Returns an [Image] for a side of the CubeMap using one of the [code]SIDE_*[/code] constants or an integer 0-5.
+ Returns an [Image] for a side of the [code]CubeMap[/code] using one of the [code]SIDE_*[/code] constants or an integer 0-5.
</description>
</method>
<method name="get_width" qualifiers="const">
<return type="int">
</return>
<description>
- Returns the CubeMap's width.
+ Returns the [code]CubeMap[/code]'s width.
</description>
</method>
<method name="set_flags">
@@ -46,6 +47,7 @@
<argument index="0" name="flags" type="int">
</argument>
<description>
+ Returns the render flags for the [code]CubeMap[/code]. See the [code]FLAG_*[/code] constants for details.
</description>
</method>
<method name="set_side">
@@ -56,44 +58,57 @@
<argument index="1" name="image" type="Image">
</argument>
<description>
- Sets an [Image] for a side of the CubeMap using one of the [code]SIDE_*[/code] constants or an integer 0-5.
+ Sets an [Image] for a side of the [code]CubeMap[/code] using one of the [code]SIDE_*[/code] constants or an integer 0-5.
</description>
</method>
</methods>
<members>
<member name="lossy_storage_quality" type="float" setter="set_lossy_storage_quality" getter="get_lossy_storage_quality">
- The lossy storage quality of the CubeMap if the storage mode is set to STORAGE_COMPRESS_LOSSY.
+ The lossy storage quality of the [code]CubeMap[/code] if the storage mode is set to STORAGE_COMPRESS_LOSSY.
</member>
<member name="storage_mode" type="int" setter="set_storage" getter="get_storage" enum="CubeMap.Storage">
- The CubeMap's storage mode. See [code]STORAGE_*[/code] constants.
+ The [code]CubeMap[/code]'s storage mode. See [code]STORAGE_*[/code] constants.
</member>
</members>
<constants>
<constant name="STORAGE_RAW" value="0" enum="Storage">
+ Store the [code]CubeMap[/code] without any compression.
</constant>
<constant name="STORAGE_COMPRESS_LOSSY" value="1" enum="Storage">
+ Store the [code]CubeMap[/code] with strong compression that reduces image quality.
</constant>
<constant name="STORAGE_COMPRESS_LOSSLESS" value="2" enum="Storage">
+ Store the [code]CubeMap[/code] with moderate compression that doesn't reduce image quality.
</constant>
<constant name="SIDE_LEFT" value="0" enum="Side">
+ Identifier for the left face of the [code]CubeMap[/code].
</constant>
<constant name="SIDE_RIGHT" value="1" enum="Side">
+ Identifier for the right face of the [code]CubeMap[/code].
</constant>
<constant name="SIDE_BOTTOM" value="2" enum="Side">
+ Identifier for the bottom face of the [code]CubeMap[/code].
</constant>
<constant name="SIDE_TOP" value="3" enum="Side">
+ Identifier for the top face of the [code]CubeMap[/code].
</constant>
<constant name="SIDE_FRONT" value="4" enum="Side">
+ Identifier for the front face of the [code]CubeMap[/code].
</constant>
<constant name="SIDE_BACK" value="5" enum="Side">
+ Identifier for the back face of the [code]CubeMap[/code].
</constant>
<constant name="FLAG_MIPMAPS" value="1" enum="Flags">
+ Generate mipmaps, to enable smooth zooming out of the texture.
</constant>
<constant name="FLAG_REPEAT" value="2" enum="Flags">
+ Repeat (instead of clamp to edge).
</constant>
<constant name="FLAG_FILTER" value="4" enum="Flags">
+ Turn on magnifying filter, to enable smooth zooming in of the texture.
</constant>
<constant name="FLAGS_DEFAULT" value="7" enum="Flags">
+ Default flags. Generate mipmaps, repeat, and filter are enabled.
</constant>
</constants>
</class>
diff --git a/doc/classes/EditorFileSystem.xml b/doc/classes/EditorFileSystem.xml
index f577a4676f..54b3accb19 100644
--- a/doc/classes/EditorFileSystem.xml
+++ b/doc/classes/EditorFileSystem.xml
@@ -33,6 +33,7 @@
<argument index="0" name="path" type="String">
</argument>
<description>
+ Returns a view into the filesystem at [code]path[/code].
</description>
</method>
<method name="get_scanning_progress" qualifiers="const">
@@ -83,6 +84,7 @@
<argument index="0" name="resources" type="PoolStringArray">
</argument>
<description>
+ Remitted if a resource is reimported.
</description>
</signal>
<signal name="sources_changed">
diff --git a/doc/classes/EditorPlugin.xml b/doc/classes/EditorPlugin.xml
index edd1f721b5..ada0ee56a8 100644
--- a/doc/classes/EditorPlugin.xml
+++ b/doc/classes/EditorPlugin.xml
@@ -82,6 +82,14 @@
<description>
</description>
</method>
+ <method name="add_scene_import_plugin">
+ <return type="void">
+ </return>
+ <argument index="0" name="scene_importer" type="EditorSceneImporter">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="add_tool_submenu_item">
<return type="void">
</return>
@@ -176,6 +184,12 @@
<description>
</description>
</method>
+ <method name="get_plugin_icon" qualifiers="virtual">
+ <return type="Object">
+ </return>
+ <description>
+ </description>
+ </method>
<method name="get_plugin_name" qualifiers="virtual">
<return type="String">
</return>
@@ -295,6 +309,14 @@
<description>
</description>
</method>
+ <method name="remove_scene_import_plugin">
+ <return type="void">
+ </return>
+ <argument index="0" name="scene_importer" type="EditorSceneImporter">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="save_external_data" qualifiers="virtual">
<return type="void">
</return>
diff --git a/doc/classes/EditorResourceConversionPlugin.xml b/doc/classes/EditorResourceConversionPlugin.xml
index b2bbe69061..8d6aa3a605 100644
--- a/doc/classes/EditorResourceConversionPlugin.xml
+++ b/doc/classes/EditorResourceConversionPlugin.xml
@@ -18,7 +18,7 @@
</description>
</method>
<method name="_converts_to" qualifiers="virtual">
- <return type="bool">
+ <return type="String">
</return>
<description>
</description>
diff --git a/doc/classes/EditorSceneImporter.xml b/doc/classes/EditorSceneImporter.xml
new file mode 100644
index 0000000000..69fe4050f4
--- /dev/null
+++ b/doc/classes/EditorSceneImporter.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<class name="EditorSceneImporter" inherits="Reference" category="Core" version="3.0-beta">
+ <brief_description>
+ </brief_description>
+ <description>
+ </description>
+ <tutorials>
+ </tutorials>
+ <demos>
+ </demos>
+ <methods>
+ <method name="_get_extensions" qualifiers="virtual">
+ <return type="Array">
+ </return>
+ <description>
+ </description>
+ </method>
+ <method name="_get_import_flags" qualifiers="virtual">
+ <return type="int">
+ </return>
+ <description>
+ </description>
+ </method>
+ <method name="_import_animation" qualifiers="virtual">
+ <return type="Animation">
+ </return>
+ <argument index="0" name="path" type="String">
+ </argument>
+ <argument index="1" name="flags" type="int">
+ </argument>
+ <argument index="2" name="bake_fps" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
+ <method name="_import_scene" qualifiers="virtual">
+ <return type="Node">
+ </return>
+ <argument index="0" name="path" type="String">
+ </argument>
+ <argument index="1" name="flags" type="int">
+ </argument>
+ <argument index="2" name="bake_fps" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
+ <method name="import_animation_from_other_importer">
+ <return type="Animation">
+ </return>
+ <argument index="0" name="path" type="String">
+ </argument>
+ <argument index="1" name="flags" type="int">
+ </argument>
+ <argument index="2" name="bake_fps" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
+ <method name="import_scene_from_other_importer">
+ <return type="Node">
+ </return>
+ <argument index="0" name="path" type="String">
+ </argument>
+ <argument index="1" name="flags" type="int">
+ </argument>
+ <argument index="2" name="bake_fps" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
+ </methods>
+ <constants>
+ <constant name="IMPORT_SCENE" value="1">
+ </constant>
+ <constant name="IMPORT_ANIMATION" value="2">
+ </constant>
+ <constant name="IMPORT_ANIMATION_DETECT_LOOP" value="4">
+ </constant>
+ <constant name="IMPORT_ANIMATION_OPTIMIZE" value="8">
+ </constant>
+ <constant name="IMPORT_ANIMATION_FORCE_ALL_TRACKS_IN_ALL_CLIPS" value="16">
+ </constant>
+ <constant name="IMPORT_ANIMATION_KEEP_VALUE_TRACKS" value="32">
+ </constant>
+ <constant name="IMPORT_GENERATE_TANGENT_ARRAYS" value="256">
+ </constant>
+ <constant name="IMPORT_FAIL_ON_MISSING_DEPENDENCIES" value="512">
+ </constant>
+ <constant name="IMPORT_MATERIALS_IN_INSTANCES" value="1024">
+ </constant>
+ <constant name="IMPORT_USE_COMPRESSION" value="2048">
+ </constant>
+ </constants>
+</class>
diff --git a/doc/classes/FileDialog.xml b/doc/classes/FileDialog.xml
index 8057e95d44..3387b4a2ed 100644
--- a/doc/classes/FileDialog.xml
+++ b/doc/classes/FileDialog.xml
@@ -103,6 +103,9 @@
</member>
<member name="mode" type="int" setter="set_mode" getter="get_mode" enum="FileDialog.Mode">
</member>
+ <member name="mode_overrides_title" type="bool" setter="set_mode_overrides_title" getter="is_mode_overriding_title">
+ If [code]true[/code], changing the [code]mode[/code] property will set the window title accordingly (e. g. setting mode to [code]MODE_OPEN_FILE[/code] will change the window title to "Open a File").
+ </member>
<member name="show_hidden_files" type="bool" setter="set_show_hidden_files" getter="is_showing_hidden_files">
</member>
</members>
diff --git a/doc/classes/HTTPClient.xml b/doc/classes/HTTPClient.xml
index b1526b64c5..b90c49b5c0 100644
--- a/doc/classes/HTTPClient.xml
+++ b/doc/classes/HTTPClient.xml
@@ -4,8 +4,10 @@
Hyper-text transfer protocol client.
</brief_description>
<description>
- Hyper-text transfer protocol client. Supports SSL and SSL server certificate verification.
- Can be reused to connect to different hosts and make many requests.
+ Hyper-text transfer protocol client (sometimes called "User Agent"). Used to make HTTP requests to download web content, upload files and other data or to communicate with various services, among other use cases.
+ Note that this client only needs to connect to a host once (see [method connect_to_host]) to send multiple requests. Because of this, methods that take URLs usually take just the part after the host instead of the full URL, as the client is already connected to a host. See [method request] for a full example and to get started.
+ A [code]HTTPClient[/code] should be reused between multiple requests or to connect to different hosts instead of creating one client per request. Supports SSL and SSL server certificate verification. HTTP status codes in the 2xx range indicate success, 3xx redirection (i.e. "try again, but over here"), 4xx something was wrong with the request, and 5xx something went wrong on the server's side.
+ For more information on HTTP, see https://developer.mozilla.org/en-US/docs/Web/HTTP (or read RFC 2616 to get it straight from the source: https://tools.ietf.org/html/rfc2616).
</description>
<tutorials>
</tutorials>
@@ -16,7 +18,7 @@
<return type="void">
</return>
<description>
- Cloces the current connection, allows for reusal of [code]HTTPClient[/code].
+ Closes the current connection, allowing reuse of this [code]HTTPClient[/code].
</description>
</method>
<method name="connect_to_host">
@@ -33,35 +35,35 @@
<description>
Connect to a host. This needs to be done before any requests are sent.
The host should not have http:// prepended but will strip the protocol identifier if provided.
- verify_host will check the SSL identity of the host if set to true.
+ [code]verify_host[/code] will check the SSL identity of the host if set to [code]true[/code].
</description>
</method>
<method name="get_connection" qualifiers="const">
<return type="StreamPeer">
</return>
<description>
- Return current connection.
+ Returns the current connection.
</description>
</method>
<method name="get_response_body_length" qualifiers="const">
<return type="int">
</return>
<description>
- Return the response's body length.
+ Returns the response's body length.
</description>
</method>
<method name="get_response_code" qualifiers="const">
<return type="int">
</return>
<description>
- Return the HTTP status code of the response.
+ Returns the response's HTTP status code.
</description>
</method>
<method name="get_response_headers">
<return type="PoolStringArray">
</return>
<description>
- Return the response headers.
+ Returns the response headers.
</description>
</method>
<method name="get_response_headers_as_dictionary">
@@ -84,21 +86,21 @@
<return type="bool">
</return>
<description>
- Return whether this [code]HTTPClient[/code] has a response available.
+ If [code]true[/code] this [code]HTTPClient[/code] has a response available.
</description>
</method>
<method name="is_blocking_mode_enabled" qualifiers="const">
<return type="bool">
</return>
<description>
- Return whether blocking mode is enabled.
+ If [code]true[/code] blocking mode is enabled.
</description>
</method>
<method name="is_response_chunked" qualifiers="const">
<return type="bool">
</return>
<description>
- Return whether this [code]HTTPClient[/code] has a response that is chunked.
+ If [code]true[/code] this [code]HTTPClient[/code] has a response that is chunked.
</description>
</method>
<method name="poll">
@@ -141,8 +143,8 @@
<argument index="3" name="body" type="String" default="&quot;&quot;">
</argument>
<description>
- Sends a request to the connected host. The url is what is normally behind the hostname, i.e. in [code]http://somehost.com/index.php[/code], url would be "index.php".
- Headers are HTTP request headers.
+ Sends a request to the connected host. The URL parameter is just the part after the host, so for [code]http://somehost.com/index.php[/code], it is [code]index.php[/code].
+ Headers are HTTP request headers. For available HTTP methods, see [code]METHOD_*[/code].
To create a POST request with query strings to push to the server, do:
[codeblock]
var fields = {"username" : "user", "password" : "pass"}
@@ -164,9 +166,9 @@
<argument index="3" name="body" type="PoolByteArray">
</argument>
<description>
- Sends a raw request to the connected host. The url is what is normally behind the hostname, i.e. in [code]http://somehost.com/index.php[/code], url would be "index.php".
- Headers are HTTP request headers.
- Sends body raw, as a byte array, does not encode it in any way.
+ Sends a raw request to the connected host. The URL parameter is just the part after the host, so for [code]http://somehost.com/index.php[/code], it is [code]index.php[/code].
+ Headers are HTTP request headers. For available HTTP methods, see [code]METHOD_*[/code].
+ Sends the body data raw, as a byte array and does not encode it in any way.
</description>
</method>
<method name="set_blocking_mode">
@@ -184,7 +186,7 @@
<argument index="0" name="connection" type="StreamPeer">
</argument>
<description>
- Set connection to use, for this client.
+ Sets connection to use for this client.
</description>
</method>
<method name="set_read_chunk_size">
@@ -199,140 +201,208 @@
</methods>
<constants>
<constant name="METHOD_GET" value="0" enum="Method">
+ HTTP GET method. The GET method requests a representation of the specified resource. Requests using GET should only retrieve data.
</constant>
<constant name="METHOD_HEAD" value="1" enum="Method">
+ HTTP HEAD method. The HEAD method asks for a response identical to that of a GET request, but without the response body. This is useful to request metadata like HTTP headers or to check if a resource exists.
</constant>
<constant name="METHOD_POST" value="2" enum="Method">
+ HTTP POST method. The POST method is used to submit an entity to the specified resource, often causing a change in state or side effects on the server. This is often used for forms and submitting data or uploading files.
</constant>
<constant name="METHOD_PUT" value="3" enum="Method">
+ HTTP PUT method. The PUT method asks to replace all current representations of the target resource with the request payload. (You can think of [code]POST[/code] as "create or update" and [code]PUT[/code] as "update", although many services tend to not make a clear distinction or change their meaning).
</constant>
<constant name="METHOD_DELETE" value="4" enum="Method">
+ HTTP DELETE method. The DELETE method requests to delete the specified resource.
</constant>
<constant name="METHOD_OPTIONS" value="5" enum="Method">
+ HTTP OPTIONS method. The OPTIONS method asks for a description of the communication options for the target resource. Rarely used.
</constant>
<constant name="METHOD_TRACE" value="6" enum="Method">
+ HTTP TRACE method. The TRACE method performs a message loop-back test along the path to the target resource. Returns the entire HTTP request received in the response body. Rarely used.
</constant>
<constant name="METHOD_CONNECT" value="7" enum="Method">
+ HTTP CONNECT method. The CONNECT method establishes a tunnel to the server identified by the target resource. Rarely used.
</constant>
<constant name="METHOD_MAX" value="8" enum="Method">
+ Marker for end of [code]METHOD_*[/code] enum. Not used.
</constant>
<constant name="STATUS_DISCONNECTED" value="0" enum="Status">
+ Status: Disconnected from the server.
</constant>
<constant name="STATUS_RESOLVING" value="1" enum="Status">
+ Status: Currently resolving the hostname for the given URL into an IP.
</constant>
<constant name="STATUS_CANT_RESOLVE" value="2" enum="Status">
+ Status: DNS failure: Can't resolve the hostname for the given URL.
</constant>
<constant name="STATUS_CONNECTING" value="3" enum="Status">
+ Status: Currently connecting to server.
</constant>
<constant name="STATUS_CANT_CONNECT" value="4" enum="Status">
+ Status: Can't connect to the server.
</constant>
<constant name="STATUS_CONNECTED" value="5" enum="Status">
+ Status: Connection established.
</constant>
<constant name="STATUS_REQUESTING" value="6" enum="Status">
+ Status: Currently sending request.
</constant>
<constant name="STATUS_BODY" value="7" enum="Status">
+ Status: HTTP body received.
</constant>
<constant name="STATUS_CONNECTION_ERROR" value="8" enum="Status">
+ Status: Error in HTTP connection.
</constant>
<constant name="STATUS_SSL_HANDSHAKE_ERROR" value="9" enum="Status">
+ Status: Error in SSL handshake.
</constant>
<constant name="RESPONSE_CONTINUE" value="100" enum="ResponseCode">
+ HTTP status code [code]100 Continue[/code]. Interim response that indicates everything so far is OK and that the client should continue with the request (or ignore this status if already finished).
</constant>
<constant name="RESPONSE_SWITCHING_PROTOCOLS" value="101" enum="ResponseCode">
+ HTTP status code [code]101 Switching Protocol[/code]. Sent in response to an [code]Upgrade[/code] request header by the client. Indicates the protocol the server is switching to.
</constant>
<constant name="RESPONSE_PROCESSING" value="102" enum="ResponseCode">
+ HTTP status code [code]102 Processing[/code] (WebDAV). Indicates that the server has received and is processing the request, but no response is available yet.
</constant>
<constant name="RESPONSE_OK" value="200" enum="ResponseCode">
+ HTTP status code [code]200 OK[/code]. The request has succeeded. Default response for successful requests. Meaning varies depending on the request. GET: The resource has been fetched and is transmitted in the message body. HEAD: The entity headers are in the message body. POST: The resource describing the result of the action is transmitted in the message body. TRACE: The message body contains the request message as received by the server.
</constant>
<constant name="RESPONSE_CREATED" value="201" enum="ResponseCode">
+ HTTP status code [code]201 Created[/code]. The request has succeeded and a new resource has been created as a result of it. This is typically the response sent after a PUT request.
</constant>
<constant name="RESPONSE_ACCEPTED" value="202" enum="ResponseCode">
+ HTTP status code [code]202 Accepted[/code]. The request has been received but not yet acted upon. It is non-committal, meaning that there is no way in HTTP to later send an asynchronous response indicating the outcome of processing the request. It is intended for cases where another process or server handles the request, or for batch processing.
</constant>
<constant name="RESPONSE_NON_AUTHORITATIVE_INFORMATION" value="203" enum="ResponseCode">
+ HTTP status code [code]203 Non-Authoritative Information[/code]. This response code means returned meta-information set is not exact set as available from the origin server, but collected from a local or a third party copy. Except this condition, 200 OK response should be preferred instead of this response.
</constant>
<constant name="RESPONSE_NO_CONTENT" value="204" enum="ResponseCode">
+ HTTP status code [code]204 No Content[/code]. There is no content to send for this request, but the headers may be useful. The user-agent may update its cached headers for this resource with the new ones.
</constant>
<constant name="RESPONSE_RESET_CONTENT" value="205" enum="ResponseCode">
+ HTTP status code [code]205 Reset Content[/code]. The server has fulfilled the request and desires that the client resets the "document view" that caused the request to be sent to its original state as received from the origin server.
</constant>
<constant name="RESPONSE_PARTIAL_CONTENT" value="206" enum="ResponseCode">
+ HTTP status code [code]206 Partial Content[/code]. This response code is used because of a range header sent by the client to separate download into multiple streams.
</constant>
<constant name="RESPONSE_MULTI_STATUS" value="207" enum="ResponseCode">
+ HTTP status code [code]207 Multi-Status[/code] (WebDAV). A Multi-Status response conveys information about multiple resources in situations where multiple status codes might be appropriate.
</constant>
<constant name="RESPONSE_IM_USED" value="226" enum="ResponseCode">
+ HTTP status code [code]226 IM Used[/code] (WebDAV). The server has fulfilled a GET request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance.
</constant>
<constant name="RESPONSE_MULTIPLE_CHOICES" value="300" enum="ResponseCode">
+ HTTP status code [code]300 Multiple Choice[/code]. The request has more than one possible responses and there is no standardized way to choose one of the responses. User-agent or user should choose one of them.
</constant>
<constant name="RESPONSE_MOVED_PERMANENTLY" value="301" enum="ResponseCode">
+ HTTP status code [code]301 Moved Permanently[/code]. Redirection. This response code means the URI of requested resource has been changed. The new URI is usually included in the response.
</constant>
<constant name="RESPONSE_FOUND" value="302" enum="ResponseCode">
+ HTTP status code [code]302 Found[/code]. Temporary redirection. This response code means the URI of requested resource has been changed temporarily. New changes in the URI might be made in the future. Therefore, this same URI should be used by the client in future requests.
</constant>
<constant name="RESPONSE_SEE_OTHER" value="303" enum="ResponseCode">
+ HTTP status code [code]303 See Other[/code]. The server is redirecting the user agent to a different resource, as indicated by a URI in the Location header field, which is intended to provide an indirect response to the original request.
</constant>
<constant name="RESPONSE_NOT_MODIFIED" value="304" enum="ResponseCode">
+ HTTP status code [code]304 Not Modified[/code]. A conditional GET or HEAD request has been received and would have resulted in a 200 OK response if it were not for the fact that the condition evaluated to false.
</constant>
<constant name="RESPONSE_USE_PROXY" value="305" enum="ResponseCode">
+ HTTP status code [code]305 Use Proxy[/code]. Deprecated. Do not use.
</constant>
<constant name="RESPONSE_TEMPORARY_REDIRECT" value="307" enum="ResponseCode">
+ HTTP status code [code]307 Temporary Redirect[/code]. The target resource resides temporarily under a different URI and the user agent MUST NOT change the request method if it performs an automatic redirection to that URI.
</constant>
<constant name="RESPONSE_BAD_REQUEST" value="400" enum="ResponseCode">
+ HTTP status code [code]400 Bad Request[/code]. The request was invalid. The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, invalid request contents, or deceptive request routing).
</constant>
<constant name="RESPONSE_UNAUTHORIZED" value="401" enum="ResponseCode">
+ HTTP status code [code]401 Unauthorized[/code]. Credentials required. The request has not been applied because it lacks valid authentication credentials for the target resource.
</constant>
<constant name="RESPONSE_PAYMENT_REQUIRED" value="402" enum="ResponseCode">
+ HTTP status code [code]402 Payment Required[/code]. This response code is reserved for future use. Initial aim for creating this code was using it for digital payment systems, however this is not currently used.
</constant>
<constant name="RESPONSE_FORBIDDEN" value="403" enum="ResponseCode">
+ HTTP status code [code]403 Forbidden[/code]. The client does not have access rights to the content, i.e. they are unauthorized, so server is rejecting to give proper response. Unlike [code]401[/code], the client's identity is known to the server.
</constant>
<constant name="RESPONSE_NOT_FOUND" value="404" enum="ResponseCode">
+ HTTP status code [code]404 Not Found[/code]. The server can not find requested resource. Either the URL is not recognized or the endpoint is valid but the resource itself does not exist. May also be sent instead of 403 to hide existence of a resource if the client is not authorized.
</constant>
<constant name="RESPONSE_METHOD_NOT_ALLOWED" value="405" enum="ResponseCode">
+ HTTP status code [code]405 Method Not Allowed[/code]. The request's HTTP method is known by the server but has been disabled and cannot be used. For example, an API may forbid DELETE-ing a resource. The two mandatory methods, GET and HEAD, must never be disabled and should not return this error code.
</constant>
<constant name="RESPONSE_NOT_ACCEPTABLE" value="406" enum="ResponseCode">
+ HTTP status code [code]406 Not Acceptable[/code]. The target resource does not have a current representation that would be acceptable to the user agent, according to the proactive negotiation header fields received in the request. Used when negotiation content.
</constant>
<constant name="RESPONSE_PROXY_AUTHENTICATION_REQUIRED" value="407" enum="ResponseCode">
+ HTTP status code [code]407 Proxy Authentication Required[/code]. Similar to 401 Unauthorized, but it indicates that the client needs to authenticate itself in order to use a proxy.
</constant>
<constant name="RESPONSE_REQUEST_TIMEOUT" value="408" enum="ResponseCode">
+ HTTP status code [code]408 Request Timeout[/code]. The server did not receive a complete request message within the time that it was prepared to wait.
</constant>
<constant name="RESPONSE_CONFLICT" value="409" enum="ResponseCode">
+ HTTP status code [code]409 Conflict[/code]. The request could not be completed due to a conflict with the current state of the target resource. This code is used in situations where the user might be able to resolve the conflict and resubmit the request.
</constant>
<constant name="RESPONSE_GONE" value="410" enum="ResponseCode">
+ HTTP status code [code]410 Gone[/code]. The target resource is no longer available at the origin server and this condition is likely permanent.
</constant>
<constant name="RESPONSE_LENGTH_REQUIRED" value="411" enum="ResponseCode">
+ HTTP status code [code]411 Length Required[/code]. The server refuses to accept the request without a defined Content-Length header.
</constant>
<constant name="RESPONSE_PRECONDITION_FAILED" value="412" enum="ResponseCode">
+ HTTP status code [code]412 Precondition Failed[/code]. One or more conditions given in the request header fields evaluated to false when tested on the server.
</constant>
<constant name="RESPONSE_REQUEST_ENTITY_TOO_LARGE" value="413" enum="ResponseCode">
+ HTTP status code [code]413 Entity Too Large[/code]. The server is refusing to process a request because the request payload is larger than the server is willing or able to process.
</constant>
<constant name="RESPONSE_REQUEST_URI_TOO_LONG" value="414" enum="ResponseCode">
+ HTTP status code [code]414 Request-URI Too Long[/code]. The server is refusing to service the request because the request-target is longer than the server is willing to interpret.
</constant>
<constant name="RESPONSE_UNSUPPORTED_MEDIA_TYPE" value="415" enum="ResponseCode">
+ HTTP status code [code]415 Unsupported Media Type[/code]. The origin server is refusing to service the request because the payload is in a format not supported by this method on the target resource.
</constant>
<constant name="RESPONSE_REQUESTED_RANGE_NOT_SATISFIABLE" value="416" enum="ResponseCode">
+ HTTP status code [code]416 Requested Range Not Satisfiable[/code]. None of the ranges in the request's Range header field overlap the current extent of the selected resource or the set of ranges requested has been rejected due to invalid ranges or an excessive request of small or overlapping ranges.
</constant>
<constant name="RESPONSE_EXPECTATION_FAILED" value="417" enum="ResponseCode">
+ HTTP status code [code]417 Expectation Failed[/code]. The expectation given in the request's Expect header field could not be met by at least one of the inbound servers.
</constant>
<constant name="RESPONSE_UNPROCESSABLE_ENTITY" value="422" enum="ResponseCode">
+ HTTP status code [code]422 Unprocessable Entity[/code] (WebDAV). The server understands the content type of the request entity (hence a 415 Unsupported Media Type status code is inappropriate), and the syntax of the request entity is correct (thus a 400 Bad Request status code is inappropriate) but was unable to process the contained instructions.
</constant>
<constant name="RESPONSE_LOCKED" value="423" enum="ResponseCode">
+ HTTP status code [code]423 Locked[/code] (WebDAV). The source or destination resource of a method is locked.
</constant>
<constant name="RESPONSE_FAILED_DEPENDENCY" value="424" enum="ResponseCode">
+ HTTP status code [code]424 Failed Dependency[/code] (WebDAV). The method could not be performed on the resource because the requested action depended on another action and that action failed.
</constant>
<constant name="RESPONSE_UPGRADE_REQUIRED" value="426" enum="ResponseCode">
+ HTTP status code [code]426 Upgrade Required[/code]. The server refuses to perform the request using the current protocol but might be willing to do so after the client upgrades to a different protocol.
</constant>
<constant name="RESPONSE_INTERNAL_SERVER_ERROR" value="500" enum="ResponseCode">
+ HTTP status code [code]500 Internal Server Error[/code]. The server encountered an unexpected condition that prevented it from fulfilling the request.
</constant>
<constant name="RESPONSE_NOT_IMPLEMENTED" value="501" enum="ResponseCode">
+ HTTP status code [code]501 Not Implemented[/code]. The server does not support the functionality required to fulfill the request.
</constant>
<constant name="RESPONSE_BAD_GATEWAY" value="502" enum="ResponseCode">
+ HTTP status code [code]502 Bad Gateway[/code]. The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request. Usually returned by load balancers or proxies.
</constant>
<constant name="RESPONSE_SERVICE_UNAVAILABLE" value="503" enum="ResponseCode">
+ HTTP status code [code]503 Service Unavailable[/code]. The server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay. Try again later.
</constant>
<constant name="RESPONSE_GATEWAY_TIMEOUT" value="504" enum="ResponseCode">
+ HTTP status code [code]504 Gateway Timeout[/code]. The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request. Usually returned by load balancers or proxies.
</constant>
<constant name="RESPONSE_HTTP_VERSION_NOT_SUPPORTED" value="505" enum="ResponseCode">
+ HTTP status code [code]505 HTTP Version Not Supported[/code]. The server does not support, or refuses to support, the major version of HTTP that was used in the request message.
</constant>
<constant name="RESPONSE_INSUFFICIENT_STORAGE" value="507" enum="ResponseCode">
+ HTTP status code [code]507 Insufficient Storage[/code]. The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request.
</constant>
<constant name="RESPONSE_NOT_EXTENDED" value="510" enum="ResponseCode">
+ HTTP status code [code]510 Not Extended[/code]. The policy for accessing the resource has not been met in the request. The server should send back all the information necessary for the client to issue an extended request.
</constant>
</constants>
</class>
diff --git a/doc/classes/HTTPRequest.xml b/doc/classes/HTTPRequest.xml
index 7c37479295..985198c76f 100644
--- a/doc/classes/HTTPRequest.xml
+++ b/doc/classes/HTTPRequest.xml
@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="HTTPRequest" inherits="Node" category="Core" version="3.0-beta">
<brief_description>
- A Node with the ability to send HTTP requests.
+ A node with the ability to send HTTP requests.
</brief_description>
<description>
- A Node with the ability to send HTTP requests. Uses a [HTTPClient] internally, supports HTTPS.
- Can be used to make HTTP requests or download files via HTTP.
+ A node with the ability to send HTTP requests. Uses [HTTPClient] internally.
+ Can be used to make HTTP requests, i.e. download or upload files or web content via HTTP.
</description>
<tutorials>
</tutorials>
@@ -16,35 +16,35 @@
<return type="void">
</return>
<description>
- Cancel the current request.
+ Cancels the current request.
</description>
</method>
<method name="get_body_size" qualifiers="const">
<return type="int">
</return>
<description>
- Return the response body length.
+ Returns the response body length.
</description>
</method>
<method name="get_download_file" qualifiers="const">
<return type="String">
</return>
<description>
- Return the file this request will download into.
+ Returns the file this request will download into.
</description>
</method>
<method name="get_downloaded_bytes" qualifiers="const">
<return type="int">
</return>
<description>
- Return the amount of bytes this HTTPRequest downloaded.
+ Returns the amount of bytes this HTTPRequest downloaded.
</description>
</method>
<method name="get_http_client_status" qualifiers="const">
<return type="int" enum="HTTPClient.Status">
</return>
<description>
- Return the current status of the underlying [HTTPClient].
+ Returns the current status of the underlying [HTTPClient]. See [code]STATUS_*[/code] enum on [HTTPClient].
</description>
</method>
<method name="request">
@@ -69,16 +69,19 @@
<argument index="0" name="path" type="String">
</argument>
<description>
- Set the file to download into. Outputs the response body into the file.
+ Sets the file to download into. Outputs the response body into the file if set.
</description>
</method>
</methods>
<members>
<member name="body_size_limit" type="int" setter="set_body_size_limit" getter="get_body_size_limit">
+ Maximum allowed size for response bodies.
</member>
<member name="max_redirects" type="int" setter="set_max_redirects" getter="get_max_redirects">
+ Maximum number of allowed redirects.
</member>
<member name="use_threads" type="bool" setter="set_use_threads" getter="is_using_threads">
+ If [code]true[/code] multithreading is used to improve performance.
</member>
</members>
<signals>
@@ -121,7 +124,7 @@
Request exceeded its maximum size limit, see [method set_body_size_limit].
</constant>
<constant name="RESULT_REQUEST_FAILED" value="8" enum="Result">
- Request failed. (unused)
+ Request failed. (Unused)
</constant>
<constant name="RESULT_DOWNLOAD_FILE_CANT_OPEN" value="9" enum="Result">
HTTPRequest couldn't open the download file.
diff --git a/doc/classes/IP.xml b/doc/classes/IP.xml
index 09734e746c..cd669e3de1 100644
--- a/doc/classes/IP.xml
+++ b/doc/classes/IP.xml
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="IP" inherits="Object" category="Core" version="3.0-beta">
<brief_description>
- IP Protocol support functions.
+ Internet protocol (IP) support functions like DNS resolution.
</brief_description>
<description>
- IP contains support functions for the IPv4 protocol. TCP/IP support is in different classes (see [StreamPeerTCP] and [TCP_Server]). IP provides hostname resolution support, both blocking and threaded.
+ IP contains support functions for the Internet Protocol (IP). TCP/IP support is in different classes (see [StreamPeerTCP] and [TCP_Server]). IP provides DNS hostname resolution support, both blocking and threaded.
</description>
<tutorials>
</tutorials>
@@ -79,24 +79,34 @@
</methods>
<constants>
<constant name="RESOLVER_STATUS_NONE" value="0" enum="ResolverStatus">
+ DNS hostname resolver status: No status.
</constant>
<constant name="RESOLVER_STATUS_WAITING" value="1" enum="ResolverStatus">
+ DNS hostname resolver status: Waiting.
</constant>
<constant name="RESOLVER_STATUS_DONE" value="2" enum="ResolverStatus">
+ DNS hostname resolver status: Done.
</constant>
<constant name="RESOLVER_STATUS_ERROR" value="3" enum="ResolverStatus">
+ DNS hostname resolver status: Error.
</constant>
<constant name="RESOLVER_MAX_QUERIES" value="32">
+ Maximum number of concurrent DNS resolver queries allowed, [code]RESOLVER_INVALID_ID[/code] is returned if exceeded.
</constant>
<constant name="RESOLVER_INVALID_ID" value="-1">
+ Invalid ID constant. Returned if [code]RESOLVER_MAX_QUERIES[/code] is exceeded.
</constant>
<constant name="TYPE_NONE" value="0" enum="Type">
+ Address type: None.
</constant>
<constant name="TYPE_IPV4" value="1" enum="Type">
+ Address type: Internet protocol version 4 (IPv4).
</constant>
<constant name="TYPE_IPV6" value="2" enum="Type">
+ Address type: Internet protocol version 6 (IPv6).
</constant>
<constant name="TYPE_ANY" value="3" enum="Type">
+ Address type: Any.
</constant>
</constants>
</class>
diff --git a/doc/classes/IP_Unix.xml b/doc/classes/IP_Unix.xml
index 28e8a3804b..1d376c7233 100644
--- a/doc/classes/IP_Unix.xml
+++ b/doc/classes/IP_Unix.xml
@@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="IP_Unix" inherits="IP" category="Core" version="3.0-beta">
<brief_description>
+ Unix IP support. See [IP].
</brief_description>
<description>
+ Unix-specific implementation of IP support functions. See [IP].
</description>
<tutorials>
</tutorials>
diff --git a/doc/classes/KinematicBody.xml b/doc/classes/KinematicBody.xml
index c5204fd0bf..d1dc236d40 100644
--- a/doc/classes/KinematicBody.xml
+++ b/doc/classes/KinematicBody.xml
@@ -102,6 +102,18 @@
</method>
</methods>
<members>
+ <member name="axis_lock_angular_x" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_angular_y" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_angular_z" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_linear_x" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_linear_y" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_linear_z" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
<member name="collision/safe_margin" type="float" setter="set_safe_margin" getter="get_safe_margin">
If the body is at least this close to another body, this body will consider them to be colliding.
</member>
diff --git a/doc/classes/Mesh.xml b/doc/classes/Mesh.xml
index c681886546..465b68171e 100644
--- a/doc/classes/Mesh.xml
+++ b/doc/classes/Mesh.xml
@@ -49,6 +49,10 @@
</description>
</method>
</methods>
+ <members>
+ <member name="lightmap_size_hint" type="Vector2" setter="set_lightmap_size_hint" getter="get_lightmap_size_hint">
+ </member>
+ </members>
<constants>
<constant name="PRIMITIVE_POINTS" value="0" enum="PrimitiveType">
Render array as points (one vertex equals one point).
diff --git a/doc/classes/MeshInstance.xml b/doc/classes/MeshInstance.xml
index f754341fef..9273e87430 100644
--- a/doc/classes/MeshInstance.xml
+++ b/doc/classes/MeshInstance.xml
@@ -4,7 +4,7 @@
Node that instances meshes into a scenario.
</brief_description>
<description>
- MeshInstance is a [Node] that takes a [Mesh] resource and adds it to the current scenario by creating an instance of it. This is the class most often used to get 3D geometry rendered and can be used to instance a single [Mesh] in many places. This allows to reuse geometry and save on resources. When a [Mesh] has to be instanced more than thousands of times at close proximity, consider using a [MultiMesh] in a [MultiMeshInstance] instead.
+ MeshInstance is a node that takes a [Mesh] resource and adds it to the current scenario by creating an instance of it. This is the class most often used to get 3D geometry rendered and can be used to instance a single [Mesh] in many places. This allows to reuse geometry and save on resources. When a [Mesh] has to be instanced more than thousands of times at close proximity, consider using a [MultiMesh] in a [MultiMeshInstance] instead.
</description>
<tutorials>
</tutorials>
@@ -15,20 +15,21 @@
<return type="void">
</return>
<description>
- This helper creates a [StaticBody] child [Node] with a [ConvexPolygonShape] [CollisionShape] calculated from the mesh geometry. It's mainly used for testing.
+ This helper creates a [StaticBody] child node with a [ConvexPolygonShape] collision shape calculated from the mesh geometry. It's mainly used for testing.
</description>
</method>
<method name="create_debug_tangents">
<return type="void">
</return>
<description>
+ This helper creates a [MeshInstance] child node with gizmos at every vertex calculated from the mesh geometry. It's mainly used for testing.
</description>
</method>
<method name="create_trimesh_collision">
<return type="void">
</return>
<description>
- This helper creates a [StaticBody] child [Node] with a [ConcavePolygonShape] [CollisionShape] calculated from the mesh geometry. It's mainly used for testing.
+ This helper creates a [StaticBody] child node with a [ConcavePolygonShape] collision shape calculated from the mesh geometry. It's mainly used for testing.
</description>
</method>
<method name="get_surface_material" qualifiers="const">
diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml
index e2198c3e15..78591e2bf8 100644
--- a/doc/classes/Node.xml
+++ b/doc/classes/Node.xml
@@ -498,7 +498,7 @@
<return type="void">
</return>
<description>
- Removes a node and set all its children as children of the parent node (if exists). All even subscriptions that pass by the removed node will be unsubscribed.
+ Removes a node and set all its children as children of the parent node (if exists). All event subscriptions that pass by the removed node will be unsubscribed.
</description>
</method>
<method name="remove_child">
diff --git a/doc/classes/PhysicsServer.xml b/doc/classes/PhysicsServer.xml
index eb7c735277..534449a94b 100644
--- a/doc/classes/PhysicsServer.xml
+++ b/doc/classes/PhysicsServer.xml
@@ -351,15 +351,6 @@
Creates a physics body. The first parameter can be any value from constants BODY_MODE*, for the type of body created. Additionally, the body can be created in sleeping state to save processing time.
</description>
</method>
- <method name="body_get_axis_lock" qualifiers="const">
- <return type="int" enum="PhysicsServer.BodyAxisLock">
- </return>
- <argument index="0" name="body" type="RID">
- </argument>
- <description>
- Gets the information, which Axis is locked if any. The can be any calue from the constants BODY_AXIS_LOCK*
- </description>
- </method>
<method name="body_get_collision_layer" qualifiers="const">
<return type="int">
</return>
@@ -485,6 +476,16 @@
Returns a body state.
</description>
</method>
+ <method name="body_is_axis_locked" qualifiers="const">
+ <return type="bool">
+ </return>
+ <argument index="0" name="body" type="RID">
+ </argument>
+ <argument index="1" name="axis" type="int" enum="PhysicsServer.BodyAxis">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="body_is_continuous_collision_detection_enabled" qualifiers="const">
<return type="bool">
</return>
@@ -540,10 +541,11 @@
</return>
<argument index="0" name="body" type="RID">
</argument>
- <argument index="1" name="axis" type="int" enum="PhysicsServer.BodyAxisLock">
+ <argument index="1" name="axis" type="int" enum="PhysicsServer.BodyAxis">
+ </argument>
+ <argument index="2" name="lock" type="bool">
</argument>
<description>
- Locks velocity along one axis to 0 and only allows rotation along this axis, can also be set to disabled which disables this functionality.
</description>
</method>
<method name="body_set_axis_velocity">
@@ -1519,17 +1521,17 @@
<constant name="SPACE_PARAM_CONSTRAINT_DEFAULT_BIAS" value="7" enum="SpaceParameter">
Constant to set/get the default solver bias for all physics constraints. A solver bias is a factor controlling how much two objects "rebound", after violating a constraint, to avoid leaving them in that state because of numerical imprecision.
</constant>
- <constant name="BODY_AXIS_LOCK_DISABLED" value="0" enum="BodyAxisLock">
- The [Body] can rotate and move freely.
+ <constant name="BODY_AXIS_LINEAR_X" value="1" enum="BodyAxis">
+ </constant>
+ <constant name="BODY_AXIS_LINEAR_Y" value="2" enum="BodyAxis">
+ </constant>
+ <constant name="BODY_AXIS_LINEAR_Z" value="4" enum="BodyAxis">
</constant>
- <constant name="BODY_AXIS_LOCK_X" value="1" enum="BodyAxisLock">
- The [Body] cannot move across x axis can only rotate across x axis.
+ <constant name="BODY_AXIS_ANGULAR_X" value="8" enum="BodyAxis">
</constant>
- <constant name="BODY_AXIS_LOCK_Y" value="2" enum="BodyAxisLock">
- The [Body] cannot move across y axis can only rotate across y axis.
+ <constant name="BODY_AXIS_ANGULAR_Y" value="16" enum="BodyAxis">
</constant>
- <constant name="BODY_AXIS_LOCK_Z" value="3" enum="BodyAxisLock">
- The [Body] cannot move across z axis can only rotate across z axis.
+ <constant name="BODY_AXIS_ANGULAR_Z" value="32" enum="BodyAxis">
</constant>
</constants>
</class>
diff --git a/doc/classes/PopupMenu.xml b/doc/classes/PopupMenu.xml
index 7071d64f2e..42ed57e4af 100644
--- a/doc/classes/PopupMenu.xml
+++ b/doc/classes/PopupMenu.xml
@@ -233,6 +233,12 @@
<description>
</description>
</method>
+ <method name="is_hide_on_state_item_selection" qualifiers="const">
+ <return type="bool">
+ </return>
+ <description>
+ </description>
+ </method>
<method name="is_item_checkable" qualifiers="const">
<return type="bool">
</return>
@@ -278,6 +284,14 @@
Removes the item at index "idx" from the menu. Note that the indexes of items after the removed item are going to be shifted by one.
</description>
</method>
+ <method name="set_hide_on_state_item_selection">
+ <return type="void">
+ </return>
+ <argument index="0" name="enable" type="bool">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="set_item_accelerator">
<return type="void">
</return>
@@ -377,6 +391,16 @@
<description>
</description>
</method>
+ <method name="set_item_statable">
+ <return type="void">
+ </return>
+ <argument index="0" name="idx" type="int">
+ </argument>
+ <argument index="1" name="state" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
<method name="set_item_submenu">
<return type="void">
</return>
@@ -417,6 +441,14 @@
<description>
</description>
</method>
+ <method name="toggle_item_statable">
+ <return type="void">
+ </return>
+ <argument index="0" name="idx" type="int">
+ </argument>
+ <description>
+ </description>
+ </method>
</methods>
<members>
<member name="hide_on_checkable_item_selection" type="bool" setter="set_hide_on_checkable_item_selection" getter="is_hide_on_checkable_item_selection">
diff --git a/doc/classes/Rect2.xml b/doc/classes/Rect2.xml
index 1bd2e812e6..4fc9e5bd71 100644
--- a/doc/classes/Rect2.xml
+++ b/doc/classes/Rect2.xml
@@ -37,6 +37,12 @@
Constructs a [code]Rect2[/code] by x, y, width, and height.
</description>
</method>
+ <method name="abs">
+ <return type="Rect2">
+ </return>
+ <description>
+ </description>
+ </method>
<method name="clip">
<return type="Rect2">
</return>
diff --git a/doc/classes/RigidBody.xml b/doc/classes/RigidBody.xml
index cfcd0258e7..3c54f29c15 100644
--- a/doc/classes/RigidBody.xml
+++ b/doc/classes/RigidBody.xml
@@ -59,8 +59,17 @@
<member name="angular_velocity" type="Vector3" setter="set_angular_velocity" getter="get_angular_velocity">
RigidBody's rotational velocity.
</member>
- <member name="axis_lock" type="int" setter="set_axis_lock" getter="get_axis_lock" enum="RigidBody.AxisLock">
- Locks the rotational forces to a particular axis, preventing rotations on other axes.
+ <member name="axis_lock_angular_x" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_angular_y" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_angular_z" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_linear_x" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_linear_y" type="bool" setter="set_axis_lock" getter="get_axis_lock">
+ </member>
+ <member name="axis_lock_linear_z" type="bool" setter="set_axis_lock" getter="get_axis_lock">
</member>
<member name="bounce" type="float" setter="set_bounce" getter="get_bounce">
RigidBody's bounciness.
@@ -168,13 +177,5 @@
<constant name="MODE_KINEMATIC" value="3" enum="Mode">
Kinematic body. The body behaves like a [KinematicBody], and can only move by user code.
</constant>
- <constant name="AXIS_LOCK_DISABLED" value="0" enum="AxisLock">
- </constant>
- <constant name="AXIS_LOCK_X" value="1" enum="AxisLock">
- </constant>
- <constant name="AXIS_LOCK_Y" value="2" enum="AxisLock">
- </constant>
- <constant name="AXIS_LOCK_Z" value="3" enum="AxisLock">
- </constant>
</constants>
</class>
diff --git a/doc/classes/SurfaceTool.xml b/doc/classes/SurfaceTool.xml
index 22099a930c..0916d0b928 100644
--- a/doc/classes/SurfaceTool.xml
+++ b/doc/classes/SurfaceTool.xml
@@ -170,6 +170,8 @@
</return>
<argument index="0" name="existing" type="ArrayMesh" default="null">
</argument>
+ <argument index="1" name="flags" type="int" default="97792">
+ </argument>
<description>
Returns a constructed [ArrayMesh] from current information passed in. If an existing [ArrayMesh] is passed in as an argument, will add an extra surface to the existing [ArrayMesh].
</description>
diff --git a/doc/classes/TextEdit.xml b/doc/classes/TextEdit.xml
index df48ba3e23..da30c4c7bd 100644
--- a/doc/classes/TextEdit.xml
+++ b/doc/classes/TextEdit.xml
@@ -305,6 +305,15 @@
Enable text wrapping when it goes beyond he edge of what is visible.
</description>
</method>
+ <method name="toggle_fold_line">
+ <return type="void">
+ </return>
+ <argument index="0" name="line" type="int">
+ </argument>
+ <description>
+ Toggle the folding of the code block at the given line.
+ </description>
+ </method>
<method name="undo">
<return type="void">
</return>
@@ -428,6 +437,8 @@
</theme_item>
<theme_item name="caret_color" type="Color">
</theme_item>
+ <theme_item name="code_folding_color" type="Color">
+ </theme_item>
<theme_item name="completion" type="StyleBox">
</theme_item>
<theme_item name="completion_background_color" type="Color">
diff --git a/doc/classes/Texture.xml b/doc/classes/Texture.xml
index 855a8f12de..bf27bc4768 100644
--- a/doc/classes/Texture.xml
+++ b/doc/classes/Texture.xml
@@ -117,22 +117,26 @@
</methods>
<constants>
<constant name="FLAG_MIPMAPS" value="1" enum="Flags">
- Generate mipmaps, to enable smooth zooming out of the texture.
+ Generate mipmaps, which are smaller versions of the same texture to use when zoomed out, keeping the aspect ratio.
</constant>
<constant name="FLAG_REPEAT" value="2" enum="Flags">
- Repeat (instead of clamp to edge).
+ Repeats texture (instead of clamp to edge).
</constant>
<constant name="FLAG_FILTER" value="4" enum="Flags">
- Turn on magnifying filter, to enable smooth zooming in of the texture.
+ Magnifying filter, to enable smooth zooming in of the texture.
</constant>
<constant name="FLAGS_DEFAULT" value="7" enum="Flags">
Default flags. Generate mipmaps, repeat, and filter are enabled.
</constant>
<constant name="FLAG_ANISOTROPIC_FILTER" value="8" enum="Flags">
+ Anisotropic mipmap filtering. Generates smaller versions of the same texture with different aspect ratios.
+ More effective on planes often shown going to the horrizon as those textures (Walls or Ground for example) get squashed in the viewport to different aspect ratios and regular mipmaps keep the aspect ratio so they don't optimize storage that well in those cases.
</constant>
<constant name="FLAG_CONVERT_TO_LINEAR" value="16" enum="Flags">
+ Converts texture to SRGB color space.
</constant>
<constant name="FLAG_MIRRORED_REPEAT" value="32" enum="Flags">
+ Repeats texture with alternate sections mirrored.
</constant>
<constant name="FLAG_VIDEO_SURFACE" value="4096" enum="Flags">
Texture is a video surface.
diff --git a/doc/classes/TileMap.xml b/doc/classes/TileMap.xml
index e58ab3dd25..72cd56dc55 100644
--- a/doc/classes/TileMap.xml
+++ b/doc/classes/TileMap.xml
@@ -38,20 +38,6 @@
Return the tile index of the cell referenced by a Vector2.
</description>
</method>
- <method name="get_center_x" qualifiers="const">
- <return type="bool">
- </return>
- <description>
- Return true if tiles are to be centered in x coordinate (by default this is false and they are drawn from upper left cell corner).
- </description>
- </method>
- <method name="get_center_y" qualifiers="const">
- <return type="bool">
- </return>
- <description>
- Return true if tiles are to be centered in y coordinate (by default this is false and they are drawn from upper left cell corner).
- </description>
- </method>
<method name="get_collision_layer_bit" qualifiers="const">
<return type="bool">
</return>
@@ -176,24 +162,6 @@
Optionally, the tile can also be flipped over the X and Y axes or transposed.
</description>
</method>
- <method name="set_center_x">
- <return type="void">
- </return>
- <argument index="0" name="enable" type="bool">
- </argument>
- <description>
- Set tiles to be centered in x coordinate. (by default this is false and they are drawn from upper left cell corner).
- </description>
- </method>
- <method name="set_center_y">
- <return type="void">
- </return>
- <argument index="0" name="enable" type="bool">
- </argument>
- <description>
- Set tiles to be centered in y coordinate. (by default this is false and they are drawn from upper left cell corner).
- </description>
- </method>
<method name="set_collision_layer_bit">
<return type="void">
</return>
diff --git a/doc/classes/TileSet.xml b/doc/classes/TileSet.xml
index 6a147a9646..3dbf172c5a 100644
--- a/doc/classes/TileSet.xml
+++ b/doc/classes/TileSet.xml
@@ -13,7 +13,7 @@
</demos>
<methods>
<method name="_forward_subtile_selection" qualifiers="virtual">
- <return type="void">
+ <return type="Vector2">
</return>
<argument index="0" name="autotile_id" type="int">
</argument>
@@ -27,7 +27,7 @@
</description>
</method>
<method name="_is_tile_bound" qualifiers="virtual">
- <return type="void">
+ <return type="bool">
</return>
<argument index="0" name="drawn_id" type="int">
</argument>
diff --git a/doc/classes/VisualServer.xml b/doc/classes/VisualServer.xml
index 479c0606f2..1a9dc3a669 100644
--- a/doc/classes/VisualServer.xml
+++ b/doc/classes/VisualServer.xml
@@ -24,6 +24,7 @@
<argument index="3" name="bottom" type="RID">
</argument>
<description>
+ Sets images to be rendered in the window margin.
</description>
</method>
<method name="black_bars_set_margins">
@@ -38,12 +39,14 @@
<argument index="3" name="bottom" type="int">
</argument>
<description>
+ Sets margin size, where black bars (or images, if [method black_bars_set_images] was used) are rendered.
</description>
</method>
<method name="canvas_create">
<return type="RID">
</return>
<description>
+ Creates a canvas and returns the assigned [RID].
</description>
</method>
<method name="canvas_item_add_circle">
@@ -58,6 +61,7 @@
<argument index="3" name="color" type="Color">
</argument>
<description>
+ Adds a circle command to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_clip_ignore">
@@ -68,6 +72,7 @@
<argument index="1" name="ignore" type="bool">
</argument>
<description>
+ If ignore is [code]true[/code], the VisualServer does not perform clipping.
</description>
</method>
<method name="canvas_item_add_line">
@@ -86,6 +91,7 @@
<argument index="5" name="antialiased" type="bool" default="false">
</argument>
<description>
+ Adds a line command to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_mesh">
@@ -98,6 +104,7 @@
<argument index="2" name="skeleton" type="RID">
</argument>
<description>
+ Adds a [Mesh] to the [CanvasItem]'s draw commands. Only affects its aabb at the moment.
</description>
</method>
<method name="canvas_item_add_multimesh">
@@ -110,6 +117,7 @@
<argument index="2" name="skeleton" type="RID">
</argument>
<description>
+ Adds a [MultiMesh] to the [CanvasItem]'s draw commands. Only affects its aabb at the moment.
</description>
</method>
<method name="canvas_item_add_nine_patch">
@@ -138,6 +146,8 @@
<argument index="10" name="normal_map" type="RID">
</argument>
<description>
+ Adds a nine patch image to the [CanvasItem]'s draw commands.
+ See [NinePatchRect] for more explanation.
</description>
</method>
<method name="canvas_item_add_particles">
@@ -156,6 +166,7 @@
<argument index="5" name="v_frames" type="int">
</argument>
<description>
+ Adds a particles system to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_polygon">
@@ -176,6 +187,7 @@
<argument index="6" name="antialiased" type="bool" default="false">
</argument>
<description>
+ Adds a polygon to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_polyline">
@@ -192,6 +204,7 @@
<argument index="4" name="antialiased" type="bool" default="false">
</argument>
<description>
+ Adds a polyline, which is a line from mutliple points with a width, to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_primitive">
@@ -212,6 +225,7 @@
<argument index="6" name="normal_map" type="RID">
</argument>
<description>
+ Adds a primitive to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_rect">
@@ -224,6 +238,7 @@
<argument index="2" name="color" type="Color">
</argument>
<description>
+ Adds a rectangle to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_set_transform">
@@ -234,6 +249,8 @@
<argument index="1" name="transform" type="Transform2D">
</argument>
<description>
+ Adds a [Transform2D] command to the [CanvasItem]'s draw commands.
+ This sets the extra_matrix uniform when executed. This affects the later command's of the canvas item.
</description>
</method>
<method name="canvas_item_add_texture_rect">
@@ -254,6 +271,7 @@
<argument index="6" name="normal_map" type="RID">
</argument>
<description>
+ Adds a textured rect to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_texture_rect_region">
@@ -276,6 +294,7 @@
<argument index="7" name="clip_uv" type="bool" default="true">
</argument>
<description>
+ Adds a texture rect with region setting to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_add_triangle_array">
@@ -298,6 +317,7 @@
<argument index="7" name="normal_map" type="RID">
</argument>
<description>
+ Adds a triangle array to the [CanvasItem]'s draw commands.
</description>
</method>
<method name="canvas_item_clear">
@@ -306,12 +326,14 @@
<argument index="0" name="item" type="RID">
</argument>
<description>
+ Clears the [CanvasItem] and removes all commands in it.
</description>
</method>
<method name="canvas_item_create">
<return type="RID">
</return>
<description>
+ Creates a new [CanvasItem] and returns its [RID].
</description>
</method>
<method name="canvas_item_set_clip">
@@ -322,6 +344,7 @@
<argument index="1" name="clip" type="bool">
</argument>
<description>
+ Sets clipping for the [CanvasItem].
</description>
</method>
<method name="canvas_item_set_copy_to_backbuffer">
@@ -334,6 +357,7 @@
<argument index="2" name="rect" type="Rect2">
</argument>
<description>
+ Sets the [CanvasItem] to copy a rect to the backbuffer.
</description>
</method>
<method name="canvas_item_set_custom_rect">
@@ -346,6 +370,7 @@
<argument index="2" name="rect" type="Rect2" default="Rect2( 0, 0, 0, 0 )">
</argument>
<description>
+ Defines a custom drawing rectangle for the [CanvasItem].
</description>
</method>
<method name="canvas_item_set_distance_field_mode">
@@ -366,6 +391,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ Sets [CanvasItem] to be drawn behind its parent.
</description>
</method>
<method name="canvas_item_set_draw_index">
@@ -376,6 +402,7 @@
<argument index="1" name="index" type="int">
</argument>
<description>
+ Sets the index for the [CanvasItem].
</description>
</method>
<method name="canvas_item_set_light_mask">
@@ -386,6 +413,7 @@
<argument index="1" name="mask" type="int">
</argument>
<description>
+ The light mask. See [LightOccluder2D] for more information on light masks.
</description>
</method>
<method name="canvas_item_set_material">
@@ -396,6 +424,7 @@
<argument index="1" name="material" type="RID">
</argument>
<description>
+ Sets a new material to the [CanvasItem].
</description>
</method>
<method name="canvas_item_set_modulate">
@@ -406,6 +435,7 @@
<argument index="1" name="color" type="Color">
</argument>
<description>
+ Sets the color that modulates the [CanvasItem] and its children.
</description>
</method>
<method name="canvas_item_set_parent">
@@ -416,6 +446,7 @@
<argument index="1" name="parent" type="RID">
</argument>
<description>
+ Sets the parent for the [CanvasItem].
</description>
</method>
<method name="canvas_item_set_self_modulate">
@@ -426,6 +457,7 @@
<argument index="1" name="color" type="Color">
</argument>
<description>
+ Sets the color that modulates the [CanvasItem] without children.
</description>
</method>
<method name="canvas_item_set_sort_children_by_y">
@@ -436,6 +468,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ Sets if [CanvasItem]'s children should be sorted by y-position.
</description>
</method>
<method name="canvas_item_set_transform">
@@ -446,6 +479,7 @@
<argument index="1" name="transform" type="Transform2D">
</argument>
<description>
+ Sets the [CanvasItem]'s [Transform2D].
</description>
</method>
<method name="canvas_item_set_use_parent_material">
@@ -456,6 +490,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ Sets if the [CanvasItem] uses its parent's material.
</description>
</method>
<method name="canvas_item_set_visible">
@@ -466,6 +501,7 @@
<argument index="1" name="visible" type="bool">
</argument>
<description>
+ Sets if the canvas item (including its children) is visible.
</description>
</method>
<method name="canvas_item_set_z">
@@ -476,6 +512,7 @@
<argument index="1" name="z" type="int">
</argument>
<description>
+ Sets the [CanvasItem]'s z order position.
</description>
</method>
<method name="canvas_item_set_z_as_relative_to_parent">
@@ -486,6 +523,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ If this is enabled, the z-position of the parent will be added to the childrens z-position.
</description>
</method>
<method name="canvas_light_attach_to_canvas">
@@ -496,12 +534,14 @@
<argument index="1" name="canvas" type="RID">
</argument>
<description>
+ Attaches the canvas light to the canvas. Removes it from its previous canvas.
</description>
</method>
<method name="canvas_light_create">
<return type="RID">
</return>
<description>
+ Creates a canvas light.
</description>
</method>
<method name="canvas_light_occluder_attach_to_canvas">
@@ -512,12 +552,14 @@
<argument index="1" name="canvas" type="RID">
</argument>
<description>
+ Attaches a light occluder to the canvas. Removes it from its previous canvas.
</description>
</method>
<method name="canvas_light_occluder_create">
<return type="RID">
</return>
<description>
+ Creates a light occluder.
</description>
</method>
<method name="canvas_light_occluder_set_enabled">
@@ -528,6 +570,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ Enables or disables light occluder.
</description>
</method>
<method name="canvas_light_occluder_set_light_mask">
@@ -538,6 +581,7 @@
<argument index="1" name="mask" type="int">
</argument>
<description>
+ The light mask. See [LightOccluder2D] for more information on light masks
</description>
</method>
<method name="canvas_light_occluder_set_polygon">
@@ -548,6 +592,7 @@
<argument index="1" name="polygon" type="RID">
</argument>
<description>
+ Sets a light occluder's polygon.
</description>
</method>
<method name="canvas_light_occluder_set_transform">
@@ -558,6 +603,7 @@
<argument index="1" name="transform" type="Transform2D">
</argument>
<description>
+ Sets a light occluder's [Transform2D].
</description>
</method>
<method name="canvas_light_set_color">
@@ -568,6 +614,7 @@
<argument index="1" name="color" type="Color">
</argument>
<description>
+ Sets the color for a light.
</description>
</method>
<method name="canvas_light_set_enabled">
@@ -578,6 +625,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ Enables or disables a canvas light.
</description>
</method>
<method name="canvas_light_set_energy">
@@ -588,6 +636,7 @@
<argument index="1" name="energy" type="float">
</argument>
<description>
+ Sets a canvas light's energy.
</description>
</method>
<method name="canvas_light_set_height">
@@ -598,6 +647,7 @@
<argument index="1" name="height" type="float">
</argument>
<description>
+ Sets a canvas light's height.
</description>
</method>
<method name="canvas_light_set_item_cull_mask">
@@ -608,6 +658,7 @@
<argument index="1" name="mask" type="int">
</argument>
<description>
+ The light mask. See [LightOccluder2D] for more information on light masks
</description>
</method>
<method name="canvas_light_set_item_shadow_cull_mask">
@@ -618,6 +669,7 @@
<argument index="1" name="mask" type="int">
</argument>
<description>
+ The shadow mask. binary about wich layers this canvas light affects wich canvas item's shadows. See [LightOccluder2D] for more information on light masks.
</description>
</method>
<method name="canvas_light_set_layer_range">
@@ -630,6 +682,7 @@
<argument index="2" name="max_layer" type="int">
</argument>
<description>
+ The layer range that gets rendered with this light.
</description>
</method>
<method name="canvas_light_set_mode">
@@ -640,6 +693,7 @@
<argument index="1" name="mode" type="int" enum="VisualServer.CanvasLightMode">
</argument>
<description>
+ The mode of the light, see CANVAS_LIGHT_MODE_* constants.
</description>
</method>
<method name="canvas_light_set_scale">
@@ -660,6 +714,7 @@
<argument index="1" name="size" type="int">
</argument>
<description>
+ Sets the width of the shadow buffer, size gets scaled to the next power of two for this.
</description>
</method>
<method name="canvas_light_set_shadow_color">
@@ -670,6 +725,7 @@
<argument index="1" name="color" type="Color">
</argument>
<description>
+ Sets the color of the canvas light's shadow.
</description>
</method>
<method name="canvas_light_set_shadow_enabled">
@@ -680,6 +736,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ Enables or disables the canvas light's shadow.
</description>
</method>
<method name="canvas_light_set_shadow_filter">
@@ -690,6 +747,7 @@
<argument index="1" name="filter" type="int" enum="VisualServer.CanvasLightShadowFilter">
</argument>
<description>
+ Sets the canvas light's shadow's filter, see CANVAS_LIGHT_SHADOW_FILTER_* constants.
</description>
</method>
<method name="canvas_light_set_shadow_gradient_length">
@@ -700,6 +758,7 @@
<argument index="1" name="length" type="float">
</argument>
<description>
+ Sets the length of the shadow's gradient.
</description>
</method>
<method name="canvas_light_set_shadow_smooth">
@@ -710,6 +769,7 @@
<argument index="1" name="smooth" type="float">
</argument>
<description>
+ Smoothens the shadow. The lower, the more smooth.
</description>
</method>
<method name="canvas_light_set_texture">
@@ -740,6 +800,7 @@
<argument index="1" name="transform" type="Transform2D">
</argument>
<description>
+ Sets the canvas light's [Transform2D].
</description>
</method>
<method name="canvas_light_set_z_range">
@@ -758,6 +819,7 @@
<return type="RID">
</return>
<description>
+ Creates a new light occluder polygon.
</description>
</method>
<method name="canvas_occluder_polygon_set_cull_mode">
@@ -768,6 +830,7 @@
<argument index="1" name="mode" type="int" enum="VisualServer.CanvasOccluderPolygonCullMode">
</argument>
<description>
+ Sets an occluder polygons cull mode. See CANVAS_OCCLUDER_POLYGON_CULL_MODE_* constants.
</description>
</method>
<method name="canvas_occluder_polygon_set_shape">
@@ -780,6 +843,7 @@
<argument index="2" name="closed" type="bool">
</argument>
<description>
+ Sets the shape of the occluder polygon.
</description>
</method>
<method name="canvas_occluder_polygon_set_shape_as_lines">
@@ -790,6 +854,7 @@
<argument index="1" name="shape" type="PoolVector2Array">
</argument>
<description>
+ Sets the shape of the occluder polygon as lines.
</description>
</method>
<method name="canvas_set_item_mirroring">
@@ -802,6 +867,7 @@
<argument index="2" name="mirroring" type="Vector2">
</argument>
<description>
+ A copy of the canvas item will be drawn with a local offset of the mirroring [Vector2].
</description>
</method>
<method name="canvas_set_modulate">
@@ -812,6 +878,7 @@
<argument index="1" name="color" type="Color">
</argument>
<description>
+ Modulates all colors in the given canvas.
</description>
</method>
<method name="draw">
@@ -820,12 +887,14 @@
<argument index="0" name="swap_buffers" type="bool" default="true">
</argument>
<description>
+ Draws a frame.
</description>
</method>
<method name="finish">
<return type="void">
</return>
<description>
+ Removes buffers and clears testcubes.
</description>
</method>
<method name="force_draw">
@@ -834,12 +903,14 @@
<argument index="0" name="swap_buffers" type="bool" default="true">
</argument>
<description>
+ Draws a frame. Same as [method draw].
</description>
</method>
<method name="force_sync">
<return type="void">
</return>
<description>
+ Syncronizes threads.
</description>
</method>
<method name="free">
@@ -848,6 +919,7 @@
<argument index="0" name="rid" type="RID">
</argument>
<description>
+ Tries to free an object in the VisualServer.
</description>
</method>
<method name="get_render_info">
@@ -856,30 +928,35 @@
<argument index="0" name="info" type="int" enum="VisualServer.RenderInfo">
</argument>
<description>
+ Returns a certain information, see RENDER_INFO_* for options.
</description>
</method>
<method name="get_test_cube">
<return type="RID">
</return>
<description>
+ Returns the id of the test cube. Creates one if none exists.
</description>
</method>
<method name="get_test_texture">
<return type="RID">
</return>
<description>
+ Returns the id of the test texture. Creates one if none exists.
</description>
</method>
<method name="get_white_texture">
<return type="RID">
</return>
<description>
+ Returns the id of a white texture. Creates one if none exists.
</description>
</method>
<method name="has_changed" qualifiers="const">
<return type="bool">
</return>
<description>
+ Returns [code]true[/code] if changes have been made to the VisualServer's data. [method draw] is usually called if this happens.
</description>
</method>
<method name="has_feature" qualifiers="const">
@@ -896,12 +973,14 @@
<argument index="0" name="feature" type="String">
</argument>
<description>
+ Returns true, if the OS supports a certain feature. Features might be s3tc, etc, etc2 and pvrtc,
</description>
</method>
<method name="init">
<return type="void">
</return>
<description>
+ Initializes the visual server.
</description>
</method>
<method name="make_sphere_mesh">
@@ -914,12 +993,14 @@
<argument index="2" name="radius" type="float">
</argument>
<description>
+ Returns a mesh of a sphere with the given amount of horizontal and vertical subdivisions.
</description>
</method>
<method name="material_create">
<return type="RID">
</return>
<description>
+ Returns an empty material.
</description>
</method>
<method name="material_get_param" qualifiers="const">
@@ -930,6 +1011,7 @@
<argument index="1" name="parameter" type="String">
</argument>
<description>
+ Returns the value of a certain material's parameter.
</description>
</method>
<method name="material_get_shader" qualifiers="const">
@@ -938,6 +1020,7 @@
<argument index="0" name="shader_material" type="RID">
</argument>
<description>
+ Returns the shader of a certain material's shader. Returns an empty RID if the material doesn't have a shader.
</description>
</method>
<method name="material_set_line_width">
@@ -948,6 +1031,7 @@
<argument index="1" name="width" type="float">
</argument>
<description>
+ Sets a materials line width.
</description>
</method>
<method name="material_set_next_pass">
@@ -958,6 +1042,7 @@
<argument index="1" name="next_material" type="RID">
</argument>
<description>
+ Sets an objects next material.
</description>
</method>
<method name="material_set_param">
@@ -970,6 +1055,7 @@
<argument index="2" name="value" type="Variant">
</argument>
<description>
+ Sets a materials parameter.
</description>
</method>
<method name="material_set_render_priority">
@@ -980,6 +1066,7 @@
<argument index="1" name="priority" type="int">
</argument>
<description>
+ Sets a material's render priority.
</description>
</method>
<method name="material_set_shader">
@@ -990,6 +1077,7 @@
<argument index="1" name="shader" type="RID">
</argument>
<description>
+ Sets a shader material's shader.
</description>
</method>
<method name="mesh_add_surface_from_arrays">
@@ -1006,6 +1094,7 @@
<argument index="4" name="compress_format" type="int" default="97792">
</argument>
<description>
+ Adds a surface generated from the Arrays to a mesh. See PRIMITIVE_TYPE_* constants for types.
</description>
</method>
<method name="mesh_clear">
@@ -1014,12 +1103,14 @@
<argument index="0" name="mesh" type="RID">
</argument>
<description>
+ Removes all surfaces from a mesh.
</description>
</method>
<method name="mesh_create">
<return type="RID">
</return>
<description>
+ Creates a new mesh.
</description>
</method>
<method name="mesh_get_blend_shape_count" qualifiers="const">
@@ -1028,6 +1119,7 @@
<argument index="0" name="mesh" type="RID">
</argument>
<description>
+ Returns a mesh's blend shape count.
</description>
</method>
<method name="mesh_get_blend_shape_mode" qualifiers="const">
@@ -1036,6 +1128,7 @@
<argument index="0" name="mesh" type="RID">
</argument>
<description>
+ Returns a mesh's blend shape mode.
</description>
</method>
<method name="mesh_get_custom_aabb" qualifiers="const">
@@ -1044,6 +1137,7 @@
<argument index="0" name="mesh" type="RID">
</argument>
<description>
+ Returns a mesh's custom aabb.
</description>
</method>
<method name="mesh_get_surface_count" qualifiers="const">
@@ -1052,6 +1146,7 @@
<argument index="0" name="mesh" type="RID">
</argument>
<description>
+ Returns a mesh's number of surfaces.
</description>
</method>
<method name="mesh_remove_surface">
@@ -1062,6 +1157,7 @@
<argument index="1" name="index" type="int">
</argument>
<description>
+ Removes a mesh's surface.
</description>
</method>
<method name="mesh_set_blend_shape_count">
@@ -1072,6 +1168,7 @@
<argument index="1" name="amount" type="int">
</argument>
<description>
+ Sets a mesh's blend shape count.
</description>
</method>
<method name="mesh_set_blend_shape_mode">
@@ -1082,6 +1179,7 @@
<argument index="1" name="mode" type="int" enum="VisualServer.BlendShapeMode">
</argument>
<description>
+ Sets a mesh's blend shape mode.
</description>
</method>
<method name="mesh_set_custom_aabb">
@@ -1092,6 +1190,7 @@
<argument index="1" name="aabb" type="AABB">
</argument>
<description>
+ Sets a mesh's custom aabb.
</description>
</method>
<method name="mesh_surface_get_aabb" qualifiers="const">
@@ -1102,6 +1201,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's aabb.
</description>
</method>
<method name="mesh_surface_get_array" qualifiers="const">
@@ -1112,6 +1212,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's vertex buffer.
</description>
</method>
<method name="mesh_surface_get_array_index_len" qualifiers="const">
@@ -1122,6 +1223,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's amount of indices.
</description>
</method>
<method name="mesh_surface_get_array_len" qualifiers="const">
@@ -1132,6 +1234,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's amount of vertices.
</description>
</method>
<method name="mesh_surface_get_arrays" qualifiers="const">
@@ -1142,6 +1245,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's buffer arrays.
</description>
</method>
<method name="mesh_surface_get_blend_shape_arrays" qualifiers="const">
@@ -1152,6 +1256,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's arrays for blend shapes
</description>
</method>
<method name="mesh_surface_get_format" qualifiers="const">
@@ -1162,6 +1267,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns the format of a mesh's surface.
</description>
</method>
<method name="mesh_surface_get_index_array" qualifiers="const">
@@ -1172,6 +1278,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's index buffer.
</description>
</method>
<method name="mesh_surface_get_material" qualifiers="const">
@@ -1182,6 +1289,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns a mesh's surface's material.
</description>
</method>
<method name="mesh_surface_get_primitive_type" qualifiers="const">
@@ -1192,6 +1300,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns the primitive type of a mesh's surface.
</description>
</method>
<method name="mesh_surface_get_skeleton_aabb" qualifiers="const">
@@ -1202,6 +1311,7 @@
<argument index="1" name="surface" type="int">
</argument>
<description>
+ Returns the aabb of a mesh's surface's skeleton.
</description>
</method>
<method name="mesh_surface_set_material">
@@ -1214,6 +1324,7 @@
<argument index="2" name="material" type="RID">
</argument>
<description>
+ Sets a mesh's surface's material.
</description>
</method>
<method name="request_frame_drawn_callback">
@@ -1240,6 +1351,7 @@
<argument index="2" name="scale" type="bool">
</argument>
<description>
+ Sets a boot image. The color defines the background color and if scale is [code]true[/code], the image will be scaled to fit the screen size.
</description>
</method>
<method name="set_debug_generate_wireframes">
@@ -1262,6 +1374,7 @@
<return type="RID">
</return>
<description>
+ Creates an empty shader.
</description>
</method>
<method name="shader_get_code" qualifiers="const">
@@ -1270,6 +1383,7 @@
<argument index="0" name="shader" type="RID">
</argument>
<description>
+ Returns a shader's code.
</description>
</method>
<method name="shader_get_default_texture_param" qualifiers="const">
@@ -1280,6 +1394,7 @@
<argument index="1" name="name" type="String">
</argument>
<description>
+ Returns a default texture from a shader searched by name.
</description>
</method>
<method name="shader_get_param_list" qualifiers="const">
@@ -1288,6 +1403,7 @@
<argument index="0" name="shader" type="RID">
</argument>
<description>
+ Returns the parameters of a shader.
</description>
</method>
<method name="shader_set_code">
@@ -1298,6 +1414,7 @@
<argument index="1" name="code" type="String">
</argument>
<description>
+ Sets a shader's code.
</description>
</method>
<method name="shader_set_default_texture_param">
@@ -1310,12 +1427,14 @@
<argument index="2" name="texture" type="RID">
</argument>
<description>
+ Sets a shader's default texture. Overwrites the texture given by name.
</description>
</method>
<method name="sky_create">
<return type="RID">
</return>
<description>
+ Creates an empty sky.
</description>
</method>
<method name="sky_set_texture">
@@ -1328,6 +1447,7 @@
<argument index="2" name="radiance_size" type="int">
</argument>
<description>
+ Sets a sky's texture.
</description>
</method>
<method name="sync">
@@ -1350,12 +1470,14 @@
<argument index="4" name="flags" type="int" default="7">
</argument>
<description>
+ Allocates space for a texture's image or video.
</description>
</method>
<method name="texture_create">
<return type="RID">
</return>
<description>
+ Creates an empty texture.
</description>
</method>
<method name="texture_create_from_image">
@@ -1366,12 +1488,14 @@
<argument index="1" name="flags" type="int" default="7">
</argument>
<description>
+ Creates a texture, allocates the space for an image, and fills in the image.
</description>
</method>
<method name="texture_debug_usage">
<return type="Array">
</return>
<description>
+ Returns a list of all the textures and their information.
</description>
</method>
<method name="texture_get_data" qualifiers="const">
@@ -1382,6 +1506,7 @@
<argument index="1" name="cube_side" type="int" enum="VisualServer.CubeMapSide" default="0">
</argument>
<description>
+ Returns a copy of a texture's image unless it's a CubeMap, in wich case it returns the [RID] of the image at one of the cubes sides.
</description>
</method>
<method name="texture_get_flags" qualifiers="const">
@@ -1390,6 +1515,7 @@
<argument index="0" name="texture" type="RID">
</argument>
<description>
+ Returns the flags of a texture.
</description>
</method>
<method name="texture_get_format" qualifiers="const">
@@ -1398,6 +1524,7 @@
<argument index="0" name="texture" type="RID">
</argument>
<description>
+ Returns the format of the texture's image.
</description>
</method>
<method name="texture_get_height" qualifiers="const">
@@ -1406,6 +1533,7 @@
<argument index="0" name="texture" type="RID">
</argument>
<description>
+ Returns the texture's height.
</description>
</method>
<method name="texture_get_path" qualifiers="const">
@@ -1414,6 +1542,7 @@
<argument index="0" name="texture" type="RID">
</argument>
<description>
+ Returns the texture's path.
</description>
</method>
<method name="texture_get_texid" qualifiers="const">
@@ -1422,6 +1551,7 @@
<argument index="0" name="texture" type="RID">
</argument>
<description>
+ Returns the opengl id of the texture's image.
</description>
</method>
<method name="texture_get_width" qualifiers="const">
@@ -1430,6 +1560,7 @@
<argument index="0" name="texture" type="RID">
</argument>
<description>
+ Returns the texture's width.
</description>
</method>
<method name="texture_set_data">
@@ -1442,6 +1573,7 @@
<argument index="2" name="cube_side" type="int" enum="VisualServer.CubeMapSide" default="0">
</argument>
<description>
+ Sets the texture's image data. If it's a CubeMap, it sets the image data at a cube side.
</description>
</method>
<method name="texture_set_flags">
@@ -1452,6 +1584,7 @@
<argument index="1" name="flags" type="int">
</argument>
<description>
+ Sets the texture's flags. See [enum TextureFlags] for options
</description>
</method>
<method name="texture_set_path">
@@ -1462,6 +1595,7 @@
<argument index="1" name="path" type="String">
</argument>
<description>
+ Sets the texture's path.
</description>
</method>
<method name="texture_set_shrink_all_x2_on_set_data">
@@ -1470,6 +1604,7 @@
<argument index="0" name="shrink" type="bool">
</argument>
<description>
+ If [code]true[/code], sets internal processes to shrink all image data to half the size.
</description>
</method>
<method name="texture_set_size_override">
@@ -1482,6 +1617,7 @@
<argument index="2" name="height" type="int">
</argument>
<description>
+ Overwrites the texture's width and height.
</description>
</method>
<method name="textures_keep_original">
@@ -1490,6 +1626,7 @@
<argument index="0" name="enable" type="bool">
</argument>
<description>
+ If [code]true[/code], the image will be stored in the texture's images array if overwritten.
</description>
</method>
<method name="viewport_attach_camera">
@@ -1500,6 +1637,7 @@
<argument index="1" name="camera" type="RID">
</argument>
<description>
+ Sets a viewport's camera.
</description>
</method>
<method name="viewport_attach_canvas">
@@ -1510,6 +1648,7 @@
<argument index="1" name="canvas" type="RID">
</argument>
<description>
+ Sets a viewport's canvas.
</description>
</method>
<method name="viewport_attach_to_screen">
@@ -1522,12 +1661,14 @@
<argument index="2" name="screen" type="int" default="0">
</argument>
<description>
+ Attaches a viewport to a screen.
</description>
</method>
<method name="viewport_create">
<return type="RID">
</return>
<description>
+ Creates an empty viewport.
</description>
</method>
<method name="viewport_detach">
@@ -1536,6 +1677,7 @@
<argument index="0" name="viewport" type="RID">
</argument>
<description>
+ Detaches the viewport from the screen.
</description>
</method>
<method name="viewport_get_render_info">
@@ -1546,6 +1688,7 @@
<argument index="1" name="info" type="int" enum="VisualServer.ViewportRenderInfo">
</argument>
<description>
+ Returns a viewport's render info. for options see VIEWPORT_RENDER_INFO* constants.
</description>
</method>
<method name="viewport_get_texture" qualifiers="const">
@@ -1554,6 +1697,7 @@
<argument index="0" name="viewport" type="RID">
</argument>
<description>
+ Returns the viewport's last rendered frame.
</description>
</method>
<method name="viewport_remove_canvas">
@@ -1564,6 +1708,7 @@
<argument index="1" name="canvas" type="RID">
</argument>
<description>
+ Detaches a viewport from a canvas and vice versa.
</description>
</method>
<method name="viewport_set_active">
@@ -1574,6 +1719,7 @@
<argument index="1" name="active" type="bool">
</argument>
<description>
+ If [code]true[/code], sets the viewport active, else sets it inactive.
</description>
</method>
<method name="viewport_set_canvas_layer">
@@ -1586,6 +1732,7 @@
<argument index="2" name="layer" type="int">
</argument>
<description>
+ Sets the renderlayer for a viewport's canvas.
</description>
</method>
<method name="viewport_set_canvas_transform">
@@ -1598,6 +1745,7 @@
<argument index="2" name="offset" type="Transform2D">
</argument>
<description>
+ Sets the transformation of a viewport's canvas.
</description>
</method>
<method name="viewport_set_clear_mode">
@@ -1608,6 +1756,7 @@
<argument index="1" name="clear_mode" type="int" enum="VisualServer.ViewportClearMode">
</argument>
<description>
+ Sets the clear mode of a viewport. See VIEWPORT_CLEAR_MODE_* constants for options.
</description>
</method>
<method name="viewport_set_debug_draw">
@@ -1618,6 +1767,7 @@
<argument index="1" name="draw" type="int" enum="VisualServer.ViewportDebugDraw">
</argument>
<description>
+ Sets the debug draw mode of a viewport. See VIEWPORT_DEBUG_DRAW_* constants for options.
</description>
</method>
<method name="viewport_set_disable_3d">
@@ -1628,6 +1778,7 @@
<argument index="1" name="disabled" type="bool">
</argument>
<description>
+ If [code]true[/code] a viewport's 3D rendering should be disabled.
</description>
</method>
<method name="viewport_set_disable_environment">
@@ -1638,6 +1789,7 @@
<argument index="1" name="disabled" type="bool">
</argument>
<description>
+ If [code]true[/code] rendering of a viewport's environment should be disabled.
</description>
</method>
<method name="viewport_set_global_canvas_transform">
@@ -1648,6 +1800,7 @@
<argument index="1" name="transform" type="Transform2D">
</argument>
<description>
+ Sets the viewport's global transformation matrix.
</description>
</method>
<method name="viewport_set_hdr">
@@ -1658,6 +1811,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ If [code]true[/code] the viewport should render to hdr.
</description>
</method>
<method name="viewport_set_hide_canvas">
@@ -1668,6 +1822,7 @@
<argument index="1" name="hidden" type="bool">
</argument>
<description>
+ If [code]true[/code] the viewport's canvas should not be rendered.
</description>
</method>
<method name="viewport_set_hide_scenario">
@@ -1688,6 +1843,7 @@
<argument index="1" name="msaa" type="int" enum="VisualServer.ViewportMSAA">
</argument>
<description>
+ Sets the anti-aliasing mode. see [enum ViewportMSAA] for options.
</description>
</method>
<method name="viewport_set_parent_viewport">
@@ -1698,6 +1854,7 @@
<argument index="1" name="parent_viewport" type="RID">
</argument>
<description>
+ Sets the viewport's parent to another viewport.
</description>
</method>
<method name="viewport_set_scenario">
@@ -1708,6 +1865,8 @@
<argument index="1" name="scenario" type="RID">
</argument>
<description>
+ Sets a viewport's scenario.
+ The scenario contains information about the [enum ScenarioDebugMode], environment information, reflection atlas etc.
</description>
</method>
<method name="viewport_set_shadow_atlas_quadrant_subdivision">
@@ -1720,6 +1879,7 @@
<argument index="2" name="subdivision" type="int">
</argument>
<description>
+ Sets the shadow atlas quadrant's subdivision.
</description>
</method>
<method name="viewport_set_shadow_atlas_size">
@@ -1730,6 +1890,7 @@
<argument index="1" name="size" type="int">
</argument>
<description>
+ Sets the size of the shadow atlas's images.
</description>
</method>
<method name="viewport_set_size">
@@ -1742,6 +1903,7 @@
<argument index="2" name="height" type="int">
</argument>
<description>
+ Sets the viewport's width and height.
</description>
</method>
<method name="viewport_set_transparent_background">
@@ -1752,6 +1914,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ If [code]true[/code] the viewport should render its background as transparent.
</description>
</method>
<method name="viewport_set_update_mode">
@@ -1762,6 +1925,7 @@
<argument index="1" name="update_mode" type="int" enum="VisualServer.ViewportUpdateMode">
</argument>
<description>
+ Sets when the viewport should be updated. See VIEWPORT_UPDATE_MODE_* constants for options.
</description>
</method>
<method name="viewport_set_usage">
@@ -1772,6 +1936,7 @@
<argument index="1" name="usage" type="int" enum="VisualServer.ViewportUsage">
</argument>
<description>
+ Sets what should be rendered in the viewport. See VIEWPORT_USAGE_* constants for options.
</description>
</method>
<method name="viewport_set_use_arvr">
@@ -1782,6 +1947,7 @@
<argument index="1" name="use_arvr" type="bool">
</argument>
<description>
+ If [code]true[/code] the viewport should use augmented or virtual reality technologies. See [ARVRInterface].
</description>
</method>
<method name="viewport_set_vflip">
@@ -1792,6 +1958,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
+ If [code]true[/code] the viewport's rendering should be flipped vertically.
</description>
</method>
</methods>
@@ -1803,160 +1970,232 @@
</signals>
<constants>
<constant name="NO_INDEX_ARRAY" value="-1">
+ Marks an error that shows that the index array is empty.
</constant>
<constant name="ARRAY_WEIGHTS_SIZE" value="4">
</constant>
<constant name="CANVAS_ITEM_Z_MIN" value="-4096">
+ The minimum Z-layer for canvas items.
</constant>
<constant name="CANVAS_ITEM_Z_MAX" value="4096">
+ The maximum Z-layer for canvas items.
</constant>
<constant name="MAX_GLOW_LEVELS" value="7">
</constant>
<constant name="MAX_CURSORS" value="8">
</constant>
<constant name="MATERIAL_RENDER_PRIORITY_MIN" value="-128">
+ The minimum renderpriority of all materials.
</constant>
<constant name="MATERIAL_RENDER_PRIORITY_MAX" value="127">
+ The maximum renderpriority of all materials.
</constant>
<constant name="CUBEMAP_LEFT" value="0" enum="CubeMapSide">
+ Marks the left side of a cubemap.
</constant>
<constant name="CUBEMAP_RIGHT" value="1" enum="CubeMapSide">
+ Marks the right side of a cubemap.
</constant>
<constant name="CUBEMAP_BOTTOM" value="2" enum="CubeMapSide">
+ Marks the bottom side of a cubemap.
</constant>
<constant name="CUBEMAP_TOP" value="3" enum="CubeMapSide">
+ Marks the top side of a cubemap.
</constant>
<constant name="CUBEMAP_FRONT" value="4" enum="CubeMapSide">
+ Marks the front side of a cubemap.
</constant>
<constant name="CUBEMAP_BACK" value="5" enum="CubeMapSide">
+ Marks the back side of a cubemap.
</constant>
<constant name="TEXTURE_FLAG_MIPMAPS" value="1" enum="TextureFlags">
+ Generate mipmaps, which are smaller versions of the same texture to use when zoomed out, keeping the aspect ratio.
</constant>
<constant name="TEXTURE_FLAG_REPEAT" value="2" enum="TextureFlags">
+ Repeat (instead of clamp to edge).
</constant>
<constant name="TEXTURE_FLAG_FILTER" value="4" enum="TextureFlags">
+ Turn on magnifying filter, to enable smooth zooming in of the texture.
</constant>
<constant name="TEXTURE_FLAG_ANISOTROPIC_FILTER" value="8" enum="TextureFlags">
+ Anisotropic mipmap filtering. Generates smaller versions of the same texture with different aspect ratios.
+ More effective on planes often shown going to the horrizon as those textures (Walls or Ground for example) get squashed in the viewport to different aspect ratios and regular mipmaps keep the aspect ratio so they don't optimize storage that well in those cases.
</constant>
<constant name="TEXTURE_FLAG_CONVERT_TO_LINEAR" value="16" enum="TextureFlags">
+ Converts texture to SRGB color space.
</constant>
<constant name="TEXTURE_FLAG_MIRRORED_REPEAT" value="32" enum="TextureFlags">
+ Repeat texture with alternate sections mirrored.
</constant>
<constant name="TEXTURE_FLAG_CUBEMAP" value="2048" enum="TextureFlags">
+ Texture is a cubemap.
</constant>
<constant name="TEXTURE_FLAG_USED_FOR_STREAMING" value="4096" enum="TextureFlags">
+ Texture is a video surface.
</constant>
<constant name="TEXTURE_FLAGS_DEFAULT" value="7" enum="TextureFlags">
+ Default flags. Generate mipmaps, repeat, and filter are enabled.
</constant>
<constant name="SHADER_SPATIAL" value="0" enum="ShaderMode">
+ Shader is a 3D shader.
</constant>
<constant name="SHADER_CANVAS_ITEM" value="1" enum="ShaderMode">
+ Shader is a 2D shader.
</constant>
<constant name="SHADER_PARTICLES" value="2" enum="ShaderMode">
+ Shader is a particle shader.
</constant>
<constant name="SHADER_MAX" value="3" enum="ShaderMode">
+ Marks maximum of the shader types array. used internally.
</constant>
<constant name="ARRAY_VERTEX" value="0" enum="ArrayType">
+ Array is a vertex array.
</constant>
<constant name="ARRAY_NORMAL" value="1" enum="ArrayType">
+ Array is a normal array.
</constant>
<constant name="ARRAY_TANGENT" value="2" enum="ArrayType">
+ Array is a tangent array.
</constant>
<constant name="ARRAY_COLOR" value="3" enum="ArrayType">
+ Array is a color array.
</constant>
<constant name="ARRAY_TEX_UV" value="4" enum="ArrayType">
+ Array is a uv coordinates array.
</constant>
<constant name="ARRAY_TEX_UV2" value="5" enum="ArrayType">
+ Array is a uv coordinates array for the second uv coordinates.
</constant>
<constant name="ARRAY_BONES" value="6" enum="ArrayType">
+ Array contains bone information.
</constant>
<constant name="ARRAY_WEIGHTS" value="7" enum="ArrayType">
+ Array is weight information.
</constant>
<constant name="ARRAY_INDEX" value="8" enum="ArrayType">
+ Array is index array.
</constant>
<constant name="ARRAY_MAX" value="9" enum="ArrayType">
+ Marks the maximum of the array types. Used internally.
</constant>
<constant name="ARRAY_FORMAT_VERTEX" value="1" enum="ArrayFormat">
+ Flag used to mark a vertex array.
</constant>
<constant name="ARRAY_FORMAT_NORMAL" value="2" enum="ArrayFormat">
+ Flag used to mark a normal array.
</constant>
<constant name="ARRAY_FORMAT_TANGENT" value="4" enum="ArrayFormat">
+ Flag used to mark a tangent array.
</constant>
<constant name="ARRAY_FORMAT_COLOR" value="8" enum="ArrayFormat">
+ Flag used to mark a color array.
</constant>
<constant name="ARRAY_FORMAT_TEX_UV" value="16" enum="ArrayFormat">
+ Flag used to mark a uv coordinates array.
</constant>
<constant name="ARRAY_FORMAT_TEX_UV2" value="32" enum="ArrayFormat">
+ Flag used to mark a uv coordinates array for the second uv coordinates.
</constant>
<constant name="ARRAY_FORMAT_BONES" value="64" enum="ArrayFormat">
+ Flag used to mark a bone information array.
</constant>
<constant name="ARRAY_FORMAT_WEIGHTS" value="128" enum="ArrayFormat">
+ Flag used to mark a weights array.
</constant>
<constant name="ARRAY_FORMAT_INDEX" value="256" enum="ArrayFormat">
+ Flag used to mark a index array.
</constant>
<constant name="ARRAY_COMPRESS_VERTEX" value="512" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) vertex array.
</constant>
<constant name="ARRAY_COMPRESS_NORMAL" value="1024" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) normal array.
</constant>
<constant name="ARRAY_COMPRESS_TANGENT" value="2048" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) tangent array.
</constant>
<constant name="ARRAY_COMPRESS_COLOR" value="4096" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) color array.
</constant>
<constant name="ARRAY_COMPRESS_TEX_UV" value="8192" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) uv coordinates array.
</constant>
<constant name="ARRAY_COMPRESS_TEX_UV2" value="16384" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) uv coordinates array for the second uv coordinates.
</constant>
<constant name="ARRAY_COMPRESS_BONES" value="32768" enum="ArrayFormat">
</constant>
<constant name="ARRAY_COMPRESS_WEIGHTS" value="65536" enum="ArrayFormat">
+ Flag used to mark a compressed (half float) weight array.
</constant>
<constant name="ARRAY_COMPRESS_INDEX" value="131072" enum="ArrayFormat">
</constant>
<constant name="ARRAY_FLAG_USE_2D_VERTICES" value="262144" enum="ArrayFormat">
+ Flag used to mark that the array contains 2D vertices.
</constant>
<constant name="ARRAY_FLAG_USE_16_BIT_BONES" value="524288" enum="ArrayFormat">
+ Flag used to mark that the array uses 16 bit bones instead of 8 bit.
</constant>
<constant name="ARRAY_COMPRESS_DEFAULT" value="97792" enum="ArrayFormat">
+ Used to set flags ARRAY_COMPRESS_VERTEX, ARRAY_COMPRESS_NORMAL, ARRAY_COMPRESS_TANGENT, ARRAY_COMPRESS_COLOR, ARRAY_COMPRESS_TEX_UV, ARRAY_COMPRESS_TEX_UV2 and ARRAY_COMPRESS_WEIGHTS quickly.
</constant>
<constant name="PRIMITIVE_POINTS" value="0" enum="PrimitiveType">
+ Primitive to draw consists of points.
</constant>
<constant name="PRIMITIVE_LINES" value="1" enum="PrimitiveType">
+ Primitive to draw consists of lines.
</constant>
<constant name="PRIMITIVE_LINE_STRIP" value="2" enum="PrimitiveType">
+ Primitive to draw consists of a line strip from start to end.
</constant>
<constant name="PRIMITIVE_LINE_LOOP" value="3" enum="PrimitiveType">
+ Primitive to draw consists of a line loop (a line strip with a line between the last and the first vertex).
</constant>
<constant name="PRIMITIVE_TRIANGLES" value="4" enum="PrimitiveType">
+ Primitive to draw consists of triangles.
</constant>
<constant name="PRIMITIVE_TRIANGLE_STRIP" value="5" enum="PrimitiveType">
+ Primitive to draw consists of a triangle strip (the last 3 verticies are always combined to make a triangle).
</constant>
<constant name="PRIMITIVE_TRIANGLE_FAN" value="6" enum="PrimitiveType">
+ Primitive to draw consists of a triangle strip (the last 2 verticies are always combined with the first to make a triangle).
</constant>
<constant name="PRIMITIVE_MAX" value="7" enum="PrimitiveType">
+ Marks the primitive types endpoint. used internally.
</constant>
<constant name="BLEND_SHAPE_MODE_NORMALIZED" value="0" enum="BlendShapeMode">
</constant>
<constant name="BLEND_SHAPE_MODE_RELATIVE" value="1" enum="BlendShapeMode">
</constant>
<constant name="LIGHT_DIRECTIONAL" value="0" enum="LightType">
+ Is a directional (sun) light.
</constant>
<constant name="LIGHT_OMNI" value="1" enum="LightType">
+ is an omni light.
</constant>
<constant name="LIGHT_SPOT" value="2" enum="LightType">
+ is an spot light.
</constant>
<constant name="LIGHT_PARAM_ENERGY" value="0" enum="LightParam">
+ The light's energy.
</constant>
<constant name="LIGHT_PARAM_SPECULAR" value="2" enum="LightParam">
+ The light's influence on specularity.
</constant>
<constant name="LIGHT_PARAM_RANGE" value="3" enum="LightParam">
+ The light's range.
</constant>
<constant name="LIGHT_PARAM_ATTENUATION" value="4" enum="LightParam">
+ The light's attenuation.
</constant>
<constant name="LIGHT_PARAM_SPOT_ANGLE" value="5" enum="LightParam">
+ The spotlight's angle.
</constant>
<constant name="LIGHT_PARAM_SPOT_ATTENUATION" value="6" enum="LightParam">
+ The spotlight's attenuation.
</constant>
<constant name="LIGHT_PARAM_CONTACT_SHADOW_SIZE" value="7" enum="LightParam">
+ Scales the shadow color.
</constant>
<constant name="LIGHT_PARAM_SHADOW_MAX_DISTANCE" value="8" enum="LightParam">
</constant>
@@ -1973,6 +2212,7 @@
<constant name="LIGHT_PARAM_SHADOW_BIAS_SPLIT_SCALE" value="14" enum="LightParam">
</constant>
<constant name="LIGHT_PARAM_MAX" value="15" enum="LightParam">
+ The light parameters endpoint. Used internally.
</constant>
<constant name="VIEWPORT_UPDATE_DISABLED" value="0" enum="ViewportUpdateMode">
</constant>
@@ -1983,28 +2223,40 @@
<constant name="VIEWPORT_UPDATE_ALWAYS" value="3" enum="ViewportUpdateMode">
</constant>
<constant name="VIEWPORT_CLEAR_ALWAYS" value="0" enum="ViewportClearMode">
+ The viewport is always cleared before drawing.
</constant>
<constant name="VIEWPORT_CLEAR_NEVER" value="1" enum="ViewportClearMode">
+ The viewport is never cleared before drawing.
</constant>
<constant name="VIEWPORT_CLEAR_ONLY_NEXT_FRAME" value="2" enum="ViewportClearMode">
+ The viewport is cleared once, then the clear mode is set to [VIEWPORT_CLEAR_NEVER].
</constant>
<constant name="VIEWPORT_MSAA_DISABLED" value="0" enum="ViewportMSAA">
+ Multisample antialiasing is disabled.
</constant>
<constant name="VIEWPORT_MSAA_2X" value="1" enum="ViewportMSAA">
+ Multisample antialiasing is set to 2X.
</constant>
<constant name="VIEWPORT_MSAA_4X" value="2" enum="ViewportMSAA">
+ Multisample antialiasing is set to 4X.
</constant>
<constant name="VIEWPORT_MSAA_8X" value="3" enum="ViewportMSAA">
+ Multisample antialiasing is set to 8X.
</constant>
<constant name="VIEWPORT_MSAA_16X" value="4" enum="ViewportMSAA">
+ Multisample antialiasing is set to 16X.
</constant>
<constant name="VIEWPORT_USAGE_2D" value="0" enum="ViewportUsage">
+ The Viewport does not render 3D but samples.
</constant>
<constant name="VIEWPORT_USAGE_2D_NO_SAMPLING" value="1" enum="ViewportUsage">
+ The Viewport does not render 3D and does not sample.
</constant>
<constant name="VIEWPORT_USAGE_3D" value="2" enum="ViewportUsage">
+ The Viewport renders 3D with effects.
</constant>
<constant name="VIEWPORT_USAGE_3D_NO_EFFECTS" value="3" enum="ViewportUsage">
+ The Viewport renders 3D but without effects.
</constant>
<constant name="VIEWPORT_RENDER_INFO_OBJECTS_IN_FRAME" value="0" enum="ViewportRenderInfo">
</constant>
@@ -2019,14 +2271,19 @@
<constant name="VIEWPORT_RENDER_INFO_DRAW_CALLS_IN_FRAME" value="5" enum="ViewportRenderInfo">
</constant>
<constant name="VIEWPORT_RENDER_INFO_MAX" value="6" enum="ViewportRenderInfo">
+ Marks end of VIEWPORT_RENDER_INFO* constants. Used internally.
</constant>
<constant name="VIEWPORT_DEBUG_DRAW_DISABLED" value="0" enum="ViewportDebugDraw">
+ Debug draw is disabled. Default setting.
</constant>
<constant name="VIEWPORT_DEBUG_DRAW_UNSHADED" value="1" enum="ViewportDebugDraw">
+ Debug draw sets objects to unshaded.
</constant>
<constant name="VIEWPORT_DEBUG_DRAW_OVERDRAW" value="2" enum="ViewportDebugDraw">
+ Overwrites clear color to [code](0,0,0,0)[/code].
</constant>
<constant name="VIEWPORT_DEBUG_DRAW_WIREFRAME" value="3" enum="ViewportDebugDraw">
+ Debug draw draws objects in wireframe.
</constant>
<constant name="SCENARIO_DEBUG_DISABLED" value="0" enum="ScenarioDebugMode">
</constant>
@@ -2037,38 +2294,53 @@
<constant name="SCENARIO_DEBUG_SHADELESS" value="3" enum="ScenarioDebugMode">
</constant>
<constant name="INSTANCE_NONE" value="0" enum="InstanceType">
+ The instance does not have a type.
</constant>
<constant name="INSTANCE_MESH" value="1" enum="InstanceType">
+ The instance is a mesh.
</constant>
<constant name="INSTANCE_MULTIMESH" value="2" enum="InstanceType">
+ The instance is a multimesh.
</constant>
<constant name="INSTANCE_IMMEDIATE" value="3" enum="InstanceType">
+ The instance is an immediate geometry.
</constant>
<constant name="INSTANCE_PARTICLES" value="4" enum="InstanceType">
+ The instance is a particle emitter.
</constant>
<constant name="INSTANCE_LIGHT" value="5" enum="InstanceType">
+ The instance is a light.
</constant>
<constant name="INSTANCE_REFLECTION_PROBE" value="6" enum="InstanceType">
</constant>
<constant name="INSTANCE_GI_PROBE" value="7" enum="InstanceType">
</constant>
<constant name="INSTANCE_MAX" value="8" enum="InstanceType">
+ The max value for INSTANCE_* constants, used internally.
</constant>
<constant name="INSTANCE_GEOMETRY_MASK" value="30" enum="InstanceType">
+ A combination of the flags of geometry instances (mesh, multimesh, immediate and particles).
</constant>
<constant name="NINE_PATCH_STRETCH" value="0" enum="NinePatchAxisMode">
+ The nine patch gets stretched where needed.
</constant>
<constant name="NINE_PATCH_TILE" value="1" enum="NinePatchAxisMode">
+ The nine patch gets filled with tiles where needed.
</constant>
<constant name="NINE_PATCH_TILE_FIT" value="2" enum="NinePatchAxisMode">
+ The nine patch gets filled with tiles where needed and stretches them a bit if needed.
</constant>
<constant name="CANVAS_LIGHT_MODE_ADD" value="0" enum="CanvasLightMode">
+ Adds light color additive to the canvas.
</constant>
<constant name="CANVAS_LIGHT_MODE_SUB" value="1" enum="CanvasLightMode">
+ Adds light color subtractive to the canvas.
</constant>
<constant name="CANVAS_LIGHT_MODE_MIX" value="2" enum="CanvasLightMode">
+ The light adds color depending on transparency.
</constant>
<constant name="CANVAS_LIGHT_MODE_MASK" value="3" enum="CanvasLightMode">
+ The light adds color depending on mask.
</constant>
<constant name="CANVAS_LIGHT_FILTER_NONE" value="0" enum="CanvasLightShadowFilter">
</constant>
@@ -2083,30 +2355,42 @@
<constant name="CANVAS_LIGHT_FILTER_PCF13" value="5" enum="CanvasLightShadowFilter">
</constant>
<constant name="CANVAS_OCCLUDER_POLYGON_CULL_DISABLED" value="0" enum="CanvasOccluderPolygonCullMode">
+ Culling of the canvas occluder is disabled.
</constant>
<constant name="CANVAS_OCCLUDER_POLYGON_CULL_CLOCKWISE" value="1" enum="CanvasOccluderPolygonCullMode">
+ Culling of the canvas occluder is clockwise.
</constant>
<constant name="CANVAS_OCCLUDER_POLYGON_CULL_COUNTER_CLOCKWISE" value="2" enum="CanvasOccluderPolygonCullMode">
+ Culling of the canvas occluder is counterclockwise.
</constant>
<constant name="INFO_OBJECTS_IN_FRAME" value="0" enum="RenderInfo">
+ The amount of objects in the frame.
</constant>
<constant name="INFO_VERTICES_IN_FRAME" value="1" enum="RenderInfo">
+ The amount of vertices in the frame.
</constant>
<constant name="INFO_MATERIAL_CHANGES_IN_FRAME" value="2" enum="RenderInfo">
+ The amount of modified materials in the frame.
</constant>
<constant name="INFO_SHADER_CHANGES_IN_FRAME" value="3" enum="RenderInfo">
+ The amount of shader rebinds in the frame.
</constant>
<constant name="INFO_SURFACE_CHANGES_IN_FRAME" value="4" enum="RenderInfo">
+ The amount of surface changes in the frame.
</constant>
<constant name="INFO_DRAW_CALLS_IN_FRAME" value="5" enum="RenderInfo">
+ The amount of draw calls in frame.
</constant>
<constant name="INFO_USAGE_VIDEO_MEM_TOTAL" value="6" enum="RenderInfo">
</constant>
<constant name="INFO_VIDEO_MEM_USED" value="7" enum="RenderInfo">
+ The amount of vertex memory and texture memory used.
</constant>
<constant name="INFO_TEXTURE_MEM_USED" value="8" enum="RenderInfo">
+ The amount of texture memory used.
</constant>
<constant name="INFO_VERTEX_MEM_USED" value="9" enum="RenderInfo">
+ The amount of vertex memory used.
</constant>
<constant name="FEATURE_SHADERS" value="0" enum="Features">
</constant>