Changes between Version 12 and Version 13 of ScreensaverEnhancements


Ignore:
Timestamp:
Mar 6, 2009, 3:20:52 AM (15 years ago)
Author:
charlief
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ScreensaverEnhancements

    v12 v13  
    1616 * when loading the next graphics application.
    1717
     18== Configuration file ==
     19
     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.
     21
     22The format is:
     23
     24{{{
     25<default_gfx_duration>600</default_gfx_duration>
     26<science_gfx_duration>1800</science_gfx_duration>
     27<science_gfx_change_interval>600</science_gfx_change_interval>
     28}}}
     29
     30This would say to run the default graphics app for 10 minutes (600 seconds),
     31then run science app graphics (if any are available) for 30 minutes, changing among science apps every 10 minutes (if multiple tasks are running),
     32then repeat the entire sequence.
     33
     34Each of the three fields is optional, and the file itself is optional.  If not otherwise specified, the default values for the three fields are the ones shown in the example above. 
     35
     36 
    1837== Default Graphics Application ==
    1938
     
    2847 * 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.
    2948
    30 
    31 == Configuration file ==
    32 
    33 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.
    34 
    35 The format is:
    36 
    37 {{{
    38 <default_gfx_duration>600</default_gfx_duration>
    39 <science_gfx_duration>1800</science_gfx_duration>
    40 <science_gfx_change_interval>600</science_gfx_change_interval>
    41 }}}
    42 
    43 This would say to run "boincsr.exe" for 10 minutes (600 seconds),
    44 then run science app graphics (if any are available) for 30 minutes, changing among science apps every 10 minutes (if multiple tasks are running),
    45 then repeat the entire sequence.
    46 
    47 Each of the three fields is optional, and the file itself is optional.  If not otherwise specified, the default values for the three fields are the ones shown in the example above. 
    48 
    49 The screensaver coordinator program will run the default graphics app instead of science graphics when no project graphics are available.  This can occur for a number of reasons, such as when BOINC is suspended or idle, when the running science applications don't support graphics, etc.  In these cases, the default graphics app should indicate the reason for not displaying science graphics.
    50 
    51  
    52 == Default graphics app ==
    53 
    5449The default graphics app will be implemented using OpenGL,
    5550using the BOINC graphics library framework.
    5651It will be configurable via a local XML file,
    5752and also via general preferences.
     53
     54
     55The screensaver coordinator program will run the default graphics app instead of science graphics when no project graphics are available.  This can occur for a number of reasons, such as when BOINC is suspended or idle, when the running science applications don't support graphics, etc.  In these cases, the default graphics app should indicate the reason for not displaying science graphics.
     56
     57
    5858Optional components:
    5959