2 Copyright (C) 1999 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef __ardour_utils_h__
21 #define __ardour_utils_h__
24 #include "libardour-config.h"
31 #include "boost/shared_ptr.hpp"
34 #include <CoreFoundation/CoreFoundation.h>
35 #endif /* __APPLE__ */
37 #include "ardour/ardour.h"
38 #include "ardour/data_type.h"
39 #include "ardour/dB.h"
40 #include "ardour/types.h"
42 #include "ardour/libardour_visibility.h"
51 LIBARDOUR_API std::string legalize_for_path (const std::string& str);
52 LIBARDOUR_API std::string legalize_for_universal_path (const std::string& str);
53 LIBARDOUR_API std::string legalize_for_uri (const std::string& str);
54 LIBARDOUR_API std::string legalize_for_path_2X (const std::string& str);
55 LIBARDOUR_API XMLNode* find_named_node (const XMLNode& node, std::string name);
56 LIBARDOUR_API std::string bool_as_string (bool);
58 static inline float f_max(float x, float a) {
67 LIBARDOUR_API std::string bump_name_once(const std::string& s, char delimiter);
68 LIBARDOUR_API std::string bump_name_number(const std::string& s);
70 LIBARDOUR_API int cmp_nocase (const std::string& s, const std::string& s2);
71 LIBARDOUR_API int cmp_nocase_utf8 (const std::string& s1, const std::string& s2);
73 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);
74 LIBARDOUR_API bool path_is_paired (std::string path, std::string& pair_base);
76 LIBARDOUR_API void compute_equal_power_fades (ARDOUR::samplecnt_t nframes, float* in, float* out);
78 LIBARDOUR_API const char* sync_source_to_string (ARDOUR::SyncSource src, bool sh = false);
79 LIBARDOUR_API ARDOUR::SyncSource string_to_sync_source (std::string str);
81 LIBARDOUR_API const char* edit_mode_to_string (ARDOUR::EditMode);
82 LIBARDOUR_API ARDOUR::EditMode string_to_edit_mode (std::string);
84 LIBARDOUR_API double gain_to_slider_position_with_max (double g, double max_gain = 2.0);
85 LIBARDOUR_API double slider_position_to_gain_with_max (double g, double max_gain = 2.0);
87 /* I don't really like hard-coding these falloff rates here
88 * Probably should use a map of some kind that could be configured
89 * These rates are db/sec.
92 #define METER_FALLOFF_OFF 0.0f
93 #define METER_FALLOFF_SLOWEST 6.6f // BBC standard
94 #define METER_FALLOFF_SLOW 8.6f // BBC standard, EBU 24dB / 2.8sec
95 #define METER_FALLOFF_SLOWISH 12.0f // DIN 20dB / 1.7 sec
96 #define METER_FALLOFF_MODERATE 13.3f // EBU-PPM, IRT PPM- 20dB / 1.5 sec
97 #define METER_FALLOFF_MEDIUM 20.0f
98 #define METER_FALLOFF_FAST 32.0f
100 LIBARDOUR_API float meter_falloff_to_float (ARDOUR::MeterFalloff);
101 LIBARDOUR_API ARDOUR::MeterFalloff meter_falloff_from_float (float);
102 LIBARDOUR_API float meter_falloff_to_db_per_sec (float);
104 LIBARDOUR_API const char* native_header_format_extension (ARDOUR::HeaderFormat, const ARDOUR::DataType& type);
105 LIBARDOUR_API bool matching_unsuffixed_filename_exists_in (const std::string& dir, const std::string& name);
107 LIBARDOUR_API uint32_t how_many_dsp_threads ();
109 LIBARDOUR_API std::string compute_sha1_of_file (std::string path);
111 template<typename T> boost::shared_ptr<ControlList> route_list_to_control_list (boost::shared_ptr<RouteList> rl, boost::shared_ptr<T> (Stripable::*get_control)() const) {
112 boost::shared_ptr<ControlList> cl (new ControlList);
113 if (!rl) { return cl; }
114 for (RouteList::const_iterator r = rl->begin(); r != rl->end(); ++r) {
115 boost::shared_ptr<AutomationControl> ac = ((*r).get()->*get_control)();
123 template<typename T> boost::shared_ptr<ControlList> stripable_list_to_control_list (StripableList& sl, boost::shared_ptr<T> (Stripable::*get_control)() const) {
124 boost::shared_ptr<ControlList> cl (new ControlList);
125 for (StripableList::const_iterator s = sl.begin(); s != sl.end(); ++s) {
126 boost::shared_ptr<AutomationControl> ac = ((*s).get()->*get_control)();
135 LIBARDOUR_API std::string CFStringRefToStdString(CFStringRef stringRef);
140 #endif /* __ardour_utils_h__ */