canvas_navigation_manager.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_OVERWORLD_CANVAS_NAVIGATION_MANAGER_H
#define YAZE_APP_EDITOR_OVERWORLD_CANVAS_NAVIGATION_MANAGER_H
 
#include <array>
#include <functional>
#include <memory>
#include <vector>
 
#include "absl/status/status.h"
#include "app/editor/overworld/ui_constants.h"
#include "app/gfx/core/bitmap.h"
#include "app/gfx/render/tilemap.h"
#include "app/gui/canvas/canvas.h"
#include "app/gui/widgets/tile_selector_widget.h"
#include "rom/rom.h"
#include "zelda3/common.h"
#include "zelda3/overworld/overworld.h"
 
namespace yaze::editor {
 
// Forward declarations
class OverworldEntityRenderer;
 
// =============================================================================
// CanvasNavigationManager
// =============================================================================
//
// Extracted from OverworldEditor to encapsulate all canvas navigation logic:
//   - Map hover detection and lazy loading (CheckForCurrentMap)
//   - Pan and zoom controls
//   - Map interaction (context menus, lock toggle)
//   - Background preloading of adjacent maps
//   - Blockset selector synchronization
//
// The manager holds pointers to shared editor state (via NavigationContext)
// and uses callbacks for operations that remain in the editor (e.g. map
// refresh, texture creation).
// =============================================================================
 
struct CanvasNavigationContext {
  // Canvas references
  gui::Canvas* ow_map_canvas = nullptr;
 
  // Data model
  zelda3::Overworld* overworld = nullptr;
  Rom* rom = nullptr;
 
  // Selection state (mutable pointers into editor fields)
  int* current_map = nullptr;
  int* current_world = nullptr;
  int* current_parent = nullptr;
  int* current_tile16 = nullptr;
 
  // Mode state
  EditingMode* current_mode = nullptr;
  bool* current_map_lock = nullptr;
  bool* is_dragging_entity = nullptr;
  bool* show_map_properties_panel = nullptr;
 
  // Graphics
  std::array<gfx::Bitmap, zelda3::kNumOverworldMaps>* maps_bmp = nullptr;
  gfx::Tilemap* tile16_blockset = nullptr;
 
  // Widgets (read-only pointer to editor's unique_ptr)
  std::unique_ptr<gui::TileSelectorWidget>* blockset_selector = nullptr;
};
 
struct CanvasNavigationCallbacks {
  std::function<void()> refresh_overworld_map;
  std::function<absl::Status()> refresh_tile16_blockset;
  std::function<void(int)> ensure_map_texture;
  std::function<bool()> pick_tile16_from_hovered_canvas;
  std::function<bool()> is_entity_hovered;
};
 
class CanvasNavigationManager {
 public:
  CanvasNavigationManager() = default;
 
  void Initialize(const CanvasNavigationContext& context,
                  const CanvasNavigationCallbacks& callbacks);
 
  // ===========================================================================
  // Map Detection and Loading
  // ===========================================================================
 
  absl::Status CheckForCurrentMap();
 
  // ===========================================================================
  // Map Interaction
  // ===========================================================================
 
  void HandleMapInteraction();
 
  // ===========================================================================
  // Pan and Zoom
  // ===========================================================================
 
  void HandleOverworldPan();
 
  void HandleOverworldZoom();
 
  void ZoomIn();
 
  void ZoomOut();
 
  void ClampOverworldScroll();
 
  void ResetOverworldView();
 
  void CenterOverworldView();
 
  void CheckForMousePan();
 
  // ===========================================================================
  // Blockset Selector Synchronization
  // ===========================================================================
 
  void ScrollBlocksetCanvasToCurrentTile();
 
  void UpdateBlocksetSelectorState();
 
  // ===========================================================================
  // Background Pre-loading
  // ===========================================================================
 
  void QueueAdjacentMapsForPreload(int center_map);
 
  void ProcessPreloadQueue();
 
 private:
  CanvasNavigationContext ctx_;
  CanvasNavigationCallbacks callbacks_;
 
  // Hover debounce state
  int last_hovered_map_ = -1;
  float hover_time_ = 0.0f;
  static constexpr float kHoverBuildDelay = 0.15f;
 
  // Background pre-loading state
  std::vector<int> preload_queue_;
  static constexpr float kPreloadStartDelay = 0.3f;
};
 
}  // namespace yaze::editor
 
#endif  // YAZE_APP_EDITOR_OVERWORLD_CANVAS_NAVIGATION_MANAGER_H