*********************************************************************************** RELEASE NOTES to Winterway 3D Engine Version 1.0 Released 27.5.2002 By T Talvitie 2002 website: trade.kauppa.turkuamk.fi/~tatalvit mailto: tapsaprogramming@hotmail.com *********************************************************************************** CONTENT 1 legal stuff 2 engine features 3 known bugs 4 installing 5 using the engine 6 system requirements 7 file listing *********************************************************************************** 1 LEGAL STUFF All executable, source and image files that are included to this release are totally Public Domain. This means that everybody are welcome to share, modify and copy these files or parts of them. Only the copyright of the document files (including this file) I keep by myself. Documents may only be copied with the unmodified original file packages and may not to be modified or used in commercial intentions in ant way without my personal permission. I simply do not supply any guarantee that w3de will work properly on your machine. If you use w3de in any way you will be doing it at your own risk. I do not accept any responsiblity for any damage or mayhem that may be done to you or your computer. *********************************************************************************** 2 ENGINE FEATURES - ZBuffering - Textured and flat-colored faces - Onject and point linking possibility to another object - Not a bad performance - 320x200x8 graphics mode support - graphics include file that supports virtual screens, bmp file opening, etc. - Rotating background image support for Doom look-a-like games which have camera that rotates only around y-axis - Ability to be compiled even to 8086/8088 instruction set (though that isn't really a feature ;) - and many more *********************************************************************************** 3 KNOWN BUGS - Engine is lacking a perspective correction in point transformation. This means that users may find some distortion in faces with texture fill and odd holes between faces when faces are in some angles in relation to the camera. *********************************************************************************** 4 RECOMMENTED INSTALLATION Unzip all files from the zip package to a sub folder that is under your programming folder and name that as following: (assuming your programming folder is C:\TC\) w3de_v10_compiled.zip -> Unzip to C:\TC\W3DE\COMPILED\ w3de_v10_source.zip -> Unzip to C:\TC\W3DE\ w3de_v10_docs_fin.zip -> Unzip to C:\TC\W3DE\DOCS\ (Finnish users only) *********************************************************************************** 5 USING THE ENGINE Unfortunately for international users, only the source code of the engine is commented in English and all other documentation (except this file) is in Finnish. Finnish users may download the w3de_v10_docs_fin.zip package that includes a wide variety of documentation related to the w3de. Fast introduction on how to get started: See example programs game.cpp and demo.cpp I think they'll answer to many questions. include the w3de to your main program (.cpp) with the following line: #include "w3de.h" After this you may use the following commands: add_face Adds face add_obj Adds object add_pnt Adds point clear_vscr Fills virtualscreen with one color clear_zbuf Resets zbuffer copy_vscr Copies vscreen inside another in desired location draw_vbox Draws filled or outlined box to vscreen draw_vline Draws a line to vscreen error Draws an error message, calls text mode & terminates run fade_screen Fades screen's palette to black flip_vscr Copies vscreen to another same sized free_zbuf Frees zbuffer init_zbuf Inits zbuffer load_bitmap Loads bmp file to vscreen luminate_screen used after fade_screen to gain palette values back move_backward Moves object backward move_forward Moves object forward new_vscr Creates new vscreen put_vpixel Draws one pixel to cscreen remove_everything3d Removes all faces, points and objects remove_face Removes face remove_obj Removes object remove_pnt Removes point remove_vscr Removes virtualscreen render_cam renders camera to vscreen rgb Changes 24-bit rgb color value to corresponding 8-bit palette index rotate_obj Changes object's angle (additive) set_cam Sets camera settings *********************************************************************************** 8 SYSTEM REQUIREMENTS - C++ compiler. Even Borland's Turbo C++ v1.01 is enough - I've compiled the engine only to DOS, but it should also work in Windows and Linux platforms with minor changes. No guarantees, though. - Free mem atleast 32k, though 1M is highly recommented. - Prosessor performance 200MHz or higher, since no low-level optimatization has been done. *********************************************************************************** 7 FILE LISTING Here are all the files that are included to the w3de v1.0 release: w3de_v10_compiled.zip readme.txt (this file) demo.exe game.exe bg-320.bmp game_ovr.bmp game_pas.bmp game_rdy.bmp hlt_lev0.bmp hlt_lev1.bmp logo0a.bmp menu0b.bmp menu1a.bmp menu1b.bmp menu2a.bmp menu2b.bmp version.bmp wpn_lev0.bmp wpn_lev1.bmp w3de_v10_source.zip readme.txt (this file) cam.h graphics.h matrix.h moving.h objects.h testobjs.h w3de.h zbuf.h demo.cpp game.cpp w3de_v10_docs_fin.zip readme.txt (this file) w3de v1.0 kaskyt.doc w3de v1.0 tiedostorakenne.doc w3de v1.0 raportti.doc w3de v1.0 testaus.doc ***********************************************************************************