comparison doc/interpreter/audio.txi @ 19528:3954d835436b

doc: included all docstrings for the @audioplayer class in audio.txi as well as added additional explanations for the functionality
author Vytautas Jančauskas <unaudio@gmail.com>
date Fri, 20 Sep 2013 00:34:30 +0300
parents e36c9a2b2919
children da6173d4e384
comparison
equal deleted inserted replaced
19527:e36c9a2b2919 19528:3954d835436b
26 @DOCSTRING(audioread) 26 @DOCSTRING(audioread)
27 @DOCSTRING(audiowrite) 27 @DOCSTRING(audiowrite)
28 28
29 @chapter Audio Device Information 29 @chapter Audio Device Information
30 30
31 @DOCSTRING(@audiodevinfo) 31 @DOCSTRING(audiodevinfo)
32 32
33 @chapter Audio Player 33 @chapter Audio Player
34 34
35 The following methods are used to create and use audioplayer objects. These objects can be used to play back audio data stored in Octave matrices and arrays. The audioplayer object supports playback from various devices available to the system, blocking and non-blocking playback, convenient pausing and resuming and much more.
36
35 @DOCSTRING(@audioplayer/audioplayer) 37 @DOCSTRING(@audioplayer/audioplayer)
38
39 @section Playback
40
41 The following methods are used to control player playback.
42
43 @DOCSTRING(@audioplayer/play)
44 @DOCSTRING(@audioplayer/playblocking)
45 @DOCSTRING(@audioplayer/pause)
46 @DOCSTRING(@audioplayer/resume)
47 @DOCSTRING(@audioplayer/stop)
48 @DOCSTRING(@audioplayer/isplaying)
49
50 @section Properties
51
52 The remaining couple of methods are used to get and set various properties of the audioplayer object.
53
54 @DOCSTRING(@audioplayer/get)
55 @DOCSTRING(@audioplayer/set)
36 56
37 @chapter Audio Recorder 57 @chapter Audio Recorder
38 58
59 The following methods are used to create and use audiorecorder objects. These objects can be used to record audio data from various devices available to the system. You can use convenient methods to retrieve that data or audioplayer objects created from that data. Methods for blocking and non-blocking recording, pausing and resuming recording and much more is available.
60
39 @DOCSTRING(@audiorecorder/audiorecorder) 61 @DOCSTRING(@audiorecorder/audiorecorder)
62
63 @section Recording
64
65 The following methods control the recording process.
66
67 @DOCSTRING(@audiorecorder/record)
68 @DOCSTRING(@audiorecorder/recordblocking)
69 @DOCSTRING(@audiorecorder/pause)
70 @DOCSTRING(@audiorecorder/resume)
71 @DOCSTRING(@audiorecorder/stop)
72 @DOCSTRING(@audiorecorder/isrecording)
73
74 @section Data Retrieval
75
76 The following methods allow you to retrieve recorded audio data in various ways.
77
78 @DOCSTRING(@audiorecorder/getaudiodata)
79 @DOCSTRING(@audiorecorder/getplayer)
80 @DOCSTRING(@audiorecorder/play)
81
82 @section Properties
83
84 The remaining two methods allow you to read or alter the properties of audiorecorder objects.
85
86 @DOCSTRING(@audiorecorder/get)
87 @DOCSTRING(@audiorecorder/set)
40 88
41 @chapter Audio Processing 89 @chapter Audio Processing
42 90
43 Octave provides a few functions for dealing with audio data. An audio 91 Octave provides a few functions for dealing with audio data. An audio
44 `sample' is a single output value from an A/D converter, i.e., a small 92 `sample' is a single output value from an A/D converter, i.e., a small