Automatic Scaling¶

Requirements

The following scripts are required to use Automatic Scaling and all related functionality covered in the Automatic Scaling guides:

scWM
scAlert

WideQuick MOD automatically scales the UI to fit any screen size or browser window. This means a project can run on different displays without requiring layout changes.

The scWM script handles all scaling. It monitors the main window every 500 ms and calculates a scaling factor based on a reference resolution of 1920×1080. The current factor is always available as scWM.scalingFactor.

Main View Scaling¶

The main view scales automatically — no configuration is needed. scWM continuously applies the correct zoom level as the window resizes. This also works on WideQuick Remote® clients and WideQuick Web® clients. Web clients scale relative to the browser window rather than the screen resolution.

Popups do not scale automatically. To scale a popup proportionally to the main view and place it on screen, call scWM.scaleAndPlacePopup() in the popup Workview's onLoad script. To find the onLoad script, right-click the Workview in the project tree in WideQuick Designer®, select Properties, open the Action tab and double-click load.

Popup Workview — onLoad

scWM.scaleAndPlacePopup(this);

Scaled popup centered in the main content area

By default the popup is centered within the main content area, excluding the navigation menu. An optional alignment argument positions it along a screen edge instead:

Alignment	Description
(none)	Centered on screen (default)
`"bottom"`	Anchored to the bottom of the screen
`"top"`	Anchored to the top of the screen
`"left"`	Anchored to the left of the screen
`"right"`	Anchored to the right of the screen

Popup workview — onLoad (bottom alignment)

scWM.scaleAndPlacePopup(this, "bottom");

Enabling Pannable/Zoomable¶

Popup scaling requires Pannable/Zoomable to be enabled on the popup Workview. In WideQuick Designer®, right-click the Workview in the project tree and select Properties. Open the Layout tab and check Pannable/Zoomable.

Pannable/Zoomable setting in Workview properties

Placement Without Scaling¶

For smaller popups that do not need to resize, use scWM.placePopup() to center the popup without scaling it:

Popup Workview — onLoad

scWM.placePopup(this);

Reloading a View¶

To force a Workview to re-initialize, use scWM.reloadPage():

Button or script

scWM.reloadPage("ViewName");

This briefly switches to a dummy view and back, forcing the target view to reload. Useful when a view needs to reflect configuration changes without navigating away manually.

Using the Scaling Factor in Custom Scripts¶

scWM.scalingFactor exposes the current scale as a number between 0 and 1 (or higher on large displays). Any custom script that needs to account for the current zoom level can read it directly:

Custom script

var factor = scWM.scalingFactor;
var scaledSize = baseSize * factor;

This is used internally by the map scripts to recalculate element positions when the window resizes.