CoreActionController.cpp

Go to the documentation of this file.

/*
 * Hydrogen
 * Copyright(c) 2002-2008 by Alex >Comix< Cominu [comix@users.sourceforge.net]
 * Copyright(c) 2008-2024 The hydrogen development team [hydrogen-devel@lists.sourceforge.net]
 *
 * http://www.hydrogen-music.org
 *
 * 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, see https://www.gnu.org/licenses
 *
 */
 
#include <core/AudioEngine/AudioEngine.h>
#include <core/AudioEngine/TransportPosition.h>
#include <core/CoreActionController.h>
#include <core/EventQueue.h>
#include <core/Hydrogen.h>
#include <core/Preferences/Preferences.h>
#include <core/Basics/InstrumentList.h>
#include <core/Basics/Instrument.h>
#include <core/Basics/PatternList.h>
#include <core/Basics/Pattern.h>
#include "core/OscServer.h"
#include <core/MidiAction.h>
#include "core/MidiMap.h"
#include <core/Helpers/Xml.h>
#include <core/SoundLibrary/SoundLibraryDatabase.h>
 
#include <core/IO/AlsaMidiDriver.h>
#include <core/IO/MidiOutput.h>
#include <core/IO/JackAudioDriver.h>
 
#ifdef H2CORE_HAVE_OSC
#include <core/NsmClient.h>
#endif
 
namespace H2Core
{
 
 
CoreActionController::CoreActionController() : m_nDefaultMidiFeedbackChannel(0)
{
        //nothing
}
 
CoreActionController::~CoreActionController() {
        //nothing
}
 
bool CoreActionController::setMasterVolume( float fMasterVolumeValue )
{
        auto pSong = Hydrogen::get_instance()->getSong();
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        pSong->setVolume( fMasterVolumeValue );
        
        return sendMasterVolumeFeedback();
}
 
bool CoreActionController::setStripVolume( int nStrip, float fVolumeValue, bool bSelectStrip )
{
        auto pHydrogen = Hydrogen::get_instance();
        
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
        
                pInstr->set_volume( fVolumeValue );
        
                if ( bSelectStrip ) {
                        pHydrogen->setSelectedInstrumentNumber( nStrip );
                }
        
                pHydrogen->setIsModified( true );
 
                return sendStripVolumeFeedback( nStrip );
        }
 
        return false;
}
 
bool CoreActionController::setMetronomeIsActive( bool isActive )
{
        Preferences::get_instance()->m_bUseMetronome = isActive;
 
        return sendMetronomeIsActiveFeedback();
}
 
bool CoreActionController::setMasterIsMuted( bool bIsMuted )
{
        auto pHydrogen = Hydrogen::get_instance();
        auto pSong = pHydrogen->getSong();
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        pSong->setIsMuted( bIsMuted );
        
        pHydrogen->setIsModified( true );
 
        return sendMasterIsMutedFeedback();
}
 
bool CoreActionController::toggleStripIsMuted( int nStrip )
{
        auto pInstr = getStrip( nStrip );
        if ( pInstr == nullptr ) {
                return false;
        }
        
        return setStripIsMuted( nStrip, !pInstr->is_muted() );
}
 
bool CoreActionController::setStripIsMuted( int nStrip, bool bIsMuted )
{
        auto pHydrogen = Hydrogen::get_instance();
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
                pInstr->set_muted( bIsMuted );
 
                EventQueue::get_instance()->push_event( EVENT_INSTRUMENT_PARAMETERS_CHANGED, nStrip );
        
                pHydrogen->setIsModified( true );
 
                return sendStripIsMutedFeedback( nStrip );
        }
 
        return false;
}
 
bool CoreActionController::toggleStripIsSoloed( int nStrip )
{
        auto pInstr = getStrip( nStrip );
        if ( pInstr == nullptr ) {
                return false;
        }
        
        return setStripIsSoloed( nStrip, !pInstr->is_soloed() );
}
 
bool CoreActionController::setStripIsSoloed( int nStrip, bool isSoloed )
{
        auto pHydrogen = Hydrogen::get_instance();
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
        
                pInstr->set_soloed( isSoloed );
 
                EventQueue::get_instance()->push_event( EVENT_INSTRUMENT_PARAMETERS_CHANGED, nStrip );
        
                pHydrogen->setIsModified( true );
 
                return sendStripIsSoloedFeedback( nStrip );
        }
 
        return false;
}
 
bool CoreActionController::setStripPan( int nStrip, float fValue, bool bSelectStrip )
{
        auto pHydrogen = Hydrogen::get_instance();
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
        
                pInstr->setPanWithRangeFrom0To1( fValue );
                
                EventQueue::get_instance()->push_event( EVENT_INSTRUMENT_PARAMETERS_CHANGED, nStrip );
                
                pHydrogen->setIsModified( true );
                
                if ( bSelectStrip ) {
                        pHydrogen->setSelectedInstrumentNumber( nStrip );
                }
 
                return sendStripPanFeedback( nStrip );
        }
 
        return false;
}
 
 
bool CoreActionController::setStripPanSym( int nStrip, float fValue, bool bSelectStrip )
{
        auto pHydrogen = Hydrogen::get_instance();
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
        
                pInstr->setPan( fValue );
                
                EventQueue::get_instance()->push_event( EVENT_INSTRUMENT_PARAMETERS_CHANGED, nStrip );
                
                pHydrogen->setIsModified( true );
                
                if ( bSelectStrip ) {
                        pHydrogen->setSelectedInstrumentNumber( nStrip );
                }
 
                return sendStripPanFeedback( nStrip );
        }
 
        return false;
}
 
bool CoreActionController::sendMasterVolumeFeedback() {
        auto pSong = Hydrogen::get_instance()->getSong();
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
                
        float fMasterVolume = pSong->getVolume();
        
#ifdef H2CORE_HAVE_OSC
        if ( Preferences::get_instance()->getOscFeedbackEnabled() ) {
                
                std::shared_ptr<Action> pFeedbackAction =
                        std::make_shared<Action>( "MASTER_VOLUME_ABSOLUTE" );
                
                pFeedbackAction->setValue( QString("%1")
                                                                   .arg( fMasterVolume ) );
                OscServer::get_instance()->handleAction( pFeedbackAction );
        }
#endif
        
        MidiMap* pMidiMap = MidiMap::get_instance();
        
        auto ccParamValues = pMidiMap->findCCValuesByActionType( QString("MASTER_VOLUME_ABSOLUTE"));
        
        return handleOutgoingControlChanges( ccParamValues, (fMasterVolume / 1.5) * 127 );
}
 
bool CoreActionController::sendStripVolumeFeedback( int nStrip ) {
 
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
 
                float fStripVolume = pInstr->get_volume();
                
#ifdef H2CORE_HAVE_OSC
                if ( Preferences::get_instance()->getOscFeedbackEnabled() ) {
                
                        std::shared_ptr<Action> pFeedbackAction =
                                std::make_shared<Action>( "STRIP_VOLUME_ABSOLUTE" );
                
                        pFeedbackAction->setParameter1( QString("%1").arg( nStrip + 1 ) );
                        pFeedbackAction->setValue( QString("%1").arg( fStripVolume ) );
                        OscServer::get_instance()->handleAction( pFeedbackAction );
                }
#endif
 
                MidiMap* pMidiMap = MidiMap::get_instance();
        
                auto ccParamValues = pMidiMap->findCCValuesByActionParam1( QString("STRIP_VOLUME_ABSOLUTE"),
                                                                                                                                   QString("%1").arg( nStrip ) );
        
                return handleOutgoingControlChanges( ccParamValues, (fStripVolume / 1.5) * 127 );
        }
        
        return false;
}
 
