shithub: sox

Download patch

ref: ee63cc75d5c6b0328f3c33a05f16fcc211eb6879
parent: 6526c600672ef016d718cbc4f34e482f060dafa4
author: Chris Bagwell <chris@cnpbagwell.com>
date: Tue Nov 22 09:56:49 EST 2011

Update .dat format description

Added notes about header format and gave an example.

--- a/ChangeLog
+++ b/ChangeLog
@@ -51,6 +51,7 @@
   o Fixed man page description for unsigned samples and change
     CVS to git references. (Ulrich Klauer)
   o When using pipes (-p) on Windows, set file mode to binary. (cbagwell)
+  o Updated .dat format description in soxformat. (Jan Stary)
 
 Other bug fixes:
 
--- a/soxformat.7
+++ b/soxformat.7
@@ -284,9 +284,12 @@
 Text Data files.
 These files contain a textual representation of the
 sample data.  There is one line at the beginning
-that contains the sample rate.  Subsequent lines
-contain two numeric data items: the time since
-the beginning of the first sample and the sample value.
+that contains the sample rate, and one line that
+contains the number of channels.
+Subsequent lines contain two or more numeric data intems:
+the time since the beginning of the first sample and the sample value
+for each channel.
+.SP
 Values are normalized so that the maximum and minimum
 are 1 and \-1.  This file format can be used to
 create data files for external programs such as
@@ -293,6 +296,15 @@
 FFT analysers or graph routines.  SoX can also convert
 a file in this format back into one of the other file
 formats.
+.SP
+Example containing only 2 stereo samples of silence:
+.SP
+.EX
+    ; Sample Rate 8012
+    ; Channels 2
+                0	0	0
+    0.00012481278	0	0
+.EE
 .TP
 \&\fB.dvms\fR, \fB.vms\fR
 Used in Germany to compress speech audio for voice mail.