summaryrefslogtreecommitdiff
path: root/libs/ardour/ardour/dsp_load_calculator.h
blob: 0fed1db7a44b2991a0979346e4cd0c3791d275c3 (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
96
97
98
99
100
101
102
/*
 * Copyright (C) 2015 Tim Mayberry <mojofunk@gmail.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#ifndef ARDOUR_DSP_LOAD_CALCULATOR_H
#define ARDOUR_DSP_LOAD_CALCULATOR_H

#include <stdint.h>
#include <cassert>
#include <algorithm>

#include <pbd/ringbuffer.h>

#include "ardour/libardour_visibility.h"

namespace ARDOUR {

class LIBARDOUR_API DSPLoadCalculator {
public:
	DSPLoadCalculator()
	    : m_max_time_us(0)
	    , m_start_timestamp_us(0)
	    , m_stop_timestamp_us(0)
	    , m_dsp_load(0)
	    , m_value_history (max_value_history())
	    , m_num_values(0)
	{

	}

	void set_max_time_us(uint64_t max_time_us) {
		assert(m_max_time_us != 0);
		m_max_time_us = max_time_us;

		// Use average of last 1/4 second of values so responsiveness
		// remains consistent independent of max time
		uint32_t max_dsp_samples_per_qtr_second = (250000 / m_max_time_us);
		m_num_values =
		    std::min(max_value_history() - 1, max_dsp_samples_per_qtr_second);

		m_value_history.reset();
	}


	uint64_t get_max_time_us() const { return m_max_time_us; }

	void set_start_timestamp_us(uint64_t start_timestamp_us)
	{
		m_start_timestamp_us = start_timestamp_us;
	}

	void set_stop_timestamp_us(uint64_t stop_timestamp_us);

	uint64_t elapsed_time_us()
	{
		return m_stop_timestamp_us - m_start_timestamp_us;
	}

	/**
	 * @return a decimal value between 0.0 and 1.0 representing the percentage
	 * of time spent between start and stop in proportion to the max expected time
	 * in microseconds(us).
	 */
	float get_dsp_load() const
	{
		if (m_dsp_load > m_max_time_us) {
			return 1.0f;
		}
		if (m_dsp_load < 0.0f) {
			return 0.0f;
		}
		return m_dsp_load;
	}
private: // methods
	static uint32_t max_value_history () { return 16; }

private: // data
	uint64_t m_max_time_us;
	uint64_t m_start_timestamp_us;
	uint64_t m_stop_timestamp_us;
	float m_dsp_load;
	RingBuffer<float> m_value_history;
	uint32_t m_num_values;
};

} // namespace ARDOUR

#endif // ARDOUR_DSP_LOAD_CALCULATOR_H