Ardour  9.0-pre0-582-g084a23a80d
libs/ardour/ardour/utils.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2000-2018 Paul Davis <paul@linuxaudiosystems.com>
3  * Copyright (C) 2005-2006 Taybin Rutkin <taybin@taybin.com>
4  * Copyright (C) 2007-2015 Tim Mayberry <mojofunk@gmail.com>
5  * Copyright (C) 2008-2013 David Robillard <d@drobilla.net>
6  * Copyright (C) 2009-2012 Carl Hetherington <carl@carlh.net>
7  * Copyright (C) 2013-2017 Robin Gareus <robin@gareus.org>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License along
20  * with this program; if not, write to the Free Software Foundation, Inc.,
21  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22  */
23 
24 #pragma once
25 
26 #ifdef WAF_BUILD
27 #include "libardour-config.h"
28 #endif
29 
30 #include <iostream>
31 #include <string>
32 #include <cmath>
33 
34 #if __APPLE__
35 #include <CoreFoundation/CoreFoundation.h>
36 #endif /* __APPLE__ */
37 
38 #include "ardour/ardour.h"
39 #include "ardour/data_type.h"
40 #include "ardour/dB.h"
41 #include "ardour/types.h"
42 
44 
45 class XMLNode;
46 
47 namespace ARDOUR {
48 
49 class Route;
50 class Track;
51 
52 LIBARDOUR_API std::string legalize_for_path (const std::string& str);
53 LIBARDOUR_API std::string legalize_for_universal_path (const std::string& str);
54 LIBARDOUR_API std::string legalize_for_uri (const std::string& str);
55 LIBARDOUR_API std::string legalize_for_path_2X (const std::string& str);
56 LIBARDOUR_API XMLNode* find_named_node (const XMLNode& node, std::string name);
57 LIBARDOUR_API std::string bool_as_string (bool);
58 
59 static inline float f_max(float x, float a) {
60  x -= a;
61  x += fabsf (x);
62  x *= 0.5f;
63  x += a;
64 
65  return (x);
66 }
67 
68 LIBARDOUR_API std::string bump_name_once(const std::string& s, char delimiter);
69 LIBARDOUR_API std::string bump_name_number(const std::string& s);
70 LIBARDOUR_API std::string bump_name_abc(const std::string& s);
71 
72 LIBARDOUR_API int cmp_nocase (const std::string& s, const std::string& s2);
73 LIBARDOUR_API int cmp_nocase_utf8 (const std::string& s1, const std::string& s2);
74 
75 LIBARDOUR_API std::string region_name_from_path (std::string path, bool strip_channels, bool add_channel_suffix = false, uint32_t total = 0, uint32_t this_one = 0);
76 LIBARDOUR_API bool path_is_paired (std::string path, std::string& pair_base);
77 
78 LIBARDOUR_API void compute_equal_power_fades (ARDOUR::samplecnt_t nframes, float* in, float* out);
79 
82 
85 
86 LIBARDOUR_API double gain_to_slider_position_with_max (double g, double max_gain = 2.0);
87 LIBARDOUR_API double slider_position_to_gain_with_max (double g, double max_gain = 2.0);
88 
89 /* I don't really like hard-coding these falloff rates here
90  * Probably should use a map of some kind that could be configured
91  * These rates are db/sec.
92 */
93 
94 #define METER_FALLOFF_OFF 0.0f
95 #define METER_FALLOFF_SLOWEST 6.6f // BBC standard
96 #define METER_FALLOFF_SLOW 8.6f // BBC standard, EBU 24dB / 2.8sec
97 #define METER_FALLOFF_SLOWISH 12.0f // DIN 20dB / 1.7 sec
98 #define METER_FALLOFF_MODERATE 13.3f // EBU-PPM, IRT PPM- 20dB / 1.5 sec
99 #define METER_FALLOFF_MEDIUM 20.0f
100 #define METER_FALLOFF_FAST 32.0f
101 
105 
107 LIBARDOUR_API bool matching_unsuffixed_filename_exists_in (const std::string& dir, const std::string& name);
108 
111 
112 LIBARDOUR_API std::string compute_sha1_of_file (std::string path);
113 
114 template<typename T> std::shared_ptr<AutomationControlList> route_list_to_control_list (std::shared_ptr<RouteList const> rl, std::shared_ptr<T> (Stripable::*get_control)() const) {
115  std::shared_ptr<AutomationControlList> cl (new AutomationControlList);
116  if (!rl) { return cl; }
117  for (auto const& r : *rl) {
118  std::shared_ptr<AutomationControl> ac = (r.get()->*get_control)();
119  if (ac) {
120  cl->push_back (ac);
121  }
122  }
123  return cl;
124 }
125 
126 template<typename T> std::shared_ptr<AutomationControlList> stripable_list_to_control_list (StripableList& sl, std::shared_ptr<T> (Stripable::*get_control)() const) {
127  std::shared_ptr<AutomationControlList> cl (new AutomationControlList);
128  for (auto const & s : sl) {
129  std::shared_ptr<AutomationControl> ac = (s.get()->*get_control)();
130  if (ac) {
131  cl->push_back (ac);
132  }
133  }
134  return cl;
135 }
136 
137 template<typename T> std::shared_ptr<AutomationControlList> stripable_list_to_control_list (std::shared_ptr<StripableList const> sl, std::shared_ptr<T> (Stripable::*get_control)() const) {
138  std::shared_ptr<AutomationControlList> cl (new AutomationControlList);
139  if (!sl) { return cl; }
140  for (auto const & s : *sl) {
141  std::shared_ptr<AutomationControl> ac = (s.get()->*get_control)();
142  if (ac) {
143  cl->push_back (ac);
144  }
145  }
146  return cl;
147 }
148 
149 #if __APPLE__
150 LIBARDOUR_API std::string CFStringRefToStdString(CFStringRef stringRef);
151 #endif // __APPLE__
152 
153 } //namespave
154 
Definition: xml++.h:114
GtkImageIconNameData name
Definition: gtkimage.h:6
#define LIBARDOUR_API
static const MIDISequence s2[]
static const MIDISequence s1[]
const char * native_header_format_extension(ARDOUR::HeaderFormat, const ARDOUR::DataType &type)
std::shared_ptr< AutomationControlList > route_list_to_control_list(std::shared_ptr< RouteList const > rl, std::shared_ptr< T >(Stripable::*get_control)() const)
bool path_is_paired(std::string path, std::string &pair_base)
std::string compute_sha1_of_file(std::string path)
std::string bump_name_number(const std::string &s)
std::list< std::shared_ptr< AutomationControl > > AutomationControlList
int cmp_nocase_utf8(const std::string &s1, const std::string &s2)
double gain_to_slider_position_with_max(double g, double max_gain=2.0)
std::list< std::shared_ptr< Stripable > > StripableList
std::string bool_as_string(bool)
uint32_t how_many_dsp_threads()
ARDOUR::RippleMode string_to_ripple_mode(std::string)
Temporal::samplecnt_t samplecnt_t
std::string legalize_for_path(const std::string &str)
uint32_t how_many_io_threads()
double slider_position_to_gain_with_max(double g, double max_gain=2.0)
XMLNode * find_named_node(const XMLNode &node, std::string name)
std::string legalize_for_uri(const std::string &str)
std::string legalize_for_universal_path(const std::string &str)
ARDOUR::EditMode string_to_edit_mode(std::string)
std::string bump_name_abc(const std::string &s)
std::string region_name_from_path(std::string path, bool strip_channels, bool add_channel_suffix=false, uint32_t total=0, uint32_t this_one=0)
void compute_equal_power_fades(ARDOUR::samplecnt_t nframes, float *in, float *out)
std::string legalize_for_path_2X(const std::string &str)
ARDOUR::MeterFalloff meter_falloff_from_float(float)
std::shared_ptr< AutomationControlList > stripable_list_to_control_list(StripableList &sl, std::shared_ptr< T >(Stripable::*get_control)() const)
int cmp_nocase(const std::string &s, const std::string &s2)
const char * ripple_mode_to_string(ARDOUR::RippleMode)
float meter_falloff_to_db_per_sec(float)
static float f_max(float x, float a)
bool matching_unsuffixed_filename_exists_in(const std::string &dir, const std::string &name)
float meter_falloff_to_float(ARDOUR::MeterFalloff)
std::string bump_name_once(const std::string &s, char delimiter)
const char * edit_mode_to_string(ARDOUR::EditMode)