summaryrefslogtreecommitdiff
path: root/src/lib/elm_route.h
blob: 5a88ff6e29c51849437c41ad12d300752e82dd73 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
/**
 * @defgroup Route Route
 * @ingroup Elementary
 *
 * @image html route_inheritance_tree.png
 * @image latex route_inheritance_tree.eps
 *
 * For displaying a route on the map widget.
 *
 * @{
 */

#define ELM_OBJ_ROUTE_CLASS elm_obj_route_class_get()

const Eo_Class *elm_obj_route_class_get(void) EINA_CONST;

extern EAPI Eo_Op ELM_OBJ_ROUTE_BASE_ID;

enum
{
   ELM_OBJ_ROUTE_SUB_ID_EMAP_SET,
   ELM_OBJ_ROUTE_SUB_ID_LONGITUDE_MIN_MAX_GET,
   ELM_OBJ_ROUTE_SUB_ID_LATITUDE_MIN_MAX_GET,
   ELM_OBJ_ROUTE_SUB_ID_LAST
};

#define ELM_OBJ_ROUTE_ID(sub_id) (ELM_OBJ_ROUTE_BASE_ID + sub_id)


/**
 * @def elm_obj_route_emap_set
 * @since 1.8
 *
 * No description supplied by the EAPI.
 *
 * @param[in] emap
 *
 * @see elm_route_emap_set
 */
#define elm_obj_route_emap_set(emap) ELM_OBJ_ROUTE_ID(ELM_OBJ_ROUTE_SUB_ID_EMAP_SET), EO_TYPECHECK(EMap_Route *, emap)

/**
 * @def elm_obj_route_longitude_min_max_get
 * @since 1.8
 *
 * Get the minimum and maximum values along the longitude.
 *
 * @param[out] min
 * @param[out] max
 *
 * @see elm_route_longitude_min_max_get
 */
#define elm_obj_route_longitude_min_max_get(min, max) ELM_OBJ_ROUTE_ID(ELM_OBJ_ROUTE_SUB_ID_LONGITUDE_MIN_MAX_GET), EO_TYPECHECK(double *, min), EO_TYPECHECK(double *, max)

/**
 * @def elm_obj_route_latitude_min_max_get
 * @since 1.8
 *
 * Get the minimum and maximum values along the latitude.
 *
 * @param[out] min
 * @param[out] max
 *
 * @see elm_route_latitude_min_max_get
 */
#define elm_obj_route_latitude_min_max_get(min, max) ELM_OBJ_ROUTE_ID(ELM_OBJ_ROUTE_SUB_ID_LATITUDE_MIN_MAX_GET), EO_TYPECHECK(double *, min), EO_TYPECHECK(double *, max)

/**
 * Add a new route object to the parent's canvas
 *
 * @param parent The parent object
 * @return The new object or NULL if it cannot be created
 *
 * @ingroup Route
 */
EAPI Evas_Object *elm_route_add(Evas_Object *parent);

#ifdef ELM_EMAP
EAPI void         elm_route_emap_set(Evas_Object *obj, EMap_Route *emap);
#endif

/**
 * Get the minimum and maximum values along the longitude.
 *
 * @param obj The route object.
 * @param min Pointer to store the minimum value.
 * @param max Pointer to store the maximum value.
 *
 * @note If only one value is needed, the other pointer can be passed
 * as @c NULL.
 *
 * @ingroup Route
 */
EAPI void        elm_route_longitude_min_max_get(const Evas_Object *obj, double *min, double *max);

/**
 * Get the minimum and maximum values along the latitude.
 *
 * @param obj The route object.
 * @param min Pointer to store the minimum value.
 * @param max Pointer to store the maximum value.
 *
 * @note If only one value is needed, the other pointer can be passed
 * as @c NULL.
 *
 * @ingroup Route
 */
EAPI void        elm_route_latitude_min_max_get(const Evas_Object *obj, double *min, double *max);

/**
 * @}
 */