/*
* 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 CUpnpResParameters class. CUpnpResParameters 
*                is created to encapsulate information that is needed in a 
*                contentdirectory res element.
*
*/






#ifndef C_UPNPRESPARAMETERS_H
#define C_UPNPRESPARAMETERS_H

// system includes
#include <e32base.h>

// user includes
// NONE

// forward declarations
// NONE

// data types
// NONE

// constants
// NONE

/**
 *  CUpnpResParameters is created to encapsulate information that is needed
 *  in a contentdirectory res element.
 *
 *  @lib dlnaprofiler.lib
 *  @since S60 v3.1
 */
class CUpnpResParameters: public CBase
    {
public:

    IMPORT_C static CUpnpResParameters* NewL();

    IMPORT_C static CUpnpResParameters* NewLC();

    virtual ~CUpnpResParameters();

    // getters

    /**
     * ProtocolInfo returns the protocolinfo string.
     *
     * @since S60 v3.1
     * @return HBufC8* Protocolinfo
     */  
    IMPORT_C const TDesC8& ProtocolInfo() const;

    /**
     * FileSizeL returns the size of the file in bytes as descriptor.
     *
     * @since S60 v3.1
     * @return HBufC8* File Size
     */  
    IMPORT_C HBufC8* FileSizeL() const;

    /**
     * DurationL returns the duration in the following form:
     *     duration = hours ":" minutes ":" seconds
     *     hours = 1*5 DIGIT; 0-99999
     *     minutes = 2 DIGIT ; 00-59
     *     seconds = 2 DIGIT ["." 3 DIGIT] ; 00-59 (.000-.999) 
     *
     * @since S60 v3.1
     * @return HBufC8* Duration
     */  
    IMPORT_C HBufC8* DurationL() const;

    /**
     * ResolutionL returns the resolution in form widthXheight.
     *
     * @since S60 v3.1
     * @return HBufC8* Resolution
     */  
    IMPORT_C HBufC8* ResolutionL() const;

    /**
     * MimeType is a getter for mime type.
     *
     * @since S60 v3.1
     * @return HBufC8* Mime type
     */  
    const TDesC8& MimeType();
    
    // Methods for querying file type

    /**
     * IsImageFile returns true if file is image file, false otherwise.
     *
     * @since S60 v3.1
     * @return TBool
     */  
    IMPORT_C TBool IsImageFile() const ;

    /**
     * IsAudioOrVideoFile returns true if file is audio or video file, 
     * false otherwise.
     *
     * @since S60 v3.1
     * @return TBool 
     */  
    IMPORT_C TBool IsAudioOrVideoFile() const;

    // setters

    /**
     * SetProtocolInfoL sets the protocolinfo attribute.
     *
     * @since S60 v3.1
     * @param const TDesC8& Protocolinfo
     */  
    void SetProtocolInfoL( const TDesC8& aProtocolInfo );

    /**
     * SetMimetypeL sets the mime type attribute.
     *
     * @since S60 v3.1
     * @param const TDesC8& Mime type
     */  
    void SetMimetypeL( const TDesC8& aMimetype );

    /**
     * SetFileSize sets the file size attribute.
     *
     * @since S60 v3.1
     * @param const TInt File size
     */  
    void SetFileSize( const TInt aFileSize );

    /**
     * SetResolution sets the resolution attribute.
     *
     * @since S60 v3.1
     * @param const TSize Resolution
     */  
    void SetResolution( const TSize aResolution );

    /**
     * SetDurationInSeconds sets the duration attribute.
     *
     * @since S60 v3.1
     * @param const TInt64 Duration
     */  
    void SetDurationInSeconds( const TInt64 aDuration );


private:

    CUpnpResParameters();

    void ConstructL();

private: // data
    HBufC8* iProtocolInfo;   // owned
    HBufC8* iMimetype;       // owned
    TInt iFileSize;
    TSize iResolution;
    TInt64 iDurationInSeconds;
    
    };


#endif // C_UPNPRESPARAMETERS_H