# Line of Sight - Tobias Downer

From RogueBasin

Line of Sight - Tobias Downer [toby atsign iglou dot com].txt This article describes my observation of existing line of sight systems in roguelike games, and details the method I adopted for my own experimental engine. Early LOS (Moria) -=-=-=-=-=-=-=-=-=- When I first played Moria on my friends Amiga in 1990, I was instantly hooked on roguelikes. Dungeon exploration was one of the main 'hook factors'. As the player moved around the dungeon, a new part would light up revealing a little bit more. You really didn't know what would be around the next corner, or how the dungeon terrain would turn out. Compared to more recent roguelikes, Moria uses very simple line of sight determination. The players light source can only extend 1 grid square around the player. When a player enters a room that is lit, the entire room appears and is memorised by the player. Determining whether a monster is visible is handled by tracing a line from the monster to the player. If a line can be traced without intersecting any wall grids, the monster is visible. There is one rather large bottleneck in this system. It is required that for each monster that _may_ be visible, that a line is traced. For a map with high concentrations of monsters (such as spawning worms), this leads to poor performance. For most cases however, the line of sight system in Moria is fast and effective. Moria was written in the second half of the 80's so it needed to be. With the increase of processor speeds and compiler technology, newer roguelikes have refined the LOS process further to create more realistic engines. A more realistic LOS (Angband) -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= In most recent roguelikes, the line of sight code has extended to encompass a 'field of view'. An easy way to visualise this, is to imagine a light source emitting rays of light up tp a given radius. Every grid that is hit by a ray from the light is flagged as visible. However some grid squares may be in shadow of the light source. The diagram below shows a simple example of this. %%%%%%%%%%%%%%% %%%%%%%%%%%%%%% Key: %% %%%%%%% %#... %%%%%%% @ Light source %#......####### # Wall hit by ray from light %#.......@..... % Wall in shadow %#......####### . Floor hit by ray from light %#... %%%%%%% Floor in shadow (blank) %% %%%%%%% %%%%%%%%%%%%%%% %%%%%%%%%%%%%%% There are several advantages to implementing such a system. If a grid 'knows' about any monsters that are standing on it, as well as flagging grids as visible, we can also flag all the monsters that are in line of sight of the player. We no longer need to do an expensive line trace between monster and player to determine monster visibility. It also allows us to incorporate nice visual effects such as fading out the areas of the map that are in the players memory but not directly visible. How do we go about writing such as routine? -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- For simplicity, lets say we have a field of view with a radius of 6 grids. One approach would be to trace a line between the light to every edge of the field of view. If we simplify this process a little, lets say our field of view is a square with the light source at coordinates (0, 0). The diagrams below shows the first three iterations of this method. 1st Iteration: Trace line between (0, 0) and (6, 0) +-----+-----+ | | | | | | | | | | | | + @****** | | | | | | | | | | | | +-----+-----+ 2nd Iteration: Trace line between (0, 0) and (6, 1) +-----+-----+ | | | | | | | | | | | | + @*** + | *** | | | | | | | | | | +-----+-----+ 3rd Iteration: Trace line between (0, 0) and (6, 2) +-----+-----+ | | | | | | | | | | | | + @** + | ** | | ** | | | | | | | | +-----+-----+ If any line trace hits a wall then the trace is finished and a new trace is started. Every grid that the line intersects is marked as visible. Implementing such a routine is very easy. I won't go into how to walk along a line here. Look up existing line drawing routines or work it out yourself. One thing to avoid is using floating point numbers - keep all calculations in the inner loop as integers. One point to note here. When you are tracing a line, you must be careful that you are checking _every_ grid that the line is going through. This is a little more involved than you may at first realise. Consider the following diagram. 0 1 2 +---+---+---+ | | | | 0 | @ | | | | *| | | +--*+---+---+ | * | | 1 | |* | | | |* | | +---+-*-+---+ | | *| | 2 | | *| | | | * | +---+---+*--+ The line travels through grids (0, 1), (1, 1), (1, 2) and (2, 2). It we were to walk the line at intervals of 1 unit along the y axis, we would miss the intersection with grid (0, 1) and (2, 2). To solve this, we actually need to walk the line at intervals of .5 units. This simple method outlines the basic approach for achieving line of sight determination. However if you were to use it, you will find the performance very poor. Let me explain the reasons why. Say we have a radius of 25 grids. A walk from the centre to the field of view edge, assuming no wall intersections, will take 50 iterations (walking at .5 units). There are a total of 50 grids on each of the 4 edges therefore the total number of iterations will be (50 * 4) * 50 = 10000 assuming no wall intersections. There are a total of 2600 grids (not including the centre grid) in our field of view. That means the algorithm is checking almost four times as many grids as there are in the field of view! Obviously, we need to find a way to optimise the performance so that a smaller number of grids need to be checked. For my own experimental engine, I used the following method. It is almost identical to the algorithm first suggested and implemented in Angband 2.8.3. A better performance LOS (Angband 2.8.3) =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- The most obvious way of optimising the performance is to subdivide the field of view and concentrate our optimisation on just one section. We can then mirror the process in all the other sections. If we subdivide the field of view into eight, we create 8 octant triangles as shown in the diagram below. For simplicity, I'm assuming a square field of view. The octants are numbered 0 to 7 and proceed clockwise around the light source. Each octant has shared edges with two other octants. +------+------+ |\ | /| | \ 5 | 6 / | | \ | / | | \ | / | | 4 \ | / 7 | | \|/ | +------@------+ | /|\ | | 3 / | \ 0 | | / | \ | | / | \ | | / 2 | 1 \ | |/ | \| +------+------+ If we optimise our algorithm to work only for octant 0, we can easily swap x and y, and change the signs of the terms to reflect on any of the other 7 octants. For example, walking through x in octant 0 is the same as walking across -x in octant 3 or 4, across -y in octant 5 or 6, and across y in octant 1 or 2. The second rule of optimisation is to pre-compute as much as you can and that memory allows. Since we only need to process 1/8th of our field of view, we have decreased the amount of memory required to store our lookup tables. Remember we used the analogy of a light source emitting rays of light? If we pre-calculated every ray of light that travels through the octant, and also find the rays of light that are blocked if a given grid is a wall. At runtime, we can scan through the octant grid, moving away from the light source, lighting up the grids that have at least one ray of light hitting them. Any grids that represent a wall will flag the rays that hit the grid as blocked, thereby putting others in shadow. The following diagram (hopefully) demonstrates this principle. 0 1 2 3 4 +-------+-------+-------+-------+-------+ | | | | | | | | | | | | | | | | | | 0 | @11 | | | | | | 65322221111111 | | | | 65333 22222 11111111111 | | | 6|54333 |22222 | 11111111 | +-------6-55--333#####22222-----+#####111 |6 554 #333 # 22222# # | 6 5444 333 # 22222 # | 6 55 444 333 # 2222 1 | 6 #55 44 # 333 # # | 6 # 5 44 333# # | 6 # 55 #444 333 # | 6# 55# 444 # 333 # +-------6#######5------444####333 |6 |55 | 44 | | 6 | 55 | 444 | | 6 | 5 | 44 2 | 6 | 55| | | 6 | 55 | | 6 | | 5 | | 6| | 55 | +-------6-------+----55-+ The diagram shows the pre-computation of 6 rays of light where each line (except 1) intersects the grid at (2, 1). Lines 2 and 6 'brush' past the corners of the grid, and lines 3, 4 and 5 travel through the middle of the grid. Because there is a wall at grid (2, 1), lines 3, 4 and 5 would be flagged as 'blocked'. This means no rays are able to hit grid (3, 2) or (4, 2) thus putting them in shadow. If we pre-calculate each line to every grid corner in an octant discarding any identical lines, and sort into a list, we produce a list of all unique lines sorted from the horizontal to the diagonal of the octant. We can then pre-calculate a lookup table for each grid square in the octant, and store the range of rays that are blocked if the given grid is a wall. For example, in the above diagram the grid at (2, 1) would block all rays between 2 and 6. The grid at (4, 1) would block all rays between 1 and 4. We can store the list of rays in a bit vector, or boolean array. If a wall grid is found, we simply flag the bits between the outer bounds of the given grid as blocked. A similar test can be used to determine if an unblocked ray hits a grid. Simply test each bit in the vector between the two outer corners, if an unblocked bit is found then the grid is visible. This method is very fast since it requires most grids to be scanned only once. The exception is along the horizontal, vertical and diagonal which are shared between two octants. These grids need to be scanned twice, once by each shared octant. It is easy to adapt the algorithm to produce a circular field of view as opposed to a square field of view. Simply use the Pythagorean theorem to determine if a given coordinate (x, y) is within the radius; (x * x) + (y * y) < (radius * radius) Angband uses an octagonal field of view; max(x, y) + (min(x, y) / 2) <= radius We could also use this algorithm to determine if a given grid is visible from another. There are two ways of doing this. Find the octant the destination grid is in relative to the source. Then do the 'blocking ray' method described above. When we reach the destination grid, if no rays are hitting it, its not visible. The second method is to find the destination grid, and for each ray that intersects the grid, trace a line from the source. If one of the traced rays hits the grid without intersecting a wall, the grid is visible. Performance =-=-=-=-=-=-= I implemented this algorithm in Java and used a radius of 25 grids with a circular field of view. It performed particularly well when there were only a few wall grids, or if the source was enclosed by many wall grids. It didn't perform so well between these extremes. However on my P120, the worse case tested speed was 5 ms (200 a second). Acknowledgments =-=-=-=-=-=-=-=-= For a more detailed description of this method, download the Angband 2.8.3 source and look in the file 'cave.c'. Thanks go to Mat Hostetter and Ben Harrison for developing and implementing the algorithm. If you have any questions about this article, feel free to email me at geoffd@iglou.com.