RobustToolbox/Robust.Shared/Map/IMapGrid.cs

using System;
using System.Collections.Generic;
using JetBrains.Annotations;
using Robust.Shared.GameObjects;
using Robust.Shared.Maths;

namespace Robust.Shared.Map
{
    /// <summary>
    ///     This is a collection of tiles in a grid format.
    /// </summary>
    [PublicAPI]
    public interface IMapGrid
    {
        /// <summary>
        ///     The integer ID of the map this grid is currently located within.
        /// </summary>
        MapId ParentMapId { get; set; }

        /// <summary>
        /// The entity this grid is represented by in the ECS system.
        /// </summary>
        EntityUid GridEntityId { get; }

        /// <summary>
        ///     The identifier of this grid.
        /// </summary>
        GridId Index { get; }

        /// <summary>
        ///     The length of the side of a square tile in world units.
        /// </summary>
        ushort TileSize { get; }

        /// <summary>
        ///     The bounding box of the grid in world coordinates.
        /// </summary>
        Box2 WorldBounds { get; }

        /// <summary>
        ///     The bounding box of the grid in local coordinates.
        /// </summary>
        Box2 LocalBounds { get; }

        /// <summary>
        ///     The length of a side of the square chunk in number of tiles.
        /// </summary>
        ushort ChunkSize { get; }

        /// <summary>
        ///     The origin of the grid in world coordinates. Make sure to set this!
        /// </summary>
        Vector2 WorldPosition { get; set; }

        /// <summary>
        ///     The rotation of the grid in world terms.
        /// </summary>
        Angle WorldRotation { get; set; }

        Matrix3 WorldMatrix { get; }

        Matrix3 InvWorldMatrix { get; }

        #region TileAccess

        /// <summary>
        ///     Gets a tile a the given world coordinates. This will not create a new chunk.
        /// </summary>
        /// <param name="coords">The location of the tile in coordinates.</param>
        /// <returns>The tile at the world coordinates.</returns>
        TileRef GetTileRef(MapCoordinates coords);

        /// <summary>
        ///     Gets a tile a the given world coordinates. This will not create a new chunk.
        /// </summary>
        /// <param name="coords">The location of the tile in coordinates.</param>
        /// <returns>The tile at the world coordinates.</returns>
        TileRef GetTileRef(EntityCoordinates coords);

        /// <summary>
        ///     Gets a tile a the given grid indices. This will not create a new chunk.
        /// </summary>
        /// <param name="tileCoordinates">The location of the tile in coordinates.</param>
        /// <returns>The tile at the tile coordinates.</returns>
        TileRef GetTileRef(Vector2i tileCoordinates);

        /// <summary>
        ///     Returns all tiles in the grid, in row-major order [xTileIndex, yTileIndex].
        /// </summary>
        /// <returns>All tiles in the chunk.</returns>
        IEnumerable<TileRef> GetAllTiles(bool ignoreSpace = true);

        /// <summary>
        ///     Replaces a single tile inside of the grid.
        /// </summary>
        /// <param name="coords"></param>
        /// <param name="tile">The tile to insert at the coordinates.</param>
        void SetTile(EntityCoordinates coords, Tile tile);

        /// <summary>
        ///     Modifies a single tile inside of the chunk.
        /// </summary>
        /// <param name="gridIndices"></param>
        /// <param name="tile">The tile to insert at the coordinates.</param>
        void SetTile(Vector2i gridIndices, Tile tile);

        /// <summary>
        ///     Modifies many tiles inside of a chunk. Avoids regenerating collision until the end.
        /// </summary>
        /// <param name="tiles"></param>
        void SetTiles(List<(Vector2i GridIndices, Tile Tile)> tiles);

        IEnumerable<TileRef> GetTilesIntersecting(Box2Rotated worldArea, bool ignoreEmpty = true, Predicate<TileRef>? predicate = null);

        /// <summary>
        ///     Returns all tiles inside the area that match the predicate.
        /// </summary>
        /// <param name="worldArea">An area in the world to search for tiles.</param>
        /// <param name="ignoreEmpty">Will empty tiles be returned?</param>
        /// <param name="predicate">Optional predicate to filter the files.</param>
        /// <returns></returns>
        IEnumerable<TileRef> GetTilesIntersecting(Box2 worldArea, bool ignoreEmpty = true, Predicate<TileRef>? predicate = null);

        IEnumerable<TileRef> GetTilesIntersecting(Circle worldArea, bool ignoreEmpty = true, Predicate<TileRef>? predicate = null);

        #endregion TileAccess

        #region SnapGridAccess

        IEnumerable<EntityUid> GetAnchoredEntities(MapCoordinates coords);
        IEnumerable<EntityUid> GetAnchoredEntities(EntityCoordinates coords);
        IEnumerable<EntityUid> GetAnchoredEntities(Vector2i pos);
        IEnumerable<EntityUid> GetAnchoredEntities(Box2 worldAABB);
        IEnumerable<EntityUid> GetAnchoredEntities(Box2Rotated worldBounds);

