home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / pscreen.lha / PublicScreen.doc < prev    next >
Encoding:
Text File  |  1992-07-07  |  7.9 KB  |  148 lines
  1.  
  2. PublicScreen.doc :  PublicScreen 1.02.10  (Release 1, rev 2 minor rev 10)
  3. ===============================================================================
  4. Copyright ⌐1992 Edward D. Berger, freely redistributable.
  5.  
  6. What is a Public Screen?
  7. ===============================================================================
  8. Public Screens are new Amiga Screens that can have program windows on them,
  9. instead of the Workbench Screen, allowing you to avoid shuffling windows around
  10. the Workbench Screen in order to get to your Icons. A good use of this would be
  11. for opening a public screen and putting both an Amiga Shell Window and a Clock
  12. Window, as a CLI work environment, leaving Workbench available for file/icon
  13. manipulation.
  14.  
  15.  
  16. ***********************************************
  17. * WARNING!! WARNING!!  DANGER WILL ROBINSON!! *
  18. ***********************************************
  19. 1.) Do NOT try to close a PublicScreen Screen any way other than by
  20. selecting its menu item, or you will crash your Amiga!
  21.     (Other public screen programs are not aware of our menu window.)
  22.  
  23. 2.) PublicScreen may not find ALL programs that use its screen, and therefore
  24. not shutdown properly, resulting in an ill/crashed Amiga.
  25.     (OK, I found 1 old program that caused this behavior...)
  26.  
  27. REQUIREMENTS:
  28. ===============================================================================
  29. Amiga OS 2.04 (v37 system libraries) is required to use PublicScreen.
  30.  
  31. USAGE INSTRUCTIONS:
  32. ===============================================================================
  33. CLI Usage:       PublicScreen <ScreenName>   (defaults to PublicScreen.1 etc.)
  34. Workbench Usage: Double Click on icon (what else?)
  35.  
  36. Installation: PublicScreen expects to find the following programs/files
  37.                 S:PublicScreen-Startup  (a startup script for the shell menu item)
  38.                 PublicScreen (in the current dir or C: [I have no paths])
  39.                 C:ED (the standard AmigaOS 2.04 Editor)
  40.                 SYS:Tools/memacs (the standard AmigaOS 2.04 memacs editor)
  41.                 SYS:Utilities/clock (the standard AmigaOS 2.04 clock)
  42.                 SYS:Tools/Calculator
  43.                 SYS:Tools/Colors (the standard AmigaOS 2.04 Screen colors program)
  44.  
  45. About the Tools Menu:
  46.               These are currently hardcoded values, through use of some C string
  47.               manipulation, I directly supply ED and SHELL with CON:specs that
  48.               substitute the current screen, for the SCREEN keyword argument.
  49.               CLOCK, CALCULATOR, and MEMACS are SHANGHAI'd by setting that mode
  50.               silently, launching the program and waiting half a second, before
  51.               returning default/shanghai back to their previous off status. The
  52.               Colors program is simply called as it always opens-- front screen.
  53.               In a user configurable version, I will probably have a settable
  54.               DELAY value, for people with slow machines.
  55.  
  56.               In a future release I hope to make this tools menu(s) configurable,
  57.               I just wanted to give something out now that was more usable than
  58.               the previous releases of PublicScreen.
  59.  
  60. Description:  PublicScreen simply opens a Public Screen with the same attributes
  61.               as your workbench screen, (Same Font, Same Screenmode, etc.)
  62.               and stays open until you select the menu item to close the screen.
  63.               (If it finds no other programs using the screen. See Warning above.)
  64.  
  65.               I have included a basic Tools Menu, so you can launch a shell,
  66.               ed-editor, memacs-editor, clock, calculator, and/ Colors windows
  67.               on your newly opened public screens.
  68.  
  69.               PublicScreen has menu items on the public screen for default mode.
  70.               On a 512K CHIP amiga approx 12 non-interlaced public screens can
  71.               be opened, or 6 interlaced ones.  These numbers increase with
  72.               1M CHIP and 2M CHIP machines. Machines with ECS should be able to
  73.               open public screens in Productivity or SuperHires modes, if that is
  74.               how their workbench screen is configured.
  75.  
  76.               If your Workbench Screen is set to a virtual size > actual display
  77.               size, such as going to the Prefs/ScreenMode program and setting
  78.               Width and Height to double their normal value, (1200 Width, 800 Height)
  79.               PublicScreen will open an identical type window.  You can thus
  80.               place multiple shell windows in view and out of view.
  81.  
  82. Requirements: AmigaOS Release 2.04 (v37)
  83.  
  84. Known BUGS:  YES!
  85.  
  86. Revision History:
  87.   REV 1.01: first usable version - alpha released 04/08/92
  88.   REV 1.02: changed default behavior for CLI to match workbench - not released
  89.   REV 1.03: reorganized some code, etc. - not released
  90.   REV 1.04: basic Menu functionality Added -alpha released 04/09/92
  91.   REV 1.05: fixed "leave shanghai/popup mode on" bug - not released
  92.   REV 1.06: added autoname function code both CLI (no-args) and Workbench
  93.   REV 2.00: RELEASED for general consumption   04/10/92
  94.   REV 2.02: changed process name from "Background_Process" to "PublicScreen" 04/12/92
  95.             (was quite rude, not giving our real name, could be suspected as virus...)
  96.             added Command Template for CLI "PublicScreen ?"  04/12/92
  97.             fixed another "leave shanghai/popup mode on" bug 04/12/92
  98.   REV 2.03: added 'low CHIP ram' to Error requester and updated docs 04/12/92
  99.   REV 2.04: added menu item for New PublicScreen (buggy implementation) 04/14/92
  100.             added cli warning message for 1.3 lusers                    04/14/92 not released
  101.   REV 2.05: looking into adding startup file design and calling modes   04/15/92 not released
  102.             changing CLI template to SCREENAME,FROM/K:
  103.             for SCREENAME=<name_of_screen> and FROM=<startup_file>
  104.             rearranging some code, increasing number and clarity of comments
  105.             since there will be a lot of changes coming.
  106.   REV 2.06: added basic CLI based program launching, and Tools Menu     04/17/92 not released
  107.             fixed bug with CON: opening with wrong font, used wrong screentag, Sorry!!
  108.             replaced some SAS/C specific code with something more portable. 04/19/92 not released
  109.   REV 2.07  Got SCREEN independent program launching working... Yeah! 04/21/92 RELEASED
  110.   REV 2.08  Changed ED commandline to have a proper close gadget, oops!
  111.             Changed CLOCK commandline to be over more to left (fit on no-overscan screens)
  112.   REV 2.09  Added "Colors" to Tools Menu because it was suggested by a user
  113.   REV 2.10  Fixed Bug in Un-default routine, Couldn't shutoff Default mode if was in
  114.             default mode before launching "Shanghai'd" programs, oops! (5/8/92)
  115.             Also program launching with "shanghai" mis-sets the popup and shanghai flags
  116.             when returning (still needs to be fixed).
  117. FUTURE:
  118.   Rev 3 and Beyond:
  119.    - Add a user configurable menu for launching programs so that once a public
  120.      screen is popped up, it is immediately usable, without switching screens.
  121.      SCREENMODE/Font selection support?
  122.  
  123.    - Add user configurable option to automatically start various programs when
  124.      publicscreen is opened.
  125.  
  126.    - Rewrite program as a Client/Server to allow external controls from Shell
  127.      Scripts, options for starting in default mode, options for non-cloneWB
  128.      Screens (screenmodes/overscan/font/colors)
  129.  
  130.    - Add External (arexx?) Support to 1.)Close Screen
  131.                                       2.)Bring Screen to Front
  132.                                       3.)Push Screen to Back
  133.                                       4.)Open other screens?
  134.  
  135.    - Get closer to the 'ideal application' in Amiga User Interface Style Guide.
  136.  
  137.   Anyone want to create a better Icon?
  138.   Write Some utilities with JUMP gadgets?
  139.  
  140. NOTICE TO OTHER PROGRAMMERS:
  141. --------------------------------------------------------
  142. PLEASE make your programs Public Screen aware, and font sensitive.
  143.  
  144. -Ed Berger
  145.  internet: eberger@psc.edu
  146.            eb15@andrew.cmu.edu
  147.  
  148.