bool CoreActionController::sendMetronomeIsActiveFeedback() {
        auto pPref = Preferences::get_instance();
        
#ifdef H2CORE_HAVE_OSC
        if ( pPref->getOscFeedbackEnabled() ) {
                std::shared_ptr<Action> pFeedbackAction =
                        std::make_shared<Action>( "TOGGLE_METRONOME" );
                
                pFeedbackAction->setParameter1( QString("%1")
                                                                                .arg( static_cast<int>(pPref->m_bUseMetronome) ) );
                OscServer::get_instance()->handleAction( pFeedbackAction );
        }
#endif
        
        MidiMap* pMidiMap = MidiMap::get_instance();
        
        auto ccParamValues = pMidiMap->findCCValuesByActionType( QString("TOGGLE_METRONOME"));
        
        return handleOutgoingControlChanges( ccParamValues,
                                                                                 static_cast<int>(pPref->m_bUseMetronome) * 127 );
}
 
bool CoreActionController::sendMasterIsMutedFeedback() {
        auto pSong = Hydrogen::get_instance()->getSong();
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
#ifdef H2CORE_HAVE_OSC
        if ( Preferences::get_instance()->getOscFeedbackEnabled() ) {
                std::shared_ptr<Action> pFeedbackAction =
                        std::make_shared<Action>( "MUTE_TOGGLE" );
                
                pFeedbackAction->setParameter1( QString("%1")
                                                                                .arg( static_cast<int>(pSong->getIsMuted()) ) );
                OscServer::get_instance()->handleAction( pFeedbackAction );
        }
#endif
 
        MidiMap*        pMidiMap = MidiMap::get_instance();
        
        auto ccParamValues = pMidiMap->findCCValuesByActionType( QString("MUTE_TOGGLE") );
 
        return handleOutgoingControlChanges( ccParamValues,
                                                                                 static_cast<int>(pSong->getIsMuted()) * 127 );
}
 
bool CoreActionController::sendStripIsMutedFeedback( int nStrip ) {
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
        
#ifdef H2CORE_HAVE_OSC
                if ( Preferences::get_instance()->getOscFeedbackEnabled() ) {
                        std::shared_ptr<Action> pFeedbackAction =
                                std::make_shared<Action>( "STRIP_MUTE_TOGGLE" );
                
                        pFeedbackAction->setParameter1( QString("%1").arg( nStrip + 1 ) );
                        pFeedbackAction->setValue( QString("%1")
                                                                                        .arg( static_cast<int>(pInstr->is_muted()) ) );
                        OscServer::get_instance()->handleAction( pFeedbackAction );
                }
#endif
 
                MidiMap* pMidiMap = MidiMap::get_instance();
        
                auto ccParamValues = pMidiMap->findCCValuesByActionParam1( QString("STRIP_MUTE_TOGGLE"),
                                                                                                                                   QString("%1").arg( nStrip ) );
        
                return handleOutgoingControlChanges( ccParamValues,
                                                                                         static_cast<int>(pInstr->is_muted()) * 127 );
        }
        
        return false;
}
 
bool CoreActionController::sendStripIsSoloedFeedback( int nStrip ) {
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
        
#ifdef H2CORE_HAVE_OSC
                if ( Preferences::get_instance()->getOscFeedbackEnabled() ) {
                        std::shared_ptr<Action> pFeedbackAction =
                                std::make_shared<Action>( "STRIP_SOLO_TOGGLE" );
                
                        pFeedbackAction->setParameter1( QString("%1").arg( nStrip + 1 ) );
                        pFeedbackAction->setValue( QString("%1")
                                                                           .arg( static_cast<int>(pInstr->is_soloed()) ) );
                        OscServer::get_instance()->handleAction( pFeedbackAction );
                }
#endif
 
                MidiMap* pMidiMap = MidiMap::get_instance();
                auto ccParamValues = pMidiMap->findCCValuesByActionParam1( QString("STRIP_SOLO_TOGGLE"),
                                                                                                                                   QString("%1").arg( nStrip ) );
        
                return handleOutgoingControlChanges( ccParamValues,
                                                                                         static_cast<int>(pInstr->is_soloed()) * 127 );
        }
 
        return false;
}
 
bool CoreActionController::sendStripPanFeedback( int nStrip ) {
        auto pInstr = getStrip( nStrip );
        if ( pInstr != nullptr ) {
 
#ifdef H2CORE_HAVE_OSC
                if ( Preferences::get_instance()->getOscFeedbackEnabled() ) {
                        std::shared_ptr<Action> pFeedbackAction =
                                std::make_shared<Action>( "PAN_ABSOLUTE" );
                
                        pFeedbackAction->setParameter1( QString("%1").arg( nStrip + 1 ) );
                        pFeedbackAction->setValue( QString("%1")
                                                                           .arg( pInstr->getPanWithRangeFrom0To1() ) );
                        OscServer::get_instance()->handleAction( pFeedbackAction );
                }
#endif
        
                MidiMap* pMidiMap = MidiMap::get_instance();
                auto ccParamValues = pMidiMap->findCCValuesByActionParam1( QString("PAN_ABSOLUTE"),
                                                                                                                                   QString("%1").arg( nStrip ) );
 
                return handleOutgoingControlChanges( ccParamValues,
                                                                                         pInstr->getPanWithRangeFrom0To1() * 127 );
        }
 
        return false;
}
 
bool CoreActionController::handleOutgoingControlChanges( std::vector<int> params, int nValue)
{
        Preferences *pPref = Preferences::get_instance();
        Hydrogen *pHydrogen = Hydrogen::get_instance();
        MidiOutput *pMidiDriver = pHydrogen->getMidiOutput();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        for ( auto param : params ) {
                if ( pMidiDriver != nullptr &&
                         pPref->m_bEnableMidiFeedback && param >= 0 ){
                        pMidiDriver->handleOutgoingControlChange( param, nValue, m_nDefaultMidiFeedbackChannel );
                }
        }
 
        return true;
}
 
std::shared_ptr<Instrument> CoreActionController::getStrip( int nStrip ) const {
        auto pSong = Hydrogen::get_instance()->getSong();
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return nullptr;
        }
 
        auto pInstr = pSong->getInstrumentList()->get( nStrip );
        if ( pInstr == nullptr ) {
                ERRORLOG( QString( "Couldn't find instrument [%1]" ).arg( nStrip ) );
        }
 
        return pInstr;
}
 
