canvas_automation_api.h

Go to the documentation of this file.

#ifndef YAZE_APP_GUI_CANVAS_CANVAS_AUTOMATION_API_H
#define YAZE_APP_GUI_CANVAS_CANVAS_AUTOMATION_API_H
 
#include <functional>
#include <tuple>
#include <vector>
 
#include "imgui/imgui.h"
 
namespace yaze {
namespace gui {
 
// Forward declaration
class Canvas;
 
class CanvasAutomationAPI {
 public:
  struct SelectionState {
    bool has_selection = false;
    std::vector<ImVec2> selected_tiles;
    ImVec2 selection_start = {0, 0};
    ImVec2 selection_end = {0, 0};
  };
 
  struct Dimensions {
    int width_tiles = 0;
    int height_tiles = 0;
    int tile_size = 16;
  };
 
  struct VisibleRegion {
    int min_x = 0;
    int min_y = 0;
    int max_x = 0;
    int max_y = 0;
  };
 
  explicit CanvasAutomationAPI(Canvas* canvas);
 
  // ============================================================================
  // Tile Operations
  // ============================================================================
 
  bool SetTileAt(int x, int y, int tile_id);
 
  int GetTileAt(int x, int y) const;
 
  bool SetTiles(const std::vector<std::tuple<int, int, int>>& tiles);
 
  // ============================================================================
  // Selection Operations
  // ============================================================================
 
  void SelectTile(int x, int y);
 
  void SelectTileRect(int x1, int y1, int x2, int y2);
 
  SelectionState GetSelection() const;
 
  void ClearSelection();
 
  // ============================================================================
  // View Operations
  // ============================================================================
 
  void ScrollToTile(int x, int y, bool center = false);
 
  void CenterOn(int x, int y);
 
  void SetZoom(float zoom);
 
  float GetZoom() const;
 
  // ============================================================================
  // Query Operations
  // ============================================================================
 
  Dimensions GetDimensions() const;
 
  VisibleRegion GetVisibleRegion() const;
 
  bool IsTileVisible(int x, int y) const;
 
  bool IsInBounds(int x, int y) const;
 
  // ============================================================================
  // Coordinate Conversion
  // ============================================================================
 
  ImVec2 TileToCanvas(int x, int y) const;
 
  ImVec2 CanvasToTile(ImVec2 canvas_pos) const;
 
  // ============================================================================
  // Callback Registration (for external integrations)
  // ============================================================================
 
  using TilePaintCallback = std::function<bool(int x, int y, int tile_id)>;
  void SetTilePaintCallback(TilePaintCallback callback);
 
  using TileQueryCallback = std::function<int(int x, int y)>;
  void SetTileQueryCallback(TileQueryCallback callback);
 
 private:
  Canvas* canvas_;
  TilePaintCallback tile_paint_callback_;
  TileQueryCallback tile_query_callback_;
};
 
}  // namespace gui
}  // namespace yaze
 
#endif  // YAZE_APP_GUI_CANVAS_CANVAS_AUTOMATION_API_H