home *** CD-ROM | disk | FTP | other *** search
/ Prima Shareware 3 / DuCom_Prima-Shareware-3_cd1.bin / PROGRAMO / PASCAL / 3DLIB / 3DO.DOC < prev    next >
Encoding:
Text File  |  1993-12-25  |  5.6 KB  |  127 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                               P.O.Box. 5517                              ║
  6.  ║                         Coralville IA 52241 U.S.A                        ║
  7.  ║                          Compuserve - 76350,333                          ║
  8.  ║                        Phone/Fax - (319) 351-8413                        ║
  9.  ║                                                                          ║
  10.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  11.  
  12. *******************************************************************************
  13. *                              3dO Documentation                              *
  14. * Last Update : Mar. 10, 1993.                                                *
  15. *******************************************************************************
  16.  
  17. *******************************************************************************
  18. *                                INTRODUCTION                                 *
  19. *******************************************************************************
  20.  
  21. 3dO is an object compiler that converts text 3d object definitions into 3d 
  22. object files.
  23.  
  24. The objects created with the 3dO object compiler can be used by 3d simple
  25. and complex objects load method.
  26.  
  27. The 3dO program is an alternate way of creating object files, to the method 
  28. that was used up to date, of creating the 3d objects with the 3d program 
  29. (available in another diskette/package).
  30.  
  31. *******************************************************************************
  32. *                                    USAGE                                    *
  33. *******************************************************************************
  34.  
  35. At the command line type :
  36.  
  37.     3DO input[.3dd] [options]
  38.  
  39. where input.3dd is the name of the object definition source.
  40.  
  41. The 3dO program will create a 3d object (.3d2) file for each SIMPLEOBJECT
  42. statement from the original source, and a .3DS file for each COMPLEXOBJECT.
  43.  
  44. *******************************************************************************
  45. *                         OBJECT DEFINITION LANGUAGE                          *
  46. *******************************************************************************
  47.  
  48. The 3dO program processes a language that is built out of series of statements.
  49.  
  50. A statement can be specified on multiple lines, if this is the case, a 
  51. continuation mark character MUST be placed at the end of the line. 
  52. The continuation mark line recognized is the '+' (plus) sign.
  53.  
  54. The SIMPLEOBJECT statement syntax is as follows :
  55.  
  56.     SIMPLEOBJECT object-name [NOGEN] +
  57.       POINT point-num x-value y-value z-value +
  58.       POINT ..... +
  59.       LINE from-point to-point +
  60.       LINE ... +
  61.     END-OBJECT
  62.  
  63. Where object-name is the name of the object file, multiple 3d points can be 
  64. specified with the POINT sub-statement, where point-num is a pointer into the 
  65. 3d point array, with x-, y- and z-value the values in the x, y and z dimensions.
  66. Multiple lines are defined using the LINE sub-statement, where from-point and
  67. to-pointsw are pointers into the 3d points array, that describe the edges of 
  68. these lines.
  69. If the optional NOGEN option is specified a stand alone simple object will NOT 
  70. be generated, this is useful if the simple object is used as part of a complex
  71. object.
  72.  
  73. The COMPLEXOBJECT statement syntax is as follows :
  74.  
  75.     COMPLEXOBJECT object-name +
  76.             CHILD child-name [AT x y z] .. +
  77.     END-OBJECT
  78.  
  79. Where object-name is the name of the complex object that will be generated,
  80. child-name is the name of the simple object that will be inserted as a child
  81. to the complex object. 
  82. The optional AT parameter TRANSLATES (moves) the child object to the requested 
  83. position in the 3D space. (for an example of a complex object definition please
  84. refer to the twopyr.3dd sample file provided with this package).
  85.  
  86. Please refer to one of the supplied *.3DD files (e.g. twolayer.3dd) for
  87. an example for the usage of this statement.
  88.  
  89. *******************************************************************************
  90. *                                   General                                   *
  91. *******************************************************************************
  92.  
  93. 3dLIB is distributed by ISoft D&M, P.O.Box. 5517 Coralville IA 52241, U.S.A.
  94.  
  95. 3dLIB is (c) copyrighted by Loewy Ron, 1991,93.
  96.  
  97. 3dLIB is a shareware package, please register your copy. To register your copy 
  98. of 3dLIB please refer to the supplied 3DLIB.REG file. 
  99.  
  100. Other programs distributed by ISoft D&M are described in the supplied 
  101. PROGRAMS.TXT file.
  102.  
  103. *******************************************************************************
  104. *                                   Contact                                   *
  105. *******************************************************************************
  106.  
  107. Please contact :
  108.  
  109.         ISoft D&M  
  110.         P.O.Box 5517
  111.         Coralville IA 52241
  112.         U.S.A
  113.  
  114.         E-Mail  : Compuserve - 76350,333
  115.         Phone   : (319) 351-8413
  116.  
  117. To contact the author directly please write to : 
  118.  
  119.         E-Mail  : Compuserve - 100274,162
  120.  
  121. *******************************************************************************
  122. *                                   Credits                                   *
  123. *******************************************************************************
  124.  
  125. 3dLIB and 3dO were written using Turbo Pascal V6.0, Turbo Pascal for Windows 
  126. V1.5 and Borland Pascal with objects V7.0, trademarks of Borland International.
  127.