Welcome to mirror list, hosted at ThFree Co, Russian Federation.

ThreadedDevice.h « devices « include « audaspace « extern - git.blender.org/blender.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: 36c2e68e36fc7d4da6197279c0eda8388a9e4598 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/*******************************************************************************
 * Copyright 2009-2016 Jörg Müller
 *
 * 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 ThreadedDevice.h
 * @ingroup plugin
 * The ThreadedDevice class.
 */

#include "devices/SoftwareDevice.h"

#include <thread>

AUD_NAMESPACE_BEGIN

/**
 * This device extends the SoftwareDevice with code for running mixing in a separate thread.
 */
class AUD_PLUGIN_API ThreadedDevice : public SoftwareDevice
{
private:
	/**
	 * Whether there is currently playback.
	 */
	bool m_playing;

	/**
	 * Whether the current playback should stop.
	 */
	bool m_stop;

	/**
	 * The streaming thread.
	 */
	std::thread m_thread;

	/**
	 * Starts the streaming thread.
	 */
	AUD_LOCAL void start();

	/**
	 * Streaming thread main function.
	 */
	AUD_LOCAL virtual void runMixingThread()=0;

	// delete copy constructor and operator=
	ThreadedDevice(const ThreadedDevice&) = delete;
	ThreadedDevice& operator=(const ThreadedDevice&) = delete;

protected:
	virtual void playing(bool playing);

	/**
	 * Empty default constructor. To setup the device call the function create()
	 * and to uninitialize call destroy().
	 */
	ThreadedDevice();

	/**
	 * Indicates that the mixing thread should be stopped.
	 * \return Whether the mixing thread should be stopping.
	 * \warning For thread safety, the device needs to be locked, when this method is called.
	 */
	inline bool shouldStop() { return m_stop; }

	/**
	 * This method needs to be called when the mixing thread is stopping.
	 * \warning For thread safety, the device needs to be locked, when this method is called.
	 */
	inline void doStop() { m_stop = m_playing = false; }

	/**
	 * Stops all playback and notifies the mixing thread to stop.
	 * \warning The device has to be unlocked to not run into a deadlock.
	 */
	void stopMixingThread();
};

AUD_NAMESPACE_END