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