SentinelSCADA › Tutorial › Chapter 6

Chapter 6: Screen Properties

Goal Learn the settings that belong to a single screen: its size, background colour and image, the access level needed to open it, and the alignment grid.

In the last chapter we looked at Project Properties, which apply to the whole project. Screen Properties are different: they apply to one screen only. They cover the screen's size, background colour and image, the access level required to open it, and the alignment grid.

Screen Properties appear in the Properties panel on the right of the designer, under SCREEN SETTINGS, whenever no widget is selected. Click an empty part of the canvas to bring them up.

The Screen Settings panel showing sheet comment, canvas size, background colour and image, layout, opacity, access level and the align grid option

Part 1: Comment and size

Sheet Comment
A short note (up to 80 characters) describing the screen, for example Overview of process line A. It is documentation only and does not affect how the screen runs.
Canvas Width (px) and Canvas Height (px)
The size of this screen's drawing area in pixels. Each can be set from 200 to 4000, in either direction, which covers a 4K display in landscape or portrait. For a portrait panel, simply make the height larger than the width: a 1080 x 1920 portrait screen is width 1080, height 1920. New screens start at the sizes set on the UI & Screen Defaults tab of Project Properties, which we met in the last chapter.

Part 2: Background colour and image

Background Color
The solid colour behind the widgets on this screen. Click the swatch to pick a colour; the hex value is shown beside it, for example #B7D7F0.

Background image

You can also place a picture behind the widgets, such as a P&ID diagram, a plant photo or a floor plan. Click the … button beside BACKGROUND IMAGE URL to open a file picker, and choose an image from your computer.

A Windows file picker showing three boiler house image files

Supported formats are PNG, JPG (JPEG), GIF and WEBP, up to 5 MB. Any other type, including SVG and BMP, is refused with an Unsupported file type message, and a larger file is refused with File exceeds the 5 MB limit.

The image is uploaded to the server and stored under the project's own resources folder, and the box fills in with its address, for example:

api/resources/BoilerHouse/boilerhouse_3_639293822358590258.jpg

Note The long number added to the end of the file name is the upload time. It means uploading two files with the same name never overwrites the first.

Layout and opacity

BG IMAGE LAYOUT controls how the image fills the screen.

The BG Image Layout drop down listing Zoom Cover, Zoom Contain, Stretch, Centre, Tile and Remove Image
Zoom (Cover)
Scales the image to fill the whole screen, keeping its proportions. Edges may be cropped. This is the default.
Zoom (Contain)
Scales the image so all of it is visible, keeping its proportions. Bars of the background colour may show.
Stretch
Stretches the image to the exact screen size. Proportions may be distorted.
Centre
Places the image at its original size in the middle of the screen.
Tile
Repeats the image across the screen.
Remove Image
Clears the background image.

BG IMAGE OPACITY sets how solid the image is, from 0 (invisible) to 1 (fully opaque). The default is 0.5. Lower values keep the image from competing with the widgets.

The BoilerHouse screen with a boiler room picture behind the gauge, clock, session panel and navigation link
Zoom (Cover) at 0.5 opacity, with the widgets still on top.

Part 3: Access Level

ACCESS LEVEL is the minimum user role needed to open the screen: Anonymous, Guest, Operator, Engineer or Admin. Anonymous, the default, means no login is required.

Authentication required The Access Level is only enforced when Require Authentication is ticked in Security > Security Settings (we first looked at the security settings in Chapter 3). Without it, everyone is treated as having access and the setting has no visible effect.

In Run mode, a Screen Link widget that points to a screen the current user is not cleared for is greyed out and disabled, with no explanation shown. In Design mode the links always look normal, so they stay editable.

For example, with a Settings screen (which we create in the next chapter) set to Engineer, Require Authentication ticked and the project in Run mode, a user logged in as Operator sees the link to Settings greyed out, while the links to Overview and Alarms work normally.

Three Screen Link buttons: Overview and Alarms active, Settings greyed out

The Screen Swapper follows the same rule. With Require Authentication on, it skips any screen in its sequence that the current user is not cleared to open. See the Screen Swapper section in Chapter 5.

Part 4: Show Align Grid

When SHOW ALIGN GRID is ticked, the alignment grid (the dots) is shown on this screen in Design mode, to help you line up and snap widgets. It overrides the project default for this screen only. The grid is a design-time aid and is not shown in Run or Kiosk mode.

Save the screen Screen Properties are saved with the screen, so remember File > Save Screen when you have changed them.

Summary