home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsa / alphasave / !AlphaSave / Program / !ProgHelp / ProgHelp < prev   
Encoding:
Text File  |  1996-04-24  |  4.0 KB  |  100 lines
  1. >!Help file for...
  2.                 _     ___   _   _
  3.             /\ \ \   \   \ \ \_\ \    /\     ££££  ££  £   £ ££££
  4.            /  \ \ \   \  _\ \   _ \  /  \    £    £  £ £   £ £      Version
  5.           / __ \ \ \__ \ \   \ \ \ \/ __ \   ££££ ££££  £ £  ££££      0.00
  6.          /_/  \_\ \___\ \_\   \_\ \_\/  \_\     £ £  £  £ £  £
  7.          __________________________________  ££££ £  £   £   ££££
  8.  
  9.                          How to Program your Own!!
  10.  
  11.                     by Marc Warne of Alpha Programming
  12.                 “Alan Launches Partridge Hats Agressively”
  13.  
  14. ------------------------------------------------------------------------------
  15.  
  16. Warning: Programming Screensavers is only recommended to those are familiar
  17.          with ARM BASIC V.
  18.  
  19. How to Program Screensavers (In 3 Easy (?) Steps...)
  20. •••••••••••••••••••••••••••
  21.  
  22. Step 1: Create your screensaver directory
  23. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24.     Create a directory with the name '!AlphaS<no>', where <no> is a number
  25. between 1 and 16. Try to make it a different number from those already
  26. supplied.
  27.  
  28. Step 2: Create the resources
  29. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  30.     Copy the following files from the example screensaver: !DemoSave, into
  31. your own screensaver directory:
  32.                                   !Boot
  33.                                   !Run
  34.                                   !Sprites
  35.                                   !Sprites22
  36.                                   !RunImage
  37.  
  38.     You may also create your own !Help file if you wish. Now it's time to
  39. load !MakeData. Before you load it, remember the directory name of your
  40. program. Then load !MakeData. When it asks you to, type in the directory
  41. of the program. You will then be asked the following questions:
  42.  
  43. Name of Screensaver: <Type in the name>
  44. Screensaver Author : <Type in your name>
  45. Date               : <Type in date or press RETURN to use current one>
  46. Special Strings    : <Just ignore this>
  47. Short Description  : <Type in description>
  48.  
  49. Are you sure? (Y/N) <Press Y to save, or N to exit>
  50.  
  51. Step 3: The Programming
  52. ~~~~~~~~~~~~~~~~~~~~~~~
  53.     Load the example screensaver proviede (ie. !DemoSave). This is a fully
  54. working screensaver, which always changes picture. When you move/click the
  55. mouse or press a button on the keyboard. This is what all screensavers should
  56. be able to do. Now take a look at the program (the !RunImage file), itself.
  57. Let's take a look at the procedures in turn:
  58.  PROCfont
  59.  --------
  60.      This is the procedure which plots fonts. I have noticed a few problems
  61. with this and RISC OS 3.5/3.6, but I have no idea what they are about. To plot
  62. a font, use PROCfont(foreground,background,x,y,font$,text$,fontsize). An
  63. example would be PROCfont(9,7,150,RND(800),"Corpus.Bold","DEMO",170). This
  64. will plot a yellow font, aliased to black (with a black background), at co-
  65. ordinates x=150 and y=RND(800), with the font "Corpus.Bold", with the text,
  66. "DEMO" and at size 170.
  67.  
  68.  PROCwait
  69.  --------
  70.      Believe it or not, this procedure waits for a given amount of time!
  71. eg. PROCwait(150) will wait for 150 cs (centiseconds), or 1.5 seconds.
  72.  
  73.  PROCcheckmove
  74.  -------------
  75.      This procedure must be called as often as possible. It checks whether the
  76. mouse has moved, been clicked on or a button has been pressed. If it has, then
  77. the program will call PROCend, which will often end it.
  78.  
  79.  PROCend
  80.  -------
  81.      This program will end the program!!
  82.  
  83. That's all of the procedures. You must always do your loops in a REPEAT...
  84. UNTIL FALSE loop, otherwise it will end.
  85.  
  86. Wow!! Not it's time to be creative and design your own loops. Have fun!!
  87.  
  88. ------------------------------------------------------------------------------
  89.  
  90. The rules of ScreenSaving
  91.  
  92.     1. There must never by the same picture on the screen for a moderatly long
  93.        period of time.
  94.     2. They are good ways of advertising
  95.     3. Could you please send all of the ones you make to me, with permission
  96.        to distribute them in later versions of AlphaSave.
  97.     4. When you move the mouse or press a key, the screensave must exit.
  98.  
  99. -------------------------------------------------- © Alpha Programming 1996 --
  100.