Free list of font descriptions returned by evas_font_dir_available_list().

Parameters:

e	The evas instance that returned such list.
available	the list returned by evas_font_dir_available_list().

Since :

3.0

Get the Evas object stacked right above obj

Returns:

the Evas_Object directly above obj, if any, or NULL, if none

This function will traverse layers in its search, if there are objects on layers above the one obj is placed at.

See also:

evas_object_layer_get()

evas_object_layer_set()

evas_object_below_get()

Since :

2.3.1

Examples:

evas-stacking.c.

Get the Evas object stacked right below obj

Returns:

the Evas_Object directly below obj, if any, or NULL, if none

This function will traverse layers in its search, if there are objects on layers below the one obj is placed at.

See also:

evas_object_layer_get()

evas_object_layer_set()

evas_object_below_get()

Since :

2.3.1

Examples:

evas-stacking.c.

Retrieves the general/main color of the given Evas object.

Retrieves the “main” color's RGB component (and alpha channel) values, which range from 0 to 255. For the alpha channel, which defines the object's transparency level, 0 means totally transparent, while 255 means opaque. These color values are premultiplied by the alpha value.

Usually you’ll use this attribute for text and rectangle objects, where the “main” color is their unique one. If set for objects which themselves have colors, like the images one, those colors get modulated by this one.

Note:

All newly created Evas rectangles get the default color values of 255 255 255 255 (opaque white).

Use NULL pointers on the components you're not interested in: they'll be ignored by the function.

Example:

        int alpha, r, g, b;

        evas_object_color_get(d.clipper, &r, &g, &b, &alpha);
        evas_color_argb_unpremul(alpha, &r, &g, &b);

        alpha -= 20;
        if (alpha < 0)
          alpha = 255;

        evas_color_argb_premul(alpha, &r, &g, &b);
        evas_object_color_set(d.clipper, r, g, b, alpha);

        fprintf(stdout, "Changing clipper's opacity: %d%%\n",
                (int)((alpha / 255.0) * 100));
        return;

See the full example.

Parameters:

[out]	r	The red component of the given color.
[out]	g	The green component of the given color.
[out]	b	The blue component of the given color.
[out]	a	The alpha component of the given color.

Since :

2.3.1

Examples:

edje-basic.c, evas-object-manipulation.c, evas-smart-interface.c, and evas-smart-object.c.

Sets the general/main color of the given Evas object to the given one.

See also:

evas_object_color_get() (for an example)

Note:

These color values are expected to be premultiplied by a.

Parameters:

[in]	r	The red component of the given color.
[in]	g	The green component of the given color.
[in]	b	The blue component of the given color.
[in]	a	The alpha component of the given color.

Since :

2.3.1

Examples:

ecore_animator_example.c, ecore_evas_basics_example.c, ecore_evas_buffer_example_01.c, ecore_evas_buffer_example_02.c, ecore_evas_callbacks.c, ecore_evas_object_example.c, ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-color-class.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, edje-swallow.c, edje-table.c, edje-text.c, eina_tiler_01.c, emotion_basic_example.c, emotion_signals_example.c, ephysics_logo.c, evas-aspect-hints.c, evas-box.c, evas-buffer-simple.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, evas-table.c, evas-text.c, and test_bouncing_text.c.

Marks the given Evas object for deletion (when Evas will free its memory).

Parameters:

obj	The given Evas object.

This call will mark obj for deletion, which will take place whenever it has no more references to it (see evas_object_ref() and evas_object_unref()).

At actual deletion time, which may or may not be just after this call, EVAS_CALLBACK_DEL and EVAS_CALLBACK_FREE callbacks will be called. If the object currently had the focus, its EVAS_CALLBACK_FOCUS_OUT callback will also be called.

See also:

evas_object_ref()

evas_object_unref()

Since :

2.3.1

Examples:

ecore_animator_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-signals-messages.c, edje-table.c, eina_tiler_01.c, evas-box.c, evas-smart-interface.c, evas-smart-object.c, test_camera.c, test_camera_track.c, test_collision_detection.c, test_delete.c, and test_velocity.c.

Retrieves the position and (rectangular) size of the given Evas object.

Parameters:

obj	The given Evas object.
x	Pointer to an integer in which to store the X coordinate of the object.
y	Pointer to an integer in which to store the Y coordinate of the object.
w	Pointer to an integer in which to store the width of the object.
h	Pointer to an integer in which to store the height of the object.

The position, naturally, will be relative to the top left corner of the canvas' viewport.

Note:

Use NULL pointers on the geometry components you're not interested in: they'll be ignored by the function.

Example:

   int w, h, cw, ch;

   evas_object_geometry_get(d.img, NULL, NULL, &w, &h);
   ecore_evas_geometry_get(d.ee, NULL, NULL, &cw, &ch);

   if (w < cw)
     evas_object_resize(d.img, cw, ch);
   else
     evas_object_resize(d.img, cw / 2, ch / 2);

   return EINA_TRUE; /* re-issue the timer */

