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