Changes between Version 15 and Version 16 of ScreensaverEnhancements


Ignore:
Timestamp:
May 29, 2009, 9:42:59 AM (15 years ago)
Author:
Nicolas
Comment:

formatting

Legend:

Unmodified
Added
Removed
Modified
  • ScreensaverEnhancements

    v15 v16  
    1818== Configuration file ==
    1919
    20 The '''screensaver coordinator''' can be customized by including an optional XML configuration file named ''ss_config.xml''.  If used, it must be located in the BOINC data directory on both Mac and Windows.
     20The '''screensaver coordinator''' can be customized by including an optional XML configuration file named {{{ss_config.xml}}}.  If used, it must be located in the BOINC data directory on both Mac and Windows.
    2121
    2222The format is:
    2323
    2424{{{
     25#!xml
    2526<default_ss_first>0</default_ss_first>
    2627<default_gfx_duration>600</default_gfx_duration>
     
    3334then repeat the entire sequence.
    3435
    35 If the <default_ss_first> flag is 1, the sequence would first run the default graphics app for 10 minutes,
    36 then  continue as above.
     36If the {{{<default_ss_first>}}} flag is `1`, the sequence would first run the default graphics app for 10 minutes,
     37then continue as above.
    3738
    3839Each of the four fields is optional, and the file itself is optional.  If not otherwise specified, the default values for the four fields are the ones shown in the example above. 
     
    4647
    4748
    48 The default graphics app will usually be called with the command-line argument ''--fullscreen'', which may be ignored.  However, it must respond to either of two possible additional command-line arguments:
    49  * ''--retry_connect'' means that if the default graphics app is unable to connect to the BOINC Client via RPC, it should continue running and retry periodically.
    50  * ''--test'' means that it should try to connect to the BOINC Client via RPC once, then exit immediately whether or not it succeeded.    It should not open a window or draw anything to the screen.  This is used by the BOINC Manager to test whether the RPC is blocked by a local software firewall; if so, most firewalls will then display a dialog so the user can approve it.
    51  * When neither the ''--retry_connect'' or ''--test'' argument is passed, the default graphics app must return immediately with an error code of -107 if it can't connect to the BOINC Client via RPC.
     49The default graphics app will usually be called with the command-line argument '''--fullscreen''', which may be ignored.  However, it must respond to either of two possible additional command-line arguments:
     50 * '''--retry_connect''' means that if the default graphics app is unable to connect to the BOINC Client via RPC, it should continue running and retry periodically.
     51 * '''--test''' means that it should try to connect to the BOINC Client via RPC once, then exit immediately whether or not it succeeded. It should not open a window or draw anything to the screen.  This is used by the BOINC Manager to test whether the RPC is blocked by a local software firewall; if so, most firewalls will then display a dialog so the user can approve it.
     52 * When neither the '''--retry_connect''' or '''--test''' argument is passed, the default graphics app must return immediately with an error code of {{{-107}}} if it can't connect to the BOINC Client via RPC.
    5253
    5354The default graphics app will be implemented using OpenGL,