annotate src/libsndfile-1.0.27/doc/embedded_files.html @ 40:1df64224f5ac

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