screen_saver.nrx                                       Version 1.91
  ----------------                           Copyright (c) 2005 [Yak]
		Copyright (c) 2005 NuukiaWorld (Temperature features)

  Inserts animated screen savers system into firmware. A screen saver
can be single picture or animation. Additionaly actual date and time
can be displayed using diffrent formats and styles. Different screen
savers can be set for different profile. Use this script several
times to add more screen savers.


PARAMETERS: []

filename - name of the file with picture, animation or screen saver
           definition, if not specified, default screen saver (as
           known from old keylock_clock.nrx script) will be added.

           For a list of supported picture/animation file formats
           please look into insert_graphics.rx script.

           Format of screen saver definition file can be found
           below.


Access settings menu with following definition:

  screen_saver


  It is a good idea to add this definition to "Tones" menu so it appears
in profiles menu (only when menu was dumped with dump_menu.nrx 1.8+).
This is beacause you will be able to set different screen savers settings
for every profile through "Profiles" menu without need to activate them.


New for 1.91:
- temperature features added

New for 1.9:
- uses separated short weekdays names from weekdays_ppm.txt

New for 1.8:
- profiled setting
- "Negative" option added
- Unicode support
- CLEAR keyword for @background command (see file format description)
- proper handling of hangup key

-------------------------------------------------------------------------

Screen saver skin file format:
==============================

  Skin file is a plain text file containing special commands.
Every command must be specified in its own line. A hash (#) at
start of a line marks this line as a comment.

# Here are the commands:
# (all arguments are optional, if not specified default value
# will be used)

@background bmp= left= top= [CLEAR]
# defines the background, as  give the filename of a
# graphic file, for list of supported formats please read
# insert_graphics.rx, if command is ommited, blank background
# will be used;  and  are the position coordinates;
# if the background is an animation and CLEAR keyword is
# specified, the background will be creared when screen saver
# enters "power save" mode, if not specified, animation will
# only be stoped (always on first frame)

@digital left= top= font= align= [XOR]
# enables digital clock,  and  are the position
# coordinates,  is a name of system font (for example
# "large/bold" or "small/plain"),  can be one of:
# "left", "center", "right" - it defines, how the 
# coordinate will be treated, in "left"  is the coordinate
# of text's start, in "center"  is the coordinate of text's
# middle, in "right"  is the coordinate of text's end;
# if XOR keyword is specified the pixels of clock that will be
# drawn over already set (by background) pixels will be !unset!
# (so if clock is drawn over black background, it will be white)

@weekday left= top= font= align= [SHORT] [XOR]
# enables weekday name displaying, parametes are the same
# as in @digital command, if SHORT keyword is specified
# the weekday name will be truncated to first two chars.

@date left= top= font= align= [DDMMYYYY|DDMM] [XOR]
# enables date displaying, parametes are the same as in
# @digital command, the date will be displayed in current language
# format unless DDMMYYYY or DDMM keywords are specified, if
# DDMMYYYY keyowrd is specified the date will be displayed in
# dd.mm.yyyy format, if DDMM keyword is specified the date
# will be displayed in dd.mm format.

@analog left= top= [XOR]
# enables analog clock displaying,  and  are the
# coordinates of hands start point (middle of the clock).

@addfont font=
# adds a font to the system so it can be used in screen saver;
# as  you have to give the name of a file containing the
# font in *.font format created by extract_ppm_fonts.nrx script;
# remember to set the  properties of other commands (see
# above) to the system name of the font (not the filename!);
# you can use more @addfont commands to add more fonts

@temp left= top= font= align= [SHORT] [F] [XOR]
# enables temperature display, parametes are the same as in
# @digital command, if SHORT keyword is specified the temperature
# will not include the unit ('C or 'F), if F keyword is specified,
# the temperature is displayed in Fahrenheit (some values are
# skipped in the Fahrenheit scale because of the 1-Celsius
# resolution of the current implementation)