        // Struct enumerators
        AnchoredEntitiesEnumerator GetAnchoredEntitiesEnumerator(Vector2i pos);

        Vector2i TileIndicesFor(EntityCoordinates coords) => CoordinatesToTile(coords);
        Vector2i TileIndicesFor(MapCoordinates worldPos) => CoordinatesToTile(MapToGrid(worldPos));
        Vector2i TileIndicesFor(Vector2 worldPos) => WorldToTile(worldPos);

        bool AddToSnapGridCell(Vector2i pos, EntityUid euid);
        bool AddToSnapGridCell(EntityCoordinates coords, EntityUid euid);
        void RemoveFromSnapGridCell(Vector2i pos, EntityUid euid);
        void RemoveFromSnapGridCell(EntityCoordinates coords, EntityUid euid);

        /// <summary>
        ///     Returns an enumerable over all the entities which are one tile over in a certain direction.
        /// </summary>
        IEnumerable<EntityUid> GetInDir(EntityCoordinates position, Direction dir);
        IEnumerable<EntityUid> GetOffset(EntityCoordinates coords, Vector2i offset);
        IEnumerable<EntityUid> GetLocal(EntityCoordinates coords);
        EntityCoordinates DirectionToGrid(EntityCoordinates coords, Direction direction);
        IEnumerable<EntityUid> GetCardinalNeighborCells(EntityCoordinates coords);
        IEnumerable<EntityUid> GetCellsInSquareArea(EntityCoordinates coords, int n);

        #endregion SnapGridAccess

        #region Transforms

        /// <summary>
        ///     Transforms EntityCoordinates to a local tile location.
        /// </summary>
        /// <param name="coords"></param>
        /// <returns></returns>
        Vector2i CoordinatesToTile(EntityCoordinates coords);

        /// <summary>
        ///     Transforms world-space coordinates from the global origin to the grid local origin.
        /// </summary>
        /// <param name="posWorld">The world-space coordinates with global origin.</param>
        /// <returns>The world-space coordinates with local origin.</returns>
        Vector2 WorldToLocal(Vector2 posWorld);

        /// <summary>
        /// Transforms map coordinates to grid coordinates.
        /// </summary>
        EntityCoordinates MapToGrid(MapCoordinates posWorld);

        /// <summary>
        ///     Transforms local vectors into world space vectors
        /// </summary>
        /// <param name="posLocal">The local vector with this grid as origin.</param>
        /// <returns>The world-space vector with global origin.</returns>
        Vector2 LocalToWorld(Vector2 posLocal);

        /// <summary>
        ///     Transforms World position into grid tile indices.
        /// </summary>
        /// <param name="posWorld">Position in the world.</param>
        /// <returns>Indices of a tile on the grid.</returns>
        Vector2i WorldToTile(Vector2 posWorld);

        /// <summary>
        ///     Transforms grid-space tile indices to local coordinates.
        ///     The resulting coordinates are centered on the tile.
        /// </summary>
        /// <param name="gridTile"></param>
        /// <returns></returns>
        EntityCoordinates GridTileToLocal(Vector2i gridTile);

        /// <summary>
        ///     Transforms grid-space tile indices to map coordinate position.
        ///     The resulting coordinates are centered on the tile.
        /// </summary>
        Vector2 GridTileToWorldPos(Vector2i gridTile);

        /// <summary>
        ///     Transforms grid-space tile indices to map coordinates.
        ///     The resulting coordinates are centered on the tile.
        /// </summary>
        MapCoordinates GridTileToWorld(Vector2i gridTile);

        /// <summary>
        ///     Transforms grid indices into a tile reference, returns false if no tile is found.
        /// </summary>
        /// <param name="indices">The Grid Tile indices.</param>
        /// <param name="tile"></param>
        /// <returns></returns>
        bool TryGetTileRef(Vector2i indices, out TileRef tile);

        /// <summary>
        ///     Transforms coordinates into a tile reference, returns false if no tile is found.
        /// </summary>
        /// <param name="coords">The coordinates.</param>
        /// <param name="tile"></param>
        /// <returns></returns>
        bool TryGetTileRef(EntityCoordinates coords, out TileRef tile);

        /// <summary>
        ///     Transforms a world position into a tile reference, returns false if no tile is found.
        /// </summary>
        bool TryGetTileRef(Vector2 worldPos, out TileRef tile);

        /// <summary>
        /// Transforms grid tile indices to chunk indices.
        /// </summary>
        Vector2i GridTileToChunkIndices(Vector2i gridTile);

        /// <summary>
        /// Transforms EntityCoordinates to chunk indices relative to grid origin.
        /// </summary>
        Vector2i LocalToChunkIndices(EntityCoordinates gridPos);

        Vector2 LocalToGrid(EntityCoordinates position);

        #endregion Transforms

        #region Collision

        bool CollidesWithGrid(Vector2i indices);

        #endregion
    }
}