Introduction to Vision Blocking

Languages: English • español • français • 日本語

BEGINNER
THIS IS A BEGINNER ARTICLE

Vision Blocking

In MapTool, tokens can be given sight, which lets the program model vision and lighting in-game. In other words, when you configure the token with vision, it can then "see" other tokens and areas of the map. In addition, MapTool provides for lighting - so a token can "see" only to the extent of its light source (or nearby light sources) - and Vision Blocking, which lets you establish boundaries to the token's visual range (so you can indicate where the walls are in a dungeon, for instance).

This introductory element will briefly review the Vision Blocking Layer tools in MapTool (sometimes also called topology tools), and how to use them to create a sample dungeon environment. Remember, Vision Blocking is intimately connected to the Sight, Light, and Fog of War features of MapTool, so once you've read this tutorial, go check out the Introduction to Lights and Sights and see how it all works together!

Not covered in this article is Token VBL.

First, Get a Map

File:samp-dungeon.png

Sample Dungeon

To start off, we'll need a map of a dungeon. Somewhere suitably subterranean and dank, full of twisty little passages, all alike.

Well, maybe we won't get too crazy with the mazes of twisty passages. Created using an awesome tileset created by Jonathan Roberts (Torstan on the RPTools Forums), the map shown to the right will be used for the examples in this introductory tutorial.

Activating the Vision Blocking Tools

The VBL tools, activated when you click on the VBL toolbar button

To activate the Vision Blocking Tools, click on the "Eye" icon in the MapTool toolbar. (eye icon screenshot). When you do so, a new set of buttons will appear - these are the various Vision Blocking drawing tools you can use. If you hover over them, a tooltip will pop up explaining what each one does. From left to right, they are:

Draw a Rectangular VBL: this creates solid rectangular areas that block vision (these are generally called Vision Blocking Layers, or "VBL" for short). . Tokens outside the area cannot see into it or through it; tokens inside the area cannot see anything at all (it is solid and opaque).
Draw a Hollow Rectangular VBL: this, as it implies, creates hollow VBL - if a token is inside the area, they will see everything inside it, but will not be able to see beyond the boundary; for tokens outside the VBL area, they will see everything outside, but cannot see into the rectangular area.
Draw a Circular VBL: like the rectangular one, this creates a circular (in reality, a polygon approximating a circular area; actual circular curves are performance-intensive!) VBL
Draw a Hollow Circular VBL: behaves like the hollow rectangle
Draw Closed Poly Line VBL: this lets you draw an arbitrary polygonal shape using line segments, and when finished, closes it and makes a solid VBL out of it. To start the polyline shape, left-click on the map, and draw the first segment. To attach the next segment, right-click and move the mouse to create the next line segment. When finished with the full shape, left-click to close it.
Draw Poly line VBL: as above, but creates a hollow polygon

Best Practices

Vision blocking and vision processing is processor-intensive, and overuse of (or overly-complex) VBL can cause serious performance issues with MapTool - slowdowns, inability to navigate a map, and so forth. Some rules of thumb:

Use square VBL wherever possible - and minimize the use of circular or highly irregular VBL
Use solid VBL wherever possible - this prevents gaps between polylines, which can be performance hogs. Instead, cover the map with VBL, and cut out the areas that the tokens should be able to see.
Use as little VBL as necessary to get the effect you seek - make it efficient!
It is frequently a good idea to set up a vision boundary at the edges of the play area on your map - maps in MapTool are theoretically infinitely sized, but if your tokens are going to be only in the dungeon area, there's no reason for MapTool to have to be calculating what they see all the way out to the edge of the universe.
- Setting the Vision Distance in the Map settings to less than the size of the map will also help.

These will help keep performance from bogging down. You can use the other kinds of VBL, but simply be aware of how complex your vision blocking setup is getting.

Putting VBL on the Sample Map

Now, to add some vision blocking to the map. We will use a recommended technique, which is to cover the entire map with a solid block of VBL, and then "cut out" of that block the areas that the players will see.

For an alternative method using Token VBL, check out the Adding VBL with a Mask tutorial.

Cover the Entire Dungeon with Solid VBL

Zooming out so the entire dungeon area is visible

Creating a block of solid VBL over the whole dungeon

Zoom the map so you can see the whole thing.
Select the Draw a Rectangular VBL button.
Left-Click to place the upper-left corner of the solid VBL. Do not hold down the left-mouse button.
Drag the mouse to define the size of the VBL. You'll see it traced out in a transparent red color as you drag.
Click the left mouse button again to place the lower-right corner of the VBL. The VBL will turn blue (if you go to the toolbar and select one of the other tools on the left side - switching off the VBL tools - the blue VBL indicators will disappear. They are only visible when the VBL tools are active).

The entire dungeon area covered by solid VBL

You've now covered the entire map with VBL. If a token was placed outside that area, and had a "sight" setting active, it would not be able to see into that area.

