Documentation > nControl > API Reference
Introduction
When you click on the monorail cross switch tile it will flip the cross switch by performing the flipSwitch()
function unless you override this by a custom procedure.
Event Scripts
Monorail cross switch tiles support the following event script:
API Functions
Tile Specific Functions
nMonorailCrossSwitchTile.clickTile(zone)
Simulates a mouse click on the tile; this executes the mouse click event script.
The argument zone specifies the mouse click zone where the virtual click appeared:
nMonorailCrossSwitchTile.flipSwitch()
Flips the switch; if the switch in the 'horizontal' position if flips it to the 'vertical' position and vice versa.
nMonorailCrossSwitchTile.flipSwitchRandom()
Flips the switch to a random position: horizontal or veritical. This function will never flip the cross switch to the 'motor mounting' position.
nMonorailCrossSwitchTile.getMouseClickZone()
Returns the zone that received the last mouse click:
nMonorailCrossSwitchTile.getState()
Returns the current state of the switch: nConst.MC_HORIZONTAL, nConst.MC_MOUNTMOTOR or nConst.MC_VERTICAL.
nMonorailCrossSwitchTile.publish(topic, data)
Publishes a message through the internal MQTT broker using the specified topic and data.
nMonorailCrossSwitchTile.setSwitchHorizontal()
Flips the switch to the 'horizontal' position.
nMonorailCrossSwitchTile.setSwitchMount()
Flips the switch to the 'motor mounting' position.
nMonorailCrossSwitchTile.setSwitchVertical()
Flips the switch to the 'vertical' position.
Inherited from nTile
nMonorailCrossSwitchTile.clearScreen() Clear all the text in the console window. nMonorailCrossSwitchTile.getTile(label) Returns the tile object specified by label. If there is no tile with the specified label, the function returns a None value. nMonorailCrossSwitchTile.print(text) Prints text in the console window. If the console window it not yet visible, printing text will make it visible. nMonorailCrossSwitchTile.showConsole(mode) Shows (mode = True) or hides (mode = False) the console window. nMonorailCrossSwitchTile.sleep(duration) Stops the execution of the script for the the given number of seconds. Note that duration can be a floating point number, e.g. to suspend the script for half a seconds use self.sleep(0.5). nMonorailCrossSwitchTile.timestamp() Returns the number of seconds that passed since nControl™ was launched. It returns a floating point value with the highest possible time resolution supported by your system. The difference between two time stamps provides the number of seconds elapsed between those two events. nMonorailCrossSwitchTile.localVars Base property to which you can add local variables that retain their value after the event script finishes. For example self.localVars.myVar = 5 adds a new property myVar to self.localVars and gives it the value 5. The localVars property is local to the current tile meaning that each tile has its own independent localVars property. nMonorailCrossSwitchTile.globalVars Base property to which you can add global variables that retain their value after the event script finishes. For example self.globalVars.myVar = 5 adds a new property myVar to self.globalVars and gives it the value 5. The globalVars property is global to nControl meaning that all tiles use the same globalVars property. As such globalVars can be used to exchange information between the tiles. |