diff --git a/classes/class_animationtree.rst b/classes/class_animationtree.rst index a8c667683..de50ddf01 100644 --- a/classes/class_animationtree.rst +++ b/classes/class_animationtree.rst @@ -13,6 +13,11 @@ AnimationTree A node to be used for advanced animation transitions in an :ref:`AnimationPlayer`. +Description +----------- + +Note: When linked with an :ref:`AnimationPlayer`, several properties and methods of the corresponding :ref:`AnimationPlayer` will not function as expected. Playback and transitions should be handled using only the ``AnimationTree`` and its constituent :ref:`AnimationNode`\ (s). The :ref:`AnimationPlayer` node should be used solely for adding, deleting, and editing animations. + Tutorials --------- @@ -128,6 +133,10 @@ The process mode of this ``AnimationTree``. See :ref:`AnimationProcessMode`, the transformation will be cancelled visually, and the animation will appear to stay in place. + ---- .. _class_AnimationTree_property_tree_root: @@ -157,6 +166,8 @@ Manually advance the animations by the specified time (in seconds). - :ref:`Transform` **get_root_motion_transform** **(** **)** const +Retrieve the motion of the :ref:`root_motion_track` as a :ref:`Transform` that can be used elsewhere. If :ref:`root_motion_track` is not a path to a track of type :ref:`Animation.TYPE_TRANSFORM`, returns an identity transformation. + ---- .. _class_AnimationTree_method_rename_parameter: diff --git a/classes/class_bitmapfont.rst b/classes/class_bitmapfont.rst index b3eb15e03..9a70e1405 100644 --- a/classes/class_bitmapfont.rst +++ b/classes/class_bitmapfont.rst @@ -47,8 +47,6 @@ Methods +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`create_from_fnt` **(** :ref:`String` path **)** | +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| :ref:`Vector2` | :ref:`get_char_size` **(** :ref:`int` char, :ref:`int` next=0 **)** const | -+---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_kerning_pair` **(** :ref:`int` char_a, :ref:`int` char_b **)** const | +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Texture` | :ref:`get_texture` **(** :ref:`int` idx **)** const | @@ -162,14 +160,6 @@ Creates a BitmapFont from the ``*.fnt`` file at ``path``. ---- -.. _class_BitmapFont_method_get_char_size: - -- :ref:`Vector2` **get_char_size** **(** :ref:`int` char, :ref:`int` next=0 **)** const - -Returns the size of a character, optionally taking kerning into account if the next character is provided. - ----- - .. _class_BitmapFont_method_get_kerning_pair: - :ref:`int` **get_kerning_pair** **(** :ref:`int` char_a, :ref:`int` char_b **)** const diff --git a/classes/class_directionallight.rst b/classes/class_directionallight.rst index 12a29352b..c170683b2 100644 --- a/classes/class_directionallight.rst +++ b/classes/class_directionallight.rst @@ -61,11 +61,11 @@ Enumerations enum **ShadowMode**: -- **SHADOW_ORTHOGONAL** = **0** --- Renders the entire scene's shadow map from an orthogonal point of view. May result in blockier shadows on close objects. +- **SHADOW_ORTHOGONAL** = **0** --- Renders the entire scene's shadow map from an orthogonal point of view. This is the fastest directional shadow mode. May result in blurrier shadows on close objects. -- **SHADOW_PARALLEL_2_SPLITS** = **1** --- Splits the view frustum in 2 areas, each with its own shadow map. +- **SHADOW_PARALLEL_2_SPLITS** = **1** --- Splits the view frustum in 2 areas, each with its own shadow map. This shadow mode is a compromise between :ref:`SHADOW_ORTHOGONAL` and :ref:`SHADOW_PARALLEL_4_SPLITS` in terms of performance. -- **SHADOW_PARALLEL_4_SPLITS** = **2** --- Splits the view frustum in 4 areas, each with its own shadow map. +- **SHADOW_PARALLEL_4_SPLITS** = **2** --- Splits the view frustum in 4 areas, each with its own shadow map. This is the slowest directional shadow mode. ---- @@ -79,7 +79,7 @@ enum **ShadowDepthRange**: - **SHADOW_DEPTH_RANGE_STABLE** = **0** --- Keeps the shadow stable when the camera moves, at the cost of lower effective shadow resolution. -- **SHADOW_DEPTH_RANGE_OPTIMIZED** = **1** --- Tries to achieve maximum shadow resolution. May result in saw effect on shadow edges. +- **SHADOW_DEPTH_RANGE_OPTIMIZED** = **1** --- Tries to achieve maximum shadow resolution. May result in saw effect on shadow edges. This mode typically works best in games where the camera will often move at high speeds, such as most racing games. Property Descriptions --------------------- diff --git a/classes/class_dynamicfontdata.rst b/classes/class_dynamicfontdata.rst index b6fdbdc00..66f7f65a7 100644 --- a/classes/class_dynamicfontdata.rst +++ b/classes/class_dynamicfontdata.rst @@ -63,7 +63,7 @@ Property Descriptions | *Getter* | is_antialiased() | +-----------+------------------------+ -If ``true``, the font is rendered with anti-aliasing. +If ``true``, the font is rendered with anti-aliasing. This property applies both to the main font and its outline (if it has one). ---- diff --git a/classes/class_editorinterface.rst b/classes/class_editorinterface.rst index 51e689c56..3fa1a4e38 100644 --- a/classes/class_editorinterface.rst +++ b/classes/class_editorinterface.rst @@ -20,6 +20,13 @@ EditorInterface gives you control over Godot editor's window. It allows customiz **Note:** This class shouldn't be instantiated directly. Instead, access the singleton using :ref:`EditorPlugin.get_editor_interface`. +Properties +---------- + ++-------------------------+------------------------------------------------------------------------------------+ +| :ref:`bool` | :ref:`distraction_free_mode` | ++-------------------------+------------------------------------------------------------------------------------+ + Methods ------- @@ -68,13 +75,24 @@ Methods +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`select_file` **(** :ref:`String` file **)** | +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| void | :ref:`set_distraction_free_mode` **(** :ref:`bool` enter **)** | -+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_main_screen_editor` **(** :ref:`String` name **)** | +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_plugin_enabled` **(** :ref:`String` plugin, :ref:`bool` enabled **)** | +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ +Property Descriptions +--------------------- + +.. _class_EditorInterface_property_distraction_free_mode: + +- :ref:`bool` **distraction_free_mode** + ++----------+------------------------------------+ +| *Setter* | set_distraction_free_mode(value) | ++----------+------------------------------------+ +| *Getter* | is_distraction_free_mode_enabled() | ++----------+------------------------------------+ + Method Descriptions ------------------- @@ -246,12 +264,6 @@ Selects the file, with the path provided by ``file``, in the FileSystem dock. ---- -.. _class_EditorInterface_method_set_distraction_free_mode: - -- void **set_distraction_free_mode** **(** :ref:`bool` enter **)** - ----- - .. _class_EditorInterface_method_set_main_screen_editor: - void **set_main_screen_editor** **(** :ref:`String` name **)** diff --git a/classes/class_font.rst b/classes/class_font.rst index 32ec39ec9..70d0e2505 100644 --- a/classes/class_font.rst +++ b/classes/class_font.rst @@ -30,6 +30,8 @@ Methods +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_ascent` **(** **)** const | +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`Vector2` | :ref:`get_char_size` **(** :ref:`int` char, :ref:`int` next=0 **)** const | ++-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_descent` **(** **)** const | +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_height` **(** **)** const | @@ -72,6 +74,14 @@ Returns the font ascent (number of pixels above the baseline). ---- +.. _class_Font_method_get_char_size: + +- :ref:`Vector2` **get_char_size** **(** :ref:`int` char, :ref:`int` next=0 **)** const + +Returns the size of a character, optionally taking kerning into account if the next character is provided. + +---- + .. _class_Font_method_get_descent: - :ref:`float` **get_descent** **(** **)** const diff --git a/classes/class_projectsettings.rst b/classes/class_projectsettings.rst index 6fa59d7a2..24812d263 100644 --- a/classes/class_projectsettings.rst +++ b/classes/class_projectsettings.rst @@ -4689,7 +4689,7 @@ Saves the configuration to the ``project.godot`` file. - :ref:`Error` **save_custom** **(** :ref:`String` file **)** -Saves the configuration to a custom file. +Saves the configuration to a custom file. The file extension must be ``.godot`` (to save in text-based :ref:`ConfigFile` format) or ``.binary`` (to save in binary format). ---- diff --git a/classes/class_viewport.rst b/classes/class_viewport.rst index 840e6a886..21aeba6f5 100644 --- a/classes/class_viewport.rst +++ b/classes/class_viewport.rst @@ -534,6 +534,8 @@ If ``true``, the GUI controls on the viewport will lay pixel perfectly. If ``true``, the viewport rendering will receive benefits from High Dynamic Range algorithm. High Dynamic Range allows the viewport to receive values that are outside the 0-1 range. In Godot HDR uses 16 bits, meaning it does not store the full range of a floating point number. +**Note:** Requires :ref:`usage` to be set to :ref:`USAGE_3D` or :ref:`USAGE_3D_NO_EFFECTS`, since HDR is not supported for 2D. + ---- .. _class_Viewport_property_keep_3d_linear: diff --git a/classes/class_webrtcpeerconnection.rst b/classes/class_webrtcpeerconnection.rst index c059bd15c..5e89cfd4c 100644 --- a/classes/class_webrtcpeerconnection.rst +++ b/classes/class_webrtcpeerconnection.rst @@ -215,7 +215,7 @@ Call this method frequently (e.g. in :ref:`Node._process`. -If ``type`` is ``answer`` the peer will start emitting :ref:`ice_candidate_created`. +After calling this function the peer will start emitting :ref:`ice_candidate_created` (unless an :ref:`Error` different from :ref:`@GlobalScope.OK` is returned). ----