[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
8529da43 MG	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