jack_utils.h

Go to the documentation of this file.

/*
 * Copyright (C) 2013 Paul Davis <paul@linuxaudiosystems.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.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#include <stdint.h>
 
#include <vector>
#include <map>
#include <string>
 
namespace ARDOUR {
 
        // Names for the drivers on all possible systems
        extern const char * const portaudio_driver_name;
        extern const char * const coreaudio_driver_name;
        extern const char * const alsa_driver_name;
        extern const char * const oss_driver_name;
        extern const char * const sun_driver_name;
        extern const char * const freebob_driver_name;
        extern const char * const ffado_driver_name;
        extern const char * const netjack_driver_name;
        extern const char * const dummy_driver_name;
 
        void get_jack_audio_driver_names (std::vector<std::string>& driver_names);
 
        void get_jack_default_audio_driver_name (std::string& driver_name);
 
        void get_jack_sample_rate_strings (std::vector<std::string>& sample_rates);
 
        std::string get_jack_default_sample_rate ();
 
        bool get_jack_sample_rate_value_from_string (const std::string& srs, uint32_t& srv);
 
        void get_jack_period_size_strings (std::vector<std::string>& samplerates);
 
        std::string get_jack_default_period_size ();
 
        bool get_jack_period_size_value_from_string (const std::string& pss, uint32_t& psv);
 
        void get_jack_dither_mode_strings (const std::string& driver, std::vector<std::string>& dither_modes);
 
        std::string get_jack_default_dither_mode (const std::string& driver);
 
        std::string get_jack_latency_string (std::string samplerate, float periods, std::string period_size);
 
        typedef std::map<std::string, std::string> device_map_t;
 
        void get_jack_alsa_device_names (device_map_t& devices);
        void get_jack_portaudio_device_names (device_map_t& devices);
        void get_jack_coreaudio_device_names (device_map_t& devices);
        void get_jack_oss_device_names (device_map_t& devices);
        void get_jack_sun_device_names (device_map_t& devices);
        void get_jack_freebob_device_names (device_map_t& devices);
        void get_jack_ffado_device_names (device_map_t& devices);
        void get_jack_netjack_device_names (device_map_t& devices);
        void get_jack_dummy_device_names (device_map_t& devices);
 
        /*
         * @return true if there were devices found for the driver
         *
         * @param driver The driver name returned by get_jack_audio_driver_names
         * @param devices The map used to insert the drivers into, devices will be cleared before
         * adding the available drivers
         */
        bool get_jack_device_names_for_audio_driver (const std::string& driver, device_map_t& devices);
 
        /*
         * @return a list of readable device names for a specific driver.
         */
        std::vector<std::string> get_jack_device_names_for_audio_driver (const std::string& driver);
 
        bool get_jack_audio_driver_supports_two_devices (const std::string& driver);
 
        bool get_jack_audio_driver_supports_latency_adjustment (const std::string& driver);
 
        bool get_jack_audio_driver_supports_setting_period_count (const std::string& driver);
 
        bool get_jack_server_application_names (std::vector<std::string>& server_names);
 
        void set_path_env_for_jack_autostart (const std::vector<std::string>&);
 
        bool get_jack_server_dir_paths (std::vector<std::string>& server_dir_paths);
 
        bool get_jack_server_paths (const std::vector<std::string>& server_dir_paths,
                        const std::vector<std::string>& server_names,
                        std::vector<std::string>& server_paths);
 
 
        bool get_jack_server_paths (std::vector<std::string>& server_paths);
 
        bool get_jack_default_server_path (std::string& server_path);
 
        typedef std::vector<std::pair<std::string,std::string> > MidiOptions;
 
        std::string get_jack_server_config_file_name ();
 
        std::string get_jack_server_user_config_dir_path ();
 
        std::string get_jack_server_user_config_file_path ();
 
        bool write_jack_config_file (const std::string& config_file_path, const std::string& command_line);
 
        struct JackCommandLineOptions {
 
                // see implementation for defaults
                JackCommandLineOptions ();
 
                //operator bool
                //operator ostream
 
                std::string      server_path;
                uint32_t         timeout;
                bool             no_mlock;
                uint32_t         ports_max;
                bool             realtime;
                uint32_t         priority;
                bool             unlock_gui_libs;
                bool             verbose;
                bool             temporary;
                bool             playback_only;
                bool             capture_only;
                std::string      driver;
                std::string      input_device;
                std::string      output_device;
                uint32_t         num_periods;
                uint32_t         period_size;
                uint32_t         samplerate;
                uint32_t         input_channels;
                uint32_t         output_channels;
                uint32_t         input_latency;
                uint32_t         output_latency;
                bool             hardware_metering;
                bool             hardware_monitoring;
                std::string      dither_mode;
                bool             force16_bit;
                bool             soft_mode;
                std::string      midi_driver;
        };
 
        std::vector<std::string> enumerate_midi_options ();
        int set_midi_option (ARDOUR::JackCommandLineOptions&, const std::string& opt);
 
        bool get_jack_command_line_string (JackCommandLineOptions& options, std::string& command_line);
}