home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsd / df_render / !DF_Render / DUAmodInfo < prev    next >
Text File  |  1995-08-20  |  4KB  |  89 lines
  1.  
  2. DUAmodInfo:
  3.   introductory documentation for DrawUtilsA module V1.10 (21 Aug 95)
  4.   ------------------------------------------------------------------
  5.  
  6. This module provides a number of SWI calls concerned with the pre-processing
  7. and display of drawfiles. The module can render all of the object types
  8. currently used by Draw (including text area objects), and also sprite
  9. objects containing the new 'deep-colour' (32 thousand & 16 million colour)
  10. sprites introduced with RISC OS 3.5.
  11.  
  12. Since the Acorn DrawFile module is now widely available, you might ask what
  13. are the differences between that module and the DrawUtilsA module.
  14.  
  15. The DrawUtilsA module provides facilities such as drawfile verification and
  16. unknown font handling which make it more useful in a general purpose viewer
  17. (one that displays drawfiles from diverse sources). The module has been
  18. tested with drawfiles produced using applications such as Draw, DrawPlus,
  19. ArcDraw, Vector, ArtWorks and FireWorkz (and various lesser known ones);
  20. some of these introduce slight variations in the file format which do not
  21. trouble Draw but which may cause problems with the DrawFile module. One
  22. obvious difference seen with some applications which export drawfiles (e.g.
  23. ArtWorks) is that they do not set the object bounding boxes correctly, which
  24. would affect file rendering with the DrawFile module. To render the file
  25. correctly, you would need to set the bounding boxes by loading the file into
  26. Draw and then saving it or by writing your own code to do the necessary
  27. calculations (the DrawUtilsA module provides a call - DF_SetBBoxes - to do
  28. just this).
  29.  
  30. The DrawUtilsA module also does a better (if slightly slower) job of
  31. rendering text area objects. For example, the order in which escape sequences
  32. appear in the text can have unexpected effects on the vertical text spacing
  33. (line and paragraph breaks). The DrawUtilsA module makes allowance for such
  34. peculiarities and will (almost) always render the object in the same way as
  35. Draw. With the DrawFile module you may find that the text is formatted
  36. somewhat differently (although this might be avoidable if you are careful
  37. about the order of the escape sequences - see the module documentation). 
  38.  
  39. In summary,if you are writing an application which generates and needs to
  40. display drawfiles, both modules provide all the necessary rendering
  41. facilities (and the DrawFile module will save about 20K of RMA space).
  42. However, if your application needs to display drawfiles from external
  43. sources the DrawUtilsA module may be more suitable.
  44.  
  45. See the second documentation file ('DUAmodSWIs') for details of the module
  46. SWI calls.
  47.  
  48. My thanks to Acorn for allocating the SWI chunk name prefix and number
  49. ('DF_' and &4B0C0).
  50.  
  51.  
  52.  
  53. History
  54. -------
  55. V1.02 (21 Apr 95): First release.
  56.  
  57. V1.10 (21 Aug 95): Module now supports independent horizontal & vertical
  58. scaling and rotation of image. Module size reduced to 50K. Minor bug in
  59. sprite rendering corrected.
  60.  
  61.  
  62. Copyright Notice: The DrawUtilsA module and the accompanying documentation
  63. files ('DUAmodInfo' and 'DUAmodSWIs') are copyright © of the author (James
  64. McQueen) 1995.
  65.  
  66. This software is supplied "as is"; no warranty of any kind concerning the
  67. merchantability of this software or its fitness for any particular purpose
  68. is given. In no circumstances shall the author or any provider or
  69. distributor of this software be liable for any damage, loss of profits, or
  70. any indirect or consequential loss arising out of the use of this software
  71. or inability to use this software.
  72.  
  73. You are free to give this software to anyone you wish via any medium
  74. including electronic bulletin board or public domain (PD) library providing
  75. it is delivered with both documentation files unaltered. You may not sell
  76. this software, except that PD libraries may make a nominal charge to cover
  77. magnetic media and postage. The module may also be distributed as a
  78. functional part of a larger application with or without its documentation
  79. files providing that authorship of the module is acknowledged in any
  80. documentation accompanying that application.
  81.  
  82.  
  83. Comments concerning this software to:
  84.     James McQueen
  85.     9/2 15 Croftbank Street
  86.     Springburn
  87.     Glasgow
  88.     G21 4LP
  89.