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