mpengine/src/mpsongscanner.cpp
author hgs
Fri, 11 Jun 2010 19:36:32 -0500
changeset 37 eb79a7c355bf
child 43 0f32e550d9d8
child 44 eff9df3d9c98
permissions -rw-r--r--
201023
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
37
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 song scanner.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#include "mpsongscanner.h"
hgs
parents:
diff changeset
    19
#include "mpmpxharvesterframeworkwrapper.h"
hgs
parents:
diff changeset
    20
#include "mptrace.h"
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
/*!
hgs
parents:
diff changeset
    23
    \class MpSongScanner
hgs
parents:
diff changeset
    24
    \brief Music Player song scanner.
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
    Song scanner interfaces with MPX Harvesting Framework to harvest
hgs
parents:
diff changeset
    27
    music files in the device.
hgs
parents:
diff changeset
    28
*/
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
/*!
hgs
parents:
diff changeset
    31
 \fn void scanStarted()
hgs
parents:
diff changeset
    32
hgs
parents:
diff changeset
    33
 This signal is emitted when scanning has started.
hgs
parents:
diff changeset
    34
hgs
parents:
diff changeset
    35
 */
hgs
parents:
diff changeset
    36
hgs
parents:
diff changeset
    37
/*!
hgs
parents:
diff changeset
    38
 \fn void scanCountChanged( int count )
hgs
parents:
diff changeset
    39
hgs
parents:
diff changeset
    40
 This signal is emitted to notify that scan count has changed.
hgs
parents:
diff changeset
    41
hgs
parents:
diff changeset
    42
 */
hgs
parents:
diff changeset
    43
hgs
parents:
diff changeset
    44
/*!
hgs
parents:
diff changeset
    45
 \fn void scanFinished( int error, int itemsAdded )
hgs
parents:
diff changeset
    46
hgs
parents:
diff changeset
    47
 Emitted when scanning has finished.
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
 */
hgs
parents:
diff changeset
    50
hgs
parents:
diff changeset
    51
/*!
hgs
parents:
diff changeset
    52
 Constructs the song scanner.
hgs
parents:
diff changeset
    53
 */
hgs
parents:
diff changeset
    54
MpSongScanner::MpSongScanner( MpMpxHarvesterFrameworkWrapper *wrapper, QObject *parent )
hgs
parents:
diff changeset
    55
    : QObject( parent ),
hgs
parents:
diff changeset
    56
      mMpxHarvesterWrapper(wrapper),
hgs
parents:
diff changeset
    57
      mScanning( false ),
hgs
parents:
diff changeset
    58
      mAutomaticScan( true )
hgs
parents:
diff changeset
    59
{
hgs
parents:
diff changeset
    60
    TX_ENTRY
hgs
parents:
diff changeset
    61
    connect( mMpxHarvesterWrapper, SIGNAL( scanStarted() ),
hgs
parents:
diff changeset
    62
            this, SIGNAL( scanStarted() ), Qt::QueuedConnection );
hgs
parents:
diff changeset
    63
    connect( mMpxHarvesterWrapper, SIGNAL( scanEnded( int, int ) ),
hgs
parents:
diff changeset
    64
            this, SLOT( handleScanEnded( int, int ) ), Qt::QueuedConnection );
hgs
parents:
diff changeset
    65
    connect( mMpxHarvesterWrapper, SIGNAL( scanCountChanged( int ) ), 
hgs
parents:
diff changeset
    66
            this, SIGNAL( scanCountChanged( int ) ), Qt::QueuedConnection );
hgs
parents:
diff changeset
    67
    connect( mMpxHarvesterWrapper, SIGNAL( diskEvent( MpxDiskEvents ) ),
hgs
parents:
diff changeset
    68
            this, SLOT( handleDiskEvent(MpxDiskEvents) ), Qt::QueuedConnection );
hgs
parents:
diff changeset
    69
    TX_EXIT
hgs
parents:
diff changeset
    70
}
hgs
parents:
diff changeset
    71
hgs
parents:
diff changeset
    72
/*!
hgs
parents:
diff changeset
    73
 Destructs the song scanner.
hgs
parents:
diff changeset
    74
 */
hgs
parents:
diff changeset
    75
MpSongScanner::~MpSongScanner()
hgs
parents:
diff changeset
    76
{
hgs
parents:
diff changeset
    77
    TX_LOG
hgs
parents:
diff changeset
    78
}
hgs
parents:
diff changeset
    79
hgs
parents:
diff changeset
    80
/*!
hgs
parents:
diff changeset
    81
 Initiates song scanning.
hgs
parents:
diff changeset
    82
 */
hgs
parents:
diff changeset
    83