bool CoreActionController::initExternalControlInterfaces()
{
        /*
         * Push the current state of Hydrogen to the attached control interfaces (e.g. OSC clients)
         */
        
        //MASTER_VOLUME_ABSOLUTE
        auto pHydrogen = Hydrogen::get_instance();
        auto pSong = pHydrogen->getSong();
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        sendMasterVolumeFeedback();
        
        //PER-INSTRUMENT/STRIP STATES
        auto pInstrList = pSong->getInstrumentList();
        for ( int ii = 0; ii < pInstrList->size(); ii++){
                auto pInstr = pInstrList->get( ii );
                if ( pInstr != nullptr ) {
                
                        //STRIP_VOLUME_ABSOLUTE
                        sendStripVolumeFeedback( ii );
 
                        //PAN_ABSOLUTE
                        sendStripPanFeedback( ii );
                        
                        //STRIP_MUTE_TOGGLE
                        sendStripIsMutedFeedback( ii );
                        
                        //SOLO
                        sendStripIsSoloedFeedback( ii );
                }
        }
        
        //TOGGLE_METRONOME
        sendMetronomeIsActiveFeedback();
        
        //MUTE_TOGGLE
        sendMasterIsMutedFeedback();
        
        return true;
}
 
 
bool CoreActionController::newSong( const QString& sSongPath ) {
        
        auto pHydrogen = Hydrogen::get_instance();
 
        if ( pHydrogen->getAudioEngine()->getState() == AudioEngine::State::Playing ) {
                // Stops recording, all queued MIDI notes, and the playback of
                // the audio driver.
                pHydrogen->sequencer_stop();
        }
        
        // Create an empty Song.
        auto pSong = Song::getEmptySong();
        
        // Check whether the provided path is valid.
        if ( !Filesystem::isSongPathValid( sSongPath ) ) {
                // Filesystem::isSongPathValid takes care of the error log message.
 
                return false;
        }
 
        if ( pHydrogen->isUnderSessionManagement() ) {
                pHydrogen->restartDrivers();
                // The drumkit of the new song will linked into the session
                // folder during the next song save.
                pHydrogen->setSessionDrumkitNeedsRelinking( true );
        }
 
        pSong->setFilename( sSongPath );
 
        pHydrogen->setSong( pSong );
        
        if ( pHydrogen->getGUIState() != Hydrogen::GUIState::unavailable ) {
                EventQueue::get_instance()->push_event( EVENT_UPDATE_SONG, 0 );
        }
        
        return true;
}
 
bool CoreActionController::openSong( const QString& sSongPath, const QString& sRecoverSongPath ) {
        auto pHydrogen = Hydrogen::get_instance();
 
        if ( pHydrogen->getAudioEngine()->getState() == AudioEngine::State::Playing ) {
                // Stops recording, all queued MIDI notes, and the playback of
                // the audio driver.
                pHydrogen->sequencer_stop();
        }
        
        // Check whether the provided path is valid.
        if ( !Filesystem::isSongPathValid( sSongPath, true ) ) {
                // Filesystem::isSongPathValid takes care of the error log message.
                return false;
        }
 
        std::shared_ptr<Song> pSong;
        if ( ! sRecoverSongPath.isEmpty() ) {
                // Use an autosave file to load the song
                pSong = Song::load( sRecoverSongPath );
                if ( pSong != nullptr ) {
                        pSong->setFilename( sSongPath );
                }
        } else {
                pSong = Song::load( sSongPath );
        }
 
        if ( pSong == nullptr ) {
                ERRORLOG( QString( "Unable to open song [%1]." )
                                  .arg( sSongPath ) );
                return false;
        }
        
        return setSong( pSong );
}
 
bool CoreActionController::openSong( std::shared_ptr<Song> pSong, bool bRelinking ) {
        
        auto pHydrogen = Hydrogen::get_instance();
 
        if ( pHydrogen->getAudioEngine()->getState() == AudioEngine::State::Playing ) {
                // Stops recording, all queued MIDI notes, and the playback of
                // the audio driver.
                pHydrogen->sequencer_stop();
        }
        
        if ( pSong == nullptr ) {
                ERRORLOG( QString( "Unable to open song." ) );
                return false;
        }
 
        return setSong( pSong, bRelinking );
}
 
bool CoreActionController::setSong( std::shared_ptr<Song> pSong, bool bRelinking ) {
 
        auto pHydrogen = Hydrogen::get_instance();
 
        // Update the Song.
        pHydrogen->setSong( pSong, bRelinking );
                
        if ( pHydrogen->isUnderSessionManagement() ) {
                pHydrogen->restartDrivers();
        } else if ( pSong->getFilename() != Filesystem::empty_song_path() ) {
                // Add the new loaded song in the "last used song" vector.
                // This behavior is prohibited under session management. Only
                // songs open during normal runs will be listed. In addition,
                // empty songs - created and set when hitting "New Song" in
                // the main menu - aren't listed either.
                insertRecentFile( pSong->getFilename() );
                Preferences::get_instance()->setLastSongFilename( pSong->getFilename() );
        }
                
        if ( pHydrogen->getGUIState() != Hydrogen::GUIState::unavailable ) {
                EventQueue::get_instance()->push_event( EVENT_UPDATE_SONG, 0 );
        }
 
        // As we just set a fresh song, we can mark it not modified
        pHydrogen->setIsModified( false );
        
        return true;
}
 
bool CoreActionController::saveSong() {
        
        auto pHydrogen = Hydrogen::get_instance();
        auto pSong = pHydrogen->getSong();
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        // Extract the path to the associate .h2song file.
        QString sSongPath = pSong->getFilename();
        
        if ( sSongPath.isEmpty() ) {
                ERRORLOG( "Unable to save song. Empty filename!" );
                return false;
        }
 
#ifdef H2CORE_HAVE_OSC
        if ( pHydrogen->isUnderSessionManagement() &&
                 pHydrogen->getSessionDrumkitNeedsRelinking() &&
                 ! pHydrogen->getSessionIsExported() ) {
 
                NsmClient::linkDrumkit( pSong );
 
                // Properly set in NsmClient::linkDrumkit()
                QString sSessionDrumkitPath = pSong->getLastLoadedDrumkitPath();
 
                auto drumkitDatabase = pHydrogen->getSoundLibraryDatabase()->getDrumkitDatabase();
                if ( drumkitDatabase.find( sSessionDrumkitPath ) != drumkitDatabase.end() ) {
                        // In case the session folder is already present in the
                        // SoundLibraryDatabase, we have to update it (takes a
                        // while) to ensure it's clean and all kits are valid. If
                        // it's not present, we can skip it because loading is
                        // done lazily.
                        pHydrogen->getSoundLibraryDatabase()->updateDrumkit( sSessionDrumkitPath );
                }
        }
#endif
        
        // Actual saving
        bool bSaved = pSong->save( sSongPath );
        if ( ! bSaved ) {
                ERRORLOG( QString( "Current song [%1] could not be saved!" )
                                  .arg( sSongPath ) );
                return false;
        }
        
        // Update the status bar.
        if ( pHydrogen->getGUIState() != Hydrogen::GUIState::unavailable ) {
                EventQueue::get_instance()->push_event( EVENT_UPDATE_SONG, 1 );
        }
        
        return true;
}
 
bool CoreActionController::saveSongAs( const QString& sNewFilename ) {
        
        auto pHydrogen = Hydrogen::get_instance();
        auto pSong = pHydrogen->getSong();
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        // Check whether the provided path is valid.
        if ( !Filesystem::isSongPathValid( sNewFilename ) ) {
                // Filesystem::isSongPathValid takes care of the error log message.
                return false;
        }
 
        QString sPreviousFilename( pSong->getFilename() );
        pSong->setFilename( sNewFilename );
        
        // Actual saving
        if ( ! saveSong() ) {
                return false;
        }
 
        // Update the recentFiles list by replacing the former file name
        // with the new one.
        insertRecentFile( sNewFilename );
        if ( ! pHydrogen->isUnderSessionManagement() ) {
                Preferences::get_instance()->setLastSongFilename( pSong->getFilename() );
        }
        
        return true;
}
 
