home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 2 / LSD and 17bit Compendium Deluxe - Volume II.iso / a / prog / cprog / tdddconv.lha / TDDDconv.readme < prev    next >
Encoding:
Text File  |  1991-11-26  |  4.2 KB  |  118 lines
  1. This is a tar file containing a set of programs called TDDDconv. These
  2. programs convert 3D objects in the binary TDDD format into either OFF,
  3. NFF, Rayshade, or vort format. There is also a Postscript object viewer.
  4. These programs are SHAREWARE and if you use them you should send in
  5. your (nominal!) shareware fee to the address below.
  6.  
  7. On most systems, creating the programs is fairly easy; you need to
  8. uncompress the .tar file, and extract the source using "tar -xf
  9. TDDDconv.tar".  To compile the source, a makefile is provided that
  10. instructs the compiler how to assemble the programs. If you type
  11. "make", the programs tddd2ps, tddd2ray, tddd2vort, tddd2off and
  12. tddd2nff should be produced.
  13.  
  14. TDDD is a complex format that allows heirarchical structure to be
  15. defined. Thus, a car might be defined as different parts, such as the
  16. frame, the doors, the tires, and the windows. When you are converting
  17. from TDDD, sometimes you will want to merge all of the sub-parts
  18. together to form one single object, but other times it is convienient
  19. to have the different parts saved as seperate objects so you can
  20. manipulate them easier. The two main programs, tddd2off and tddd2nff,
  21. support both conversion methods by a flag, -split. The other programs
  22. only output the "merged" version.
  23.  
  24. The programs included: 
  25.  
  26. 1) tddd2off
  27.  
  28. Usage: tddd2off [-geom_only] [-split] [infile] [outfile]
  29.  
  30.    Converts an input TDDD file to an OFF format file. It defaults
  31.    to outputting both a .geom and a .ipcol file, but if you are only
  32.    interested in the structure of the object, the flag -geom_only
  33.    (or -g) will ouput only the point, edge, and face information.
  34.    -split will split heirarchical objects into individual objects.
  35.    In this case, if the outfile name is "model", the output names
  36.    would be "model001.geom", "model002,geom", etc. 
  37.  
  38. 2) tddd2nff
  39.  
  40. Usage: tddd2nff [-split] [infile] [outfile]
  41.  
  42.    Converts an input TDDD file and saves an NFF format file.  -split
  43.    will split heirarchical objects into individual objects. In this case,
  44.    if the outfile name is "model", the output names would be
  45.    "model001.nff", "model002.nff", etc. 
  46.  
  47. 3) tddd2ps
  48.  
  49.  Usage: tddd2ps [infile] [outfile]
  50.  
  51.   Outputs a ready-to-print Postscript file showing the object in wireframe 
  52.   from three orthoganal views, and a perspective view. For large objects,
  53.   the output file can get to be megabytes long, so be careful.
  54.  
  55. 4) tddd2ray
  56.  
  57.  Usage: tddd2ray [infile] [outfile]
  58.  
  59.    Converts a TDDD object to Rayshade format. Note that the conversion will
  60.    not output seperate parts like the OFF and NFF programs; this is being
  61.    worked on for a future release. 
  62.  
  63. 5) tddd2vort
  64.  
  65.  Usage: tddd2vort [infile] [outfile]
  66.  
  67.    Converts a TDDD object to vort format. Note that the conversion will
  68.    not output seperate parts like the OFF and NFF programs; this is being
  69.    worked on for a future release. 
  70.  
  71.  
  72.  
  73. Each of the five programs can also be operated as a filter, so you can use
  74. cat and pipes to process objects if you like.
  75.  
  76.  
  77. -----------------------------------
  78.  
  79. These programs are provided as SHAREWARE. If you choose to use these
  80. programs, you are obligated to send in a $25 (US) to the author, Glenn
  81. Lewis. If you think of the number of new objects you'll be able to
  82. use, you have to admit that it is well worth the investment. His
  83. address:
  84.  
  85.    Glenn M. Lewis
  86.    8341 Olive Hill Court
  87.    Fair Oaks, CA  95628
  88.    (USA)
  89.  
  90. Registered users also get code to automatically convert text strings into
  91. 3D objects using any TeX font. Logos in Rayshade are easy!
  92.  
  93. Glenn is also reachable via email for questions, bug reports, etc.
  94. at glewis@pcocd2.intel.com.
  95.  
  96. ----------------
  97.  
  98. Enjoy these programs and the objects, and send in your Shareware fee to
  99. Glenn!
  100.  
  101.  
  102. If you have any 3D objects of your own, I would -LOVE- to hear from you.
  103. Even if I can't redistribute them, I'm always trying to increase my
  104. personal library.
  105.  
  106.  
  107. -Steve
  108.  
  109. --------------------------------------------------------------------------
  110. Steve Worley                                       spworley@athena.mit.edu
  111. --------------------------------------------------------------------------
  112.  
  113. 11/26/91
  114.   
  115.    The conversion programs in this new archive are an update to the
  116. previous ones; it is more robust and does not issue spurious warnings.
  117.  
  118.   -Steve