home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / mag_discs / volume_9 / issue_12 / welcome / !WelcomeA / !Help < prev    next >
Text File  |  1994-10-02  |  5KB  |  183 lines
  1. Documentation for WelcomeA, an alternative desktop welcome screen
  2.  
  3. Program and documentation are Copyright ⌐ Cy Booker 1993, 1994
  4.  
  5.     This program is distributed in the hope that it will be useful,
  6.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  7.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  8.  
  9.  
  10. Requirements
  11. ============
  12.  
  13.         RISC OS 3.00 or later
  14.         Knowledge of !Boot files
  15.  
  16.         Risc PC users please see below
  17.  
  18.  
  19. What's This
  20. ===========
  21.  
  22.         This is a program that GENERATES a module.  This module, will
  23.         provide an alterative "Desktop Welcome" screen.  The standard
  24.         welcome screen is the one with all those fonts in it, you know,
  25.         the thing that made you save the font cache & load it in your
  26.         boot file :-)
  27.  
  28.  
  29. Risc PC users
  30. =============
  31.  
  32.         With the advant of RISC OS 3.5 the boot sequence has been
  33.         radically altered, which affects the setting up and use of
  34.         WelcomeA significantly.
  35.  
  36.         To install WelcomeA run !WelcomeA as per normal.  This creates
  37.         a directory <Choices$Dir>.Boot.PreDesk.WelcomeA and places
  38.         various things in there.
  39.  
  40.         This will cause the module to be loaded before the desktop is
  41.         started.
  42.  
  43.         To `run' this now press CTRL-SHIFT-F12 and hit RETURN.
  44.  
  45.         If you decide that you do not like WelcomeA then please run
  46.         the file !WelcomeA.RiscPC.DeInstall.
  47.  
  48.         Please also read the Problems section below, particularly the
  49.         point about the 256 colour sprites.
  50.  
  51.  
  52. One Second Guide
  53. ================
  54.  
  55.    1.   Run the application
  56.  
  57.    2.   Ignore the error message
  58.  
  59.    3.   CTRL-SHIFT-F12
  60.  
  61.    4.   RETURN
  62.  
  63.    5.   Read the documentation
  64.  
  65.  
  66. Quick Guide
  67. ===========
  68.  
  69.    0.   If you have a Risc PC see your own section above
  70.  
  71.    1.   Alter your !Boot (*) file to include the line
  72.            RMEnsure WelcomeAnimate 1.10 RMLoad [path].!WelcomeA.Module
  73.  
  74.         **BEFORE** the line that calls the desktop boot file.
  75.         Putting the above line in the DeskBoot file will NOT suffice
  76.  
  77.    2.   CTRL-SHIFT-F12
  78.  
  79.    3.   RETURN
  80.  
  81.    4.   Say "cor"
  82.  
  83.  
  84. (*)     See "About Boot Files" below
  85.  
  86.  
  87.  
  88. Not So Quick Guide
  89. ==================
  90.  
  91.    1.   Create a super spiffy sprite
  92.  
  93.    2.   Save this sprite as [path].!WelcomeA.Sprite
  94.  
  95.    3.   Run !WelcomeA.!Compile
  96.  
  97.    4.   Say "my, what a lot of flicker"
  98.  
  99.    5.   If you have a Risc PC then run !WelcomeA
  100.  
  101.    6.   CTRL-SHIFT-F12
  102.  
  103.    7.   RETURN
  104.  
  105.    8.   Say "that's more like it"
  106.  
  107.  
  108.  
  109. Bloody Long Guide
  110. =================
  111.  
  112.    1.   Alter the values of the system variables set in the !Compile
  113.         script file so that the module is saved in !System.Modules
  114.  
  115.    2.   If you do NOT have a Risc PC then change your !Boot file so it
  116.         loads the module from the system directory
  117.  
  118.    3.   Load !WelcomeA.Source into your favourite editor
  119.  
  120.    4.   Fiddle about with the constants at the start
  121.  
  122.    5.   Repeat the Not So Quick Guide
  123.  
  124.  
  125.  
  126. About Boot Files
  127. ================
  128.  
  129.         For Risc PC users please see your own section.
  130.  
  131.         You'll have to look it up in the manual, as boot files are so
  132.         environment-specific.  Basically you have an OBEY file called
  133.         !Boot in your root directory.  This probably ensures various
  134.         modules are loaded and then executes your DESKBOOT file.  You
  135.         need to make sure that the module generated by this program is
  136.         loaded BEFORE the desktop starts up.
  137.  
  138.  
  139. Problems
  140. ========
  141.  
  142.         You *must* ensure that the Sprite that's used is the same
  143.         screen mode / palette as the Wimp's desktop.  In particular the
  144.         sprite distributed with WelcomeA is only 16 colours, so if your
  145.         desktop boots into 256+ colours then you won't see much.  Note
  146.         that if you run !Compile on a 256 colour/large sprite then you
  147.         may (will) have to increase the numbers after the WimpSlot
  148.         command inside !Compile.
  149.  
  150.         If your desktop boots into a large screen mode then you may have
  151.         to disable buffering (see !Compile).  This is because there will
  152.         not be enough screen memory for two screens.
  153.  
  154.         You must disable any other program that displays its own desktop
  155.         banner.  The computer will only display one banner.
  156.  
  157.  
  158. Updates
  159. =======
  160.  
  161.         18.06.1993 1.00 working, no documentation
  162.         27.06.1993 1.10 documentation
  163.         02.10.1994 1.20 documentation/files for Risc PC users
  164.  
  165.  
  166. Author
  167. ======
  168.  
  169.         This program is FREEWARE.
  170.         Any bugs/feedback most welcome.
  171.  
  172.                         Cy Booker
  173.                         86 Church View
  174.                         Main Road
  175.                         Crockenhill
  176.                         Swanley
  177.                         Kent
  178.                         BR8 8JW
  179.                         U.K.
  180.  
  181.         Internet: cy@cheepnis.demon.co.uk            Arcade BBS: #1706
  182.  
  183.