Files
yabridge/src/common/utils.h
T
2021-04-14 17:09:43 +02:00

72 lines
2.6 KiB
C++

// yabridge: a Wine VST bridge
// Copyright (C) 2020-2021 Robbert van der Helm
//
// 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 3 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, see <https://www.gnu.org/licenses/>.
#pragma once
#include <optional>
#ifdef __WINE__
#include "../wine-host/boost-fix.h"
#endif
#include <boost/filesystem.hpp>
/**
* The interval in seconds between synchronizing the Wine plugin host's audio
* thread scheduling priority with the host's audio thread.
*
* @relates Vst2Bridge::last_audio_thread_priority_synchronization
*/
constexpr time_t audio_thread_priority_synchronization_interval = 10;
// The cannonical overloading template for `std::visitor`, not sure why this
// isn't part of the standard library
template <class... Ts>
struct overload : Ts... {
using Ts::operator()...;
};
template <class... Ts>
overload(Ts...) -> overload<Ts...>;
/**
* Return the path to the directory for story temporary files. This will be
* `$XDG_RUNTIME_DIR` if set, and `/tmp` otherwise.
*/
boost::filesystem::path get_temporary_directory();
/**
* Get the current thread's scheduling priority if the thread is using
* `SCHED_FIFO`. Returns a nullopt of the calling thread is not under realtime
* scheduling.
*/
std::optional<int> get_realtime_priority();
/**
* Set the scheduling policy to `SCHED_FIFO` with priority 5 for this process.
* We explicitly don't do this for wineserver itself since from my testing that
* can actually increase latencies.
*
* @param sched_fifo If true, set the current process/thread's scheudling policy
* to `SCHED_FIFO`. Otherwise reset it back to `SCHWED_OTHER`.
* @param priority The scheduling priority to use. The exact value usually
* doesn't really matter unless there are a lot of other active `SCHED_FIFO`
* background tasks. We'll use 5 as a default, but we'll periodically copy the
* priority set by the host on the audio threads.
*
* @return Whether the operation was successful or not. This will fail if the
* user does not have the privileges to set realtime priorities.
*/
bool set_realtime_priority(bool sched_fifo, int priority = 5);