bool CoreActionController::savePreferences() {
        
        if ( Hydrogen::get_instance()->getGUIState() != Hydrogen::GUIState::unavailable ) {
                // Update the status bar and let the GUI save the preferences
                // (after writing its current settings to disk).
                EventQueue::get_instance()->push_event( EVENT_UPDATE_PREFERENCES, 0 );
                return true;
        }
        
        return Preferences::get_instance()->savePreferences();
}
bool CoreActionController::quit() {
 
        if ( Hydrogen::get_instance()->getGUIState() != Hydrogen::GUIState::unavailable ) {
                EventQueue::get_instance()->push_event( EVENT_QUIT, 0 );
        } else {
                // TODO: Close Hydrogen with no GUI present.
                
                ERRORLOG( QString( "Error: Closing the application via the core part is not supported yet!" ) );
                return false;
                
        }
        
        return true;
}
 
bool CoreActionController::activateTimeline( bool bActivate ) {
        auto pHydrogen = Hydrogen::get_instance();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        pHydrogen->setIsTimelineActivated( bActivate );
        
        if ( pHydrogen->getJackTimebaseState() == JackAudioDriver::Timebase::Slave ) {
                WARNINGLOG( QString( "Timeline usage was [%1] in the Preferences. But these changes won't have an effect as long as there is still an external JACK timebase master." )
                                        .arg( bActivate ? "enabled" : "disabled" ) );
        } else if ( pHydrogen->getMode() == Song::Mode::Pattern ) {
                WARNINGLOG( QString( "Timeline usage was [%1] in the Preferences. But these changes won't have an effect as long as Pattern Mode is still activated." )
                                        .arg( bActivate ? "enabled" : "disabled" ) );
        }
        
        return true;
}
 
bool CoreActionController::addTempoMarker( int nPosition, float fBpm ) {
        auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
        auto pTimeline = pHydrogen->getTimeline();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        pAudioEngine->lock( RIGHT_HERE );
 
        pTimeline->deleteTempoMarker( nPosition );
        pTimeline->addTempoMarker( nPosition, fBpm );
        pHydrogen->getAudioEngine()->handleTimelineChange();
 
        pAudioEngine->unlock();
 
        pHydrogen->setIsModified( true );
 
        EventQueue::get_instance()->push_event( EVENT_TIMELINE_UPDATE, 0 );
 
        return true;
}
 
bool CoreActionController::deleteTempoMarker( int nPosition ) {
        auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
        
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        pAudioEngine->lock( RIGHT_HERE );
        
        pHydrogen->getTimeline()->deleteTempoMarker( nPosition );
        pHydrogen->getAudioEngine()->handleTimelineChange();
 
        pAudioEngine->unlock();
        
        pHydrogen->setIsModified( true );
        EventQueue::get_instance()->push_event( EVENT_TIMELINE_UPDATE, 0 );
 
        return true;
}
 
bool CoreActionController::addTag( int nPosition, const QString& sText ) {
        auto pHydrogen = Hydrogen::get_instance();
        auto pTimeline = pHydrogen->getTimeline();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        pTimeline->deleteTag( nPosition );
        pTimeline->addTag( nPosition, sText );
 
        pHydrogen->setIsModified( true );
 
        EventQueue::get_instance()->push_event( EVENT_TIMELINE_UPDATE, 0 );
 
        return true;
}
 
bool CoreActionController::deleteTag( int nPosition ) {
        auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
        
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        pHydrogen->getTimeline()->deleteTag( nPosition );
        
        pHydrogen->setIsModified( true );
        EventQueue::get_instance()->push_event( EVENT_TIMELINE_UPDATE, 0 );
 
        return true;
}
 
bool CoreActionController::activateJackTransport( bool bActivate ) {
        
#ifdef H2CORE_HAVE_JACK
        if ( !Hydrogen::get_instance()->hasJackAudioDriver() ) {
                ERRORLOG( "Unable to (de)activate Jack transport. Please select the Jack driver first." );
                return false;
        }
        
        Hydrogen::get_instance()->getAudioEngine()->lock( RIGHT_HERE );
        if ( bActivate ) {
                Preferences::get_instance()->m_bJackTransportMode = Preferences::USE_JACK_TRANSPORT;
        } else {
                Preferences::get_instance()->m_bJackTransportMode = Preferences::NO_JACK_TRANSPORT;
        }
        Hydrogen::get_instance()->getAudioEngine()->unlock();
        
        EventQueue::get_instance()->push_event( EVENT_JACK_TRANSPORT_ACTIVATION, static_cast<int>( bActivate ) );
        
        return true;
#else
        ERRORLOG( "Unable to (de)activate Jack transport. Your Hydrogen version was not compiled with jack support." );
        return false;
#endif
}
 
bool CoreActionController::activateJackTimebaseMaster( bool bActivate ) {
        auto pHydrogen = Hydrogen::get_instance();
        
#ifdef H2CORE_HAVE_JACK
        if ( !pHydrogen->hasJackAudioDriver() ) {
                ERRORLOG( "Unable to (de)activate Jack timebase master. Please select the Jack driver first." );
                return false;
        }
        
        pHydrogen->getAudioEngine()->lock( RIGHT_HERE );
        if ( bActivate ) {
                Preferences::get_instance()->m_bJackMasterMode = Preferences::USE_JACK_TIME_MASTER;
                pHydrogen->onJackMaster();
        } else {
                Preferences::get_instance()->m_bJackMasterMode = Preferences::NO_JACK_TIME_MASTER;
                pHydrogen->offJackMaster();
        }
        pHydrogen->getAudioEngine()->unlock();
        
        EventQueue::get_instance()->push_event( EVENT_JACK_TIMEBASE_STATE_CHANGED,
                                                                                        static_cast<int>(pHydrogen->getJackTimebaseState()) );
        
        return true;
#else
        ERRORLOG( "Unable to (de)activate Jack timebase master. Your Hydrogen version was not compiled with jack support." );
        return false;
#endif
}
 
bool CoreActionController::activateSongMode( bool bActivate ) {
 
        auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
        auto pSong = pHydrogen->getSong();
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        if ( !( bActivate && pHydrogen->getMode() != Song::Mode::Song ) &&
                 ! ( ! bActivate && pHydrogen->getMode() != Song::Mode::Pattern ) ) {
                // No changes.
                return true;
        }               
        
        pHydrogen->sequencer_stop();
 
        pAudioEngine->lock( RIGHT_HERE );
 
        if ( bActivate && pHydrogen->getMode() != Song::Mode::Song ) {
                pHydrogen->setMode( Song::Mode::Song );
        }
        else if ( ! bActivate && pHydrogen->getMode() != Song::Mode::Pattern ) {
                pHydrogen->setMode( Song::Mode::Pattern );
        }
        
        pAudioEngine->handleSongModeChanged();
 
        pAudioEngine->unlock();
        
        return true;
}
 
