jamulus/src/llconclientdlg.cpp

/******************************************************************************\
 * Copyright (c) 2004-2006
 *
 * Author(s):
 *  Volker Fischer
 *
 ******************************************************************************
 *
 * 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., 
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 *
\******************************************************************************/

#include "llconclientdlg.h"


/* Implementation *************************************************************/
CLlconClientDlg::CLlconClientDlg ( CClient* pNCliP, QWidget* parent,
    const char* name, bool modal, WFlags f) : pClient ( pNCliP ),
    CLlconClientDlgBase ( parent, name, modal, f ),
    ClientSettingsDlg ( pNCliP, 0, 0, FALSE, Qt::WStyle_MinMax )
{
    /* add help text to controls */
    QString strInpLevH = tr("<b>Input level meter:</b> Shows the level of the "
        "input audio signal of the sound card. The level is in dB. Overload "
        "should be avoided.");
    QWhatsThis::add(TextLabelInputLevel, strInpLevH);
    QWhatsThis::add(ProgressBarInputLevelL, strInpLevH);
    QWhatsThis::add(ProgressBarInputLevelR, strInpLevH);

    QWhatsThis::add(PushButtonConnect, tr("<b>Connect / Disconnect Button:"
        "</b> Push this button to connect the server. A valid IP address has "
        "to be specified before. If the client is connected, pressing this "
        "button will disconnect the connection."));

    QWhatsThis::add(TextLabelStatus, tr("<b>Status Bar:</b> In the status bar "
        "different messages are displayed. E.g., if an error occurred or the "
        "status of the connection is shown."));

    QString strServAddrH = tr("<b>Server Address:</b> In this edit control, "
        "the IP address of the server can be set. If an invalid address was "
        "chosen, an error message is shown in the status bar.");
    QWhatsThis::add(TextLabelServerAddr, strServAddrH);
    QWhatsThis::add(LineEditServerAddr, strServAddrH);

    QString strFaderTag = tr("<b>Fader Tag:</b> In this edit control, "
        "the tag string of your fader can be set. This tag will appear "
        "at your fader on the mixer board when connected to the server.");
    QWhatsThis::add(TextLabelServerTag, strFaderTag);
    QWhatsThis::add(LineEditFaderTag, strFaderTag);

    QString strAudFader = tr ( "<b>Audio Fader:</b> With the audio fader "
        "control the level of left and right audio input channels can "
        "be controlled." );
    QWhatsThis::add ( TextAudInFader, strAudFader );
    QWhatsThis::add ( SliderAudInFader, strAudFader );

    QString strAudReverb = tr ( "<b>Reverberation Level:</b> The level of "
        "reverberation effect can be set with this control. The channel to "
        "which that reverberation effect shall be applied can be chosen "
        "with the Reverberation Channel Selection radio buttons." );
    QWhatsThis::add ( TextLabelAudReverb, strAudReverb );
    QWhatsThis::add ( SliderAudReverb, strAudReverb );

    QString strRevChanSel = tr ( "<b>Reverberation Channel Selection:</b> "
        "With these radio buttons the audio input channel on which the "
        "reverberation effect is applied can be chosen. Either the left "
        "or right input channel can be selected." );
    QWhatsThis::add ( TextLabelReverbSelection, strRevChanSel );
    QWhatsThis::add ( RadioButtonRevSelL, strRevChanSel );
    QWhatsThis::add ( RadioButtonRevSelR, strRevChanSel );

    QWhatsThis::add ( LEDOverallStatus, tr ( "<b>Overall Status:</b> "
        "The overall status of the software is shown. If either the "
        "network or sound interface has bad status, this LED will show "
        "red color." ) );

    // init fader tag line edit
    LineEditFaderTag->setText ( pClient->strName.c_str() );

    // init server address line edit
    LineEditServerAddr->setText ( pClient->strIPAddress.c_str() );

    // we want the cursor to be at IP address line edit at startup
    LineEditServerAddr->setFocus();

    /* init status label */
    OnTimerStatus();

    /* init connection button text */
    PushButtonConnect->setText ( CON_BUT_CONNECTTEXT );

    /* init input level meter bars */
    ProgressBarInputLevelL->setTotalSteps ( NUM_STEPS_INP_LEV_METER );
    ProgressBarInputLevelL->setProgress ( 0 );
    ProgressBarInputLevelR->setTotalSteps ( NUM_STEPS_INP_LEV_METER );
    ProgressBarInputLevelR->setProgress ( 0 );


    // init slider controls ---
    // audio in fader
    SliderAudInFader->setRange ( 0, AUD_FADER_IN_MAX );
    const int iCurAudInFader = pClient->GetAudioInFader();
    SliderAudInFader->setValue ( iCurAudInFader );
    SliderAudInFader->setTickInterval ( AUD_FADER_IN_MAX / 9 );

    // audio reverberation
    SliderAudReverb->setRange ( 0, AUD_REVERB_MAX );
    const int iCurAudReverb = pClient->GetReverbLevel();
    SliderAudReverb->setValue ( AUD_REVERB_MAX - iCurAudReverb );
    SliderAudReverb->setTickInterval ( AUD_REVERB_MAX / 9 );


    // set radio buttons ---
    // reverb channel
    if ( pClient->IsReverbOnLeftChan() )
    {
        RadioButtonRevSelL->setChecked ( true );
    }
    else
    {
        RadioButtonRevSelR->setChecked ( true );
    }


    /* Settings menu  ------------------------------------------------------- */
    pSettingsMenu = new QPopupMenu ( this );
    CHECK_PTR ( pSettingsMenu );

    pSettingsMenu->insertItem ( tr ( "&General Settings..." ), this,
        SLOT ( OnOpenGeneralSettings() ) );

    pSettingsMenu->insertSeparator();
    pSettingsMenu->insertItem ( tr ( "E&xit" ), this,
        SLOT ( close() ), CTRL+Key_Q );


    /* Main menu bar -------------------------------------------------------- */
    pMenu = new QMenuBar ( this );
    CHECK_PTR ( pMenu );

    pMenu->insertItem ( tr ( "&Settings" ), pSettingsMenu );
    pMenu->insertItem ( tr ( "&?"), new CLlconHelpMenu ( this ) );
    pMenu->setSeparator ( QMenuBar::InWindowsStyle );

    /* Now tell the layout about the menu */
    CLlconClientDlgBaseLayout->setMenuBar ( pMenu );


    // connections -------------------------------------------------------------
    // push-buttons
    QObject::connect(PushButtonConnect, SIGNAL(clicked()),
        this, SLOT(OnConnectDisconBut()));

    // timers
    QObject::connect(&TimerSigMet, SIGNAL(timeout()),
        this, SLOT(OnTimerSigMet()));
    QObject::connect(&TimerStatus, SIGNAL(timeout()),
        this, SLOT(OnTimerStatus()));

    // sliders
    QObject::connect(SliderAudInFader, SIGNAL(valueChanged(int)),
        this, SLOT(OnSliderAudInFader(int)));
    QObject::connect(SliderAudReverb, SIGNAL(valueChanged(int)),
        this, SLOT(OnSliderAudReverb(int)));

    // radio buttons
    QObject::connect(RadioButtonRevSelL, SIGNAL(clicked()),
        this, SLOT(OnRevSelL()));
    QObject::connect(RadioButtonRevSelR, SIGNAL(clicked()),
        this, SLOT(OnRevSelR()));

    // line edits
    QObject::connect ( LineEditFaderTag, SIGNAL ( textChanged ( const QString& ) ),
        this, SLOT ( OnFaderTagTextChanged ( const QString& ) ) );

    // other
    QObject::connect ( pClient,
        SIGNAL ( ConClientListMesReceived ( CVector<CChannelShortInfo> ) ),
        this, SLOT ( OnConClientListMesReceived ( CVector<CChannelShortInfo> ) ) );
    QObject::connect ( MainMixerBoard, SIGNAL ( ChangeChanGain ( int, double ) ),
        this, SLOT ( OnChangeChanGain ( int, double ) ) );


    // timers ------------------------------------------------------------------
    // start timer for status bar
    TimerStatus.start(STATUSBAR_UPDATE_TIME);
}

