[audio-libsamplerate.git] / libsamplerate / doc / win32.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>

<HEAD>
	<TITLE>
	Secret Rabbit Code (aka libsamplerate)
	</TITLE>
	<META NAME="Author"      CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">
    <META NAME="Version"     CONTENT="libsamplerate-0.1.8">
	<META NAME="Description" CONTENT="The Secret Rabbit Code Home Page">
	<META NAME="Keywords"    CONTENT="libsamplerate sound resample audio dsp Linux">
	<LINK REL=StyleSheet HREF="SRC.css" TYPE="text/css" MEDIA="all">
</HEAD>

<BODY TEXT="#FFFFFF" BGCOLOR="#000000" LINK="#FB1465" VLINK="#FB1465" ALINK="#FB1465">
<!-- pepper -->
<CENTER>
	<IMG SRC="SRC.png" HEIGHT=100 WIDTH=760 ALT="SRC.png">
</CENTER>
<!-- pepper -->
<BR>
<!-- pepper -->
<TABLE ALIGN="center" WIDTH="98%">
<TR>
<TD VALIGN="top">
<BR>
<DIV CLASS="nav">
	<BR>
	<A HREF="index.html">Home</A><BR>
	<A HREF="license.html">License</A><BR>
	<A HREF="history.html">History</A><BR>
	<A HREF="download.html">Download</A><BR>
	<A HREF="quality.html">Quality</A><BR>
	<A HREF="api.html">API</A><BR>
	<A HREF="bugs.html">Bug Reporting</A><BR>
	<A HREF="win32.html">On Win32</A><BR>
	<A HREF="faq.html">FAQ</A><BR>
	<A HREF="lists.html">Mailing Lists</A><BR>
	<A HREF="ChangeLog">ChangeLog</A><BR>
<BR>
<DIV CLASS="block">
Author :<BR>Erik de Castro Lopo
<!-- pepper -->
<BR><BR>
<!-- pepper -->

</DIV>
	<IMG SRC=
	"/cgi-bin/Count.cgi?ft=6|frgb=55;55;55|tr=0|md=6|dd=B|st=1|sh=1|df=src_win32.dat"
	HEIGHT=30 WIDTH=100 ALT="counter.gif">
</DIV>

</TD>
<!-- pepper -->
<!-- ######################################################################## -->
<!-- pepper -->
<TD VALIGN="top">
<DIV CLASS="block">

<H1><B>Compiling on Win32.</B></H1>
<P>
For Win32 there is a Microsoft Visual C++ compatible makefile in the <B>Win32\</B>
directory and a MSDOS batch file in the top level directory of the distribution. 
</P>
<P>
To build the examples programs you will need to download the precompiled
win32 or win64
	<A HREF="http://www.mega-nerd.com/libsndfile/#Download">libsndfile</A>
binary and install them.

</P>
<P>
Making the libsamplerate DLL on Win32 involves the following:
</P>
<OL>
	<LI> Using WinZip in the GUI, open the libsamplerate-0.X.Y.tar.gz file and 
			extract the files into a directory. The following example assumes 
		<B>C:\</B>.
	<LI> In the directory containing the extracted files, find the file 
	    	<B>Win32\Makefile.msvc</B> and open it in a text editor (ie Notepad or 
			similar). 
	<LI> Find the line which starts with <B>MSVCDir</B> and modify the directory
		    path to point to the location of MSVC++ on your machine. This allows the
			makefile to inform the compiler of the location of the standard header
			files.
    <LI> Copy <B>libsndfile-1.dll</B>, <B>libsndfile-1.lib</B> and
			<B>libsndfile-1.def</B> from the directory libsndfile was installed in
			to the the directory containing libsamplerate.
    <LI> Copy the header file <B>include/sndfile.h</B> from where libsndfile was
			installed to the <B>Win32</B> directory under the libsamplerate
			directory.
	<LI> Open a Command Shell and cd into the libsamplerate-0.X.Y directory.
	<LI> Make sure that the program <B>nmake</B> (which is part of the MSCV++ 
			package) is in a directory which is part of your <B>PATH</B> variable.
	<LI> Type in the command 
		<PRE>    C:\libsamplerate-0.X.Y> make
		</PRE>
			and press &lt;return&gt;. You should now see a a large number of compile
			commands as libsamplerate.dll is built. 
	<LI> To check that the built DLL has been compiled correctly type in and run the
			command
		<PRE>    C:\libsamplerate-0.X.Y> make check
		</PRE>
			which will compile a set of test programs and run them. 
			If any of the programs fail the error message will be help in debugging 
			the problem.
			(Note that some of the tests require libsndfile or libfftw/librfftw and
			are not able to run on Win32).
</OL>
<P>
At the end of the above procedure, you will find the DLL, <B>libsamplerate.dll</B>, a
LIB file <B>libsamplerate.lib</B> in the current directory. These two files, along
with the header file <B>samplerate.h</B> (in the <B>src\</B> directory) are all that 
you need to copy to your project in order to use libsamplerate.
</P>

<H2><BR>Compile Problems</H2>
<P>
If you run into compile problems using the above procedure, you should 
	<A HREF="lists.html"> join the main mailing list </A>
and post your problem and/or questions there. 
Please include any error messages generated during step 6 above.
</P>

<P>
If you are using some other method to compile the libsamplerate DLL you are 
probably on your own.
</P>
<BR>

<!--

From here:

	http://www.gimp.org/~tml/gimp/win32/downloads.html

Download these files:

	gettext-runtime-0.13.1.zip
	glib-2.4.5-20040903.zip
	libiconv-1.9.1.bin.woe32.zip
	pkgconfig-0.15.zip

and install them.

-->

<!-- <A HREF="mailto:aldel@mega-nerd.com">For the spam bots</A> -->

</DIV>
</TD></TR>
</TABLE>

</BODY>
</HTML>
Commit	Line	Data
	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 <return>. 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