From 64b729f3284ead6a71fbeb7f8e0dd22187b21786 Mon Sep 17 00:00:00 2001 From: "Matthias P. Braendli" Date: Fri, 8 Jul 2016 11:50:26 +0200 Subject: Add doxygen configuration and target --- src/FileInput.h | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) (limited to 'src/FileInput.h') diff --git a/src/FileInput.h b/src/FileInput.h index 57cc5a0..937cbd4 100644 --- a/src/FileInput.h +++ b/src/FileInput.h @@ -1,5 +1,5 @@ /* ------------------------------------------------------------------ - * Copyright (C) 2014 Matthias P. Braendli + * Copyright (C) 2016 Matthias P. Braendli * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -15,6 +15,16 @@ * and limitations under the License. * ------------------------------------------------------------------- */ +/*! \section File Input + * + * This input reads a wav or raw file. + * + * The raw input needs to be signed 16-bit per sample data, with + * the number of channels corresponding to the command line. + * + * The wav input must also correspond to the parameters on the command + * line (number of channels, rate) + */ #ifndef _FILE_INPUT_H_ #define _FILE_INPUT_H_ @@ -35,15 +45,15 @@ class FileInput ~FileInput(); - /* Open the file and prepare the wav decoder. + /*! Open the file and prepare the wav decoder. * - * Returns nonzero on error + * \return nonzero on error */ int prepare(void); - /* Read length bytes into buf. + /*! Read length bytes into buf. * - * Returns the number of bytes read. + * \return the number of bytes read. */ ssize_t read(uint8_t* buf, size_t length); int eof(); -- cgit v1.2.3