Handles door placement and interaction in the dungeon editor. More...

#include <door_interaction_handler.h>

Inheritance diagram for yaze::editor::DoorInteractionHandler:

Collaboration diagram for yaze::editor::DoorInteractionHandler:

[legend]

Public Types
enum class	PlacementBlockReason { kNone = 0 , kInvalidRoom , kDoorLimit , kInvalidPosition }

Public Member Functions
void	BeginPlacement () override
	Begin placement mode.

void	CancelPlacement () override
	Cancel current placement.

bool	IsPlacementActive () const override
	Check if placement mode is active.

bool	HandleClick (int canvas_x, int canvas_y) override
	Handle mouse click at canvas position.

void	HandleDrag (ImVec2 current_pos, ImVec2 delta) override
	Handle mouse drag.

void	HandleRelease () override
	Handle mouse release.

void	DrawGhostPreview () override
	Draw ghost preview during placement.

void	DrawSelectionHighlight () override
	Draw selection highlight for selected entities.

std::optional< size_t >	GetEntityAtPosition (int canvas_x, int canvas_y) const override
	Get entity at canvas position.

void	SetDoorType (zelda3::DoorType type)
	Set door type for placement.

zelda3::DoorType	GetDoorType () const
	Get current door type for placement.

void	DrawSnapIndicators ()
	Draw snap position indicators during door drag.

void	SelectDoor (size_t index)
	Select door at index.

void	ClearSelection ()
	Clear door selection.

bool	HasSelection () const
	Check if a door is selected.

std::optional< size_t >	GetSelectedIndex () const
	Get selected door index.

void	DeleteSelected ()
	Delete selected door.

bool	was_placement_blocked () const
	True if the most recent PlaceDoorAtSnappedPosition was blocked.

PlacementBlockReason	placement_block_reason () const

void	clear_placement_blocked ()

Public Member Functions inherited from yaze::editor::BaseEntityHandler
virtual	~BaseEntityHandler ()=default

void	SetContext (InteractionContext *ctx)
	Set the interaction context.

InteractionContext *	context () const
	Get the interaction context.

virtual bool	HandleMouseWheel (float delta)

void	DrawPostPlacementToast ()

Private Member Functions
void	PlaceDoorAtSnappedPosition (int canvas_x, int canvas_y)
	Place door at snapped position.

bool	UpdateSnappedPosition (int canvas_x, int canvas_y)
	Update snapped position based on cursor.

Private Attributes
bool	door_placement_mode_ = false

PlacementBlockReason	placement_block_reason_ = PlacementBlockReason::kNone

zelda3::DoorType	preview_door_type_ = zelda3::DoorType::NormalDoor

zelda3::DoorDirection	detected_door_direction_ = zelda3::DoorDirection::North

uint8_t	snapped_door_position_ = 0

std::optional< size_t >	selected_door_index_

bool	is_dragging_ = false

ImVec2	drag_start_pos_

ImVec2	drag_current_pos_

Additional Inherited Members
Protected Member Functions inherited from yaze::editor::BaseEntityHandler
void	TriggerSuccessToast ()

void	DrawSuccessToastOverlay (const char *msg, ImU32 color) const

std::pair< int, int >	RoomToCanvas (int room_x, int room_y) const
	Convert room tile coordinates to canvas pixel coordinates.

std::pair< int, int >	CanvasToRoom (int canvas_x, int canvas_y) const
	Convert canvas pixel coordinates to room tile coordinates.

bool	IsWithinBounds (int canvas_x, int canvas_y) const
	Check if coordinates are within room bounds.

ImVec2	GetCanvasZeroPoint () const
	Get canvas zero point (for screen coordinate conversion)

float	GetCanvasScale () const
	Get canvas global scale.

bool	HasValidContext () const
	Check if context is valid.

zelda3::Room *	GetCurrentRoom () const
	Get current room (convenience method)

Protected Attributes inherited from yaze::editor::BaseEntityHandler
InteractionContext *	ctx_ = nullptr

float	toast_expire_time_ = 0.0f

Static Protected Attributes inherited from yaze::editor::BaseEntityHandler
static constexpr float	kToastDuration = 1.5f

Detailed Description

Handles door placement and interaction in the dungeon editor.

Doors snap to valid wall positions and have automatic direction detection based on which wall the cursor is near.

Definition at line 18 of file door_interaction_handler.h.

Member Enumeration Documentation

◆ PlacementBlockReason

enum class yaze::editor::DoorInteractionHandler::PlacementBlockReason

strong

Enumerator
kNone
kInvalidRoom
kDoorLimit
kInvalidPosition

Definition at line 20 of file door_interaction_handler.h.

Member Function Documentation

◆ BeginPlacement()

void yaze::editor::DoorInteractionHandler::BeginPlacement ( )

overridevirtual

Begin placement mode.

Called when user selects an entity to place from the palette. Override to initialize placement state.

Implements yaze::editor::BaseEntityHandler.

Definition at line 13 of file door_interaction_handler.cc.

References ClearSelection(), and door_placement_mode_.

Referenced by yaze::editor::InteractionCoordinator::SetMode().

Here is the call graph for this function:

◆ CancelPlacement()

void yaze::editor::DoorInteractionHandler::CancelPlacement ( )

overridevirtual

Cancel current placement.

Called when user presses Escape or switches modes. Override to clean up placement state.

Implements yaze::editor::BaseEntityHandler.

Definition at line 18 of file door_interaction_handler.cc.

References detected_door_direction_, door_placement_mode_, yaze::zelda3::North, and snapped_door_position_.

Referenced by yaze::editor::InteractionCoordinator::CancelCurrentMode(), and yaze::editor::InteractionCoordinator::CancelPlacement().

◆ IsPlacementActive()

bool yaze::editor::DoorInteractionHandler::IsPlacementActive ( ) const

inlineoverridevirtual

Check if placement mode is active.

Implements yaze::editor::BaseEntityHandler.

Definition at line 33 of file door_interaction_handler.h.

References door_placement_mode_.

Referenced by yaze::editor::InteractionCoordinator::DrawGhostPreviews(), yaze::editor::InteractionCoordinator::DrawSelectionHighlights(), yaze::editor::InteractionCoordinator::HandleClick(), yaze::editor::InteractionCoordinator::HandleMouseWheel(), and yaze::editor::InteractionCoordinator::IsPlacementActive().

◆ HandleClick()

bool yaze::editor::DoorInteractionHandler::HandleClick	(	int	canvas_x,
		int	canvas_y )

overridevirtual

Handle mouse click at canvas position.

Parameters

canvas_x	Unscaled X position relative to canvas origin
canvas_y	Unscaled Y position relative to canvas origin

Returns: true if click was handled by this handler

Implements yaze::editor::BaseEntityHandler.

Definition at line 24 of file door_interaction_handler.cc.

References ClearSelection(), door_placement_mode_, drag_current_pos_, drag_start_pos_, GetEntityAtPosition(), yaze::editor::BaseEntityHandler::HasValidContext(), is_dragging_, PlaceDoorAtSnappedPosition(), and SelectDoor().

Referenced by yaze::editor::InteractionCoordinator::HandleClick(), and yaze::editor::InteractionCoordinator::TrySelectEntityAtCursor().

◆ HandleDrag()

void yaze::editor::DoorInteractionHandler::HandleDrag	(	ImVec2	current_pos,
		ImVec2	delta )

overridevirtual

Handle mouse drag.

Parameters

current_pos	Current mouse position (screen coords)
delta	Mouse movement since last frame

Implements yaze::editor::BaseEntityHandler.

Definition at line 47 of file door_interaction_handler.cc.

References drag_current_pos_, is_dragging_, and selected_door_index_.

Referenced by yaze::editor::InteractionCoordinator::HandleDrag().

◆ HandleRelease()

void yaze::editor::DoorInteractionHandler::HandleRelease ( )

overridevirtual

Handle mouse release.

Called when left mouse button is released after a drag.

Implements yaze::editor::BaseEntityHandler.

Definition at line 53 of file door_interaction_handler.cc.

References yaze::editor::BaseEntityHandler::ctx_, yaze::zelda3::DoorPositionManager::DetectWallFromPosition(), drag_current_pos_, yaze::editor::BaseEntityHandler::GetCurrentRoom(), is_dragging_, yaze::zelda3::DoorPositionManager::IsValidPosition(), yaze::editor::kDoors, yaze::editor::InteractionContext::NotifyInvalidateCache(), yaze::editor::InteractionContext::NotifyMutation(), selected_door_index_, and yaze::zelda3::DoorPositionManager::SnapToNearestPosition().

Referenced by yaze::editor::InteractionCoordinator::HandleRelease().

◆ DrawGhostPreview()

void yaze::editor::DoorInteractionHandler::DrawGhostPreview ( )

overridevirtual

Draw ghost preview during placement.

Called every frame when placement mode is active. Shows preview of entity at cursor position.

Implements yaze::editor::BaseEntityHandler.

Definition at line 97 of file door_interaction_handler.cc.

References yaze::editor::InteractionContext::canvas, yaze::editor::BaseEntityHandler::ctx_, detected_door_direction_, door_placement_mode_, yaze::editor::BaseEntityHandler::GetCanvasScale(), yaze::editor::BaseEntityHandler::GetCurrentRoom(), yaze::zelda3::GetDoorDimensions(), yaze::zelda3::GetDoorDirectionName(), yaze::zelda3::GetDoorTypeName(), yaze::editor::AgentUI::GetTheme(), yaze::editor::BaseEntityHandler::HasValidContext(), yaze::zelda3::kMaxDoors, yaze::zelda3::DoorPositionManager::PositionToTileCoords(), preview_door_type_, yaze::editor::BaseEntityHandler::RoomToCanvas(), snapped_door_position_, and UpdateSnappedPosition().

Referenced by yaze::editor::InteractionCoordinator::DrawGhostPreviews().

◆ DrawSelectionHighlight()

void yaze::editor::DoorInteractionHandler::DrawSelectionHighlight ( )

overridevirtual

Draw selection highlight for selected entities.

Called every frame to show selection state.

Implements yaze::editor::BaseEntityHandler.

Definition at line 187 of file door_interaction_handler.cc.

References yaze::zelda3::DoorPositionManager::DetectWallSection(), drag_current_pos_, DrawSnapIndicators(), yaze::editor::BaseEntityHandler::GetCanvasScale(), yaze::editor::BaseEntityHandler::GetCanvasZeroPoint(), yaze::editor::BaseEntityHandler::GetCurrentRoom(), yaze::zelda3::GetDoorDimensions(), yaze::editor::BaseEntityHandler::HasValidContext(), is_dragging_, yaze::zelda3::DoorPositionManager::PositionToTileCoords(), selected_door_index_, and yaze::zelda3::DoorPositionManager::SnapToNearestPosition().

Referenced by yaze::editor::InteractionCoordinator::DrawSelectionHighlights().

◆ GetEntityAtPosition()

std::optional< size_t > yaze::editor::DoorInteractionHandler::GetEntityAtPosition	(	int	canvas_x,
		int	canvas_y ) const

overridevirtual

Get entity at canvas position.

Parameters

canvas_x	Unscaled X position relative to canvas origin
canvas_y	Unscaled Y position relative to canvas origin

Returns: Entity index if found, nullopt otherwise

Implements yaze::editor::BaseEntityHandler.

Definition at line 250 of file door_interaction_handler.cc.

References yaze::editor::BaseEntityHandler::ctx_, yaze::editor::BaseEntityHandler::GetCanvasScale(), yaze::editor::InteractionContext::GetCurrentRoomConst(), yaze::zelda3::GetDoorDimensions(), and yaze::editor::BaseEntityHandler::HasValidContext().

Referenced by yaze::editor::InteractionCoordinator::GetEntityAtPosition(), and HandleClick().

Here is the call graph for this function:

◆ SetDoorType()

void yaze::editor::DoorInteractionHandler::SetDoorType ( zelda3::DoorType type )

inline

Set door type for placement.

Definition at line 52 of file door_interaction_handler.h.

References preview_door_type_.

◆ GetDoorType()

zelda3::DoorType yaze::editor::DoorInteractionHandler::GetDoorType ( ) const

inline

Get current door type for placement.

Definition at line 57 of file door_interaction_handler.h.

References preview_door_type_.

◆ DrawSnapIndicators()

void yaze::editor::DoorInteractionHandler::DrawSnapIndicators ( )

Draw snap position indicators during door drag.

Shows valid snap positions along the detected wall.

Definition at line 382 of file door_interaction_handler.cc.

References yaze::zelda3::DoorPositionManager::DetectWallSection(), drag_current_pos_, yaze::editor::BaseEntityHandler::GetCanvasScale(), yaze::editor::BaseEntityHandler::GetCanvasZeroPoint(), yaze::editor::BaseEntityHandler::GetCurrentRoom(), yaze::zelda3::GetDoorDimensions(), yaze::zelda3::DoorPositionManager::GetSectionStartPosition(), yaze::editor::AgentUI::GetTheme(), yaze::editor::BaseEntityHandler::HasValidContext(), is_dragging_, yaze::zelda3::kMaxDoors, yaze::zelda3::DoorPositionManager::PositionToTileCoords(), and yaze::zelda3::DoorPositionManager::SnapToNearestPosition().

Referenced by DrawSelectionHighlight(), and yaze::editor::InteractionCoordinator::DrawSelectionHighlights().

◆ SelectDoor()

void yaze::editor::DoorInteractionHandler::SelectDoor ( size_t index )

