kitControl-OneShot
This component provides a single, temporary, status Boolean output for a specified duration (as set in the Time property). A OneShot action occurs with a false-to-true value transition at the In property, or with an invoked Fire action. When either of these conditions occurs, the component sets the Out property value to true and the Out Not property value to false for a time that is equal to the value of the Time property. When the time expires, these values revert to the previous default values.
OneShot is available in the Timer folder of the kitControl palette.
| Property | Value | Description |
|---|---|---|
| Facets | Config Facets window | Defines the text to display for each Boolean value. trueText configures the text to describe the state when the component returns true. falseText configures the text to describe the state when the component returns false. This definition applies to the Out value for this component. |
| In | true or false (default) and null definition | Defines the input value. You set this property by linking
a Boolean Out value to it. You can manually configure
the default state to a numeric value or set it to null, so that when no value is linked into this property, the component
uses the default value. The component passes this property value to
its Out property for the amount of time set in
the Time property. When null value is checked, the value displayed defaults to the incoming value from the device. If you remove the check mark you can configure the In value. |
| Time | hours minutes seconds (defaults to .5 second) | Determines how long the Out and Out Not properties hold their one-shot values. For example, a Time property value of 2 holds the Out property at true and the Out Not property value at false for two seconds. |
| Out | true or false (default) and null definition | Displays the current value (display text) that changes with
afalse to true transition at the In property value or a Fire action. Using the Facets property, you configure the Out value display text as desired. After a OneShot is triggered and the Time value period expires, this value returns to the default (false) value. null does not change the value with a OneShot Fire action or false to true transition at the In property value. When null value is checked, the value displayed defaults to the incoming value from the device. If you remove the check mark you can configure the In value. |
| Out Not | true (default) or false and null definition | Displays the opposite of the Out property.
This value changes with a false to true transition at the In property value or a Fire
action. After a OneShot is triggered and the Time value period expires, this value returns to the default (true) value. null does not change with a OneShot Fire action or false to true transition of the In property value. When null value is checked, the value displayed defaults to the incoming value from the device. If you remove the check mark you can configure the In value. |