Differences

This shows you the differences between two versions of the page.

--- rpd:line_of_sight [2025/12/20 03:24] – Update line_of_sight page with code references and technical details mike
+++ rpd:line_of_sight [2025/12/20 03:29] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Line of Sight ======
+**Line of Sight** is a fundamental game mechanic that determines what areas and entities the hero can see and interact with.
+==== Basic Concept ====
+  * Line of sight determines which tiles are visible to the hero
+  * The hero can typically see in a circular radius around their position
+  * Walls and other solid obstacles block line of sight
+  * Some effects can extend or restrict the hero's line of sight
+==== Applications ====
+  * **Movement**: The hero can only move to adjacent visible tiles
+  * **Ranged Attacks**: Ranged weapons require an unobstructed line of sight to the target
+  * **Spells**: Many spells require line of sight to affect targets
+  * **Detection**: Enemies and items are only visible when in line of sight
+==== Mechanics ====
+  * Light sources can affect line of sight in dark areas
+  * Some abilities or items can grant extended vision
+  * Darkness or fog effects can reduce line of sight
+  * Certain terrain features may block or redirect line of sight
+  * Implemented using the **ShadowCaster** class which calculates visibility from a central point
+==== Technical Implementation ====
+  * The game maintains a boolean array `fieldOfView` for each level which tracks visibility
+  * Uses ShadowCaster algorithm to determine visible cells from character position
+  * LOS blocking terrain is flagged using TerrainFlags.LOS_BLOCKING
+  * Level objects can also block line of sight with the `losBlocker()` method
+==== Code References ====
+  * Core implementation: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/mechanics/ShadowCaster.java|ShadowCaster.java]]
+  * Level visibility: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/levels/Level.java#L1488-L1525|updateFieldOfView in Level.java]]
+  * LOS blocking flags: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/levels/TerrainFlags.java#L8|TerrainFlags.java]]
+  * Level objects LOS: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/nyrds/pixeldungeon/levels/objects/Deco.java#L83|losBlocker method]]
+==== Related Pages ====
+  * [[rpd:range|Range]] - Distance mechanics for attacks
+  * [[rpd:ranged_weapons|Ranged Weapons]] - Weapons affected by line of sight
+  * [[rpd:spells|Spells]] - Many spells require line of sight
+  * [[rpd:light|Light]] - Related to visibility
+{{tag> rpd mechanics}}