Sizing and Aligning Maps

September 05, 2023 08:42

Smart Sizing For Maps

The Smart Sizing feature allows you to change the page size to match your map when you place it on the map layer.

If you add an image to an empty map layer, you will be prompted to resize the page to fit the map.. You can always choose to fit the map to the page yourself, or use our align to grid feature. Press the button “Don’t show me again” and continue with your dungeon-making!

Smart Sizing feature:

This feature only works when a map is being placed on a blank map layer.
Smart Sizing does not work if the map is smaller than the current size of the map.
The feature works better with gridless map images.
Smart sizing works on personal uploads, not Marketplace purchases.

In addition to smart sizing, you can now set your own grid dimensions for uploaded images. Set the size, and never worry about resizing when you drop an image again.

Using The Align To Grid Tool

Sometimes you might want to use a pre-made battlemap that already has a gridded surface. If you're struggling to align your image's grid with Roll20's, our align to grid tool can assist you.

Zoom in to 150%.
Make sure you are on the Map & Background layer.
Right Click on your map image and choose Advanced -> Align to Grid.
Click and drag to trace a 3x3 (three across & three down) square box aligned with the grid on your map. Disregard the Roll20 grid for now. While pixel-perfect precision is unnecessary, a more precise tracing reduces the need for future adjustments.
When you let go of the mouse, a new window will appear. If you are satisfied with your tracing, click on the "Align to Grid" button to confirm.
The Grid Alignment Tool should resize your map to match fairly closely to Roll20's grid. Use the horizontal and vertical scaling transformers on your image to fine-tune the grid alignment.

Here are 4 different ways to align your map on Roll20. In this tutorial, we'll explain how to set up your page, set dimensions, align to Grid, and share tips for maps that are more challenging to align.

Further tips on aligning

If you have problems aligning to the grid, this is a breakdown from Gauss.

Square map

Follow these steps to align a square map. These steps assume you have already placed the map on the map layer, and that you are currently viewing the map layer.

Start by setting your zoom to 150%.
Next, right-click on your map and select Advanced -> Align to Grid.
Trace a 3x3 section of your map's grid and release and click the align grid button.

To fine-tune the map:

Hold down the Alt key. With your mouse, move the map so that the grid is aligned as closely as possible. Doing this in the center of the map will produce the best results.
Use the scaling transformers (light blue boxes at the edge of your map) to resize the map to better fit.
For a more precise fit, right-click on the map and select Advanced -> Set Dimensions.
- If the vertical map lines are to the left of the Roll20 grid lines then increase the width.
- If the vertical map lines are to the right of the Roll20 grid lines, then decrease the width.
- If the horizontal map lines are above the Roll20 grid lines, then increase the height.
- If the horizontal map lines are below the Roll20 grid lines, then decrease the height.
Repeat the above step until the grid matches your entire map.

Hex map

Follow these steps to align a hex map. Note: Be sure to choose the right grid style on the Page Settings.

Drop the map onto the map layer.
Use the scalers (little boxes on the edge of the image) to get the hex map near the same size as the hex grid.
Find the middle of the map by doing the following:
1. Height: Count the number of vertical hexes. The middle of the map should be the halfway point. For example, if your map is 60 hexes tall, the halfway point is the line between hex 30 and 31.
2. Width: Count the horizontal hexes. The middle of the map should be the halfway point. For example, if your map is 80 hexes wide the halfway point is the line between hex 40 and 41.
3. The two midpoints should create an intersection which is the middle of the map. This is where you will make adjustments from.
Align the intersection at the middle of the map. You can do this by holding Alt and aligning the map intersection to the grid intersection.
Align the horizontal map lines first. Right-click on the map, select Advanced -> Set Dimensions.
If the lines above the starting line are above the Roll20 grid, then decrease the height. If the lines are below the Roll20 grid then increase the height. #*Repeat the above step if the alignment point gets offset. This can happen if the alignment point is not the center of the map. Keep repeating this until the horizontal map lines are perfect.
Align the vertical map lines next. Right-click on the map, select Advanced -> Set Dimensions.
If the lines to the right of the starting line are to the right of the Roll20 grid, then decrease the width. If the lines are to the left then increase the width.
- Repeat the above step if the alignment point gets offset. This can happen if the alignment point is not the center of the map. Keep repeating this until the vertical map lines are perfect.

