43
User_Manual_RP3001k.doc
Script Options
You can override Digi-Frame’s default options (parameters) by specifying your own. The general format of each
line in the scriptfile is a URL (local or remote) to the media item (image, movie or other playable file),
optionally followed by a comma, then a comma-delimited list of options (optionally with an equals sign and a
value to assign to the option), up to a total length of 2,048 characters (2Kbytes). This can be expressed more
formally as:
Media-URL[,option1[=value1],[…],optionn[=valuen]]
For example, to display a JPEG image residing on the Digi-Frame’s hard drive named picture1.jpg with a pause
time of 3 seconds and a dissolve transition, you would enter the following line in your script file:
picture1.jpg,pause=3,transition=dissolve
Options appearing on a line with a media item reference apply only to that media item. Options not explicitly
defined on a script line will use the system defaults for those options. System defaults can be set both by the
on-screen menu system and by script directives. To change the systemwide default of an option in a script, use
the “setdefault” directive on its own line like this:
setdefault,option1[=value1],[…],optionn[=valuen]]
For example, to set the default pause time to 5 seconds you would enter this line in your script file:
setdefault,pause=5
The setdefault directive sets a new system-wide default setting for the option(s) it specifies until overridden by
another setdefault directive or the manual default settings in the menu system.
Below is a list of options and directives supported by the current software. Future software versions will
support additional options. Note that options are case-sensitive.
backlight=[0 or 1]
Enables (1) or disables (0) the LCD backlight. For instance, you can turn the backlight off for one hour
with a line that reads:
dummy.jpg,backlight=0,pause=3600
(The dummy.jpg file does not need to exist). Remember to turn the backlight on again!
Hardware Note: On current production units, background audio will continue to play from internal
speakers while the backlight is off. On older production units, the internal speakers will cut out when
the backlight switches off. On all units, audio will continue to play on the line-out jack.
blocksize=[1 to 256]
Sets the block size for transitions that have configurable blocksize (currently, only the "blocks"
transition).