bool CoreActionController::activateLoopMode( bool bActivate ) {
 
        auto pHydrogen = Hydrogen::get_instance();
        auto pSong = pHydrogen->getSong();
        auto pAudioEngine = pHydrogen->getAudioEngine();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
 
        bool bChange = false;
 
        if ( bActivate &&
                 pSong->getLoopMode() != Song::LoopMode::Enabled ) {
                pSong->setLoopMode( Song::LoopMode::Enabled );
                bChange = true;
                
        } else if ( ! bActivate &&
                                pSong->getLoopMode() == Song::LoopMode::Enabled ) {
                // If the transport was already looped at least once, disabling
                // loop mode will result in immediate stop. Instead, we want to
                // stop transport at the end of the song.
                if ( pSong->lengthInTicks() <
                         pAudioEngine->getTransportPosition()->getTick() ) {
                        pSong->setLoopMode( Song::LoopMode::Finishing );
                } else {
                        pSong->setLoopMode( Song::LoopMode::Disabled );
                }
                bChange = true;
        }
 
        pAudioEngine->lock( RIGHT_HERE );
        pAudioEngine->handleLoopModeChanged();
        pAudioEngine->unlock();
        
        if ( bChange ) {
                EventQueue::get_instance()->push_event( EVENT_LOOP_MODE_ACTIVATION,
                                                                                                static_cast<int>( bActivate ) );
        }
        
        return true;
}
 
bool CoreActionController::setDrumkit( const QString& sDrumkit, bool bConditional ) {
 
        auto pDrumkit = Hydrogen::get_instance()->getSoundLibraryDatabase()
                ->getDrumkit( sDrumkit );
        if ( pDrumkit == nullptr ) {
                ERRORLOG( QString( "Drumkit [%1] could not be loaded." )
                                  .arg( sDrumkit ) );
                return false;
        }
 
        return setDrumkit( pDrumkit, bConditional );
}
 
bool CoreActionController::setDrumkit( std::shared_ptr<Drumkit> pDrumkit, bool bConditional ) {
        if ( pDrumkit != nullptr ) {
 
                auto pHydrogen = Hydrogen::get_instance();
                auto pSong = pHydrogen->getSong();
                if ( pSong != nullptr ) {
 
                        INFOLOG( QString( "Setting drumkit [%1] located at [%2]" )
                                         .arg( pDrumkit->get_name() )
                                         .arg( pDrumkit->get_path() ) );
 
                        pHydrogen->getAudioEngine()->lock( RIGHT_HERE );
                
                        pSong->setDrumkit( pDrumkit, bConditional );
                        
                        if ( pHydrogen->getSelectedInstrumentNumber() >=
                                 pSong->getInstrumentList()->size() ) {
                                pHydrogen->setSelectedInstrumentNumber(
                                        std::max( 0, pSong->getInstrumentList()->size() -1 ),
                                        false );
                        }
 
                        pHydrogen->renameJackPorts( pSong );
                        
                        pHydrogen->getAudioEngine()->unlock();
        
                        initExternalControlInterfaces();
 
                        pHydrogen->setIsModified( true );
        
                        // Create a symbolic link in the session folder when under session
                        // management.
                        if ( pHydrogen->isUnderSessionManagement() ) {
                                pHydrogen->setSessionDrumkitNeedsRelinking( true );
                        }
 
                        EventQueue::get_instance()->push_event( EVENT_DRUMKIT_LOADED, 0 );
                }
                else {
                        ERRORLOG( "No song set yet" );
                        return false;
                }
        }
        else {
                ERRORLOG( "Provided Drumkit is not valid" );
                return false;
        }
 
        return true;
}
 
bool CoreActionController::upgradeDrumkit( const QString& sDrumkitPath, const QString& sNewPath ) {
 
        if ( sNewPath.isEmpty() ) {
                INFOLOG( QString( "Upgrading kit at [%1] inplace." )
                                 .arg( sDrumkitPath ) );
        } else {
                INFOLOG( QString( "Upgrading kit at [%1] into [%2]." )
                                 .arg( sDrumkitPath ).arg( sNewPath ) );
        }
 
        QFileInfo sourceFileInfo( sDrumkitPath );
        if ( ! sNewPath.isEmpty() ) {
                // Check whether there is already a file or directory
                // present. The latter has to be writable. If none is present,
                // create a folder.
                if ( ! Filesystem::path_usable( sNewPath, true, false ) ) {
                        return false;
                }
        } else {
                // We have to assure that the source folder is not just
                // readable since an inplace upgrade was requested
                if ( ! Filesystem::dir_writable( sourceFileInfo.dir().absolutePath(),
                                                                                 true ) ) {
                        ERRORLOG( QString( "Unable to upgrade drumkit [%1] in place: Folder is in read-only mode" )
                                          .arg( sDrumkitPath ) );
                        return false;
                }
        }
 
        QString sTemporaryFolder, sDrumkitDir;
        // Whether the drumkit was provided as compressed .h2drumkit file.
        bool bIsCompressed;
        auto pDrumkit = retrieveDrumkit( sDrumkitPath, &bIsCompressed,
                                                                         &sDrumkitDir, &sTemporaryFolder );
 
        if ( pDrumkit == nullptr ) {
                ERRORLOG( QString( "Unable to load drumkit from source path [%1]" )
                                  .arg( sDrumkitPath ) );
                return false;
        }
 
        // If the drumkit is not updated inplace, we also need to copy
        // all samples and metadata, like images.
        QString sPath;
        if ( ! sNewPath.isEmpty() ) {
 
                // When dealing with a compressed drumkit, we can just leave
                // it in the temporary folder and copy the compressed content
                // to the destination right away.
                if ( ! bIsCompressed ) {
                        // Copy content
                        QDir drumkitDir( sDrumkitDir );
                        for ( const auto& ssFile : drumkitDir.entryList( QDir::Files ) ) {
 
                                // We handle the drumkit file later
                                if ( ssFile.contains( ".xml" ) ) {
                                        continue;
                                }
                                Filesystem::file_copy( drumkitDir.absolutePath() + "/" + ssFile,
                                                                           sNewPath + "/" + ssFile, true, true );
                        }
                        sPath = sNewPath;
                } else {
                        sPath = sDrumkitDir;
                }
                
        } else {
                // Upgrade inplace.
 
                if ( ! bIsCompressed ) {
                        // Make a backup of the original file in order to make the
                        // upgrade reversible.
                        QString sBackupPath =
                                Filesystem::drumkit_backup_path( Filesystem::drumkit_file( sDrumkitDir ) );
                        if ( ! Filesystem::file_copy( Filesystem::drumkit_file( sDrumkitDir ),
                                                                                  sBackupPath, true, true ) ) {
                                ERRORLOG( QString( "Unable to backup source drumkit XML file from [%1] to [%2]. We abort instead of overwriting things." )
                                                  .arg( Filesystem::drumkit_file( sDrumkitDir ) )
                                                  .arg( sBackupPath ) );
                                return false;
                        }
                } else {
                        QString sBackupPath = Filesystem::drumkit_backup_path( sDrumkitPath );
                        if ( ! Filesystem::file_copy( sDrumkitPath, sBackupPath, true, true ) ) {
                                ERRORLOG( QString( "Unable to backup source .h2drumkit file from [%1] to [%2]. We abort instead of overwriting things." )
                                                  .arg( sDrumkitPath ).arg( sBackupPath ) );
                                return false;
                        }
                }
 
                sPath = sDrumkitDir;
        }
 
        if ( ! pDrumkit->save( sPath, -1, true, true ) ) {
                ERRORLOG( QString( "Error while saving upgraded kit to [%1]" )
                                  .arg( sPath ) );
                return false;
        }
 
        // Compress the updated drumkit again in order to provide the same
        // format handed over as input.
        if ( bIsCompressed ) {
                QString sExportPath;
                if ( ! sNewPath.isEmpty() ) {
                        sExportPath = sNewPath;
                } else {
                        sExportPath = sourceFileInfo.dir().absolutePath();
                }
                
                if ( ! pDrumkit->exportTo( sExportPath, "", true, false ) ) {
                        ERRORLOG( QString( "Unable to export upgrade drumkit to [%1]" )
                                          .arg( sExportPath ) );
                        return false;
                }
 
                INFOLOG( QString( "Upgraded drumkit exported as [%1]" )
                                 .arg( sExportPath + "/" + pDrumkit->get_name() +
                                           Filesystem::drumkit_ext ) );
        }
 
        // Upgrade was successful. Cleanup
        if ( ! sTemporaryFolder.isEmpty() ) {
                // Filesystem::rm( sTemporaryFolder, true, true );
        }
 
        INFOLOG( QString( "Drumkit [%1] successfully upgraded!" )
                         .arg( sDrumkitPath ) );
 
        return true;
}
 
