home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / banner_1 / !BanEd_Documents_Banner_Help < prev    next >
Encoding:
Text File  |  1994-06-22  |  2.7 KB  |  66 lines
  1. !Banner Vsn 0.10 - Documentation
  2. --------------------------------
  3.  
  4. Index
  5. -----
  6.  
  7. Section A:  Introduction
  8.         B:  Getting !Banner to work
  9.         C:  Problems and further ideas
  10.         
  11. A: Introduction        
  12. ---------------
  13.  
  14.  !Banner is inspired by a plea in the DataFile catalogue for a program that will
  15. display banners for a predetermined time just like Impression does. The brief
  16. stated the need to display a sprite on the desktop with the ability to overlay
  17. text in any font and at any size upon the sprite. !Banner is designed to be
  18. placed within the directory of an application that needs a banner displayed.
  19.  !Banner acheives this using a script 'Language' which allows all these
  20. paramters to be changed easily and quickly in a seperate Text file whose name
  21. can be specified by the user and is placed within !Banner's directory. The
  22. sprite to be displayed is contained within a file whose name can be user-defined
  23. as can the name of the sprite to be displayed. The size of this sprite is
  24. determined and a window is created to fit the sprite and centred upon the screen
  25. and displayed for a period of time defined in the script file.
  26.  !Banner nominally claims 32K for itself and claims more memory depending on the
  27. size of the sprite file that contains the sprite to be displayed. Also please
  28. note that large hi-res sprites will lead to over 300K being claimed by the
  29. application. The application works as a seperate task and quits itself as soon
  30. as the window is closed.
  31.  
  32. B: Getting !Banner to work
  33. --------------------------
  34.  
  35.  It is expected that !Banner is run from another appliaction's !Run file using
  36. the following command:
  37.  
  38.  Run <App$Dir>.!Banner Script
  39.  
  40. where <App$Dir> is the system variable containing the parent application's
  41. filepath and Script is the name of the text file containing the script itself.
  42. In this way, !Banner can have more than one script file in its directory and the
  43. parent application can run a different script under different conditions.
  44.  Please note that !Banner must remain intact at all times - you must not dissect
  45. up !RunImage to include within your own application.
  46.  
  47.  
  48. C: Problems and further ideas
  49. -----------------------------
  50.  
  51. Problems at the moment:
  52.  
  53. - The whole program is not at all secure - people could easily change the script
  54.   file and ruin the whole display. Need some security somehow.
  55. - Command script is very limited. But I'm loathed to add things at the moment
  56.   until I hear from people and am told what is really needed.
  57.  
  58. Ideas for possible inclusion in next release
  59.  
  60. - Allow the system font to be scaled
  61. - Allow rotation and translation of text
  62. - Allow rotation and translation of sprite
  63. - Include option for OK buttons to remove window rather than a time delay
  64.  
  65.  
  66. © Brian Marsden 22/6/94