sprite_interaction_handler.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_DUNGEON_INTERACTION_SPRITE_INTERACTION_HANDLER_H_
#define YAZE_APP_EDITOR_DUNGEON_INTERACTION_SPRITE_INTERACTION_HANDLER_H_
 
#include <functional>
#include <utility>
#include <vector>
 
#include "absl/status/status.h"
#include "app/editor/dungeon/interaction/base_entity_handler.h"
#include "app/editor/dungeon/interaction/ghost_preview_feedback.h"
#include "zelda3/sprite/sprite.h"
 
namespace yaze {
namespace editor {
 
class SpriteInteractionHandler : public BaseEntityHandler {
 public:
  using GhostCapacityState = PlacementCapacityState;
  enum class PlacementBlockReason {
    kNone = 0,
    kInvalidRoom,
    kSpriteLimit,
    kStorageValidation,
  };
 
  // ========================================================================
  // BaseEntityHandler interface
  // ========================================================================
 
  void BeginPlacement() override;
  void CancelPlacement() override { sprite_placement_mode_ = false; }
  bool IsPlacementActive() const override { return sprite_placement_mode_; }
 
  bool HandleClick(int canvas_x, int canvas_y) override;
  void HandleDrag(ImVec2 current_pos, ImVec2 delta) override;
  void HandleRelease() override;
 
  void DrawGhostPreview() override;
  void DrawSelectionHighlight() override;
 
  std::optional<size_t> GetEntityAtPosition(int canvas_x,
                                            int canvas_y) const override;
 
  // ========================================================================
  // Sprite-specific methods
  // ========================================================================
 
  void SetSpriteId(uint8_t id) { preview_sprite_id_ = id; }
 
  uint8_t GetSpriteId() const { return preview_sprite_id_; }
 
  void SelectSprite(size_t index);
 
  void ClearSelection();
 
  bool HasSelection() const { return selected_sprite_index_.has_value(); }
 
  std::optional<size_t> GetSelectedIndex() const {
    return selected_sprite_index_;
  }
 
  void DeleteSelected();
  void DeleteAll();
  bool NudgeSelected(int delta_x, int delta_y);
  // ROM sprite fields: 5-bit coordinates/subtype, one-bit layer, key drop 0..2.
  // Rejects reserved stream terminators and hidden key-marker encodings too.
  static absl::Status ValidateSpriteProperties(uint8_t id, int x, int y,
                                               int subtype, int layer,
                                               int key_drop);
  bool UpdateSprite(size_t index, uint8_t id, int x, int y, int subtype,
                    int layer, int key_drop);
 
  // Preflight is read-only and runs before history or room data changes.
  using SpriteMutationPreflight =
      std::function<absl::Status(int, const std::vector<zelda3::Sprite>&)>;
  void SetSpriteMutationPreflight(SpriteMutationPreflight callback) {
    sprite_mutation_preflight_ = std::move(callback);
  }
  const absl::Status& mutation_status() const { return mutation_status_; }
  void SetMutationErrorCallback(
      std::function<void(const absl::Status&)> callback) {
    mutation_error_callback_ = std::move(callback);
  }
 
  bool was_placement_blocked() const {
    return placement_block_reason_ != PlacementBlockReason::kNone;
  }
  PlacementBlockReason placement_block_reason() const {
    return placement_block_reason_;
  }
  void clear_placement_blocked() {
    placement_block_reason_ = PlacementBlockReason::kNone;
  }
  GhostCapacityState GetPlacementGhostCapacityState() const;
 
 private:
  // Placement state
  bool sprite_placement_mode_ = false;
  uint8_t preview_sprite_id_ = 0;
  PlacementBlockReason placement_block_reason_ = PlacementBlockReason::kNone;
 
  // Selection state
  std::optional<size_t> selected_sprite_index_;
  bool is_dragging_ = false;
  ImVec2 drag_start_pos_;
  ImVec2 drag_current_pos_;
 
  SpriteMutationPreflight sprite_mutation_preflight_;
  std::function<void(const absl::Status&)> mutation_error_callback_;
  absl::Status mutation_status_ = absl::OkStatus();
 
  bool PreflightSprites(const std::vector<zelda3::Sprite>& candidate);
 
  void PlaceSpriteAtPosition(int canvas_x, int canvas_y);
 
  std::pair<int, int> CanvasToSpriteCoords(int canvas_x, int canvas_y) const;
};
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_DUNGEON_INTERACTION_SPRITE_INTERACTION_HANDLER_H_