Foundry Virtual Tabletop includes support for placing Tiles, which are individual pieces of artwork which are displayed above the background image of the scene which can add decorations, props, or custom features. Tiles are displayed below Tokens.

A future Foundry Virtual Tabletop version will add support for "overlay tiles" which will support a layer of Tiles that Tokens can pass beneath.

To place or create Tiles, activate the Tiles Layer from the controls palette on the left hand side of the screen. There are two ways to place tiles.

1. Creating a custom tile. To do this use the second tool which looks like a cube and you can left-click drag a box which will form the basic shape for the tile. Once you release your left-mouse button you will be prompted to provide the configuration details for the Tile.
2. Using the File Browser, by clicking the folder icon in the tool palette you will be shown a File Picker where you can drag and drop image assets onto the Scene to create Tiles.

The Tile Configuration Sheet

Once a Tile is created, you can configure all the details of the Tile by double-clicking on the Tile. The configuration options are described below:

Tile Sprite

The image or video file path of the displayed tile. Note that Tiles can be either static images or videos. If using Video tiles, the .webm format is recommended to support transparency (if needed).

X-Position

The x-coordinate location of the top-left corner of the Tile.

Y-Position

The y-coordinate location of the top-left corner of the Tile.

Width

The horizontal width of the desired Tile display.

Height

The vertical height of the desired Tile display.

Rotation

The rotation of the Tile, in degrees.

Once any changes to the Tile have been made, click the "Update Tile" button to confirm your changes.

In addition to configuring the Tile using the sheet, you can also re-position or rotate the Tile using your mouse. Left-click and drag to move the tile, or use CTRL+MouseWheel or SHIFT+MouseWheel to rotate the Tile. This can be a convenient way to configure the Tile location, but using exact coordinates in the Config Sheet is more precise.

The Tile HUD

There are additional options for configuring the Tile in the HUD which is accessed on a single right-click.

The buttons in the Tile HUD are, from top-to-bottom:

Toggle Visibility

Toggle the visibility state of the Tile, turning it from hidden to visible (or vice-versa).

Toggle Locked State

Toggle the locked state of the Tile. While locked, the Tile cannot be moved and is non-interactive.

Bring to Front

Bring the Tile to the front of the rendered Layer, displaying it above other nearby Tiles.

Send to Back

Send the Tile to the back of the Tiles Layer, displaying it below other nearby Tiles.

API References

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

• The Tile Object
• The TilesLayer Canvas Layer
• The TileConfig Application