Filter

This text is AI-generated — we need your feedback

This documentation was written with the help of AI and has not been fully reviewed. If something is wrong, unclear or missing, please tell us: open the feedback form, say which section it concerns and what you expected to read. The same link is at the bottom of every page.

The Filter is an automation symbol for an electrical filter. It is found in the Automation - OpenBridge section of the Perspective Component Palette as Filter.

It is meant to be placed in a mimic or diagram, typically in a coordinate container, with its properties bound to the state of the device. The Filter shows the state it is given; it does not change it, and clicking it does nothing unless you configure an event.

The Filter is one of the automation buttons. The readout and tag, the alert frame, the progress ring, the badges, the size and the positioning are shared by all of them and are described in Automation Buttons — Common Features. This page covers what is specific to the Filter.

A Filter dropped from the palette with default properties:

State

Bind on to the tag or property that holds the state of the device. The symbol is drawn filled and grey when on is false, and as an outline when it is true. The status row of the readout shows Off or On.

Off	On

---

Alternative Icons

alternativeIcon selects which symbol is drawn. There are 4 icons. The table shows every icon off and on, for both values of variant:

alternativeIcon	square, off	square, on	flat, off	flat, on
filter1 (default)
filter2
filter3
filter4

Use the same icon for the same kind of device throughout a project.

---

Variant

variant selects whether the icon is drawn on a button or directly on the background:

• square (default) — the icon sits on a square button with a border.
• flat — only the icon is drawn, larger and without a button. Use it where the symbol is part of a line diagram.

square	flat

Orientation

orientation rotates the icon so that it follows the line it is part of. The readout is not rotated. verticalRight rotates the icon 90° clockwise, verticalLeft 90° counter-clockwise.

horizontal	verticalRight	verticalLeft

---

Properties

Name	Description	Property Type
on	Whether the device is on. Selects the on icon and the On status row. Default false.	value
alternativeIcon	Which icon to draw: filter1, filter2, filter3, filter4. Default filter1.	value
variant	square draws the icon on a button, flat draws only the icon. Default square.	value
orientation	Rotation of the icon: horizontal, verticalRight or verticalLeft. Default horizontal.	value

Common Properties

The Filter is an automation button. The properties below work in the same way on every automation button, and are described in Automation Buttons — Common Features:

• Readout — The readout next to the symbol: the status row and the tag name. Properties: showReadoutStack, readoutPosition, readoutSize, showStatus, hasTag, tag.
• Positioning — Which part of the button is aligned to the component’s box. Properties: positioning.
• Size — Size of the whole component. Properties: componentSize.
• Activated — Highlighted background that marks the symbol as selected. Properties: activated.
• Alert Frame — Alert frame around the symbol. Properties: alert, alertFrameType, alertFrameStatus, alertFrameMode, alertFrameThickness, showAlertCategoryIcon, showAlertIcon.
• Progress — Progress ring while a command is carried out. Properties: progress, progressMode, progressValue.
• Badges — Badges in the corners of the symbol. Properties: badgeControl, badgeAlert, badgeInterlock, badgeCommandLocked.
• Style — Standard Perspective style object.

Component Events

The Filter has no component events of its own. The standard Perspective events, such as onClick, are available in the component’s event configuration. See Operating a Device.