Some more image object functions examples (2nd block)

In this example, we have three images on the canvas, but one of them is special – we're using it as a proxy image object. It will mirror the contents of the other two images (which are the ones on the top of the canvas), one at a time:

d.proxy_img = evas_object_image_filled_add(d.evas);
evas_object_image_source_set(d.proxy_img, d.logo);
evas_object_move(d.proxy_img, WIDTH / 2, HEIGHT / 2);
evas_object_resize(d.proxy_img, WIDTH / 2, HEIGHT / 2);
evas_object_show(d.proxy_img);
EVAS_API void evas_object_show(Evas_Object *eo_obj)
Makes the given Evas object visible.
Definition: evas_object_main.c:1814
EVAS_API void evas_object_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y)
Move the given Evas object to the given location inside its canvas' viewport.
Definition: evas_object_main.c:1171
EVAS_API void evas_object_resize(Evas_Object *obj, Evas_Coord w, Evas_Coord h)
Changes the size of the given Evas object.
Definition: evas_object_main.c:1236
EVAS_API Eina_Bool evas_object_image_source_set(Evas_Object *eo, Evas_Object *src)
Set the source object on an image object to used as a proxy.
Definition: evas_image_legacy.c:463
EVAS_API Evas_Object * evas_object_image_filled_add(Evas *eo_e)
Creates a new image object that automatically scales its bound image to the object's area,...
Definition: evas_image_legacy.c:35

As in other examples, we have a command line interface on it.

static const char *commands = \
"commands are:\n"
"\tp - change proxy image's source\n"
"\ts - print noise image's stride value\n"
"\ta - save noise image to disk (/tmp dir)\n"
"\tv - change source visibility\n"
"\te - enable/disable source events\n"
"\th - print help\n";

The 'p' one will change the source of the proxy image to one of the other two, as seem above.

if (strcmp(ev->key, "p") == 0) /* change proxy's source */
{
Evas_Object *source = evas_object_image_source_get(d.proxy_img);
if (source == d.logo) source = d.noise_img;
else if (source == d.noise_img) source = d.text_obj;
else source = d.logo;
evas_object_image_source_set(d.proxy_img, source);
printf("Proxy image's source changed\n");
return;
}
Efl_Canvas_Object Evas_Object
An Evas Object handle.
Definition: Evas_Common.h:185
EVAS_API Evas_Object * evas_object_image_source_get(const Evas_Object *eo)
Get the current source object of an image object.
Definition: evas_image_legacy.c:470

Note the top right image, the smaller one:

d.noise_img = evas_object_image_add(d.evas);
evas_object_image_size_set(d.noise_img, WIDTH / 4, HEIGHT / 4);
evas_object_image_data_set(d.noise_img, pixels);
evas_object_move(d.noise_img, (WIDTH * 5) / 8, HEIGHT / 8);
evas_object_resize(d.noise_img, WIDTH / 4, HEIGHT / 4);
evas_object_show(d.noise_img);
#define EINA_TRUE
boolean value TRUE (numerical value 1)
Definition: eina_types.h:539
EVAS_API void evas_object_image_data_set(Eo *eo_obj, void *data)
Sets the raw image data of the given image object.
Definition: evas_image_legacy.c:610
EVAS_API void evas_object_image_size_set(Evas_Object *eo_obj, int w, int h)
Sets the size of the given image object.
Definition: evas_image_legacy.c:847
EVAS_API Evas_Object * evas_object_image_add(Evas *eo_e)
Creates a new image object on the given Evas e canvas.
Definition: evas_image_legacy.c:25
EVAS_API void evas_object_image_filled_set(Evas_Object *eo_obj, Eina_Bool value)
Set whether the image object's fill property should track the object's size.
Definition: evas_image_legacy.c:81

Since we are creating the data for its pixel buffer ourselves, we have to set its size with evas_object_image_size_set(), first. We set our data with the function evas_object_image_data_set(), where the second argument is a buffer with random data. There's a last command to print it's stride value. Since its created with one quarter of the canvas's original width

#define WIDTH (320)
#define HEIGHT (240)

you can check this value.

