Game.LambdaHack.Common.Tile

Operations concerning dungeon level tiles.

Unlike for many other content types, there is no type Tile, of particular concrete tiles in the dungeon, corresponding to TileKind (the type of kinds of terrain tiles). This is because the tiles are too numerous and there's not enough storage space for a well-rounded Tile type, on one hand, and on the other hand, tiles are accessed too often in performance critical code to try to compress their representation and/or recompute them. Instead, of defining a Tile type, we express various properties of concrete tiles by arrays or sparse EnumMaps, as appropriate.

Actors at normal speed (2 m/s) take one turn to move one tile (1 m by 1 m).

Documentation

type SmellTime = Time

The last time a hero left a smell in a given tile. To be used by monsters that hunt by smell.

kindHasFeature :: Feature -> TileKind -> Bool

Whether a tile kind has the given feature.

hasFeature :: Ops TileKind -> Feature -> Id TileKind -> Bool

Whether a tile kind (specified by its id) has the given feature.

isClear :: Ops TileKind -> Id TileKind -> Bool

Whether a tile does not block vision. Essential for efficiency of FOV, hence tabulated.

isLit :: Ops TileKind -> Id TileKind -> Bool

Whether a tile is lit on its own. Essential for efficiency of Perception, hence tabulated.

isWalkable :: Ops TileKind -> Id TileKind -> Bool

Whether actors can walk into a tile. Essential for efficiency of pathfinding, hence tabulated.

isPassableKind :: TileKind -> Bool

isPassable :: Ops TileKind -> Id TileKind -> Bool

Whether actors can walk into a tile, perhaps opening a door first, perhaps a hidden door. Essential for efficiency of pathfinding, hence tabulated.

isDoor :: Ops TileKind -> Id TileKind -> Bool

Whether a tile is a door, open or closed. Essential for efficiency of pathfinding, hence tabulated.

isSuspect :: Ops TileKind -> Id TileKind -> Bool

Whether a tile is suspect. Essential for efficiency of pathfinding, hence tabulated.

isExplorable :: Ops TileKind -> Id TileKind -> Bool

Whether one can easily explore a tile, possibly finding a treasure or a clue. Doors can't be explorable since revealing a secret tile should not change it's (walkable and) explorable status. Door status should not depend on whether they are open or not so that a foe opening a door doesn't force us to backtrack to explore it.

lookSimilar :: TileKind -> TileKind -> Bool

The player can't tell one tile from the other.

speedup :: Bool -> Ops TileKind -> TileSpeedup

openTo :: Ops TileKind -> Id TileKind -> Rnd (Id TileKind)

closeTo :: Ops TileKind -> Id TileKind -> Rnd (Id TileKind)

causeEffects :: Ops TileKind -> Id TileKind -> [Effect Int]

revealAs :: Ops TileKind -> Id TileKind -> Rnd (Id TileKind)

hideAs :: Ops TileKind -> Id TileKind -> Id TileKind

isOpenable :: Ops TileKind -> Id TileKind -> Bool

Whether a tile kind (specified by its id) has an OpenTo feature.

isClosable :: Ops TileKind -> Id TileKind -> Bool

Whether a tile kind (specified by its id) has a CloseTo feature.

isChangeable :: Ops TileKind -> Id TileKind -> Bool

Whether a tile kind (specified by its id) has a ChangeTo feature. Essential for efficiency of pathfinding, hence tabulated.

isEscape :: Ops TileKind -> Id TileKind -> Bool

isStair :: Ops TileKind -> Id TileKind -> Bool

data TileSpeedup

Constructors

TileSpeedup

Fields

isClearTab :: !Tab

isLitTab :: !Tab

isWalkableTab :: !Tab

isPassableTab :: !Tab

isDoorTab :: !Tab

isSuspectTab :: !Tab

isChangeableTab :: !Tab

data Tab

createTab :: Ops TileKind -> (TileKind -> Bool) -> Tab

accessTab :: Tab -> Id TileKind -> Bool