Configure a pushbutton animation for an analog value

You can configure an element with a pushbutton to set an analog value.

To configure an element with a pushbutton animation to set an analog value

1. Select the element.

2. On the Special menu, click Edit Animations. The Edit Animations dialog box appears.

3. Click the Add icon and select Pushbutton. The pushbutton animation is added to the Animation list and the Pushbutton state selection panel appears.

4. Click the Analog button. The Analog Pushbutton configuration panel appears.

5. In the Analog box, type an attribute reference or browse for one by using the browse button.

6. From the Action list, select:

   • Direct so the value becomes Value1 when the element is clicked and the mouse button held. The value returns to Value2 when the mouse button is released.

   • Toggle so the value becomes Value1 if it is Value2 and Value2 if it is Value1 when the element is clicked.

   • Set so the value is set to Value1 when the element is clicked

7. In the boxes Value1 and, if applicable, Value2, type analog values, attribute references or references.

8. From the Action list, select

   • Increment so the value is increased by Value1.

   • Decrement so the value is decreased by Value1.

   • Multiply so the value is multiplied with Value1.

   • Divide so the value is divided by Value1.

     (The Increment, Decrement, Multiply and Divide actions have not been tested on a non-English language Operating System. AVEVA OMI ViewApps and Web Client do not support these actions.)

     On selecting any of the above four options; you are presented with the following options:

     1. Percentage

        If Checked	If Unchecked
        Value1 will be the ramp percentage of the range (Maximum – Minimum).	Value1 will be the ramp value
        For example, when Increment action is selected where Value = 100, Value1 = 5, Minimum = 0, Maximum = 200. If Percentage is checked, it will ramp up the reference value by 5% x (200-0) = 10 and updated reference value = 100 + 10 = 110.	For example, when Increment action is selected where Value = 100, Value1 = 5, Minimum = 0, Maximum = 200. If Percentage is not checked, it will ramp up the reference value by 5 and updated reference value = 100 + 5 = 105.

     2. Value1: Value1 > 0 to ramp up the existing value; Value1 < 0 to ramp down the existing value.

     3. Restrict Values: Select the Restrict Values checkbox if you want to provide minimum and maximum values. If the Percentage option is selected, this option will be enabled but will appear grayed out to indicate that no changes can be made. You must provide Minimum and Maximum values.

        Percentage	Restrict Values	Reference Value (+,-,*,/)
        Unchecked	Unchecked	CurrentValue (operator) Value1
        Unchecked	Checked	CurrentValue (operator) Value1 (with restriction between minimum and maximum values)
        Checked	Unchecked	N/A
        Checked	Checked	CurrentValue (operator) [(Value1/100) * (Maximum-Minimum)]

     4. Minimum and Maximum:

        • During design time only constant values will be validated

        • The Minimum value must be less than the Maximum value

        • If you provide references they will be validated in runtime.

9. You can configure the value to be written when the mouse button is released instead. Select On button release. This does not apply if you select Direct as action.

10. You can configure the value to be written:

    • Continuously by selecting the Continuously while button is pressed. Also specify the frequency the value is to be sent, by typing a value in the Delay between value send box.

    • One time by clearing the Continuously while button is pressed.

      This does not apply if you select Toggle as action. If you select Toggle as action, the Continuously while button is pressed checkbox will be grayed out and disabled.

11. Specify that the pushbutton action is run by pressing a key or key combination. In the Shortcut area. Select a shortcut key in the Key list. Select CTRL and/or SHIFT to combine the shortcut key with the CTRL key and/or SHIFT key.

12. Preview the pushbutton run-time behavior by clicking Button in the Preview area. Click the button multiple times to preview the value changes over a period of time.

13. If you select the Increment, Decrement, Multiply or Divide action, then the Preview area will behave as follows:

    • Value will start from 100 and will be updated only if Value1, Minimum, and Maximum are constant values, else it will display No Preview.

    • Only mouse action with On button release option will update the preview value. Continuously while button is pressed option and Shortcut key will not update the preview value.

    • If Increment is selected with the Percentage option, the preview message will be Set to existing value plus Value1 %x (Max-Min) on mouse action, else the preview message will be Set to existing value plus Value1 on mouse action.

    • The preview message will differ for the action selected; Decrement (minus), Multiply (multiplied) and Divide (divided).

14. Click OK.