home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / utilities / _vmode / _help < prev    next >
Encoding:
Text File  |  1992-02-25  |  4.0 KB  |  115 lines
  1. !VMode ($Revision: 1.3 $)
  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.) Probably requires at least the taskwindow from
  6. Desktop C.
  7.  
  8. * Supports any mode that can be a sprite
  9. * Allows saving of a screen dump
  10. * Allocates space for screens using flex style slot extension
  11. * Cursor (!)
  12. * Passes on hot keys
  13. * You get source
  14. * Good enough to run nethack in the desktop :-)
  15. * Now with bits module that supplies a *newtask command, and it traps -ctrl'd ones.
  16.  
  17. Not supported:
  18.  
  19. * Zooming
  20. * A better cursor
  21. * Changing the palette.
  22. * Dragged input
  23. * Input editing
  24. * Function/special keys
  25. * A Zoomed to full screen state.
  26. * HARD: The thing under taskwindow reading the current mode or variables.
  27.  
  28. If I receive 25 pounds or more, or even just a substantial number of
  29. letters, I will be encouraged enough to do something about these, and those
  30. who sent money will receive the new versions of this and other things.
  31. Alternatively, you have the source, so go ahead and add something
  32. worthwhile! (Though please distribute my version as well as a modified one,
  33. or send changes back to me.)
  34.  
  35. Intructions:
  36.  
  37. Run it. A click on the bar icon will launch a new taskwindow in mode 0, you
  38. can then change mode in that window if you like, or run something. A menu
  39. allows the same four operations on tasks as !Edit, and lets you save a
  40. screendump. The menu from the bar icon allows you to control whether
  41. requests for new taskwindows are grabbed - the default state of this comes
  42. from the value of VMode$NewTasks.
  43.  
  44. This is not actually very useful, however, as requests launched by
  45. taskwindow itself seem to contain only the command taskwindow, and not the
  46. parameters. !Edit, however, kindly only traps ones of this form, so I've
  47. added a command newtask that launches requests with a full command line in,
  48. and !VMode grabs those that contain a -ctrl. As an example, I've renamed my
  49. nethack !run to !run2, and installed this line as !run:
  50.  
  51.         newtask taskwindow <Obey$Dir>.!Run2 -ctrl
  52.  
  53.  
  54. RiscOS 3.00 wimp vs taskwindow vs UKSwi handlers
  55.  
  56. Note that the 3.00 wimp during each poll makes a call to a swi that is in
  57. fact undefined - possibly this is intended for some sort of expansion. This
  58. would be ok, except that it means the UKSwi handler that an application has
  59. installed is called, possibly when its not expected if taskwindow has
  60. preempted it and called Wimp_Poll. For instance, some versions of H.Roger's
  61. unixlib want to core dump when this occurs, but taskwindow eats the core
  62. dump, so they just exit silently. Anyway, a simple patch is a
  63. module that defines this swi to do nothing, which is in W300UKSwi - so use
  64. this if you are lucky enough to have an A5000.
  65.  
  66. Distribution:
  67.  
  68. This software may be freely redistributed, so long as only a reasonable
  69. copying or media charge is made, and all files I distribute are included. I
  70. retain copyright to the code. Commercial (including magazine) distribution,
  71. or distributing modified versions of this please contact me - I am normally
  72. happy for it to be reused in other free software, but like to avoid deviant
  73. versions of mine causing trouble.
  74.  
  75. If you like and use it, and feel that further work would be worthwhile,
  76. please send me 5 (or more) pounds. If I receive 25 or more, I'll add some
  77. more features and fix any problems - though I may do anyway.
  78.  
  79. $Log:    !Help $
  80. # Revision 1.3  92/02/25  11:46:50  bdb
  81. # Changed newtasks behaviour to only trap on -trl ones,
  82. # and no longer use weird patch. This supports a newtask
  83. # command to replace taskwindow.
  84. # 
  85. # Revision 1.2  92/02/20  11:12:42  bdb
  86. # Added cursor, passing on keys
  87. # dbox_query replaces error box.
  88. # Added chat about UKSwi patch module to !Help
  89. # 
  90. # Revision 1.1  92/02/19  16:28:22  bdb
  91. # Initial revision
  92. # 
  93.  
  94. Me:
  95.  
  96. Brian.Brunswick@cl.cam.ac.uk
  97. 0223 334419
  98.  
  99. At least till Sep 92:
  100. Brian Brunswick
  101. Trinity College
  102. Cambridge
  103. CB2 1TQ
  104. UK
  105. 0223 351516
  106.  
  107. Brian Brunswick
  108. Fairview
  109. Avenue des Hirondelles
  110. Pool-in-WharfeDale
  111. Leeds
  112. LS21 1EY
  113. UK
  114. 0532 843737
  115.