home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / graphics / directx / readme.txt < prev   
Text File  |  1997-09-19  |  4KB  |  101 lines
  1. DirectX 5 Release Notes for the Platform SDK
  2. ----------------------------------------------
  3.  
  4. Setting up your DirectX build environment
  5. -----------------------------------------
  6. To setup your DirectX build environment, edit the 
  7. <sdkdir>\samples\graphics\directx\dxsetenv.bat
  8. file to point to the location of your compiler, assembler, and the location
  9. of the Platform SDK. Run the dxsetenv.bat batch file.
  10.  
  11. Windows 95-specific libs (VC and Watcom) are installed to <sdkdir>\lib. 
  12. Windows 95-specific libs (Borland) are installed to <sdkdir>\lib\borland. 
  13.  
  14. If you have problems building the samples when running under a DOS Command 
  15. box, try using a NT DOS CMD box instead. Start\Run, Type "CMD", hit enter".    
  16.  
  17. If you encounter problems building samples using the default build 
  18. environment, you may need to edit the DXSETENV.BAT file to use WINDEF.H 
  19. released with Microsoft Visual C++ version 5.0.
  20.  
  21. SDK Samples
  22. -----------
  23.  
  24. To ensure compatability with all editors, all tabs in sample source code files
  25. have been replaced with spaces.
  26.  
  27. All SDK samples are designed to be built in the directory they are in.  
  28. Once your Win32 development environment is set up, you 
  29. can go to any sample directory and do a make.
  30.  
  31. There is a main make file in each sample directory:
  32. MAKEFILE        - for use with Microsoft VC++ 2.0 or higher (NMAKE)
  33.  
  34. There are 2 ways to build each sample, debug or retail.   To build a
  35. sample as retail with VC++, just type:
  36.  
  37. nmake nodebug=1
  38.  
  39. To build a sample as debug with VC++, just type:
  40.  
  41. nmake
  42.  
  43. There is also a master make file in the SAMPLES directory that will compile
  44. all the samples at once:
  45. MAKEFILE        - for use with Microsoft VC++ 2.0 or higher (NMAKE)
  46.  
  47.  
  48. Creating a setup program for your game
  49. ---------------------------------------
  50. We have included the source code to a sample setup program for a game
  51. which uses the DirectX runtimes. The source for this program is located in 
  52. <sdkdir>\samples\Graphics\DirectX\setup. Note that to build 
  53. your own custom setup program, all you need to do is edit the copy_list 
  54. at the start of DINSTALL.C to be your list of files, search for 
  55. "fox", and then for "bear", and change things appropriately.
  56.  
  57. Next, create a game directory that includes your files and the setup program 
  58. you have built. Xcopy /s the <sdkdir>\redist\DirectX5\win95\directx directory to the 
  59. root of your game directory, i.e.:
  60.  
  61. XCOPY /S c:\mssdk\redist\DirectX5\win95\directx\*.* D:\FUNGAME
  62.  
  63. If you are building an autorun CD title, you can copy the AUTORUN.INF at 
  64. <sdkdir>\samples\Graphics\DirectX\setup to the root of your game directory. 
  65. If your installation program is called SETUP.EXE, you will not have to make 
  66. any changes to this file. If it is called something else, then you can edit 
  67. AUTORUN.INF appropriately.
  68.  
  69.  
  70. Notes for users of Visual C++ 4.2
  71. ---------------------------------
  72. Visual C++ 4.2 includes the DX2 header files and libraries.  If you are
  73. getting errors compiling the samples, make sure that the DX5 include
  74. and lib paths come before the MSVC++ 4.2 include and libs.
  75.  
  76.  
  77. Notes for users of Watcom C/C++
  78. -------------------------------
  79. Watcom C/C++ v10.6 is required to compile the DXSDK samples.
  80. v10.0 is not sufficient. The Microsoft Windows Platform SDK is also required
  81. and is expected to be in \MSTOOLS on the same drive as your DXSDK
  82. sample files. If the Platform SDK is elsewhere, you can set the MSTOOLS
  83. environment variable to point to its root directory (e.g. set
  84. MSTOOLS=\MSTOOLS).
  85.  
  86. Change lines 408-410 of SAMPLES\WIN32.MAK from:
  87.         libc = libc.lib oldnames.lib
  88.         libcmt = libcmt.lib oldnames.lib
  89.         libcdll = msvcrt.lib oldnames.lib
  90. to:
  91.         libc =
  92.         libcmt =
  93.         libcdll =
  94.  
  95. The Watcom makefiles expect the WATCOM environment variable
  96. to be set, as it should have been by the Watcom installation procedure.
  97.  
  98. Only a subset of the samples have Watcom makefiles.
  99.  
  100. Watcom and Watcom C/C++ are trademarks of Powersoft, Watcom Division.
  101.