The EndCapSize property defines the size of the end tip of a line (the EndCap). As with the EndCap property, typically you would set the EndCapSize on the Polyline Properties window or the Text Properties window and would not animate it. However, you can animate the EndCapSize if required. You can animate it so that it is a certain size by entering the relevant number for its expression or you can animate it so that the end tip changes size according to the value or state of an item in the database.
The numbers for the available sizes are:
| Number for Expression | Style (width x height) |
|---|---|
|
0 |
Small x Small |
|
1 |
Medium x Small |
|
2 |
Large x Small |
|
3 |
Small x Medium |
|
4 |
Medium x Medium |
|
5 |
Large x Medium |
|
6 |
Small x Large |
|
7 |
Medium x Large |
|
8 |
Large x Large |
For example, you could animate a line with an arrow tip so that the arrow tip increases in size when an alarm is raised for a point. To do this, you would enter the following expression for the EndCapSize property:
LOOKUP( "<DigitalPoint 2>.AlarmState" + 1, 0, 0, 3, 5, 8)
Where <DigitalPoint 2> is the location and name of the 2 bit digital point (do not enter the angle brackets < > ), the AlarmState is the point property that animates the EndCapSize property of the Mimic object and the numerical values are:
- +1 is needed as LOOKUP is 1 based (starts from 1) whereas the point's alarm states are 0 based (start from 0).
- The first 0 is the EndCapSize that is applied when the point has an alarm state of 0 (no alarms raised). The 0 EndCapSize is small x small.
- The second 0 is the EndCapSize that is applied when the point has an alarm state of 1 (alarms disabled). The 0 EndCapSize is small x small.
- The 3 is the EndCapSize that is applied when the point has an alarm state of 2 (acknowledged uncleared alarm). The 3 EndCapSize is small x medium.
- The 5 is the EndCapSize that is applied when the point has an alarm state of 3 (unacknowledged cleared alarm). The 5 EndCapSize is large x medium.
- The 8 is the EndCapSize that is applied when the point has an alarm state of 4 (unacknowledged uncleared alarm). The 8 EndCapSize is large x large.