home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 007A / MORAY20.ZIP / UTILS / 3DTO3D.TXT < prev    next >
Text File  |  1995-11-19  |  6KB  |  173 lines
  1.  
  2.  
  3.                                 3Dto3D
  4.  
  5.               a little 3D to 3D Format Converter Version 1.0
  6.                              by Thomas Baier
  7.                               November 1995
  8.                          Compuserve: 100527,3011
  9.                        Internet  : thbaier@ibm.net
  10.                         Copyright by Thomas Baier
  11.  
  12.  
  13.  
  14.    Version 1.0 and later of 3Dto3D are Shareware and may be distributed
  15.    freely, provided that you leave this documentation file in the
  16.    archive. Note that this program is fully functional.
  17.  
  18.    Additionally you need the DOS4GW - Extender Version 1.95/1.96/1.97.
  19.    
  20.    If you enjoy this program, use it frequently, and can afford to pay
  21.    a registration fee, then send $10 to: 
  22.    
  23.                         Thomas Baier 
  24.                         Ammerseestr.9
  25.                         85551 Kirchheim 
  26.                         Germany
  27.    
  28.    Please include your name and mailing address.
  29.    With this registration you help me improve 3dto3d. With registration you 
  30.    can expect a prompt response on questions or bugs. Thanks. 
  31.    
  32.  
  33.    This program is a little utility to convert 3D files to a number of
  34.    other 3D formats. It can generate smooth triangles for those formats
  35.    that support it, allowing you to specify the angle under which the
  36.    faces should be smoothed.
  37.  
  38.  
  39.    INPUT
  40.  
  41.    This version supports the following input formats:
  42.  
  43.    - .RAW
  44.      Simple RAW format in the form: pnt0 pnt1 pnt2
  45.      Multiple objects are supported if the file is in the form:
  46.      NAME_OBJECT1
  47.      pnta00 pnta01 pnta02
  48.      pnta10 pnta11 pnta12
  49.      pnta20 pnta21 pnta22
  50.      ...
  51.      NAME_OBJECT2
  52.      pntb00 pntb01 pntb02
  53.      pntb10 pntb11 pntb12
  54.      pntb20 pntb21 pntb22
  55.      ...
  56.  
  57.      see chess.raw for an example.
  58.  
  59.    - .3DS
  60.      Binary mesh format for 3D Studio (Trademark ...)
  61.      only objects with faces are supported
  62.      Highlight output does not work (convert to RAW first and then to OBT).
  63.  
  64.    - .OBJ
  65.      Binary mesh format for Imagine 2.x/3.x (Trademark ...)
  66.      only objects with faces are supported
  67.      Tip: If you have a object generated in the form - editor, load it
  68.      into the detail editor, select it, use the "merge" command and
  69.      save it as a ".obj" file. Now the object is ready for converting.
  70.      Tip: If you have object files with the extension .iob (Amiga
  71.      extension ??) rename it to ".obj".
  72.      Highlight output does not work (convert first to RAW and then to OBT).
  73.  
  74.  
  75.    OUTPUT
  76.  
  77.    This version supports the following output formats:
  78.  
  79.    - .RAW
  80.      The converter can generate a smooth RAW from an unsmoothed
  81.      RAW and vice versa.
  82.    - .UDO/.INC
  83.      Userdefined Object format for Moray V2.x and a inc file for
  84.      POVRAY or POLYRAY.
  85.      The converter writes a UDO file and a corresponding POV-Ray or 
  86.      Polyray include file, generating triangles (poly's) and 
  87.      smooth_triangles (patches). Use the /e parameter to reduce
  88.      the edge count if you are getting too many edges in the UDO file.
  89.      A value of /e5 will retain just about all edges that are not coplanar.
  90.      A value of /e60 will throw out lots of edges and retain only pretty
  91.      sharp contours.
  92.    - .ASC
  93.      ASCII object format for 3D Studio
  94.    - .OBT
  95.      ASCII object format for Highlight Pro
  96.      Converts only RAW to OBT
  97.    - .RPL
  98.      ASCII object macro format for Real 3D. (Version 3.12)
  99.    - .3DS
  100.      Binary object format for 3D Studio
  101.  
  102.    If inputtype and outputtype are the same, $$$ is used as filename.
  103.  
  104.  
  105. Usage:
  106.                 3dto3d xxxx [options]
  107. Example:
  108.                 raw2_3d chess /e20 /t3
  109. Options:
  110.                 /svalue (value = Smoothing Angle in degrees, default 70.0°)
  111.                 - smoothes tri's with a normal angle below value
  112.                   affects only output of /o1, /o2, /o3
  113.  
  114.                 /evalue (value = Edge Detect Angle in degree, default 0.0°)
  115.                 - throws out edges with an angle below value
  116.                   affects only the UDO file created with /o2 and /o3
  117.  
  118.                 /v(Verbose on)
  119.                 - gives status messages on the progress of the conversion
  120.  
  121.                 /tvalue (value = Swapmode)
  122.                         value = 0 normal (default);
  123.                         value = 1 swap X <-> Y;
  124.                         value = 2 swap X <-> Z
  125.                         value = 3 swap Y <-> Z
  126.                 - swaps axis
  127.  
  128.                 /ivalue (value = Inputtype)
  129.                         value = 0 RAW (default)
  130.                         value = 1 3DS (3D Studio)
  131.                         value = 2 OBJ (Imagine)
  132.  
  133.                 /ovalue (value = Outputtype)
  134.                         value = 0 RAW
  135.                         - makes a pure RAW file for testing
  136.                           form: pnt0 pnt1 pnt2
  137.  
  138.                         val = 1 Smoothed RAW
  139.                         - makes a smoothed Raw file
  140.                           form: pnt0 norm0 pnt1 norm1 pnt2 norm2
  141.  
  142.                         val = 2 UDO + POV/INC <Moray/Povray>(default)
  143.                         - makes a POVRAY include File with triangles
  144.                           and a MORAY UDO file
  145.  
  146.                         val = 3 UDO + POLY/INC <Moray/Polyray>
  147.                         - makes a POLYRAY include File with triangles
  148.                           and a MORAY UDO file
  149.  
  150.                         val = 4 ASC <3DStudio>
  151.                         - makes a 3DStudio ASC file
  152.  
  153.                         val = 5 OBT <HighLight>
  154.                         - makes a HighLightPro OBT file
  155.                           (only works with RAW files)
  156.  
  157.                         val = 6 RPL <Real3D Macro>
  158.                         - makes Real3D RPL file, ASCII Macro
  159.  
  160.                         val = 7 3DS <3DStudio>
  161.                         - makes a 3DStudio binary file
  162.  
  163.                         val = 8 UDO + POV/INC <Moray/Povray>(wire)
  164.                         - makes a POVRAY include File
  165.                           and a MORAY UDO file
  166.                           For every edge in the object a cylinder
  167.                           and for every vertex a sphere is outputted
  168.                           The radius is controlled via /s
  169.                           /s1.0 for radius 1.0
  170.                           The goal is to make a real wireframe object
  171.                           Try it !!!
  172.  
  173.