Godot4 ローカル座標をタイルマップのセル座標に小数切り上げで変換する例

# グローバル座標の位置を、tilmepa_layer のセルの位置 (小数切り上げで整数) に変換します。
#
# TileMapLayer.local_to_map(local_pos) + Vector2i(1, 1) という処理（仮に処理 A）と似ていますが、
# 引数によって処理が異なる場合があります。
# 例えば、TileMapLayer.global_posiion = (0, 0), TileMapLayer.tile_set.tile_size = (16, 16) の場合、
# local_pos が (20, 47) だった場合、本関数では (1, 2) で、処理 A でも (1, 2) と同じ値が返されます。
# しかし、 local_pos が (32, 48) だった場合、本関数では (1, 2) ですが、処理 A では (2, 3) になってしまいます。
func to_cell_pos_ceil(global_pos: Vector2, tilemap_layer: TileMapLayer) -> Vector2i:
	return Vector2i(to_cell_pos(global_pos, tilemap_layer).ceil())

# グローバル座標の位置を、tilmepa_layer のセルの位置 (小数切り捨てで整数) に変換します。
# おそらく、TileMapLayer.local_to_map と同じ結果が得られます。
func to_cell_pos_floor(global_pos: Vector2, tilemap_layer: TileMapLayer) -> Vector2i:
	return Vector2i(to_cell_pos(global_pos, tilemap_layer).floor())

# グローバル座標の位置を、tilmepa_layer のセルの位置(小数)に変換します。
# to_cell_pos_ceil, to_ceil_pos_floor 関数の共通の処理です。
func to_cell_pos(global_pos: Vector2, tilemap_layer: TileMapLayer) -> Vector2:
	# tilemap_layer のローカル座標に変換。
	# 例えば tilemap_layer.global_position = (-16, 32), global_pos = (64, 80) だった場合
	# local_pos には (64 - (-16), 80 - 32) = (80, 48) に変換されます。 
	var local_pos = tilemap_layer.to_local(global_pos)
	# tilemap_layer のタイル(セル)サイズを取得します。
	var cell_size = Vector2(tilemap_layer.tile_set.tile_size)
	# local_pos = (80, 48) で cell_size = (16, 16) の場合はセル座標 (5, 3) が返されます。
	# セル座標が (4.8, 2.1) のような場合は切り上げられて (5, 3) が返されます。
	return local_pos / cell_size

func _ready():
	var global_pos = Vector2(64, 80)
	var cell_pos = to_cell_pos_floor(global_pos, $TileMapLayer)
	print("global_pos = ", global_pos)
	print("$TileMapLayer.global_position = ", $TileMapLayer.global_position)
	print("$TileMapLayer.tile_set.tile_size = ", $TileMapLayer.tile_set.tile_size)
	print("cell_pos = ", cell_pos)

global_pos = (64, 80)
$TileMapLayer.global_position = (-16, 32)
$TileMapLayer.tile_set.tile_size = (16, 16)
cell_pos = (5, 3)

func _ready():
	$TileMapLayer.global_position = Vector2(0, 0)
	print("local_to_map(20, 47) + Vector2i(1, 1) = ", $TileMapLayer.local_to_map(Vector2(20, 47)) + Vector2i(1, 1))
	print("to_cell_pos_ceil(Vector2(20, 47), $TileMapLayer) = ", to_cell_pos_ceil(Vector2(20, 47), $TileMapLayer))
	print("local_to_map(32, 48)  + Vector2i(1, 1) = ", $TileMapLayer.local_to_map(Vector2(32, 48)) + Vector2i(1, 1))
	print("to_cell_pos_ceil(Vector2(32, 48), $TileMapLayer) = ", to_cell_pos_ceil(Vector2(32, 48), $TileMapLayer))
	print("local_to_map(33, 49) + Vector2i(1, 1) = ", $TileMapLayer.local_to_map(Vector2(33, 49)) + Vector2i(1, 1))
	print("to_cell_pos_ceil(Vector2(33, 49), $TileMapLayer) = ", to_cell_pos_ceil(Vector2(33, 49), $TileMapLayer))

local_to_map(20, 47) + Vector2i(1, 1) = (2, 3)
to_cell_pos_ceil(Vector2(20, 47), $TileMapLayer) = (2, 3)
local_to_map(32, 48)  + Vector2i(1, 1) = (3, 4)
to_cell_pos_ceil(Vector2(32, 48), $TileMapLayer) = (2, 3)
local_to_map(33, 49) + Vector2i(1, 1) = (3, 4)
to_cell_pos_ceil(Vector2(33, 49), $TileMapLayer) = (3, 4)

		# 当たり判定領域の外接矩形を取得して、body の scale に合わせて拡大縮小します。
		var rect = shape.get_rect()
		rect.position *= body.scale
		rect.size *= body.scale

		# デバッグ用に１６の倍数に設定
		rect.position = Vector2(-8, -8)
		rect.size = Vector2(16, 16)
		#print("Collision shape rect: ", rect) # Debug