annotate scripts/audio/wavwrite.m @ 5642:2618a0750ae6

[project @ 2006-03-06 21:26:48 by jwe]
author jwe
date Mon, 06 Mar 2006 21:26:54 +0000
parents c45cf76df06f
children 34f96dd5441b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
1 ## Copyright (C) 2005 Michael Zeising
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
2 ##
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
3 ## This file is part of Octave.
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
4 ##
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
6 ## under the terms of the GNU General Public License as published by
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
7 ## the Free Software Foundation; either version 2, or (at your option)
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
8 ## any later version.
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
9 ##
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
13 ## General Public License for more details.
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
14 ##
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
15 ## You should have received a copy of the GNU General Public License
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
16 ## along with Octave; see the file COPYING. If not, write to the Free
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
17 ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
18 ## 02110-1301, USA.
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
19
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
20 ## -*- texinfo -*-
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
21 ## @deftypefn {Function File} {} wavwrite(@var{filename}, @var{y})
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
22 ## Write @var{y} to the canonical RIFF/WAVE sound file @var{filename}. A sample
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
23 ## rate of 8000 Hz and 16-bit samples are assumed. Each column of the data
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
24 ## represents a separate channel.
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
25 ##
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
26 ## @deftypefnx {Function File} {} wavwrite(@var{filename}, @var{y}, @var{fs})
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
27 ## Set the sample rate to @var{fs} Hz.
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
28 ##
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
29 ## @deftypefnx {Function File} {} wavwrite(@var{filename}, @var{y}, @var{fs}, @var{bits})
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
30 ## Set the sample rate to @var{fs} Hz and resolution to @var{bits} bits.
5642
2618a0750ae6 [project @ 2006-03-06 21:26:48 by jwe]
jwe
parents: 5572
diff changeset
31 ## @seealso{wavread}
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
32 ## @end deftypefn
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
33
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
34 ## Author: Michael Zeising <michael.zeising@stud.uni-erlangen.de>
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
35 ## Created: 06 December 2005
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
36
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
37 function wavwrite (filename, y, samples_per_sec, bits_per_sample)
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
38
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
39 BYTEORDER = "ieee-le";
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
40
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
41 if (nargin < 2 || nargin > 4)
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
42 usage ("wavwrite (filename, y, samples_per_sec, bits_per_sample)");
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
43 endif
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
44
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
45 ## parse arguments
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
46 if (nargin < 3)
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
47 warning ("wavwrite: sample rate set to 8000 Hz");
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
48 samples_per_sec = 8000;
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
49 endif
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
50
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
51 if (nargin < 4)
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
52 warning ("wavwrite: sample resolution set to 16-bit");
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
53 bits_per_sample = 16;
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
54 endif
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
55
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
56 ## determine sample format
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
57 switch (bits_per_sample)
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
58 case 8
5572
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
59 format = "uint8";
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
60 case 16
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
61 format = "int16";
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
62 case 32
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
63 format = "int32";
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
64 otherwise
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
65 error ("wavread: sample resolution not supported");
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
66 endswitch
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
67
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
68 ## calculate filesize
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
69 channels = size(y)(2);
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
70 n = size(y)(1);
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
71
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
72 ## size of data chunk
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
73 ck_size = n*channels*(bits_per_sample/8);
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
74
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
75 ## open file for writing binary
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
76
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
77 if (! ischar (filename))
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
78 error ("wavwrite: expecting filename to be a character string");
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
79 endif
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
80
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
81 [fid, msg] = fopen (filename, "wb");
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
82 if (fid < 0)
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
83 error ("wavwrite: %s", msg)
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
84 endif
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
85
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
86 ## write RIFF/WAVE header
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
87 c = 0;
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
88 c += fwrite (fid, "RIFF", "uchar");
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
89
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
90 ## file size - 8
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
91 c += fwrite (fid, ck_size + 36, "ulong", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
92 c += fwrite (fid, "WAVEfmt ", "uchar");
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
93
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
94 ## size of fmt chunk
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
95 c += fwrite (fid, 16, "ulong", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
96
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
97 ## sample format code (PCM)
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
98 c += fwrite (fid, 0x0001, "short", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
99
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
100 ## channels
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
101 c += fwrite (fid, channels, "short", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
102
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
103 ## sample rate
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
104 c += fwrite (fid, samples_per_sec, "ulong", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
105
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
106 ## bytes per second
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
107 bps = samples_per_sec*channels*bits_per_sample/8;
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
108 c += fwrite (fid, bps, "ulong", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
109
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
110 ## block align
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
111 c += fwrite (fid, channels*bits_per_sample/8, "short", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
112
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
113 c += fwrite (fid, bits_per_sample, "short", 0, BYTEORDER);
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
114 c += fwrite (fid, "data", "uchar");
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
115 c += fwrite (fid, ck_size, "ulong", 0, BYTEORDER);
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
116
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
117 if (c < 25)
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
118 fclose (fid);
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
119 error ("wavread: writing to file failed");
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
120 endif
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
121
5572
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
122 ## interleave samples
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
123 yi = reshape (y', n*channels, 1);
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
124
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
125 ## scale samples
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
126 switch (bits_per_sample)
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
127 case 8
5572
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
128 yi = round (yi*127.5 + 127.5);
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
129 case 16
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
130 yi = floor (yi*32767.5);
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
131 case 32
c45cf76df06f [project @ 2005-12-12 20:54:06 by jwe]
jwe
parents: 5567
diff changeset
132 yi = floor (yi*2147483647.5);
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
133 endswitch
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
134
5567
80e629357483 [project @ 2005-12-07 06:31:28 by jwe]
jwe
parents: 5565
diff changeset
135 ## write to file
5565
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
136 c = fwrite (fid, yi, format, 0, BYTEORDER);
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
137
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
138 fclose (fid);
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
139
2eeed655e801 [project @ 2005-12-06 20:38:20 by jwe]
jwe
parents:
diff changeset
140 endfunction