Mercurial > octave-nkf
view libinterp/dldfcn/__recorder_audiorecorder__.cc @ 19538:d7b55fc1b37d
Add missing texinfo docstrings to all audio functions
* libinterp/dldfcn/__player_audioplayer__.cc,
libinterp/dldfcn/__recorder_audiorecorder__.cc,
scripts/audio/@audioplayer/subsasgn.m, scripts/audio/@audioplayer/subsref.m,
scripts/audio/@audiorecorder/__get_properties__.m,
scripts/audio/@audiorecorder/subsasgn.m,
scripts/audio/@audiorecorder/subsref.m: Add texinfo docstrings to all
functions, internal or otherwise.
author | Mike Miller <mtmiller@ieee.org> |
---|---|
date | Thu, 03 Oct 2013 08:33:46 -0400 |
parents | 36a26a131209 |
children |
line wrap: on
line source
/* Copyright (C) 2013 Vytautas JanĨauskas This file is part of Octave. Octave is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. Octave is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Octave; see the file COPYING. If not, see <http://www.gnu.org/licenses/>. */ #ifdef HAVE_CONFIG_H #include <config.h> #endif #include "oct.h" #include "ov-struct.h" #ifdef HAVE_PORTAUDIO #include "player_class.cc" #include "recorder_class.cc" #endif DEFUN_DLD (__recorder_audiorecorder__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{recorder} =} __recorder_audiorecorder__ (@var{fs}, @var{nbits}, @var{channels})\n\ @deftypefnx {Loadable Function} {@var{recorder} =} __recorder_audiorecorder__ (@var{fs}, @var{nbits}, @var{channels}, @var{id})\n\ @deftypefnx {Loadable Function} {@var{recorder} =} __recorder_audiorecorder__ (@var{fcn}, @dots{})\n\ Undocumented internal function.\n\ @end deftypefn") { #ifdef HAVE_PORTAUDIO int nargin = args.length (); audiorecorder* retval = new audiorecorder (); int offset = 0; if (nargin > 0) { bool is_function = args(0).is_string () || args(0).is_function_handle () || args(0).is_inline_function (); if (is_function) { retval->octave_callback_function = args(0).function_value (); offset = 1; } } switch (nargin - offset) { case 3: retval->set_fs (args(0 + offset).int_value ()); retval->set_nbits (args(1 + offset).int_value ()); retval->set_channels (args(2 + offset).int_value ()); break; case 4: retval->set_fs (args(0 + offset).int_value ()); retval->set_nbits (args(1 + offset).int_value ()); retval->set_channels (args(2 + offset).int_value ()); retval->set_id (args(3 + offset).int_value ()); break; } retval->init (); return octave_value (retval); #else octave_value retval; error ("portaudio not found on your system and thus audio functionality is not present"); return retval; #endif } DEFUN_DLD (__recorder_getaudiodata__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{data}} __recorder_getaudiodata__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->getaudiodata ()); #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_channels__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{n} =} __recorder_get_channels__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_channels ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_fs__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{fs} =} __recorder_get_fs__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_fs ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_id__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{id} =} __recorder_get_id__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_id ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_nbits__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{nbits} =} __recorder_get_nbits__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_nbits ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_sample_number__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{n} =} __recorder_get_sample_number__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_sample_number ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_tag__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{tag} =} __recorder_get_tag__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_tag ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_total_samples__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{n} =} __recorder_get_total_samples__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = octave_value (recorder->get_total_samples ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_get_userdata__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {@var{data} =} __recorder_get_userdata__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); retval = recorder->get_userdata (); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_isrecording__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_isrecording__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); if (recorder->isrecording ()) return octave_value (1); else return octave_value (0); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_pause__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_pause__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->pause (); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_recordblocking__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_recordblocking__ (@var{recorder}, @var{seconds})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->recordblocking (args(1).float_value ()); #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_record__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_record__ (@var{recorder})\n\ @deftypefnx {Loadable Function} {} __recorder_record__ (@var{recorder}, @var{seconds})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); if (args.length () == 1) { recorder->record (); } else if (args.length () == 2) { recorder->set_end_sample (args(1).int_value () * recorder->get_fs ()); recorder->record (); } else { error ("audiorecorder: wrong number of arguments passed to record"); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_resume__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_resume__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 1) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->resume (); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_set_fs__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_set_fs__ (@var{recorder}, @var{fs})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 2) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->set_fs (args(1).int_value ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_set_tag__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_set_tag__ (@var{recorder}, @var{tag})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 2) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->set_tag (args(1).char_matrix_value ()); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_set_userdata__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_set_userdata__ (@var{recorder}, @var{data})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO int nargin = args.length (); if (nargin == 2) { const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->set_userdata (args(1)); } #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; } DEFUN_DLD (__recorder_stop__, args, , "-*- texinfo -*-\n\ @deftypefn {Loadable Function} {} __recorder_stop__ (@var{recorder})\n\ Undocumented internal function.\n\ @end deftypefn") { octave_value retval; #ifdef HAVE_PORTAUDIO const octave_base_value& rep = args(0).get_rep (); audiorecorder *recorder = &((audiorecorder &)rep); recorder->stop (); #else error ("portaudio not found on your system and thus audio functionality is not present"); #endif return retval; }