The image on the top left also has a subtlety: it is pre-loaded on this example.

d.logo = evas_object_image_filled_add(d.evas);
d.logo, EVAS_CALLBACK_IMAGE_PRELOADED, _on_preloaded, NULL);
evas_object_image_file_set(d.logo, img_path, NULL);
evas_object_resize(d.logo, WIDTH / 2, HEIGHT / 2);
@ EVAS_CALLBACK_MOUSE_MOVE
Mouse Move Event.
Definition: Evas_Common.h:424
@ EVAS_CALLBACK_MULTI_UP
Multi-touch Up Event.
Definition: Evas_Common.h:427
@ EVAS_CALLBACK_HOLD
Events go on/off hold.
Definition: Evas_Common.h:440
@ EVAS_CALLBACK_MOUSE_IN
Mouse In Event.
Definition: Evas_Common.h:420
@ EVAS_CALLBACK_IMAGE_PRELOADED
Image has been preloaded.
Definition: Evas_Common.h:442
@ EVAS_CALLBACK_MULTI_MOVE
Multi-touch Move Event.
Definition: Evas_Common.h:428
@ EVAS_CALLBACK_MOUSE_UP
Mouse Button Up Event.
Definition: Evas_Common.h:423
@ EVAS_CALLBACK_MOUSE_OUT
Mouse Out Event.
Definition: Evas_Common.h:421
@ EVAS_CALLBACK_MOUSE_DOWN
Mouse Button Down Event.
Definition: Evas_Common.h:422
@ EVAS_CALLBACK_MULTI_DOWN
Multi-touch Down Event.
Definition: Evas_Common.h:426
EVAS_API void evas_object_event_callback_add(Evas_Object *eo_obj, Evas_Callback_Type type, Evas_Object_Event_Cb func, const void *data)
Add (register) a callback function to a given Evas object event.
Definition: evas_callbacks.c:478
EVAS_API void evas_object_image_file_set(Evas_Object *obj, const char *file, const char *key)
Set the source file from where an image object must fetch the real image data (it may be an Eet file,...
Definition: evas_image_legacy.c:194
EVAS_API void evas_object_image_preload(Evas_Object *eo_obj, Eina_Bool cancel)
Preload an image object's image data in the background.
Definition: evas_image_legacy.c:66

On real use cases we wouldn't be just printing something like this

static void
_mouse_down(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Mouse_Down *ev = event_info;
printf("Mouse Down - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
#define EINA_UNUSED
Used to indicate that a function parameter is purposely unused.
Definition: eina_types.h:339
Eo Evas
An opaque handle to an Evas canvas.
Definition: Evas_Common.h:163
Evas_Coord y
y co-ordinate
Definition: Evas_Common.h:212
Evas_Coord x
x co-ordinate
Definition: Evas_Common.h:211
Mouse button press event.
Definition: Evas_Legacy.h:160
Evas_Coord_Point canvas
The X/Y location of the cursor.
Definition: Evas_Legacy.h:164

naturally.

The 's' command will save one of the images on the disk, in the png format:

if (strcmp(ev->key, "a") == 0) /* save noise image to disk */
{
if (!evas_object_image_save(d.noise_img, file_path, NULL, quality_str))
fprintf(stderr, "Cannot save image to '%s' (flags '%s')\n",
file_path, quality_str);
else
printf("Image saved to '%s' (flags '%s'), check it out with "
"an image viewer\n", file_path, quality_str);
return;
}
EVAS_API Eina_Bool evas_object_image_save(const Evas_Object *obj, const char *file, const char *key, const char *flags)
Save the given image object's contents to an (image) file.
Definition: evas_image_legacy.c:222

The full example follows.

#ifdef HAVE_CONFIG_H
#include "config.h"
#else
#define PACKAGE_EXAMPLES_DIR "."
#endif
#include <Ecore.h>
#include <Ecore_Evas.h>
#include <stdio.h>
#include <errno.h>
#include "evas-common.h"
#define WIDTH (320)
#define HEIGHT (240)
static const char *img_path = PACKAGE_EXAMPLES_DIR EVAS_IMAGE_FOLDER "/enlightenment.png";
static const char *commands = \
"commands are:\n"
"\tp - change proxy image's source\n"
"\ts - print noise image's stride value\n"
"\ta - save noise image to disk (/tmp dir)\n"
"\tv - change source visibility\n"
"\te - enable/disable source events\n"
"\th - print help\n";
const char *file_path = "/tmp/evas-images2-example.png";
const char *quality_str = "quality=100";
struct test_data
{
Ecore_Evas *ee;
Evas *evas;
Evas_Object *logo, *noise_img, *proxy_img, *text_obj, *bg;
};
static struct test_data d = {0};
static void
_mouse_down(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Mouse_Down *ev = event_info;
printf("Mouse Down - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
static void
_mouse_move(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Mouse_Move *ev = event_info;
printf("Mouse Move - obj(%p), coords(%d %d)\n",
obj, ev->cur.canvas.x, ev->cur.canvas.y);
}
static void
_mouse_up(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Mouse_Up *ev = event_info;
printf("Mouse Up - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
static void
_multi_down(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Multi_Down *ev = event_info;
printf("Multi Down - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
static void
_multi_move(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Multi_Move *ev = event_info;
printf("Multi Move - obj(%p), coords(%d %d)\n",
obj, ev->cur.canvas.x, ev->cur.canvas.y);
}
static void
_multi_up(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Multi_Up *ev = event_info;
printf("Multi Up - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
static void
_mouse_in(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Mouse_In *ev = event_info;
printf("Mouse In - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
static void
_mouse_out(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Mouse_Out *ev = event_info;
printf("Mouse Out - obj(%p), coords(%d %d)\n",
obj, ev->canvas.x, ev->canvas.y);
}
static void
_hold(void *data EINA_UNUSED, Evas *e EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
Evas_Event_Hold *ev = event_info;
printf("Hold - obj(%p), hold(%d)\n", obj, ev->hold);
}
static void
_on_preloaded(void *data EINA_UNUSED,
void *event_info EINA_UNUSED)
{
printf("Image has been pre-loaded!\n");
}
static void
_on_destroy(Ecore_Evas *ee EINA_UNUSED)
{
}
/* 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);
}
static void
_on_keydown(void *data EINA_UNUSED,
void *einfo)
{
Evas_Event_Key_Down *ev = einfo;
if (strcmp(ev->key, "h") == 0) /* print help */
{
puts(commands);
return;
}
if (strcmp(ev->key, "s") == 0) /* print proxy image' stride value */
{
int stride = evas_object_image_stride_get(d.noise_img);
printf("Image has row stride value of %d, which accounts"
" for %d pixels\n", stride, stride / 4);
return;
}
if (strcmp(ev->key, "p") == 0) /* change proxy's source */
{
Evas_Object *source = evas_object_image_source_get(d.proxy_img);
if (source == d.logo) source = d.noise_img;
else if (source == d.noise_img) source = d.text_obj;
else source = d.logo;
evas_object_image_source_set(d.proxy_img, source);
printf("Proxy image's source changed\n");
return;
}
if (strcmp(ev->key, "a") == 0) /* save noise image to disk */
{
if (!evas_object_image_save(d.noise_img, file_path, NULL, quality_str))
fprintf(stderr, "Cannot save image to '%s' (flags '%s')\n",
file_path, quality_str);
else
printf("Image saved to '%s' (flags '%s'), check it out with "
"an image viewer\n", file_path, quality_str);
return;
}
if (strcmp(ev->key, "v") == 0) /* change source visibility */
{
Eina_Bool src_visible =
evas_object_image_source_visible_set(d.proxy_img, !src_visible);
return;
}
if (strcmp(ev->key, "e") == 0) /* change source events */
{
evas_object_image_source_events_set(d.proxy_img, !src_events);
return;
}
}
int
main(void)
{
unsigned int i;
unsigned int pixels[(WIDTH / 4) * (HEIGHT / 4)];
return EXIT_FAILURE;
/* this will give you a window with an Evas canvas under the first
* engine available */
d.ee = ecore_evas_new(NULL, 10, 10, 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);
/* the canvas pointer, de facto */
d.evas = ecore_evas_get(d.ee);
d.bg = evas_object_rectangle_add(d.evas);
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 */
d.bg, EVAS_CALLBACK_KEY_DOWN, _on_keydown, NULL);
d.logo = evas_object_image_filled_add(d.evas);
d.logo, EVAS_CALLBACK_IMAGE_PRELOADED, _on_preloaded, NULL);
evas_object_image_file_set(d.logo, img_path, NULL);
evas_object_resize(d.logo, WIDTH / 2, HEIGHT / 2);
/* creating noise image */
for (i = 0; i < sizeof(pixels) / sizeof(pixels[0]); i++)
pixels[i] = rand();
d.noise_img = evas_object_image_add(d.evas);
evas_object_image_size_set(d.noise_img, WIDTH / 4, HEIGHT / 4);
evas_object_image_data_set(d.noise_img, pixels);
evas_object_move(d.noise_img, (WIDTH * 5) / 8, HEIGHT / 8);
evas_object_resize(d.noise_img, WIDTH / 4, HEIGHT / 4);
evas_object_show(d.noise_img);
printf("Creating noise image with size %d, %d\n",
WIDTH / 4, HEIGHT / 4);
d.text_obj = evas_object_textblock_add(d.evas);
evas_object_textblock_text_markup_set(d.text_obj, "Hello world! :)");
evas_textblock_style_set(st, "DEFAULT='font=Sans font_size=16 color=#114 wrap=word'");
evas_object_move(d.text_obj, WIDTH / 16, HEIGHT * 9 / 16);
evas_object_resize(d.text_obj, WIDTH / 4, 0);
evas_object_show(d.text_obj);
d.proxy_img = evas_object_image_filled_add(d.evas);
evas_object_image_source_set(d.proxy_img, d.logo);
evas_object_move(d.proxy_img, WIDTH / 2, HEIGHT / 2);
evas_object_resize(d.proxy_img, WIDTH / 2, HEIGHT / 2);
evas_object_show(d.proxy_img);
puts(commands);
return 0;
error:
fprintf(stderr, "error: Requires at least one Evas engine built and linked"
" to ecore-evas for this example to run properly.\n");
return -1;
}
Evas wrapper functions.
@ EVAS_CALLBACK_KEY_DOWN
Key Press Event.
Definition: Evas_Common.h:430
EAPI int ecore_evas_init(void)
Inits the Ecore_Evas system.
Definition: ecore_evas.c:602
EAPI void ecore_evas_callback_destroy_set(Ecore_Evas *ee, Ecore_Evas_Event_Cb func)
Sets a callback for Ecore_Evas destroy events.
Definition: ecore_evas.c:1185
EAPI void ecore_evas_show(Ecore_Evas *ee)
Shows an Ecore_Evas' window.
Definition: ecore_evas.c:1480
EAPI Evas * ecore_evas_get(const Ecore_Evas *ee)
Gets an Ecore_Evas's Evas.
Definition: ecore_evas.c:1300
EAPI void ecore_evas_geometry_get(const Ecore_Evas *ee, int *x, int *y, int *w, int *h)
Gets the geometry of an Ecore_Evas.
Definition: ecore_evas.c:1362
EAPI Ecore_Evas * ecore_evas_new(const char *engine_name, int x, int y, int w, int h, const char *extra_options)
Creates a new Ecore_Evas based on engine name and common parameters.
Definition: ecore_evas.c:1039
EAPI void ecore_evas_callback_resize_set(Ecore_Evas *ee, Ecore_Evas_Event_Cb func)
Sets a callback for Ecore_Evas resize events.
Definition: ecore_evas.c:1140
EAPI int ecore_evas_shutdown(void)
Shuts down the Ecore_Evas system.
Definition: ecore_evas.c:666
EAPI void ecore_evas_free(Ecore_Evas *ee)
Frees an Ecore_Evas.
Definition: ecore_evas.c:1083
void ecore_main_loop_quit(void)
Quits the main loop once all the events currently on the queue have been processed.
Definition: ecore_main.c:1321
void ecore_main_loop_begin(void)
Runs the application main loop.
Definition: ecore_main.c:1311
unsigned char Eina_Bool
Type to mimic a boolean.
Definition: eina_types.h:527
EVAS_API int evas_object_image_stride_get(const Evas_Object *obj)
Retrieves the row stride of the given image object.
Definition: evas_image_legacy.c:176
EVAS_API void evas_object_color_set(Evas_Object *obj, int r, int g, int b, int a)
Sets the general/main color of the given Evas object to the given one.
Definition: evas_object_main.c:2024
EVAS_API void evas_object_focus_set(Efl_Canvas_Object *obj, Eina_Bool focus)
Indicates that this object is the keyboard event receiver on its canvas.
Definition: efl_canvas_object_eo.legacy.c:39
EVAS_API void evas_object_image_source_visible_set(Evas_Object *eo, Eina_Bool visible)
Set the source object to be visible or not.
Definition: evas_image_legacy.c:1052
EVAS_API void evas_object_image_source_events_set(Evas_Object *eo, Eina_Bool repeat)
Set whether an Evas object is to source events.
Definition: evas_image_legacy.c:498
EVAS_API Eina_Bool evas_object_image_source_events_get(const Evas_Object *eo)
Determine whether an object is set to source events.
Definition: evas_image_legacy.c:505
EVAS_API Eina_Bool evas_object_image_source_visible_get(const Evas_Object *eo)
Get the state of the source object visibility.
Definition: evas_image_legacy.c:1089
EVAS_API Evas_Object * evas_object_rectangle_add(Evas *e)
Adds a rectangle to the given evas.
Definition: evas_object_rectangle.c:78
EVAS_API void evas_object_textblock_text_markup_set(Eo *eo_obj, const char *text)
Sets given text as markup for the textblock object.
Definition: evas_object_textblock.c:8792
EVAS_API void evas_object_textblock_style_set(Eo *eo_obj, const Evas_Textblock_Style *ts)
Sets object's style to given style.
Definition: evas_object_textblock.c:8304
struct _Efl_Canvas_Textblock_Style Evas_Textblock_Style
A textblock style object.
Definition: evas_textblock_legacy.h:140
EVAS_API Evas_Textblock_Style * evas_textblock_style_new(void)
Creates a new textblock style.
Definition: evas_object_textblock.c:7971
EVAS_API Evas_Object * evas_object_textblock_add(Evas *e)
Adds a textblock to the given evas.
Definition: evas_object_textblock.c:7907
EVAS_API void evas_textblock_style_set(Evas_Textblock_Style *ts, const char *text)
Sets the style ts to the style passed as text by text.
Definition: evas_object_textblock.c:8048
Evas_Coord y
y co-ordinate
Definition: Evas_Common.h:233
Evas_Coord x
x co-ordinate
Definition: Evas_Common.h:232
Hold change event.
Definition: Evas_Legacy.h:348
int hold
The hold flag.
Definition: Evas_Legacy.h:349
Key press event.
Definition: Evas_Legacy.h:314
const char * key
The logical key : (eg shift+1 == exclamation)
Definition: Evas_Legacy.h:320
Mouse enter event.
Definition: Evas_Legacy.h:196
Evas_Coord_Point canvas
The X/Y location of the cursor.
Definition: Evas_Legacy.h:200
Mouse move event.
Definition: Evas_Legacy.h:228
Evas_Position cur
Current mouse position.
Definition: Evas_Legacy.h:231
Mouse leave event.
Definition: Evas_Legacy.h:212
Evas_Coord_Point canvas
The X/Y location of the cursor.
Definition: Evas_Legacy.h:216
Mouse button release event.
Definition: Evas_Legacy.h:178
Evas_Coord_Point canvas
The X/Y location of the cursor.
Definition: Evas_Legacy.h:182
Multi button press event.
Definition: Evas_Legacy.h:260
Multi button down event.
Definition: Evas_Legacy.h:298
Multi button release event.
Definition: Evas_Legacy.h:279
Evas_Coord_Point canvas
position on the canvas
Definition: Evas_Common.h:247
Evas_Coord_Precision_Point canvas
position on the canvas
Definition: Evas_Common.h:253