Action Trigger
Overview
Use this operator to trigger an Action (link) as a result of a signal value. The Action is triggered as soon as the input value changes from 0 or less to 1.0 or more.Operator ports
Input S: Floating point valuesProperties
Find more information about changing properties here: linkAction
type: Select from the listSelect the code of the Action that is performed when the input value is greater or equal to 1.0.
Select one of those presets:
Value
type: See descriptionFill in a parameter value, if one is needed for the Action or to set a value in Address.
Address
type: Address, starts with '$' sign (see link)Fill in the address of the object that should receive the Action.
You may type or paste the address, or you may press the small button on the right to open the Address Searcher dialog (link)
AutoExtendAddress
type: True or FalseSet to True if the Address should be extended by the channel name that triggered the Action.
Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'
True or False
True may also be read like 'yes' and false like 'no'
The address is extended intelligently. For example, if the address is $Design.Input Field.Text$, then the channel name is added to Design.Input Field and not to Text. If a signal channel is called '10', then the address that is used becomes $Design.Input Field10.Text$. AutoExtendAddress also works for global variables, for example $MyVar$ could become $MyVar10$.
Caption
type: Word or phraseThe name of the object in the project. This name must not contain '.' or '$' characters.
Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.
Documentation
type: See descriptionOptional documentation of this object.
It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.
Details
The trigger input expects a trigger, which is a transition from 0 to 1. The input is expected to be a pseudo-boolean signal. It is not exactly defined on what value the trigger is detected (somewhere half-way between 0 and 1).It is allowed to connect a constant at the input of the Action Trigger, for example to connect to a Constant Button (link). The action will trigger as soom as the constant value changes from 0 or less to 1.0 or more. However, in such a case you would probably want to use an Action Button (link).
If the Action Trigger has multiple channels at its input bus, then those signals are considered all individually, all having there own trigger moment.
If you use the AutoExtendAddress property, it is possible to change the specified action address by extending it with the channel name.
For example, if AutoExtendAddress is True, and the address is $Design.Action, then if a channel is called 'Channel 1', the address is internally changed to '$Design.ActionChannel 1'. Note: You could use a Channel Terminal (link) to deliberately change channel names.
Examples
Example: Action Trigger Demo
Example of the Action Trigger operator. Fish and heart images are switched by a signal controled Action Trigger.Examples\DF0407011_001_ActionTrigger_Demo.xmc
Example: Action Trigger AutoExtendAddress Demo
Demonstrates the use of the AutoExtendAddress property of the Action Trigger. If AutoExtendAddress is set to True, then for each input channel, the channel name is added to the specified action address. In this example: the second channel is called 'C2', therefore the address is changed by putting 'C2' behind it, so the Action operator 'ActionC2' is called.Examples\DF0407011_002_ActionTrigger_AutoExtendAddress_Demo.xmc