/*

* Copyright (c) 2005 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:  

*           Messaging Image Info class.

*

*/

#ifndef __MSGIMAGEINFO_H

#define __MSGIMAGEINFO_H

// INCLUDES

#include <e32std.h>

// CONSTANTS

// MACROS

// FORWARD DECLARATIONS

class RFile;

class TDataType;

class CImageDecoder;

// DATA TYPES

// FUNCTION PROTOTYPES

// CLASS DECLARATION

/**

* Messaging Image Info class.

*

* @lib MsgMedia.lib

* @since 3.1

*/

NONSHARABLE_CLASS( CMsgImageInfo ) : public CMsgMediaInfo

    {

    public:  // New methods

        /**

        * Factory method that creates this object.

        *

        * @param    aFile       IN File handle to create info class from.

        * @param    aMimeType   IN Mime type of the file.

        * @return   pointer to instance

        */

        IMPORT_C static CMsgImageInfo* NewL(

            RFile& aFile, 

            TDataType& aMimeType );

        /**

        * Destructor

        */

        virtual ~CMsgImageInfo();

        /**

        * Get delay.

        *

        * @return   Delay between the first two frames in milliseconds

        */

        inline TInt Delay() const;

        /**

        * Get color depth.

        *

        * @return   Color depth in bits per pixel.

        */

        inline TInt BitsPerPixel() const;

        /**

        * Checks if image is animation.

        *

        * @return   True if is and false if is not.

        */

        inline TBool IsAnimation() const;

        /**

        * Get number of frames.

        *

        * @return   Number of frames in animation.

        */

        inline TInt FrameCount() const;

        /**

        * Get dimensions.

        *

        * @return   Dimensions of unscaled image.

        */

        inline TSize Dimensions() const;

        /**

        * Checks if image is fully scalable.

        *

        * @return   Boolean value.

        */

        inline TBool FullyScalable() const;

        /**

        * Checks if image is transparent.

        *

        * @return   Boolean value.

        */

        inline TBool IsTransparent() const;

    protected:

        /**

        * From CActive

        */

    	void DoCancel();

        /**

        * From CActive

        */

    	void RunL();

    protected:

        enum MyFrameFlags

            {

            EFullyScalable = 0x0001,

            ETransparent   = 0x0002

            };

        /**

        * Constructor.

        *

        * @param    aMimeType   IN Mime type of the file.

        */

        CMsgImageInfo( TDataType& aMimeType );

        /**

        * 2nd phase constructor.

        *

        * @param    aFile       IN File handle to create info class from.

        */

        void ConstructL( RFile& aFile );

        /**

        * Opens the image file and gets info (e.g. dimensions).

        * Called from ConstructL.

        *

        * @param    aFile       IN File handle to create info class from.

        */

        void ResolveImageInfoL( RFile& aFile );

    protected: // data

        TInt    iDelay;

        TInt    iFrames;

        TInt    iBitsPerPixel;

        TSize   iOverallSizeInPixels;

        TUint32 iFrameFlags;

    };

#endif // __MSGIMAGEINFO_H