home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / formats / ttddd / spec / t3d_src / readme.r39 < prev    next >
Encoding:
Text File  |  1994-06-01  |  13.7 KB  |  288 lines
  1. ==========================================================================
  2.  
  3. NEWS FLASH!
  4.  
  5.     As of release #38 of T3DLIB, I have decided to change what I release.
  6. To promote the users of T3DLIB to register this ShareWare with me, I have
  7. decided to not release the entire collection of goodies with the public
  8. release.  Then, when people register, I will either e-mail (if possible)
  9. the other goodies, or mail them on a floppy.
  10.     Of course, all currently registered T3DLIB users can simply send me
  11. e-mail and I will e-mail them back the latest collection of T3DLIB goodies,
  12. or if you do not have access to e-mail, then please mail me a blank floppy
  13. disk, and I will be happy to fill it up and mail it back to you, without
  14. further charge.
  15.     Please see the CHANGES file to see what is new in this release.  Of
  16. particular interest may be that I now support reading and writing of
  17. Imagine staging files.
  18.  
  19.     The "goodies" that are currently being "held back" are:
  20. 1) bumpit - algorithmically perturbs the points of an object - great for morphs
  21. 2) spherize - confines points of an object to a unit sphere - great for morphs
  22. 3) mbb - calculates and prints the Minimum Bounding Box of an object
  23. 4) set_texture_path - (re)sets the root path of all textures in an object
  24. 5) set_brush_path - (re)sets the root path of all brushmaps and stencils in object
  25.  [as of R39...]
  26. 6) texit - applies Imagine 2.0 texture to an object (No source provided)
  27.  
  28.     So please register, and enjoy T3DLIB!  Thanks!
  29.  
  30.     And now I return you to the portion you may have already read...
  31.  
  32.                                                         -- Glenn
  33.  
  34. ==========================================================================
  35. ==========================================================================
  36. ==========================================================================
  37.  
  38. This is an lzh file containing a set of programs called T3DLIB (previously
  39. known as TTDDDLIB).  These programs convert 3D objects in the binary TDDD
  40. format into the Textual TDDD (TTDDD) format and back again, and also
  41. provide a number of other conversion filters.
  42.  
  43. -----------------------------------
  44.  
  45. These programs are provided as SHAREWARE. If you choose to use these programs,
  46. you are obligated to send in a $25 (US) to the author, Glenn Lewis.
  47. His address:
  48.  
  49.    Glenn M. Lewis
  50.    8341 Olive Hill Court
  51.    Fair Oaks, CA  95628
  52.    (USA)
  53.  
  54. Glenn is also reachable via email at glewis@pcocd2.intel.com.
  55.  
  56. ----------------
  57.  
  58. Enjoy these programs and the objects, and send in your Shareware fee to Glenn!
  59.  
  60. [condensed message from...]
  61. -Steve
  62.  
  63. --------------------------------------------------------------------------
  64. Steve Worley                                         Worley@cup.portal.com
  65. --------------------------------------------------------------------------
  66.  
  67.  
  68.     As of March 31, 1992, I have included the Amiga executables of the latest
  69. revision of T3DLIB in the files:
  70.  
  71.   T3DLIB*_68000exe.lha  (68000, non-FPU version)
  72.   T3DLIB*_68030exe.lha  (68030, FPU version)
  73.  
  74.     Note that these were compiled with SAS/C, and so they do not have that bogus
  75. restriction of running only under version 2.04 of the operating system like the
  76. R33 version of the executables had!
  77. Yahoo!  Thanks, Scott!
  78.  
  79.     You will find several filters in there, all of which support Imagine
  80. objects (and, of course, Turbo Silver objects).  The most important filter you
  81. will use is called "readwrite", which basically replaces the old ReadTDDD and
  82. WriteTDDD programs.
  83.  
  84.     "ReadWrite" will read from its standard input, *EITHER* an Imagine object
  85. file *OR* a TTDDD file, and it is smart enough to know which is which without
  86. you telling it.  (In fact, all of the executables from T3DLIB now read
  87. either type of file!)  It will also read old Turbo Silver files, and make all
  88. external objects internal.
  89.  
  90.     "readwrite" will, by default, output TTDDD files to its standard output.
  91. But if you give it the "-tddd" flag (or "-t" for short), it will output
  92. Imagine object files directly!
  93.  
  94.     Remember that all of these programs are filters, so you must redirect
  95. their input and output from/to files.
  96.  
  97.     readwrite   - reads and writes both TDDD and TTDDD files
  98.     tddd2mif    - reads TDDD or TTDDD files and outputs FrameMaker MIF files
  99.     tddd2ps     - reads TDDD or TTDDD files and outputs isometric wireframes
  100.                   with Top, Front, Right, and Isometric views in PostScript
  101.     tddd2nff    - reads TDDD or TTDDD files and outputs NFF files
  102.     tddd2off    - reads TDDD or TTDDD files and outputs OFF files
  103.     tddd2ray    - reads TDDD or TTDDD files and outputs Rayshade 4.0 files
  104.     tddd2vort   - reads TDDD or TTDDD files and outputs VORT files
  105.  
  106. Two new filters as of release 34 are:
  107.     tddd2dxf    - reads TDDD or TTDDD files and outputs DXF (AutoCAD) files
  108.     tddd2pov    - reads TDDD or TTDDD files and outputs POV-Ray 1.0 files
  109.  
  110. Here is some documentation on the OFF and NFF versions:
  111.  
  112. TDDD is a complex format that allows heirarchical structure to be
  113. defined. Thus, a car might be defined as different parts, such as the
  114. frame, the doors, the tires, and the windows. When you are converting
  115. from TDDD, sometimes you will want to merge all of the sub-parts together
  116. to form one single object, but other times it is convienient to have the
  117. different parts saved as seperate objects so you can manipulate them 
  118. easier. T3DLIB supports both conversion methods by a flag, -split. 
  119.  
  120. The programs included:
  121.  
  122. 1) tddd2off
  123.  
  124. Usage: tddd2off [-geom_only] [-split] [infile] [outfile]
  125.  
  126.    Converts an input TDDD or TTDDD file to an OFF format file. It defaults
  127.    to outputting both a .geom and a .ipcol file, but if you are only
  128.    interested in the structure of the object, the flag -geom_only
  129.    (or -g) will ouput only the point, edge, and face information.
  130.    -split will split heirarchical objects into individual objects.
  131.    In this case, if the outfile name is "model", the output names
  132.    would be "model001.geom", "model002,geom", etc. 
  133.  
  134. 2) tddd2nff
  135.  
  136. Usage: tddd2nff [infile] [outfile]
  137.  
  138.    Converts an input TDDD or TTDDD file and saves an NFF format file.
  139.  
  140. -------------------------------------------------------------------------
  141.  
  142.     Althought the following does not cut it for documentation (hopefully
  143. I will have some real docs by the next release...), I thought this might
  144. be helpful to some people:
  145.  
  146. >>>>> On Wed, 24 Jun 92 13:23:29 -0400, kelly@ll.mit.edu said:
  147.  
  148. Dave> Greetings;
  149.  
  150. Dave>         Can anyone out there tell me a little about the program
  151. Dave> TTDDD?  Specifically what kinds of things can be done with it
  152. Dave> (especially by none programmers such as myself). I downloaded some
  153. Dave> nice 3D fonts from hubcap that were converted from TeX with TTDDD.
  154. Dave> Is this the kind of thing that I could do with little or no
  155. Dave> programming? Also what other programs/excessories would be useful
  156. Dave> with TTDDD? Thanks for the help!
  157.  
  158.         Hi!  I am Glenn Lewis, the author of TTDDD and T3DLIB (previously
  159. known as "TTDDDLIB").  I thought I would post to the list so that
  160. everybody would be up-to-date.
  161.  
  162.         Basically, the old TTDDD programs, called "ReadTDDD" and
  163. "WriteTDDD" are obsolete, and do not support any of the new Imagine
  164. sub-chunks.  Let me give you a summary of what T3DLIB can do for you
  165. from my point of view, which is obviously quite biased.
  166.  
  167.         First, T3DLIB consists of two things: a linkable library of
  168. routines that allow programmers to manipulate 3D objects and scenes
  169. easily from within their own applications.  (Of course if you wish to
  170. use my code in a commercial product, you must check with me first, as
  171. one author failed to do.)  The second part of T3DLIB is a collection of
  172. filters that are built using the linkable library.  T3DLIB supports
  173. (reads/writes) most all "chunks" in the Imagine TDDD file format.
  174.  
  175.         The source code (and executables that run under *BOTH* 2.04 and 1.3
  176. of the Amiga operating system without any special libraries) are available on
  177. hubcap.clemson.edu [130.127.8.1] in the directory:
  178. pub/amiga/incoming/imagine/TTDDDLIB.  Also, many people have contributed
  179. some really nice programs that use or enhance T3DLIB.  Please look in the
  180. subdirectory called "contrib" on hubcap for a few of these.
  181. [NOTE: I have added a few of these programs to the registered T3DLIB disk.]
  182.  
  183.         The main program included in T3DLIB is called "ReadWrite".  This
  184. is the one that makes the previous two programs obsolete, as mentioned
  185. above.  "ReadWrite" is simply a filter, but a powerful one.  First off,
  186. I better describe what the TTDDD format is: TTDDD is "Textual TDDD", and
  187. "TDDD" is an IFF (Interchange File Format [?]) that has many "chunks"
  188. and "sub-chunks" that describe objects and scene for Imagine (and
  189. previously Turbo Silver).  "TDDD" was created by Impulse, Inc.  TTDDD
  190. was created by me, and allows any text file to describe in full detail,
  191. all that a TDDD file can describe, but is editable and can be
  192. algorithmically generated.
  193.  
  194.         Back to "ReadWrite"...  ReadWrite reads a file from its standard
  195. input, and writes a file to its standard output.  The input file can be
  196. *either* a TTDDD *or* a TDDD file, and the output, by default, is a
  197. TTDDD file.  If "ReadWrite" is given the "-tddd" (or "-t" for short)
  198. flag on its command line, it will write a TDDD file that is directly
  199. loadable by Imagine.  Since Imagine does not support "external" objects
  200. like Turbo Silver did, "ReadWrite" will load any "external" objects at
  201. that time and make them internal to make Imagine happy.  Also, if one
  202. wishes to "optimize" points and edges (by simply removing redundancies),
  203. the "-m" (for "merge") flag will accomplish this.  This does, however,
  204. take much longer processing time, so sit back and let it crunch on the
  205. object(s).
  206.  
  207.         This, obviously, is the most useful (and necessary) program for
  208. dealing with TTDDD and TDDD files.  Here is a list of other utilities
  209. that are included:
  210.  
  211. tddd2off tddd2nff tddd2vort tddd2ray tddd2ps tddd2mif tddd2dxf tddd2pov
  212.  
  213.         All of the above are also filters, and perform the following
  214. conversions:
  215.  
  216. tddd2off  - converts TDDD (or TTDDD automatically) to OFF format
  217. tddd2nff  - converts TDDD (or TTDDD automatically) to NFF format
  218. tddd2vort - converts TDDD (or TTDDD automatically) to VORT format
  219. tddd2ray  - converts TDDD (or TTDDD automatically) to Rayshade 4.0 format
  220. tddd2ps   - converts TDDD (or TTDDD automatically) to PostScript format
  221. tddd2mif  - converts TDDD (or TTDDD automatically) to MIF format
  222. tddd2dxf  - converts TDDD (or TTDDD automatically) to DXF (AutoCAD) format
  223. tddd2pov  - converts TDDD (or TTDDD automatically) to POV-Ray format
  224.  
  225. OFF is DEC's Object File Format.
  226. NFF is Eric Haines' (SP?) Neutral File Format.
  227. VORT is the "Very Ordinary Ray Tracer", I believe.
  228. Rayshade is that awesome program by Craig Kolb.
  229. PostScript output has 4 views: Top, front, right, and isometric.
  230. MIF is "Maker Interchange Format" for FrameMaker, and looks like the
  231.     PostScript output, but is editable from within FrameMaker.
  232. DXF is AutoCAD's interchange file format.
  233. POV is POV-Ray's file format.
  234.  
  235.         The entire T3DLIB package is shareware, and costs $25 to
  236. register.  Details are in the sources archive on hubcap.  As a "Thank You" 
  237. for registering, I will send you a disk with the two utilities: TSTeX
  238. (which created the font you viewed on hubcap from public domain TeX
  239. fonts [in PK format]) and SQuad, which generates superquadric surfaces
  240. based upon parameters that you supply it.  Examples of superquadrics are
  241. torii, cubes (with rounded edges), diamonds, and a sphere is a
  242. degenerate superquadric.  I will also send you a copy of the TDDD file
  243. format, which is basically the documentation for the TTDDD file format,
  244. as it uses the same names, but is editable.  I also provide some
  245. examples on the diskette.
  246.  
  247.         But back to your original question: What can this do for
  248. non-programmers?  Well, you will probably find the utilities useful, and
  249. you may be interested in looking at the geometric details of an object
  250. (OK, maybe not :-).
  251.  
  252.         Most definitely, though, the power of the package comes from
  253. being able to algorithmically generate or modify objects and scenes for
  254. animating or for simply creating/modifying complex objects.
  255.  
  256.         Helge Rasmussen, for example, created a program called
  257. "igensurf" that uses the TTDDD format and filters to generate basically
  258. any surface that you can describe mathematically in closed form.
  259.  
  260.         Steve Worley, for another example, created an animation of a
  261. waterfall by algorithmically controlling the positions of thousands of
  262. little spheres.
  263.  
  264.         I, for a third example, created the steam locomotive object on
  265. hubcap with the help of TTDDD, and animated the pistons and wheels.
  266.  
  267.         One of my registered shareware users has a cabinetry business
  268. and models all cabinets and drawers using TTDDD first, and presents a
  269. video of his plans to the customer before he ever starts, making each
  270. presentation expressly unique for that person's kitchen or room.
  271.  
  272.         Feel free, if you have any questions, to send me e-mail.  I hope
  273. I have answered any questions you have, without attempting to make this
  274. a commercial.
  275.  
  276.         Future work includes general object morphing for Imagine such
  277. that *any* two objects can be morphed from one to the other, with T3DLIB
  278. creating all the in-betweens, since Imagine currently can only morph two
  279. objects with the same topology (points/edges/faces).
  280.  
  281.         Of course, work on this will not continue until Steve Worley and
  282. I finish up Essence and ship it.  :-)  [Hmmm... as of release 34, that is
  283. not longer an excuse, so I will have to think of another good one.  :-) ]
  284.  
  285.                                                         -- Glenn
  286.  
  287. Glenn Lewis | glewis@pcocd2.intel.com | These are my opinions...not Intel's
  288.