cannam@89: #include "portaudiocpp/Stream.hxx"
cannam@89: 
cannam@89: #include <cstddef>
cannam@89: 
cannam@89: #include "portaudiocpp/Exception.hxx"
cannam@89: #include "portaudiocpp/System.hxx"
cannam@89: 
cannam@89: namespace portaudio
cannam@89: {
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	Stream::Stream() : stream_(NULL)
cannam@89: 	{
cannam@89: 	}
cannam@89: 
cannam@89: 	Stream::~Stream()
cannam@89: 	{
cannam@89: 		// (can't call close here, 
cannam@89: 		// the derived class should atleast call 
cannam@89: 		// close() in it's deconstructor)
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Closes the Stream if it's open, else does nothing.
cannam@89: 	//////
cannam@89: 	void Stream::close()
cannam@89: 	{
cannam@89: 		if (isOpen() && System::exists())
cannam@89: 		{
cannam@89: 			PaError err = Pa_CloseStream(stream_);
cannam@89: 			stream_ = NULL;
cannam@89: 
cannam@89: 			if (err != paNoError)
cannam@89: 				throw PaException(err);
cannam@89: 		}
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Returns true if the Stream is open.
cannam@89: 	//////
cannam@89: 	bool Stream::isOpen() const
cannam@89: 	{
cannam@89: 		return (stream_ != NULL);
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	void Stream::setStreamFinishedCallback(PaStreamFinishedCallback *callback)
cannam@89: 	{
cannam@89: 		PaError err = Pa_SetStreamFinishedCallback(stream_, callback);
cannam@89: 
cannam@89: 		if (err != paNoError)
cannam@89: 			throw PaException(err);
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	void Stream::start()
cannam@89: 	{
cannam@89: 		PaError err = Pa_StartStream(stream_);
cannam@89: 
cannam@89: 		if (err != paNoError)
cannam@89: 			throw PaException(err);
cannam@89: 	}
cannam@89: 
cannam@89: 	void Stream::stop()
cannam@89: 	{
cannam@89: 		PaError err = Pa_StopStream(stream_);
cannam@89: 
cannam@89: 		if (err != paNoError)
cannam@89: 			throw PaException(err);
cannam@89: 	}
cannam@89: 
cannam@89: 	void Stream::abort()
cannam@89: 	{
cannam@89: 		PaError err = Pa_AbortStream(stream_);
cannam@89: 
cannam@89: 		if (err != paNoError)
cannam@89: 			throw PaException(err);
cannam@89: 	}
cannam@89: 
cannam@89: 	bool Stream::isStopped() const
cannam@89: 	{
cannam@89: 		PaError ret = Pa_IsStreamStopped(stream_);
cannam@89: 
cannam@89: 		if (ret < 0)
cannam@89: 			throw PaException(ret);
cannam@89: 
cannam@89: 		return (ret == 1);
cannam@89: 	}
cannam@89: 
cannam@89: 	bool Stream::isActive() const
cannam@89: 	{
cannam@89: 		PaError ret = Pa_IsStreamActive(stream_);
cannam@89: 
cannam@89: 		if (ret < 0)
cannam@89: 			throw PaException(ret);
cannam@89: 
cannam@89: 		return (ret == 1);
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Returns the best known input latency for the Stream. This value may differ from the 
cannam@89: 	/// suggested input latency set in the StreamParameters. Includes all sources of 
cannam@89: 	/// latency known to PortAudio such as internal buffering, and Host API reported latency. 
cannam@89: 	/// Doesn't include any estimates of unknown latency.
cannam@89: 	//////
cannam@89: 	PaTime Stream::inputLatency() const
cannam@89: 	{
cannam@89: 		const PaStreamInfo *info = Pa_GetStreamInfo(stream_);
cannam@89: 		if (info == NULL)
cannam@89: 		{
cannam@89: 			throw PaException(paInternalError);
cannam@89: 			return PaTime(0.0);
cannam@89: 		}
cannam@89: 
cannam@89: 		return info->inputLatency;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Returns the best known output latency for the Stream. This value may differ from the 
cannam@89: 	/// suggested output latency set in the StreamParameters. Includes all sources of 
cannam@89: 	/// latency known to PortAudio such as internal buffering, and Host API reported latency. 
cannam@89: 	/// Doesn't include any estimates of unknown latency.
cannam@89: 	//////
cannam@89: 	PaTime Stream::outputLatency() const
cannam@89: 	{
cannam@89: 		const PaStreamInfo *info = Pa_GetStreamInfo(stream_);
cannam@89: 		if (info == NULL)
cannam@89: 		{
cannam@89: 			throw PaException(paInternalError);
cannam@89: 			return PaTime(0.0);
cannam@89: 		}
cannam@89: 
cannam@89: 		return info->outputLatency;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Returns the sample rate of the Stream. Usually this will be the 
cannam@89: 	/// best known estimate of the used sample rate. For instance when opening a 
cannam@89: 	/// Stream setting 44100.0 Hz in the StreamParameters, the actual sample 
cannam@89: 	/// rate might be something like 44103.2 Hz (due to imperfections in the 
cannam@89: 	/// sound card hardware).
cannam@89: 	//////
cannam@89: 	double Stream::sampleRate() const
cannam@89: 	{
cannam@89: 		const PaStreamInfo *info = Pa_GetStreamInfo(stream_);
cannam@89: 		if (info == NULL)
cannam@89: 		{
cannam@89: 			throw PaException(paInternalError);
cannam@89: 			return 0.0;
cannam@89: 		}
cannam@89: 
cannam@89: 		return info->sampleRate;
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	PaTime Stream::time() const
cannam@89: 	{
cannam@89: 		return Pa_GetStreamTime(stream_);
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Accessor (const) for PortAudio PaStream pointer, useful for interfacing with 
cannam@89: 	/// PortAudio add-ons such as PortMixer for instance. Normally accessing this 
cannam@89: 	/// pointer should not be needed as PortAudioCpp aims to provide all of PortAudio's 
cannam@89: 	/// functionality.
cannam@89: 	//////
cannam@89: 	const PaStream *Stream::paStream() const
cannam@89: 	{
cannam@89: 		return stream_;
cannam@89: 	}
cannam@89: 
cannam@89: 	//////
cannam@89: 	/// Accessor (non-const) for PortAudio PaStream pointer, useful for interfacing with 
cannam@89: 	/// PortAudio add-ons such as PortMixer for instance. Normally accessing this 
cannam@89: 	/// pointer should not be needed as PortAudioCpp aims to provide all of PortAudio's 
cannam@89: 	/// functionality.
cannam@89: 	//////
cannam@89: 	PaStream *Stream::paStream()
cannam@89: 	{
cannam@89: 		return stream_;
cannam@89: 	}
cannam@89: 
cannam@89: 	// -----------------------------------------------------------------------------------
cannam@89: 
cannam@89: } // namespace portaudio