This version adds a write-only RotateSource property to VirtualRouter Destinations and SapPropertyRouter Destinations. The property accepts a comma delineated list of source numbers. This can be used to rotate through a number of sources on a button push and/or to switch between two sources (for example a source and a cleared route) on each button press. For example:
In this example, the mousedown event of a button is used. And so each time the button is pressed (mousedown=true), the value 1,2,3 is sent to the destination's write-only RotateSource property. The logic that will take place under the hood is as follows:
If the current source is none of the source numbers in the list (not 1, 2, or 3), then source 1 will be applied.
If the source is currently source 1, then source 2 will be applied.
If the source is currently source 2, then source 3 will be applied.
If the source is currently source 3, then source 1 will be applied.
This can be useful for situations where you want to rotate thought multiple monitor channels. It can also be used when you want to switch between a route and a cleared route by using a value like: 2,0.
The RotateSource property is only applicable to VirtualRouter destinations and SapProperty router destinations.