See the full example.

Since :

2.3.1

Examples:

ecore_imf_example.c, edje-box2.c, ephysics_logo.c, evas-box.c, evas-events.c, evas-map-utils.c, evas-smart-interface.c, evas-smart-object.c, test_bouncing_text.c, test_camera.c, test_camera_track.c, and test_growing_balls.c.

Set the position and (rectangular) size of the given Evas object.

Parameters:

obj	The given Evas object.
x	X position to move the object to, in canvas units.
y	Y position to move the object to, in canvas units.
w	The new width of the Evas object.
h	The new height of the Evas object.

The position, naturally, will be relative to the top left corner of the canvas' viewport.

If the object get moved, the object's EVAS_CALLBACK_MOVE callback will be called.

If the object get resized, the object's EVAS_CALLBACK_RESIZE callback will be called.

See also:

evas_object_move()

evas_object_resize()

evas_object_geometry_get

Since (EFL) :

1.8

Since :

3.0

Makes the given Evas object invisible.

Parameters:

obj	The given Evas object.

Hidden objects, besides not being shown at all in your canvas, won't be checked for changes on the canvas rendering process. Furthermore, they will not catch input events. Thus, they are much ligher (in processing needs) than an object that is invisible due to indirect causes, such as being clipped or out of the canvas' viewport.

Besides becoming hidden, obj object's EVAS_CALLBACK_SHOW callback will be called.

Note:

All objects are created in the hidden state! If you want them shown, use evas_object_show() after their creation.

See also:

evas_object_show()

evas_object_visible_get()

Example:

        if (evas_object_visible_get(d.clipper))
          {
             evas_object_hide(d.clipper);
             fprintf(stdout, "hidden\n");
          }
        else
          {
             evas_object_show(d.clipper);
             fprintf(stdout, "visible\n");
          }
        return;

See the full example.

Since :

2.3.1

Examples:

evas-map-utils.c, evas-object-manipulation.c, and evas-smart-interface.c.

Retrieves the layer of its canvas that the given object is part of.

Returns:

Number of its layer

See also:

evas_object_layer_set()

Since :

2.3.1

Examples:

evas-stacking.c.

Sets the layer of its canvas that the given object will be part of.

If you don't use this function, you'll be dealing with an unique layer of objects, the default one. Additional layers are handy when you don't want a set of objects to interfere with another set with regard to stacking. Two layers are completely disjoint in that matter.

This is a low-level function, which you'd be using when something should be always on top, for example.

Warning:

Be careful, it doesn't make sense to change the layer of smart objects' children. Smart objects have a layer of their own, which should contain all their children objects.

See also:

evas_object_layer_get()

Parameters:

[in]

l

The number of the layer to place the object on. Must be between #EVAS_LAYER_MIN and #EVAS_LAYER_MAX.

Since :

2.3.1

Examples:

eina_tiler_01.c, ephysics_logo.c, and evas-stacking.c.

Lower obj to the bottom of its layer.

obj will, then, be the lowest one in the layer it belongs to. Objects on other layers won't get touched.

See also:

evas_object_stack_above()

evas_object_stack_below()

evas_object_raise()

Since :

2.3.1

Examples:

evas-stacking.c.

Move the given Evas object to the given location inside its canvas' viewport.

Parameters:

[in]	x	in
[in]	y	in

Since :

2.3.1

Examples:

ecore_animator_example.c, ecore_evas_buffer_example_01.c, ecore_evas_buffer_example_02.c, ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-color-class.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, edje-swallow.c, edje-table.c, edje-text.c, eina_tiler_01.c, emotion_basic_example.c, emotion_signals_example.c, ephysics_logo.c, evas-aspect-hints.c, evas-box.c, evas-buffer-simple.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, evas-table.c, evas-text.c, test_bouncing_ball.c, test_bouncing_text.c, test_camera.c, test_camera_track.c, test_collision_detection.c, test_collision_filter.c, test_constraint.c, test_delete.c, test_forces.c, test_growing_balls.c, test_no_gravity.c, test_rotating_forever.c, test_shapes.c, test_sleeping_threshold.c, test_slider.c, and test_velocity.c.

Raise obj to the top of its layer.

obj will, then, be the highest one in the layer it belongs to. Object on other layers won't get touched.

See also:

evas_object_stack_above()

evas_object_stack_below()

evas_object_lower()

Since :

2.3.1

Examples:

evas-stacking.c.

Increments object reference count to defer its deletion.

Parameters:

obj	The given Evas object to reference

This increments the reference count of an object, which if greater than 0 will defer deletion by evas_object_del() until all references are released back (counter back to 0). References cannot go below 0 and unreferencing past that will result in the reference count being limited to 0. References are limited to 2^32 - 1 for an object. Referencing it more than this will result in it being limited to this value.

See also:

evas_object_unref()

evas_object_del()

Note:

