home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / dubmodule / DUBmodule / DUBmodInfo < prev    next >
Encoding:
Text File  |  1996-03-24  |  3.3 KB  |  82 lines
  1.  
  2. DUBmodInfo:
  3.   introductory documentation for DrawUtilsB module V1.00 (14 Feb 96)
  4.   ------------------------------------------------------------------
  5.  
  6. This module provides a number of swi calls concerned with the creation and -
  7. to a lesser extent - editing of drawfiles. The module can handle all of the
  8. standard object types used by !Draw (up to V0.99 - RISC OS 3.5) but does not
  9. currently support unknown object types.
  10.  
  11. The basic function of the module is to organize data into the correct format
  12. as a drawfile with the minimum of code in the calling application. For
  13. example, a single call (DF_InitialiseFile) will write the drawfile header,
  14. font table object (for a supplied list of fonts) and options object (for a
  15. supplied page size code). Similarly, DF_PathStart allows all attributes of a
  16. path object to be specified in a single call and creates a path object
  17. header; e.g. one of the four standard dash patterns used by !Draw can be
  18. selected simply by number or others can be defined if required. Other
  19. features include:
  20.  
  21. •Automatic insertion/extension of the font table when text objects are
  22.  created - particularly useful if you do not know what fonts will be used in
  23.  advance.
  24.  
  25. •Choice of units (although currently they must be integer values).
  26.  
  27. •Path objects can contain bezier curves defined by points on the curve - the
  28.  module works out where the control points go (even within a subpath, it is
  29.  possible to have some control points set by the module and others by the
  30.  calling application).
  31.  
  32. •Group objects nested to a depth of 127 and tagged objects to a depth of 15.
  33.  
  34. •Transformed text & sprite objects created simply by adding a rotation value
  35.  or transformation matrix parameter to the appropriate swi call.
  36.  
  37. •Transformation facilities which can be applied to any object (e.g. a group
  38.  object) - transformation can be applied about a specified point (e.g. to
  39.  rotate an object about its centre).
  40.  
  41. •Bounding boxes set correctly on completion of an object.
  42.  
  43. •Extensive error trapping with support for error-recovery.
  44.  
  45.  
  46. See the second documentation file ('DUBmodSWIs') for details of the module
  47. swi calls.
  48.  
  49.  
  50. History
  51. -------
  52. V1.00 (14 Feb 96): First release.
  53.  
  54.  
  55. Copyright Notice: The DrawUtilsB module and the accompanying documentation
  56. files ('DUBmodInfo' and 'DUBmodSWIs') are copyright © of the author (James
  57. McQueen) 1996.
  58.  
  59. This software is supplied "as is"; no warranty of any kind concerning the
  60. merchantability of this software or its fitness for any particular purpose
  61. is given. In no circumstances shall the author or any provider or
  62. distributor of this software be liable for any damage, loss of profits, or
  63. any indirect or consequential loss arising out of the use of this software
  64. or inability to use this software.
  65.  
  66. You are free to give this software to anyone you wish via any medium
  67. including electronic bulletin board or public domain (PD) library providing
  68. it is delivered with both documentation files unaltered. You may not sell
  69. this software, except that PD libraries may make a nominal charge to cover
  70. magnetic media and postage. The module may also be distributed as a
  71. functional part of a larger application with or without its documentation
  72. files providing that authorship of the module is acknowledged in the
  73. documentation accompanying that application.
  74.  
  75.  
  76. Comments concerning this software to:
  77.     James McQueen
  78.     9/2 15 Croftbank Street
  79.     Springburn
  80.     Glasgow
  81.     G21 4LP
  82.