home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / 3DT3D14.ZIP / 3DTO3D.TXT < prev    next >
Text File  |  1996-05-26  |  9KB  |  245 lines
  1.  
  2.  
  3.                                 3Dto3D
  4.  
  5.               a little 3D to 3D Format Converter Version 1.4
  6.                              by Thomas Baier
  7.                               May 1996
  8.                          Compuserve: 100527,3011
  9.                        Internet  : thbaier@ibm.net
  10.            WWW: http://ourworld.compuserve.com/homepages/thbaier
  11.                         Copyright by Thomas Baier
  12.  
  13.  
  14.  
  15.    Version 1.0 and later of 3Dto3D are Shareware and may be distributed
  16.    freely, provided that you leave this documentation file in the
  17.    archive. Note that this program is fully functional.
  18.  
  19.    Additionally you need the DOS4GW - Extender Version 1.95/1.96/1.97.
  20.    Add there is a Win95/NT version called 3dnt3d.exe.
  21.    
  22.    If you enjoy this program, use it frequently, and can afford to pay
  23.    a registration fee, then send $10 to: 
  24.    
  25.                         Thomas Baier 
  26.                         Ammerseestr.9
  27.                         85551 Kirchheim 
  28.                         Germany
  29.    
  30.    Please include your name and mailing address.
  31.    With this registration you help me improve 3dto3d. With registration you 
  32.    can expect a prompt response on questions or bugs. Thanks. 
  33.    
  34.  
  35.    This program is a little utility to convert 3D files to a number of
  36.    other 3D formats. It can generate smooth triangles for those formats
  37.    that support it, allowing you to specify the angle under which the
  38.    faces should be smoothed.
  39.  
  40.  
  41.    INPUT
  42.  
  43.    This version supports the following input formats:
  44.  
  45.    - .RAW
  46.      Simple RAW format in the form: pnt0 pnt1 pnt2
  47.      Multiple objects are supported if the file is in the form:
  48.      NAME_OBJECT1
  49.      pnta00 pnta01 pnta02
  50.      pnta10 pnta11 pnta12
  51.      pnta20 pnta21 pnta22
  52.      ...
  53.      NAME_OBJECT2
  54.      pntb00 pntb01 pntb02
  55.      pntb10 pntb11 pntb12
  56.      pntb20 pntb21 pntb22
  57.      ...
  58.  
  59.      see chess.raw for an example.
  60.  
  61.    - .3DS
  62.      Binary mesh format for 3D Studio (Trademark ...)
  63.      only objects with faces are supported
  64.      Highlight output does not work (convert to RAW first and then to OBT).
  65.  
  66.    - .OBJ
  67.      Binary mesh format for Imagine 2.x/3.x (Trademark ...)
  68.      only objects with faces are supported
  69.      Tip: If you have a object generated in the form - editor, load it
  70.      into the detail editor, select it, use the "merge" command and
  71.      save it as a ".obj" file. Now the object is ready for converting.
  72.      Tip: If you have object files with the extension .iob (Amiga
  73.      extension ??) rename it to ".obj".
  74.      Highlight output does not work (convert first to RAW and then to OBT).
  75.  
  76.  
  77.    OUTPUT
  78.  
  79.    This version supports the following output formats:
  80.  
  81.    - .RAW
  82.      The converter can generate a smooth RAW from an unsmoothed
  83.      RAW and vice versa.
  84.    - .UDO/.INC
  85.      Userdefined Object format for Moray V2.x and a inc file for
  86.      POVRAY or POLYRAY.
  87.      The converter writes a UDO file and a corresponding POV-Ray or 
  88.      Polyray include file, generating triangles (poly's) and 
  89.      smooth_triangles (patches). Use the /e parameter to reduce
  90.      the edge count if you are getting too many edges in the UDO file.
  91.      A value of /e5 will retain just about all edges that are not coplanar.
  92.      A value of /e60 will throw out lots of edges and retain only pretty
  93.      sharp contours.
  94.      Additional wired and wired/blobby output for povray is supported
  95.    - .ASC
  96.      ASCII object format for 3D Studio. Hidden edges are supported
  97.    - .OBT
  98.      ASCII object format for Highlight Pro
  99.      Converts only RAW to OBT
  100.    - .RPL
  101.      ASCII object macro format for Real 3D. (Version 3.12)
  102.    - .3DS
  103.      Binary object format for 3D Studio. Hidden edges are supported
  104.    - .OBJ
  105.      Binary object format for Imagine.
  106.      Hidden edges (Quick edges) and smoothing (Sharp Edges) are supported
  107.    - .RWX
  108.      ASCII objectformat for RenderWare
  109.    - .WRL
  110.      ASCII objectformat for VRML 1.0
  111.  
  112.    If inputtype and outputtype are the same, $$$ is used as filename.
  113.  
  114.  
  115. Usage:
  116.                 3dto3d xxxx [options]
  117. Example:
  118.                 3dto3d chess /e20 /t3
  119. Options:
  120.                 /svalue (value = Smoothing Angle in degrees, default 70.0°)
  121.                 - smoothes tri's with a normal angle below value
  122.                   affects only output of /o1, /o2, /o3, /o10
  123.  
  124.                 /evalue (value = Edge Detect Angle in degree, default 1.0°)
  125.                 - throws out edges with an angle below value
  126.                   affects POV/UDO, 3DS and OBJ files created with
  127.                   /o2, /o3, /o4, /o7, /o8, /o9, /o10
  128.  
  129.                 /v(Verbose on)
  130.                 - gives status messages on the progress of the conversion
  131.  
  132.                 /u(Unify Mesh on)
  133.                 - changing all normal vectors pointing outside
  134.  
  135.                 /j(write absolute path to udo/inc file)
  136.  
  137.                 /rvalue (value = radius for wireframe objetcs, default 1.0)
  138.  
  139.                 /tvalue (value = Swapmode)
  140.                         value = 0 normal (default);
  141.                         value = 1 swap X <-> Y;
  142.                         value = 2 swap X <-> Z
  143.                         value = 3 swap Y <-> Z
  144.                 - swaps axis
  145.  
  146.                 /xvalue (val = sizingvalue, default 1.0)
  147.                 - sizes the mesh.
  148.                   values from 0.0 to 1.0 shrink the mesh
  149.                   values greater than 1.0 enlarg the mesh
  150.                   negative values mirror the mesh
  151.  
  152.                 /ivalue (value = Inputtype)
  153.                         value = 0 RAW (default)
  154.                         value = 1 3DS (3D Studio)
  155.                         value = 2 OBJ (Imagine)
  156.  
  157.                 /ovalue (value = Outputtype)
  158.                         value = 0 RAW
  159.                         - makes a pure RAW file for testing
  160.                           form: pnt0 pnt1 pnt2
  161.  
  162.                         val = 1 Smoothed RAW
  163.                         - makes a smoothed Raw file
  164.                           form: pnt0 norm0 pnt1 norm1 pnt2 norm2
  165.  
  166.                         val = 2 UDO + POV/INC <Moray/Povray>(default)
  167.                         - makes a POVRAY include File with triangles
  168.                           and a MORAY UDO file
  169.  
  170.                         val = 3 UDO + POLY/INC <Moray/Polyray>
  171.                         - makes a POLYRAY include File with triangles
  172.                           and a MORAY UDO file
  173.  
  174.                         val = 4 ASC <3DStudio>
  175.                         - makes a 3DStudio ASC file
  176.                         - /e affects hiding edges for better viewing
  177.  
  178.                         val = 5 OBT <HighLight>
  179.                         - makes a HighLightPro OBT file
  180.                           (only works with RAW files)
  181.  
  182.                         val = 6 RPL <Real3D Macro>
  183.                         - makes Real3D RPL file, ASCII Macro
  184.  
  185.                         val = 7 3DS <3DStudio>
  186.                         - makes a 3DStudio binary file
  187.                         - /e affects hiding edges for better viewing
  188.  
  189.                         val = 8 UDO + POV/INC <Moray/Povray>(wire)
  190.                         - makes a POVRAY include File
  191.                           and a MORAY UDO file
  192.                           For every edge in the object a cylinder
  193.                           and for every vertex a sphere is output
  194.                           The radius is controlled via /r
  195.                           /r1.0 for radius 1.0
  196.                           Can be used to make a 'real' wireframe object
  197.  
  198.                         val = 9 UDO + POV/INC <Moray/Povray>(blobbywire)
  199.                         - makes a POVRAY include File
  200.                           and a MORAY UDO file
  201.                           For every edge in the object a line of blobs
  202.                           and for every vertex a blob is output
  203.                           The radius and the spacing is controlled via /r
  204.                           /r1.0 for radius 1.0
  205.  
  206.                         val = 10 OBJ <Imagine Object>
  207.                         - makes a Imagine binary file
  208.                         - /e affects hiding edges for better viewing
  209.                           (Quickedges)
  210.                         - /s affects smoothing edges for better viewing
  211.                           (Sharpedges). A low value makes more edges sharp.
  212.  
  213.                         val = 11 RWX <RenderWare Object>
  214.                         - makes RenderWare object file, ASCII
  215.  
  216.             val = 12 WRL <VRML 1.0 Object>
  217.             - makes VRML object file, ASCII
  218.  
  219.  
  220.  
  221.                                 History
  222.  
  223.         Version 1.4
  224.         - OBJ (Imagine) output supported (/o10)
  225.         - Quickedges support (hidden edges in meshes) for 3ds and obj (/e)
  226.         - mesh sizing (/x)
  227.         - mesh unifing (/u)
  228.         - SharpEdges (smoothing) support for obj (/s)
  229.         - NT console compile (3dnt3d.exe)
  230.         - RWX (RenderWare) output supported (/o11)
  231.     - WRL (VRML 1.0) output supported (/o12)
  232.  
  233.         Version 1.3
  234.         - bugfix for raw input
  235.  
  236.         Version 1.2
  237.         - blobby wire
  238.  
  239.         Version 1.1
  240.         - improved 3ds import
  241.  
  242.         Version 1.0
  243.         - first public release
  244.  
  245.