libsamplerate/doc/win32.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
   2 <HTML>
   3
   4 <HEAD>
   5         <TITLE>
   6         Secret Rabbit Code (aka libsamplerate)
   7         </TITLE>
   8         <META NAME="Author"      CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">
   9     <META NAME="Version"     CONTENT="libsamplerate-0.1.8">
  10         <META NAME="Description" CONTENT="The Secret Rabbit Code Home Page">
  11         <META NAME="Keywords"    CONTENT="libsamplerate sound resample audio dsp Linux">
  12         <LINK REL=StyleSheet HREF="SRC.css" TYPE="text/css" MEDIA="all">
  13 </HEAD>
  14
  15 <BODY TEXT="#FFFFFF" BGCOLOR="#000000" LINK="#FB1465" VLINK="#FB1465" ALINK="#FB1465">
  16 <!-- pepper -->
  17 <CENTER>
  18         <IMG SRC="SRC.png" HEIGHT=100 WIDTH=760 ALT="SRC.png">
  19 </CENTER>
  20 <!-- pepper -->
  21 <BR>
  22 <!-- pepper -->
  23 <TABLE ALIGN="center" WIDTH="98%">
  24 <TR>
  25 <TD VALIGN="top">
  26 <BR>
  27 <DIV CLASS="nav">
  28         <BR>
  29         <A HREF="index.html">Home</A><BR>
  30         <A HREF="license.html">License</A><BR>
  31         <A HREF="history.html">History</A><BR>
  32         <A HREF="download.html">Download</A><BR>
  33         <A HREF="quality.html">Quality</A><BR>
  34         <A HREF="api.html">API</A><BR>
  35         <A HREF="bugs.html">Bug Reporting</A><BR>
  36         <A HREF="win32.html">On Win32</A><BR>
  37         <A HREF="faq.html">FAQ</A><BR>
  38         <A HREF="lists.html">Mailing Lists</A><BR>
  39         <A HREF="ChangeLog">ChangeLog</A><BR>
  40 <BR>
  41 <DIV CLASS="block">
  42 Author :<BR>Erik de Castro Lopo
  43 <!-- pepper -->
  44 <BR><BR>
  45 <!-- pepper -->
  46
  47 </DIV>
  48         <IMG SRC=
  49         "/cgi-bin/Count.cgi?ft=6|frgb=55;55;55|tr=0|md=6|dd=B|st=1|sh=1|df=src_win32.dat"
  50         HEIGHT=30 WIDTH=100 ALT="counter.gif">
  51 </DIV>
  52
  53 </TD>
  54 <!-- pepper -->
  55 <!-- ######################################################################## -->
  56 <!-- pepper -->
  57 <TD VALIGN="top">
  58 <DIV CLASS="block">
  59
  60 <H1><B>Compiling on Win32.</B></H1>
  61 <P>
  62 For Win32 there is a Microsoft Visual C++ compatible makefile in the <B>Win32\</B>
  63 directory and a MSDOS batch file in the top level directory of the distribution.
  64 </P>
  65 <P>
  66 To build the examples programs you will need to download the precompiled
  67 win32 or win64
  68         <A HREF="http://www.mega-nerd.com/libsndfile/#Download">libsndfile</A>
  69 binary and install them.
  70
  71 </P>
  72 <P>
  73 Making the libsamplerate DLL on Win32 involves the following:
  74 </P>
  75 <OL>
  76         <LI> Using WinZip in the GUI, open the libsamplerate-0.X.Y.tar.gz file and
  77                         extract the files into a directory. The following example assumes
  78                 <B>C:\</B>.
  79         <LI> In the directory containing the extracted files, find the file
  80                 <B>Win32\Makefile.msvc</B> and open it in a text editor (ie Notepad or
  81                         similar).
  82         <LI> Find the line which starts with <B>MSVCDir</B> and modify the directory
  83                     path to point to the location of MSVC++ on your machine. This allows the
  84                         makefile to inform the compiler of the location of the standard header
  85                         files.
  86     <LI> Copy <B>libsndfile-1.dll</B>, <B>libsndfile-1.lib</B> and
  87                         <B>libsndfile-1.def</B> from the directory libsndfile was installed in
  88                         to the the directory containing libsamplerate.
  89     <LI> Copy the header file <B>include/sndfile.h</B> from where libsndfile was
  90                         installed to the <B>Win32</B> directory under the libsamplerate
  91                         directory.
  92         <LI> Open a Command Shell and cd into the libsamplerate-0.X.Y directory.
  93         <LI> Make sure that the program <B>nmake</B> (which is part of the MSCV++
  94                         package) is in a directory which is part of your <B>PATH</B> variable.
  95         <LI> Type in the command
  96                 <PRE>    C:\libsamplerate-0.X.Y> make
  97                 </PRE>
  98                         and press &lt;return&gt;. You should now see a a large number of compile
  99                         commands as libsamplerate.dll is built.
 100         <LI> To check that the built DLL has been compiled correctly type in and run the
 101                         command
 102                 <PRE>    C:\libsamplerate-0.X.Y> make check
 103                 </PRE>
 104                         which will compile a set of test programs and run them.
 105                         If any of the programs fail the error message will be help in debugging
 106                         the problem.
 107                         (Note that some of the tests require libsndfile or libfftw/librfftw and
 108                         are not able to run on Win32).
 109 </OL>
 110 <P>
 111 At the end of the above procedure, you will find the DLL, <B>libsamplerate.dll</B>, a
 112 LIB file <B>libsamplerate.lib</B> in the current directory. These two files, along
 113 with the header file <B>samplerate.h</B> (in the <B>src\</B> directory) are all that
 114 you need to copy to your project in order to use libsamplerate.
 115 </P>
 116
 117 <H2><BR>Compile Problems</H2>
 118 <P>
 119 If you run into compile problems using the above procedure, you should
 120         <A HREF="lists.html"> join the main mailing list </A>
 121 and post your problem and/or questions there.
 122 Please include any error messages generated during step 6 above.
 123 </P>
 124
 125 <P>
 126 If you are using some other method to compile the libsamplerate DLL you are
 127 probably on your own.
 128 </P>
 129 <BR>
 130
 131 <!--
 132
 133 From here:
 134
 135         http://www.gimp.org/~tml/gimp/win32/downloads.html
 136
 137 Download these files:
 138
 139         gettext-runtime-0.13.1.zip
 140         glib-2.4.5-20040903.zip
 141         libiconv-1.9.1.bin.woe32.zip
 142         pkgconfig-0.15.zip
 143
 144 and install them.
 145
 146 -->
 147
 148 <!-- <A HREF="mailto:aldel@mega-nerd.com">For the spam bots</A> -->
 149
 150 </DIV>
 151 </TD></TR>
 152 </TABLE>
 153
 154 </BODY>
 155 </HTML>
 156