Grid Placement

GBPositioning2DUtils

AUTO-GENERATED FILE — DO NOT EDIT MANUALLY

Source: utils/gb_positioning_2d_utils.gd

Version: 5.0

class_name: GBPositioning2DUtils extends: RefCounted

Summary

GBPositioning2DUtils 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.

Signals

(none)

Exports

(none)

Methods

(none)