Functional explanation
SquareObject is a rectangular shape used for panels, status blocks, separators, background blocks, and simple visual highlighting.
It is the basic building block for many design layouts because it can act as a flat shape, a framed panel, or a container-style visual element inside a larger symbol.
Use the page background settings for the full page background. Use SquareObject for local panels and visual blocks inside the page.
Object name
Set the object name shown in the square decorator context.
| Setting | Description | Example | Units |
|---|---|---|---|
| Object Name | Name used to identify the Square object. | StatusPanel | Text |
No rows match the filter.
Settings
Configure the fill, border, and state styling for the square object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Set Background | Marks the object as a background element, so it sits behind the other objects on the page. | false | Boolean |
No rows match the filter.
Color
Configure the color and the conditional color states for the square object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Color | Fill color for the shape. Set from the Color picker in the Color group. A gradient can be used here as well as a single color; see the Gradients section of the Color Library article. | #f8f9fa | Color |
| Color States | Conditional color state rules that restyle the square from a variable or expression. Each rule pairs a condition with a color, and the first matching rule wins. A gradient can be used here as well as a single color; see the Gradients section of the Color Library article. | [{"state":"alarm","color":"#dc3545"}] | JSON array |
No rows match the filter.
Position / Size
Configure the position and size of the Square object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Top | Top position of the object. | 100 | px |
| Left | Left position of the object. | 220 | px |
| Width | Width of the object. | 120 | px |
| Height | Height of the object. | 120 | px |
| Z-index | Layer order of the object. Higher values appear in front of lower values. | 10 | Number |
No rows match the filter.
Border
Configure the border styling for the square object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Border Color | Border color used for the square. | #CED4DA | Color |
| Border Color States | Dynamic border color state rules JSON array. | [{"state":"alarm","color":"#dc3545"}] | JSON array |
| Border Width | Border width used for the square. | 1 | px |
| Border Radius | Corner radius of the square border. | 4 | px |
| Border Visibility | Expression controlling whether the border is visible. | SYSTEM.UserGroups == "Operators" | Expression |
| Border Blink | Expression or boolean controlling border blinking. | PLC1.AlarmActive | Boolean or expression |
| Border Blink Speed | Blink speed used for the border. | 500 | ms |
| Border Blink Offset | Blink offset used to stagger border blinking between objects. | false | Boolean |
No rows match the filter.
Actions
Configure the action list executed when the square is clicked. See the Actions article for every available action type and its settings.
| Setting | Description | Example | Units |
|---|---|---|---|
| Actions | Action list executed when the square is clicked. | Open popup, set value | Action configuration |
No rows match the filter.
Animate Position / Size
Configure the runtime animation settings for height, width, top, and left of the Square object.
22 rows
| Setting | Description | Example | Units |
|---|---|---|---|
| Animate Height Variable | Variable or expression that drives runtime height animation. | PLC1.Level | Variable or expression |
| Animate Height Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Height Maximum Raw | End of the raw value span. The animated height reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Height Minimum px | Start of the pixel span. The animated height runs from 0 px up to the difference between Maximum px and Minimum px. | 20 | px |
| Animate Height Maximum px | End of the pixel span. With Minimum px at 0, this is the height at full scale. | 60 | px |
| Animate Height Reverse | Sets the edge the height grows from. Cleared grows the object upwards from the bottom edge, which suits level and fill graphics. Selected grows it downwards from the top edge. | false | Boolean |
| Animate Width Variable | Variable or expression that drives runtime width animation. | PLC1.Value | Variable or expression |
| Animate Width Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Width Maximum Raw | End of the raw value span. The animated width reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Width Minimum px | Start of the pixel span. The animated width runs from 0 px up to the difference between Maximum px and Minimum px. | 80 | px |
| Animate Width Maximum px | End of the pixel span. With Minimum px at 0, this is the width at full scale. | 220 | px |
| Animate Width Reverse | Sets the edge the width grows from. Cleared grows the object to the right from the left edge. Selected grows it to the left from the right edge. | false | Boolean |
| Animate Top Variable | Variable or expression that drives runtime top-position animation. | PLC1.PositionTop | Variable or expression |
| Animate Top Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Top Maximum Raw | End of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Top Minimum px | Start of the pixel span. A rising value moves the object upwards from its resting position by up to the difference between Maximum px and Minimum px. To move the object downwards, set Minimum px above Maximum px. | 100 | px |
| Animate Top Maximum px | End of the pixel span. A rising value moves the object upwards by up to the difference between Maximum px and Minimum px. | 260 | px |
| Animate Left Variable | Variable or expression that drives runtime left-position animation. | PLC1.PositionLeft | Variable or expression |
| Animate Left Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Left Maximum Raw | End of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Left Minimum px | Start of the pixel span. A rising value moves the object to the right from its resting position by up to the difference between Maximum px and Minimum px. To move the object to the left, set Minimum px above Maximum px. | 200 | px |
| Animate Left Maximum px | End of the pixel span. A rising value moves the object to the right by up to the difference between Maximum px and Minimum px. | 420 | px |
No rows match the filter.
Rotation
Configure the rotation of the square object. The fixed Rotation angle and the free-running rotation are independent and can be combined: the object is first turned to its fixed angle and then keeps turning from there.
Free-running rotation is applied in runtime. In the design environment the object stays still so that it can be selected, moved, and resized.
| Setting | Description | Example | Units |
|---|---|---|---|
| Rotation | Fixed rotation angle applied to the object. Accepts a value, a variable, or an expression. | 45 | Degrees |
| Transform Origin | Point the object rotates around. Left empty the object turns around its own centre. | center | CSS transform origin |
| Rotate Continuously | Turns free-running rotation on while the value resolves to true, which is how a running fan, pump, agitator, or mixer is shown. Accepts true or false, a variable, or an expression, so the movement can follow a run feedback. | PLC1.Fan1_Running | Expression |
| Rotation Speed | Speed of the free-running rotation in degrees per second, so a larger value turns faster. Accepts a value, a variable, or an expression, which lets the symbol turn at the speed the device reports. A negative value turns the other way. | 90 | Degrees per second |
| Rotation Direction | Direction of the free-running rotation. Accepts a value, a variable, or an expression, so it can follow the direction the drive reports: a positive value turns clockwise and a negative value turns counter clockwise. Clockwise and Counter Clockwise are accepted as text, and a true or false value is read as a reverse signal, where true turns counter clockwise. Leave empty to turn clockwise. Often not needed, because a Rotation Speed that can go negative already sets the direction. | -1 | Signed value |
No rows match the filter.
Access Control
Configure access control for the Square object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Access Control Enable | Enables access control evaluation for the object. | true | Boolean |
| Access Control | Expression controlling who can use or see the object. | SYSTEM.UserGroups == "Operators" | Expression |
| Access Control Filter | CSS filter applied when access control is used to alter the object appearance. | blur(0px) contrast(30%) | CSS filter |
No rows match the filter.
Visibility
Configure the runtime visibility and blinking behavior for the Square object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Visibility | Expression controlling whether the object is visible. | PLC1.SquareVisible | Expression |
| Blink | Expression or boolean controlling square blinking. | PLC1.AlarmActive | Boolean or expression |
| Blink Speed | Blink speed used during runtime. | 500 | ms |
| Blink Offset | Blink offset used to stagger blinking between objects. | false | Boolean |
No rows match the filter.