2 * @defgroup Fingers Fingers
4 * Elementary is designed to be finger-friendly for touchscreens,
5 * and so in addition to scaling for display resolution, it can
6 * also scale based on finger "resolution" (or size). You can then
7 * customize the granularity of the areas meant to receive clicks
10 * Different profiles may have pre-set values for finger sizes.
12 * @ref general_functions_example_page "This" example contemplates
13 * some of these functions.
19 * Adjust size of an element for finger usage.
21 * @param times_w How many fingers should fit horizontally
22 * @param w Pointer to the width size to adjust
23 * @param times_h How many fingers should fit vertically
24 * @param h Pointer to the height size to adjust
26 * This takes width and height sizes (in pixels) as input and a
27 * size multiple (which is how many fingers you want to place
28 * within the area, being "finger" the size set by
29 * elm_finger_size_set()), and adjusts the size to be large enough
30 * to accommodate the resulting size -- if it doesn't already
31 * accommodate it. On return the @p w and @p h sizes pointed to by
32 * these parameters will be modified, on those conditions.
34 * @note This is kind of low level Elementary call, most useful
35 * on size evaluation times for widgets. An external user wouldn't
36 * be calling, most of the time.
40 EAPI void elm_coords_finger_size_adjust(int times_w, Evas_Coord *w, int times_h, Evas_Coord *h);