annotate trunk/src/Modules/Input/ModuleFileInput.h @ 318:30dde71d0230

- Modified licence from GPL 3 to Apache v2

// Copyright 2006-2010, Willem van Engen, Thomas Walters
//
// AIM-C: A C++ implementation of the Auditory Image Model
// http://www.acousticscale.org/AIMC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/*! \file
 *  \brief Audio file input
 *
 *  \author Willem van Engen <[e-mail]>
 *  \author Thomas Walters <[e-mail]>
 *  \date created 2006/09/21
 *  \version \$Id$
 */

#ifndef AIMC_MODULES_INPUT_FILEINPUT_H_
#define AIMC_MODULES_INPUT_FILEINPUT_H_

#include <sndfile.h>

#include "Support/Module.h"
#include "Support/Parameters.h"
#include "Support/SignalBank.h"

namespace aimc {
class ModuleFileInput : public Module {
 public:
  explicit ModuleFileInput(Parameters *pParam);
  virtual ~ModuleFileInput();

  /*! \brief Initializes this input device using an audio file
   *  \param sFilename Path of the file to load
   *  \return true on success, false on error
   */
  bool LoadFile(const char *sFilename);

  /*! \brief Process the loaded file.
   */
  void Process();

  /*! \brief Dummy Initialize function. Call LoadFile instead.
   */
  virtual bool Initialize(const SignalBank &input);

  /*! \brief Dummy funciton to comply with the Module specification. Gives an
   *  error message when called.
   */
  virtual void Process(const SignalBank &input);

 private:
  /*! \brief Prepare the module
   *  \param input Input SignalBank
   *  \param output true on success false on failure
   */
  virtual bool InitializeInternal(const SignalBank &input);

  /*! \brief Rewind to the start of the file
   */
  virtual void ResetInternal();

  /*! \brief File descriptor
   */
  SNDFILE *file_handle_;

  /*! \brief Current position in time of the file
   */
  int file_position_samples_;
  bool file_loaded_;
  int audio_channels_;
  int buffer_length_;
  float sample_rate_;
};
}  // namespace aimc

#endif  // AIMC_MODULES_INPUT_FILEINPUT_H_