Event to Action
Overview
Use this operator to translate an Event Marker (link) into an Action (link).Operator ports
Input Any: Any sample type. The connection is not limited to one type of signal.Output Any: Any sample type. The connection is not limited to one type of signal.
Properties
Find more information about changing properties here: linkEventCode
type: See descriptionThe event code that is this operator will filter out of the data stream and convert to an Action.
RemoveEvent
type: True or FalseSet to True, if the filtered event should be removed from the signal.
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'
Action
type: Select from the listThe action code that is sent to the system. Select from the list.
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 the Action targets. The address should start with '$'.
You may type or paste the address, or you may press the small button on the right to open the Address Searcher dialog (link)
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.
Variable Parameters
Find more information about Variable Parameters here: linkEventCode
type: See descriptionThe event code that is this operator will filter out of the data stream and convert to an Action.
Value
type: See descriptionReads or changes the value, if one is needed for the Action or to set a value in Address.
Details
An event marker is a kind of flag that has been put to one sample by, for example, the Event Trigger (link). An event marker has an Event Code, with which it can be identified.If an Event to Action operator is inserted in a channel bus where at some points in time event markers will pass, then the Event to Action can filter out the events with the Event Code that is specified in the EventCode property.
Whenever the event filter encounters an event with the correct number, it can perform an Action, such as letting the project move to the next page (SHOWPAGE) or any other actions.
The Event to Action works for all types of signals.