CLlconClientDlg::~CLlconClientDlg()
{
    /* if connected, terminate connection */
    if (pClient->IsRunning())
    {
        pClient->Stop();
    }
}

void CLlconClientDlg::closeEvent ( QCloseEvent * Event )
{
    // store IP address
    pClient->strIPAddress = LineEditServerAddr->text().latin1();

    // store fader tag
    pClient->strName = LineEditFaderTag->text().latin1();

    // default implementation of this event handler routine
    Event->accept();
}

void CLlconClientDlg::OnConnectDisconBut()
{
    // start/stop client, set button text
    if ( pClient->IsRunning() )
    {
        pClient->Stop();
        PushButtonConnect->setText ( CON_BUT_CONNECTTEXT );

        // stop timer for level meter bars and reset them
        TimerSigMet.stop();
        ProgressBarInputLevelL->setProgress ( 0 );
        ProgressBarInputLevelR->setProgress ( 0 );

        // immediately update status bar
        OnTimerStatus();

        // clear mixer board (remove all faders)
        MainMixerBoard->HideAll();
    }
    else
    {
        // set address and check if address is valid
        if ( pClient->SetServerAddr ( LineEditServerAddr->text() ) )
        {
#if ( QT_VERSION > 300 )
            pClient->start ( QThread::TimeCriticalPriority );
#else
            pClient->start();
#endif
            PushButtonConnect->setText ( CON_BUT_DISCONNECTTEXT );

            // start timer for level meter bar
            TimerSigMet.start ( LEVELMETER_UPDATE_TIME );
        }
        else
        {
            // Restart timer to ensure that the text is visible at
            // least the time for one complete interval
            TimerStatus.changeInterval ( STATUSBAR_UPDATE_TIME );

            // show the error in the status bar
            TextLabelStatus->setText ( tr ( "invalid address" ) );
        }
    }
}

