home *** CD-ROM | disk | FTP | other *** search
/ Action Ware 10: Quake / ACWARE10.iso / acware10 / editors / mdlv14 / mdlsrc.txt < prev    next >
Text File  |  1996-08-07  |  4KB  |  108 lines
  1. ------ meddle source code read me ---------------
  2.  
  3. WARNING: USE THIS SOURCE AT YOUR OWN RISK! THE AUTHOR IS NOT
  4. RESPONSIBLE FOR ANY LOSS OF DATA OR OTHER DAMAGE CAUSED BY USE
  5. OF THIS SOURCE CODE!
  6.  
  7. ------ ramblings ------
  8.  
  9.  
  10. [cut much stuff] 
  11.  
  12. Also I hope someone ports this to linux, since I've had a few
  13. questions about that...
  14.  
  15. LASTLY, there are some bad programming techniques in this source as 
  16. well as some errors which really don't hurt anything. Too bad.
  17.  
  18. ------ the files ------
  19.  
  20. This is all i'm gonna say about the contents of the files, 
  21. but you can email me if you have a question:
  22.  
  23. makefile    ::  it's the make file (duh)
  24. mdl.pal     ::  the palette for quake (comes with meddle)
  25. mdl.map     ::  color map (comes with meddle)
  26. mdl.cfg     ::  config file for program (comes with meddle)
  27. mdl.cc      ::  the main program, reads command line, cfg file, etc.
  28.                 it now also has a small help section
  29. mdl_io.cc   ::  read/write mdl file, set up 3d data
  30. mdl_2d.cc   ::  All the 2D editing and displaying things 
  31. mdl_3d.cc   ::  All the 3D editing and displaying things
  32. bg_grx.cc   ::  My graphics routines converted to grx with a lot of
  33.                 unused and redundant stuff. A lot of 3dgpl stuff pasted
  34.                 in there.
  35. bg_mouse.cc ::  my mouse routines (yuck)
  36. bg_grx.h    ::  header file for graphics and
  37.                 more 3d junk
  38. bg_mouse.h  ::  header file for mouse stuff
  39. mdl.h       ::  header file for main program
  40. cwsdpmi.exe ::  dpmi environment (comes with meddle)
  41.  
  42. I bet most of you are reading this because you want to add texture
  43. mapping to something. Well, here is some help. You'll have to look
  44. at stuff towards the end of bg_grx.cc, you'll need to cut and 
  45. paste alot. It doesn't do proper volume clipping either. You also
  46. should look at mdl_3d.cc since that is where the meat is. It is 
  47. completely un-optimized. If you don't understand the 3d format, it
  48. is similar to that found in the book by Allen Watt ( i think that's
  49. his name) on 3d graphics. In the main loop I convert all points
  50. to the eyeball (camara) coordinate system, sort the sides, back
  51. face removal, then draw them. That's it.
  52.  
  53. The texturing routine is a little different from 3dgpl, it just
  54. uses bilinear mapping instead of perspective corrected. 
  55. Gouraurd shading has been added to the texture mapping (like
  56. quake).
  57.  
  58. // this part is junk... but may help some
  59. Lastly, I included 3ds2mdl.cc which kinda works. It is a program
  60. which reads 3ds files and saves them as an mdl file. It only reads
  61. one object and is in the experimental stage. I did make some quake 
  62. models with it though. You just have to keep the number of polys low.
  63. And use MedDLe to do the mapping. The makefile for it is called 
  64. makefile.3ds. This may be of some help to someone. Figuring out the
  65. 3ds file format wasn't the easiest thing to do with the docs I had,
  66. (and I didn't have 3ds!), so if you release a converter of some sort,
  67. please give me some credit. The hard part is done, you just need to
  68. fix some things.  
  69.  
  70. Note i didn't fix this to work with the new version of the models. 
  71. // end junk
  72.  
  73. ------ compiling ------
  74.  
  75. You should be able to compile this stuff as is with DJGPPv2 and
  76. GRXv2. I will tell you right now that I am one of the best source
  77. code thieves. But I do give credit where credit is due. Most of the 
  78. 3d code was adapted from 3dgpl (get it at x2ftp.oulu.fi) as stated in
  79. the meddle read me. If your good enough to understand the stuff your 
  80. stealing, then fine, it saves time. That's why meddle source is here.
  81. If you can make heads or tails out of it, it may help you make 
  82. your editor. Take what you want, just give credit to whom you feel
  83. deserves it.
  84.  
  85. note: the 3ds2mdl might not compile (or even work). But it should, I just
  86. haven't tested it for some time and it might be an old version.
  87.  
  88. oh, and just type 'make' to make the program. :)
  89.  
  90. -------- LAST WORD ------
  91.  
  92. The meddle project IS NOT DEAD. It's just that I don't have much time
  93. now a days. I am learning vc++, and will continue MedDLe in windows.
  94. (yea right)
  95. I also plan to make it a real 3d editor. 
  96. (yea right)
  97. If time permits there will be 
  98. some quake map editing features like monster placement and stuff. For 
  99. you dos and linux guys, I give you this code :)
  100.  
  101. -----------------------
  102. brian martin
  103. the zombywoof
  104.  
  105. brian@phyast.pitt.edu
  106. www.phyast.pitt.edu/~brian
  107.  
  108.