/******************************************************************************* * Copyright 2015-2016 Juan Francisco Crespo Galán * * 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. ******************************************************************************/ #pragma once /** * @file BinauralSound.h * @ingroup fx * The BinauralSound class. */ #include "ISound.h" #include "HRTF.h" #include "Source.h" #include "util/ThreadPool.h" #include "util/FFTPlan.h" #include #include AUD_NAMESPACE_BEGIN /** * This class represents a sound that can sound different depending on its realtive position with the listener. */ class AUD_API BinauralSound : public ISound { private: /** * A pointer to the imput sound. */ std::shared_ptr m_sound; /** * A pointer to an HRTF object with a collection of impulse responses. */ std::shared_ptr m_hrtfs; /** * A pointer to a Source object which represents the source of the sound. */ std::shared_ptr m_source; /** * A shared ptr to a thread pool. */ std::shared_ptr m_threadPool; /** * A shared ponter to an FFT plan. */ std::shared_ptr m_plan; // delete copy constructor and operator= BinauralSound(const BinauralSound&) = delete; BinauralSound& operator=(const BinauralSound&) = delete; public: /** * Creates a new ConvolverSound. * \param sound The sound that will be convolved. It must have only one channel. * \param hrtfs The HRTF set that will be used. * \param source A shared pointer to a Source object that contains the source of the sound. * \param threadPool A shared pointer to a ThreadPool object with 1 or more threads. * \param plan A shared pointer to a FFTPlan object that will be used for convolution. * \warning The same FFTPlan object must be used to construct both this and the HRTF object provided. */ BinauralSound(std::shared_ptr sound, std::shared_ptr hrtfs, std::shared_ptr source, std::shared_ptr threadPool, std::shared_ptr plan); /** * Creates a new BinauralSound. A default FFT plan will be created. * \param sound The sound that will be convolved. Must have only one channel. * \param hrtfs The HRTF set that will be used. * \param source A shared pointer to a Source object that contains the source of the sound. * \param threadPool A shared pointer to a ThreadPool object with 1 or more threads. * \warning To use this constructor no FFTPlan object must have been provided to the hrtfs. */ BinauralSound(std::shared_ptr sound, std::shared_ptr hrtfs, std::shared_ptr source, std::shared_ptr threadPool); virtual std::shared_ptr createReader(); /** * Retrieves the HRTF set being used. * \return A shared pointer to the current HRTF object being used. */ std::shared_ptr getHRTFs(); /** * Changes the set of HRTFs used for convolution, it'll only affect newly created readers. * \param hrtfs A shared pointer to the new HRTF object. */ void setHRTFs(std::shared_ptr hrtfs); /** * Retrieves the Source object being used. * \return A shared pointer to the current Source object being used. */ std::shared_ptr getSource(); /** * Changes the Source object used to change the source position of the sound. * \param source A shared pointer to the new Source object. */ void setSource(std::shared_ptr source); }; AUD_NAMESPACE_END