Select door at index.

Definition at line 283 of file door_interaction_handler.cc.

References yaze::editor::BaseEntityHandler::ctx_, yaze::editor::InteractionContext::NotifyEntityChanged(), and selected_door_index_.

Referenced by HandleClick(), and yaze::editor::InteractionCoordinator::SelectEntity().

Here is the call graph for this function:

◆ ClearSelection()

void yaze::editor::DoorInteractionHandler::ClearSelection ( )

Clear door selection.

Definition at line 288 of file door_interaction_handler.cc.

References is_dragging_, and selected_door_index_.

Referenced by BeginPlacement(), yaze::editor::InteractionCoordinator::ClearAllEntitySelections(), DeleteSelected(), and HandleClick().

◆ HasSelection()

bool yaze::editor::DoorInteractionHandler::HasSelection ( ) const

inline

Check if a door is selected.

Definition at line 79 of file door_interaction_handler.h.

References selected_door_index_.

Referenced by yaze::editor::InteractionCoordinator::DeleteSelectedEntity(), yaze::editor::InteractionCoordinator::DrawSelectionHighlights(), yaze::editor::InteractionCoordinator::GetSelectedEntityType(), yaze::editor::InteractionCoordinator::HandleDrag(), and yaze::editor::InteractionCoordinator::HasEntitySelection().

◆ GetSelectedIndex()

std::optional< size_t > yaze::editor::DoorInteractionHandler::GetSelectedIndex ( ) const

inline

Get selected door index.

Definition at line 84 of file door_interaction_handler.h.

References selected_door_index_.

Referenced by yaze::editor::InteractionCoordinator::GetSelectedEntity().

◆ DeleteSelected()

void yaze::editor::DoorInteractionHandler::DeleteSelected ( )

Delete selected door.

Definition at line 293 of file door_interaction_handler.cc.

References ClearSelection(), yaze::editor::BaseEntityHandler::ctx_, yaze::editor::BaseEntityHandler::GetCurrentRoom(), yaze::editor::BaseEntityHandler::HasValidContext(), yaze::editor::kDoors, yaze::editor::InteractionContext::NotifyInvalidateCache(), yaze::editor::InteractionContext::NotifyMutation(), and selected_door_index_.

Referenced by yaze::editor::InteractionCoordinator::DeleteSelectedEntity().

◆ was_placement_blocked()

bool yaze::editor::DoorInteractionHandler::was_placement_blocked ( ) const

inline

True if the most recent PlaceDoorAtSnappedPosition was blocked.

Definition at line 92 of file door_interaction_handler.h.

References kNone, and placement_block_reason_.

◆ placement_block_reason()

PlacementBlockReason yaze::editor::DoorInteractionHandler::placement_block_reason ( ) const

inline

Definition at line 95 of file door_interaction_handler.h.

References placement_block_reason_.

◆ clear_placement_blocked()

void yaze::editor::DoorInteractionHandler::clear_placement_blocked ( )

inline

Definition at line 98 of file door_interaction_handler.h.

References kNone, and placement_block_reason_.

◆ PlaceDoorAtSnappedPosition()

void yaze::editor::DoorInteractionHandler::PlaceDoorAtSnappedPosition	(	int	canvas_x,
		int	canvas_y )

private

Place door at snapped position.

Definition at line 309 of file door_interaction_handler.cc.

References yaze::zelda3::Room::Door::byte1, yaze::zelda3::Room::Door::byte2, yaze::editor::BaseEntityHandler::ctx_, yaze::zelda3::DoorPositionManager::DetectWallFromPosition(), yaze::zelda3::Room::Door::direction, yaze::zelda3::Room::Door::EncodeBytes(), yaze::editor::BaseEntityHandler::GetCurrentRoom(), yaze::editor::BaseEntityHandler::HasValidContext(), yaze::zelda3::DoorPositionManager::IsValidPosition(), kDoorLimit, yaze::editor::kDoors, kInvalidPosition, kInvalidRoom, yaze::zelda3::kMaxDoors, kNone, yaze::editor::InteractionContext::NotifyInvalidateCache(), yaze::editor::InteractionContext::NotifyMutation(), placement_block_reason_, yaze::zelda3::Room::Door::position, preview_door_type_, yaze::zelda3::DoorPositionManager::SnapToNearestPosition(), yaze::editor::BaseEntityHandler::TriggerSuccessToast(), and yaze::zelda3::Room::Door::type.

Referenced by HandleClick().

◆ UpdateSnappedPosition()

