home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d01xx / d0100.lha / Conman / sideshow.doc < prev    next >
Text File  |  1987-09-07  |  2KB  |  44 lines
  1. ===========================     SideShow     ==========================
  2.  
  3. SideShow is a simple utility for use with the ConMan console handler.  It
  4. allows one or more "scratchpad" windows to be used to prepare commands for
  5. a host window; the commands are then slipped into the main command stream
  6. using a special "backdoor" mechanism implemented in the console handler.
  7.  
  8. Operation.
  9. Any number of "SideShow" windows may be opened by entering "run sideshow"
  10. from a command window.  Commands may then be entered and edited in the
  11. new window using the usual ConMan editing facilites.  Once the desired
  12. command or data sequence has been prepared, hit F8 to submit it to the 
  13. host's stream.  The host window need not be active to receive the command 
  14. stream; it may be sitting in the background somewhere.  The close gadget
  15. or F3 may be used to exit at any time.
  16.  
  17. A window definition may be supplied as a command-line argument.  For example,
  18. "run sideshow con:////BigGuy/c" specifies a full-screen window with a close
  19. gadget.
  20.  
  21. Note:  SideShow requires version V0.98B or later of ConMan; if used with 
  22. a prior version or with a normal DOS console, an error message will be 
  23. displayed whenever an attempt is made to transmit a sequence of commands.
  24.  
  25.  
  26. Principles of Operation.
  27. SideShow uses a special packet type called "ACTION_FORCE" (code 2001) which
  28. has been implemented in the ConMan console handler.  This packet takes 
  29. the same parameters as a "write" packet, but causes the data to be entered
  30. into the input stream, just as though it had been typed at the keyboard.  
  31. The stream is edited in exactly the same fashion as actual keyboard input
  32. input, so control sequences may be included for special effects.
  33.  
  34. This program serves as an example of function-key interrupt processing
  35. using the ConHandler library functions.  In this case the keys of interest
  36. are F3, F8, and HELP; the "close gadget" event is also checked, but is
  37. passed back to the console handler rather than being trapped.  The assembly
  38. source code for "SideShow" is available.
  39.  
  40. 'C' programmers should note that the event handler function may be written
  41. entirely in 'C', as the arguments are available on the stack as well as in 
  42. registers.  I've put together preliminary documentation and the binding
  43. functions; call or write for details.
  44.