* to control the map size, orientation (heading), zoom level, and managing
* objects such as markers, polylines and polygons that can be superimposed on
* the map.
- *
+ *
* \ingroup maps
*/
class EXPORT_API GeoTiledMap
/// day map.
MT_Satellite_Day, ///< Indicates a satellite day map.
MT_Terrain_Day, ///< Indicates a terrain day map.
- MT_Hybrid_Day, ///< Indicates a hybrid day map
+ MT_Hybrid_Day, ///< Indicates a hybrid day map
/// (satellite, with roads and labels).
#ifdef TIZEN_MIGRATION
MT_Normal_Day_Grey,
MT_Carnav_Day_Grey,
#endif
MT_Last_Entry_Undefined ///< Indicates that the map type is not
- /// defined.
+ /// defined.
};
/**
/**
* This method sets the size of the map.
- *
+ *
* @param size A constant reference to an object specifying the size of the
* map in pixels (width and height).
*/
/**
* This method sets the map zoom level.
- *
+ *
* @param zoomLevel A value indicating the new zoom level.
*/
#ifdef TIZEN_MIGRATION
#else
void SetZoomLevel(double zoomLevel);
#endif
-
+
/**
* This method retrieves the map zoom level.
*
* @return A value indicating the new zoom level.
*/
double GetZoomLevel() const;
-
+
/**
* This method retrieves the minimum map zoom level.
*
* @return A value indicating the minimum map zoom level.
*/
double GetMinimumZoomLevel() const;
-
+
#ifdef TIZEN_CUSTOMIZATION
/**
* This method sets the minimum map zoom level.
*/
void SetMaximumZoomLevel(double zoomLevel);
#endif
-
+
/**
* This method pans the map the caller-specified number of pixels
* horizontally and vertically.
void Pan(int dx, int dy);
/**
- * This method sets the coordinates of the map center.
- *
+ * This method sets the coordinates of the map center.
+ *
* @param center A constant reference to an object containing the new
* geographic coordinates of the map center.
*/
void SetCenter(const GeoCoordinates& center);
/**
- * This method retrieves the coordinates of the map center.
- *
+ * This method retrieves the coordinates of the map center.
+ *
* @return A constant reference to an object containing the
* geographic coordinates of the map center.
*/
/**
* This method invalidates (discards) all the map objects, including
- * markers.
+ * markers.
*/
void InvalidateMapObjects();
/**
* This method clears all the map objects associated with the given tiled
- * map object.
+ * map object.
*/
void ClearMapObjects();
* This method converts the geographic location specified by the caller to
* screen coordinates, taking into consideration the current zoom level and
* the view area.
- *
+ *
* @param coordinate A constant reference to an object containing the
* coordinates to convert.
- *
+ *
* @return An object containing the x and y coordinates defining the screen
* location.
*/
* This method converts the screen position specified by the caller to
* geographic coordinates. The method is called, for example, when a marker
* is being added to the map.
- *
+ *
* @param screenPosition An object containing the x and y coordinates
* defining the screen location to convert.
- *
+ *
* @return An object containing the geographic coordinates of corresponding
* to the received screen position.
*/
/**
* This method adds an object to the map. The object is a marker, a polygon
* or polyline, or a group of objects.
- *
+ *
* @param obj A pointer to an object to add to the map. If the object does
* not exist (is <code>NULL</code>), the method has no effect.
- *
+ *
* @param bTransferOwnership A Boolean value indicating if the ownership of
* the map object given in the first parameter should be transferred
* to this map instance (<code>true</code>, default) or not
void AddObject(GeoMapObject* obj, bool bTransferOwnership=true);
/**
- * This method removes the object specified by the caller from the map.
- *
+ * This method removes the object specified by the caller from the map.
+ *
* @param obj A pointer to the object to remove from the map. If the object
* does not exist (is <code>NULL</code>), the method has no effect.
- *
+ *
* @return Boolean value indicating if the removal of the object was
* successful (<code>true</code>) or not (<code>false</code>).
*/
/**
* This method obtains a pointer to the map object located at the screen
* position indicated by the caller.
- *
+ *
* @param point A constant reference to an object containing the pixel
* coordinates of the screen position from which to get the map object.
- *
+ *
* @return A pointer to the map object at the specified screen location,
* otherwise <code>NULL</code> if no map object is found.
*/
/**
* This method obtains a count of marker objects in the given tiled map.
- *
+ *
* @return A value that indicates the number of marker objects.
*/
size_t GetNumMarkerObjects() const;
/**
* This method retrieves a pointer to a marker object at the index specified
* by the caller.
- *
+ *
* @param idx A value specifying the index of the marker object to
- * retrieve.
- *
+ * retrieve.
+ *
* @return A pointer to the marker object at the specified index or
* <code>NULL</code> if the index is invalid.
*/
* This method draws (renders and displays) a map image of the size
* specified by the caller. The displayed map includes the required map
* tiles as well as any objects such as markers, polygons and polylines.
- *
+ *
* @param uWidth A value specifying the width of the map image.
- *
- * @param uHeight A value specifying the height of the map image.
- *
+ *
+ * @param uHeight A value specifying the height of the map image.
+ *
* @return A Boolean, <code>true</code> if the map has been successfully
* pained, otherwise <code>false</code>.
*/
/**
* This method sets a callback to be invoked when the map has
- * been updated.
- *
+ * been updated.
+ *
* @param slot A function object to be called when the map has
- * been updated.
+ * been updated.
*/
void SetUpdateMapSignal(UpdateMapSignalFunctor slot);
/**
* This method sets the map type.
- *
+ *
* @param aMapType A value indicating the new map type.
*/
void SetMapType(MapType aMapType);
/**
* This method retrieves the map type.
- *
+ *
* @return A value indicating the current map type.
*/
MapType GetMapType() const;
* L"ara", L"chi", L"cht", L"dut", L"eng", L"ger", L"gle", L"fre", L"ita", L"spa", L"rus", L"pol", L"gre", L"wel"
*/
/**
- * This method sets the language of the map.
- *
+ * This method sets the language of the map.
+ *
* @param aMapLanguage A constant reference to a string containing a
* language code. The value of the string must be one of "ara"
* (Arabic), "chi" (Chinese), "cht" (Chinese-Taiwan), "dut" (Dutch),
void SetMapLanguage(const String& aMapLanguage);
/**
- * This method retrieves the current language of the map.
- *
+ * This method retrieves the current language of the map.
+ *
* @return A constant reference to a string containing the language code,
* which is one of "ara" (Arabic), "chi" (Chinese), "cht"
* (Chinese-Taiwan), "dut" (Dutch), "eng" (English), "ger" (German),
/**
* This method retrieves the size of the tiles, used for rendering the map.
- *
+ *
* @return An unsigned integer indicating the size of the map tiles.
*/
unsigned int GetTileSize() const;
/**
* This method changes the background color of the map.
* The background color is updated after refreshing the map.
- *
+ *
* @param color A constant reference to an object representing the new map
* background color.
*/
#ifdef TIZEN_CUSTOMIZATION
/**
* This method retrieves the root tile, used for rendering the map.
- *
+ *
* @return An pointer indicating the bitmap of the root tile.
*/
DrawableBitmapPtr GetRootPixmap() const;
/**
* This method sets a pointer of a structure of the Evas GL API object that
* contains the GL APIs to be used in Evas GL.
- *
- * @param __glapi A pointer to a structure of the Evas GL API object.
+ *
+ * @param __glapi A pointer to a structure of the Evas GL API object.
*/
void SetEvasGlApi(Evas_GL_API *__glapi);
* @param yFactor The propotional y-position of the logo [0.0~1.0].
*/
void SetLogoPosition(double xFactor, double yFactor);
+
+ /**
+ * This method retrieves the scale of the whole map.
+ *
+ * @return A value indicating the scale of the whole map.
+ */
+ double GetScale();
+
+ /**
+ * This method sets the scale of the whole map view.
+ *
+ * @return scale The scale of the whole map view.
+ */
+ void SetScale(double scale);
#endif
#ifdef TIZEN_SUPPORT_TILE_FILE_CACHE