utilities/mpmediacontroller/src/mpvolumeslider.cpp
author hgs
Fri, 06 Aug 2010 16:51:36 -0500
changeset 47 4cc1412daed0
permissions -rw-r--r--
201031
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
47
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description: Music Player volume slider.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#include <hbvolumesliderpopup.h>
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
#include "mpvolumeslider.h"
hgs
parents:
diff changeset
    21
#include "mpenginefactory.h"
hgs
parents:
diff changeset
    22
#include "mptrace.h"
hgs
parents:
diff changeset
    23
hgs
parents:
diff changeset
    24
const int KVolumeMin = 0;
hgs
parents:
diff changeset
    25
const int KVolumeMuted = 1;
hgs
parents:
diff changeset
    26
const int KDefaultSteps = 10;
hgs
parents:
diff changeset
    27
const int KDataCompleted = 0x07; // 0x01 volume max, 0x02 volume level, 0x04 volume mute
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
/*!
hgs
parents:
diff changeset
    30
 Constructs MpVolumeSlider.
hgs
parents:
diff changeset
    31
 */
hgs
parents:
diff changeset
    32
MpVolumeSlider::MpVolumeSlider( QObject *parent )
hgs
parents:
diff changeset
    33
    : QObject( parent),
hgs
parents:
diff changeset
    34
      mMpEngine( 0 ),
hgs
parents:
diff changeset
    35
      mVolumeSliderPopup( 0 ),
hgs
parents:
diff changeset
    36
      mEngineVolumeMax( 0 ),
hgs
parents:
diff changeset
    37
      mEngineVolumeLevel( 0 ),
hgs
parents:
diff changeset
    38
      mEngineMuted( false ),
hgs
parents:
diff changeset
    39
      mEngineDataCompleted( 0 ),
hgs
parents:
diff changeset
    40
      mSliderPressed( false ),
hgs
parents:
diff changeset
    41
      mSliderStep( 0 )
hgs
parents:
diff changeset
    42
{
hgs
parents:
diff changeset
    43
    TX_ENTRY
hgs
parents:
diff changeset
    44
    mMpEngine = MpEngineFactory::sharedEngine();
hgs
parents:
diff changeset
    45
    connect( mMpEngine, SIGNAL( volumePropertyChanged( MpCommon::MpVolumeProperty, int ) ), 
hgs
parents:
diff changeset
    46
             this, SLOT( handleVolumeProperty( MpCommon::MpVolumeProperty, int ) ) );
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
    //Request Volume properties
hgs
parents:
diff changeset
    49
    mMpEngine->getMaxVolume();
hgs
parents:
diff changeset
    50
    mMpEngine->getVolume();
hgs
parents:
diff changeset
    51
    mMpEngine->getMuteState();
hgs
parents:
diff changeset
    52
    TX_EXIT
hgs
parents:
diff changeset
    53
}
hgs
parents:
diff changeset
    54
hgs
parents:
diff changeset
    55
/*!
hgs
parents:
diff changeset
    56
 Destructs MpVolumeSlider.
hgs
parents:
diff changeset
    57
 */
hgs
parents:
diff changeset
    58
MpVolumeSlider::~MpVolumeSlider()
hgs
parents:
diff changeset
    59
{
hgs
parents:
diff changeset
    60
    TX_ENTRY
hgs
parents:
diff changeset
    61
    delete mVolumeSliderPopup;
hgs
parents:
diff changeset
    62
    TX_EXIT
hgs
parents:
diff changeset
    63
}
hgs
parents:
diff changeset
    64
hgs
parents:
diff changeset
    65
/*!
hgs
parents:
diff changeset
    66
 Make volume slider visible with latest engine data.
hgs
parents:
diff changeset
    67
 */
hgs
parents:
diff changeset
    68
void MpVolumeSlider::showVolumeSlider()
hgs
parents:
diff changeset
    69
{
hgs
parents:
diff changeset
    70
    TX_ENTRY
hgs
parents:
diff changeset
    71
hgs
parents:
diff changeset
    72
    if ( !mSliderPressed ) {
hgs
parents:
diff changeset
    73
hgs
parents:
diff changeset
    74
        // Initialize popup until needed, in order to save time during app start up.
hgs
parents:
diff changeset
    75
        if ( !mVolumeSliderPopup ) {
hgs
parents:
diff changeset
    76
            initializeVolumeSliderPopup();
hgs
parents:
diff changeset
    77
        }
hgs
parents:
diff changeset
    78
hgs
parents:
diff changeset
    79
        // Update VolumeSlider with Engine values
hgs
parents:
diff changeset
    80
        if ( mEngineMuted ) {
hgs
parents:
diff changeset
    81
            if ( mVolumeSliderPopup->value() != KVolumeMin ) {
hgs
parents:
diff changeset
    82
                // Muted from outside (possibly from Headset or MediaKeys), update volume slider as "muted"
hgs
parents:
diff changeset
    83
                // Todo: Replace with a more appropriate method to mute slider, when provided by Orbit.
hgs
parents:
diff changeset
    84
                mVolumeSliderPopup->setValue( KVolumeMin );
hgs
parents:
diff changeset
    85
            }
hgs
parents:
diff changeset
    86
        }
hgs
parents:
diff changeset
    87
        else if ( mVolumeSliderPopup->value() != ( mEngineVolumeLevel / mSliderStep ) ){
hgs
parents:
diff changeset
    88
            mVolumeSliderPopup->setValue( mEngineVolumeLevel / mSliderStep );
hgs
parents:
diff changeset
    89
        }
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
        // Show VolumeSlider
hgs
parents:
diff changeset
    92
        if ( !mVolumeSliderPopup->isVisible() ) {
hgs
parents:
diff changeset
    93
            mVolumeSliderPopup->setVisible( true );
hgs
parents:
diff changeset
    94
        }
hgs
parents:
diff changeset
    95
    }
hgs
parents:
diff changeset
    96
hgs
parents:
diff changeset
    97
    TX_EXIT
hgs
parents:
diff changeset
    98
}
hgs
parents:
diff changeset
    99
