/usr/share/doc/octave/octave.html/Audio-Data-Processing.html is in octave-doc 4.2.2-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Audio Data Processing (GNU Octave)</title>
<meta name="description" content="Audio Data Processing (GNU Octave)">
<meta name="keywords" content="Audio Data Processing (GNU Octave)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Audio-Processing.html#Audio-Processing" rel="up" title="Audio Processing">
<link href="Object-Oriented-Programming.html#Object-Oriented-Programming" rel="next" title="Object Oriented Programming">
<link href="Recorder-Properties.html#Recorder-Properties" rel="prev" title="Recorder Properties">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="octave.css">
</head>
<body lang="en">
<a name="Audio-Data-Processing"></a>
<div class="header">
<p>
Previous: <a href="Audio-Recorder.html#Audio-Recorder" accesskey="p" rel="prev">Audio Recorder</a>, Up: <a href="Audio-Processing.html#Audio-Processing" accesskey="u" rel="up">Audio Processing</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Audio-Data-Processing-1"></a>
<h3 class="section">33.5 Audio Data Processing</h3>
<p>Octave provides a few functions for dealing with audio data. An audio
‘sample’ is a single output value from an A/D converter, i.e., a small
integer number (usually 8 or 16 bits), and audio data is just a series
of such samples. It can be characterized by three parameters: the
sampling rate (measured in samples per second or Hz, e.g., 8000 or
44100), the number of bits per sample (e.g., 8 or 16), and the number of
channels (1 for mono, 2 for stereo, etc.).
</p>
<p>There are many different formats for representing such data. Currently,
only the two most popular, <em>linear encoding</em> and <em>mu-law
encoding</em>, are supported by Octave. There is an excellent FAQ on audio
formats by Guido van Rossum <a href="mailto:guido@cwi.nl">guido@cwi.nl</a> which can be
found at any FAQ ftp site, in particular in the directory
<samp>/pub/usenet/news.answers/audio-fmts</samp> of the archive site
<code>rtfm.mit.edu</code>.
</p>
<p>Octave simply treats audio data as vectors of samples (non-mono data are
not supported yet). It is assumed that audio files using linear
encoding have one of the extensions <samp>lin</samp> or <samp>raw</samp>, and that
files holding data in mu-law encoding end in <samp>au</samp>, <samp>mu</samp>, or
<samp>snd</samp>.
</p>
<a name="XREFlin2mu"></a><dl>
<dt><a name="index-lin2mu"></a>: <em><var>y</var> =</em> <strong>lin2mu</strong> <em>(<var>x</var>, <var>n</var>)</em></dt>
<dd><p>Convert audio data from linear to mu-law.
</p>
<p>Mu-law values use 8-bit unsigned integers. Linear values use <var>n</var>-bit
signed integers or floating point values in the range -1 ≤ <var>x</var>
≤ 1 if <var>n</var> is 0.
</p>
<p>If <var>n</var> is not specified it defaults to 0, 8, or 16 depending on
the range of values in <var>x</var>.
</p>
<p><strong>See also:</strong> <a href="#XREFmu2lin">mu2lin</a>.
</p></dd></dl>
<a name="XREFmu2lin"></a><dl>
<dt><a name="index-mu2lin"></a>: <em><var>y</var> =</em> <strong>mu2lin</strong> <em>(<var>x</var>, <var>n</var>)</em></dt>
<dd><p>Convert audio data from mu-law to linear.
</p>
<p>Mu-law values are 8-bit unsigned integers. Linear values use <var>n</var>-bit
signed integers or floating point values in the range -1 ≤ <var>y</var>
≤ 1 if <var>n</var> is 0.
</p>
<p>If <var>n</var> is not specified it defaults to 0.
</p>
<p><strong>See also:</strong> <a href="#XREFlin2mu">lin2mu</a>.
</p></dd></dl>
<a name="XREFrecord"></a><dl>
<dt><a name="index-record-2"></a>: <em></em> <strong>record</strong> <em>(<var>sec</var>)</em></dt>
<dt><a name="index-record-3"></a>: <em></em> <strong>record</strong> <em>(<var>sec</var>, <var>fs</var>)</em></dt>
<dd><p>Record <var>sec</var> seconds of audio from the system’s default audio input at
a sampling rate of 8000 samples per second.
</p>
<p>If the optional argument <var>fs</var> is given, it specifies the sampling rate
for recording.
</p>
<p>For more control over audio recording, use the <code>audiorecorder</code> class.
</p>
<p><strong>See also:</strong> <a href="#XREFsound">sound</a>, <a href="#XREFsoundsc">soundsc</a>.
</p></dd></dl>
<a name="XREFsound"></a><dl>
<dt><a name="index-sound"></a>: <em></em> <strong>sound</strong> <em>(<var>y</var>)</em></dt>
<dt><a name="index-sound-1"></a>: <em></em> <strong>sound</strong> <em>(<var>y</var>, <var>fs</var>)</em></dt>
<dt><a name="index-sound-2"></a>: <em></em> <strong>sound</strong> <em>(<var>y</var>, <var>fs</var>, <var>nbits</var>)</em></dt>
<dd><p>Play audio data <var>y</var> at sample rate <var>fs</var> to the default audio
device.
</p>
<p>The audio signal <var>y</var> can be a vector or a two-column array, representing
mono or stereo audio, respectively.
</p>
<p>If <var>fs</var> is not given, a default sample rate of 8000 samples per second
is used.
</p>
<p>The optional argument <var>nbits</var> specifies the bit depth to play to the
audio device and defaults to 8 bits.
</p>
<p>For more control over audio playback, use the <code>audioplayer</code> class.
</p>
<p><strong>See also:</strong> <a href="#XREFsoundsc">soundsc</a>, <a href="#XREFrecord">record</a>.
</p></dd></dl>
<a name="XREFsoundsc"></a><dl>
<dt><a name="index-soundsc"></a>: <em></em> <strong>soundsc</strong> <em>(<var>y</var>)</em></dt>
<dt><a name="index-soundsc-1"></a>: <em></em> <strong>soundsc</strong> <em>(<var>y</var>, <var>fs</var>)</em></dt>
<dt><a name="index-soundsc-2"></a>: <em></em> <strong>soundsc</strong> <em>(<var>y</var>, <var>fs</var>, <var>nbits</var>)</em></dt>
<dt><a name="index-soundsc-3"></a>: <em></em> <strong>soundsc</strong> <em>(…, [<var>ymin</var>, <var>ymax</var>])</em></dt>
<dd><p>Scale the audio data <var>y</var> and play it at sample rate <var>fs</var> to the
default audio device.
</p>
<p>The audio signal <var>y</var> can be a vector or a two-column array, representing
mono or stereo audio, respectively.
</p>
<p>If <var>fs</var> is not given, a default sample rate of 8000 samples per second
is used.
</p>
<p>The optional argument <var>nbits</var> specifies the bit depth to play to the
audio device and defaults to 8 bits.
</p>
<p>By default, <var>y</var> is automatically normalized to the range [-1, 1]. If
the range [<var>ymin</var>, <var>ymax</var>] is given, then elements of <var>y</var>
that fall within the range <var>ymin</var> ≤ <var>y</var> ≤ <var>ymax</var>
are scaled to the range [-1, 1] instead.
</p>
<p>For more control over audio playback, use the <code>audioplayer</code> class.
</p>
<p><strong>See also:</strong> <a href="#XREFsound">sound</a>, <a href="#XREFrecord">record</a>.
</p></dd></dl>
<hr>
<div class="header">
<p>
Previous: <a href="Audio-Recorder.html#Audio-Recorder" accesskey="p" rel="prev">Audio Recorder</a>, Up: <a href="Audio-Processing.html#Audio-Processing" accesskey="u" rel="up">Audio Processing</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|