Analog Threeway Valve
The Analog Threeway Valve is an automation symbol for a valve that connects three pipes, where each port can be set to any opening between closed and fully open, such as a mixing or diverting control valve. It is found in the Automation - OpenBridge section of the Perspective Component Palette as Valve - Threeway Analog (Experimental). It is a palette entry of its own, listed right after the Valve, which is for two-port valves only.
Note: This component is experimental: its properties may change in a later version.
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 Analog Threeway Valve shows the state it is given; it does not change it, and clicking it does nothing unless you configure an event.

The Analog Threeway Valve 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 Analog Threeway Valve. For a valve whose ports are only open or closed, use the Digital Threeway Valve; for a two-port control valve, the Analog Valve.
An Analog Threeway Valve dropped from the palette with default properties (all
ports at 0):

The valve has three ports and one side without a port. Bind open1, open2
and open3 to the opening of each port in percent, from 0 (closed) to 100
(fully open).
The ports are numbered from the side without a port, in the order left, stem,
right as seen with the stem pointing down. With the default
orientation bottom, port 1 is the left port, port 2 the
bottom port (the stem) and port 3 the right port. Port 2 is always the
stem; the numbering turns with the symbol.
A port counts as open when its opening is above 0. What the symbol shows:
- Fewer than two ports open — no flow can pass, so the valve is drawn closed (filled and grey) and the readout shows Closed.
- A port at
0while the two others are open — that port is drawn plugged (filled). - A port between
0and100— the shut part of the port is drawn as a shaded band at the port end; the band narrows as the port opens. - All three ports at
100— the open symbol.
The handle on top of the symbol shows how the flow from the most open port is split between the two others: upright when it all goes one way, level when it all goes the other, and tilted in between.
The headings give open1 / open2 / open3:
In a Connector Diagram, the medium flows only between the
ports that are above 0, and never through the side without a port.
0 / 0 / 0 |
100 / 0 / 0 |
100 / 100 / 0 |
100 / 0 / 100 |
0 / 100 / 100 |
|---|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
100 / 100 / 100 |
100 / 50 / 50 |
100 / 25 / 75 |
50 / 100 / 50 |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
The openings are only drawn on the symbol; the readout does not show them. Use the flow readout to show values.
Properties
Section titled “Properties”| Name | Description | Property Type |
|---|---|---|
| open1 | Opening of port 1 in percent, 0–100. Default 0. |
value |
| open2 | Opening of port 2, the stem, in percent, 0–100. Default 0. |
value |
| open3 | Opening of port 3 in percent, 0–100. Default 0. |
value |
Orientation
Section titled “Orientation”orientation names the side the stem (port 2) points to: bottom (default)
and top lay the valve on a horizontal pipe, left and right on a vertical
one. The images show ports 1 and 2 at 100 and port 3 at 0, so the plugged port
shows where port 3 ends up:
bottom (default) |
left |
top |
right |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
Where each port is, per orientation:
bottom— port 1 left, port 2 bottom, port 3 right.left— port 1 top, port 2 left, port 3 bottom.top— port 1 right, port 2 top, port 3 left.right— port 1 bottom, port 2 right, port 3 top.
Flow Readout
Section titled “Flow Readout”Flow through a three-way valve can go several ways at once, so the status row of
the readout is a list, set with flows:
- While no flow can pass (fewer than two ports above
0), the readout shows Closed, whateverflowsholds. - While flow can pass and
flowsis empty (the default), it shows Open. - Otherwise it shows one row per item in
flows.
| Closed | Open, no flows |
|---|---|
![]() |
![]() |
flows does not follow the ports: the component does not work out where the
flow goes. Bind or write the rows you want to show.
Each item is one of two kinds of row:
- Value row —
direction,valueandunit. Shows an arrow, the value with three digits (leading zeros greyed out) and the unit.unitdefaults to%. - State row —
directionandopen. Shows an arrow and Open or Closed. Withdirectionnone, the on or off icon is shown in place of the arrow.
A row is a state row as soon as it has an open key. A row added in the
Property Editor starts as a value row (direction none, value 0, unit
%); add an open key to it to make it a state row.
Example: two value rows, flow going right and down:
[ {"direction": "right", "value": 60, "unit": "%"}, {"direction": "down", "value": 40, "unit": "%"}]Example: two state rows:
[ {"direction": "right", "open": true}, {"direction": "down", "open": false}]| Value rows | State rows | State row, no arrow |
|---|---|---|
![]() |
![]() |
![]() |
Direction
Section titled “Direction”direction is the arrow in front of the row, pointing on screen: up, down,
left, right or none (no arrow). It does not turn with
orientation; point it the way the flow goes in your diagram.
up |
down |
left |
right |
none (default) |
|---|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
Properties
Section titled “Properties”| Name | Description | Property Type |
|---|---|---|
| flows | Readout rows, one per flow. Default [] (shows Open or Closed). |
array |
| flows[n].direction | Arrow in front of the row: up, down, left, right or none. Default none. |
value |
| flows[n].value | Value of a value row. Default 0. |
value |
| flows[n].unit | Unit of a value row. Default %. |
value |
| flows[n].open | Makes the row a state row: true shows Open, false shows Closed. Not present on a new row. |
value |
Variant
Section titled “Variant”variant selects whether the icon is drawn on a button or directly on the
background:
regular(default) — the icon sits on a round button.flat— only the icon is drawn, larger and without a button. Use it where the valve is part of a pipe in a diagram.
| Closed | Open | |
|---|---|---|
regular |
![]() |
![]() |
flat |
![]() |
![]() |
Properties
Section titled “Properties”| Name | Description | Property Type |
|---|---|---|
| open1 | Opening of port 1 in percent, 0–100. Default 0. See Ports. |
value |
| open2 | Opening of port 2, the stem, in percent. Default 0. |
value |
| open3 | Opening of port 3 in percent. Default 0. |
value |
| orientation | Side the stem points to: bottom, left, top or right. Default bottom. |
value |
| flows | Readout rows, one per flow. Default []. See Flow Readout. |
array |
| variant | regular draws the icon on a button, flat draws only the icon. Default regular. |
value |
Common Properties
Section titled “Common Properties”The Analog Threeway Valve 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 (here the flow readout) and the tag name. Properties:
showReadoutStack,readoutPosition,readoutSize,showStatus,showStatusIcon,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. - Static — Grey symbol for a device whose state is unknown. Properties:
static. - Alert Frame — Alert frame around the symbol. Properties:
alert,alertFrameType,alertFrameStatus,alertFrameMode,alertFrameThickness,showAlertCategoryIcon,showAlertIcon,alertIcon,alertLabel,alertTimer. - 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
Section titled “Component Events”The Analog Threeway Valve 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.
Found an error or something unclear?
Tell us what is wrong, confusing or missing on this page.
Built on the OpenBridge Design System






















