mirror of
https://github.com/godotengine/godot.git
synced 2024-11-21 03:18:37 +08:00
308 lines
14 KiB
XML
308 lines
14 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="TileData" inherits="Object" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Settings for a single tile in a [TileSet].
|
|
</brief_description>
|
|
<description>
|
|
[TileData] object represents a single tile in a [TileSet]. It is usually edited using the tileset editor, but it can be modified at runtime using [method TileMap._tile_data_runtime_update].
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="add_collision_polygon">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Adds a collision polygon to the tile on the given TileSet physics layer.
|
|
</description>
|
|
</method>
|
|
<method name="add_occluder_polygon">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Adds an occlusion polygon to the tile on the TileSet occlusion layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="get_collision_polygon_one_way_margin" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<description>
|
|
Returns the one-way margin (for one-way platforms) of the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="get_collision_polygon_points" qualifiers="const">
|
|
<return type="PackedVector2Array" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<description>
|
|
Returns the points of the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="get_collision_polygons_count" qualifiers="const">
|
|
<return type="int" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Returns how many polygons the tile has for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="get_constant_angular_velocity" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Returns the constant angular velocity applied to objects colliding with this tile.
|
|
</description>
|
|
</method>
|
|
<method name="get_constant_linear_velocity" qualifiers="const">
|
|
<return type="Vector2" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Returns the constant linear velocity applied to objects colliding with this tile.
|
|
</description>
|
|
</method>
|
|
<method name="get_custom_data" qualifiers="const">
|
|
<return type="Variant" />
|
|
<param index="0" name="layer_name" type="String" />
|
|
<description>
|
|
Returns the custom data value for custom data layer named [param layer_name].
|
|
</description>
|
|
</method>
|
|
<method name="get_custom_data_by_layer_id" qualifiers="const">
|
|
<return type="Variant" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Returns the custom data value for custom data layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="get_navigation_polygon" qualifiers="const">
|
|
<return type="NavigationPolygon" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="flip_h" type="bool" default="false" />
|
|
<param index="2" name="flip_v" type="bool" default="false" />
|
|
<param index="3" name="transpose" type="bool" default="false" />
|
|
<description>
|
|
Returns the navigation polygon of the tile for the TileSet navigation layer with index [param layer_id].
|
|
[param flip_h], [param flip_v], and [param transpose] allow transforming the returned polygon.
|
|
</description>
|
|
</method>
|
|
<method name="get_occluder" qualifiers="const" deprecated="Use [method get_occluder_polygon] instead.">
|
|
<return type="OccluderPolygon2D" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="flip_h" type="bool" default="false" />
|
|
<param index="2" name="flip_v" type="bool" default="false" />
|
|
<param index="3" name="transpose" type="bool" default="false" />
|
|
<description>
|
|
Returns the occluder polygon of the tile for the TileSet occlusion layer with index [param layer_id].
|
|
[param flip_h], [param flip_v], and [param transpose] allow transforming the returned polygon.
|
|
</description>
|
|
</method>
|
|
<method name="get_occluder_polygon" qualifiers="const">
|
|
<return type="OccluderPolygon2D" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<param index="2" name="flip_h" type="bool" default="false" />
|
|
<param index="3" name="flip_v" type="bool" default="false" />
|
|
<param index="4" name="transpose" type="bool" default="false" />
|
|
<description>
|
|
Returns the occluder polygon at index [param polygon_index] from the TileSet occlusion layer with index [param layer_id].
|
|
The [param flip_h], [param flip_v], and [param transpose] parameters can be [code]true[/code] to transform the returned polygon.
|
|
</description>
|
|
</method>
|
|
<method name="get_occluder_polygons_count" qualifiers="const">
|
|
<return type="int" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<description>
|
|
Returns the number of occluder polygons of the tile in the TileSet occlusion layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="get_terrain_peering_bit" qualifiers="const">
|
|
<return type="int" />
|
|
<param index="0" name="peering_bit" type="int" enum="TileSet.CellNeighbor" />
|
|
<description>
|
|
Returns the tile's terrain bit for the given [param peering_bit] direction. To check that a direction is valid, use [method is_valid_terrain_peering_bit].
|
|
</description>
|
|
</method>
|
|
<method name="is_collision_polygon_one_way" qualifiers="const">
|
|
<return type="bool" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<description>
|
|
Returns whether one-way collisions are enabled for the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="is_valid_terrain_peering_bit" qualifiers="const">
|
|
<return type="bool" />
|
|
<param index="0" name="peering_bit" type="int" enum="TileSet.CellNeighbor" />
|
|
<description>
|
|
Returns whether the given [param peering_bit] direction is valid for this tile.
|
|
</description>
|
|
</method>
|
|
<method name="remove_collision_polygon">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<description>
|
|
Removes the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="remove_occluder_polygon">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<description>
|
|
Removes the polygon at index [param polygon_index] for TileSet occlusion layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_collision_polygon_one_way">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<param index="2" name="one_way" type="bool" />
|
|
<description>
|
|
Enables/disables one-way collisions on the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_collision_polygon_one_way_margin">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<param index="2" name="one_way_margin" type="float" />
|
|
<description>
|
|
Sets the one-way margin (for one-way platforms) of the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_collision_polygon_points">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<param index="2" name="polygon" type="PackedVector2Array" />
|
|
<description>
|
|
Sets the points of the polygon at index [param polygon_index] for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_collision_polygons_count">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygons_count" type="int" />
|
|
<description>
|
|
Sets the polygons count for TileSet physics layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_constant_angular_velocity">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="velocity" type="float" />
|
|
<description>
|
|
Sets the constant angular velocity. This does not rotate the tile. This angular velocity is applied to objects colliding with this tile.
|
|
</description>
|
|
</method>
|
|
<method name="set_constant_linear_velocity">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="velocity" type="Vector2" />
|
|
<description>
|
|
Sets the constant linear velocity. This does not move the tile. This linear velocity is applied to objects colliding with this tile. This is useful to create conveyor belts.
|
|
</description>
|
|
</method>
|
|
<method name="set_custom_data">
|
|
<return type="void" />
|
|
<param index="0" name="layer_name" type="String" />
|
|
<param index="1" name="value" type="Variant" />
|
|
<description>
|
|
Sets the tile's custom data value for the TileSet custom data layer with name [param layer_name].
|
|
</description>
|
|
</method>
|
|
<method name="set_custom_data_by_layer_id">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="value" type="Variant" />
|
|
<description>
|
|
Sets the tile's custom data value for the TileSet custom data layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_navigation_polygon">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="navigation_polygon" type="NavigationPolygon" />
|
|
<description>
|
|
Sets the navigation polygon for the TileSet navigation layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_occluder" deprecated="Use [method set_occluder_polygon] instead.">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="occluder_polygon" type="OccluderPolygon2D" />
|
|
<description>
|
|
Sets the occluder for the TileSet occlusion layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_occluder_polygon">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygon_index" type="int" />
|
|
<param index="2" name="polygon" type="OccluderPolygon2D" />
|
|
<description>
|
|
Sets the occluder for polygon with index [param polygon_index] in the TileSet occlusion layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_occluder_polygons_count">
|
|
<return type="void" />
|
|
<param index="0" name="layer_id" type="int" />
|
|
<param index="1" name="polygons_count" type="int" />
|
|
<description>
|
|
Sets the occluder polygon count in the TileSet occlusion layer with index [param layer_id].
|
|
</description>
|
|
</method>
|
|
<method name="set_terrain_peering_bit">
|
|
<return type="void" />
|
|
<param index="0" name="peering_bit" type="int" enum="TileSet.CellNeighbor" />
|
|
<param index="1" name="terrain" type="int" />
|
|
<description>
|
|
Sets the tile's terrain bit for the given [param peering_bit] direction. To check that a direction is valid, use [method is_valid_terrain_peering_bit].
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="flip_h" type="bool" setter="set_flip_h" getter="get_flip_h" default="false">
|
|
If [code]true[/code], the tile will have its texture flipped horizontally.
|
|
</member>
|
|
<member name="flip_v" type="bool" setter="set_flip_v" getter="get_flip_v" default="false">
|
|
If [code]true[/code], the tile will have its texture flipped vertically.
|
|
</member>
|
|
<member name="material" type="Material" setter="set_material" getter="get_material">
|
|
The [Material] to use for this [TileData]. 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">
|
|
Color modulation of the tile.
|
|
</member>
|
|
<member name="probability" type="float" setter="set_probability" getter="get_probability" default="1.0">
|
|
Relative probability of this tile being selected when drawing a pattern of random tiles.
|
|
</member>
|
|
<member name="terrain" type="int" setter="set_terrain" getter="get_terrain" default="-1">
|
|
ID of the terrain from the terrain set that the tile uses.
|
|
</member>
|
|
<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)">
|
|
Offsets the position of where the tile is drawn.
|
|
</member>
|
|
<member name="transpose" type="bool" setter="set_transpose" getter="get_transpose" default="false">
|
|
If [code]true[/code], the tile will display transposed, i.e. with horizontal and vertical texture UVs swapped.
|
|
</member>
|
|
<member name="y_sort_origin" type="int" setter="set_y_sort_origin" getter="get_y_sort_origin" default="0">
|
|
Vertical point of the tile used for determining y-sorted order.
|
|
</member>
|
|
<member name="z_index" type="int" setter="set_z_index" getter="get_z_index" default="0">
|
|
Ordering index of this tile, relative to [TileMap].
|
|
</member>
|
|
</members>
|
|
<signals>
|
|
<signal name="changed">
|
|
<description>
|
|
Emitted when any of the properties are changed.
|
|
</description>
|
|
</signal>
|
|
</signals>
|
|
</class>
|