map_refresh_coordinator.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_OVERWORLD_MAP_REFRESH_COORDINATOR_H
#define YAZE_APP_EDITOR_OVERWORLD_MAP_REFRESH_COORDINATOR_H
 
#include <array>
#include <functional>
#include <string>
 
#include "absl/status/status.h"
#include "app/gfx/core/bitmap.h"
#include "app/gfx/render/tilemap.h"
#include "app/gfx/types/snes_palette.h"
#include "zelda3/common.h"
#include "zelda3/overworld/overworld.h"
 
namespace yaze {
 
class Rom;
 
namespace gfx {
class IRenderer;
}  // namespace gfx
 
namespace editor {
 
class Tile16Editor;
 
// =============================================================================
// MapRefreshCoordinator
// =============================================================================
//
// Extracted from OverworldEditor to encapsulate the Map Refresh System.
// Handles refreshing map graphics, palettes, tilesets, and multi-area
// coordination after property changes.
//
// This class does not own any of the data it operates on. It holds
// pointers/references to data owned by OverworldEditor.
// =============================================================================
 
struct MapRefreshContext {
  Rom* rom = nullptr;
  zelda3::Overworld* overworld = nullptr;
  std::array<gfx::Bitmap, zelda3::kExpandedMapCount>* maps_bmp = nullptr;
  gfx::Tilemap* tile16_blockset = nullptr;
  gfx::Bitmap* current_gfx_bmp = nullptr;
  gfx::BitmapTable* current_graphics_set = nullptr;
  gfx::SnesPalette* palette = nullptr;
  gfx::IRenderer* renderer = nullptr;
  Tile16Editor* tile16_editor = nullptr;
 
  // Mutable state references (owned by OverworldEditor)
  int* current_world = nullptr;
  int* current_map = nullptr;
  int* current_blockset = nullptr;
  int* game_state = nullptr;
  bool* map_blockset_loaded = nullptr;
  absl::Status* status = nullptr;
 
  std::function<void(int map_index)> ensure_map_texture;
};
 
class MapRefreshCoordinator {
 public:
  explicit MapRefreshCoordinator(const MapRefreshContext& ctx) : ctx_(ctx) {}
 
  // ===========================================================================
  // Map Refresh Methods
  // ===========================================================================
 
  void InvalidateGraphicsCache(int map_id = -1);
 
  void InvalidateTile16Definitions();
 
  // Color-only refresh of materialized maps, including cached other worlds.
  // Unbuilt maps resolve current GameData colors when they are first built.
  absl::Status RefreshPaletteUsers(const std::string& group, int palette_index);
 
  void RefreshChildMap(int map_index);
 
  void RefreshOverworldMap();
 
  void RefreshOverworldMapOnDemand(int map_index);
 
  void RefreshChildMapOnDemand(int map_index);
 
  void RefreshMultiAreaMapsSafely(int map_index, zelda3::OverworldMap* map);
 
  // Explicit targets let undo refresh an area without changing selection.
  absl::Status RefreshMapPalette(int map_id = -1);
 
  void ForceRefreshGraphics(int map_index);
 
  void RefreshSiblingMapGraphics(int map_index, bool include_self = false);
 
  void RefreshMapProperties(int map_id = -1);
 
  absl::Status RefreshTile16Blockset();
 
  void UpdateBlocksetWithPendingTileChanges();
 
 private:
  MapRefreshContext ctx_;
};
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_OVERWORLD_MAP_REFRESH_COORDINATOR_H