diff --git a/classes/class_bakedlightmap.rst b/classes/class_bakedlightmap.rst index 47872e189..448c015db 100644 --- a/classes/class_bakedlightmap.rst +++ b/classes/class_bakedlightmap.rst @@ -19,27 +19,29 @@ Prerendered indirect light map for a scene. Properties ---------- -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`float` | :ref:`bake_cell_size` | 0.25 | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`float` | :ref:`bake_energy` | 1.0 | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`Vector3` | :ref:`bake_extents` | Vector3( 10, 10, 10 ) | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`bool` | :ref:`bake_hdr` | false | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`BakeMode` | :ref:`bake_mode` | 0 | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`float` | :ref:`bake_propagation` | 1.0 | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`BakeQuality` | :ref:`bake_quality` | 1 | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`float` | :ref:`capture_cell_size` | 0.5 | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`String` | :ref:`image_path` | "." | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ -| :ref:`BakedLightmapData` | :ref:`light_data` | null | -+----------------------------------------------------+--------------------------------------------------------------------------+-----------------------+ ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`float` | :ref:`bake_cell_size` | 0.25 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`float` | :ref:`bake_default_texels_per_unit` | 20.0 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`float` | :ref:`bake_energy` | 1.0 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`Vector3` | :ref:`bake_extents` | Vector3( 10, 10, 10 ) | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`bool` | :ref:`bake_hdr` | false | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`BakeMode` | :ref:`bake_mode` | 0 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`float` | :ref:`bake_propagation` | 1.0 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`BakeQuality` | :ref:`bake_quality` | 1 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`float` | :ref:`capture_cell_size` | 0.5 | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`String` | :ref:`image_path` | "." | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ +| :ref:`BakedLightmapData` | :ref:`light_data` | null | ++----------------------------------------------------+------------------------------------------------------------------------------------------------+-----------------------+ Methods ------- @@ -132,6 +134,18 @@ Property Descriptions Grid subdivision size for lightmapper calculation. The default value will work for most cases. Increase for better lighting on small details or if your scene is very large. +.. _class_BakedLightmap_property_bake_default_texels_per_unit: + +- :ref:`float` **bake_default_texels_per_unit** + ++-----------+-----------------------------------------+ +| *Default* | 20.0 | ++-----------+-----------------------------------------+ +| *Setter* | set_bake_default_texels_per_unit(value) | ++-----------+-----------------------------------------+ +| *Getter* | get_bake_default_texels_per_unit() | ++-----------+-----------------------------------------+ + .. _class_BakedLightmap_property_bake_energy: - :ref:`float` **bake_energy** diff --git a/classes/class_editorsettings.rst b/classes/class_editorsettings.rst index bcbfc9cda..e4cf21835 100644 --- a/classes/class_editorsettings.rst +++ b/classes/class_editorsettings.rst @@ -60,6 +60,15 @@ Signals - **settings_changed** **(** **)** +Emitted when editor settings change. + +Constants +--------- + +.. _class_EditorSettings_constant_NOTIFICATION_EDITOR_SETTINGS_CHANGED: + +- **NOTIFICATION_EDITOR_SETTINGS_CHANGED** = **10000** --- Emitted when editor settings change. It used by various editor plugins to update their visuals on theme changes or logic on configuration changes. + Description ----------- diff --git a/classes/class_spatial.rst b/classes/class_spatial.rst index dd95fb93e..bf11f89c4 100644 --- a/classes/class_spatial.rst +++ b/classes/class_spatial.rst @@ -448,6 +448,8 @@ Transforms ``global_point`` from world space to this node's local space. Changes the node's position by given offset :ref:`Vector3`. +Note that the translation ``offset`` is affected by the node's scale, so if scaled by e.g. ``(10, 1, 1)``, a translation by an offset of ``(2, 0, 0)`` would actually add 20 (``2 * 10``) to the X coordinate. + .. _class_Spatial_method_translate_object_local: - void **translate_object_local** **(** :ref:`Vector3` offset **)** diff --git a/classes/class_string.rst b/classes/class_string.rst index bbf09a7c5..c38e8a292 100644 --- a/classes/class_string.rst +++ b/classes/class_string.rst @@ -178,6 +178,10 @@ Methods +-----------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`rstrip` **(** :ref:`String` chars **)** | +-----------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`PoolByteArray` | :ref:`sha1_buffer` **(** **)** | ++-----------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`String` | :ref:`sha1_text` **(** **)** | ++-----------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PoolByteArray` | :ref:`sha256_buffer` **(** **)** | +-----------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`sha256_text` **(** **)** | @@ -666,6 +670,18 @@ For example, ``"One,Two,Three,Four"`` will return ``["Three","Four"]`` if split Returns a copy of the string with characters removed from the right. +.. _class_String_method_sha1_buffer: + +- :ref:`PoolByteArray` **sha1_buffer** **(** **)** + +Returns the SHA-1 hash of the string as an array of bytes. + +.. _class_String_method_sha1_text: + +- :ref:`String` **sha1_text** **(** **)** + +Returns the SHA-1 hash of the string as a string. + .. _class_String_method_sha256_buffer: - :ref:`PoolByteArray` **sha256_buffer** **(** **)** diff --git a/classes/class_tcp_server.rst b/classes/class_tcp_server.rst index abf86cf01..897d52eb3 100644 --- a/classes/class_tcp_server.rst +++ b/classes/class_tcp_server.rst @@ -22,6 +22,8 @@ Methods +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_connection_available` **(** **)** const | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ +| :ref:`bool` | :ref:`is_listening` **(** **)** const | ++-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`listen` **(** :ref:`int` port, :ref:`String` bind_address="*" **)** | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`stop` **(** **)** | @@ -43,6 +45,12 @@ Method Descriptions Returns ``true`` if a connection is available for taking. +.. _class_TCP_Server_method_is_listening: + +- :ref:`bool` **is_listening** **(** **)** const + +Returns ``true`` if the server is currently listening for connections. + .. _class_TCP_Server_method_listen: - :ref:`Error` **listen** **(** :ref:`int` port, :ref:`String` bind_address="*" **)** diff --git a/classes/class_tilemap.rst b/classes/class_tilemap.rst index d1dcc9ed7..b3fde7dc9 100644 --- a/classes/class_tilemap.rst +++ b/classes/class_tilemap.rst @@ -34,6 +34,8 @@ Properties +--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ | :ref:`bool` | :ref:`cell_y_sort` | false | +--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ +| :ref:`bool` | :ref:`centered_textures` | false | ++--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ | :ref:`float` | :ref:`collision_bounce` | 0.0 | +--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ | :ref:`float` | :ref:`collision_friction` | 1.0 | @@ -46,6 +48,8 @@ Properties +--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ | :ref:`bool` | :ref:`collision_use_parent` | false | +--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ +| :ref:`bool` | :ref:`compatibility_mode` | false | ++--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ | :ref:`Mode` | :ref:`mode` | 0 | +--------------------------------------------+--------------------------------------------------------------------------------+---------------------------------+ | :ref:`int` | :ref:`occluder_light_mask` | 1 | @@ -286,6 +290,22 @@ Position for tile origin. See :ref:`TileOrigin` for pos If ``true``, the TileMap's children will be drawn in order of their Y coordinate. +.. _class_TileMap_property_centered_textures: + +- :ref:`bool` **centered_textures** + ++-----------+--------------------------------+ +| *Default* | false | ++-----------+--------------------------------+ +| *Setter* | set_centered_textures(value) | ++-----------+--------------------------------+ +| *Getter* | is_centered_textures_enabled() | ++-----------+--------------------------------+ + +If ``true``, the textures will be centered in the middle of each tile. This is useful for certain isometric or top-down modes when textures are made larger or smaller than the tiles (e.g. to avoid flickering on tile edges). The offset is still applied, but from the center of the tile. If used, :ref:`compatibility_mode` is ignored. + +If ``false``, the texture position start in the top-left corner unless :ref:`compatibility_mode` is enabled. + .. _class_TileMap_property_collision_bounce: - :ref:`float` **collision_bounce** @@ -368,6 +388,24 @@ If ``true``, TileMap collisions will be handled as a kinematic body. If ``false` | *Getter* | get_collision_use_parent() | +-----------+---------------------------------+ +.. _class_TileMap_property_compatibility_mode: + +- :ref:`bool` **compatibility_mode** + ++-----------+---------------------------------+ +| *Default* | false | ++-----------+---------------------------------+ +| *Setter* | set_compatibility_mode(value) | ++-----------+---------------------------------+ +| *Getter* | is_compatibility_mode_enabled() | ++-----------+---------------------------------+ + +If ``true``, the compatibility with the tilemaps made in Godot 3.1 or earlier is maintained (textures move when the tile origin changes and rotate if the texture size is not homogeneous). This mode presents problems when doing ``flip_h``, ``flip_v`` and ``transpose`` tile operations on non-homogeneous isometric tiles (e.g. 2:1), in which the texture could not coincide with the collision, thus it is not recommended for isometric or non-square tiles. + +If ``false``, the textures do not move when doing ``flip_h``, ``flip_v`` operations if no offset is used, nor when changing the tile origin. + +The compatibility mode doesn't work with the :ref:`centered_textures` option, because displacing textures with the :ref:`cell_tile_origin` option or in irregular tiles is not relevant when centering those textures. + .. _class_TileMap_property_mode: - :ref:`Mode` **mode** diff --git a/classes/class_transform.rst b/classes/class_transform.rst index 9d57da16f..e9127ef9e 100644 --- a/classes/class_transform.rst +++ b/classes/class_transform.rst @@ -69,13 +69,13 @@ Constants .. _class_Transform_constant_FLIP_Z: -- **IDENTITY** = **Transform( 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0 )** +- **IDENTITY** = **Transform( 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0 )** --- ``Transform`` with no translation, rotation or scaling applied. When applied to other data structures, :ref:`IDENTITY` performs no transformation. -- **FLIP_X** = **Transform( -1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0 )** +- **FLIP_X** = **Transform( -1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0 )** --- ``Transform`` with mirroring applied perpendicular to the YZ plane. -- **FLIP_Y** = **Transform( 1, 0, 0, 0, -1, 0, 0, 0, 1, 0, 0, 0 )** +- **FLIP_Y** = **Transform( 1, 0, 0, 0, -1, 0, 0, 0, 1, 0, 0, 0 )** --- ``Transform`` with mirroring applied perpendicular to the XZ plane. -- **FLIP_Z** = **Transform( 1, 0, 0, 0, 1, 0, 0, 0, -1, 0, 0, 0 )** +- **FLIP_Z** = **Transform( 1, 0, 0, 0, 1, 0, 0, 0, -1, 0, 0, 0 )** --- ``Transform`` with mirroring applied perpendicular to the XY plane. Description ----------- diff --git a/classes/class_transform2d.rst b/classes/class_transform2d.rst index 1fc6d9368..fff077d42 100644 --- a/classes/class_transform2d.rst +++ b/classes/class_transform2d.rst @@ -73,11 +73,11 @@ Constants .. _class_Transform2D_constant_FLIP_Y: -- **IDENTITY** = **Transform2D( 1, 0, 0, 1, 0, 0 )** +- **IDENTITY** = **Transform2D( 1, 0, 0, 1, 0, 0 )** --- ``Transform2D`` with no translation, rotation or scaling applied. When applied to other data structures, :ref:`IDENTITY` performs no transformation. -- **FLIP_X** = **Transform2D( -1, 0, 0, 1, 0, 0 )** +- **FLIP_X** = **Transform2D( -1, 0, 0, 1, 0, 0 )** --- ``Transform2D`` with mirroring applied parallel to the X axis. -- **FLIP_Y** = **Transform2D( 1, 0, 0, -1, 0, 0 )** +- **FLIP_Y** = **Transform2D( 1, 0, 0, -1, 0, 0 )** --- ``Transform2D`` with mirroring applied parallel to the Y axis. Description ----------- diff --git a/classes/class_websocketclient.rst b/classes/class_websocketclient.rst index 2bd40ea95..adfd2bcc5 100644 --- a/classes/class_websocketclient.rst +++ b/classes/class_websocketclient.rst @@ -102,7 +102,7 @@ Method Descriptions - :ref:`Error` **connect_to_url** **(** :ref:`String` url, :ref:`PoolStringArray` protocols=PoolStringArray( ), :ref:`bool` gd_mp_api=false **)** -Connects to the given URL requesting one of the given ``protocols`` as sub-protocol. +Connects to the given URL requesting one of the given ``protocols`` as sub-protocol. If the list empty (default), no sub-protocol will be requested. If ``true`` is passed as ``gd_mp_api``, the client will behave like a network peer for the :ref:`MultiplayerAPI`, connections to non-Godot servers will not work, and :ref:`data_received` will not be emitted. diff --git a/classes/class_websocketserver.rst b/classes/class_websocketserver.rst index e5243864d..6b1367c5f 100644 --- a/classes/class_websocketserver.rst +++ b/classes/class_websocketserver.rst @@ -112,7 +112,7 @@ Returns ``true`` if the server is actively listening on a port. Starts listening on the given port. -You can specify the desired subprotocols via the "protocols" array. If the list empty (default), "binary" will be used. +You can specify the desired subprotocols via the "protocols" array. If the list empty (default), no sub-protocol will be requested. If ``true`` is passed as ``gd_mp_api``, the server will behave like a network peer for the :ref:`MultiplayerAPI`, connections from non-Godot clients will not work, and :ref:`data_received` will not be emitted.