void CLlconClientDlg::OnOpenGeneralSettings()
{
    // open general settings dialog
    ClientSettingsDlg.show();

    // make sure dialog is upfront and has focus
    ClientSettingsDlg.raise();
    ClientSettingsDlg.setActiveWindow();
    
}

void CLlconClientDlg::OnFaderTagTextChanged ( const QString& strNewName )
{
    // refresh internal name parameter
    pClient->strName = strNewName.latin1();

    // update name at server
    pClient->SetRemoteName();
}

void CLlconClientDlg::OnTimerSigMet()
{
    /* get current input levels */
    double dCurSigLevelL = pClient->MicLevelL();
    double dCurSigLevelR = pClient->MicLevelR();

    /* linear transformation of the input level range to the progress-bar
       range */
    dCurSigLevelL -= LOW_BOUND_SIG_METER;
    dCurSigLevelL *= NUM_STEPS_INP_LEV_METER /
        ( UPPER_BOUND_SIG_METER - LOW_BOUND_SIG_METER );

    // lower bound the signal
    if ( dCurSigLevelL < 0 )
    {
        dCurSigLevelL = 0;
    }

    dCurSigLevelR -= LOW_BOUND_SIG_METER;
    dCurSigLevelR *= NUM_STEPS_INP_LEV_METER /
        ( UPPER_BOUND_SIG_METER - LOW_BOUND_SIG_METER );

    // lower bound the signal
    if ( dCurSigLevelR < 0 )
    {
        dCurSigLevelR = 0;
    }

    /* show current level */
    ProgressBarInputLevelL->setProgress ( (int) ceil ( dCurSigLevelL ) );
    ProgressBarInputLevelR->setProgress ( (int) ceil ( dCurSigLevelR ) );
}

void CLlconClientDlg::UpdateDisplay()
{
    /* show connection status in status bar */
    if ( pClient->IsConnected () && pClient->IsRunning () )
    {
        TextLabelStatus->setText ( tr ( "connected" ) );
    }
    else
    {
        TextLabelStatus->setText ( tr ( "disconnected" ) );
    }
}

void CLlconClientDlg::customEvent ( QCustomEvent* Event )
{
    if ( Event->type() == QEvent::User + 11 )
    {
        const int iMessType = ( (CLlconEvent*) Event ) ->iMessType;
        const int iStatus = ( (CLlconEvent*) Event ) ->iStatus;

        switch ( iMessType )
        {
        case MS_SOUND_IN:
        case MS_SOUND_OUT:
        case MS_JIT_BUF_PUT:
        case MS_JIT_BUF_GET:

            // show overall status -> if any LED goes red, this LED will go red
            LEDOverallStatus->SetLight ( iStatus );
            break;

        case MS_RESET_ALL:
            LEDOverallStatus->Reset();
            break;
        }

        // update general settings dialog, too
        ClientSettingsDlg.SetStatus ( iMessType, iStatus );
    }
}