Foundry VTT canvas interaction module
EZGlide
A Foundry VTT module that smooths canvas zooming and panning with exponential easing.
EZGlide smooths Foundry VTT canvas zooming and panning with animated exponential easing. It makes tabletop navigation feel less abrupt while keeping the underlying Foundry canvas model intact.
Features
- Smooth zooming: mouse-wheel zooming with exponential decay animation.
- Smooth panning: right-click drag panning with interpolation.
- Configurable speeds: independent controls for zoom and pan animation.
- User choice: per-user settings let individual players opt out.
- Macro alternative: a companion macro for players who cannot install modules.
Installation
In Foundry VTT, open Add-on Modules, choose Install Module, search for EZGlide, and install it. Then enable it in your world settings.
Macro Alternative
For players who cannot get the module installed in a world, EZGlide also includes a companion macro.
Copy the contents of macro/macro.js, create a new Foundry macro, paste the code, and run it. The macro needs to run each time the world loads, but it saves prior settings.
Configuration
Settings are available through Game Settings, Configure Settings, then EZGlide.
- Smooth Zoom: enables or disables smooth zoom behavior.
- Zoom Smoothing Factor: controls how quickly zoom converges.
- Zoom Step Size: controls the multiplier for each wheel scroll.
- Smooth Panning: enables or disables smooth panning behavior.
- Pan Smoothing Factor: controls pan animation speed.
All settings are user-scoped, so one player can keep smooth controls enabled while another disables them.
Technical Notes
EZGlide depends on libWrapper.
It is incompatible with aeris-smooth-camera, because both modules modify canvas interaction behavior. Unlike aeris-smooth-camera, EZGlide supports simultaneous panning and zooming.
Development Story
The project has a longer technical story behind it. EZGlide came from finding exponential smoothing more interesting than the immediate feature request. The module is an adaptation of a small mathematical idea into Foundry VTT’s existing canvas interaction system.
I am collecting that story in Exponential Smoothing in Foundry VTT.
License
EZGlide is licensed under GPL v3.0.