home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Workbench / Patches / bootprogress.readme < prev    next >
Text File  |  1998-05-11  |  5KB  |  207 lines
  1. Short:    Progress bar while booting w/ picture
  2. Author:   bdf11146@fs2.bdtf.hu (┴lmos Rajnai)
  3. Uploader: bdf11146@fs2.bdtf.hu (┴lmos Rajnai)
  4. Type:     util/boot
  5. Requires: Kick V2.04, iff.library V23
  6. Replace:  util/boot/BootProgress.lha
  7.  
  8. ---------------------------------------------------------------------
  9.  
  10.  BootProgress V1.02
  11.  
  12.  Easy2use progress bar while your Startup-Sequence is running.
  13.  
  14.  Why BootProgress, and not an other one?
  15.  
  16.  * It is easy to use, needs just a few modification in your Startup-Sequence
  17.  * Fully system friendly, no hacking at all
  18.  * Can display an IFF/ILBM file
  19.  * It can divide the bar by itself
  20.  * It works after you or any program modified your Startup-Sequence
  21.  * It is Freeware
  22.  
  23.  How does it work?
  24.  -----------------
  25.  
  26.  The program consists two part: the main part is BootProgress, which shows
  27. the IFF picture, sets up all it needs, and waits. Then come BumpProgress, it
  28. tells the bumps to BootProgress. When a bump arrives (to the public port of
  29. BootProgress), the progress bar raises one step.
  30.  
  31.  Usage
  32.  -----
  33.  
  34.  Place to the beginning of Startup-Sequence the BootProgress. (It is better
  35. to place right after the SetPatch, but it's up to you.)
  36.  
  37.  The template of BootProgress is:
  38.  
  39.  PICTURE/A,XPOS/A/N,YPOS/A/N,WIDTH/A/N,HEIGHT/A/N,COLOR/A/N,BUMPS/N
  40.  
  41.  those parameters are:
  42.  
  43.    PICTURE/A - the full path and name of your picture to display
  44.    XPOS/A/N,YPOS/A/N - x and y position of left-up corner of your progress
  45. bar on the picture (numeric of course)
  46.    WIDTH/A/N,HEIGHT/A/N - width and height of your progress bar
  47.    COLOR/A/N - the color to use for drawing the bar
  48.    BUMPS/N - number of bumps (or steps, if you prefer) it is not need to be
  49. set, if it is missing, BootProgress counts the calls of BumpProgress in your
  50. Startup-Sequence, and uses as the number of bumps, you can override this by
  51. using this parameter
  52.  
  53.  After every time you want to force a bumping, just call BumpProgress.
  54.  
  55.  Do not use BumpProgress in other boot-up scripts (eg. User-Startup), than
  56. Startup-Sequence! If you want to use this way, you have to set bumps by
  57. yourself using BUMPS parameter! (Not adviced anyway.)
  58.  
  59.  When the progress bar filled up, BootProgress exits. You are also able to
  60. terminate BootProgress by starting again. (Both will be terminated of
  61. course.)
  62.  
  63. ---------------------------------------------------------------------
  64.  
  65. An example:
  66. -----------
  67.  
  68. c:setpatch >NIL:
  69. c:patchopenwb >NIL:
  70.  
  71. run >NIL: c:BootProgress work:visual/pictures/own/bootpic.iff 2 40 635 5 255
  72. ; x=2, y=40, width=635, height=5, color=255
  73.  
  74. Resident >NIL: c:bumpprogress PURE
  75.  
  76. C:AddBuffers >NIL: DF0: 15
  77.  
  78. [...snip...]
  79.  
  80. FailAt 21
  81. BumpProgress
  82.  
  83. C:MakeDir RAM:T RAM:Clipboards
  84.  
  85. [...snip...]
  86.  
  87. Assign >NIL: FONTS: Workbench:Fonts
  88. BumpProgress
  89.  
  90. C:IPrefs
  91. BumpProgress
  92.  
  93. BindDrivers
  94. C:Mount >NIL: DEVS:DOSDrivers/~(#?.info)
  95. BumpProgress
  96.  
  97. SetEnv Workbench $Workbench
  98.  
  99. [...snip...]
  100.  
  101. BumpProgress
  102.  
  103. C:ConClip
  104. Path >NIL: RAM: C: SYS:Utilities SYS:Rexxc SYS:System S: SYS:Prefs SYS:WBStartup SYS:Tools SYS:Tools/Commodities
  105. BumpProgress
  106.  
  107. IF EXISTS S:User-Startup
  108.   Execute S:User-Startup
  109. EndIF
  110. BumpProgress 
  111. ;That was the last bump, BootProgress terminates itself.
  112.  
  113. resident bumpprogress remove
  114.  
  115. C:LoadWB
  116. EndCLI >NIL:
  117. ---------------------------------------------------------------------
  118.  
  119. Don't forget to use Run command on BootProgress!
  120.  
  121. Check out of the cases of BumpProgress!
  122. BootProgress counts only when appears like "BumpProgress", and that is why I
  123. used lowercase version ("bumpprogress") when it was made resident, and when
  124. it was removed.
  125.  
  126. That's all.
  127. (Easy? Let's say.)
  128.  
  129. About included pictures
  130. -----------------------
  131.  
  132.  Bootpic1.IFF
  133.    640x480x256 AGA picture,
  134.    x:221 y:330 width:186 height:7 colour:16 (white), 57 (red)
  135.  
  136.  Bootpic2.IFF
  137.    640x480x256 AGA picture,
  138.    x:221 y:330 width:186 height:7 colour:255 (white), 169 (red)
  139.  
  140.  Bootpic3.IFF
  141.    640x480x16 ECS picture,
  142.    x:208 y:322 width:15 height:9 colour:16 (white), 4 (red), 5 (lila)
  143.  
  144. Warranty
  145. --------
  146.  
  147.    BootProgress is totally Freeware, you may use as you want, but
  148.  
  149.    THE AUTHOR DOES NOT ASSUME THE RESPONSIBILITIES OF ANY LOSS OF DATA OR
  150.  DAMAGE CAUSED BY USE, MISUSE OR CRASH OF THE PROGRAM.  YOU USE THIS TOOL
  151.  AT YOUR OWN RISK.
  152.  
  153. Thanks to
  154. ---------
  155.  
  156.   * Wouter van Oortmerssen for AmigaE
  157.   * Christian A. Weber for IFF.library
  158.   * Paolo Zanellati for pictures and bug reports
  159.   * Opi (Geo) of Bi°Hazard for support and beers together
  160.  
  161. Author of the program
  162. ---------------------
  163.  
  164.     ┴lmos Rajnai (Rachy/Bi°Hazard)
  165.  
  166.     E-Mail: bdf1146@fs2.bdtf.hu
  167.  
  168.     Normal mail:   H-8360 Keszthely
  169.                   BercsΘnyi M.u. 46.
  170.                         Hungary
  171.  
  172.  I am waiting for your bug report, suggestions etc...
  173.  
  174. Author of the pictures
  175. ----------------------
  176.  
  177.     Paolo Zanellati
  178.  
  179.     E-Mail: Paolo.Zanellati@Italy.Sun.COM
  180.  
  181. History
  182. -------
  183.  
  184.    V1.02 Last bump bug fixed, pictures included to the archive
  185.          (29. April 1998)
  186.  
  187.    V1.01 Width division fixed, thanks to Paolo Zanellati for bug report
  188.          (9. March 1998)
  189.  
  190.    V1.0 First public release
  191.         (6. March 1998)
  192.  
  193. See also
  194. --------
  195.  
  196.   game/misc/Shells.lha - a gambling game
  197.  
  198.   util/pack/XfdDir.lha - extension for Xfd.library
  199.  
  200.   pix/trace/Fanta.jpg  - a traced picture
  201.  
  202.   docs/mags/F0NT01.lha - F0NT06.lha - Hungarian all about disk mag
  203.  
  204.   util/mics/remover.lha - an uninstaller
  205.  
  206.   misc/emu/FastFormat1541.lha - a fast formatter for C=1541 floppy drive
  207.