For Hex (V), reverse all of the above instructions that involve width and height or horizontal and vertical.

Further accuracy on aligning the grid

Here are some other tips and trick to get a more accurate Align to Grid as a first step:

Increase the Page Size to a very large number (such as 200 by 200). You can adjust settings for the current map in the Page Toolbar.
Set zoom to 50% and then expand the map size to fit the Page Size.
Set zoom to 150% and use the Align to Grid tool.
Reduce the zoom to 50% and move your map to the top left corner of the page.
Decrease the page size to match your map size.
Return the zoom level to 100% and follow the fine-tuning tips above.

Extracted map from PDF

I extracted my map out of a PDF and the grid is too small even when set to 150%!
There is a simple solution:

Thankfully this has a simple solution:

Follow the above steps to align the map to the grid.
Use the Set Dimensions tool to increase the size of the map. Make sure you use a multiple of 2. Example: If your map's current dimensions are 3640 by 5040 then double the dimensions to 7280 by 10080.
Increase the Page Size (in the Page Toolbar) to fit the new size of your map.
You may need to double the Grid size and halve the Scale size. You can find both fields in your Page Settings in the Page Toolbar.
Make any final adjustments such as using Alt and move the map and reposition it if necessary.

There are other methods to solve this problem but most of those are more complicated. If you find that using a grid size other than 1 creates a problem contact us, so we can help you to fix this while keeping the grid size at 1.

I know the pixel dimensions, how do I adapt to the 70x70 pixels of Roll20?

I have a map grid which is 64x64pixels. I want to set the Roll20 grid to 64x64pixels. How do I do this?

Use the Set Dimensions tool to set the dimensions of your map to a multiple of the grid. For example: if your grid is 50 squares by 32 squares and uses 64 pixels by 64 pixels then set the dimensions to 3200 by 2048. This presumes that there are no partial grid borders. If there are, you will need to use the Align to Grid tool.
In a calculator divide the grid size by 70. This will produce a decimal value. Example: 64/70 will result in 0.91428571...
Set your Grid Unit Size to the decimal value you calculated. This can be found in the Page Settings for your map in the Page Toolbar.
Now we need to fix the Scale. Divide the scale you wish (such as 5feet) by the decimal value you calculated in step 1 and put that number in the scale. Example: 5/0.91428571... will result in 5.46875. Click OK.
Now hold down Alt and move the map to align the grids if necessary. They should line up perfectly.

Another method for aligning maps with existing grids

Right-click on the image and set the dimensions to 700x700px (10 cells each way).
Right-click on image and set "is drawing". You can skip this step if you are certain that the map edges are exactly on a grid line (there are a lot of maps, especially older ones, that aren't).

These two steps provide ample space to easily grasp the image and clearly view some of the details, particularly the grid on the map.
Set the image so that the upper left corner is in one row and column from the top and left edges of the map.
Adjust the Roll20 grid to a setting that is highly visible and contrasts well with the specific map you are using.
Drag the bottom of the map downward until the map grid lines along the left edge line up with the Roll20 grid. Enlarge the Roll20 map page as needed to get enough room.
Drag the right edge out until the map grid lines along the top edge line up with the Roll20 grid. Enlarge the Roll20 map page as needed to get enough room.
Some old maps didn't have a grid line at the edge of the map, and instead ended about halfway into another row/column of cells. To avoid snapping to the grid, you can set the image to "is drawing" mode, allowing you to align the upper left corner as needed. Adjust as needed to get any overhang into the border row/column.
After stretching the map to align with the grid, assess whether you are satisfied with the map's display resolution. If the map is blurry, use the "set dimensions" to set the image size to half. Then set the grid size to .5, adjust the upper left-hand corner alignment if needed, and reduce the size of your map page to match the current image size plus any border cells you want to maintain.
Turn the Roll20 grid fully transparent, so that you are only seeing the map grid.

Once that is done, the optional (though recommended) step number 10 is to use your pro subscription perk of the transmogrifier to save this map to a map library game so you never have to go through that setup again for that map should you desire to use it again in the future.

The preceding workflow comes from one of our Pro members, Kraynic, with many thanks from us here on the team!