Marker Plugin

[afman75]

Marker Plugin
-------------


Description: Plugin allows you to mark an LCDSmartie screen with invisble code to perfom an action on the screen. Plugin

was developed to fill void where no action like 'Perf' plugin can be used to switch themes or screens.

For example:

A clock screen is desired to be displayed most of the time but you want to switch to a computer monitoring theme every

ten minutes to display its info then return to the clock. This plugin allows you to invisibly mark the last computer

monitoring theme screen. Then perform an some action on it in the Actions tab. Works like an "If currentscreen = 1 then

GotoTheme(2)" in the actions tab if that was an available command.

USAGE:

There are two functions that exist in the plugin: Function1 marks the screen and Function2 is used in the

Actions tab.

Function1:


> $dll(Marker,1,{marker string}, {delay in seconds})

For example,

$dll(Marker,1,SecondTheme, 5)

Note: Nothing will be displayed on the LCD display nor take up any characters. usually place this command at the

bigginning of the screen or on an empty line. The delay is present so that the marked screen can display its information

before and action is taken on it. Usually set to one second before the screen timeout although can be set to zero.

Function2:

> $dll(Marker,2,,) There are no overloads, anything placed inside variables will be ignored.

This will return whatever value you placed in the string section of Function1. Use this in the Actions tab to perform

some operation.

For example,

If $dll(Marker,2,,) = SecondTheme The GotoTheme(2)

One final note:

If you are going to be switching screens and themes it is recommended that you group theme screens together in an

ascending order (1,2,3, etc.). This will reduce the action tab items and avoid having to make two actions. One to goto

the thmeme followed buy a goto screen. LCD Smartie goes to the next available theme screen after the current screen.

So, if theme1 is screens 1,3,5, and theme2 is screens 2,4,6 and screen 5 is markered and actioined so that is will goto

theme 2 screen 6 will be the next displayed screen. Therefore, if screen 6 is markered and actioned to return to theme1

LCD Smartie will only display screens 1,3,5,6. You would have to add a second goto screen action after the goto theme

action with screen 5 to return to screen 2.

For example,

If $dll(Marker,2,,) = SecondTheme The GotoTheme(2)
If $dll(Marker,2,,) = SecondTheme The GotoScreen(2)

Assuming screen 5 is markered >$dll(Marker,1,SecondTheme,{delay})

This will return the order to 1,3,5,2,4,6,1,3 etc...

Enjoy