/*
* Copyright (c) 2008 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:  Java Installer component iconconverter.
*                Reads icon and .jar file and stores it a temp file in a
*                format that can be shown by the S60 UI shell.
*
*/


#ifndef ICONCONVERTER_H
#define ICONCONVERTER_H

#include <e32base.h>
#include <fbs.h>
#include <imageconversion.h>


namespace java
{

NONSHARABLE_CLASS(CActiveListener) : public CActive
{
public:
    CActiveListener() : CActive(CActive::EPriorityIdle)
    {
        CActiveScheduler::Add(this);
    }
    void InitialiseActiveListener()
    {
        SetActive();
    }
    // From CActive
    virtual void RunL()
    {
        CActiveScheduler::Stop();
    }
    virtual void DoCancel() {};
};


/**
* Reads the icon from specified .jar file, converts it to format
* supported by S60 UI shell and returns it in a temporary file.
*
*/
NONSHARABLE_CLASS(CIconConverter) : public CBase
{
public:

    /**
     * NewL constructor
     * Constructs a new CIconConverter object
     *
     * @param[in] aFs file session
     * @return pointer to new IconConverter
     */
    static CIconConverter* NewL(RFs& aRFs);

    /**
     * Read iconFile in aJarFile, if it is SVG icon
     * use CMifConverter to convert it to MIF,
     * otherwise convert it to MBM,
     * store it to output file
     *
     * @param[in] aJarFile jar file that contains the icon
     * @param[in] aIconFile the path name of icon inside jar
     * @param[in] aOutputFile the name of the file where the converted icon
     *   must be stored to
     * @param[out] apWasMbm The value pointed by this parameter will be set to
     *   ETrue if the icon was converted to MBM, otherwise it is set to EFalse
     * @return Symbian error code in case of an error,
     *   KErrNone is conversion succeeds
     */
    int Convert(
        const TDesC &aJarFile,
        const TDesC &aIconFile,
        const TDesC &aOutputFile,
        TBool *apWasMbm);

    /**
     * Destroy the object and release all internal memory objects.
     * Does not close file session.
     */
    ~CIconConverter();

    /**
     * Logs the names of all MIME types that IconConverter supports
     * in the current device. Also the corresponding file extensions
     * are logged.
     */
    static void LogAllSupportedMimeTypes();

private:
    /**
     * Constructor
     * Constructs a new CIconConverter object
     *
     * @param[in] aFs file session
     * @return pointer to new IconConverter
     */
    CIconConverter(RFs &aRFs);

    /**
     * Reads icon from .jar file and then based on the type of
     * icon calls either ConvertNormalIconL or
     * ConvertScalableIconL
     *
     * @param[in] aJarFile jar file that contains the icon
     * @param[in] aIconFile the path name of icon inside jar
     * @param[in] aOutputFile the name of the file where the converted icon
     *   must be stored to
     * @param[out] apWasMbm The value pointed by this parameter will be set to
     *   ETrue if the icon was converted to MBM, otherwise it is set to EFalse
     * @return Symbian error code in case of an error,
     *   KErrNone is conversion succeeds
     */
    int ConvertL(
        const TDesC &aJarFile,
        const TDesC &aIconFile,
        const TDesC &aOutputFile,
        TBool *apWasMbm);

    /**
     * Real implementation of Convert for normal icons.
     * Uses iImageDecoder to convert icon to mbm.
     *
     * @param[in] apIconBuf
     * @param[in] aptrIconBuf
     * @param[in] aOutputFile the name of the file where the converted icon
     *   must be stored to
     * @return Symbian error code in case of an error,
     *   KErrNone is conversion succeeds
     */
    int ConvertNormalIconL(
        HBufC8*      apIconBuf,
        TPtr8       &aptrIconBuf,
        const TDesC &aOutputFile);

    /**
     * Real implementation of Convert for scalable icons.
     * Uses CMifConverter to convert svg to mif
     *
     * @param[in] apIconBuf
     * @param[in] aOutputFile the name of the file where the converted icon
     *   must be stored to
     * @return Symbian error code in case of an error,
     *   KErrNone is conversion succeeds
     */
    int ConvertScalableIconL(
        HBufC8*      apIconBuf,
        const TDesC &aOutputFile);


private:
    /**
     * File server session. Shared with the caller.
     * Do not close.
     */
    RFs iRFs;

    /**
     * Converts from any format supported by the conversion
     * plugins in the S60 system to bitmap.
     */
    CBufferedImageDecoder* iImageDecoder;

    /**
     * Pointer to bitmap generated from the icon
     */
    CFbsBitmap* iBitmap;

    /**
     * Pointer to the bitmap mask generated from the icon.
     * May be NULL if the original icon not not have mask.
     */
    CFbsBitmap* iBitmapMask;

    CActiveListener *iActiveListener;

};

} // namespace java

#endif // ICONCONVERTER_H