TileSet

Inherits: Resource < Reference < Object

Biblioteca de tile para tilemaps.

Descripción

Un TileSet es una biblioteca de tiles para un TileMap. Contiene una lista de tiles, cada uno de los cuales consiste en un sprite y formas de colisión opcionales.

Los tiles están referenciados por un ID entero único.

Tutoriales

Métodos

Vector2

_forward_atlas_subtile_selection ( int atlastile_id, Object tilemap, Vector2 tile_location ) virtual

Vector2

_forward_subtile_selection ( int autotile_id, int bitmask, Object tilemap, Vector2 tile_location ) virtual

bool

_is_tile_bound ( int drawn_id, int neighbor_id ) virtual

void

autotile_clear_bitmask_map ( int id )

int

autotile_get_bitmask ( int id, Vector2 coord )

BitmaskMode

autotile_get_bitmask_mode ( int id ) const

Vector2

autotile_get_icon_coordinate ( int id ) const

OccluderPolygon2D

autotile_get_light_occluder ( int id, Vector2 coord ) const

NavigationPolygon

autotile_get_navigation_polygon ( int id, Vector2 coord ) const

Vector2

autotile_get_size ( int id ) const

int

autotile_get_spacing ( int id ) const

int

autotile_get_subtile_priority ( int id, Vector2 coord )

int

autotile_get_z_index ( int id, Vector2 coord )

void

autotile_set_bitmask ( int id, Vector2 bitmask, int flag )

void

autotile_set_bitmask_mode ( int id, BitmaskMode mode )

void

autotile_set_icon_coordinate ( int id, Vector2 coord )

void

autotile_set_light_occluder ( int id, OccluderPolygon2D light_occluder, Vector2 coord )

void

autotile_set_navigation_polygon ( int id, NavigationPolygon navigation_polygon, Vector2 coord )

void

autotile_set_size ( int id, Vector2 size )

void

autotile_set_spacing ( int id, int spacing )

void

autotile_set_subtile_priority ( int id, Vector2 coord, int priority )

void

autotile_set_z_index ( int id, Vector2 coord, int z_index )

void

clear ( )

void

create_tile ( int id )

int

find_tile_by_name ( String name ) const

int

get_last_unused_tile_id ( ) const

Array

get_tiles_ids ( ) const

void

remove_tile ( int id )

void

tile_add_shape ( int id, Shape2D shape, Transform2D shape_transform, bool one_way=false, Vector2 autotile_coord=Vector2( 0, 0 ) )

OccluderPolygon2D

tile_get_light_occluder ( int id ) const

ShaderMaterial

tile_get_material ( int id ) const

Color

tile_get_modulate ( int id ) const

String

tile_get_name ( int id ) const

NavigationPolygon

tile_get_navigation_polygon ( int id ) const

Vector2

tile_get_navigation_polygon_offset ( int id ) const

Texture

tile_get_normal_map ( int id ) const

Vector2

tile_get_occluder_offset ( int id ) const

Rect2

tile_get_region ( int id ) const

Shape2D

tile_get_shape ( int id, int shape_id ) const

int

tile_get_shape_count ( int id ) const

Vector2

tile_get_shape_offset ( int id, int shape_id ) const

bool

tile_get_shape_one_way ( int id, int shape_id ) const

float

tile_get_shape_one_way_margin ( int id, int shape_id ) const

Transform2D

tile_get_shape_transform ( int id, int shape_id ) const

Array

tile_get_shapes ( int id ) const

Texture

tile_get_texture ( int id ) const

Vector2

tile_get_texture_offset ( int id ) const

TileMode

tile_get_tile_mode ( int id ) const

int

tile_get_z_index ( int id ) const

void

tile_set_light_occluder ( int id, OccluderPolygon2D light_occluder )

void

tile_set_material ( int id, ShaderMaterial material )

void

tile_set_modulate ( int id, Color color )

void

tile_set_name ( int id, String name )

void

tile_set_navigation_polygon ( int id, NavigationPolygon navigation_polygon )

void

tile_set_navigation_polygon_offset ( int id, Vector2 navigation_polygon_offset )

void

tile_set_normal_map ( int id, Texture normal_map )

void

tile_set_occluder_offset ( int id, Vector2 occluder_offset )

void

tile_set_region ( int id, Rect2 region )

void

tile_set_shape ( int id, int shape_id, Shape2D shape )

void

tile_set_shape_offset ( int id, int shape_id, Vector2 shape_offset )

void

tile_set_shape_one_way ( int id, int shape_id, bool one_way )