hgs
parents:
diff changeset
   100
/*!
hgs
parents:
diff changeset
   101
 Slot to handle volume property notifications
hgs
parents:
diff changeset
   102
 */
hgs
parents:
diff changeset
   103
void MpVolumeSlider::handleVolumeProperty( MpCommon::MpVolumeProperty property, int value )
hgs
parents:
diff changeset
   104
{
hgs
parents:
diff changeset
   105
    TX_ENTRY_ARGS("Property: " << property << ", Value: " << value );
hgs
parents:
diff changeset
   106
    switch( property )
hgs
parents:
diff changeset
   107
    {
hgs
parents:
diff changeset
   108
        case MpCommon::MaxVolume :
hgs
parents:
diff changeset
   109
            mEngineVolumeMax = value;
hgs
parents:
diff changeset
   110
            mEngineDataCompleted |= 0x01;
hgs
parents:
diff changeset
   111
            break;
hgs
parents:
diff changeset
   112
        case MpCommon::Volume :
hgs
parents:
diff changeset
   113
            mEngineVolumeLevel = value;
hgs
parents:
diff changeset
   114
            // Framework automatically mutes if volume == KVolumeMin and unmutes when volume > KVolumeMin
hgs
parents:
diff changeset
   115
            mEngineMuted = mEngineVolumeLevel == KVolumeMin; 
hgs
parents:
diff changeset
   116
            if ( mEngineDataCompleted == KDataCompleted ) {
hgs
parents:
diff changeset
   117
                showVolumeSlider();
hgs
parents:
diff changeset
   118
            }
hgs
parents:
diff changeset
   119
            else {
hgs
parents:
diff changeset
   120
                mEngineDataCompleted |= 0x02;
hgs
parents:
diff changeset
   121
            }
hgs
parents:
diff changeset
   122
            break;
hgs
parents:
diff changeset
   123
        case MpCommon::MuteState :
hgs
parents:
diff changeset
   124
            mEngineMuted = ( value == KVolumeMuted );
hgs
parents:
diff changeset
   125
            if ( mEngineDataCompleted == KDataCompleted ) {
hgs
parents:
diff changeset
   126
                showVolumeSlider();
hgs
parents:
diff changeset
   127
            }
hgs
parents:
diff changeset
   128
            else {
hgs
parents:
diff changeset
   129
                mEngineDataCompleted |= 0x04;
hgs
parents:
diff changeset
   130
            }
hgs
parents:
diff changeset
   131
            break;
hgs
parents:
diff changeset
   132
        default:
hgs
parents:
diff changeset
   133
            TX_LOG_ARGS( "We should never be here" );
hgs
parents:
diff changeset
   134
            break;
hgs
parents:
diff changeset
   135
    }
hgs
parents:
diff changeset
   136
    TX_EXIT
hgs
parents:
diff changeset
   137
}
hgs
parents:
diff changeset
   138
hgs
parents:
diff changeset
   139
/*!
hgs
parents:
diff changeset
   140
 Slot called when slider is pressed.
hgs
parents:
diff changeset
   141
 */
hgs
parents:
diff changeset
   142
void MpVolumeSlider::sliderPressed()
hgs
parents:
diff changeset
   143
{
hgs
parents:
diff changeset
   144
    TX_ENTRY
hgs
parents:
diff changeset
   145
    mSliderPressed = true;
hgs
parents:
diff changeset
   146
    TX_EXIT
hgs
parents:
diff changeset
   147
}
hgs
parents:
diff changeset
   148
hgs
parents:
diff changeset
   149
/*!
hgs
parents:
diff changeset
   150
 Slot called when slider is released.
hgs
parents:
diff changeset
   151
 */
hgs
parents:
diff changeset
   152
void MpVolumeSlider::sliderReleased()
hgs
parents:
diff changeset
   153
{
hgs
parents:
diff changeset
   154
    TX_ENTRY
hgs
parents:
diff changeset
   155
    mSliderPressed = false;
hgs
parents:
diff changeset
   156
    TX_EXIT
hgs
parents:
diff changeset
   157
}
hgs
parents:
diff changeset
   158
