home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 103.lha / screenx.doc < prev    next >
Text File  |  1986-11-20  |  5KB  |  129 lines
  1.  
  2.  
  3. ScreenX Documentation - By Steve Tibbett.
  4.  
  5. ScreenX is a program designed to be put into your Startup sequence.
  6. It provides a number of things that are already available in different
  7. packages, along with a couple of it's own twists.  
  8.  
  9.  
  10. Clearly Written Documentation??  Come on, it's a PD program!!
  11.  
  12.  
  13. ScreenX's major functions are:
  14.  
  15.  1: Provide a small clock/memory counter on the Workbench Screen,
  16.     which will take very little processor time yet be accurate.
  17.  
  18.  2: Provide a means to recover those screens that are "Lost" behind
  19.     those stupid programs that don't bother to put Depth gadgets
  20.     on their screens.  IE, Chessmaster.
  21.  
  22.  3: Provide an easy way to save a screen to an IFF file (Easier than
  23.     "Flip the screen you want to the front within 10 seconds" anyway).
  24.  
  25.  4: Give me something to do for a couple of evenings.
  26.  
  27.  5: Be small enough to be put into your Startup Sequence and not take
  28.     much memory. 
  29.  
  30.  
  31. ScreenX accomplishes all of these quite well.
  32.  
  33. ScreenX has two modes of operation:  When it is "Awake", and when it is
  34. "Sleeping".  When it is sleeping, it is sitting on the Workbench screen
  35. showing you how much Chip and Fast RAM you have, and the current time.
  36. If you click in the ScreenX window (Thus activating it - You cannot tell
  37. if the window is active or not because of the text that's being printed
  38. on the title bar.  Just click in it and you will know it's active).  When
  39. it's window is active, you can either hit the Space Bar or the Right
  40. Mouse Button to "Wake Up" ScreenX.  
  41.  
  42. When ScreenX is awake, it opens up it's own Screen (Taking about 25K of
  43. memory doing so, which is why I made the small window in the first place).
  44. On the left of this screen is a list of all the screens that are currently
  45. in the system, and on the right of the screen are 7 gadgets allowing you
  46. to tell the program what to do.
  47.  
  48. These gadgets are:
  49.  
  50.    Pop Screen To Front:  This gadget will take the currently selected
  51.                          screen and pop it to the front.  Handy for getting
  52.                          'Hidden' screens back.
  53.  
  54.    Push Screen To Back:  If you have 4 screens in memory, and one of them
  55.                          doesn't have Depth gadgets, you can push that
  56.                          one to the back, and as long as you don't click any
  57.                          of the other screens back behind it, you won't
  58.                          have any problems.  (If you do click anything else
  59.                          behind it, you'll have to use ScreenX to get them
  60.                          back!)
  61.  
  62.   Update Screen List:  This will redraw the list of screens that is
  63.                        being shown.  Necessary if any of the screens
  64.                        there leave while you are looking at them, or if
  65.                        new screens appear.   Note that any action taken on
  66.                        a screen that is no longer around is ignored (even
  67.                        clicking on it).
  68.  
  69.   Cycle All Screens:  I'll let you figure this one out on your own.
  70.  
  71.   Close Screen:  Danger.  You got it.  This isn't something you should be
  72.                  doing unless you KNOW what you are doing.  It will let
  73.                  you CLOSE DOWN the screen of your choice.  The problem
  74.                  with this is that if anybody else decides to write on that
  75.                  screen at any time, BOOMO.  What it's really useful for is
  76.                  when a program crashes, you can close it's screen to free
  77.                  up a bunch of Chip RAM that is taken up.  Just make sure
  78.                  you don't go closing the Workbench down, or something
  79.                  stupid like that.  OK?
  80.  
  81.   Save Screen to IFF File:  This gadget will instantly turn the screen Red
  82.                             (so you know something's going on), and save
  83.                 the screen selected into the filename in the
  84.                 Text gadget at the bottom of the screen.
  85.                 Note that the filename in that gadget must
  86.                 include the full pathname, or else if you just
  87.                 type a filename in there, it will be written to
  88.                 the current directory.
  89.  
  90.  
  91. That's about it.  If you have any problems, or any suggestions, please
  92. give my BBS a call (if you have a modem), or send me a large box of money
  93. with a note in it if you don't have a modem.  
  94.  
  95. Oh ya, I suppose some of you will actually want to PRINT screens with this -
  96. that's coming.  So is a Hot Key to get the thing up any time, rather than
  97. having to fish up the Workbench screen first.
  98.  
  99. Oh ya #2, there are a couple of command line options for this thing too.
  100.  
  101. If you run it from the Workbench, it will open the "Sleeping" window, but if
  102. you run it from the CLI, it will assume you want the "Awake" window.  If 
  103. you really want the sleeping window from the CLI, use the -S option.  Also,
  104. in order to keep the clock and memory count accurate, ScreenX updates it's
  105. little window 6 times a second.  If you find this slowing things down 
  106. a bit, you can use the -E (efficient) option from the CLI to make it only
  107. update the window once every 2 seconds or so.  
  108.  
  109.  
  110.             ...Steve
  111.  
  112.     (Feeling guilty?  Just dying to send money somewhere?  I am about
  113.      to buy a hard disk, y'know...)
  114.  
  115.            Steve Tibbett
  116.            2710 Saratoga Pl. #1108
  117.            Gloucester, Ontario
  118.            K1T 1Z2
  119.  
  120.     (or just call my BBS at 613-731-3419).
  121.    
  122.  
  123. Addendum:
  124.  
  125. Now, whenever you pop a screen to the front, ScreenX assumes you don't want
  126. it any more, and shrinks itself into the small window.  Just thought you'd
  127. like to know.
  128.  
  129.