void

tile_set_shape_one_way_margin ( int id, int shape_id, float one_way )

void

tile_set_shape_transform ( int id, int shape_id, Transform2D shape_transform )

void

tile_set_shapes ( int id, Array shapes )

void

tile_set_texture ( int id, Texture texture )

void

tile_set_texture_offset ( int id, Vector2 texture_offset )

void

tile_set_tile_mode ( int id, TileMode tilemode )

void

tile_set_z_index ( int id, int z_index )

Enumeraciones

enum BitmaskMode:

  • BITMASK_2X2 = 0

  • BITMASK_3X3_MINIMAL = 1

  • BITMASK_3X3 = 2


enum AutotileBindings:

  • BIND_TOPLEFT = 1

  • BIND_TOP = 2

  • BIND_TOPRIGHT = 4

  • BIND_LEFT = 8

  • BIND_CENTER = 16

  • BIND_RIGHT = 32

  • BIND_BOTTOMLEFT = 64

  • BIND_BOTTOM = 128

  • BIND_BOTTOMRIGHT = 256


enum TileMode:

  • SINGLE_TILE = 0

  • AUTO_TILE = 1

  • ATLAS_TILE = 2

Descripciones de Métodos



  • bool _is_tile_bound ( int drawn_id, int neighbor_id ) virtual

Determina cuando el auto-tiler debe considerar que dos diferentes identificaciones de auto-tiler están unidas.

Nota: neighbor_id será -1 (TileMap.INVALID_CELL) al comparar una tile con una tile vecina vacía.


  • void autotile_clear_bitmask_map ( int id )

Borra toda la información de la máscara de bits del autotile.


Devuelve la máscara de bits del subtiles de un autotile dado sus coordenadas.

El valor es la suma de los valores de AutotileBindings presentes en el subtile (por ejemplo, un valor de 5 significa que la máscara de bits tiene enlaces tanto en la parte superior izquierda como en la superior derecha).


Devuelve el BitmaskMode del autotile.


  • Vector2 autotile_get_icon_coordinate ( int id ) const

Devuelve el subtile que se está usando como icono en un atlas/autotile dadas sus coordenadas.

La subtile definida como el icono será utilizada como una alternativa cuando la información de la máscara de bits del atlas/autotile esté incompleta. También se usará para representarla en el editor de TileSet.


Devuelve el oclusor de luz del subtile de un atlas/autotile dadas sus coordenadas.


Devuelve el polígono de navegación del subsuelo de un atlas/autotile dadas sus coordenadas.


Devuelve el tamaño de los subtiles en un atlas/autotile.


  • int autotile_get_spacing ( int id ) const

Devuelve el espacio entre los subtiles del atlas/autotile.


Devuelve la prioridad del subtile de un autotile dado sus coordenadas.

Cuando más de un subtile tiene el mismo valor de máscara de bits, uno de ellos será elegido al azar para dibujar. Su prioridad definirá la frecuencia con la que se elegirá.


Devuelve el índice de dibujo del subtile de un atlas/autotile dadas sus coordenadas.


  • void autotile_set_bitmask ( int id, Vector2 bitmask, int flag )

Establece la máscara de bits del subtile de un autotile dado sus coordenadas.

El valor es la suma de los valores de AutotileBindings presentes en el subtile (por ejemplo, un valor de 5 significa que la máscara de bits tiene enlaces tanto en la parte superior izquierda como en la superior derecha).


Establece el BitmaskMode del autotile.


  • void autotile_set_icon_coordinate ( int id, Vector2 coord )

Establece el subtile que se usará como icono en un atlas/autotile dadas sus coordenadas.

La subtile definida como el icono será utilizada como una alternativa cuando la información de la máscara de bits del atlas/autotile esté incompleta. También se usará para representarla en el editor de TileSet.


Establece el oclusor de luz del subtile desde un atlas/autotile dado sus coordenadas.


Establece el polígono de navegación del sutile a partir de un atlas/autotile dadas sus coordenadas.


Establece el tamaño de los subtiles en un atlas/autotile.


  • void autotile_set_spacing ( int id, int spacing )

Establece el espacio entre los subtiles del atlas/autotile.


  • void autotile_set_subtile_priority ( int id, Vector2 coord, int priority )

Establece la prioridad del sutil de un autotile dado sus coordenadas.

Cuando más de un subtile tiene el mismo valor de máscara de bits, uno de ellos será elegido al azar para dibujar. Su prioridad definirá la frecuencia con la que se elegirá.


  • void autotile_set_z_index ( int id, Vector2 coord, int z_index )

