home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 September / 09_02.iso / software / zinf_hit / files / zinf-2.2.0a.exe / %MAINDIR% / README.win32 < prev    next >
Encoding:
Text File  |  2002-07-15  |  3.6 KB  |  84 lines
  1.          How to compile the FreeAmp MSVC Projects on Windows 32
  2.                   by Chad Loder <cloder@ccs.neu.edu>
  3.        $Id: README.win32,v 1.1 2002/06/20 06:38:49 mayhemchaos Exp $
  4.  
  5.  
  6. 1) Download and install a source distribution.
  7.  
  8. 2) Download and install NASM (http://www.web-sites.co.uk/nasm/).
  9.  
  10. 3) Download and install the Win32 port of the SGI stl from:
  11.    http://www.freeamp.org/~robert/stl.html
  12.  
  13.    (This page is a mirror of the original page, which no longer exists)
  14.  
  15. 4) Run Developer Studio and open the FreeAmp workspace located at:
  16.    freeamp\base\win32\prj\freeamp.dsw
  17.  
  18. 5) Put NASM in your path. Choose "Tools | Options" in DevStudio and
  19.    go to the "Directories" tab.  Choose "Show Directories For" and
  20.    select "Executable Files". Then add the directory where you have
  21.    NASM.
  22.  
  23. 6) The workspace is set up so that DevStudio automatically calculates
  24.    dependencies between projects. This means that building the top
  25.    level project (called simply "freeamp") will automatically build
  26.    all the other projects you need to run the product. Set freeamp
  27.    as your active project.
  28.  
  29. 7) Build the freeamp project, and then run freeamp.exe. If you
  30.    installed a shipping version of FreeAmp somewhere else, the first
  31.    time you run the development version of FreeAmp, it will ask
  32.    you whether you want to associate .MP3 files with the development
  33.    version. It's up to you, I find it's nice to associate them with
  34.    the development version.
  35.  
  36. 8) If you get some errors compiling the dsoundcardpmo.cpp file, you likely
  37.    have an old version (or rather, the stock DirectX headers that ship
  38.    with MSVC 5.0) of DirectX installed. You can either update the DirectX
  39.    SDK (which is a *very* large download) or you can grab the needed 
  40.    dsound.h file from here: http://www.freeamp.org/misc/dsound.h
  41.  
  42.  
  43. OTHER NOTES
  44. ###########
  45.  
  46. Setting Breakpoints
  47. -------------------
  48.  
  49. You may have trouble setting breakpoints when freeamp is not
  50. currently being debugged. This is because you cannot set breakpoints
  51. in DLLs for which DevStudio hasn't loaded the debug symbols. This is
  52. common when you want to debug something that happens early in FreeAmp's
  53. startup.
  54.  
  55. Once FreeAmp is completely up and running, all of the DLLs and debug
  56. symbols are loaded and you can set breakpoints anywhere, but before that
  57. time, not all the DLLs have loaded and you can't set breakpoints in some
  58. files. You can fix this situation by telling DevStudio about the
  59. DLLs you want to debug. Go to the "Project | Settings"
  60. dialog for the "freeamp" project and choose the "Debug" tab.
  61. Select "Additional DLLs" in the "Category" list and then enter
  62. each DLL that you want to debug. Note that FreeAmp DLL files
  63. do not end in .DLL -- they have funky names like something.ppp
  64. and something.ppo. Most of them live in the freeamp\plugins
  65. directory, and it wouldn't hurt to add them ALL to the "Additional
  66. DLLs" category -- this will cause DevStudio to load the debug
  67. symbols ahead of time, and you can set breakpoints before you
  68. start debugging.
  69.  
  70.  
  71. Building From the Command Line
  72. ------------------------------
  73.  
  74. You can automate the build (for those of you who don't like using
  75. the DevStudio GUI) by exporting all the makefiles (select
  76. "Project | Export Makefile" and then running Microsoft's NMAKE.EXE
  77. on the freeamp makefile. You may need to twiddle a little bit
  78. to get it to work, but it's not difficult.
  79.  
  80. If you are using DevStudio 6, or greater, you can also build from
  81. the command line by using a command line similar to this one:
  82.  
  83.   MSDEV  drive:path\freeamp\base\win32\proj\freeamp.dsw /make all /out:Build-Log.txt
  84.