Example_Evas_Size_Hints(3)

NAME
Example_Evas_Size_Hints - Evas alignment, minimum size, maximum size, padding and weight hints example In this code, we place a (vertical) box with two rectangles as child elements.

It has a command line interface with which to act on those rectangles' size hints:

static const char commands[] =   "commands are:
  "	Shift + a - change alignment hints on top rectangle
  "	Shift + m - change min. size hint on top rectangle
  "	Shift + n - change max. size hint on top rectangle
  "	Shift + p - change padding hints on top rectangle
  "	Shift + w - change weight hints on top rectanglen"
  "	Control + a - change alignment hints on bottom rectangle
  "	Control + m - change min. size hint on bottom rectangle
  "	Control + n - change max. size hint on bottom rectangle
  "	Control + p - change padding hints on bottom rectangle
  "	Control + w - change weight hints on bottom rectanglen"
  "	s - print current hints information
  "	h - print help;

 That should be self explanatory. Change those values (possibly resizing the box, which will resize together with the example's window) to get how size hints are honored by a container object, which in this case is the Evas box.

More on this smart object can be found on Evas box example. The full code for this example follows.

#ifdef HAVE_CONFIG_H
#include "config.h"
#else
#define PACKAGE_EXAMPLES_DIR "."
#endif
#include <Ecore.h>
#include <Ecore_Evas.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include "evas-common.h"
#define WIDTH  320
#define HEIGHT 480
static const char commands[] =   "commands are:
  "	Shift + a - change alignment hints on top rectangle
  "	Shift + m - change min. size hint on top rectangle
  "	Shift + n - change max. size hint on top rectangle
  "	Shift + p - change padding hints on top rectangle
  "	Shift + w - change weight hints on top rectanglen"
  "	Control + a - change alignment hints on bottom rectangle
  "	Control + m - change min. size hint on bottom rectangle
  "	Control + n - change max. size hint on bottom rectangle
  "	Control + p - change padding hints on bottom rectangle
  "	Control + w - change weight hints on bottom rectanglen"
  "	s - print current hints information
  "	h - print help;
static const char *border_img_path = PACKAGE_EXAMPLES_DIR EVAS_IMAGE_FOLDER "/red.png";
struct coord_tuple
{
   Evas_Coord w, h;
};
struct weight_tuple
{
   double x, y;
};
struct padding_tuple
{
   Evas_Coord l, r, t, b;
};
struct rect_data
{
   struct coord_tuple   *min_ptr;
   struct coord_tuple    min[4];
   struct coord_tuple   *max_ptr;
   struct coord_tuple    max[4];
   struct weight_tuple  *align_ptr;
   struct weight_tuple   align[3];
   struct weight_tuple  *weight_ptr;
   struct weight_tuple   weight[3];
   struct padding_tuple *padding_ptr;
   struct padding_tuple  padding[3];
};
struct test_data
{
   Ecore_Evas      *ee;
   Evas            *canvas;
   struct rect_data t_data, b_data;
   Evas_Object     *bg, *box, *t_rect, *b_rect, *border;
};
static struct test_data d = {0};
/* Keep the example's window size in sync with the background image's size */
static void
_canvas_resize_cb(Ecore_Evas *ee)
{
   int w, h;
   ecore_evas_geometry_get(ee, NULL, NULL, &w, &h);
   evas_object_resize(d.bg, w, h);
   evas_object_move(d.box, (w / 4), (h / 4));
   evas_object_resize(d.box, (w / 2), (h / 2));
   evas_object_move(d.border, (w / 4) - 3, (h / 4) - 3);
   evas_object_resize(d.border, (w / 2) + 6, (h / 2) + 6);
}
static void
_print_rect_stats(Evas_Object *rect)
{
   Evas_Coord w, h, l, r, t, b;
   Eina_Size2D cmin;
   double x, y;
   evas_object_size_hint_align_get(rect, &x, &y);
   printf("	align hints: h(%f), v(%f),
          x, y);
   cmin = efl_gfx_hint_size_combined_min_get(rect);
   printf("	min. size hints: h(%d), v(%d),
          cmin.w, cmin.h);
   evas_object_size_hint_max_get(rect, &w, &h);
   printf("	max. size hints: h(%d), v(%d),
          w, h);
   evas_object_size_hint_padding_get(rect, &l, &r, &t, &b);
   printf("	padding hints: l(%d), r(%d), t(%d), b(%d),
          l, r, t, b);
   evas_object_size_hint_weight_get(rect, &x, &y);
   printf("	weight hints: h(%f), v(%f),
          x, y);
}
/* use the following commands to interact with this example - 'h' is
 * the key for help */
static void
_on_keydown(void        *data EINA_UNUSED,
            Evas        *evas EINA_UNUSED,
            Evas_Object *o EINA_UNUSED,
            void        *einfo)
{
   Evas_Event_Key_Down *ev = einfo;
   struct rect_data *r_data = NULL;
   const Evas_Modifier *mods;
   Evas_Object *rect = NULL;
   const char *name = NULL;
   mods = evas_key_modifier_get(evas);
   if (evas_key_modifier_is_set(mods, "Shift"))
     {
        rect = d.t_rect;
        r_data = &d.t_data;
        name = "top";
     }
   else if (evas_key_modifier_is_set(mods, "Control"))
     {
        rect = d.b_rect;
        r_data = &d.b_data;
        name = "bottom";
     }
   else if (strcmp(ev->key, "h") == 0) /* print help */
     {
        printf(commands);
        return;
     }
   else if (strcmp(ev->key, "s") == 0) /* get aspect status of the
                                            * rectangles WRT size
                                            * hints */
     {
        printf("Top rectangle:);
        _print_rect_stats(d.t_rect);
        printf("ottom rectangle:);
        _print_rect_stats(d.b_rect);
        return;
     }
   if (!rect) return;
   if (strcmp(ev->key, "a") == 0) /* alignment hints */
     {
        (r_data->align_ptr)++;
        if ((unsigned int)
            (((unsigned char *)(r_data->align_ptr)) - ((unsigned char *)(r_data->align))) >=
            sizeof(r_data->align))
          r_data->align_ptr = r_data->align;
        evas_object_size_hint_align_set(
          rect, r_data->align_ptr->x, r_data->align_ptr->y);
        printf("Changing align hints for %s rect. to (%f, %f),
               name, r_data->align_ptr->x, r_data->align_ptr->y);
        return;
     }
   if (strcmp(ev->key, "m") == 0) /* min. size hints */
     {
        (r_data->min_ptr)++;
        if ((unsigned int)
            (((unsigned char *)(r_data->min_ptr)) - ((unsigned char *)(r_data->min))) >=
            sizeof(r_data->min))
          r_data->min_ptr = r_data->min;
        evas_object_size_hint_min_set(
          rect, r_data->min_ptr->w, r_data->min_ptr->h);
        printf("Changing min. size hints for %s rect. to (%d, %d),
               name, r_data->min_ptr->w, r_data->min_ptr->h);
        return;
     }
   if (strcmp(ev->key, "n") == 0) /* max. size hints */
     {
        (r_data->max_ptr)++;
        if ((unsigned int)
            (((unsigned char *)(r_data->max_ptr)) - ((unsigned char *)(r_data->max))) >=
            sizeof(r_data->max))
          r_data->max_ptr = r_data->max;
        evas_object_size_hint_max_set(
          rect, r_data->max_ptr->w, r_data->max_ptr->h);
        printf("Changing max. size hints for %s rect. to (%d, %d),
               name, r_data->max_ptr->w, r_data->max_ptr->h);
        return;
     }
   if (strcmp(ev->key, "p") == 0) /* padding size hints */
     {
        (r_data->padding_ptr)++;
        if ((unsigned int)
            (((unsigned char *)(r_data->padding_ptr)) - ((unsigned char *)(r_data->padding))) >=
            sizeof(r_data->padding))
          r_data->padding_ptr = r_data->padding;
        evas_object_size_hint_padding_set(
          rect, r_data->padding_ptr->l, r_data->padding_ptr->r,
          r_data->padding_ptr->t, r_data->padding_ptr->b);
        printf("Changing padding size hints for %s rect. to (%d, %d, %d, %d),
               name, r_data->padding_ptr->l, r_data->padding_ptr->r,
               r_data->padding_ptr->t, r_data->padding_ptr->b);
        return;
     }
   /* experiment with weights here. keep in mind that, for the box
    * object, only if all the children have non zero weights this hint
    * will have an effect */
   if (strcmp(ev->key, "w") == 0) /* weight hints */
     {
        (r_data->weight_ptr)++;
        if ((unsigned int)
            (((unsigned char *)(r_data->weight_ptr)) - ((unsigned char *)(r_data->weight))) >=
            sizeof(r_data->weight))
          r_data->weight_ptr = r_data->weight;
        evas_object_size_hint_weight_set(
          rect, r_data->weight_ptr->x, r_data->weight_ptr->y);
        printf("Changing weight hints for %s rect. to (%f, %f),
               name, r_data->weight_ptr->x, r_data->weight_ptr->y);
        return;
     }
}
static void
_on_destroy(Ecore_Evas *ee EINA_UNUSED)
{
   ecore_main_loop_quit();
}
int
main(void)
{
   if (!ecore_evas_init())
     return EXIT_FAILURE;
   /* init values one is going to cycle through while running this
    * example */
   struct rect_data init_data =    {
      .min = {{0, 0}, {30, 30}, {100, 70}, {200, 200}},
      .max = {{0, 0}, {100, 100}, {100, 70}, {300, 300}},
      .align = {{0.0, 0.0}, {0.5, 0.5}, {1.0, 0.5}},
      .weight = {{0.0, 0.0}, {3, 6}, {10, 100}},
      .padding = {{0, 0, 0, 0}, {3, 6, 9, 12}, {10, 20, 0, 30}}
   };
   d.t_data = init_data;
   d.t_data.min_ptr = d.t_data.min + 1;
   d.t_data.max_ptr = d.t_data.max + 1;
   d.t_data.align_ptr = d.t_data.align;
   d.t_data.weight_ptr = d.t_data.weight;
   d.t_data.padding_ptr = d.t_data.padding;
   d.b_data = init_data;
   d.b_data.min_ptr = d.b_data.min + 1;
   d.b_data.max_ptr = d.b_data.max + 1;
   d.b_data.align_ptr = d.b_data.align;
   d.b_data.weight_ptr = d.b_data.weight;
   d.b_data.padding_ptr = d.b_data.padding;
   /* this will give you a window with an Evas canvas under the first
    * engine available */
   d.ee = ecore_evas_new(NULL, 0, 0, WIDTH, HEIGHT, NULL);
   if (!d.ee)
     goto error;
   ecore_evas_callback_destroy_set(d.ee, _on_destroy);
   ecore_evas_callback_resize_set(d.ee, _canvas_resize_cb);
   ecore_evas_show(d.ee);
   /* the canvas pointer, de facto */
   d.canvas = ecore_evas_get(d.ee);
   d.bg = evas_object_rectangle_add(d.canvas);
   evas_object_color_set(d.bg, 255, 255, 255, 255); /* white bg */
   evas_object_move(d.bg, 0, 0); /* at canvas' origin */
   evas_object_resize(d.bg, WIDTH, HEIGHT); /* covers full canvas */
   evas_object_show(d.bg);
   evas_object_focus_set(d.bg, EINA_TRUE);
   evas_object_event_callback_add(
     d.bg, EVAS_CALLBACK_KEY_DOWN, _on_keydown, NULL);
   /* Evas box with vertical layout */
   d.box = evas_object_box_add(d.canvas);
   evas_object_box_layout_set(
     d.box, evas_object_box_layout_vertical, NULL, NULL);
   evas_object_show(d.box);
   /* this is a border around the box, container of the rectangles we
    * are going to experiment with (changing some size hints). this
    * way you can see how the container relates to the children */
   d.border = evas_object_image_filled_add(d.canvas);
   evas_object_image_file_set(d.border, border_img_path, NULL);
   evas_object_image_border_set(d.border, 3, 3, 3, 3);
   evas_object_image_border_center_fill_set(d.border, EVAS_BORDER_FILL_NONE);
   evas_object_show(d.border);
   d.t_rect = evas_object_rectangle_add(d.canvas);
   evas_object_color_set(d.t_rect, 0, 0, 255, 255);
   evas_object_size_hint_min_set(
          d.t_rect, d.t_data.min_ptr->w, d.t_data.min_ptr->h);
   evas_object_show(d.t_rect);
   evas_object_box_append(d.box, d.t_rect);
   d.b_rect = evas_object_rectangle_add(d.canvas);
   evas_object_color_set(d.b_rect, 0, 255, 0, 255);
   evas_object_size_hint_min_set(
          d.b_rect, d.b_data.min_ptr->w, d.b_data.min_ptr->h);
   evas_object_show(d.b_rect);
   evas_object_box_append(d.box, d.b_rect);
   _canvas_resize_cb(d.ee);
   printf(commands);
   ecore_main_loop_begin();
   ecore_evas_shutdown();
   return 0;
error:
   fprintf(stderr, "error: Requires at least one Evas engine built and linked"
                   " to ecore-evas for this example to run properly.);
   return -1;
}