c73e86a3b5f5f75e234c54483960dc4844505aa2
[Faustine.git] / interpretor / lib / src / libsndfile-1.0.25 / doc / embedded_files.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3
4 <HEAD>
5 <TITLE>
6 libsndfile : Embedded Sound Files.
7 </TITLE>
8 <META NAME="Author" CONTENT="Erik de Castro Lopo (erikd AT mega-nerd DOT com)">
9 <META NAME="Description" CONTENT="The libsndfile API.">
10 <META NAME="Keywords" CONTENT="WAV AIFF AU libsndfile sound audio dsp Linux">
11 <LINK REL="stylesheet" HREF="libsndfile.css" TYPE="text/css" MEDIA="all">
12 <LINK REL="stylesheet" HREF="print.css" TYPE="text/css" MEDIA="print">
13 </HEAD>
14 <!-- pepper -->
15 <BODY>
16 <!-- pepper -->
17 <H1><B>Embedded Sound Files.</B></H1>
18
19 <P>
20 By using the open SNDFILE with a file descriptor function:
21 </P>
22 <!-- pepper -->
23 <PRE>
24 SNDFILE* sf_open_fd (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;
25 </PRE>
26 <!-- pepper -->
27 <P>
28 it is possible to open sound files embedded within larger files.
29 There are however a couple of caveats:
30 <P>
31 <!-- pepper -->
32 <UL>
33 <LI> Read/Write mode (SFM_RDWR) is not supported.
34 <LI> Writing of embedded files is only supported at the end of the file.
35 <LI> Reading of embedded files is only supported at file offsets greater
36 than zero.
37 <LI> Not all file formats are supported (currently only WAV, AIFF and AU).
38 </UL>
39 <!-- pepper -->
40 <P>
41 The test program <B>multi_file_test.c</B> in the <B>tests/</B> directory of the
42 source code tarball shows how this functionality is used to read and write
43 embedded files.
44 </P>
45 <!-- pepper -->
46 </BODY>
47 </HTML>