Cut out the Visible Areas from the Solid VBL

Erasing a section of VBL - hold down Ctrl to make the area snap to the map grid.

Now, we cut out the rooms. This process is a bit trickier - to keep the VBL efficient, make sure you get the edges lined up as best you can and you don't leave any narrow gaps or thin lines of VBL between rooms (a trick to doing this is in the instructions below). For this part, I will be clearing all VBL, out to the outer walls. We will work on the interior walls later.

Zoom the map until you are comfortable with the zoom level.
Select the Draw a Rectangular VBL tool.
Hold down the Shift key, and left-click to mark the upper-left corner of the area of VBL you want to erase. A white, transparent box will follow the mouse cursor (if it's not white, you forgot to hold shift!)
Drag the mouse until you've reached where you want the lower-right corner of the cleared area to be, and left-click. The blue VBL will disappear. You have now erased the VBL for that area, and tokens in that area would be able to see (their vision would be blocked, of course, once it reached any VBL!).
Repeat this process for the rest of the rooms, tunnels, and so forth.

The VBL is now erased over the dungeon rooms themselves.

Afterwards, you'll have a large blue area, with the dungeon "cut out" inside it.

TIP: if you hold down Ctrl while you trace your VBL, it will snap to the gridlines of the map. This is very useful for aligning VBL. I used this technique to erase the VBL on the sample map, because it makes the VBL align easily and squarely on the dungeon walls.

Interior VBL

Drawing VBL on the walls with the Poly Line VBL tool.

Finally, we will put VBL on the interior walls. This will make it so that the walls inside the dungeon block vision too.

Zoom the map to focus on a particular wall.
Select the "Draw Polyline VBL" tool.
Hold down Ctrl, and left-click on the map to place the beginning of the line segment. I recommend starting the line somewhere in the solid VBL, so that there are no gaps at the edges of the walls.
Drag the mouse to draw the line segment. (in the screenshot, the line segment is the thin red line inside the yellow circle; the yellow circle was drawn on the screenshot to show you where the polyline is - it's not part of the VBL process)
Left-click to place the end of the line segment. The red line will turn blue, indicating that there is VBL now on that wall.
Repeat the process for the other walls, until you are satisfied.

VBL and Objects

There are lots of objects in a dungeon that can block vision - doors, pillars, piles of rubble, chests...you name it. It is also possible to apply VBL directly to these objects using Token VBL. This means that you can, for instance, put VBL on a door and have it "open" with the door when your players open it.

If you don't want to configure Token VBL, for instance if your map image has objects directly on it but you haven't made them into tokens, you can also simulate object VBL by deleting the VBL that crossed the doorway. You'll have to experiment with the VBL for the objects in your dungeon, but here are some tips (these are apart from using Token VBL, which is an advanced topic):

Doors: for doors, if they are closed, simply draw the VBL along the wall in which the door sits. When (if) the door is ever opened, you can rotate the door object, and use Solid Rectangular VBL to erase the vision blocking layer that covered the doorway (remember, hold down Shift to erase VBL). Make sure to use solid VBL - if you use a hollow rectangle, it will only erase where the hollow rectangle's boundary intersects the other VBL.

An "X" drawn with VBL, typically used for pillars, statues, and similar objects

Pillars, statues, and standing objects: remember that, when you use VBL, the tokens cannot see into or through it at all (and, because of this, the players won't see anything covered by or hidden inside VBL on their screens). If you want the players to be able to see some of an object - like a large pillar - one of the recommended tricks is to draw an "X" on the pillar using poly line VBL (instead of covering the whole pillar with a circular or rectangular solid VBL. Using an X means that the players can see some of the pillar, depending on where their tokens are. It makes for a much nicer look. If you look at the screenshot, you'll see an "X" drawn using VBL on top of one of the barrels.

VBL Limitations

The Vision Blocking Layer in MapTool is a tool for helping to simulate what a character can see during a game. However, it does have limitations, and doesn't "completely simulate vision" or anything like that. We touched on one limitation earlier, the fact that VBL cannot be attached to specific objects, and so if you open a door that is covered by VBL - the door object might move, but the VBL stays put. Here are a couple other limitations of the current (as of MapTool 1.3.b56) Vision Blocking Tools.

Vision Blocking is Binary: VBL in MapTool is on or off. There is no "partially transparent" or "one way" VBL in the current version of MapTool.
Vision Blocking is Total: Related to the above, VBL blocks all forms of vision. There are no vision types currently that can see through VBL.
Vision Blocking has no Elevation: VBL cannot at this point be given a particular height - it stretches to infinity, up and down, and so there's no way to set up VBL so a tall character can see "over" it

Advanced VBL

Tokens can also have VBL attached to them. This is called Token VBL. See Introduction to Tokens VBL Section for more information.
Token VBL can be leveraged into bringing VBL in from paint programs. See Adding VBL with a Mask for a tutorial on how.