Establece el índice de dibujo del sutile a partir de un atlas/autotile dadas sus coordenadas.


  • void clear ( )

Limpia todos los tiles.


  • void create_tile ( int id )

Crea un nuevo tile con la identificación dada.


  • int find_tile_by_name ( String name ) const

Devuelve el primer tile que coincida con el nombre dado.


  • int get_last_unused_tile_id ( ) const

Devuelve la identificación que sigue a la última identificación usada actualmente, útil cuando se crea un nuevo tile.


  • Array get_tiles_ids ( ) const

Devuelve un array de todas las identificaciones de tiles usadas actualmente.


  • void remove_tile ( int id )

Quita la identificación del tile dado.


Añade una forma al tile.


Devuelve el oclusor de luz del tile.


Devuelve el material del tile.


  • Color tile_get_modulate ( int id ) const

Devuelve el color de modulación del tile.


Devuelve el nombre del tile.


Devuelve el polígono de navegación del tile.


  • Vector2 tile_get_navigation_polygon_offset ( int id ) const

Devuelve el desplazamiento del polígono de navegación del tile.


Devuelve la textura normal del mapa del tile.


  • Vector2 tile_get_occluder_offset ( int id ) const

Devuelve el desplazamiento del oclusor de luz del tile.


  • Rect2 tile_get_region ( int id ) const

Devuelve la sub-región del tile en la textura.


Devuelve un tile con una forma determinada.


  • int tile_get_shape_count ( int id ) const

Devuelve el número de formas asignadas a un tile.


Devuelve el desplazamiento de la forma de un tile.


  • bool tile_get_shape_one_way ( int id, int shape_id ) const

Devuelve el valor de la colisión en un sentido de la forma de un tile.


  • float tile_get_shape_one_way_margin ( int id, int shape_id ) const


Devuelve la Transform2D de la forma de un tile.


  • Array tile_get_shapes ( int id ) const

Devuelve una serie de diccionarios que describen las formas de los tiles.

Estructura del diccionario en el array devuelto por este método:

{
    "autotile_coord": Vector 2,
    "one_way": bool,
    "one_way_margin": int,
    "shape": CollisionShape2D,
    "shape_transform": Transform2D,
}

Devuelve la textura del tile.


  • Vector2 tile_get_texture_offset ( int id ) const

Devuelve el desplazamiento de la textura del tile.


Devuelve el TileMode del tile.


  • int tile_get_z_index ( int id ) const

Devuelve el índice Z del tile (capa de dibujo).


Establece un oclusor ligero para el tile.


Establece el material del tile.


  • void tile_set_modulate ( int id, Color color )

Establece el color de modulación del tile.


Establece el nombre del tile.


Establece el polígono de navegación del tile.


  • void tile_set_navigation_polygon_offset ( int id, Vector2 navigation_polygon_offset )

Establece un desplazamiento del polígono de navegación del tile.


  • void tile_set_normal_map ( int id, Texture normal_map )

Establece la textura normal del mapa del tile.

Nota: Godot espera que el mapa normal use las coordenadas X+, Y-, y Z+. Ver esta página para una comparación de las coordenadas del mapa normal esperadas por los motores populares.


  • void tile_set_occluder_offset ( int id, Vector2 occluder_offset )

Establece un desplazamiento para el oclusor de luz del tile.


  • void tile_set_region ( int id, Rect2 region )

Establece la sub-región del tile en la textura. Esto es común en los atlas de texturas.


Establece una forma para el tile, permitiendo la colisión.


  • void tile_set_shape_offset ( int id, int shape_id, Vector2 shape_offset )

Establece el desplazamiento de la forma de un tile.


  • void tile_set_shape_one_way ( int id, int shape_id, bool one_way )

Permite una colisión unidireccional en la forma de un tile.


  • void tile_set_shape_one_way_margin ( int id, int shape_id, float one_way )


  • void tile_set_shape_transform ( int id, int shape_id, Transform2D shape_transform )

Establece un Transform2D en la forma de un tile.


  • void tile_set_shapes ( int id, Array shapes )

Establece un Transform2D en la forma de un tile.


  • void tile_set_texture ( int id, Texture texture )

Establece la textura del tile.


  • void tile_set_texture_offset ( int id, Vector2 texture_offset )

Establece el desplazamiento de la textura del tile.


  • void tile_set_tile_mode ( int id, TileMode tilemode )

Establece el TileMode del tile.


  • void tile_set_z_index ( int id, int z_index )

Establece el índice de dibujo del tile.