home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / drivers / a066_1 / !VMode / !Help < prev    next >
Text File  |  1992-03-03  |  5KB  |  130 lines
  1. !VMode ($Revision: 1.5 $)
  2.  
  3. A replacement for !edit as a taskwindow driver. Handles most VDU calls so
  4. taskwindowed app can use graphics, positioned text etc. (Works by
  5. redirection to a sprite.) Requires taskwindow module.
  6.  
  7. * Supports any mode that can be a sprite
  8. * Allows saving of a screen dump
  9. * Allocates space for screens using flex style slot extension
  10. * Cursor (!)
  11. * Passes on f12
  12. * Magnifier  *NEW*
  13. * Palette changes work  *NEW*
  14. * Flexable startup method *NEW*
  15. * You get source
  16. * Good enough to run nethack in the desktop :-)
  17.  
  18. Not supported:
  19.  
  20. * A better cursor (flashing?)
  21. * Dragged input
  22. * Input editing
  23. * A Zoomed to full screen state.
  24. * HARD: The thing under taskwindow reading the current mode or variables.
  25.  
  26. If I receive 25 pounds or more, or even just a substantial number of
  27. letters, I will be encouraged enough to do something about these, and those
  28. who sent money will receive the new versions of this and other things.
  29. Alternatively, you have the source, so go ahead and add something
  30. worthwhile! (Though please distribute my version as well as a modified one,
  31. or send changes back to me.)
  32.  
  33. Intructions:
  34.  
  35. Run it. A click on the bar icon will launch a new taskwindow in mode 0, you
  36. can then change mode in that window if you like, or run something. A menu
  37. allows the same four operations on tasks as !Edit, and lets you save a
  38. screendump. The menu from the bar icon allows you to control whether
  39. requests for new taskwindows are grabbed - the default state of this comes
  40. from the value of VMode$NewTasks.
  41.  
  42. This is not actually very useful, however, as requests launched by
  43. taskwindow itself seem to contain only the command taskwindow, and not the
  44. parameters. !Edit, however, kindly only traps ones of this form, so any
  45. proper ones generated will be got by !VMode. These can come either from
  46. the newtask command in my bits module, used something like
  47.         do newtask taskwindow <Obey$Dir>.!Run2 -ctrl
  48. The problem with this is that VMode must already be running.
  49.  
  50. The recommended technique is now to use
  51.         do vmode taskwindow <Obey$Dir>.!Run2 -ctrl
  52. which actually runs vmode (the alias is set up when vmode is seen by the filer)
  53. and the new copy will quit if its already running. So for nethack, rename
  54. its !run file to !run2, and put the line above in !run.
  55.  
  56. RiscOS 3.00 wimp vs taskwindow vs UKSwi handlers
  57.  
  58. Note that the 3.00 wimp during each poll makes a call to a swi that is in
  59. fact undefined - possibly this is intended for some sort of expansion. This
  60. would be ok, except that it means the UKSwi handler that an application has
  61. installed is called, possibly when its not expected if taskwindow has
  62. preempted it and called Wimp_Poll. For instance, some versions of H.Roger's
  63. unixlib want to core dump when this occurs, but taskwindow eats the core
  64. dump, so they just exit silently. Anyway, a simple patch is a
  65. module that defines this swi to do nothing, which is in W300UKSwi - so use
  66. this if you are lucky enough to have an A5000.
  67.  
  68. Distribution:
  69.  
  70. This software may be freely redistributed, so long as only a reasonable
  71. copying or media charge is made, and all files I distribute are included. I
  72. retain copyright to the code. Commercial (including magazine) distribution,
  73. or distributing modified versions of this please contact me - I am normally
  74. happy for it to be reused in other free software, but like to avoid deviant
  75. versions of mine causing trouble.
  76.  
  77. If you like and use it, and feel that further work would be worthwhile,
  78. please send me 5 (or more) pounds. If I receive 25 or more, I'll add some
  79. more features and fix any problems - though I may do anyway.
  80.  
  81. $Log:    !Help $
  82. # Revision 1.5  92/03/04  16:34:24  bdb
  83. # Better start up
  84. # 
  85. # Revision 1.4  92/03/02  17:25:27  bdb
  86. # Trap and use palette changes.
  87. # Added magnifier - fixed cursor vs this
  88. # Title changing
  89. # Fixed rogue cursor bug
  90. # Only pass on f12 and send other keys to task.
  91. # And mode number with 127
  92. # Trapped VDU 21
  93. # Prevented status lag update on menu allowing multiple resumes
  94. # 
  95. # Revision 1.3  92/02/25  11:46:50  bdb
  96. # Changed newtasks behaviour to only trap on -ctrl ones,
  97. # and no longer use weird patch. This supports a newtask
  98. # command to replace taskwindow.
  99. # 
  100. # Revision 1.2  92/02/20  11:12:42  bdb
  101. # Added cursor, passing on keys
  102. # dbox_query replaces error box.
  103. # Added chat about UKSwi patch module to !Help
  104. # 
  105. # Revision 1.1  92/02/19  16:28:22  bdb
  106. # Initial revision
  107. # 
  108.  
  109. Me:
  110.  
  111. Brian.Brunswick@cl.cam.ac.uk
  112. 0223 334419
  113.  
  114. At least till Sep 92:
  115. Brian Brunswick
  116. Trinity College
  117. Cambridge
  118. CB2 1TQ
  119. UK
  120. 0223 351516
  121.  
  122. Brian Brunswick
  123. Fairview
  124. Avenue des Hirondelles
  125. Pool-in-WharfeDale
  126. Leeds
  127. LS21 1EY
  128. UK
  129. 0532 843737
  130.