landmarksui/engine/inc/CLmkEncoder.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 02 Feb 2010 00:16:03 +0200
changeset 0 522cd55cc3d7
child 10 159664f72ed5
permissions -rw-r--r--
Revision: 201003 Kit: 201005

/*
* Copyright (c) 2004 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:    LandmarksUi Content File -    This class wraps functionality related to landmark encoding into
*                a simpler interface.
*
*/







#ifndef CLMKENCODER_H
#define CLMKENCODER_H

//  INCLUDES
#include <EPos_Landmarks.h>
#include "MLmkAOOperationObserver.h"
#include "CLmkLandmark.h"


// FORWARD DECLARATIONS
class CPosLandmarkEncoder;
class CPosLandmarkDatabase;
class CLmkAOOperation;
class CPosLandmark;

// CLASS DECLARATION
/**
 * This class wraps functionality related to landmark encoding into
 * a simpler interface.
 */
class CLmkEncoder : public CBase, public MLmkAOOperationObserver
    {
	public:  // Constructors and destructor

		/**
		* Create CLmkEncoder object
        * @param aDb landmark database
        * @param aObserver calling class setting itself as observer to this class
        * @param aProgressNote Note to show the progress of encoding operation
		* @return newly instantiated object
		*/
		IMPORT_C static CLmkEncoder* NewL( CPosLandmarkDatabase& aDb,
                                           MLmkAOOperationObserver& aObserver,
                                           TBool aProgressNote );

		/**
		* Destructor.
		*/
		~CLmkEncoder();

    protected: //from MLmkAOOperationObserver
        void HandleOperationL( TOperationTypes aType,
                               TReal32 aProgress,
                               TInt aStatus );

    public: // New functions
        /**
        * Set package name
        * @param aName
        */
        //IMPORT_C void SetPackageNameL( const TDesC& aName );

        /**
        * Start encoding package. Possibly existing file is deleted first.
        * @param aFile where parsed data is stored
        * @param aLandmarkIdArray
        */
        IMPORT_C void StartEncodingL( const TDesC& aFile,
                        const RArray<TPosLmItemId>& aLandmarkIdArray );

        /**
        * Start encoding package. Possibly existing file is deleted first.
        * This API can also be used for encoding unsaved landmarks
        * @param aFile where parsed data is stored
        * @param aLandmarks
        */
        IMPORT_C void CLmkEncoder::StartEncodingL(const TDesC& aFileName,
                    	const RPointerArray<CLmkLandmark>& aLandmarks );

        /**
        * Cancel encode operation
        */
        IMPORT_C void CancelEncodeOperationL();

    private:  // New functions
    	/**
        * This function is used for setting the name for landmarks package
        * @param aName Name to be set for landmarks package
        */
    	void SetPackageNameL( const TDesC& aName );

        /**
        * Finalize the encode process. It uses the Landmarks Framework method
        * to signal the finalizing the encode process.
        */
        void FinalizeEncodingL();

        /**
        * Checks if any Active Object is already running. This is used whenever
        * a new Active Object operation is started.
        */
        void LeaveIfInUseL();

        /**
        * Instantiates iEncoder & prepares file to which encoded data is written.
        */
        void PrepareEncoderL(const TDesC& aFileName);

    private:  // Constructors and destructor
        /**
        * C++ default constructor.
        * @param aDb landmark database
        * @param aObserver calling class sets itself as the observer to this class
        * @param aProgressNote Note to show the progress of landmark encoding process
        * @return newly instantiated object
        */
        CLmkEncoder( CPosLandmarkDatabase& aDb,
                    MLmkAOOperationObserver& aObserver,
                    TBool aProgressNote );

        /**
		* By default Symbian 2nd phase constructor is private.
        * @param aFile
		*/
        void ConstructL();

    private:    // Data
        ///Ref:
        CPosLandmarkDatabase& iDb;

        ///Ref:
        MLmkAOOperationObserver& iObserver;

        TBool iProgressNote;

        TBool iExporting; // detailed encoder status

        ///Own: EPos encoder
        CPosLandmarkEncoder* iEncoder;

        ///Own:
        CLmkAOOperation* iAOOperation;
    };

#endif      // CLMKENCODER_H

// End of File