bool yaze::editor::DoorInteractionHandler::UpdateSnappedPosition	(	int	canvas_x,
		int	canvas_y )

private

Update snapped position based on cursor.

Definition at line 369 of file door_interaction_handler.cc.

References detected_door_direction_, yaze::zelda3::DoorPositionManager::DetectWallFromPosition(), snapped_door_position_, and yaze::zelda3::DoorPositionManager::SnapToNearestPosition().

Referenced by DrawGhostPreview().

Here is the call graph for this function:

Member Data Documentation

◆ door_placement_mode_

bool yaze::editor::DoorInteractionHandler::door_placement_mode_ = false

private

Definition at line 104 of file door_interaction_handler.h.

Referenced by BeginPlacement(), CancelPlacement(), DrawGhostPreview(), HandleClick(), and IsPlacementActive().

◆ placement_block_reason_

PlacementBlockReason yaze::editor::DoorInteractionHandler::placement_block_reason_ = PlacementBlockReason::kNone

private

Definition at line 105 of file door_interaction_handler.h.

Referenced by clear_placement_blocked(), PlaceDoorAtSnappedPosition(), placement_block_reason(), and was_placement_blocked().

◆ preview_door_type_

zelda3::DoorType yaze::editor::DoorInteractionHandler::preview_door_type_ = zelda3::DoorType::NormalDoor

private

Definition at line 106 of file door_interaction_handler.h.

Referenced by DrawGhostPreview(), GetDoorType(), PlaceDoorAtSnappedPosition(), and SetDoorType().

◆ detected_door_direction_

zelda3::DoorDirection yaze::editor::DoorInteractionHandler::detected_door_direction_ = zelda3::DoorDirection::North

private

Definition at line 107 of file door_interaction_handler.h.

Referenced by CancelPlacement(), DrawGhostPreview(), and UpdateSnappedPosition().

◆ snapped_door_position_

uint8_t yaze::editor::DoorInteractionHandler::snapped_door_position_ = 0

private

Definition at line 108 of file door_interaction_handler.h.

Referenced by CancelPlacement(), DrawGhostPreview(), and UpdateSnappedPosition().

◆ selected_door_index_

std::optional<size_t> yaze::editor::DoorInteractionHandler::selected_door_index_

private

Definition at line 111 of file door_interaction_handler.h.

Referenced by ClearSelection(), DeleteSelected(), DrawSelectionHighlight(), GetSelectedIndex(), HandleDrag(), HandleRelease(), HasSelection(), and SelectDoor().

◆ is_dragging_

bool yaze::editor::DoorInteractionHandler::is_dragging_ = false

private

Definition at line 112 of file door_interaction_handler.h.

Referenced by ClearSelection(), DrawSelectionHighlight(), DrawSnapIndicators(), HandleClick(), HandleDrag(), and HandleRelease().

◆ drag_start_pos_

ImVec2 yaze::editor::DoorInteractionHandler::drag_start_pos_

private

Definition at line 113 of file door_interaction_handler.h.

Referenced by HandleClick().

◆ drag_current_pos_

ImVec2 yaze::editor::DoorInteractionHandler::drag_current_pos_

private

Definition at line 114 of file door_interaction_handler.h.

Referenced by DrawSelectionHighlight(), DrawSnapIndicators(), HandleClick(), HandleDrag(), and HandleRelease().

The documentation for this class was generated from the following files:

src/app/editor/dungeon/interaction/door_interaction_handler.h
src/app/editor/dungeon/interaction/door_interaction_handler.cc

	yaze 0.3.2 Link to the Past ROM Editor

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ PlacementBlockReason

Member Function Documentation

◆ BeginPlacement()

◆ CancelPlacement()

◆ IsPlacementActive()

◆ HandleClick()

◆ HandleDrag()

◆ HandleRelease()

◆ DrawGhostPreview()

◆ DrawSelectionHighlight()

◆ GetEntityAtPosition()

◆ SetDoorType()

◆ GetDoorType()

◆ DrawSnapIndicators()

◆ SelectDoor()

◆ ClearSelection()

◆ HasSelection()

◆ GetSelectedIndex()

◆ DeleteSelected()

◆ was_placement_blocked()

◆ placement_block_reason()

◆ clear_placement_blocked()

◆ PlaceDoorAtSnappedPosition()

◆ UpdateSnappedPosition()

Member Data Documentation

◆ door_placement_mode_

◆ placement_block_reason_

◆ preview_door_type_

◆ detected_door_direction_

◆ snapped_door_position_

◆ selected_door_index_

◆ is_dragging_

◆ drag_start_pos_

◆ drag_current_pos_