There are generally 3 types of commands for various gadgets
shownXXX, showXXX and visibleXXX + additional forceXXX
shownXXX - shows whether gadget is enabled at all. It will usually have dexcription.ext param like showXXX = 1; But can also be force enabled/disabled with showXXX command
showXXX - command to force enable or disable the gadget (see above)
visibleXXX - this command returns the visibility of the gadget on the screen, whether user can see it.
forceXXX - usually gadgets have own key shortcut, but this command will force activate the gadget from script.
For example, map, the most complete of them
shownMap - is true if showMap = 1; (default) in description.ext or showMap true is executed to force enable it.
showMap - will enable map even if it is disabled with showMap = 0; in description.ext
visibleMap - will return true if the map control is visible to the user (even if map is disabled)
forceMap - will force open/close map
Almost every gadgets behaves this way. With UAV feed this is inconsistent:
- showUAVFeed = 1; or showUAVFeed = 0; in description.ext makes absolutely no difference to what shownUAVFeed command returns.
- shownUAVFeed is actually (non-existent) visibleUAVFeed, because it returns the visibility of UAV Feed control
- showUAVFeed is what should have been called forceUAVFeed, because it force activates / deactivates the UAV feed on the screen
UAVFeed commands should behave Analogously to Map commands for consistency, unless of course consistency is not a priority.
shownUAVFeed - shall be true if showUAVFeed = 1; in description.ext or showUAVFeed true is executed to force enable it.
showUAVFeed - should enable UAVFeed even if it is disabled with showUAVFeed = 0; in description.ext
visibleUAVFeed - should return true if the UAVFeed control is visible to the user (even if UAVFeed is disabled)
forceUAVFeed - should force open/close UAVFeed