home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / os20 / util / pprefs / pprefs.doc < prev    next >
Text File  |  1993-12-21  |  13KB  |  290 lines
  1. ***************************************************************************
  2. *                                                                         *
  3. *                   PPrefs 1.1 Screen Promotion Utility                   *
  4. *                          Freely distributable                           *
  5. *                    Copyright © 1993 The Naughty Bits                    *
  6. *                                                                         *
  7. *                         Olaf Gschweng                                   *
  8. *                         Riefstahlstr. 33                                *
  9. *                         17235 Neustrelitz                               *
  10. *                         Germany                                         *
  11. *                                                                         *
  12. *                 EMail: gschweng@informatik.uni-rostock.de               *
  13. *                                                                         *
  14. ***************************************************************************
  15.  
  16.  
  17. DISTRIBUTION CONDITIONS
  18.  
  19.  
  20. The programs and files in this distribution may be freely distributed as
  21. long as no charge is made other than to cover time and copying costs. The
  22. files in this distribution must be kept together in original, unchanged
  23. form. If you want to include PPrefs as part of a commercial package you
  24. have to contact the author first.
  25.  
  26.  
  27. INTRODUCTION
  28.  
  29.  
  30. PPrefs is a screenmode promotion utiltity which allows you to promote every
  31. available screenmode of your system (including those that normally don't
  32. appear in screenmode requesters, e.g. HAM or EHB modes) with another mode.
  33. Besides it can keep exceptions of that normal promotions when you want that
  34. some very special programs get their very special screen or don't get
  35. promoted at all.
  36.  
  37. Screen promotion could be useful for you if you only have a VGA monitor
  38. that cannot diplay those PAL and NTSC resolutions, or if you don't like
  39. that resyncing of your Multisync monitor (like on my NEC 3D, which stays
  40. black for 1 second) every time you change between screens with different
  41. modes, or if your monitor doesn't handle different positions and sizes for
  42. every mode and you have to manually adjust your monitor all the time or
  43. live with that screen that exceeds your overscan area a bit too much .. ,
  44. or ..
  45.  
  46. I wrote PPrefs because all the other promotion utilties I tried and used
  47. did not have the flexibility I needed. After trying several of them I used
  48. ForceMonitor but I was not fully satisfied with it. After I bought my
  49. Picasso II gfx card, I needed a good promotion utility even more because I
  50. don't like that ChangeScreen utility included with the Picasso so much.
  51.  
  52.  
  53. REQUIREMENTS
  54.  
  55.  
  56. PPrefs requires Kickstart 2.0, but should be more useful with Kick 3.0 or
  57. the WB 2.1 :)
  58. You should have asl.library, iffparse.library, mathieeedoubbas.library and
  59. mathieeedoubtrans.library in your LIBS: directory.
  60.  
  61.  
  62. INSTALLATION
  63.  
  64.  
  65. PPrefs consists of two programs. The program PPrefs itself is a CLI program
  66. that patches the intuition.library/OpenScreen() and OpenScreenTagList()
  67. functions. You should put it in your C: directory or anywhere else on your
  68. Workbench disk, or just put it on top of another thing - you know there are
  69. too many things not lying on top of another .. (sorry, watched Pythons too
  70. much)
  71.  
  72. The other program is the preferences editor of PPrefs which should be
  73. placed in the Prefs drawer of your WB disk. This GUI is localized, so if
  74. you have 2.1 or above you can also install the catalog to get the editor in
  75. your language. To activate PPrefs you must run PPrefs from a shell. As it
  76. doesn't detach itself you should use the 'Run' command. To install it
  77. permanently, add the following line to the startup-sequence or (preferably)
  78. your user-startup:
  79.  
  80. Run <NIL: >NIL: PPrefs
  81.  
  82. To remove it, send it a CTRL_C. But don't do this if another program
  83. patched the OpenScreen or OpenScreenTagList function AFTER PPrefs did - you
  84. must remove the other program first.
  85.  
  86.  
  87. THE PREFERENCES EDITOR
  88.  
  89.  
  90. Overview
  91.  
  92. The 2 listview gadgets on the top left side are for the source and
  93. destination mode selection, the other pair below them shows various
  94. informations on the selected modes. The other listview on the right side is
  95. for the exceptions.
  96.  
  97. Because of the many things to diplay in the window and the resulting small
  98. listviews I decided to build sublists for each monitor - ever tried
  99. clicking on the slider of the mode selector of DPaint 4.5 ? To enter a
  100. sublist just click on the monitor name, to leave it click on the top item
  101. of the sublist.
  102.  
  103. Note: If you have the OS3.0 standard mode promotion enabled (yes, the
  104. little gadget in IControl that is not mentioned in the docs - remember how
  105. lucky you where as you, just fooling around with your brandnew A4000's
  106. Workbench, found it, and you felt that you looked for something like that
  107. the whole time ...), then the promoted (i.e. scandoubled modes) appear in
  108. the Default: monitor's list. I have it disabled and simply do not need it
  109. anymore.
  110.  
  111. How to promote
  112.  
  113. If you want to promote a mode, just single click on it on the source side
  114. so that its properties appear in the listview below. Then select the
  115. desired destination mode on the destination side (again a single click is
  116. enough) - that's all.
  117.  
  118. If you click on a source mode that is already promoted, its destination
  119. mode will automatically appear on the right side; if it has not been
  120. promoted yet, the right side will show no selection.
  121.  
  122. Note: The Kickstart 3.0 (i.e. GadTools V39) listviews highlight the
  123. selected entry rather than showing its name on the bottom of the gadget as
  124. they do under 2.0 - so they give you a much better view on what's going on.
  125.  
  126. How to unpromote
  127.  
  128. To remove a promotion you have to click on the 'Unpromote' gadget above the
  129. mode listviews. Alternatively you can select the 'Unpromote' menuitem in
  130. the 'Edit' menu. There is also an item to remove all promotions and one to
  131. remove all promotions of a monitor.
  132.  
  133. The exceptions
  134.  
  135. If you want to exclude a particular program from the promotion or if you
  136. want its screen(s) to be promoted differently than the normal promotion -
  137. that's where the exceptions come into action.
  138.  
  139. You can specify this screens by its name or by the name of the program that
  140. opens the screen. You can choose the appropriate list by clicking on the
  141. cycle gadget below the listview. To add an entry click on the 'Add' gadget
  142. and then enter the desired name. (The new entry will be inserted above a
  143. previously selected entry or on the bottom if no entry was selected
  144. before.) The program will now get exactly the mode it wanted whether there
  145. is a promotion for that mode or not. The names can contain wildcards and
  146. are case insensitive.
  147.  
  148. If you want to give a program a particular screen mode just select its
  149. entry in one of the exception lists and then select the desired mode in the
  150. destination listview.
  151.  
  152. Options
  153.  
  154. Under pre-AA chipsets the number of colors a mode is able to display,
  155. varies. So if you want to promote a mode to another one that only can
  156. display less colors than the original mode, it can happen that a program
  157. cannot get the number of colors it wants to get. For this case you can
  158. specify (separately for each promotion and exception) what should be done
  159. here by choosing between keeping the resolution or keeping the colors. The
  160. default is to keep the resolution, so the program gets the mode you wanted
  161. it to get, but only as many colors as available. This may have the effect
  162. that you can't see everything you should - perhaps you should then better
  163. use the other option: to keep the colors and to reduce the resolution of
  164. that screen. In this case PPrefs will activate autoscroll (if needed) so
  165. you can shift the visible area to let you see all of the screen.
  166.  
  167. Best mode
  168.  
  169. Under Kick 3.0 (or above:) you will find a "Best xxxx mode" entry in the
  170. monitor list and in every mode list (on the destination side). This lets
  171. PPrefs use the new BestModeID() function to determine a suitable display
  172. mode. If you select the global entry then the mode is searched in the whole
  173. display database - it will take a noticable amount of time before the
  174. screen is opened. If you selected the entry in one o