void MpSongScanner::scan( bool automaticScan )
hgs
parents:
diff changeset
    84
{
hgs
parents:
diff changeset
    85
    TX_ENTRY
hgs
parents:
diff changeset
    86
    if ( !mScanning ) {
hgs
parents:
diff changeset
    87
        mScanning = true;
hgs
parents:
diff changeset
    88
        mAutomaticScan = automaticScan;
hgs
parents:
diff changeset
    89
        mMpxHarvesterWrapper->scan();
hgs
parents:
diff changeset
    90
    }
hgs
parents:
diff changeset
    91
    TX_EXIT
hgs
parents:
diff changeset
    92
}
hgs
parents:
diff changeset
    93
hgs
parents:
diff changeset
    94
/*!
hgs
parents:
diff changeset
    95
 Returns mAutomaticScan value.
hgs
parents:
diff changeset
    96
 */
hgs
parents:
diff changeset
    97
bool MpSongScanner::isAutomaticScan()
hgs
parents:
diff changeset
    98
{
hgs
parents:
diff changeset
    99
    return mAutomaticScan;
hgs
parents:
diff changeset
   100
}
hgs
parents:
diff changeset
   101
hgs
parents:
diff changeset
   102
/*!
hgs
parents:
diff changeset
   103
 Cancels ongoing song scanning, if any.
hgs
parents:
diff changeset
   104
hgs
parents:
diff changeset
   105
 \sa scan()
hgs
parents:
diff changeset
   106
 */
hgs
parents:
diff changeset
   107
void MpSongScanner::cancelScan()
hgs
parents:
diff changeset
   108
{
hgs
parents:
diff changeset
   109
    TX_ENTRY
hgs
parents:
diff changeset
   110
    if ( mScanning ) {
hgs
parents:
diff changeset
   111
        mScanning = false;
hgs
parents:
diff changeset
   112
        mMpxHarvesterWrapper->cancelScan();
hgs
parents:
diff changeset
   113
    }
hgs
parents:
diff changeset
   114
    TX_EXIT
hgs
parents:
diff changeset
   115
}
hgs
parents:
diff changeset
   116
hgs
parents:
diff changeset
   117
/*!
hgs
parents:
diff changeset
   118
 Slot called upon notification from MPX Harvesting FW indicating end of
hgs
parents:
diff changeset
   119
 scanning process.
hgs
parents:
diff changeset
   120
 */
hgs
parents:
diff changeset
   121
void MpSongScanner::handleScanEnded( int numItemsAdded, int error )
hgs
parents:
diff changeset
   122
{
hgs
parents:
diff changeset
   123
    TX_ENTRY
hgs
parents:
diff changeset
   124
    if (error == KErrDiskFull) {
hgs
parents:
diff changeset
   125
        emit scanFinished( ScanErrorDiskFull, 0 );
hgs
parents:
diff changeset
   126
        mScanning = false;
hgs
parents:
diff changeset
   127
    }
hgs
parents:
diff changeset
   128
    else{
hgs
parents:
diff changeset
   129
        if( error < 0) {
hgs
parents:
diff changeset
   130
            emit scanFinished( ScanGeneralError, numItemsAdded );
hgs
parents:
diff changeset
   131
        }
hgs
parents:
diff changeset
   132
        else if ( mScanning ) {
hgs
parents:
diff changeset
   133
            emit scanFinished( ScanErrorNone, numItemsAdded );
hgs
parents:
diff changeset
   134
        }
hgs
parents:
diff changeset
   135
        else {
hgs
parents:
diff changeset
   136
            // Scan canceled
hgs
parents:
diff changeset
   137
            emit scanFinished( ScanGeneralError, numItemsAdded );
hgs
parents:
diff changeset
   138
        }
hgs
parents:
diff changeset
   139
        mScanning = false;
hgs
parents:
diff changeset
   140
    }
hgs
parents:
diff changeset
   141
    TX_EXIT
hgs
parents:
diff changeset
   142
}
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
/*!
hgs
parents:
diff changeset
   145
 Slot to be called when disk event is received from MPX framework.
hgs
parents:
diff changeset
   146
 */
hgs
parents:
diff changeset
   147
void MpSongScanner::handleDiskEvent( MpxDiskEvents event )
hgs
parents:
diff changeset
   148
{
hgs
parents:
diff changeset
   149
    TX_ENTRY
hgs
parents:
diff changeset
   150
    Q_UNUSED( event );
hgs
parents:
diff changeset
   151
    if ( mScanning ) {
hgs
parents:
diff changeset
   152
        emit scanFinished( ScanInterrupted, 0 );
hgs
parents:
diff changeset
   153
        mScanning = false;
hgs
parents:
diff changeset
   154
    }
hgs
parents:
diff changeset
   155
    TX_EXIT
hgs
parents:
diff changeset
   156
}
hgs
parents:
diff changeset
   157