ref: dc724763680110a1df03f7f53cda1d7aa390df79
dir: /src/io/ioutils.h/
/*
Copyright (C) 2016 Paul Brossier <piem@aubio.org>
This file is part of aubio.
aubio 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.
aubio 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 aubio. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef AUBIO_IOUTILS_H
#define AUBIO_IOUTILS_H
/** \file
Simple utility functions to validate input parameters.
*/
#ifdef __cplusplus
extern "C" {
#endif
/** validate samplerate
\param kind the object kind to report on
\param path the object properties to report on
\param samplerate the object properties to report on
\return 0 if ok, non-zero if validation failed
*/
uint_t aubio_io_validate_samplerate(const char_t *kind, const char_t *path,
uint_t samplerate);
/** validate number of channels
\param kind the object kind to report on
\param path the object properties to report on
\param channels the object properties to report on
\return 0 if ok, non-zero if validation failed
*/
uint_t aubio_io_validate_channels(const char_t *kind, const char_t *path,
uint_t channels);
/** validate length of input
\param kind the object kind to report on
\param path the path to report on
\param max_size maximum number of frames that can be written
\param write_data_length actual length of input vector/matrix
\param write number of samples asked
\return write or the maximum number of frames that can be written
*/
uint_t
aubio_sink_validate_input_length(const char_t *kind, const char_t *path,
uint_t max_size, uint_t write_data_length, uint_t write);
/** validate height of input
\param kind the object kind to report on
\param path the path to report on
\param max_size maximum number of channels that can be written
\param write_data_height actual height of input matrix
\return write_data_height or the maximum number of channels
*/
uint_t
aubio_sink_validate_input_channels(const char_t *kind, const char_t *path,
uint_t sink_channels, uint_t write_data_height);
#ifdef __cplusplus
}
#endif
#endif /* AUBIO_IOUTILS_H */