RotateSource Property
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:
(1)(1)(1)(1)(2)(1)(1)(1).png?sv=2022-11-02&spr=https&st=2026-02-06T04%3A50%3A22Z&se=2026-02-06T05%3A01%3A22Z&sr=c&sp=r&sig=%2B9PESsULS%2B2nIRQmPFWMJW%2Bp%2BIcYBV53aR0p5vMoQ%2FI%3D)
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.