bool CoreActionController::validateDrumkit( const QString& sDrumkitPath, bool bCheckLegacyVersions ) {
 
        INFOLOG( QString( "Validating kit [%1]" ).arg( sDrumkitPath ) );
 
        QString sTemporaryFolder, sDrumkitDir;
        // Whether the drumkit was provided as compressed .h2drumkit file.
        bool bIsCompressed;
        auto pDrumkit = retrieveDrumkit( sDrumkitPath, &bIsCompressed,
                                                                         &sDrumkitDir, &sTemporaryFolder );
 
        if ( pDrumkit == nullptr ) {
                ERRORLOG( QString( "Unable to load drumkit from source path [%1]" )
                                  .arg( sDrumkitPath ) );
                return false;
        }
 
        if ( ! Filesystem::drumkit_valid( sDrumkitDir ) ) {
                ERRORLOG( QString( "Something went wrong in the drumkit retrieval of [%1]. Unable to load from [%2]" )
                                  .arg( sDrumkitPath ).arg( sDrumkitDir ) );
                return false;
        }
 
        auto validateXSD = [&]( const QString& sXSDPath, const QString& sContext ) {
                
                XMLDoc doc;
                if ( !doc.read( Filesystem::drumkit_file( sDrumkitDir ),
                                                sXSDPath, true ) ) {
                        ERRORLOG( QString( "Drumkit file [%1] does not comply with [%2] XSD definition" )
                                          .arg( Filesystem::drumkit_file( sDrumkitDir ) )
                                          .arg( sContext ) );
                        return false;
                }
        
                XMLNode root = doc.firstChildElement( "drumkit_info" );
                if ( root.isNull() ) {
                        ERRORLOG( QString( "Drumkit file [%1] seems bricked: 'drumkit_info' node not found" )
                                          .arg( Filesystem::drumkit_file( sDrumkitDir ) ) );
                        return false;
                }
 
                INFOLOG( QString( "Drumkit file [%1] validates [%2] XSD definition" )
                                 .arg( Filesystem::drumkit_file( sDrumkitDir ) )
                                 .arg( sContext ) );
                
                return true;
        };
 
        bool bValid = validateXSD( Filesystem::drumkit_xsd_path(), "current" );
        if ( ! bValid && ! bCheckLegacyVersions ) {
                return false;
        }
 
        if ( ! bValid && bCheckLegacyVersions ) {
                const auto legacyXSDFiles = Filesystem::drumkit_xsd_legacy_paths();
 
                for ( const auto& sPath : legacyXSDFiles ) {
                        QString sContext( sPath );
                        sContext.remove( Filesystem::xsd_dir() );
                        sContext.remove( Filesystem::drumkit_xsd() );
 
                        if ( validateXSD( sPath, sContext ) ) {
                                bValid = true;
                                break;
                        }
                }
 
                if ( ! bValid ) {
                        return false;
                }
        }
 
        INFOLOG( QString( "Drumkit [%1] is valid!" )
                         .arg( sDrumkitPath ) );
        
        return true;
}
 
std::shared_ptr<Drumkit> CoreActionController::retrieveDrumkit( const QString& sDrumkitPath, bool* bIsCompressed, QString *sDrumkitDir, QString* sTemporaryFolder ) {
 
        std::shared_ptr<Drumkit> pDrumkit = nullptr;
 
        // We do not attempt to retrieve the drumkit from disk since this
        // function is intended to be used for validating or upgrading
        // drumkits via CLI or OSC command. It should always refer to the
        // latest copy found on disk.
 
        *bIsCompressed = false;
        *sTemporaryFolder = "";
        *sDrumkitDir = "";
 
        QFileInfo sourceFileInfo( sDrumkitPath );
 
        if ( Filesystem::dir_readable( sDrumkitPath, true ) ) {
 
                // Providing the folder containing the drumkit
                pDrumkit = Drumkit::load( sDrumkitPath, false, true );
                *sDrumkitDir = sDrumkitPath;
                
        } else if ( sourceFileInfo.fileName() == Filesystem::drumkit_xml() &&
                                Filesystem::file_readable( sDrumkitPath, true ) ) {
 
                // Providing the path of a drumkit.xml file within a drumkit
                // folder.
                QString sDrumkitDirPath = QFileInfo( sDrumkitPath ).absoluteDir().absolutePath();
                pDrumkit = Drumkit::load( sDrumkitDirPath, false, true );
                *sDrumkitDir = sourceFileInfo.dir().absolutePath();
                        
        } else if ( ( "." + sourceFileInfo.suffix() ) == Filesystem::drumkit_ext &&
                                Filesystem::file_readable( sDrumkitPath, true ) ) {
 
                *bIsCompressed = true;
                
                // Temporary folder used to extract a compressed drumkit (
                // .h2drumkit ).
                QString sTemplateName( Filesystem::tmp_dir() + "/" +
                                                           sourceFileInfo.baseName() + "_XXXXXX" );
                QTemporaryDir tmpDir( sTemplateName );
                tmpDir.setAutoRemove( false );
                if ( ! tmpDir.isValid() ) {
                        ERRORLOG( QString( "Unable to create temporary folder using template name [%1]" )
                                          .arg( sTemplateName ) );
                        return nullptr;
                }
                
                *sTemporaryFolder = tmpDir.path();
 
                // Providing the path to a compressed .h2drumkit file. It will
                // be extracted to a temporary folder and loaded from there.
                if ( ! Drumkit::install( sDrumkitPath, tmpDir.path(), true ) ) {
                        ERRORLOG( QString( "Unabled to extract provided drumkit [%1] into [%2]" )
                                          .arg( sDrumkitPath ).arg( tmpDir.path() ) );
                        return nullptr;
                }
 
                // INFOLOG( QString( "Extracting drumkit [%1] into [%2]" )
                //               .arg( sDrumkitPath ).arg( tmpDir.path() ) );
 
                // The extracted folder is expected to contain a single
                // directory named as the drumkit itself. But some kits
                // deviate from the latter condition. So, we just use the
                // former one.
                QDir extractedDir( tmpDir.path() );
                QStringList extractedContent =
                        extractedDir.entryList( QDir::AllEntries | QDir::NoDotAndDotDot );
                QStringList extractedFolders =
                        extractedDir.entryList( QDir::Dirs | QDir::NoDotAndDotDot );
                if ( ( extractedContent.size() != extractedFolders.size() ) ||
                         ( extractedFolders.size() != 1 ) ) {
                        ERRORLOG( QString( "Unsupported content of [%1]. Expected a single folder within the archive containing all samples, metadata, as well as the drumkit.xml file. Instead:\n" )
                                          .arg( sDrumkitPath ) );
                        for ( const auto& sFile : extractedContent ) {
                                ERRORLOG( sFile );
                        }
                        return nullptr;
                }
 
                *sDrumkitDir = tmpDir.path() + "/" + extractedFolders[0];
                
                pDrumkit = Drumkit::load( *sDrumkitDir, false, true );
                
        } else {
                ERRORLOG( QString( "Provided source path [%1] does not point to a Hydrogen drumkit" )
                                  .arg( sDrumkitPath ) );
                return nullptr;
        }
 
        return pDrumkit;
}
 
