--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mds_plat/location_manager_api/inc/rtracklog.h	Wed Oct 06 15:08:08 2010 +0300
@@ -0,0 +1,199 @@
+/*
+* Copyright (c) 2006-2009 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:  An interface to Track Log.
+*
+*/
+
+#ifndef RTRACKLOG_H_
+#define RTRACKLOG_H_
+
+#include <lbssatellite.h> 
+#include <rlocationmanager.h>
+#include <locationeventdef.h>
+
+// forward declaration
+class MTrackLogObserver;
+class CTrackLogObserverAO;
+
+/*
+ *  TrackLog API is used to start, stop and delete track-logs, 
+ *  to get track-log status and to get track-log in GPX format. 
+ * 
+ *  @lib LocationManager.lib
+ *  @since S60 3.2
+ */
+NONSHARABLE_CLASS( RTrackLog ) : public RLocationManager
+{
+
+public:
+	IMPORT_C RTrackLog();
+	
+	/**
+	 * Starts track-log recording. Also starts location trail recording 
+	 * if it is not already running.
+	 * @since S60 3.2
+	 * @param None.
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */ 
+	IMPORT_C TInt StartTrackLog();
+	
+	/**
+	 * Stops track-log recording.
+	 * @since S60 3.2
+	 * @param None.
+	 * @return None.
+	 */ 
+	IMPORT_C void StopTrackLog();
+	
+	/**
+	 * Gets the status of track-log recording and GPS signal quality.
+	 * @since S60 3.2
+	 * @param aRecording, indicating track log recording status
+	 * @param aFixQuality, GPS signal quality
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */ 
+	IMPORT_C TInt GetStatus(TBool& aRecording, TPositionSatelliteInfo& aFixQuality);
+
+	/**
+	 * Deletes a track-log file
+	 * @since S60 3.2
+	 * @param aUri, Track log URI
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */ 
+	IMPORT_C TInt DeleteTrackLog(TDesC& aUri);
+	
+	/**
+	 * Returns a boolean indicating track-log recording status.
+	 * @since S60 3.2
+	 * @param None.
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */ 
+	IMPORT_C TBool IsRecording();
+	
+	/**
+	 * Registers a new track-log observer.
+	 * @since S60 3.2
+	 * @param aObserver, observer which is added.
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */
+	IMPORT_C TInt AddObserver(MTrackLogObserver* aObserver );
+	
+	/**
+	 * Removes a registered track-log observer.
+	 * @since S60 3.2
+	 * @param aObserver, observer which is removed.
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */
+	IMPORT_C TInt RemoveObserver(MTrackLogObserver* aObserver);
+	
+	/**
+	 * Returns the name of the current track-log file.
+	 * @since S60 3.2
+	 * @param aTrackLogName, track log file name
+	 * @return KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 */
+	IMPORT_C TInt TrackLogName(TDes& aTrackLogName);
+	
+	/**
+	 * Overrides inherited class close.
+	 * Close observers array and calls main class close.
+	 * @since S60 3.2
+	 * @param None.
+	 * @return None.
+	 */ 
+	IMPORT_C void Close();
+	
+public:
+	
+	/**
+	 * @param aStatus, the request status of the active object
+	 * @return None.
+	 */	
+	void SendNotifyRequest( TRequestStatus& aStatus );
+	
+	/**
+	 * Notifies of an event in tracklog. The event can be of type EStarted/EStopped/ESignalChanged.
+	 * @param aError error code
+	 * @return None.
+	 */
+	void TrackLogEvent( TInt aError );
+
+	
+private:
+	/**
+	 * Array of observers
+	 */ 
+	RPointerArray<MTrackLogObserver> iObservers;
+	
+	TBool iSubscribed;
+	/**
+	 * An active object that observes tracklog events (starting/stopping/GPS fix quality changes).
+	 */
+	CTrackLogObserverAO* iTrackLogObserverAO;
+	
+	TPositionSatelliteInfo iFixQuality;
+	TBool iRecording;
+	TEventTypes iEventType;
+	TPckg<TPositionSatelliteInfo> iWrapQuality;
+	TPckg<TBool> iWrapRec;
+	TPckg<TEventTypes> iWrapEventType;
+};
+
+/**
+ * Track log Observer interface class for receiving track-log events.
+ */ 
+class MTrackLogObserver
+{
+
+public:
+	/**
+	 * Called to notify the observer that the 
+	 * Track-log recording has started.
+	 * 
+	 * @param aError, KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 * @return None.
+	 */ 
+	virtual void TrackLogStarted(TInt aError) = 0;
+	
+	/**
+	 * Called to notify the observer that the 
+	 * Track-log recording was stopped.
+	 * 
+	 * @param aError, KErrNone if successful, otherwise one of the other 
+     *       system-wide error codes.
+	 * @return None.
+	 */ 
+	virtual void TrackLogStopped(TInt aError) = 0;
+	
+	/**
+	 * Called to notify the observer that the 
+	 * GPS fix quality has changed.
+	 * 
+	 * @param aFixQuality, GPS signal quality
+	 * @param aTrackingActive, Is Tracking active
+	 * @return None.
+	 */ 
+	virtual void GPSFixQualityChanged(TPositionSatelliteInfo& aFixQuality, TBool& aTrackingActive) = 0;
+	
+private:
+};
+#endif /*RTRACKLOG_H_*/