home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 58 / af058sub.adf / frcemon31.lha / ForceMonitor.doc < prev    next >
Text File  |  1993-04-23  |  6KB  |  145 lines
  1. /***************************************************************************/
  2. /*                                       */
  3. /* This magnificient piece of software is real PD, so you do not need to   */
  4. /* send any money to me, but I would like to receive some good sourcecodes */
  5. /* especially for OS2.0 [ amiga, of course ;-) ] or better.
  6. /*                                       */
  7. /***************************************************************************/
  8. /*                                       */
  9. /* This program is dedicated to the poor souls which own a brandnew A4000, */
  10. /* but cannot afford a real MultiScan monitor. It can change some Monitor- */
  11. /* IDs to a given ID, which allows to use most non-games Amiga-Software on */
  12. /* cheap, standard VGA-monitors. KickStart 3.0 or better is required.      */
  13. /*                                       */
  14. /*    Michael Illgner                            */
  15. /*    Theodorstr. 27                             */
  16. /*    W-4790 Paderborn                           */
  17. /*    Germany                                */
  18. /*    Tel.: 05251/26488 or 05251/60-2331                   */
  19. /*                                       */
  20. /*    email: fillg1@uni-paderborn.de                     */
  21. /*                                       */
  22. /***************************************************************************/
  23. /*                                       */
  24. /*        F o r c e M o n i t o r  V3.10                   */
  25. /*                                       */
  26. /***************************************************************************/
  27.  
  28. ForceMonitor is written as a commodity, so it should belong to your
  29. WBStartUp-drawer and will be started and used as any other commodity. 
  30. ForceMonitor patches OpenScreen and OpenScreenTagList, to open most screens
  31. in a given displaymode. Using Exchange you can disable ForceMonitor, which
  32. will bypass the patch. Due to security reasons, the patch will only removed
  33. at program end.
  34.  
  35. Forcemonitor accepts the following tooltypes :
  36.  
  37. CX_PRIORITY        -- the commodity's priority, 
  38.                please look in your Amiga manual
  39. CX_POPUP        -- YES or NO, popup the configwindow at startup
  40. CX_POPKEY        -- the hotkey to display the configwindow,
  41.                defaults to 'ctrl alt f', please look
  42.                in your normal manuals (like Toolmanager)
  43.                 to get a detailed description of possible hotkeys
  44.  
  45. The rest of the ToolTypes should not be set by the Workbench Info-command,
  46. this will be done by the configwindow. 
  47.  
  48.  
  49. Now a short description of the gadgets in the configwindow,
  50. its use should be quite obvious.
  51.  
  52. PopKey            Shortcut 'p'
  53. An alternative place to specify the hotkey for displaying this window.
  54.  
  55. CheckSize        Shortcut 'c'
  56. ForceMonitor uses the 3.0 function BestModeID to determine to new
  57. ScreenMode. If CheckSize is choosen, BestModeID will use the specified
  58. sizes in the NewScreen structure or in the SA_Width and SA_Height tags
  59. instead of the default ones. This is recommended.
  60.  
  61. NewLook            Shortcut 'n'
  62. Set the newlook for all screens, even the old ones.
  63.  
  64. AutoScroll        Shortcut 'a'
  65. Set the Autoscroll flag for all screens.
  66.  
  67. Hide            Shortcut 'h'
  68. Close the configwindow, equivalent to the closebutton.
  69.  
  70. Save            Shortcut 's'
  71. Saves the configuration to the info-file, so no extra configfile
  72. is needed :-)
  73.  
  74. Quit            Shortcut 'q'
  75. Quits the program, removing the patch.
  76.  
  77. Replace
  78. This is a ListView gadget where you can select the MonitorIDs you
  79. want to replace. VGA users should select PAL, NTSC and default, which
  80. is the MonitorID 0x0 or no Monitor specified. 
  81.  
  82. With            Shortcut 'w'
  83. With this Cycle gadet, you can choose the new MonitorID, which will
  84. replace the selected ones in the ListView gadget.
  85.  
  86. Reject
  87. Here you can specify screens and tasks, which ForceMonitor will not change.
  88. Example: You don't want to change any screen ImageFX will open, so include
  89. "T:ImageFX" into the rejectlist (T: means the task ImageFX).
  90. Another example: "S:#?NetHack#?" will not change any screen which title includes
  91. the string NetHack. ForceMonitor is using the DOS-function MatchPatternNoCase(),
  92. so you can use any valid AmigaDOSPattern including wildcards, the comparison is
  93. >not< case-sensitiv.
  94.  
  95. Enable
  96. Like the Commodities Exchange Enable/Disable gadgets.
  97.  
  98. Sorry, I cannot include the sources yet, because I am not allowed to own
  99. the 3.0 AutoDocs and Includes ;-) (Hello CATS, we need them !!!!!)
  100.  
  101. History :
  102.  
  103. V1.0     ForceVGA is based on ForceNTSC
  104. V2.0    Initial Release on Oct 23 1992
  105.  
  106. V3.0     Changed to ForceMonitor, complete rewritten, can now switch to
  107.     any MonitorID
  108.  
  109. V3.1    fixed small bug in LoadConfig()
  110.  
  111. V3.2    fixed small bug in determining the fontsize
  112.  
  113. V3.3    recompiled using SAS/C 6.2 (no new SAS/C bugs found, yet ;-)
  114.  
  115. V3.4    change the highlighting method in renderhook
  116.  
  117. V3.5    fixed some small bugs.
  118.     The NewLook flag was always set.
  119.     ForceMonitor now checks ToolTypes from the icon it was started from,
  120.     not from the program icon itself. 
  121.     Thanks to Markus Stipp (corwin@uni-paderborn.de) for discovering these.
  122.  
  123. V3.6    The ConfigWindow now gets to the front if opened.
  124.  
  125. V3.7    Implemented the Reject-Screens-and-Tasks ListView, now you can specify
  126.     some Screens and Tasks, where ForceMonitor will not work.
  127.     Changed the SaveConfig() routine, now >all< unknown ToolTypes are saved,
  128.     not only "DONOTWAIT" !!
  129.     The version string is updated on every compilation now !!
  130.     ForceMonitor now uses 68020 code instead of 68040, so Amiga 1200 owners
  131.     are happy :-)
  132.  
  133. V3.8    Implemented some menus.
  134.     Corrected the Reject-Screen-and-Task Gadget enabling and activation.
  135.     Removed bug in MyOpenScreenTagList() which caused enforcerhits on
  136.     screens without title.
  137.     Removed ugly bug in GetMonitorList()
  138.     ForceMonitor will now popup the ConfigWindow, if no correct configuration
  139.     could be read from the icon.
  140.  
  141. V3.9    ForceMonitor will activate the ConfigWindow if openend.
  142.  
  143. V3.10    Implemented an Enable Gadget to en/-disable ForceMonitor from ConfigWindow.
  144.     Thanks to Mario Kemper (magick@uni-paderborn.de) for this suggestion.
  145.