This is a very simple reference counting mechanism! For instance, Evas is not ready to check for pending references on a canvas deletion, or things like that. This is useful on scenarios where, inside a code block, callbacks exist which would possibly delete an object we are operating on afterwards. Then, one would evas_object_ref() it on the beginning of the block and evas_object_unref() it on the end. It would then be deleted at this point, if it should be.

Example:

  evas_object_ref(obj);

  // action here...
  evas_object_smart_callback_call(obj, SIG_SELECTED, NULL);
  // more action here...
  evas_object_unref(obj);

Since (EFL) :

1.1

Since :

2.3.1

Get the object reference count.

Parameters:

obj	The given Evas object to query

This gets the reference count for an object (normally 0 until it is referenced). Values of 1 or greater mean that someone is holding a reference to this object that needs to be unreffed before it can be deleted.

See also:

evas_object_ref()

evas_object_unref()

evas_object_del()

Since (EFL) :

1.2

Since :

2.3.1

Changes the size of the given Evas object.

Parameters:

[in]	w	in
[in]	h	in

Since :

2.3.1

Examples:

ecore_animator_example.c, ecore_evas_basics_example.c, ecore_evas_buffer_example_01.c, ecore_evas_buffer_example_02.c, ecore_evas_callbacks.c, ecore_evas_object_example.c, ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-color-class.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, edje-swallow.c, edje-table.c, edje-text.c, eina_tiler_01.c, emotion_basic_example.c, emotion_signals_example.c, ephysics_logo.c, evas-aspect-hints.c, evas-box.c, evas-buffer-simple.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, evas-table.c, evas-text.c, test_bouncing_ball.c, test_camera.c, test_camera_track.c, test_collision_detection.c, test_collision_filter.c, test_constraint.c, test_delete.c, test_forces.c, test_growing_balls.c, test_no_gravity.c, test_rotating_forever.c, test_shapes.c, test_sleeping_threshold.c, test_slider.c, and test_velocity.c.

Makes the given Evas object visible.

Parameters:

obj	The given Evas object.

Besides becoming visible, the object's EVAS_CALLBACK_SHOW callback will be called.

See also:

evas_object_hide() for more on object visibility.

evas_object_visible_get()

Since :

2.3.1

Examples:

ecore_animator_example.c, ecore_evas_basics_example.c, ecore_evas_buffer_example_01.c, ecore_evas_buffer_example_02.c, ecore_evas_callbacks.c, ecore_evas_object_example.c, ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-color-class.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, edje-swallow.c, edje-table.c, edje-text.c, eina_tiler_01.c, emotion_basic_example.c, emotion_signals_example.c, ephysics_logo.c, evas-aspect-hints.c, evas-box.c, evas-buffer-simple.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, evas-table.c, evas-text.c, test_bouncing_ball.c, test_bouncing_text.c, test_camera.c, test_camera_track.c, test_collision_detection.c, test_collision_filter.c, test_constraint.c, test_delete.c, test_forces.c, test_growing_balls.c, test_no_gravity.c, test_rotating_forever.c, test_shapes.c, test_sleeping_threshold.c, test_slider.c, and test_velocity.c.

Stack obj immediately above above

Objects, in a given canvas, are stacked in the order they get added to it. This means that, if they overlap, the highest ones will cover the lowest ones, in that order. This function is a way to change the stacking order for the objects.

This function is intended to be used with objects belonging to the same layer in a given canvas, otherwise it will fail (and accomplish nothing).

If you have smart objects on your canvas and obj is a member of one of them, then above must also be a member of the same smart object.

Similarly, if obj is not a member of a smart object, above must not be either.

See also:

evas_object_layer_get()

evas_object_layer_set()

evas_object_stack_below()

Parameters:

[in]

above

the object above which to stack

Since :

2.3.1

Examples:

evas-stacking.c.

Stack obj immediately below below

Objects, in a given canvas, are stacked in the order they get added to it. This means that, if they overlap, the highest ones will cover the lowest ones, in that order. This function is a way to change the stacking order for the objects.

This function is intended to be used with objects belonging to the same layer in a given canvas, otherwise it will fail (and accomplish nothing).

If you have smart objects on your canvas and obj is a member of one of them, then below must also be a member of the same smart object.

Similarly, if obj is not a member of a smart object, below must not be either.

See also:

evas_object_layer_get()

evas_object_layer_set()

evas_object_stack_below()

Parameters:

[in]

below

the object below which to stack

Since :

2.3.1

Examples:

evas-stacking.c.

Decrements object reference count.

Parameters:

obj	The given Evas object to unreference

This decrements the reference count of an object. If the object has had evas_object_del() called on it while references were more than 0, it will be deleted at the time this function is called and puts the counter back to 0. See evas_object_ref() for more information.

See also:

evas_object_ref() (for an example)

evas_object_del()

Since (EFL) :

1.1

Since :

2.3.1

Retrieves whether or not the given Evas object is visible.

Since :

2.3.1

Examples:

evas-object-manipulation.c.