/*
* Copyright (c) 2004-2007 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:  
*     See class description below
*
*/


#ifndef __LANDMARKS_UTILS_H__
#define __LANDMARKS_UTILS_H__

/** 
* Coordinate data conversion utility methods
*/
class LandmarksUtils
    {
      public:

        /** Converts a float to a descriptor.
        * Handles the case when the float is NaN
        * @param aFloat the source float
        * @param aDes the target descriptor
        * @param aRealFormat Format used for real value conversion to text
        */
        static void FloatToDes(TReal aFloat, TDes& aDes, TRealFormat aRealFormat);

        /** Converts a float lat/long to a descriptor.
        * Handles the case when the float is NaN
        * @param aFloat the source float
        * @param aDes the target descriptor
        */
        static void LatLongToDes(TReal aFloat, TDes& aDes);

        /** Converts a latitude or longitude in float format 
        * to a descriptor containing degrees, minutes and seconds.
        *
        * @param aLatLong the source float
        * @param aDes the target descriptor (degrees, minutes and seconds)
        */
        static void LatLongFloatToDegMinSecDesL(TReal aLatLong, TDes& aDes);
        
        /** Panics the application due to some programming error
        * @param aReason The panic number or error code
        */
        static void Panic(TInt aReason);
        
        /** Pops up error note for user with given text */
        static void ErrorNoteL( const TDesC& aErrorText );
      
        /** Pops up information note for user with given text */
        static void InfoNoteL( const TDesC& aInfoText );

      private:
      
        //! Internal struct for LatLongFloatToDegMinSecDesL
        struct SDegMinSec
            {
            //! degrees
            TInt32 iDegrees;
            //! minutes
            TInt32 iMinutes;
            //! seconds
            TReal iSeconds;
            };
    };

#endif // __LANDMARKS_UTILS_H__