/*
* Copyright (c) 2006-2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:      Header file of CUpnpResResolver class. CUpnpResResolver is 
*                a class used for resolving res field attributes for a given 
*                file.
*
*/






#ifndef C_UPNPRESRESOLVER_H
#define C_UPNPRESRESOLVER_H

// system includes
#include <e32base.h>
#include <mdaaudiosampleplayer.h> // CMdaAudioPlayerUtility

// user includes
// NONE

// forward declarations
class RFile;
class CUpnpResParameters;

// data types
// NONE

// constants
// NONE

/**
 *  CUpnpResResolver is a class for resolving res field attributes for a 
 *  given file.
 *
 *  CUpnpResResolver class can be used to resolve a res field attributes for 
 *  a media file (image, AV, video). Attributes resolved for media files are:
 *     - Protocolinfo for all files.
 *     - Resolution and size for images.
 *     - Duration and size for videos.
 *     - Duration and size for music.
 *
 *  @lib dlnaprofiler.lib
 *  @since S60 v3.1
 */
class CUpnpResResolver: public CBase, 
                        public MMdaAudioPlayerCallback
    {
public:

    IMPORT_C static CUpnpResResolver* NewL();

    IMPORT_C static CUpnpResResolver* NewLC();

    virtual ~CUpnpResResolver();

    /**
     * GetResParametersL resolves parameters that will be needed in 
     * res-element attributes.
     *
     * @since S60 v3.1
     * @param const TDesC& File for which to obtain res parameters.
     * @return CUpnpResParameters* Parameters needed for res-element.
     */  
    IMPORT_C CUpnpResParameters* GetResParametersL( const TDesC& aFilename );
    
private:

    CUpnpResResolver();

    void ConstructL();

    /**
     * GetMimetypeL returns the mime type of the file.
     *
     * @since S60 v3.1
     * @param RFile& File for which to obtain mime.
     * @return HBufC8* Mime type of the file.
     */  
    HBufC8* GetMimetypeL( RFile& aFile );
    
    /**
     * GetAudioDurationL obtains the duration of a audio file.
     * After call the duration is in iDuration member variable.
     *
     * @since S60 v3.1
     * @param const TDesC& The audio file for which to obtain duration.
     */  
    void GetAudioDurationL( const TDesC& aFilename );

    /**
     * GetVideoDurationL obtains the duration of a video file.
     * After call the duration is in iDuration member variable.
     *
     * @since S60 v3.1
     * @param RFile& The video file for which to obtain duration.
     */  
    void GetVideoDurationL( RFile& aFile );

    /**
     * GetFileSizeL returns the size of file in bytes.
     *
     * @since S60 v3.1
     * @param RFile& The file for which to obtain size
     * @return TInt File size.
     */  
    TInt GetFileSizeL( RFile& aFile );

    /**
     * GetImageResolutionL returns the resolution of the image.
     *
     * @since S60 v3.1
     * @param RFile& File for which to obtain resolution.
     * @param const TDesC8& Mime type of the file.
     * @return TSize The resolution of the image. 
     */  
    TSize GetImageResolutionL( RFile& aFile, const TDesC8& aMimetype );

// from base class MMdaAudioPlayerCallback (used from audio resolving thread)

    /**
     * From MMdaAudioPlayerCallback.
     * MapcPlayComplete 
     *
     * @since S60 v3.1
     * @param aError error code
     */
    void MapcPlayComplete( TInt aError );

    /**
     * From MMdaAudioPlayerCallback.
     * MapcInitComplete 
     *
     * @since S60 v3.1
     * @param aError error code
     * @param aDuration duration of the file
     */
    void MapcInitComplete( TInt aError, 
                           const TTimeIntervalMicroSeconds& aDuration );
    
// audio resolving thread    
    
    /**
     * Thread function for audio resolving thread.
     * 
     * @param aSelf Pointer to CUpnpResResolver class instance.
     * @return Possible return values:
     *  KErrNone: Thread exited ok.
     *  Otherwise system wide error code.
     */
    static TInt ThreadFunction( TAny* aSelf );

    /**
     * Resolves audio duration from iAVFile.
     * 
     * @param None.
     * @return None.
     */
    void ResolveAudioDurationL();
           
private: // data    
    // duration of the media file (video or audio)
    TTimeIntervalMicroSeconds iDuration;
    
    // current audio/video file
    HBufC* iAVFile;
    
    // semaphore for keeping sync between main thread and audio resolving thread
    RSemaphore iSemaphore;
    };


#endif // C_UPNPRESRESOLVER_H