home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 160.lha / ScreenX.Docs < prev    next >
Encoding:
Text File  |  1988-04-27  |  8.5 KB  |  201 lines
  1.  
  2.  
  3. ScreenX Documentation - By Steve Tibbett.
  4.  
  5. ScreenX is a program designed to be put into your Startup sequence. It
  6. 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. NOTE: INFO NEW TO V2.2 IS AT THE END OF THIS DOCUMENT.
  11.  
  12.  
  13. Clearly Written Documentation??  Come on, it's a PD program!!
  14.  
  15.  
  16. ScreenX's major functions are:
  17.  
  18.  1: Provide a small clock/memory counter on the Workbench Screen,
  19.     which will take very little processor time yet be accurate.
  20.  
  21.  2: Provide a means to recover those screens that are "Lost" behind
  22.     those stupid programs that don't bother to put Depth gadgets
  23.     on their screens.  IE, Chessmaster.
  24.  
  25.  3: Provide an easy way to save a screen to an IFF file (Easier than
  26.     "Flip the screen you want to the front within 10 seconds" anyway).
  27.  
  28.  4: Give me something to do for a couple of evenings.
  29.  
  30.  5: Be small enough to be put into your Startup Sequence and not take
  31.     much memory. 
  32.  
  33.  
  34. ScreenX accomplishes all of these quite well.
  35.  
  36. ScreenX has two modes of operation:  When it is "Awake", and when it
  37. is "Sleeping".  When it is sleeping, it is sitting on the Workbench
  38. screen showing you how much Chip and Fast RAM you have, and the
  39. current time. If you click in the ScreenX window (Thus activating it -
  40. You cannot tell if the window is active or not because of the text
  41. that's being printed on the title bar.  Just click in it and you will
  42. know it's active).  When it's window is active, you can either hit the
  43. Space Bar or the Right Mouse Button to "Wake Up" ScreenX.  
  44.  
  45. When ScreenX is awake, it opens up it's own Screen (Taking about 25K
  46. of memory doing so, which is why I made the small window in the first
  47. place). On the left of this screen is a list of all the screens that
  48. are currently in the system, and on the right of the screen are 7
  49. gadgets allowing you to tell the program what to do.
  50.  
  51. These gadgets are:
  52.  
  53.    Pop Screen To Front:  This gadget will take the currently selected
  54.                          screen and pop it to the front.  Handy for getting
  55.                          'Hidden' screens back.
  56.  
  57.    Push Screen To Back:  If you have 4 screens in memory, and one of them
  58.                          doesn't have Depth gadgets, you can push that
  59.                          one to the back, and as long as you don't click any
  60.                          of the other screens back behind it, you won't
  61.                          have any problems.  (If you do click anything else
  62.                          behind it, you'll have to use ScreenX to get them
  63.                          back!)
  64.  
  65.   Update Screen List:  This will redraw the list of screens that is
  66.                        being shown.  Necessary if any of the screens
  67.                        there leave while you are looking at them, or if
  68.                        new screens appear.   Note that any action taken on
  69.                        a screen that is no longer around is ignored (even
  70.                        clicking on it).
  71.  
  72.   Cycle All Screens:  I'll let you figure this one out on your own.  Note
  73.               that to make it stop, you must click anywhere in the
  74.                       main ScreenX screen...
  75.  
  76.   Close Screen:  Danger.  You got it.  This isn't something you should be
  77.                  doing unless you KNOW what you are doing.  It will let
  78.                  you CLOSE DOWN the screen of your choice.  The problem
  79.                  with this is that if anybody else decides to write on that
  80.                  screen at any time, BOOMO.  What it's really useful for is
  81.                  when a program crashes, you can close it's screen to free
  82.                  up a bunch of Chip RAM that is taken up.  Just make sure
  83.                  you don't go closing the Workbench down, or something
  84.                  stupid like that.  OK?
  85.  
  86.   Save Screen to IFF File:  This gadget will instantly turn the screen Red
  87.                             (so you know something's going on), and save
  88.                 the screen selected into the filename in the
  89.                 Text gadget at the bottom of the screen.
  90.                 Note that the filename in that gadget must
  91.                 include the full pathname, or else if you just
  92.                 type a filename in there, it will be written to
  93.                 the current directory.
  94.  
  95.  
  96.  
  97. Oh ya... there are a couple of command line options for this thing too.
  98.  
  99. COMMAND LINE OPTIONS:
  100.  
  101. There are a couple of options you might want.
  102.  
  103.   -C : This will DISABLE changing colour 0 to White and colour 1 to Black for 
  104.        printing purposes.  Without this option, when you tell it to print a
  105.        screen, color 0 and color 1 become white and black, which makes the
  106.        printout usually look better (depending on what you are printing).
  107.        If you are printing digitized pictures, or anything else where the
  108.        colours actually matter, then you NEED this option.
  109.  
  110.   -E : ScreenX will eat up about 5% of the processor's time keeping the memory
  111.        display accurate.  If you don't like this, you can put "-E" on the
  112.        command line, which will tell it to only update the display about
  113.        once every second and a half - this way, it's really taking NO 
  114.        time.
  115.  
  116.   -F : This option will display the free memory as BYTES rather than
  117.        as K.  It makes the window a little bigger, but some people
  118.        like seeing 200000 rather than 200.
  119.  
  120.  
  121.         ...Steve Tibbett
  122.            2710 Saratoga Pl. #1108
  123.            Gloucester, Ontario
  124.            K1T 1Z2
  125.  
  126.     (or just call my BBS at 613-731-3419).
  127.     (or send me BIX mail at 'S.Tibbett')
  128.     (or Plink mail at "STEVEX")
  129.    
  130. Actually, if you want the source for it, send me a disk with some sort
  131. of a return mailer thing, (maybe even throw in some cash, eh?), and
  132. I'll send it to ya.
  133.  
  134.  
  135. /*****************************************************************/
  136.  
  137. NEW INFO FOR V2.1 OF SCREENX:
  138.  
  139. I don't think anybody ever actually wanted ScreenX to come up with the
  140. big window open, so I took that option out altogether.  When you say
  141. "Run ScreenX", it just opens the small window.
  142.  
  143. Put ScreenX in your startup sequence!
  144. (This has changed - see the V2.2 notes)
  145.  
  146. I added the ability to print screens.  Click on the screen you want
  147. printed, and then click on "Print Screen" and it will start doing it. 
  148. If you click on the Print Screen gadget while the screen is being
  149. printed, it will usually STOP the print (unlike most programs that
  150. tell you to click stop, but really they just ignore you).
  151.  
  152. Little warning here about printing screens:  Just after I added the
  153. Print Screen gadget, while I was testing it, I ran into a weird
  154. problem - I could print, say, the DiskX screen, but if I tried to
  155. print the ScreenX screen, or the Workbench screen, I'd get a blank
  156. page.  Well, after THREE HOURS of working on this (starting at 11
  157. PM...), I finally figured out that if your preferences are set for
  158. Black and White, and  your screen colors are sorta not far enuf apart
  159. to be Black and White, it will print all white - White's an easy color
  160. to print...  Anyway, either fiddle with the Threshold thing in
  161. Preferences, or use Grey Scale mode.  (NOTE that this has changed.
  162. See the command line options above.  Don't you wish I'd rewrite this
  163. manual?)
  164.  
  165. Another new gadget: Screen Info.  What this does, is tell you my BBS
  166. number!  There are also some less useful stats there, like the current
  167. font that screen is using, the amount of memory that screen is using
  168. (Note: If it says 32K, it really means 32000 bytes), the number of
  169. Windows open on that screen, and the number of Gadgets on that screen.
  170. The depth of that screen too - Depth = Number Bitplanes.  (It's always
  171. fun to run a bunch of programs, and then try to find all the
  172. gadgets...)
  173.  
  174. Ummmm, that's about it for now I guess.  If anybody can think of some
  175. more stats to stick in the "Screen Info" window, let me know - I  sure
  176. can't.
  177.  
  178.  
  179. /******************************************************************/
  180.  
  181.  
  182. V2.2 NOTES:
  183.  
  184. This version has only three enhancements.
  185.  
  186. First, if you click in the title-bar-window, and hit "F", it will
  187. change it's display to "Largest:" and show you the Largest fragment of
  188. memory left in that section.  (If your largest memory fragment is too
  189. small, it's like you don't have any memory left.)
  190.  
  191. Secondly, if you put "-F" on the command line, instead of showing you
  192. the # of K you have free, it will show you the # of bytes free.  
  193.  
  194. Lastly, you NO LONGER NEED RUNBACK TO PUT THIS IN THE STARTUP
  195. SEQUENCE! Just put "SCREENX" on a line by itself.  No RUN needed
  196. either!  If you want ScreenX to come up when you boot, just copy 
  197. ScreenX V2.2 into the "C" directory (or onto the root directory) of 
  198. your boot disk.  Then, anywhere in your startup-sequence (before
  199. the ENDCLI of course), just put "ScreenX".
  200.  
  201.