Drawing tools can be used to allow the GM and users to annotate the map with freehand or shaped drawings. The appearance of drawings can be pre-configured using defaults, or individual drawn shapes may have their appearance changed after they have been placed.


Drawing Tool Permissions

By default, players do not have permission to use Drawing tools, while Trusted players and Assistant GMs have access to the drawing tools enabled by default. If you wish to allow or revoke permissions to the drawing tools, you can do so from the "Use Drawing Tools" section of the Permission Configuration in the Game Settings menu.

Drawing Types

Rectangle Drawing Tool
Used for drawing rectangular and square four-sided shapes.
Ellipse Drawing Tool
Used for drawing enclosed circular shapes.
Polygon Drawing Tool
Used for drawing polygonal geometric shapes from straight lines. Right-click removes the last point drawn, double-click to finish drawing.
Freehand Drawing Tool
Used for drawing freehand, as though with a stylus, can be used to create complex rounded shapes. Will continue to draw as long as the left mouse button is pressed.
Text Drawing Tool
Used for placing text directly onto the map in order to offer labels or place messages directly on the canvas.

Configuring Drawings

Drawing Tools and Configuration
Drawing Tools are just the thing when you need to leave some artistic graffiti on your Game-Master's lovingly prepared Scene!

Drawings may be configured by using the "Configure Drawing" tool. This sets the defaults your drawings will adhere to when placed. In addition, individual drawings can be modified after their placement and any of the below settings changed via the configuration menu. To access the configuration menu for a particular drawing, simply doubleclick it.

Line Width
Set the thickness in pixels (px) of the lines drawn by the Square, Ellipse, Polygon or Freehand tools.
Stroke Color
Set the color in Hex (#000000) used to color shapes drawn with the drawing tools.
Line Opacity
Set the transparency of shapes drawn with the drawing tools.
Smoothing Factor
Foundry will attempt to smooth rough edges of shapes to reduce the number of vertices in freehand drawings. Use this setting to adjust how aggressive the smoothing filter is.
Fill Type
Shapes can be filled as necessary, "None" will not fill a shape, "Solid" will fill your shape with a chosen color, and Pattern will fill a shape with a chosen texture file.
Fill Color
Set the color in Hex (#000000) used to fill the inside of shapes drawn with the drawing tools.
Fill Opacity
Set the transparency of the color and texture used to fill the inside of shapes drawn with the drawing tools.
Fill Texture
Set the texture to use for filling the inside of a shape. This should ideally be a repeating, tiling png with transparency.
Text Label
Applies a text which will expand to fit and fill the inside of the shape drawn, please note that if the content of the text label is longer (in height) than the shape itself, it will expand beyond the shape’s boundaries.
Font Family
Choose from available fonts in Foundry to style your text.
Font Size
Choose the font size in pixels (px) for text labels and the text tool.
Text Color
Choose the color to be applied to text in labels and text tool drawings.
Text Opacity
Set the transparency of text both for text labels and text tool drawings.

API References

To interact with Drawings programmatically, consider using the following API concepts: