cannam@89: #include "portaudiocpp/StreamParameters.hxx"
cannam@89: 
cannam@89: #include <cstddef>
cannam@89: 
cannam@89: #include "portaudiocpp/Device.hxx"
cannam@89: 
cannam@89: namespace portaudio
cannam@89: {
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Default constructor; does nothing.
cannam@89: 	//////
cannam@89: 	StreamParameters::StreamParameters()
cannam@89: 	{
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Sets up the all parameters needed to open either a half-duplex or full-duplex Stream.
cannam@89: 	///
cannam@89: 	/// @param inputParameters The parameters for the input direction of the to-be opened 
cannam@89: 	/// Stream or DirectionSpecificStreamParameters::null() for an output-only Stream.
cannam@89: 	/// @param outputParameters The parameters for the output direction of the to-be opened
cannam@89: 	/// Stream or DirectionSpecificStreamParameters::null() for an input-only Stream.
cannam@89: 	/// @param sampleRate The to-be opened Stream's sample rate in Hz.
cannam@89: 	/// @param framesPerBuffer The number of frames per buffer for a CallbackStream, or 
cannam@89: 	/// the preferred buffer granularity for a BlockingStream.
cannam@89: 	/// @param flags The flags for the to-be opened Stream; default paNoFlag.
cannam@89: 	//////
cannam@89: 	StreamParameters::StreamParameters(const DirectionSpecificStreamParameters &inputParameters, 
cannam@89: 		const DirectionSpecificStreamParameters &outputParameters, double sampleRate, unsigned long framesPerBuffer, 
cannam@89: 		PaStreamFlags flags) : inputParameters_(inputParameters), outputParameters_(outputParameters), 
cannam@89: 		sampleRate_(sampleRate), framesPerBuffer_(framesPerBuffer), flags_(flags)
cannam@89: 	{
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Sets the requested sample rate. If this sample rate isn't supported by the hardware, the 
cannam@89: 	/// Stream will fail to open. The real-life sample rate used might differ slightly due to 
cannam@89: 	/// imperfections in the sound card hardware; use Stream::sampleRate() to retreive the 
cannam@89: 	/// best known estimate for this value.
cannam@89: 	//////
cannam@89: 	void StreamParameters::setSampleRate(double sampleRate)
cannam@89: 	{
cannam@89: 		sampleRate_ = sampleRate;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Either the number of frames per buffer for a CallbackStream, or 
cannam@89: 	/// the preferred buffer granularity for a BlockingStream. See PortAudio 
cannam@89: 	/// documentation.
cannam@89: 	//////
cannam@89: 	void StreamParameters::setFramesPerBuffer(unsigned long framesPerBuffer)
cannam@89: 	{
cannam@89: 		framesPerBuffer_ = framesPerBuffer;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Sets the specified flag or does nothing when the flag is already set. Doesn't 
cannam@89: 	/// `unset' any previously existing flags (use clearFlags() for that).
cannam@89: 	//////
cannam@89: 	void StreamParameters::setFlag(PaStreamFlags flag)
cannam@89: 	{
cannam@89: 		flags_ |= flag;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Unsets the specified flag or does nothing if the flag isn't set. Doesn't affect 
cannam@89: 	/// any other flags.
cannam@89: 	//////
cannam@89: 	void StreamParameters::unsetFlag(PaStreamFlags flag)
cannam@89: 	{
cannam@89: 		flags_ &= ~flag;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Clears or `unsets' all set flags.
cannam@89: 	//////
cannam@89: 	void StreamParameters::clearFlags()
cannam@89: 	{
cannam@89: 		flags_ = paNoFlag;
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	void StreamParameters::setInputParameters(const DirectionSpecificStreamParameters &parameters)
cannam@89: 	{
cannam@89: 		inputParameters_ = parameters;
cannam@89: 	}
cannam@89: 
cannam@89: 	void StreamParameters::setOutputParameters(const DirectionSpecificStreamParameters &parameters)
cannam@89: 	{
cannam@89: 		outputParameters_ = parameters;
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	bool StreamParameters::isSupported() const
cannam@89: 	{
cannam@89: 		return (Pa_IsFormatSupported(inputParameters_.paStreamParameters(), 
cannam@89: 			outputParameters_.paStreamParameters(), sampleRate_) == paFormatIsSupported);
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	double StreamParameters::sampleRate() const
cannam@89: 	{
cannam@89: 		return sampleRate_;
cannam@89: 	}
cannam@89: 
cannam@89: 	unsigned long StreamParameters::framesPerBuffer() const
cannam@89: 	{
cannam@89: 		return framesPerBuffer_;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Returns all currently set flags as a binary combined 
cannam@89: 	/// integer value (PaStreamFlags). Use isFlagSet() to 
cannam@89: 	/// avoid dealing with the bitmasks.
cannam@89: 	//////
cannam@89: 	PaStreamFlags StreamParameters::flags() const
cannam@89: 	{
cannam@89: 		return flags_;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Returns true if the specified flag is currently set 
cannam@89: 	/// or false if it isn't.
cannam@89: 	//////
cannam@89: 	bool StreamParameters::isFlagSet(PaStreamFlags flag) const
cannam@89: 	{
cannam@89: 		return ((flags_ & flag) != 0);
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	DirectionSpecificStreamParameters &StreamParameters::inputParameters()
cannam@89: 	{
cannam@89: 		return inputParameters_;
cannam@89: 	}
cannam@89: 
cannam@89: 	const DirectionSpecificStreamParameters &StreamParameters::inputParameters() const
cannam@89: 	{
cannam@89: 		return inputParameters_;
cannam@89: 	}
cannam@89: 
cannam@89: 	DirectionSpecificStreamParameters &StreamParameters::outputParameters()
cannam@89: 	{
cannam@89: 		return outputParameters_;
cannam@89: 	}
cannam@89: 
cannam@89: 	const DirectionSpecificStreamParameters &StreamParameters::outputParameters() const
cannam@89: 	{
cannam@89: 		return outputParameters_;
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: } // namespace portaudio
cannam@89: 
cannam@89: 
cannam@89: 
cannam@89: 
cannam@89: