home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / wb / pst / pst.doc < prev    next >
Text File  |  1993-10-15  |  14KB  |  361 lines
  1.  
  2. PST - a Public Screen creation Tool
  3. -----------------------------------
  4.  
  5. Copyright ©1993 by Timothy B. Kreuzer.  All rights reserved.
  6.  
  7. Version: 1.0a
  8.  
  9. Author: Tim Kreuzer (and the KreuzerSoft support team)
  10.  
  11. Language: SAC/C V6.3
  12.  
  13.  
  14. Features: Creates a Public Screen with screen type selectable from any
  15.            currently active Monitor type
  16.           Uses the 3.0 ASL Screen Mode Requester
  17.           Allows for selection of screen dimensions, depth, overscan, and
  18.            autoscroll (via ASL Screen Mode Requester)
  19.           Allows complete control of all Public Screen-related features,
  20.            such as "Default Public Screen", "Pop to Front", and "Shanghai".
  21.           Tested OK using the Enforcer.
  22.  
  23.  
  24.           Extremely compatible with the KreuzerSoft series of graphics
  25.            programs (Fractal, LyapunovSpace, Terrain, PaletteTool, etc.)
  26.            but is NOT in anyway restricted to usage with them.
  27.  
  28.           Put differently, this is a general-usage tool.
  29.  
  30.  
  31. Limitations: Requires AmigaDOS 3.0
  32.  
  33.              I have tested PST extensively and have never had it cause
  34.               any problems or crashes.  I cannot, however, guarantee it
  35.               100% for each system and the various programs you use.
  36.               As such, you use PST at your own risk.  Please report any
  37.               problems encountered to the author.
  38.  
  39.  
  40.  
  41. Changes in Version 1.0a
  42. -----------------------
  43.  
  44. 1) Fixed a bug where all pens/color registers in the Public Screen that is
  45.    opened were "Obtained", and not available to 3.0 programs which utilize
  46.    the "ObtainPen" function.
  47.  
  48.    Note that since the detailed info on what's new in 3.0 as far as 
  49.    functions, flags, etc. is not available to common folk like me (yet),
  50.    I feel fortunate to have figured this out from the include files.  
  51.  
  52.    Now, all but the first four pens/registers (needed for Intuition) and
  53.    the three for the pointer are free to "Obtain".
  54.  
  55. 2) Finally figured out how to get the 3.0 "NewLook" menus (black-on-white)
  56.    to display correctly, based upon adapting the code output from 
  57.    GadToolsBox (same "Note" as previous item).
  58.  
  59. 3) The size and position of the Screen Mode Requester will now attempt to
  60.    tailor itself to the Workbench (or default Public Screen) it is opened
  61.    upon (roughly 1/4 of screen size, centered in the middle of the screen).
  62.  
  63. 4) Added new explanatory sections and additional info to this "doc" file.
  64.  
  65.    If you obtained V1.0 of PST, I recommend reading this updated "doc" file
  66.    as the new information can be useful.
  67.  
  68.  
  69.  
  70. Why did I create PST?
  71. ---------------------
  72.  
  73. When creating the KreuzerSoft series of graphics programs, I decided to
  74. make them open on the current default Public Screen, instead of embedding
  75. the opening of a screen within them.  This was intended to allow the
  76. maximum flexibility in their usage (i.e., you could open them on your
  77. Workbench screen as well).
  78.  
  79. This is also why I did not embed any screen palette controls into the
  80. programs, and instead created the stand-alone PaletteTool.
  81.  
  82. I had previously recommended the usage of WindowBlender (to open an AGA
  83. Public Screen at any resolution/# of colors/etc.) and PSX (to make the
  84. WindowBlender screen the default Public Screen) as a method of using the
  85. KreuzerSoft graphics programs on screens with characteristics different
  86. from the Workbench.
  87.  
  88. I finally grew tired of either resetting my Workbench screen mode or
  89. using WindowBlender/PSX to set up an AGA Public Screen.  Having not yet
  90. seen any type of tool to create (AGA) Public Screens and control them (like
  91. the venerable PSX did for 2.0), I decided to create PST.
  92.  
  93. NOTE that there are many other ways in which PST can be used, besides in
  94. relation to the KreuzerSoft graphics programs.  I only mention the other
  95. programs as an explanation of why PST was created.
  96.  
  97.  
  98.  
  99. Getting started with PST
  100. ------------------------
  101.  
  102. Click on the PST icon.
  103.  
  104. PST will present a Screen Mode Requester, containing a list of all currently
  105. available screen modes (via your "Monitor" definitions).
  106.  
  107. You are defining, via this requester, the type of screen to be opened as
  108. a new Public Screen.
  109.  
  110. Select the type of screen desired from the list.
  111.  
  112. The Overscan, Width, Height, Colors, and AutoScrool gadgets allow you to
  113. further tailor the PublicScreen which is to be opened.
  114.  
  115. Once you've set the screen parameters to your liking, select OK.
  116.  
  117. A Public Screen of the designated characteristics will then be opened.
  118.  
  119.  
  120.  
  121. The (PST) Public Screen menu
  122. ----------------------------
  123.  
  124. The Public Screen opened by PST contains a menu which allows you to control
  125. the characteristics of the Public Screen.
  126.  
  127. This menu can be activated by first left-clicking anywhere on the background
  128. surface of the screen (akin to the Workbench).
  129.  
  130.  
  131. The "PST" menu items are as follows:
  132.  
  133.         About...                     Version, Copyright, and Author 
  134.                                      information.
  135.  
  136.  
  137. The "Screen Control" menu items are as follows:
  138.  
  139.  
  140.         Public - NoPop               Defines the screen as a "local" Public
  141.                                      Screen, which WILL NOT pop to the front
  142.                                      if a window is opened upon it.
  143.  
  144.         Public - Pop                 Defines the screen as a "local" Public
  145.                                      Screen, which WILL pop to the front if
  146.                                      a window is opened upon it.
  147.  
  148.         Default - NoPop/NoShanghai   Defines the screen as the "default"
  149.                                      Public Screen, which WILL NOT pop to the
  150.                                      front if a window is opened upon it,
  151.                                      and WILL NOT force windows which 
  152.                                      normally open on the Workbench screen 
  153.                                      to open on this screen.
  154.  
  155.         Default - NoPop/Shanghai     Defines the screen as the "default"
  156.                                      Public Screen, which WILL NOT pop to the
  157.                                      front if a window is opened upon it,
  158.                                      and WILL force windows which normally
  159.                                      open on the Workbench screen to open
  160.                                      on this screen.
  161.  
  162.         Default - Pop/NoShanghai     Defines the screen as the "default"
  163.                                      Public Screen, which WILL pop to the
  164.                                      front if a window is opened upon it,
  165.                                      but WILL NOT force windows which 
  166.                                      normally open on the Workbench screen
  167.                                      to open on this screen.
  168.  
  169.         Default - Pop/Shanghai       Defines the screen as the "default"
  170.                                      Public Screen, which WILL pop to the
  171.                                      front if a window is opened upon it,
  172.                                      and WILL force windows which normally
  173.                                      open on the Workbench screen to open 
  174.                                      on this screen.
  175.  
  176.         Close                        Close the PST Public Screen.
  177.  
  178.                                      NOTE that the actual screen will NOT
  179.                                      close until all windows opened on
  180.                                      PST screen are themselves closed.
  181.  
  182.                                      NOTE that in this case, once you select
  183.                                      "Close", the PST screen menu is no 
  184.                                      longer available.
  185.  
  186.  
  187. IMPORTANT NOTE: The 6 different "Public Screen" modes listed above are
  188.                 completely changeable (i.e., can be dynamically changed).
  189.                 You are NOT locked into choosing only 1 of them each time
  190.                 you run PST.
  191.  
  192.                 For example, you may want to initially select "Default -
  193.                 Pop/Shanghai" to get some of your Workbench programs to
  194.                 open their windows on the PST screen, then change back to
  195.                 "Public - NoPop" so that any new programs/windows open on
  196.                 the Workbench screen as usual.
  197.  
  198.  
  199.            
  200. Note about the PST Screen menu items
  201. ------------------------------------
  202.  
  203. 1) KreuzerSoft graphics program users will want to select 
  204.  
  205.        "Default - Pop/NoShanghai"
  206.  
  207.    so that the Fractal/LyapunovSpace/etc. windows will open on the Public
  208.    Screen, which will cause the Public Screen to pop to the front.
  209.  
  210. 2) The only (current) reason I can think of to select the
  211.  
  212.        "Public - NoPop"  and   "Public - Pop"
  213.  
  214.    items would be as "operating" modes.  That is, once you've gotten a
  215.    program to open it's window(s) on the PST screen and wish to turn off
  216.    the "Default" and/or "Shanghai" modes. 
  217.  
  218.    Of course, they are also useful for programs which allow windows to be
  219.    opened on a named (i.e., non-Default) Public Screen (not too many of
  220.    these yet).
  221.  
  222. 3) When the PST Public Screen is closed, the Workbench screen is (re)set 
  223.    to be the "default" Public Screen (and PopToFront and Shanghai are 
  224.    turned off).  This is, of course, only important if the final PST
  225.    Public Screen mode included "Default", "Pop", or "Shanghai".
  226.  
  227.  
  228.  
  229. Notes about Public Screen and Default Public Screen workings
  230. -------------------------------------------------------------
  231.  
  232. 1) I've noticed that even if you select the "Public - Pop" options, the
  233.    PST screen does not alway pop to the front when you start a given
  234.    program from the Workbench.  Not quite sure (yet) why this happens.
  235.  
  236.    Worst case is that you'll have to use the Screen Depth gadget or the
  237.    "Amiga-m" key combo to move the PST screen back to the front.
  238.  
  239. 2) I use PST to give me a second "Workbench", by using the "Public - 
  240.    Shanghai" options.  It really cuts down on the Workbench screen clutter
  241.    if you're editing multiple files while doing other things which operate
  242.    via Workbench-screen windows.
  243.  
  244.    It also allows you to, say, edit files on the PST screen at a higher
  245.    screen mode resolution while keeping your Workbench at a more "reasonable"
  246.    resolution.  Of course, editing files is just one example of this "dual"
  247.    Workbench approach.  One could easily apply the same thing to the "# of
  248.    available colors".
  249.  
  250.    Give this a try and see what you think.
  251.  
  252.    Remember that you can temporarily set the "Shanghai" option, start some
  253.    new programs (which open on the PST screen), and then turn off "Shanghai"
  254.    (select one of the "Public" options).  This will put you back in the
  255.    "normal" mode where programs open on the Workbench screen.
  256.  
  257.  
  258.  
  259. Credits/Miscellaneous
  260. ---------------------
  261.  
  262. The GUI for PST was developed using Jan van den Baards' wonderful 
  263. GadToolsBox.
  264.  
  265. WindowBlender is a fantastic 3.0/AGA graphics program written by
  266. Fred Mitchell.
  267.  
  268. PublicScreenX (aka PSX) is a marvelous public screen manager written 
  269. by Steve Tibbett.
  270.  
  271. Thanks to Dave at Buried Treasure in Rockville, MD.  Please support your
  272. local Amiga dealers!
  273.  
  274.  
  275.  
  276. Possible future enhancements
  277. ----------------------------
  278.  
  279. 1) Default the Screen Mode Requester initial settings to those of the
  280.    current Workbench or Default Public Screen.
  281.  
  282. 2) Support the opening of multiple "PST" Public Screens.
  283.  
  284. 3) Allow user to select the name of the PST-generated Public Screen(s).
  285.  
  286.  
  287.  
  288. *********************************************************************
  289. Please let me know if you have any problems/suggestions/comments/etc.
  290. *********************************************************************
  291.  
  292. I can be reached via two methods:
  293.  
  294.     - E-mail on GEnie (T.KREUZER)
  295.  
  296.         - U.S. mail at: 6711A N. Washington Blvd.
  297.                         Arlington, VA  22213
  298.  
  299.  
  300.  
  301. -----------------------------------------------------------------------------
  302.                                 Legal Department
  303. -----------------------------------------------------------------------------
  304.  
  305. PST Version 1.0a
  306. Copyright ©1993 by Timothy B. Kreuzer.  All rights reserved.
  307.  
  308.  
  309. PST is freely redistributable, as long as the following rules are
  310. followed:
  311.  
  312.         - This doc file must be kept with the executable(s), and must
  313.           include the above copyright notice.
  314.  
  315.         - You may not charge any fee for this program, other than the basic
  316.           cost of distribution media (and ONLY the media itself) and/or BBS
  317.           access.
  318.  
  319.         - Fred Fish is hereby given permission to include this archive in
  320.           his superb collection of Amiga PD software.
  321.  
  322.  
  323. My religion does not prohibit me from receiving $$$$ if you really like
  324. the program, or would like custom modifications.
  325.  
  326. Here's that address again:
  327.  
  328.         Timothy B. Kreuzer
  329.     6711A N. Washington Blvd.
  330.     Arlington, VA  22213
  331.  
  332.  
  333.  
  334. -----------------------------------------------------------------------------
  335.                               Commercial Section
  336. -----------------------------------------------------------------------------
  337.  
  338. The following KreuzerSoft projects are (hopefully) available on a BBS
  339. near you:
  340.  
  341.         Fractal V1.1       - Mandelbrot set program for 3.0/AGA.
  342.  
  343.         LyapunovSpace V1.1 - Lyapunov fractal program for 3.0/AGA.
  344.  
  345.         Terrain V1.1       - 3-D fractal terrain program for 3.0/AGA.
  346.  
  347.         PaletteTool V1.2   - Public Screen palette program for 3.0/AGA.
  348.  
  349.         FindColor          - "Color-by-Name" selector for 3.0/AGA.
  350.  
  351.         Worm V1.1          - Port of SUN-Unix graphic toy for all Amigas.
  352.  
  353.         DLA                - Diffusion Limited Aggregation simulation for
  354.                              all Amigas.
  355.  
  356.         Jimi               - 8-color Jimi Hendrix image for your Workbench.
  357.  
  358.  
  359.         All for the incredibly low, low price of FREE!
  360.  
  361.