Skip to content

Commit

Permalink
Re-extracted class docs.
Browse files Browse the repository at this point in the history
  • Loading branch information
Relintai committed Mar 10, 2024
1 parent 0e32e11 commit fb99db4
Show file tree
Hide file tree
Showing 10 changed files with 50 additions and 36 deletions.
8 changes: 5 additions & 3 deletions modules/layered_tile_map/doc_classes/LayeredTileData.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileData" inherits="Object" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileData" inherits="Object" version="4.3">
<brief_description>
Settings for a single tile in a [LayeredTileSet].
</brief_description>
Expand Down Expand Up @@ -214,7 +214,7 @@
<member name="material" type="Material" setter="set_material" getter="get_material">
The [Material] to use for this [LayeredTileData]. This can be a [CanvasItemMaterial] to use the default shader, or a [ShaderMaterial] to use a custom shader.
</member>
<member name="modulate" type="Color" setter="set_modulate" getter="get_modulate" default="Color(1, 1, 1, 1)" keywords="color, colour">
<member name="modulate" type="Color" setter="set_modulate" getter="get_modulate" default="Color( 1, 1, 1, 1 )">
Color modulation of the tile.
</member>
<member name="probability" type="float" setter="set_probability" getter="get_probability" default="1.0">
Expand All @@ -226,7 +226,7 @@
<member name="terrain_set" type="int" setter="set_terrain_set" getter="get_terrain_set" default="-1">
ID of the terrain set that the tile uses.
</member>
<member name="texture_origin" type="Vector2i" setter="set_texture_origin" getter="get_texture_origin" default="Vector2i(0, 0)">
<member name="texture_origin" type="Vector2i" setter="set_texture_origin" getter="get_texture_origin" default="Vector2i( 0, 0 )">
Offsets the position of where the tile is drawn.
</member>
<member name="transpose" type="bool" setter="set_transpose" getter="get_transpose" default="false">
Expand All @@ -246,4 +246,6 @@
</description>
</signal>
</signals>
<constants>
</constants>
</class>
12 changes: 6 additions & 6 deletions modules/layered_tile_map/doc_classes/LayeredTileMap.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileMap" inherits="LayeredTileMapLayerGroup" keywords="gridmap" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileMap" inherits="LayeredTileMapLayerGroup" version="4.3">
<brief_description>
Node for 2D tile-based maps.
</brief_description>
Expand Down Expand Up @@ -76,7 +76,7 @@
Clears cells that do not exist in the tileset.
</description>
</method>
<method name="force_update" deprecated="Use [method notify_runtime_tile_data_update] and/or [method update_internals] instead.">
<method name="force_update">
<return type="void" />
<argument index="0" name="layer" type="int" default="-1" />
<description>
Expand Down Expand Up @@ -196,7 +196,7 @@
Returns the number of layers in the LayeredTileMap.
</description>
</method>
<method name="get_navigation_map" qualifiers="const" deprecated="Use [method get_layer_navigation_map] instead.">
<method name="get_navigation_map" qualifiers="const">
<return type="RID" />
<argument index="0" name="layer" type="int" />
<description>
Expand Down Expand Up @@ -239,7 +239,7 @@
<return type="PoolVector2iArray" />
<argument index="0" name="layer" type="int" />
<argument index="1" name="source_id" type="int" default="-1" />
<argument index="2" name="atlas_coords" type="Vector2i" default="Vector2i(-1, -1)" />
<argument index="2" name="atlas_coords" type="Vector2i" default="Vector2i( -1, -1 )" />
<argument index="3" name="alternative_tile" type="int" default="-1" />
<description>
Returns a [Vector2i] array with the positions of all cells containing a tile in the given layer. Tiles may be filtered according to their source ([param source_id]), their atlas coordinates ([param atlas_coords]) or alternative id ([param alternative_tile]).
Expand Down Expand Up @@ -331,7 +331,7 @@
<argument index="0" name="layer" type="int" />
<argument index="1" name="coords" type="Vector2i" />
<argument index="2" name="source_id" type="int" default="-1" />
<argument index="3" name="atlas_coords" type="Vector2i" default="Vector2i(-1, -1)" />
<argument index="3" name="atlas_coords" type="Vector2i" default="Vector2i( -1, -1 )" />
<argument index="4" name="alternative_tile" type="int" default="0" />
<description>
Sets the tile identifiers for the cell on layer [param layer] at coordinates [param coords]. Each tile of the [LayeredTileSet] is identified using three parts:
Expand Down Expand Up @@ -445,7 +445,7 @@
If [param layer] is negative, the layers are accessed from the last one.
</description>
</method>
<method name="set_navigation_map" deprecated="Use [method set_layer_navigation_map] instead.">
<method name="set_navigation_map">
<return type="void" />
<argument index="0" name="layer" type="int" />
<argument index="1" name="map" type="RID" />
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileMapLayerGroup" inherits="Node2D" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileMapLayerGroup" inherits="YSort" version="4.3">
<brief_description>
Groups a set of tile map layers together, allowing them to share a provided [LayeredTileSet].
</brief_description>
Expand All @@ -9,9 +9,13 @@
</description>
<tutorials>
</tutorials>
<methods>
</methods>
<members>
<member name="tile_set" type="LayeredTileSet" setter="set_tileset" getter="get_tileset">
The assigned [LayeredTileSet]. This LayeredTileSet will be applied to all child layers.
</member>
</members>
<constants>
</constants>
</class>
18 changes: 10 additions & 8 deletions modules/layered_tile_map/doc_classes/LayeredTileMapPattern.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileMapPattern" inherits="Resource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileMapPattern" inherits="Resource" version="4.3">
<brief_description>
Holds a pattern to be copied from or pasted into [LayeredTileMap]s.
</brief_description>
Expand All @@ -10,6 +10,12 @@
<tutorials>
</tutorials>
<methods>
<method name="empty" qualifiers="const">
<return type="bool" />
<description>
Returns whether the pattern is empty or not.
</description>
</method>
<method name="get_cell_alternative_tile" qualifiers="const">
<return type="int" />
<argument index="0" name="coords" type="Vector2i" />
Expand Down Expand Up @@ -50,12 +56,6 @@
Returns whether the pattern has a tile at the given coordinates.
</description>
</method>
<method name="empty" qualifiers="const">
<return type="bool" />
<description>
Returns whether the pattern is empty or not.
</description>
</method>
<method name="remove_cell">
<return type="void" />
<argument index="0" name="coords" type="Vector2i" />
Expand All @@ -68,7 +68,7 @@
<return type="void" />
<argument index="0" name="coords" type="Vector2i" />
<argument index="1" name="source_id" type="int" default="-1" />
<argument index="2" name="atlas_coords" type="Vector2i" default="Vector2i(-1, -1)" />
<argument index="2" name="atlas_coords" type="Vector2i" default="Vector2i( -1, -1 )" />
<argument index="3" name="alternative_tile" type="int" default="-1" />
<description>
Sets the tile identifiers for the cell at coordinates [param coords]. See [method LayeredTileMap.set_cell].
Expand All @@ -82,4 +82,6 @@
</description>
</method>
</methods>
<constants>
</constants>
</class>
8 changes: 4 additions & 4 deletions modules/layered_tile_map/doc_classes/LayeredTileSet.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileSet" inherits="Resource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileSet" inherits="Resource" version="4.3">
<brief_description>
Tile library for tilemaps.
</brief_description>
Expand Down Expand Up @@ -612,16 +612,16 @@
</method>
</methods>
<members>
<member name="tile_layout" type="int" setter="set_tile_layout" getter="get_tile_layout" enum="LayeredTileSet.TileLayout" default="0">
<member name="tile_layout" type="int" setter="set_tile_layout" getter="get_tile_layout" enum="LayeredTileSet.TileLayout">
For all half-offset shapes (Isometric, Hexagonal and Half-Offset square), changes the way tiles are indexed in the LayeredTileMap grid.
</member>
<member name="tile_offset_axis" type="int" setter="set_tile_offset_axis" getter="get_tile_offset_axis" enum="LayeredTileSet.TileOffsetAxis" default="0">
<member name="tile_offset_axis" type="int" setter="set_tile_offset_axis" getter="get_tile_offset_axis" enum="LayeredTileSet.TileOffsetAxis">
For all half-offset shapes (Isometric, Hexagonal and Half-Offset square), determines the offset axis.
</member>
<member name="tile_shape" type="int" setter="set_tile_shape" getter="get_tile_shape" enum="LayeredTileSet.TileShape" default="0">
The tile shape.
</member>
<member name="tile_size" type="Vector2i" setter="set_tile_size" getter="get_tile_size" default="Vector2i(16, 16)">
<member name="tile_size" type="Vector2i" setter="set_tile_size" getter="get_tile_size" default="Vector2i( 16, 16 )">
The tile size, in pixels. For all tile shapes, this size corresponds to the encompassing rectangle of the tile shape. This is thus the minimal cell size required in an atlas.
</member>
<member name="uv_clipping" type="bool" setter="set_uv_clipping" getter="is_uv_clipping" default="false">
Expand Down
18 changes: 10 additions & 8 deletions modules/layered_tile_map/doc_classes/LayeredTileSetAtlasSource.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileSetAtlasSource" inherits="LayeredTileSetSource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileSetAtlasSource" inherits="LayeredTileSetSource" version="4.3">
<brief_description>
Exposes a 2D atlas texture as a set of tiles for a [LayeredTileSet] resource.
</brief_description>
Expand Down Expand Up @@ -31,7 +31,7 @@
<method name="create_tile">
<return type="void" />
<argument index="0" name="atlas_coords" type="Vector2i" />
<argument index="1" name="size" type="Vector2i" default="Vector2i(1, 1)" />
<argument index="1" name="size" type="Vector2i" default="Vector2i( 1, 1 )" />
<description>
Creates a new tile at coordinates [param atlas_coords] with the given [param size].
</description>
Expand Down Expand Up @@ -161,7 +161,7 @@
<argument index="2" name="animation_columns" type="int" />
<argument index="3" name="animation_separation" type="Vector2i" />
<argument index="4" name="frames_count" type="int" />
<argument index="5" name="ignored_tile" type="Vector2i" default="Vector2i(-1, -1)" />
<argument index="5" name="ignored_tile" type="Vector2i" default="Vector2i( -1, -1 )" />
<description>
Returns whether there is enough room in an atlas to create/modify a tile with the given properties. If [param ignored_tile] is provided, act as is the given tile was not present in the atlas. This may be used when you want to modify a tile's properties.
</description>
Expand All @@ -175,8 +175,8 @@
<method name="move_tile_in_atlas">
<return type="void" />
<argument index="0" name="atlas_coords" type="Vector2i" />
<argument index="1" name="new_atlas_coords" type="Vector2i" default="Vector2i(-1, -1)" />
<argument index="2" name="new_size" type="Vector2i" default="Vector2i(-1, -1)" />
<argument index="1" name="new_atlas_coords" type="Vector2i" default="Vector2i( -1, -1 )" />
<argument index="2" name="new_size" type="Vector2i" default="Vector2i( -1, -1 )" />
<description>
Move the tile and its alternatives at the [param atlas_coords] coordinates to the [param new_atlas_coords] coordinates with the [param new_size] size. This functions will fail if a tile is already present in the given area.
If [param new_atlas_coords] is [code]Vector2i(-1, -1)[/code], keeps the tile's coordinates. If [param new_size] is [code]Vector2i(-1, -1)[/code], keeps the tile's size.
Expand Down Expand Up @@ -260,16 +260,18 @@
</method>
</methods>
<members>
<member name="margins" type="Vector2i" setter="set_margins" getter="get_margins" default="Vector2i(0, 0)">
<member name="margins" type="Vector2i" setter="set_margins" getter="get_margins" default="Vector2i( 0, 0 )">
Margins, in pixels, to offset the origin of the grid in the texture.
</member>
<member name="separation" type="Vector2i" setter="set_separation" getter="get_separation" default="Vector2i(0, 0)">
<member name="normal_texture" type="Texture" setter="set_normal_texture" getter="get_normal_texture">
</member>
<member name="separation" type="Vector2i" setter="set_separation" getter="get_separation" default="Vector2i( 0, 0 )">
Separation, in pixels, between each tile texture region of the grid.
</member>
<member name="texture" type="Texture" setter="set_texture" getter="get_texture">
The atlas texture.
</member>
<member name="texture_region_size" type="Vector2i" setter="set_texture_region_size" getter="get_texture_region_size" default="Vector2i(16, 16)">
<member name="texture_region_size" type="Vector2i" setter="set_texture_region_size" getter="get_texture_region_size" default="Vector2i( 16, 16 )">
The base tile size in the texture (in pixel). This size must be bigger than the LayeredTileSet's [code]tile_size[/code] value.
</member>
<member name="use_texture_padding" type="bool" setter="set_use_texture_padding" getter="get_use_texture_padding" default="true">
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileSetScenesCollectionSource" inherits="LayeredTileSetSource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileSetScenesCollectionSource" inherits="LayeredTileSetSource" version="4.3">
<brief_description>
Exposes a set of scenes as tiles for a [LayeredTileSet] resource.
</brief_description>
Expand Down Expand Up @@ -91,4 +91,6 @@
</description>
</method>
</methods>
<constants>
</constants>
</class>
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="LayeredTileSetSource" inherits="Resource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="LayeredTileSetSource" inherits="Resource" version="4.3">
<brief_description>
Exposes a set of tiles for a [LayeredTileSet] resource.
</brief_description>
Expand Down Expand Up @@ -59,4 +59,6 @@
</description>
</method>
</methods>
<constants>
</constants>
</class>
6 changes: 3 additions & 3 deletions modules/web/doc_classes/FileCache.xml
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@
<description>
Returns the absolute path to a file if it exists in the given [member wwwroot]. If it doesn't exists returns an empty [String].
Guards against directory traversal.
Note: file path should be the url you want to access the file with, including lead slash. e.g. http://127.0.0.1/a/b/d.jpg -> /a/b/d.jpg
Note: file path should be the url you want to access the file with, including lead slash. e.g. http://127.0.0.1/a/b/d.jpg -&gt; /a/b/d.jpg
</description>
</method>
<method name="wwwroot_get_simplified_abs_path">
Expand All @@ -61,7 +61,7 @@
<description>
Returns the absolute path to a file in the given [member wwwroot]. Does not checks if the file exists or not. Returns an empty [String] on error.
Guards against directory traversal.
Note: file path should be the url you want to access the file with, including lead slash. e.g. http://127.0.0.1/a/b/d.jpg -> /a/b/d.jpg
Note: file path should be the url you want to access the file with, including lead slash. e.g. http://127.0.0.1/a/b/d.jpg -&gt; /a/b/d.jpg
</description>
</method>
<method name="wwwroot_has_file">
Expand All @@ -70,7 +70,7 @@
<description>
Check whether a file exists in the given [member wwwroot].
Guards against directory traversal.
Note: file path should be the url you want to access the file with, including lead slash. e.g. http://127.0.0.1/a/b/d.jpg -> /a/b/d.jpg
Note: file path should be the url you want to access the file with, including lead slash. e.g. http://127.0.0.1/a/b/d.jpg -&gt; /a/b/d.jpg
</description>
</method>
</methods>
Expand Down
2 changes: 1 addition & 1 deletion modules/web/doc_classes/ListWebPage.xml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@
<member name="max_visible_navigation_links" type="int" setter="set_max_visible_navigation_links" getter="get_max_visible_navigation_links" default="6">
This many pagination links will be visible max.
</member>
<member name="paginate" type="bool" setter="set_paginate" getter="get_paginate" default="false">
<member name="paginate" type="bool" setter="set_paginate" getter="get_paginate" default="true">
Whether to allow pagination or not.
</member>
<member name="placeholder_text" type="String" setter="set_placeholder_text" getter="get_placeholder_text" default="&quot;No content yet!&quot;">
Expand Down

0 comments on commit fb99db4

Please sign in to comment.