Added SearchLocation() to API

master
Mohammad Shoaib 2022-05-01 14:26:08 +05:30
parent 6acfb4ff4e
commit ce69a5ad98
1 changed files with 23 additions and 5 deletions

View File

@ -16,13 +16,13 @@ namespace stardew_access.ScreenReader
/// <param name="center">The starting point.</param> /// <param name="center">The starting point.</param>
/// <param name="limit">The limiting factor or simply radius of the search area.</param> /// <param name="limit">The limiting factor or simply radius of the search area.</param>
/// <returns>A dictionary with all the detected tiles along with the name of the object on it and it's category.</returns> /// <returns>A dictionary with all the detected tiles along with the name of the object on it and it's category.</returns>
public Dictionary<Vector2, (string, string)> SearchNearbyTiles(Vector2 center, int limit) public Dictionary<Vector2, (string name, string category)> SearchNearbyTiles(Vector2 center, int limit)
{ {
/* /*
* How to use the Dictionary to get the name and category of a tile:- * How to use the Dictionary to get the name and category of a tile:-
* *
* string? objectName = detectedTiles.GetValueOrDefault(center).Item1; * string tileName = detectedTiles.GetValueOrDefault(tilePosition).name;
* string? objectCategory = detectedTiles.GetValueOrDefault(center).Item2; * string tileCategory = detectedTiles.GetValueOrDefault(tilePosition).category;
* *
* Here detectedTiles is the Dictionary returned by this method * Here detectedTiles is the Dictionary returned by this method
*/ */
@ -30,12 +30,30 @@ namespace stardew_access.ScreenReader
return new Radar().SearchNearbyTiles(center, limit, false); return new Radar().SearchNearbyTiles(center, limit, false);
} }
/// <summary>
/// Search the entire location using Breadth First Search algorithm(BFS).
/// </summary>
/// <returns>A dictionary with all the detected tiles along with the name of the object on it and it's category.</returns>
public Dictionary<Vector2, (string name, string category)> SearchLocation()
{
/*
* How to use the Dictionary to get the name and category of a tile:-
*
* string tileName = detectedTiles.GetValueOrDefault(tilePosition).name;
* string tileCategory = detectedTiles.GetValueOrDefault(tilePosition).category;
*
* Here detectedTiles is the Dictionary returned by this method
*/
return new Radar().SearchLocation();
}
/// <summary> /// <summary>
/// Check the tile for any object /// Check the tile for any object
/// </summary> /// </summary>
/// <param name="tile">The tile where we want to check the name and category of object if any</param> /// <param name="tile">The tile where we want to check the name and category of object if any</param>
/// <returns>Name of the object as the first item (Item1) and category as the second item (Item2). Returns null if no object found.</returns> /// <returns>Name of the object as the first item (name) and category as the second item (category). Returns null if no object found.</returns>
public (string?, string?) GetNameWithCategoryNameAtTile(Vector2 tile) public (string? name, string? category) GetNameWithCategoryNameAtTile(Vector2 tile)
{ {
return TileInfo.getNameWithCategoryNameAtTile(tile); return TileInfo.getNameWithCategoryNameAtTile(tile);
} }