mirror of
https://github.com/LMMS/lmms.git
synced 2026-03-26 09:53:03 -04:00
# GUI ## Present inputs/outputs in hierarchical menu Present the available inputs and outputs in a hierarchical sorted menu which shows clients with their ports. The heavy lifting of creating the menu for the tool button is done in the new method `buildMenu`. It takes the input/output names in Jack's "Client name:Port name" format. If an input/output name can be successfully split into the client name and port name then a sub menu with the client name is created (if it was not already created before) and the port name is added as an entry. If the name cannot be split into exactly two components then it is simply added to the top level menu as is. Ports of the LMMS client are filtered out to prevent loops. The menu starts with the client's sub menus in alphabetical order. Then the top level entries are added in alphabetical order as well. The callbacks for the `QAction` instances are implemented with lambdas because MOC does not support nested classes like the setup widget is. For now the used lambda only sets the text of the `QToolButton` as these are used for persisting the configuration anyway. ## Disconnected state Add the option to keep inputs/outputs disconnected. The disconnected state is represented by the string "-" which is also what is saved into the configuration in this case. For now the representation in the GUI and of the save state is the same as it has the advantage that no translation is necessary and thus not mapping between display text and save state is necessary. ## Show technical output/input names Show the technical output and input port names used by LMMS in the setup dialog. Note: these are the names that are shown in tools like `qjackctl` or `qpwgraph`. This was proposed in a review. Personally I like the non-technical names better but let's see what's accepted. ## Let the tool buttons use available space Let the tool buttons stretch so that they look uniform and use all the available space. # Driver ## Reconnect inputs and outputs Attempt to reconnect the inputs and outputs from the configuration during startup of the Jack driver. Nothing will be done for inputs and outputs that are not available at startup. Example: the users might have saved some inputs when a device was available. The device is then disconnected and LMMS restarted. The stored inputs cannot be used anymore. To give the users the least surprise nothing is done. `AudioJack::attemptToConnect` does the actual reconnection and also prints some information for now. `attemptToReconnectOutput` and `attemptToReconnectInput` delegate to `attemptToConnect` with the right parameters. # Technical details ## Generalized number of inputs/outputs Generalize the number of inputs and outputs by using for loops. This affects the number of widgets that are created and the amount of configuration that is stored. This change is a result of a code review discussion. In my opinion it adds unnecessary complexity to something that should later be implemented completely different anyway. It is for example now necessary to compute the key names that are used during the saving of the configuration based on the channel number. The commit exists so that its changes can be discussed further. It might be reverted in one of the next commits. ## Collecting input and output names Add `AudioJack::setupWidget::getAudioPortNames` which takes the type of port and then collects all port names which match. Make `getAudioOutputNames` and `getAudioInputNames` delegate to that method with the appropriate type. This also hides the different terminologies a bit. ## Separate Jack client in the GUI The separate Jack client is necessary because the setup dialog does not have any access to the actual driver. So a new client is created when the dialog is opened and deleted when it is closed, i.e. when the dialog is deleted itself. ## Repeated strings Repeatedly used hard-coded strings are defined as static constant variables in the anonymous namespace. This should prevent subtle mistakes when working with the configuration values of the Jack driver. ## Saving the settings `AudioJack::setupWidget::saveSettings` saves the selections that have been made from the widgets right into the configuration.
156 lines
4.2 KiB
C++
156 lines
4.2 KiB
C++
/*
|
|
* AudioJack.h - support for JACK-transport
|
|
*
|
|
* Copyright (c) 2005-2009 Tobias Doerffel <tobydox/at/users.sourceforge.net>
|
|
*
|
|
* This file is part of LMMS - https://lmms.io
|
|
*
|
|
* 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 (see COPYING); if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
*/
|
|
|
|
#ifndef LMMS_AUDIO_JACK_H
|
|
#define LMMS_AUDIO_JACK_H
|
|
|
|
#include "lmmsconfig.h"
|
|
|
|
#ifdef LMMS_HAVE_JACK
|
|
#ifndef LMMS_HAVE_WEAKJACK
|
|
#include <jack/jack.h>
|
|
#else
|
|
#include <weak_libjack.h>
|
|
#endif
|
|
|
|
#include <atomic>
|
|
#include <vector>
|
|
#ifdef AUDIO_BUS_HANDLE_SUPPORT
|
|
#include <QMap>
|
|
#endif
|
|
|
|
#include "AudioDevice.h"
|
|
#include "AudioDeviceSetupWidget.h"
|
|
#ifdef AUDIO_BUS_HANDLE_SUPPORT
|
|
#include "AudioBusHandle.h"
|
|
#endif
|
|
|
|
class QLineEdit;
|
|
class QMenu;
|
|
class QToolButton;
|
|
|
|
namespace lmms
|
|
{
|
|
|
|
class MidiJack;
|
|
|
|
|
|
class AudioJack : public QObject, public AudioDevice
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
AudioJack(bool& successful, AudioEngine* audioEngine);
|
|
~AudioJack() override;
|
|
|
|
// this is to allow the jack midi connection to use the same jack client connection
|
|
// the jack callback is handled here, we call the midi client so that it can read
|
|
// it's midi data during the callback
|
|
AudioJack* addMidiClient(MidiJack* midiClient);
|
|
void removeMidiClient() { m_midiClient = nullptr; }
|
|
jack_client_t* jackClient() { return m_client; };
|
|
|
|
inline static QString name()
|
|
{
|
|
return QT_TRANSLATE_NOOP("AudioDeviceSetupWidget", "JACK (JACK Audio Connection Kit)");
|
|
}
|
|
|
|
class setupWidget : public gui::AudioDeviceSetupWidget
|
|
{
|
|
public:
|
|
setupWidget(QWidget* parent);
|
|
void saveSettings() override;
|
|
|
|
private:
|
|
std::vector<std::string> getAudioPortNames(JackPortFlags portFlags) const;
|
|
std::vector<std::string> getAudioInputNames() const;
|
|
std::vector<std::string> getAudioOutputNames() const;
|
|
static QMenu* buildMenu(QToolButton* toolButton, const std::vector<std::string>& names, const QString& filteredLMMSClientName);
|
|
|
|
private:
|
|
QLineEdit* m_clientName;
|
|
// Because we do not have access to a JackAudio driver instance we have to be our own client to display inputs and outputs...
|
|
jack_client_t* m_client;
|
|
|
|
std::vector<QToolButton*> m_outputDevices;
|
|
std::vector<QToolButton*> m_inputDevices;
|
|
};
|
|
|
|
private slots:
|
|
void restartAfterZombified();
|
|
|
|
private:
|
|
bool initJackClient();
|
|
void resizeInputBuffer(jack_nframes_t nframes);
|
|
|
|
void attemptToConnect(size_t index, const char *lmms_port_type, const char *source_port, const char *destination_port);
|
|
void attemptToReconnectOutput(size_t outputIndex, const QString& targetPort);
|
|
void attemptToReconnectInput(size_t inputIndex, const QString& sourcePort);
|
|
|
|
void startProcessing() override;
|
|
void stopProcessing() override;
|
|
|
|
void registerPort(AudioBusHandle* port) override;
|
|
void unregisterPort(AudioBusHandle* port) override;
|
|
void renamePort(AudioBusHandle* port) override;
|
|
|
|
int processCallback(jack_nframes_t nframes);
|
|
|
|
static int staticProcessCallback(jack_nframes_t nframes, void* udata);
|
|
static void shutdownCallback(void* _udata);
|
|
|
|
jack_client_t* m_client;
|
|
|
|
bool m_active;
|
|
std::atomic<bool> m_stopped;
|
|
|
|
std::atomic<MidiJack*> m_midiClient;
|
|
std::vector<jack_port_t*> m_outputPorts;
|
|
std::vector<jack_port_t*> m_inputPorts;
|
|
jack_default_audio_sample_t** m_tempOutBufs;
|
|
std::vector<SampleFrame> m_inputFrameBuffer;
|
|
SampleFrame* m_outBuf;
|
|
|
|
f_cnt_t m_framesDoneInCurBuf;
|
|
f_cnt_t m_framesToDoInCurBuf;
|
|
|
|
#ifdef AUDIO_BUS_HANDLE_SUPPORT
|
|
struct StereoPort
|
|
{
|
|
jack_port_t* ports[2];
|
|
};
|
|
|
|
using JackPortMap = QMap<AudioBusHandle*, StereoPort>;
|
|
JackPortMap m_portMap;
|
|
#endif
|
|
|
|
signals:
|
|
void zombified();
|
|
};
|
|
|
|
} // namespace lmms
|
|
|
|
#endif // LMMS_HAVE_JACK
|
|
|
|
#endif // LMMS_AUDIO_JACK_H
|