bool CoreActionController::extractDrumkit( const QString& sDrumkitPath, const QString& sTargetDir ) {
 
        QString sTarget;
        bool bInstall = false;
        if ( sTargetDir.isEmpty() ) {
                bInstall = true;
                INFOLOG( QString( "Installing drumkit [%1]" ).arg( sDrumkitPath ) );
                sTarget = Filesystem::usr_drumkits_dir();
        } else {
                INFOLOG( QString( "Extracting drumkit [%1] to [%2]" )
                                 .arg( sDrumkitPath ).arg( sTargetDir ) );
                sTarget = sTargetDir;
        }
 
        if ( ! Filesystem::path_usable( sTarget, true, false ) ) {
                ERRORLOG( QString( "Target dir [%1] is neither a writable folder nor can it be created." )
                                  .arg( sTarget ) );
                return false;
        }
 
        QFileInfo sKitInfo( sDrumkitPath );
        if ( ! Filesystem::file_readable( sDrumkitPath, true ) ||
                 "." + sKitInfo.suffix() != Filesystem::drumkit_ext ) {
                ERRORLOG( QString( "Invalid drumkit path [%1]. Please provide an absolute path to a .h2drumkit file." )
                                  .arg( sDrumkitPath ) );
                return false;
        }
 
        if ( ! Drumkit::install( sDrumkitPath, sTarget, true ) ) {
                ERRORLOG( QString( "Unabled to extract provided drumkit [%1] into [%2]" )
                                  .arg( sDrumkitPath ).arg( sTarget ) );
                return false;
        }
 
        if ( bInstall ) {
                Hydrogen::get_instance()->getSoundLibraryDatabase()->updateDrumkits();
        }
 
        return true;
}
        
bool CoreActionController::locateToColumn( int nPatternGroup ) {
 
        if ( nPatternGroup < -1 ) {
                ERRORLOG( QString( "Provided column [%1] too low. Assigning 0  instead." )
                                  .arg( nPatternGroup ) );
                nPatternGroup = 0;
        }
        
        auto pHydrogen = Hydrogen::get_instance();
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        long nTotalTick = pHydrogen->getTickForColumn( nPatternGroup );
        if ( nTotalTick < 0 ) {
                if ( pHydrogen->getMode() == Song::Mode::Song ) {
                        ERRORLOG( QString( "Provided column [%1] violates the allowed range [0;%2). No relocation done." )
                                          .arg( nPatternGroup )
                                          .arg( pHydrogen->getSong()->getPatternGroupVector()->size() ) );
                        return false;
                } else {
                        // In case of Pattern mode this is not a problem and we
                        // will treat this case as the beginning of the song.
                        nTotalTick = 0;
                }
        }
 
        return locateToTick( nTotalTick );
}
 
bool CoreActionController::locateToTick( long nTick, bool bWithJackBroadcast ) {
 
        const auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        pAudioEngine->lock( RIGHT_HERE );
    
        pAudioEngine->locate( nTick, bWithJackBroadcast );
        
        pAudioEngine->unlock();
        
        EventQueue::get_instance()->push_event( EVENT_RELOCATION, 0 );
        return true;
}
 
bool CoreActionController::newPattern( const QString& sPatternName ) {
        auto pPatternList = Hydrogen::get_instance()->getSong()->getPatternList();
        Pattern* pPattern = new Pattern( sPatternName );
        
        return setPattern( pPattern, pPatternList->size() );
}
bool CoreActionController::openPattern( const QString& sPath, int nPatternPosition ) {
        auto pHydrogen = Hydrogen::get_instance();
        auto pSong = pHydrogen->getSong();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        auto pPatternList = pSong->getPatternList();
        Pattern* pNewPattern = Pattern::load_file( sPath, pSong->getInstrumentList() );
 
        if ( pNewPattern == nullptr ) {
                ERRORLOG( QString( "Unable to loading the pattern [%1]" ).arg( sPath ) );
                return false;
        }
 
        if ( nPatternPosition == -1 ) {
                nPatternPosition = pPatternList->size();
        }
 
        return setPattern( pNewPattern, nPatternPosition );
}
 
bool CoreActionController::setPattern( Pattern* pPattern, int nPatternPosition ) {
        auto pHydrogen = Hydrogen::get_instance();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        auto pPatternList = pHydrogen->getSong()->getPatternList();
 
        // Check whether the name of the new pattern is unique.
        if ( !pPatternList->check_name( pPattern->get_name() ) ){
                pPattern->set_name( pPatternList->find_unused_pattern_name( pPattern->get_name() ) );
        }
 
        pPatternList->insert( nPatternPosition, pPattern );
        if ( pHydrogen->isPatternEditorLocked() ) {
                pHydrogen->updateSelectedPattern( true );
        } else  {
                pHydrogen->setSelectedPatternNumber( nPatternPosition );
        }
        pHydrogen->setIsModified( true );
        
        // Update the SongEditor.
        if ( pHydrogen->getGUIState() != Hydrogen::GUIState::unavailable ) {
                EventQueue::get_instance()->push_event( EVENT_PATTERN_MODIFIED, 0 );
        }
        return true;
}
 
