entity_operations.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_OVERWORLD_ENTITY_OPERATIONS_H
#define YAZE_APP_EDITOR_OVERWORLD_ENTITY_OPERATIONS_H
 
#include <vector>
 
#include "absl/status/status.h"
#include "absl/status/statusor.h"
#include "imgui/imgui.h"
#include "zelda3/overworld/overworld.h"
#include "zelda3/overworld/overworld_entrance.h"
#include "zelda3/overworld/overworld_exit.h"
#include "zelda3/overworld/overworld_item.h"
#include "zelda3/sprite/sprite.h"
 
namespace yaze {
namespace editor {
 
// Build an existing table row's complete serialized value before mutating it.
// The row is explicit: entrance IDs and return rooms are not unique identities.
// Maps must already be present in the owning model; this does not admit or
// allocate a project terrain map, entrance slot, or return row.
absl::StatusOr<zelda3::OverworldEntrance> BuildOverworldEntranceEdit(
    const zelda3::Overworld& overworld,
    const std::vector<zelda3::OverworldEntrance>& records, size_t row,
    const zelda3::OverworldEntrance& draft, bool legacy_hole_table = false);
absl::StatusOr<zelda3::OverworldExit> BuildOverworldExitEdit(
    const zelda3::Overworld& overworld,
    const std::vector<zelda3::OverworldExit>& records, size_t row,
    const zelda3::OverworldExit& draft);
 
absl::StatusOr<zelda3::OverworldEntrance*> InsertEntrance(
    zelda3::Overworld* overworld, ImVec2 mouse_pos, int current_map,
    bool is_hole = false);
 
absl::StatusOr<zelda3::OverworldExit*> InsertExit(zelda3::Overworld* overworld,
                                                  ImVec2 mouse_pos,
                                                  int current_map);
 
absl::StatusOr<zelda3::Sprite*> InsertSprite(zelda3::Overworld* overworld,
                                             ImVec2 mouse_pos, int current_map,
                                             int game_state,
                                             uint8_t sprite_id = 0);
 
absl::StatusOr<zelda3::OverworldItem*> InsertItem(zelda3::Overworld* overworld,
                                                  ImVec2 mouse_pos,
                                                  int current_map,
                                                  uint8_t item_id = 0);
 
// Construct insertion values from the authored map domain without mutating it.
// current_map identifies the physical 512-pixel screen under world_position;
// the resulting entity belongs to that screen's parent and uses parent-relative
// game coordinates. InsertItem/InsertSprite additionally require a loaded model.
absl::StatusOr<zelda3::OverworldItem> BuildOverworldItemForInsertion(
    const std::vector<zelda3::OverworldMap>& maps, ImVec2 world_position,
    int current_map, uint8_t item_id);
absl::StatusOr<zelda3::Sprite> BuildOverworldSpriteForInsertion(
    const std::vector<zelda3::OverworldMap>& maps, ImVec2 world_position,
    int current_map, uint8_t sprite_id);
 
absl::Status RemoveItem(zelda3::Overworld* overworld,
                        const zelda3::OverworldItem* item_ptr);
 
absl::Status RemoveItemByIdentity(zelda3::Overworld* overworld,
                                  const zelda3::OverworldItem& item_identity);
 
zelda3::OverworldItem* FindItemByIdentity(
    zelda3::Overworld* overworld, const zelda3::OverworldItem& item_identity);
 
absl::StatusOr<zelda3::OverworldItem*> DuplicateItemByIdentity(
    zelda3::Overworld* overworld, const zelda3::OverworldItem& item_identity,
    int offset_x = 16, int offset_y = 0);
 
absl::Status NudgeItem(zelda3::OverworldItem* item, int delta_x, int delta_y);
 
zelda3::OverworldItem* FindNearestItemForSelection(
    zelda3::Overworld* overworld, const zelda3::OverworldItem& anchor_identity);
 
inline uint8_t GetParentMapId(const zelda3::OverworldMap* map,
                              int current_map) {
  if (!map) {
    return static_cast<uint8_t>(current_map);
  }
  uint8_t parent = map->parent();
  return (parent == 0xFF) ? static_cast<uint8_t>(current_map) : parent;
}
 
inline ImVec2 SnapToEntityGrid(ImVec2 pos) {
  return ImVec2(static_cast<float>(static_cast<int>(pos.x / 16) * 16),
                static_cast<float>(static_cast<int>(pos.y / 16) * 16));
}
 
inline ImVec2 ClampToOverworldBounds(ImVec2 pos) {
  return ImVec2(std::clamp(pos.x, 0.0f, 4080.0f),  // 4096 - 16
                std::clamp(pos.y, 0.0f, 4080.0f));
}
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_OVERWORLD_ENTITY_OPERATIONS_H