home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0200 - 0209 / ibm0200-0209 / ibm0200.tar / ibm0200 / LBPK10.ZIP / LITE.DOC < prev    next >
Encoding:
Text File  |  1994-04-21  |  8.9 KB  |  235 lines
  1. [PPE] LightBar toolkit v1.0
  2. Copyright (c)1994 Mr. Data Enterprises  04/21/94
  3.  
  4.  
  5. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  6. Intro:
  7. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  8. What you have in your hands is really a simple concept of allowing a way of
  9. making a system that lets a user select options via arrow keys and/or hotkeys
  10. in a very simplified manner.
  11. For arrow keys you may use either the gray arrows, number pad, Home, End,
  12. PgUp, or PgDn.  PgUp and PgDn move up or down 1/4 of the way.
  13. Please take time to read this doc as I will try to keep it simple, because
  14. there's a lot of little things you may need/want to know about.
  15.  
  16.  
  17. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  18. Quickie Startup for the Impatient or Lazy:
  19. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  20. Supplied are the following example setups and how to install them:
  21.  
  22. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  23. Replacement More? Prompt
  24.  
  25. In PCBTEXT #196 enter the following line (modify directory):
  26. !C:\PCB\PPL\LITE\LITE.PPE MORE
  27.  
  28. This runs the gives a display somewhat like:
  29.  
  30. ──More?── Continue NonStop Stop
  31.  
  32. ...with Continue highlighted first.
  33. move around to select the others or press the first letter of the option to
  34. move to it and press Enter to select.
  35.  
  36. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  37. Sample Help Menu
  38.  
  39. In CMD.LST, add the following commands:
  40.  
  41.     Command         Security  PPE/MNU File -or- Keystroke Replacement
  42.     ══════════════  ════════  ═══════════════════════════════════════
  43.     HELP                0     C:\PCB\PPL\LITE\LITE.PPE HELP
  44.     H                   0     C:\PCB\PPL\LITE\LITE.PPE HELP
  45.     ?                   0     C:\PCB\PPL\LITE\LITE.PPE HELP
  46.  
  47. This help system really is just a demonstration, you may want to read on and
  48. find out how to customize it to add new help commands to it.  Otherwise you
  49. get a quick list of the standard PCBoard commands drawn over the screen and
  50. the highlight starts on Abort and you may move around by arrows or common one
  51. key hotkeys.
  52.  
  53.  
  54. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  55. How The System Works
  56. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  57.  
  58. Wherever you want a prompt for lightbar entry to go, do a call to the LITE.PPE
  59. and as a parameter give the 8 character filename (.LIT extension assumed
  60. always) and it will use that configuration given in that file.  Configuration
  61. files must be in the PPE directory where LITE.PPE is located or it will not
  62. find your configuration.
  63.  
  64. Here is the format for these configuration (LIT) files:
  65.  
  66. ***Line 1 : X pos to start at for title
  67.  
  68.     In the beginning you can have it display strings of text or titles to
  69. as many places or times as you wish before the prompt is displayed.  This is
  70. useful in many areas, use your imagination :-).  For as many times as you want
  71. to display Title text, enter the XPos on first line...
  72. Feature:  There are many ways of figuring positions.  Enter these for Pos...
  73.  C    = Current Pos (no change)
  74.  Rxx    = Relative, move xx places from start of the beginning of prompt
  75.  Txx    = Relative, move xx places from end of last printed title
  76.  txx    = Relative, move xx places from start of last printed title
  77.  Ixx    = Relative, move xx places from end of last printed item or title
  78.  ixx    = Relative, move xx places from start of last printed item or title
  79.  xx    = Absolute, move to xx pos (direct to xx pos)
  80.  Axx    = Absolute, move to xx pos (just another way)
  81.  
  82. (for the impaired: Absolute - Direct to the specified number on the screen
  83.                    Relative - Move in a direction the specified number of
  84.                               places from current position)
  85.  
  86. ***Line 2 : Y pos to start at for title
  87.  
  88.     ditto, next line YPos
  89.     
  90. ***Line 3 : Title text
  91.  
  92.     one line text, file, or call PPE.
  93. Feature:  For any text entry line, you may use either straight text or use...
  94.  %drive:\path\filename.ext = display the file following the '%'
  95.  #drive:\path\filename.ext = clear screen and then display file following '#'
  96.  !drive:\path\filename.ext = call the PPE following '!'
  97.     
  98. -- Loop lines 1-3 until you're done displaying --
  99.  
  100. ***Line 4 : @X code for unhighlighted item
  101.  
  102.     the PPE knows the titles are done when the next line is an @X code.
  103. Here you give it a @X color for any unhighlighted item.
  104.  
  105. ***Line 5 : @X code for highlighted item
  106.  
  107.     yeah guessed, @X code for higlhighted items
  108.     
  109. ***Line 6 : Number of Items
  110.  
  111.     the PPE needs to know how many items are to be used.
  112.     
  113. ***Line 7 : X pos to start at for item
  114.  
  115.     Now you will give data for each item to use.  Start with XPos
  116.     
  117. ***Line 8 : Y pos to start at for item
  118.  
  119.     Yeah, you know
  120.     
  121. ***Line 9 : Item Text
  122.  
  123.     Text string for item.  Note: You may enter @X codes here as well to
  124. override the unhighlight color.
  125.  
  126. ***Line 10: Hotkey character
  127.  
  128.     This is the character that will allow the user to quickly jump to this
  129. item.  You may enter either one character representing the item, or use a
  130. helpful feature of the ^x control keys.  i.e. ^D = Control+D.
  131. Note: Do not attempt to use ^X as a hotkey since PCBoard takes that as a
  132. 'don't display anything' key which will kill any displaying of data to the
  133. screen.
  134.  
  135. ***Line 11: Text to display when selected (before stuffing) (put - for nothing)
  136.  
  137.     When an item is selected via Enter key, you may have it display a text
  138. string, file, or call a PPE.  after this you can stuff the keyboard with some
  139. text.  On this line you may enter the text, file, or call PPE line.
  140. If you don't wish to have a display show, put a - (dash) so that no characters
  141. are sent.
  142.  
  143. ***Line 12: Text to be keyboard stuffed
  144.  
  145.     This is the text to be stuffed.  You cannot use file or call PPE
  146. commands here.  There wouldn't be a reason to use a file anyway...  but if
  147. anyone can figure a reason, please send me.
  148.  
  149. -- Loop lines 7-12 for each item --
  150.     After all items are defined:
  151.  
  152. -- This is It! --  
  153. Configuration is over
  154.  
  155.  
  156. Good luck creating easy to use, good looking prompts that are all possible
  157. thanx to me (ego alert).
  158.  
  159. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  160. History
  161. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  162. Lightbar kit
  163. 1.0 - first release
  164.  
  165.  
  166. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  167. Author's Notice
  168. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  169. I program in PPE a lot recently since I put up my PCBoard BBS.  I've been
  170. hooked.  I have experience in 80x86 and even 6502 (eck :) assembly
  171. programming.
  172.  
  173. If you have a reason to contact me, please do so at:
  174.  
  175.     SnailMail:    Mr. Data
  176.             P.O. Box 1037
  177.             Pennsauken, NJ  08109-0537
  178.             
  179.     BBs:        (609)662-7314  14.4k v.32bis
  180.     FidoNET:    1:266/30.36
  181.     Internet:    Shawn.Poulson@f30.n266.z1.fidonet.org
  182.     
  183. I would like to hear any bug reports (there shouldn't be any from my testing),
  184. and especially any good ideas.  Or if you are a PPE coder yourself and you
  185. would like to talk, mail me.  If you made any PPE that is the same as mine,
  186. E-mail it to me UUEncoded so I can try to beat it. :)
  187.  
  188. I hope this 10min write is good enough.  I hope I haven't confused anyone.
  189.  
  190.  
  191. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  192. Quickie Reference
  193. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  194. ---------------------------------------------------------------------
  195.  for positioning:
  196.  C    = Current Pos (no change)
  197.  Rxx    = Relative, move xx places from start of the beginning of prompt
  198.  Txx    = Relative, move xx places from end of last printed title
  199.  txx    = Relative, move xx places from start of last printed title
  200.  Ixx    = Relative, move xx places from end of last printed item or title
  201.  ixx    = Relative, move xx places from start of last printed item or title
  202.  xx    = Absolute, move to xx pos
  203.  Axx    = Absolute, just another way
  204.  
  205.  for Title/Display text entries:
  206.  ...                       = any text, shown as-is
  207.  %drive:\path\filename.ext = display the file following the '%'
  208.  #drive:\path\filename.ext = clear screen and then display file following '#'
  209.  !drive:\path\filename.ext = call the PPE following '!'
  210.  
  211.  for Hotkey/Stuff text:
  212.  ...    = any text, stuffed as-is
  213.  ^x    = for control characters (i.e. ^A, ^Z)
  214.  
  215. -----
  216. Line 1 : X pos to start at for title
  217. Line 2 : Y pos to start at for title
  218. Line 3 : Title Text
  219. --
  220. Line 4 : @X code for unhighlighted item
  221. Line 5 : @X code for highlighted item
  222. Line 6 : Number of items
  223. --
  224. Line 7 : X pos to start at for item
  225. Line 8 : Y pos to start at for item
  226. Line 9 : Item text
  227. Line 10: Hotkey character or ^Ctrl code (i.e. A, ^Q)
  228. Line 11: Text to display when selected (before stuffing) (put - for nothing)
  229. Line 12: Text to be keyboard stuffed
  230. -----
  231.  
  232.  Repeat 1-3 for as many times as needed for text display
  233.  Repeat 7-12 for each item
  234. ---------------------------------------------------------------------
  235.