home *** CD-ROM | disk | FTP | other *** search
/ GEGA 010 / GEGA010.iso / Mods / Half-Life2 / mdlview / readme.txt < prev   
Text File  |  1999-07-01  |  15KB  |  274 lines
  1. Mdlviewer v2.1.0701, a Half-Life modelviewer. Released on 1st of July 1999
  2. ---------------------------------------------------------------------------------------------
  3.  
  4. Programming by:
  5.     Frans 'Otis' Bouma        
  6.     Greg 'Ascent' Dunn        
  7.     Volker 'Dark Yoda' Sch÷neveld
  8.  
  9. Additional credits:
  10.     Core modelcode by Valve Software.
  11.  
  12. Released by: 
  13.     The HalfLife Workshop. http://www.planethalflife.com/workshop
  14.  
  15. ---------------------------------------------------------------------------------------------
  16. Version 2.1.0701
  17. ========================
  18. - Changed info about Otis and Halflife Workshop. Halflife Workshop is now hosted by planethalflife.com
  19. - Compiled using Visual C++ version 6.0 SP2, which gives about 20% speed gain
  20. - Fixed reported colordepth bugs. Now truecolor textures are hinted correctly and are uploaded as truecolor textures.
  21.   Also the screendepth is 32bit by default.
  22. - Changed Additive rendering mode. Now the polygons you see at the backface are just drawn with lines. Gives better views.
  23.  
  24. Version 2.1.0402
  25. ========================
  26.  
  27. - Fixed numerous bugs and lame things
  28. - Added texture importing and exporting functionality
  29. - Added model save functionality
  30. - Added bone rendering
  31. - Added chrome effect toggle
  32. - Added skinfamily selection
  33. - Added new loadercode for a solid, failproof loading of files
  34. - Added more errorrecovery
  35. - Added new rendermode, ADDITIVE, so you can see semitransparent textures AND bones
  36. - Added better wireframe rendercode
  37. - Added numerious nice things in the gui so the user can work with the program easier without
  38.         trapping a bug or closing the application instantaniously.
  39. - Added new splashscreen
  40. ---------------------------------------------------------------------------------------------
  41.  
  42. This modelviewer uses the MFC4.2 library, which is a dll that is used in many
  43. applications. If you don't have it, you can download it from Microsoft's ftp site.
  44.  
  45. This modelviewer can't read straight from a pakfile. You need a pakexplorer to extract
  46. the models. 
  47.  
  48. This modelviewer uses OpenGL as render API. Therefore, if you don't have an OpenGL ICD installed
  49. on your system, you won't see a thing and the viewer will probably crash. Look below to install
  50. a software OpenGL library if you don't have it.
  51.  
  52. This is the second 2.x release. If you find bugs, please let us know. You can email a bugreport to:
  53.  
  54.     otis@planethalflife.com
  55.  
  56. Please be specific what went wrong and how to reproduce the problem. Please read this document
  57. totally, because a lot of 'so called bugs' can be avoided if you do the right things :)
  58.  
  59. This modelviewer works on Windows 95/98 and NT 4.0. It's tested on windows2000 beta3 and performed fine.
  60. (But note, it runs much better on NT than it does on Win9x)
  61. ---------------------------------------------------------------------------------------------
  62.  
  63. INFO
  64. ====
  65. Everything is shown in an MDI window, which looks familliar if you work with Word or similar
  66. programs. You can open as much models at once as you like, but it will be CPU intensive.
  67.  
  68. This version does not have optimized rendercode in it yet. Therefore, we recommend not to load more
  69. than 2 or 3 models if you are on a slow system.  (again, it works better under NT or in wireframe mode)
  70.  
  71. The main controlling center is the Model Control Center (MCC). In there you can control
  72. the current selected model. The current selected model is the model in the view that has
  73. the focus. People who like keyboards more than mice can select the model in it's view
  74. and use the following keys to control it.
  75.  
  76. - Left Mouse Button for positioning of model in front of camera
  77. - Right Mouse Button for rotating the camera around the model
  78. - Wheel on wheelmouse for zooming IN or OUT
  79. - z for zooming IN
  80. - x for zooming OUT
  81. - n for next sequence
  82. - p for previous sequence
  83. - b for next body
  84. - f for toggle fog on/off
  85. - r for toggling rendermode (wireframe/textured/lightshademap/additive textured with bones)
  86. - '-' on numpad to decrease fog distance (if fog enabled)
  87. - '+' on numpad to increase fog distance (if fog enabled)
  88.  
  89. The MCC has some more options you'd like to use. First there are buttons as equivalents for the keys
  90. plus there are info boxes that tell you more about the current status of the model you are viewing.
  91.  
  92. Addionally there are a few options you can use from the MCC that don't have keyboard equivalents. These
  93. options allow you to select textures of the model, export these to a .bmp file, import .bmp files as
  94. the texture instead of the currently selected texture, toggle the chrome effect on or off of the currently
  95. selected texture and browse through the skinfamilies. See 'Customizing the model' below for details.
  96.  
  97. ===============
  98. IMPORTANT NOTE:
  99. ===============
  100. You can't view files like hgrunt02.mdl, scientist02.mdl or files like scientistt.mdl. In 
  101. general, don't load files like name0x.mdl and namet.mdl. These files are already loaded when you 
  102. view name.mdl. The files like scientist0x.mdl are sequencegroup files and scientistt.mdl are 
  103. texturefiles needed to view the model. So if you try to load these into the viewer, it will 
  104. probably crash or won't view anything at all. So to view everything about the scientist, just 
  105. load scientist.mdl. You won't miss any info. So don't email us about this, it's NOT a bug!
  106.  
  107. One tip about how you look at the model: if you pan or rotate inside the viewer, you are NOT 
  108. moving or rotating the model itself, but the camera that you use to look at the model. This is 
  109. essential different, and explaines why the chrome won't behave as expected when you pan or
  110. rotate a model. 
  111.  
  112. ---------------------------------------------------------------------------------------------
  113. HOW TO GET STARTED
  114. ==================
  115. - You'll need OpenGL libraries to run this, which can be downloaded here, if you don't already 
  116.   have them:
  117.  
  118.     windows95, windows98:
  119.         ftp://ftp.microsoft.com/softlib/mslfiles/opengl95.exe
  120.     
  121.     NT 4:
  122.         Install service pack 3 or 4 for the latest OpenGL libraries. NT4 has native
  123.         OpenGL support so it should run on native NT4 systems.
  124.  
  125. - You'll also need to unpack .mdl files from the half-life\valve\pak0.pak file. These two pak 
  126.   utilities work, as well as others:
  127.  
  128.     http://asp.planetquake.com/dl/dl.asp?qped/qped211.exe
  129.     ftp://ftp.cdrom.com/pub/quake/planetquake/chopshop/utilities/quake/pak_utils/pakexplr.zip
  130.  
  131. - With one of the 2 tools mentioned above, go to the half-life\valve dir on your harddisk
  132.   and open pak0.pak. Go into the models dir in the pakfile (a pakfile is just a compressed
  133.   directory structure). Extract all the files in that dir (except the 'player' dir) into
  134.   a directory on your harddisk, for example c:\half-life\valve\models. Now you can
  135.   view every model.mdl file in that dir (except for the special ones model0x.mdl and
  136.   modelt.mdl as mentioned above). 
  137.  
  138. - To make a screenshot, simply press alt + prntscrn on your keyboard and paste it into your
  139.   favorite paintprogram to resize it.
  140. ---------------------------------------------------------------------------------------------
  141.  
  142. CUSTOMIZING THE MODEL.
  143. ======================
  144.  
  145. We're not joking if we tell you it's now possible to put your own photo on the face of your
  146. favorite DM model. In fact, you can change any texture on any model now. After loading the
  147. model, no texture is selected. You can see that because the word 'none' is shown after 'Current
  148. texture selected'. If you press the '-' or '+' BUTTONS that are next it in the MCC, you will see
  149. that you can select a texture by simply hitting the '-' or '+' buttons. A texture is selected
  150. when it's flickering between white and the texture it has. Sometimes you'll see that you hit the '+'
  151. or '-' button and you don't see a texture selected. It's then not visible at the moment and you can
  152. make it visible by moving on to another BODY by pressing 'next body' or another skin family (if
  153. available). 
  154.  
  155. Exporting Textures.
  156. -------------------
  157. If you've selected the texture you want to work on, you can then export this texture to a .bmp file
  158. by clicking 'export texture'. A dialog pops up that allows you to select the filename how to save the
  159. texture, click Ok and the texture is saved to this file. You will be warned if the file already exists.
  160. The texture is saved as a 256 color non compressed .bmp file. You can then edit this texture
  161. in your favorite paint program. Please consider that textures can only have 256 colors and if you want
  162. to re-import this texture at the same spot of the model, don't change the size of the bitmap.
  163.  
  164. Importing Textures.
  165. -------------------
  166. If you have for example exported a hgrunt.mdl's face to a bmp file and you have added your own photo
  167. to that bmp, you want to get it onto the model ofcourse. Load the model and select the texture you want
  168. to replace. Then click 'import texture' and a dialog pops up that allows you to select the .bmp file that
  169. contains the new texture. Select the file and click Ok. If the bmp file is valid it will be put on the
  170. model immediately. Click 'none' to deselect the texture and to watch the new texture live on the model.
  171.  
  172. Toggling chrome on textures.
  173. ----------------------------
  174. Half-life introduced a neat feature on models: environment mapping. Some parts of models looked shiny
  175. and reflective, like shiny chrome. Well, you can apply this chrome to all textures on all models now.
  176. Simply select the texture as described, hit the 'Texture has chrome effect' checkbox and the chrome is
  177. switched ON if it wasn't there, and switched OFF it was. Click 'none' to deselect all textures and to
  178. watch the effect. As a cool example, try the chromeflag on the hgrunt.mdl 's pants for nylon pants!
  179.  
  180. Saving the model.
  181. ------------------
  182. If you like your changes, you want to save the model for usage later. Simply go to the file menu and click
  183. 'save as'. Select a filename and the modelfiles will then be saved to this new file. It's not recommended
  184. to overwrite sourcefiles, like a just downloaded DM model. You then can't undo the changes you've made.
  185.  
  186. I still have questions.
  187. ------------------------
  188. Of course you do. But we encourage you to experiment with the buttons. You can't hurt anything. Just
  189. experiment!
  190.  
  191. Why Is my BMP file not valid for importing?
  192. -------------------------------------------
  193. This can be of several reasons:
  194. - The bitmap is compressed
  195. - The bitmap doesn't fit onto the polygon. Because textures are not scaled by the engine, it will look ugly
  196.   anyway to try to import a bitmap that is larger or smaller than the original bitmap.
  197. - The file is not a Windows bitmap but a file in another format.
  198. - The file contains more than 256 colors. The current texturestorage format, which is Valve's, is
  199.   256 colors indexed, which means 256 colors for the total bitmap. If you want to use more colors, like 24bit per pixel, 
  200.   and who doesn't, you are loosing these if you want to save the model. Therefor we only let you load bitmaps with 256
  201.   colors.
  202.  
  203. ---------------------------------------------------------------------------------------------
  204.  
  205. DISCLAIMER AND COPYRIGHTS.
  206. ==========================
  207. This mdlviewer is not supported by Valve. It's based on the original code from Valve Software
  208. for their own mdlviewer. Also that mdlviewer isn't supported by Valve. This complete new tool
  209. is programmed by the people mentioned in the 'credits' part.
  210. Because the original sourcecode is licensed to valve and iD software no-one may make money
  211. from this tool. It's given to the public for the purpose where it's made for: viewing 
  212. halflife models. 
  213.  
  214. If you want to include the sourcecode of this modelviewer in your commercial program, please 
  215. contact Valve software. If you want to include the sourcecode of this modelviewer in your NON 
  216. commercial program, contact us and we can discuss the co-operation, on the 
  217. condition that you won't make money from the non-commercial program after you've included the 
  218. sourcecode. 
  219.  
  220. Use this tool as-is. There is no warranty and there will also be no warranty. It's truely tested 
  221. on Windows 95, Windows 98 and Windows NT. As with all free software: use it at your own risk. :)
  222.  
  223. The zipfile containing the modelviewer may not be modified in a way that the modelviewer is
  224. separated from this textfile. No-one may alter this textfile. If you want to publish 
  225. Mdlviewer on a website or other distribution medium, you are free to do so, unless you
  226. won't charge money for the modelviewer or the ziparchive.
  227.  
  228. If you use a model made by others and change stuff on it and release it as your own, please consider
  229. that the model you used is made by someone who wants copyright and credits for his/hers work. Always
  230. include a note in a textfile with the model that states who made the original. Respect work of
  231. others!
  232.  
  233. Mdlviewer is (c)1998-1999 Ascent, Dark Yoda & Otis
  234. ---------------------------------------------------------------------------------------------
  235.  
  236. KNOWN PROBLEMS AND MALFUNTIONS.
  237. ===============================
  238. - Sometimes a sequence is reported to have a length > 0 milliseconds but nothing happens. Some
  239.   gibmodels have this 'problem'. The sequence length is calculated from the number of frames
  240.   that are reported in the modelfile. It's ok to use this length as a length for the sequence
  241.   in a multimanager. The length is only mentioned as a key to have correct values for your
  242.   multimanager to handle more than 1 scripted sequence, without having you tweak and tune
  243.   the map by trial and error.
  244. - On NT with a TNT and detonator drivers and a resolution of 1600x1200 it will lockup after loading
  245.   more than 4 models after eachother. This is a driver problem and there is no solution at the moment
  246.   for this.
  247. - On NT sometimes the wheelmouse of logitech (mouseman) will crash the application when using the wheel
  248.   for zooming purposes. This is a driver problem and you should get the latest mousedrivers to fix this
  249.   (they used ugly code :) )
  250. - Sometimes the bones seem really dark when displaying the model in additive rendering mode. (the one with the
  251.   transparent textures). This is due to the blendingmodes we used to display the additive rendering mode.
  252. ---------------------------------------------------------------------------------------------
  253.  
  254. CONTACT
  255. ===============================
  256. If you're willing to contribute info or share your bugreports with us, please email to
  257.  
  258.     otis@planethalflife.com
  259.  
  260. Please keep your questions related to the tool. We're willing to help everyone with certain
  261. mapping problems, but there are other resources on the net that will help you even more,
  262. and probably faster :)
  263.  
  264. Development has stopped and we've released the sourcecode of the mdlviewer to the public.
  265. Feel free to adjust the code. If you've added a cool feature, please drop us a line. We always
  266. want to hear from fans!
  267.  
  268. Have fun and stay tuned!
  269.  
  270.     Ascent, Dark Yoda and Otis on 1st of July 1999
  271.     -----------------------------------------------
  272.     Half-life Workshop: http://www.planethalflife.com/workshop
  273.  
  274.