annotate src/libsndfile-1.0.25/doc/embedded_files.html @ 169:223a55898ab9 tip default

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