home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computing 64 / ac064.adf / ScreenX.DOC / ScreenX.DOC
Text File  |  1993-07-22  |  9KB  |  210 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.1 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 is
  37. "Sleeping".  When it is sleeping, it is sitting on the Workbench screen
  38. showing you how much Chip and Fast RAM you have, and the current time.
  39. If you click in the ScreenX window (Thus activating it - You cannot
  40. tell if the window is active or not because of the text that's being
  41. printed on the title bar.  Just click in it and you will know it's
  42. active).  When it's window is active, you can either hit the Space Bar
  43. 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 of
  46. 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. That's about it.  If you have any problems, or any suggestions, please
  97. give my BBS a call (if you have a modem), or send me a large box of money
  98. with a note in it if you don't have a modem.  
  99.  
  100. Oh ya, I suppose some of you will actually want to PRINT screens with this -
  101. that's coming.  So is a Hot Key to get the thing up any time, rather than
  102. having to fish up the Workbench screen first.
  103.  
  104. Oh ya #2, there are a couple of command line options for this thing too.
  105.  
  106. If you run it from the Workbench, it will open the "Sleeping" window, but if
  107. you run it from the CLI, it will assume you want the "Awake" window.  If 
  108. you really want the sleeping window from the CLI, use the -S option.  Also,
  109. in order to keep the clock and memory count accurate, ScreenX updates it's
  110. little window 6 times a second.  If you find this slowing things down 
  111. a bit, you can use the -E (efficient) option from the CLI to make it only
  112. update the window once every 2 seconds or so.  
  113.  
  114.  
  115.             ...Steve
  116.  
  117.  
  118.     (Feeling guilty?  Just dying to send money somewhere?  I couldn't
  119.     leave out my address, now, could I?)
  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.    
  129. Actually, if you want the source for it, send me a disk with some sort
  130. of a return mailer thing, (maybe even throw in some cash, eh?), and
  131. I'll send it to ya.
  132.  
  133.  
  134.  
  135. Addendum:
  136.  
  137. Now, whenever you pop a screen to the front, ScreenX assumes you don't
  138. want it any more, and shrinks itself into the small window.  Just
  139. thought you'd like to know.
  140.  
  141.  
  142.  
  143.  
  144. /*********************************/
  145.    NEW INFO FOR V2.1 OF SCREENX:
  146. /*********************************/
  147.  
  148. I don't think anybody ever actually wanted ScreenX to come up with the
  149. big window open, so I took that option out altogether.  When you say
  150. "Run ScreenX", it just opens the small window.
  151.  
  152. Put ScreenX in your startup sequence!
  153.  
  154. If you want to put ScreenX in your Startup-Sequence, you're going to
  155. have to use a program like RunBack or the arp Arun command or else you
  156. are not going to be able to close the CLI window that you ran ScreenX
  157. from.  Stupid, eh?  (It's not new to this version, but I don't think I
  158. told anybody this in the old docs).
  159.  
  160. I added the ability to print screens.  After seeing my name mentioned
  161. in Info magazine, I figured I owed it to the world... 8-).  Anyways, 
  162. click on the screen you want printed, and then click on "Print Screen"
  163. and it will start doing it.  If you click on the Print Screen gadget
  164. while the screen is being printed, it will usually STOP the print
  165. (unlike most programs that tell you to click stop, but really they just
  166. ignore you).
  167.  
  168. Little warning here about printing screens:  Just after I added the
  169. Print Screen gadget, while I was testing it, I ran into a weird problem
  170. - I could print, say, the DiskX screen, but if I tried to print the
  171. ScreenX screen, or the Workbench screen, I'd get a blank page.  Well,
  172. after THREE HOURS of working on this (starting at 11 PM..), I finally
  173. figured out that if your preferences are set for Black and White, and 
  174. your screen colors are sorta not far enuf apart to be Black and White,
  175. it will print all white - White's an easy color to print...  Anyway,
  176. either fiddle with the Threshold thing in Preferences, or use Grey
  177. Scale mode.
  178.  
  179. Another new gadget: Screen Info.  What this does, is tell you my BBS
  180. number!  There are also some less useful stats there, like the current
  181. font that screen is using, the amount of memory that screen is using
  182. (Note: If it says 32K, it really means 32000 bytes), the number of
  183. Windows open on that screen, and the number of Gadgets on that screen.
  184. The depth of that screen too - Depth = Number Bitplanes.  (It's always
  185. fun to run a bunch of programs, and then try to find all the
  186. gadgets...)
  187.  
  188. Ummmm, that's about it for now I guess.  If anybody can think of some
  189. more stats to stick in the "Screen Info" window, let me know - I  sure
  190. can't.
  191.  
  192. Plea: Instead of sending me money, feel free to send me original
  193. software. Especially if you write software - It costs you next to
  194. nothing to send me one, and who knows, one of these days I may actually
  195. send out an upgrade or something.  (More likely I'll sell your name and
  196. address to one of those horrid companies that sends you junk mail, if
  197. they pay me enough.  Maybe not).
  198.  
  199.                                                       ...Steve
  200.  
  201. NEWS FLASH:
  202.  
  203. New command line option - If you DONT specify "-C" on the command line,
  204. ScreenX will convert colors 1 and 0 into Black and White for the 
  205. print job - This ensures that something always gets printed.  This
  206. will screw up anything to do with color, or grey scales, so if you are
  207. printing color, specify the -C on the command line.
  208.  
  209. And it's an even 15,000 bytes now!
  210.