Overview
The Measurement Control toolbar, when enabled, provides access to tools for accessing and controlling the placement of measured templates. This tool allows you to determine the shape of a spell, or area effect, and determine what spaces will be affected. This article will go over how to lay down measurement templates, the types of shapes available, and how to modify a template once it's been placed into a scene.
Measured Template Controls
- Circle Template ( )
- Circular templates create a radius around the starting point to the distance you select.
- Cone Template ( )
- Cones create an effect in the shape of a triangle or pizza slice from the starting point. These cones default to about 53 degrees, but can be customized in the templates settings.
- Rectangle Template ( )
- A rectangle uses the origin point as one of the corners, treating the origin as being inside of the rectangle's area.
- Ray Template ( )
- A ray creates a single line that is one square in width and as long as you drag it to. Rays can have their width increased as required in its template settings.
- Clear Templates ( )
- This button clears all existing templates on the scene if you are a GM or Assistant GM.
To place a measured template of any kind, select the type you want to place, then click a point in the scene, and drag out the selected measurement shape to the desired size. Once you release your mouse button the template will be created. If your scene is using the Grid or Hex grid types it also shows you all the spaces affected. Gridless maps will not show highlighted spaces, though it will still show the area of the effect.
You can hover your mouse over an existing template's origin point (appears as a starburst icon) and use Shift + your mouse scroll wheel to rotate a cone or ray template around its starting point. Control + scroll wheel allows you to make smaller adjustments to the template. To move an existing template click and drag the template by the starburst icon that represents the template's origin point. Templates will automatically snap to grids spaces and grid intersections. You can precisely place them by holding down Shift or Control while dragging them.
To delete a template, simply hover your mouse over the origin point, and press the delete key. Gamemasters can use the trash can icon to remove all measurement templates from a scene. To hide a template, simply right-click on the origin point. The icon will turn orange, indicating the template is hidden from view.
The measurement template configuration screen can be accessed by double clicking any existing template in a scene. From there you can change the type of template to any of the types noted above, and directly manipulate various qualities of the drawn template.
- Template Type
- You may alter the shape type of the Measured Template after it is placed using this dropdown field.
- X-Position
- The x-coordinate location of the Template origin. This can also be changed via drag-and-drop on the control icon.
- Y-Position
- The y-coordinate location of the Template origin. This can also be changed via drag-and-drop on the control icon.
- Direction
- The Template direction determines which angle which the template is facing. For some template types (like circle) this may not have an effect, but for templates like Cone, or Ray this configures the direction in which the template points.
- Angle
- This field only applies to conical templates and can be any value from 1 to 360 degrees.
- Width
- This field only applies to Ray type templates to configure the width of the ray or beam.
- Distance
- This configures how far the Measured Template reaches from its origin point. For a circle template, this sets the radius of the, while in all other templates it can affect the length of a ray or cone, or the width of a rectangle. Note: Once a template has been drawn in a scene, the only way to change the distance is by directly manipulating it from the configuration window.
- Border Color
- This determines the color of the template's outline, and defaults to black, but can be changed after the fact to whatever color desired.
- Fill Color
- This determines the internal color and grid highlight color when a cone is drawn. The fill color defaults to the color of the user creating the template. This color can be changed to whatever color desired from this menu.
- Template Texture
- This allows for a tiling image to be applied to the interior of the Measured Template. The texture will be repeated to fill the entirety of the shape, which looks best when a tileable, seamless texture is used. Tiling textures must be image files only and are recommended to be power-of-2 in their dimensions (i.e.. 128, 256, 512, etc...).
Cone Template Type
You can change the appearance of the end of the Cone template shape and whether it is rounded (default) or flat. This setting can be changed from the Core Settings tab found in the Game Settings menu. To lean more about this menu see the Game Settings article.
This directly affects how many squares are affected at the farthest edge of a cone. The rounded setting makes the cones taper slightly at the edge, while the flat setting makes sure the widest part of the cone and most affected squares is always the furthest point from the origin.
API References
To interact with AmbientLights programmatically, consider using the following API concepts: