Function ClearLOT

TombEngine/Game/control/lot.cpp:406–425

* @brief Resets the LOT pathfinding state for a new search. * * Clears the search queue (Head/Tail) and resets all node data. Must be called * before starting a new pathfinding search or when the creature's zone changes. * * The search uses a linked-list queue structure: * - Head: First box to expand in the search. * - Tail: Last box in the expansion queue. * - Each node's nextExpansion li

 * @param LOT Pointer to the LOTInfo structure to clear.
 */
void ClearLOT(LOTInfo* LOT)
{
	// Clear the BFS queue pointers.
	LOT->Head = NO_VALUE;  // First box to expand (front of queue).
	LOT->Tail = NO_VALUE;  // Last box in queue (for appending).

	// Reset search state.
	LOT->SearchNumber = 0;   // Incremented each new search to invalidate old data.
	LOT->TargetBox = NO_VALUE;    // The box we're pathfinding TO.
	LOT->RequiredBox = NO_VALUE;  // The box we WANT to pathfind to (triggers recalc).

	// Reset all node data.
	auto* node = LOT->Node.data();
	for (auto& node : LOT->Node)
	{
		node.exitBox = NO_VALUE;       // Direction to target (filled by SearchLOT).
		node.nextExpansion = NO_VALUE; // Next node in BFS queue.
		node.searchNumber = 0;         // Which search this node was visited in.
	}
}

/**
 * @brief Creates the navigable zone for a creature based on its starting position.