home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / m / multimod / !MultiMod / !Help < prev    next >
Encoding:
Text File  |  1992-11-16  |  6.0 KB  |  141 lines
  1. !MultiMod
  2. =========
  3.  
  4. Copyright © Stewart Brodie, June 1992
  5. =====================================
  6.  
  7. This application is in the Public Domain.  It may be distributed freely
  8. provided that NO charge is made for it (except for postage or a disc).  It
  9. must also be kept intact with all the files unmodified (but see section
  10. Dimensions below).  (Largish) Source code extracts may be used provided
  11. credit is given.  No responsibility can be accepted for damage or any form
  12. of loss caused, or allegedly caused, by this program.  It is placed in the
  13. Public Domain in good faith.
  14.  
  15. Multi Module
  16. ============
  17.  
  18. This application allows you to group together modules, which are normally
  19. loaded from disc together, all in one file.  Furthermore, this file is
  20. stored as an absolute file which can be squeezed to save space.  This allows
  21. the user to load these modules more quickly.  An example of this might be
  22. loading ColourTrans, SharedCLibrary and FPEmulator plus any utility modules
  23. you may have on booting up.
  24.  
  25. To start the application, double click on the !MultiMod icon or a MultiMod
  26. file.  The filetype I have used is 0x7cf which is not registered with
  27. anybody.  To open a new window, click on the icon bar icon, or use the save
  28. dialogue box on the menu.  Place modules in a collection by dropping them in
  29. the window.  Remove icons by choosing the Remove option on the menu for that
  30. module's icon.
  31.  
  32. Dimensions
  33. ==========
  34.  
  35. Because of people griping on Usenet recently about software authors
  36. producing software that is only 2-D or 3-D, I have placed some attempt at
  37. different sets of icons in the directory.  The files inside the `resources'
  38. sub-directory should not be changed.  To switch between 2-D and 3-D icons,
  39. open the !MultiMod directory and double-click on either !2d or !3d.  This
  40. will modify the !Sprites, Sprites and Templates files. Note that this is the
  41. ONLY modification that may be made to the directory if it is being passed on
  42. to somebody else.
  43.  
  44. Menus
  45. =====
  46.  
  47. To save a collection use the Save option on the window's menu.  To export
  48. the data as an absolute file use the Save Group option on the window's menu. 
  49. To change the format of the window, use the Display sub-menu for the window. 
  50. You may choose Large or Small Icons, or Full Info which correspond roughly
  51. to Filer-like displays.  The sort options are also available on this menu. 
  52. This affects the order of display in the window and also the order in the
  53. exported file.  You may sort in alphabetic order (case insensitive), size of
  54. module (largest or smallest first) or in the order in which the modules
  55. were imported to the window.
  56.  
  57. You may save a collection into another collection by dragging the file icon
  58. onto the window.  This may be done from a Filer window or from another Multi
  59. Module window.
  60.  
  61. You may quit by choosing the Quit option on any menu.  If you have unsaved
  62. data in any windows, you will be asked whether you still want it.  You may
  63. close a collection window by clicking on its close icon.  If there is
  64. unsaved data, you will be again prompted to confirm the discard of the data.
  65.  
  66. Printing
  67. ========
  68.  
  69. You may print a collection file by dragging it to a printer driver icon. 
  70. You may drag from either Save dialogue box.  Printing from a file when the
  71. application is not loaded is not yet supported.  The printed output is a
  72. textual summary of the file contents.
  73.  
  74. Source Code
  75. ===========
  76.  
  77. I have left the source code inside the application directory.  This will
  78. only be useful for examination purposes.  (It does not take an expert in C
  79. to determine the original form of "c.wimpif" :-) ).  To remake the
  80. application from scratch, it should be necessary only to invoke a make
  81. utility with the included makefile.  However, the current directory should
  82. be set to !MultiMod's directory.  It speeds compilation up a bit if you copy
  83. $.clib.h to RAM:$.h as that is where the compiler will look first.  Please
  84. do not look at the dodgy ways the display modes are handled - this is my
  85. first time at using arrays of structures whose fields are functions.  In
  86. each place where I have used an array of functions it speeds up the code a
  87. bit, but it looks weird although the sorting procedure is quite neat.
  88.  
  89. Suggested improvements and/or bug reports should be mailed to one of the
  90. addresses below, although I make no guarantees over production of new
  91. versions incorporating the improvements or with the bugs fixed. (The source
  92. isn't *that* bad -- someone should be able to tinker it about a bit. A good
  93. start would be removing all the comments from wimpif.c which I think just
  94. get in the way, but I can't be bothered to remove them. :-) )
  95.  
  96. Do not tamper with "abscode.h" as this is automatically generated by the
  97. BASIC program `ARM_Source' which assembles the code to run the application.
  98.  
  99. Acknowledgement
  100. ===============
  101.  
  102. Acknowledgement is due to "cs2du@hatfield.ac.uk" who wrote `mod2abs'
  103. available from the Newcastle info-server, whose idea it was to convert
  104. modules into applications.  I have taken this idea one step further allowing
  105. multiple modules per application file.
  106.  
  107. Versions
  108. ========
  109.  
  110. 1.00    First working version (01-Jun-1992)
  111.  
  112. Future Enhancements
  113. ===================
  114.  
  115. Allow filetypes other than module to be included. eg. Sprites to be added to
  116. the Wimp's common sprite pool.  Already mostly capable of handling this. 
  117. Only need to change the file type of the `Module' to that of a sprite file
  118. and set the icon strings (see wimpif.h).  But also need to rewrite
  119. ARM_Source code to handle the new data.  I suspect a sprite might not like
  120. being called upon to initialise :-).  But still only handling one type at a
  121. time.
  122.  
  123. Do selective redrawing, not just whack all the icons out for every
  124. rectangle.  To be fair, though, I think that Wimp_PlotIcon is checking
  125. anyway.  I don't see how else it could preform redraws so quickly.
  126.  
  127. Contact Address
  128. ===============
  129.  
  130. I may be sent e-mail at the following addresses which can only be guaranteed
  131. until July 1994:
  132.  
  133. snb90@ecs.soton.ac.uk
  134. snb@mail.soton.ac.uk
  135.  
  136. S.N.Brodie@ecs.soton.ac.uk   -- only if the name server is up :-)
  137.  
  138. ===========================
  139.  
  140. Stewart Brodie, 1 June 1992
  141.