hgs
parents:
diff changeset
   159
/*!
hgs
parents:
diff changeset
   160
 Slot called when mute icon is clicekd.
hgs
parents:
diff changeset
   161
 */
hgs
parents:
diff changeset
   162
void MpVolumeSlider::muteIconClicked()
hgs
parents:
diff changeset
   163
{
hgs
parents:
diff changeset
   164
    TX_ENTRY
hgs
parents:
diff changeset
   165
    if ( mVolumeSliderPopup->value() ) {
hgs
parents:
diff changeset
   166
        mMpEngine->unmute();
hgs
parents:
diff changeset
   167
        mEngineMuted = false;
hgs
parents:
diff changeset
   168
    }
hgs
parents:
diff changeset
   169
    else {
hgs
parents:
diff changeset
   170
        mMpEngine->mute();
hgs
parents:
diff changeset
   171
        mEngineMuted = true;
hgs
parents:
diff changeset
   172
    }
hgs
parents:
diff changeset
   173
    TX_EXIT
hgs
parents:
diff changeset
   174
}
hgs
parents:
diff changeset
   175
hgs
parents:
diff changeset
   176
/*!
hgs
parents:
diff changeset
   177
 Slot called when volume slider value changes.
hgs
parents:
diff changeset
   178
 */
hgs
parents:
diff changeset
   179
void MpVolumeSlider::volumeSliderChanged( int value )
hgs
parents:
diff changeset
   180
{
hgs
parents:
diff changeset
   181
    TX_ENTRY
hgs
parents:
diff changeset
   182
hgs
parents:
diff changeset
   183
    if ( mEngineVolumeLevel != ( value * mSliderStep ) ) {
hgs
parents:
diff changeset
   184
        // When Mute icon is clicked, slider value changes automatically to zero,
hgs
parents:
diff changeset
   185
        // don't send that change in order to avoid reset the engine previous volume.
hgs
parents:
diff changeset
   186
        if ( !( mEngineMuted && value == KVolumeMin ) ) {
hgs
parents:
diff changeset
   187
            mMpEngine->setVolume( value * mSliderStep );
hgs
parents:
diff changeset
   188
        }
hgs
parents:
diff changeset
   189
    }
hgs
parents:
diff changeset
   190
hgs
parents:
diff changeset
   191
    TX_EXIT
hgs
parents:
diff changeset
   192
}
hgs
parents:
diff changeset
   193
hgs
parents:
diff changeset
   194
/*!
hgs
parents:
diff changeset
   195
 Inernal
hgs
parents:
diff changeset
   196
 */
hgs
parents:
diff changeset
   197
void MpVolumeSlider::initializeVolumeSliderPopup()
hgs
parents:
diff changeset
   198
{
hgs
parents:
diff changeset
   199
    TX_ENTRY
hgs
parents:
diff changeset
   200
hgs
parents:
diff changeset
   201
    mVolumeSliderPopup = new HbVolumeSliderPopup();
hgs
parents:
diff changeset
   202
    mVolumeSliderPopup->setRange( KVolumeMin, KDefaultSteps );
hgs
parents:
diff changeset
   203
    mVolumeSliderPopup->setSingleStep( 1 );
hgs
parents:
diff changeset
   204
    mVolumeSliderPopup->setTickPosition( Hb::NoSliderTicks );
hgs
parents:
diff changeset
   205
    mSliderStep = mEngineVolumeMax / KDefaultSteps ;
hgs
parents:
diff changeset
   206
hgs
parents:
diff changeset
   207
    connect( mVolumeSliderPopup, SIGNAL( sliderPressed() ), 
hgs
parents:
diff changeset
   208
             this, SLOT( sliderPressed() ) );
hgs
parents:
diff changeset
   209
    connect( mVolumeSliderPopup, SIGNAL( sliderReleased() ), 
hgs
parents:
diff changeset
   210
             this, SLOT( sliderReleased() ) );
hgs
parents:
diff changeset
   211
    connect( mVolumeSliderPopup, SIGNAL( iconClicked() ), 
hgs
parents:
diff changeset
   212
             this, SLOT( muteIconClicked() ) );
hgs
parents:
diff changeset
   213
    // volumeChanged event is also sent when VolumeSlider is Muted/Unmuted
hgs
parents:
diff changeset
   214
    // QueuedConnection used in order to handle Mute events first,
hgs
parents:
diff changeset
   215
    // and then be able to know whether to apply the slider volume changes to the engine
hgs
parents:
diff changeset
   216
    connect( mVolumeSliderPopup, SIGNAL( valueChanged( int ) ), 
hgs
parents:
diff changeset
   217
             this, SLOT( volumeSliderChanged( int ) ),
hgs
parents:
diff changeset
   218
             Qt::QueuedConnection );
hgs
parents:
diff changeset
   219
hgs
parents:
diff changeset
   220
    TX_EXIT
hgs
parents:
diff changeset
   221
}
hgs
parents:
diff changeset
   222