Functional explanation
CircleObject is used for indicators, lamps, round highlights, and circular decorative elements.
It is commonly used when a compact visual status marker is needed, such as running, stopped, warning, or fault states. The circle is also useful for stylized process graphics and symbol decoration.
Keep width and height equal when a true circle is required. If the values differ, the object becomes an ellipse.
Object name
Set the object name shown in the circle decorator context.
| Setting | Description | Example | Units |
|---|---|---|---|
| Object Name | Name used to identify the Circle object. | StatusLamp | Text |
No rows match the filter.
Settings
Configure the fill, border, and state styling for the circle 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 circle 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 circle 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 Circle 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. | 24 | px |
| Height | Height of the object. | 24 | 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 circle object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Border Color | Border color used for the circle. | #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 circle. | 1 | px |
| Border Radius | Corner radius of the circle 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 circle is clicked. See the Actions article for every available action type and its settings.
| Setting | Description | Example | Units |
|---|---|---|---|
| Actions | Action list executed when the circle is clicked. | Toggle, open popup | Action configuration |
No rows match the filter.
Animate Position / Size
Configure the runtime animation settings for height, width, top, and left of the Circle 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 circle 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 Circle 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 Circle object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Visibility | Expression controlling whether the object is visible. | PLC1.CircleVisible | Expression |
| Blink | Expression or boolean controlling circle 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.