PlacementPositioning2DUtils

PlacementPositioning2DUtils Static utility functions for 2D grid-based positioning and tile movement operations. This class provides pure functions for common 2D game positioning tasks including:

• Converting between world coordinates, viewport coordinates, and tile coordinates
• Moving nodes to tile centers with proper alignment
• Viewport-to-world coordinate transformations using Camera2D
• Distance-limited movement with adjacency constraints
• Direction vector normalization for tile-based movement All functions are static and depend only on provided parameters, making them highly testable and reusable. Extracted from GridPositioner2D to reduce class coupling and improve maintainability. [b]⭐ CAMERA2D REQUIRED[/b]
• Add a Camera2D node to your scene before using Grid Building operations. World coordinate calculations from mouse position depend on Camera2D for accurate positioning. [b]Requirements:[/b] Designed for 2D games using TileMapLayer and Camera2D nodes.

Source: addons/grid_placement/utils/placement_positioning_2d_utils.gd

Syntax

class PlacementPositioning2DUtils extends RefCounted

Members

Name	Kind	Summary
success	Property	Internal explicit projection result shared by runtime and validator paths. World origin is therefore a normal successful value rather than a sentinel.
world_position	Property
error	Property
get_tile_from_global_position	Method
move_to_tile_center	Method
move_to_closest_valid_tile_center	Method
limit_tile_to_max_distance	Method
is_region_valid	Method
snap_tile_to_region	Method
get_tile_from_node_position	Method
move_node_by_tiles	Method
convert_screen_to_world_position	Method
viewport_center_to_world_position	Method
move_node_to_tile_at_viewport_center	Method
direction_to_tile_delta	Method