This is an old revision of the document!

ScreenResolution(s) Token

The %ScreenResolution% token (v11.0+) returns the resolution of the specified screen.

The %ScreenResolutions% token (v11.0+) returns the available resolutions of the specified screen.

They both takes a parameter indicating which screen to use.

The parameter may be:

Index Name	Description
Main or 0	the screen with the primary menu bar (as configured in the Displays preferences).
Second	the first from the left which is not the Main screen.
Third	the second from the left which is not the Main screen.
Internal	the internal screen of the Mac.
External	the first from the left which is not an internal screen.
Mouse	the screen containing the mouse.
Front	the screen containing (the most of) the front window.
Back	the first from the left not containing (the most of) the front window.
Back2	the second left most screen not containing (the most of) the front window.
All	all of the screens, from left to right, one per line.
Positive Calculation	the indexed screen from left to right.
Negative Calculation	the indexed screen from right to left.

So for example, %ScreenResolution%Main% gives the resolution of the main screen.

The resolution is in the form:

nominal width, nominal height, pixel width, pixel height, frame rate

The ScreenResolutions themselves are also separated by a comma with an additional space.