camerauis/cameraxui/cxengine/tsrc/unit/system_include/rlocationtrail.h
author hgs
Fri, 06 Aug 2010 10:03:37 +0300
changeset 46 c826656d6714
parent 42 feebad15db8c
permissions -rw-r--r--
201031
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
     1
/*
46
hgs
parents: 42
diff changeset
     2
* Copyright (c) 2006-2010 Nokia Corporation and/or its subsidiary(-ies). 
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
     3
* All rights reserved.
feebad15db8c 201027_1
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
feebad15db8c 201027_1
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
feebad15db8c 201027_1
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
feebad15db8c 201027_1
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
feebad15db8c 201027_1
hgs
parents:
diff changeset
     8
*
feebad15db8c 201027_1
hgs
parents:
diff changeset
     9
* Initial Contributors:
feebad15db8c 201027_1
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
feebad15db8c 201027_1
hgs
parents:
diff changeset
    11
*
feebad15db8c 201027_1
hgs
parents:
diff changeset
    12
* Contributors:
feebad15db8c 201027_1
hgs
parents:
diff changeset
    13
*
46
hgs
parents: 42
diff changeset
    14
* Description:  An interface to Location Trail.
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    15
*
feebad15db8c 201027_1
hgs
parents:
diff changeset
    16
*/
feebad15db8c 201027_1
hgs
parents:
diff changeset
    17
feebad15db8c 201027_1
hgs
parents:
diff changeset
    18
#ifndef R_RLOCATIONTRAIL_H
feebad15db8c 201027_1
hgs
parents:
diff changeset
    19
#define R_RLOCATIONTRAIL_H
feebad15db8c 201027_1
hgs
parents:
diff changeset
    20
feebad15db8c 201027_1
hgs
parents:
diff changeset
    21
feebad15db8c 201027_1
hgs
parents:
diff changeset
    22
/**
46
hgs
parents: 42
diff changeset
    23
 *  Fake implementation of RLocationManager class which is used for creating a Location Manager session.
hgs
parents: 42
diff changeset
    24
 *  Location Manager is used to start and stop the location trail, retrieve 
hgs
parents: 42
diff changeset
    25
 *  location information and write the location information to images.
hgs
parents: 42
diff changeset
    26
*/
hgs
parents: 42
diff changeset
    27
class  RLocationTrail
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    28
    {
feebad15db8c 201027_1
hgs
parents:
diff changeset
    29
public:
46
hgs
parents: 42
diff changeset
    30
    /**
hgs
parents: 42
diff changeset
    31
     * Location trail states.
hgs
parents: 42
diff changeset
    32
     */
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    33
    enum TTrailState
feebad15db8c 201027_1
hgs
parents:
diff changeset
    34
        {
feebad15db8c 201027_1
hgs
parents:
diff changeset
    35
        ETrailStopped,
feebad15db8c 201027_1
hgs
parents:
diff changeset
    36
        EWaitingGPSData,
feebad15db8c 201027_1
hgs
parents:
diff changeset
    37
        ESearchingGPS,
feebad15db8c 201027_1
hgs
parents:
diff changeset
    38
        ETrailStarted,
feebad15db8c 201027_1
hgs
parents:
diff changeset
    39
        ETrailStopping,
feebad15db8c 201027_1
hgs
parents:
diff changeset
    40
        ETrailStarting
feebad15db8c 201027_1
hgs
parents:
diff changeset
    41
        };
46
hgs
parents: 42
diff changeset
    42
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    43
    enum TTrailCaptureSetting
46
hgs
parents: 42
diff changeset
    44
    	{
hgs
parents: 42
diff changeset
    45
    	EOff,
hgs
parents: 42
diff changeset
    46
    	ECaptureNetworkInfo,
hgs
parents: 42
diff changeset
    47
    	ECaptureAll 
hgs
parents: 42
diff changeset
    48
    	};    
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    49
feebad15db8c 201027_1
hgs
parents:
diff changeset
    50
public:
46
hgs
parents: 42
diff changeset
    51
	RLocationTrail();
hgs
parents: 42
diff changeset
    52
	
hgs
parents: 42
diff changeset
    53
	~RLocationTrail();
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    54
46
hgs
parents: 42
diff changeset
    55
    /**
hgs
parents: 42
diff changeset
    56
     * Starts recording location information to location trail.
hgs
parents: 42
diff changeset
    57
     * @since S60 3.2
hgs
parents: 42
diff changeset
    58
     * @param aState, an enumeration of ECaptureNetworkInfo  
hgs
parents: 42
diff changeset
    59
     * (only cell ID stored) and ECaptureAll 
hgs
parents: 42
diff changeset
    60
     * (GPS coordinates and cell ID stored).
hgs
parents: 42
diff changeset
    61
     * @return KErrNone if successful, otherwise one of the other 
hgs
parents: 42
diff changeset
    62
     *         system-wide error codes.
hgs
parents: 42
diff changeset
    63
     */
hgs
parents: 42
diff changeset
    64
    int StartLocationTrail(TTrailCaptureSetting aState);
hgs
parents: 42
diff changeset
    65
    
hgs
parents: 42
diff changeset
    66
    /**
hgs
parents: 42
diff changeset
    67
     * Stops recording location information to location trail.
hgs
parents: 42
diff changeset
    68
     * @since S60 3.1
hgs
parents: 42
diff changeset
    69
     * @param None.
hgs
parents: 42
diff changeset
    70
     * @return KErrNone if successful, otherwise one of the other 
hgs
parents: 42
diff changeset
    71
     *         system-wide error codes.
hgs
parents: 42
diff changeset
    72
     */
hgs
parents: 42
diff changeset
    73
    int StopLocationTrail();
hgs
parents: 42
diff changeset
    74
    
hgs
parents: 42
diff changeset
    75
    
hgs
parents: 42
diff changeset
    76
    /**
hgs
parents: 42
diff changeset
    77
    * Connect to location trail server
hgs
parents: 42
diff changeset
    78
    * @return KErrNone if successful, otherwise one of the other 
hgs
parents: 42
diff changeset
    79
    *         system-wide error codes.
hgs
parents: 42
diff changeset
    80
    **/
hgs
parents: 42
diff changeset
    81
    int Connect();
hgs
parents: 42
diff changeset
    82
    
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    83
    void Close();
feebad15db8c 201027_1
hgs
parents:
diff changeset
    84
46
hgs
parents: 42
diff changeset
    85
private:
hgs
parents: 42
diff changeset
    86
    bool mTrailConnected;
hgs
parents: 42
diff changeset
    87
    bool mTrailStarted;
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    88
    };
46
hgs
parents: 42
diff changeset
    89
    
42
feebad15db8c 201027_1
hgs
parents:
diff changeset
    90
#endif // R_RLOCATIONTRAIL_H
feebad15db8c 201027_1
hgs
parents:
diff changeset
    91
46
hgs
parents: 42
diff changeset
    92
//End of File