2023-01-05 12:25:55 +00:00
/**************************************************************************/
/* tile_map.h */
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/**************************************************************************/
2018-01-04 23:50:27 +00:00
2014-02-10 01:10:30 +00:00
# ifndef TILE_MAP_H
# define TILE_MAP_H
# include "scene/2d/node_2d.h"
2021-05-07 13:41:39 +00:00
# include "scene/gui/control.h"
2014-02-10 01:10:30 +00:00
# include "scene/resources/tile_set.h"
2021-05-07 13:41:39 +00:00
class TileSetAtlasSource ;
2019-02-05 23:45:40 +00:00
2023-06-16 12:16:37 +00:00
class TerrainConstraint {
private :
const TileMap * tile_map = nullptr ;
Vector2i base_cell_coords ;
int bit = - 1 ;
int terrain = - 1 ;
int priority = 1 ;
public :
bool operator < ( const TerrainConstraint & p_other ) const {
if ( base_cell_coords = = p_other . base_cell_coords ) {
return bit < p_other . bit ;
}
return base_cell_coords < p_other . base_cell_coords ;
}
String to_string ( ) const {
return vformat ( " Constraint {pos:%s, bit:%d, terrain:%d, priority:%d} " , base_cell_coords , bit , terrain , priority ) ;
}
Vector2i get_base_cell_coords ( ) const {
return base_cell_coords ;
}
bool is_center_bit ( ) const {
return bit = = 0 ;
}
HashMap < Vector2i , TileSet : : CellNeighbor > get_overlapping_coords_and_peering_bits ( ) const ;
void set_terrain ( int p_terrain ) {
terrain = p_terrain ;
}
int get_terrain ( ) const {
return terrain ;
}
void set_priority ( int p_priority ) {
priority = p_priority ;
}
int get_priority ( ) const {
return priority ;
}
TerrainConstraint ( const TileMap * p_tile_map , const Vector2i & p_position , int p_terrain ) ; // For the center terrain bit
TerrainConstraint ( const TileMap * p_tile_map , const Vector2i & p_position , const TileSet : : CellNeighbor & p_bit , int p_terrain ) ; // For peering bits
TerrainConstraint ( ) { } ;
} ;
2021-05-07 13:41:39 +00:00
struct TileMapQuadrant {
struct CoordsWorldComparator {
2023-03-12 11:53:46 +00:00
_ALWAYS_INLINE_ bool operator ( ) ( const Vector2 & p_a , const Vector2 & p_b ) const {
2022-08-20 16:39:05 +00:00
// We sort the cells by their local coords, as it is needed by rendering.
2021-05-07 13:41:39 +00:00
if ( p_a . y = = p_b . y ) {
return p_a . x > p_b . x ;
} else {
return p_a . y < p_b . y ;
}
}
2017-10-22 01:42:23 +00:00
} ;
2022-08-20 16:39:05 +00:00
// Dirty list element.
2021-05-07 13:41:39 +00:00
SelfList < TileMapQuadrant > dirty_list_element ;
2023-06-16 12:16:37 +00:00
// Quadrant coords.
2021-05-07 13:41:39 +00:00
Vector2i coords ;
2023-06-16 12:16:37 +00:00
// TileMapCells.
2022-05-13 13:04:37 +00:00
RBSet < Vector2i > cells ;
2023-06-16 12:16:37 +00:00
// We need those two maps to sort by local position for rendering.
2021-05-07 13:41:39 +00:00
// This is kind of workaround, it would be better to sort the cells directly in the "cells" set instead.
2023-03-12 11:53:46 +00:00
RBMap < Vector2i , Vector2 > map_to_local ;
RBMap < Vector2 , Vector2i , CoordsWorldComparator > local_to_map ;
2021-05-07 13:41:39 +00:00
// Debug.
RID debug_canvas_item ;
2021-05-18 13:40:52 +00:00
// Rendering.
2021-05-07 13:41:39 +00:00
List < RID > canvas_items ;
2022-10-06 12:06:33 +00:00
HashMap < Vector2i , RID > occluders ;
2021-05-07 13:41:39 +00:00
// Physics.
List < RID > bodies ;
2021-05-18 13:40:52 +00:00
// Navigation.
2022-05-13 13:04:37 +00:00
HashMap < Vector2i , Vector < RID > > navigation_regions ;
2021-05-07 13:41:39 +00:00
2021-05-18 13:40:52 +00:00
// Scenes.
2022-05-13 13:04:37 +00:00
HashMap < Vector2i , String > scenes ;
2021-05-18 13:40:52 +00:00
2021-10-22 14:32:06 +00:00
// Runtime TileData cache.
2022-05-13 13:04:37 +00:00
HashMap < Vector2i , TileData * > runtime_tile_data_cache ;
2021-10-22 14:32:06 +00:00
2021-05-07 13:41:39 +00:00
void operator = ( const TileMapQuadrant & q ) {
coords = q . coords ;
debug_canvas_item = q . debug_canvas_item ;
canvas_items = q . canvas_items ;
occluders = q . occluders ;
bodies = q . bodies ;
navigation_regions = q . navigation_regions ;
}
TileMapQuadrant ( const TileMapQuadrant & q ) :
dirty_list_element ( this ) {
coords = q . coords ;
debug_canvas_item = q . debug_canvas_item ;
canvas_items = q . canvas_items ;
occluders = q . occluders ;
bodies = q . bodies ;
navigation_regions = q . navigation_regions ;
}
TileMapQuadrant ( ) :
dirty_list_element ( this ) {
}
} ;
2019-07-08 09:35:52 +00:00
2023-06-16 12:16:37 +00:00
class TileMapLayer : public RefCounted {
2021-05-07 13:41:39 +00:00
public :
2023-06-16 12:16:37 +00:00
enum DataFormat {
FORMAT_1 = 0 ,
FORMAT_2 ,
FORMAT_3 ,
FORMAT_MAX ,
} ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
private :
// Exposed properties.
String name ;
bool enabled = true ;
Color modulate = Color ( 1 , 1 , 1 , 1 ) ;
bool y_sort_enabled = false ;
int y_sort_origin = 0 ;
int z_index = 0 ;
RID navigation_map ;
bool uses_world_navigation_map = false ;
// Internal.
TileMap * tile_map_node = nullptr ;
int layer_index_in_tile_map_node = - 1 ;
RID canvas_item ;
bool _rendering_quadrant_order_dirty = false ;
HashMap < Vector2i , TileMapCell > tile_map ;
HashMap < Vector2i , TileMapQuadrant > quadrant_map ;
SelfList < TileMapQuadrant > : : List dirty_quadrant_list ;
// Rect cache.
mutable Rect2 rect_cache ;
mutable bool rect_cache_dirty = true ;
mutable Rect2i used_rect_cache ;
mutable bool used_rect_cache_dirty = true ;
// Quadrants management.
Vector2i _coords_to_quadrant_coords ( const Vector2i & p_coords ) const ;
HashMap < Vector2i , TileMapQuadrant > : : Iterator _create_quadrant ( const Vector2i & p_qk ) ;
void _make_quadrant_dirty ( HashMap < Vector2i , TileMapQuadrant > : : Iterator Q ) ;
void _erase_quadrant ( HashMap < Vector2i , TileMapQuadrant > : : Iterator Q ) ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
// Per-system methods.
void _rendering_notification ( int p_what ) ;
void _rendering_update ( ) ;
void _rendering_cleanup ( ) ;
void _rendering_update_dirty_quadrants ( SelfList < TileMapQuadrant > : : List & r_dirty_quadrant_list ) ;
void _rendering_reorder_quadrants ( int & r_index ) ;
void _rendering_create_quadrant ( TileMapQuadrant * p_quadrant ) ;
void _rendering_cleanup_quadrant ( TileMapQuadrant * p_quadrant ) ;
void _rendering_draw_quadrant_debug ( TileMapQuadrant * p_quadrant ) ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
HashMap < RID , Vector2i > bodies_coords ; // Mapping for RID to coords.
void _physics_update_dirty_quadrants ( SelfList < TileMapQuadrant > : : List & r_dirty_quadrant_list ) ;
void _physics_cleanup_quadrant ( TileMapQuadrant * p_quadrant ) ;
void _physics_draw_quadrant_debug ( TileMapQuadrant * p_quadrant ) ;
2022-02-23 16:25:50 +00:00
2023-06-16 12:16:37 +00:00
void _navigation_update ( ) ;
void _navigation_cleanup ( ) ;
void _navigation_update_dirty_quadrants ( SelfList < TileMapQuadrant > : : List & r_dirty_quadrant_list ) ;
void _navigation_cleanup_quadrant ( TileMapQuadrant * p_quadrant ) ;
void _navigation_draw_quadrant_debug ( TileMapQuadrant * p_quadrant ) ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
HashSet < Vector2i > instantiated_scenes ;
void _scenes_update_dirty_quadrants ( SelfList < TileMapQuadrant > : : List & r_dirty_quadrant_list ) ;
void _scenes_cleanup_quadrant ( TileMapQuadrant * p_quadrant ) ;
void _scenes_draw_quadrant_debug ( TileMapQuadrant * p_quadrant ) ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
// Runtime tile data.
void _build_runtime_update_tile_data ( SelfList < TileMapQuadrant > : : List & r_dirty_quadrant_list ) ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
// Terrains.
TileSet : : TerrainsPattern _get_best_terrain_pattern_for_constraints ( int p_terrain_set , const Vector2i & p_position , const RBSet < TerrainConstraint > & p_constraints , TileSet : : TerrainsPattern p_current_pattern ) ;
RBSet < TerrainConstraint > _get_terrain_constraints_from_added_pattern ( const Vector2i & p_position , int p_terrain_set , TileSet : : TerrainsPattern p_terrains_pattern ) const ;
RBSet < TerrainConstraint > _get_terrain_constraints_from_painted_cells_list ( const RBSet < Vector2i > & p_painted , int p_terrain_set , bool p_ignore_empty_terrains ) const ;
2022-02-23 16:25:50 +00:00
2023-06-16 12:16:37 +00:00
public :
// TileMap node.
void set_tile_map ( TileMap * p_tile_map ) ;
void set_layer_index_in_tile_map_node ( int p_index ) ;
2022-02-23 16:25:50 +00:00
2023-06-16 12:16:37 +00:00
// Rect caching.
Rect2 get_rect ( bool & r_changed ) const ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
// Terrains.
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_constraints ( const Vector < Vector2i > & p_to_replace , int p_terrain_set , const RBSet < TerrainConstraint > & p_constraints ) ; // Not exposed.
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_connect ( const Vector < Vector2i > & p_coords_array , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ; // Not exposed.
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_path ( const Vector < Vector2i > & p_coords_array , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ; // Not exposed.
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_pattern ( const Vector < Vector2i > & p_coords_array , int p_terrain_set , TileSet : : TerrainsPattern p_terrains_pattern , bool p_ignore_empty_terrains = true ) ; // Not exposed.
// Not exposed to users.
TileMapCell get_cell ( const Vector2i & p_coords , bool p_use_proxies = false ) const ;
int get_effective_quadrant_size ( ) const ;
// For TileMap node's use.
void notify_canvas_entered ( ) ;
void notify_visibility_changed ( ) ;
void notify_xform_changed ( ) ;
void notify_local_xform_changed ( ) ;
void notify_canvas_exited ( ) ;
void notify_selected_layer_changed ( ) ;
void notify_light_mask_changed ( ) ;
void notify_material_changed ( ) ;
void notify_use_parent_material_changed ( ) ;
void notify_texture_filter_changed ( ) ;
void notify_texture_repeat_changed ( ) ;
void update_dirty_quadrants ( ) ;
void set_tile_data ( DataFormat p_format , const Vector < int > & p_data ) ;
Vector < int > get_tile_data ( ) const ;
void clear_instantiated_scenes ( ) ;
void clear_internals ( ) ; // Exposed for now to tilemap, but ideally, we should avoid it.
void recreate_internals ( ) ; // Exposed for now to tilemap, but ideally, we should avoid it.
// --- Exposed in TileMap ---
// Cells manipulation.
void set_cell ( const Vector2i & p_coords , int p_source_id = TileSet : : INVALID_SOURCE , const Vector2i p_atlas_coords = TileSetSource : : INVALID_ATLAS_COORDS , int p_alternative_tile = 0 ) ;
void erase_cell ( const Vector2i & p_coords ) ;
int get_cell_source_id ( const Vector2i & p_coords , bool p_use_proxies = false ) const ;
Vector2i get_cell_atlas_coords ( const Vector2i & p_coords , bool p_use_proxies = false ) const ;
int get_cell_alternative_tile ( const Vector2i & p_coords , bool p_use_proxies = false ) const ;
TileData * get_cell_tile_data ( const Vector2i & p_coords , bool p_use_proxies = false ) const ; // Helper method to make accessing the data easier.
void clear ( ) ;
// Patterns.
Ref < TileMapPattern > get_pattern ( TypedArray < Vector2i > p_coords_array ) ;
void set_pattern ( const Vector2i & p_position , const Ref < TileMapPattern > p_pattern ) ;
// Terrains.
void set_cells_terrain_connect ( TypedArray < Vector2i > p_cells , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ;
void set_cells_terrain_path ( TypedArray < Vector2i > p_path , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ;
// Cells usage.
TypedArray < Vector2i > get_used_cells ( ) const ;
TypedArray < Vector2i > get_used_cells_by_id ( int p_source_id = TileSet : : INVALID_SOURCE , const Vector2i p_atlas_coords = TileSetSource : : INVALID_ATLAS_COORDS , int p_alternative_tile = TileSetSource : : INVALID_TILE_ALTERNATIVE ) const ;
Rect2i get_used_rect ( ) const ;
// Layer properties.
void set_name ( String p_name ) ;
String get_name ( ) const ;
void set_enabled ( bool p_enabled ) ;
bool is_enabled ( ) const ;
void set_modulate ( Color p_modulate ) ;
Color get_modulate ( ) const ;
void set_y_sort_enabled ( bool p_y_sort_enabled ) ;
bool is_y_sort_enabled ( ) const ;
void set_y_sort_origin ( int p_y_sort_origin ) ;
int get_y_sort_origin ( ) const ;
void set_z_index ( int p_z_index ) ;
int get_z_index ( ) const ;
void set_navigation_map ( RID p_map ) ;
RID get_navigation_map ( ) const ;
// In case something goes wrong.
void force_update ( ) ;
// Fixing and clearing methods.
void fix_invalid_tiles ( ) ;
// Find coords for body.
bool has_body_rid ( RID p_physics_body ) const ;
Vector2i get_coords_for_body_rid ( RID p_physics_body ) const ; // For finding tiles from collision.
} ;
class TileMap : public Node2D {
GDCLASS ( TileMap , Node2D ) ;
public :
2021-05-24 10:33:22 +00:00
enum VisibilityMode {
VISIBILITY_MODE_DEFAULT ,
VISIBILITY_MODE_FORCE_SHOW ,
VISIBILITY_MODE_FORCE_HIDE ,
} ;
2021-05-07 13:41:39 +00:00
private :
friend class TileSetPlugin ;
2014-02-10 01:10:30 +00:00
2021-05-24 10:33:22 +00:00
// A compatibility enum to specify how is the data if formatted.
2023-06-16 12:16:37 +00:00
mutable TileMapLayer : : DataFormat format = TileMapLayer : : FORMAT_3 ;
2014-02-10 01:10:30 +00:00
2021-07-28 16:10:01 +00:00
static constexpr float FP_ADJUST = 0.00001 ;
2021-05-24 10:33:22 +00:00
// Properties.
2021-05-07 13:41:39 +00:00
Ref < TileSet > tile_set ;
2021-05-24 10:33:22 +00:00
int quadrant_size = 16 ;
2021-09-15 13:23:58 +00:00
bool collision_animatable = false ;
2021-07-28 16:10:01 +00:00
VisibilityMode collision_visibility_mode = VISIBILITY_MODE_DEFAULT ;
VisibilityMode navigation_visibility_mode = VISIBILITY_MODE_DEFAULT ;
2014-02-10 01:10:30 +00:00
2023-06-16 12:16:37 +00:00
// Layers.
LocalVector < Ref < TileMapLayer > > layers ;
2021-07-28 16:10:01 +00:00
int selected_layer = - 1 ;
void _clear_internals ( ) ;
2023-06-16 12:16:37 +00:00
void _recreate_internals ( ) ;
2021-07-28 16:10:01 +00:00
2023-06-16 12:16:37 +00:00
bool pending_update = false ;
2021-07-28 16:10:01 +00:00
2021-09-15 13:23:58 +00:00
Transform2D last_valid_transform ;
Transform2D new_transform ;
2021-10-22 14:32:06 +00:00
2021-05-07 13:41:39 +00:00
void _tile_set_changed ( ) ;
2021-10-13 12:49:28 +00:00
bool _tile_set_changed_deferred_update_needed = false ;
void _tile_set_changed_deferred_update ( ) ;
2014-10-03 03:10:51 +00:00
2014-02-10 01:10:30 +00:00
protected :
2017-10-22 01:42:23 +00:00
bool _set ( const StringName & p_name , const Variant & p_value ) ;
bool _get ( const StringName & p_name , Variant & r_ret ) const ;
void _get_property_list ( List < PropertyInfo > * p_list ) const ;
2014-02-10 01:10:30 +00:00
void _notification ( int p_what ) ;
static void _bind_methods ( ) ;
2023-06-16 12:16:37 +00:00
# ifndef DISABLE_DEPRECATED
Rect2i _get_used_rect_bind_compat_78328 ( ) ;
static void _bind_compatibility_methods ( ) ;
# endif
2014-02-10 01:10:30 +00:00
public :
2022-12-12 10:33:42 +00:00
static Vector2i transform_coords_layout ( const Vector2i & p_coords , TileSet : : TileOffsetAxis p_offset_axis , TileSet : : TileLayout p_from_layout , TileSet : : TileLayout p_to_layout ) ;
2021-05-07 13:41:39 +00:00
2019-10-21 21:37:07 +00:00
# ifdef TOOLS_ENABLED
2020-07-10 10:34:39 +00:00
virtual Rect2 _edit_get_rect ( ) const override ;
2019-10-21 21:37:07 +00:00
# endif
2018-07-29 21:09:59 +00:00
2023-06-16 12:16:37 +00:00
// Called by TileMapLayers.
void queue_update_dirty_quadrants ( ) ;
void _update_dirty_quadrants ( ) ;
2014-02-10 01:10:30 +00:00
void set_tileset ( const Ref < TileSet > & p_tileset ) ;
Ref < TileSet > get_tileset ( ) const ;
void set_quadrant_size ( int p_size ) ;
int get_quadrant_size ( ) const ;
2023-05-20 02:26:27 +00:00
static void draw_tile ( RID p_canvas_item , const Vector2 & p_position , const Ref < TileSet > p_tile_set , int p_atlas_source_id , const Vector2i & p_atlas_coords , int p_alternative_tile , int p_frame = - 1 , Color p_modulation = Color ( 1.0 , 1.0 , 1.0 , 1.0 ) , const TileData * p_tile_data_override = nullptr , real_t p_animation_offset = 0.0 ) ;
2021-07-28 16:10:01 +00:00
// Layers management.
int get_layers_count ( ) const ;
2021-08-31 08:48:45 +00:00
void add_layer ( int p_to_pos ) ;
void move_layer ( int p_layer , int p_to_pos ) ;
void remove_layer ( int p_layer ) ;
2023-06-16 12:16:37 +00:00
2021-07-28 16:10:01 +00:00
void set_layer_name ( int p_layer , String p_name ) ;
String get_layer_name ( int p_layer ) const ;
void set_layer_enabled ( int p_layer , bool p_visible ) ;
bool is_layer_enabled ( int p_layer ) const ;
2021-10-10 15:04:25 +00:00
void set_layer_modulate ( int p_layer , Color p_modulate ) ;
Color get_layer_modulate ( int p_layer ) const ;
2021-07-28 16:10:01 +00:00
void set_layer_y_sort_enabled ( int p_layer , bool p_enabled ) ;
bool is_layer_y_sort_enabled ( int p_layer ) const ;
void set_layer_y_sort_origin ( int p_layer , int p_y_sort_origin ) ;
int get_layer_y_sort_origin ( int p_layer ) const ;
void set_layer_z_index ( int p_layer , int p_z_index ) ;
int get_layer_z_index ( int p_layer ) const ;
2023-06-16 12:16:37 +00:00
void set_layer_navigation_map ( int p_layer , RID p_map ) ;
RID get_layer_navigation_map ( int p_layer ) const ;
2021-07-28 16:10:01 +00:00
void set_selected_layer ( int p_layer_id ) ; // For editor use.
int get_selected_layer ( ) const ;
2021-09-15 13:23:58 +00:00
void set_collision_animatable ( bool p_enabled ) ;
bool is_collision_animatable ( ) const ;
2021-10-21 14:42:06 +00:00
// Debug visibility modes.
2021-05-24 10:33:22 +00:00
void set_collision_visibility_mode ( VisibilityMode p_show_collision ) ;
VisibilityMode get_collision_visibility_mode ( ) ;
void set_navigation_visibility_mode ( VisibilityMode p_show_navigation ) ;
VisibilityMode get_navigation_visibility_mode ( ) ;
2021-10-21 14:42:06 +00:00
// Cells accessors.
2023-01-18 12:35:58 +00:00
void set_cell ( int p_layer , const Vector2i & p_coords , int p_source_id = TileSet : : INVALID_SOURCE , const Vector2i p_atlas_coords = TileSetSource : : INVALID_ATLAS_COORDS , int p_alternative_tile = 0 ) ;
2022-03-01 18:25:18 +00:00
void erase_cell ( int p_layer , const Vector2i & p_coords ) ;
2021-07-28 16:10:01 +00:00
int get_cell_source_id ( int p_layer , const Vector2i & p_coords , bool p_use_proxies = false ) const ;
Vector2i get_cell_atlas_coords ( int p_layer , const Vector2i & p_coords , bool p_use_proxies = false ) const ;
int get_cell_alternative_tile ( int p_layer , const Vector2i & p_coords , bool p_use_proxies = false ) const ;
2021-11-03 13:58:12 +00:00
// Helper method to make accessing the data easier.
TileData * get_cell_tile_data ( int p_layer , const Vector2i & p_coords , bool p_use_proxies = false ) const ;
2014-02-10 01:10:30 +00:00
2021-10-21 14:42:06 +00:00
// Patterns.
2021-09-29 15:48:27 +00:00
Ref < TileMapPattern > get_pattern ( int p_layer , TypedArray < Vector2i > p_coords_array ) ;
2022-12-12 10:33:42 +00:00
Vector2i map_pattern ( const Vector2i & p_position_in_tilemap , const Vector2i & p_coords_in_pattern , Ref < TileMapPattern > p_pattern ) ;
void set_pattern ( int p_layer , const Vector2i & p_position , const Ref < TileMapPattern > p_pattern ) ;
2015-08-02 15:29:37 +00:00
2023-06-16 12:16:37 +00:00
// Terrains (Not exposed).
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_constraints ( int p_layer , const Vector < Vector2i > & p_to_replace , int p_terrain_set , const RBSet < TerrainConstraint > & p_constraints ) ;
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_connect ( int p_layer , const Vector < Vector2i > & p_coords_array , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ;
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_path ( int p_layer , const Vector < Vector2i > & p_coords_array , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ;
HashMap < Vector2i , TileSet : : TerrainsPattern > terrain_fill_pattern ( int p_layer , const Vector < Vector2i > & p_coords_array , int p_terrain_set , TileSet : : TerrainsPattern p_terrains_pattern , bool p_ignore_empty_terrains = true ) ;
2022-02-23 16:25:50 +00:00
2023-06-16 12:16:37 +00:00
// Terrains (exposed).
2022-02-23 16:25:50 +00:00
void set_cells_terrain_connect ( int p_layer , TypedArray < Vector2i > p_cells , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ;
void set_cells_terrain_path ( int p_layer , TypedArray < Vector2i > p_path , int p_terrain_set , int p_terrain , bool p_ignore_empty_terrains = true ) ;
2021-10-21 14:42:06 +00:00
2023-06-16 12:16:37 +00:00
// Not exposed to users.
2021-07-28 16:10:01 +00:00
TileMapCell get_cell ( int p_layer , const Vector2i & p_coords , bool p_use_proxies = false ) const ;
int get_effective_quadrant_size ( int p_layer ) const ;
2017-10-22 01:42:23 +00:00
2020-09-23 19:49:50 +00:00
virtual void set_y_sort_enabled ( bool p_enable ) override ;
2018-07-22 13:26:14 +00:00
2022-08-20 16:39:05 +00:00
Vector2 map_to_local ( const Vector2i & p_pos ) const ;
Vector2i local_to_map ( const Vector2 & p_pos ) const ;
2014-10-03 03:10:51 +00:00
2021-05-07 13:41:39 +00:00
bool is_existing_neighbor ( TileSet : : CellNeighbor p_cell_neighbor ) const ;
Vector2i get_neighbor_cell ( const Vector2i & p_coords , TileSet : : CellNeighbor p_cell_neighbor ) const ;
2019-07-01 20:43:52 +00:00
2021-07-28 16:10:01 +00:00
TypedArray < Vector2i > get_used_cells ( int p_layer ) const ;
2023-01-18 12:35:58 +00:00
TypedArray < Vector2i > get_used_cells_by_id ( int p_layer , int p_source_id = TileSet : : INVALID_SOURCE , const Vector2i p_atlas_coords = TileSetSource : : INVALID_ATLAS_COORDS , int p_alternative_tile = TileSetSource : : INVALID_TILE_ALTERNATIVE ) const ;
2023-06-16 12:16:37 +00:00
Rect2i get_used_rect ( ) const ;
2017-02-20 21:02:03 +00:00
2023-06-16 12:16:37 +00:00
// Override some methods of the CanvasItem class to pass the changes to the quadrants CanvasItems.
2020-07-10 10:34:39 +00:00
virtual void set_light_mask ( int p_light_mask ) override ;
virtual void set_material ( const Ref < Material > & p_material ) override ;
virtual void set_use_parent_material ( bool p_use_parent_material ) override ;
2020-02-19 21:26:24 +00:00
virtual void set_texture_filter ( CanvasItem : : TextureFilter p_texture_filter ) override ;
virtual void set_texture_repeat ( CanvasItem : : TextureRepeat p_texture_repeat ) override ;
2021-09-15 13:23:58 +00:00
// For finding tiles from collision.
Vector2i get_coords_for_body_rid ( RID p_physics_body ) ;
2023-04-19 04:22:46 +00:00
// For getting their layers as well.
int get_layer_for_body_rid ( RID p_physics_body ) ;
2021-09-15 13:23:58 +00:00
2022-02-23 16:25:50 +00:00
// Fixing and clearing methods.
2018-02-24 05:56:48 +00:00
void fix_invalid_tiles ( ) ;
2021-07-28 16:10:01 +00:00
2023-06-16 12:16:37 +00:00
// Clears tiles from a given layer.
2021-07-28 16:10:01 +00:00
void clear_layer ( int p_layer ) ;
2014-02-10 01:10:30 +00:00
void clear ( ) ;
2023-06-16 12:16:37 +00:00
// Force a TileMap update.
2021-10-22 14:32:06 +00:00
void force_update ( int p_layer = - 1 ) ;
// Helpers?
2022-12-12 10:33:42 +00:00
TypedArray < Vector2i > get_surrounding_cells ( const Vector2i & coords ) ;
void draw_cells_outline ( Control * p_control , const RBSet < Vector2i > & p_cells , Color p_color , Transform2D p_transform = Transform2D ( ) ) ;
2021-05-07 13:41:39 +00:00
2023-06-16 12:16:37 +00:00
// Virtual function to modify the TileData at runtime.
2021-10-22 14:32:06 +00:00
GDVIRTUAL2R ( bool , _use_tile_data_runtime_update , int , Vector2i ) ;
GDVIRTUAL3 ( _tile_data_runtime_update , int , Vector2i , TileData * ) ;
2021-07-28 16:10:01 +00:00
// Configuration warnings.
2022-09-19 15:43:15 +00:00
PackedStringArray get_configuration_warnings ( ) const override ;
2021-07-28 16:10:01 +00:00
2014-02-10 01:10:30 +00:00
TileMap ( ) ;
~ TileMap ( ) ;
} ;
2021-05-24 10:33:22 +00:00
VARIANT_ENUM_CAST ( TileMap : : VisibilityMode ) ;
2014-02-10 01:10:30 +00:00
# endif // TILE_MAP_H