bool CoreActionController::removePattern( int nPatternNumber ) {
        auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
        auto pSong = pHydrogen->getSong();
 
 
        if ( pSong == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
 
        INFOLOG( QString( "Deleting pattern [%1]" ).arg( nPatternNumber ) );
        
        auto pPatternList = pSong->getPatternList();
        auto pPatternGroupVector = pSong->getPatternGroupVector();
        auto pPlayingPatterns = pAudioEngine->getPlayingPatterns();
        auto pNextPatterns = pAudioEngine->getNextPatterns();
        
        int nSelectedPatternNumber = pHydrogen->getSelectedPatternNumber();
        auto pPattern = pPatternList->get( nPatternNumber );
 
        if ( pPattern == nullptr ) {
                ERRORLOG( QString( "Pattern [%1] not found" ).arg( nPatternNumber ) );
                return false;
        }
 
        pAudioEngine->lock( RIGHT_HERE );
 
        // Ensure there is always at least one pattern present in the
        // list.
        if ( pPatternList->size() == 0 ) {
                Pattern* pEmptyPattern = new Pattern( "Pattern 1" );
                pPatternList->add( pEmptyPattern );
        }
 
        // Delete all instances of the pattern in the pattern group vector
        // (columns of the SongEditor)
        for ( const auto& ppatternList : *pPatternGroupVector ) {
                for ( int ii = 0; ii < ppatternList->size(); ++ii ) {
                        if ( ppatternList->get( ii ) == pPattern ) {
                                ppatternList->del( ii );
                                // there is at most one instance of a pattern per
                                // column.
                                continue;
                        }
                }
        }
 
        PatternList* pColumn;
        // Ensure there are no empty columns in the pattern group vector.
        for ( int ii = pPatternGroupVector->size() - 1; ii >= 0; --ii ) {
                pColumn = pPatternGroupVector->at( ii );
                if ( pColumn->size() == 0 ) {
                        pPatternGroupVector->erase( pPatternGroupVector->begin() + ii );
                        delete pColumn;
                }
                else {
                        break;
                }
        }
        
        if ( pHydrogen->isPatternEditorLocked() ) {
                pHydrogen->updateSelectedPattern( false );
        } else if ( nPatternNumber == nSelectedPatternNumber ) {
                pHydrogen->setSelectedPatternNumber( std::max( 0, nPatternNumber - 1 ),
                                                                                         false );
        }
 
        // Remove the pattern from the list of of patterns that are played
        // next in pattern mode.
        // IMPORTANT: it has to be removed from the next patterns list
        // _before_ updating the playing patterns.
        for ( int ii = 0; ii < pNextPatterns->size(); ++ii ) {
                if ( pNextPatterns->get( ii ) == pPattern ) {
                        pAudioEngine->toggleNextPattern( nPatternNumber );
                }
        }
        
        // Ensure the pattern is not among the list of currently played
        // patterns cached in the audio engine if transport is in pattern
        // mode.
        pAudioEngine->removePlayingPattern( pPattern );
 
        // Delete the pattern from the list of available patterns.
        pPatternList->del( pPattern );
 
        pHydrogen->updateSongSize();
 
        pAudioEngine->unlock();
 
        // Update virtual pattern presentation.
        for ( const auto& ppattern : *pPatternList ) {
 
                Pattern::virtual_patterns_cst_it_t it =
                        ppattern->get_virtual_patterns()->find( pPattern );
                if ( it != ppattern->get_virtual_patterns()->end() ) {
                        ppattern->virtual_patterns_del( *it );
                }
        }
 
        pHydrogen->updateVirtualPatterns();
        pHydrogen->setIsModified( true );
        
        delete pPattern;
        
        return true;
}
 
bool CoreActionController::toggleGridCell( int nColumn, int nRow ){
        auto pHydrogen = Hydrogen::get_instance();
 
        if ( pHydrogen->getSong() == nullptr ) {
                ERRORLOG( "no song set" );
                return false;
        }
        
        auto pSong = pHydrogen->getSong();
        auto pPatternList = pSong->getPatternList();
        std::vector<PatternList*>* pColumns = pSong->getPatternGroupVector();
 
        if ( nRow < 0 || nRow > pPatternList->size() ) {
                ERRORLOG( QString( "Provided row [%1] is out of bound [0,%2]" )
                                  .arg( nRow ).arg( pPatternList->size() ) );
                return false;
        }
        
        auto pNewPattern = pPatternList->get( nRow );
        if ( pNewPattern == nullptr ) {
                ERRORLOG( QString( "Unable to obtain Pattern in row [%1]." )
                                  .arg( nRow ) );
 
                return false;
        }
 
        pHydrogen->getAudioEngine()->lock( RIGHT_HERE );
        if ( nColumn >= 0 && nColumn < pColumns->size() ) {
                PatternList *pColumn = ( *pColumns )[ nColumn ];
                auto pPattern = pColumn->del( pNewPattern );
                if ( pPattern == nullptr ) {
                        // No pattern in this row. Let's add it.
                        pColumn->add( pNewPattern );
                } else {
                        // There was already a pattern present and we removed it.
                        // Ensure that there are no empty columns at the end of
                        // the song.
                        for ( int ii = pColumns->size() - 1; ii >= 0; ii-- ) {
                                PatternList *pColumn = ( *pColumns )[ ii ];
                                if ( pColumn->size() == 0 ) {
                                        pColumns->erase( pColumns->begin() + ii );
                                        delete pColumn;
                                } else {
                                        break;
                                }
                        }
                }
        } else if ( nColumn >= pColumns->size() ) {
                // We need to add some new columns..
                PatternList *pColumn;
 
                for ( int ii = 0; nColumn - pColumns->size() + 1; ii++ ) {
                        pColumn = new PatternList();
                        pColumns->push_back( pColumn );
                }
                pColumn->add( pNewPattern );
        } else {
                // nColumn < 0
                ERRORLOG( QString( "Provided column [%1] is out of bound [0,%2]" )
                                  .arg( nColumn ).arg( pColumns->size() ) );
                return false;
        }
        
        pHydrogen->updateSongSize();
        pHydrogen->updateSelectedPattern( false );
        
        pHydrogen->getAudioEngine()->unlock();
 
        pHydrogen->setIsModified( true );
        
        // Update the SongEditor.
        if ( pHydrogen->getGUIState() != Hydrogen::GUIState::unavailable ) {
                EventQueue::get_instance()->push_event( EVENT_GRID_CELL_TOGGLED, 0 );
        }
 
        return true;
}
 
void CoreActionController::updatePreferences() {
        auto pPref = Preferences::get_instance();
        auto pHydrogen = Hydrogen::get_instance();
        auto pAudioEngine = pHydrogen->getAudioEngine();
 
        pAudioEngine->getMetronomeInstrument()->set_volume(
                pPref->m_fMetronomeVolume );
 
        // If the GUI is active, we have to update it to reflect the
        // changes in the preferences.
        if ( pHydrogen->getGUIState() == H2Core::Hydrogen::GUIState::ready ) {
                H2Core::EventQueue::get_instance()->push_event( H2Core::EVENT_UPDATE_PREFERENCES, 1 );
        }
}
 
void CoreActionController::insertRecentFile( const QString sFilename ){
 
        auto pPref = Preferences::get_instance();
 
        // The most recent file will always be added on top and possible
        // duplicates are removed later on.
        bool bAlreadyContained = false;
 
        std::vector<QString> recentFiles = pPref->getRecentFiles();
        
        recentFiles.insert( recentFiles.begin(), sFilename );
 
        if ( std::find( recentFiles.begin(), recentFiles.end(),
                                        sFilename ) != recentFiles.end() ) {
                // Eliminate all duplicates in the list while keeping the one
                // inserted at the beginning. Also, in case the file got renamed,
                // remove it's previous name from the list.
                std::vector<QString> sTmpVec;
                for ( const auto& ssFilename : recentFiles ) {
                        if ( std::find( sTmpVec.begin(), sTmpVec.end(), ssFilename ) ==
                                 sTmpVec.end() ) {
                                // Particular file is not contained yet.
                                sTmpVec.push_back( ssFilename );
                        }
                }
 
                recentFiles = sTmpVec;
        }
 
        pPref->setRecentFiles( recentFiles );
}
}