Skip to main content

Resolution

Resolution is about how many pixels Easel uses to render the graphics on the screen. More pixels means a sharper image, but also more work for the computer to do, which can lead to lower performance. The single thing which makes the most difference to graphics performance is resolution.

Resolution levels​

Easel can function at three resolutions:

  • Maximum resolution: If a player has a high-density pixel display, sometimes called a retina display, then Easel will render to subpixels when set to Maximum resolution.
  • High resolution renders to pixels but not to subpixels.
  • Low resolution renders to half the height and width, and so looks pixelated, but is also the most performant, especially on lower-end devices.

Choosing the resolution​

You can give your players the option to choose their resolution using the ResolutionToggle or ResolutionDropdown user interface element.

Otherwise, Easel will attempt to automatically choose the best resolution for the player's device based on how it is performing.

tip

Set the minResolution parameter of graphics.toml to define the lowest resolution that your game can be set to. This affects which resolution will be chosen automatically by Easel, as well as which options are available to the player if you use a resolution toggle or dropdown.