This example demonstrates how someone can set a perspective to be used by an Edje object, but setting a global perspective.
The API for setting a perspective for just one Edje object is almost the same and it's trivial, so we are not doing that on this example.
Let's go first to the main function, where we start creating our objects and loading the theme. We also set some variables that will be used globally in our program:
{
const char *edje_file = PACKAGE_DATA_DIR"/perspective.edj";
struct _App app;
Ecore_Evas *ee;
return EXIT_FAILURE;
goto shutdown_ecore_evas;
app.x = 0;
app.y = 0;
app.focal = 50;
A boolean is used to indicate that we are animating.
We also set the app.x
and app.y
to (0, 0) because the original position of our text + rectangle part will be on top left. This is a convention that we are using in this example, and setting x, y to 1, 1 would mean bottom right. We do this to later define the name of the signals that we are sending to the theme.
After this, some boilerplate code to load the theme:
if (!ee) goto shutdown_edje;
Now we are going to setup a callback to tell us that the animation has ended. We do this just to avoid sending signals to the theme while it's animating.
Finally, let's create our perspective object, define its position, focal distance and z plane position, and set it as global:
Notice that if we wanted to set it just to our edje object, instead of setting the perspective as global to the entire canvas, we could just use edje_object_perspective_set() instead of edje_perspective_global_set(). The rest of the code would be exactly the same.
Now, let's take a look at what we do in our callbacks.
The callback for key_down is converting the arrow keys to a signal that represents where we want our text and rectangle moved to. It does that by using the following function:
_part_move(struct _App *app, int dx, int dy)
{
char emission[64];
if (app->animating)
return;
app->x += dx;
app->y += dy;
if (app->x > 1)
app->x = 1;
if (app->x < 0)
app->x = 0;
if (app->y > 1)
app->y = 1;
if (app->y < 0)
app->y = 0;
snprintf(emission, sizeof(emission), "move,%d,%d", app->x, app->y);
}
Notice that, after sending the signal to the Edje object, we set our boolean to store that we are animating now. It will only be unset when we receive a signal from the theme that the animation has ended.
Now, on the key_down code, we just call this function when the arrows or "PgUp" or "PgDown" keys are pressed:
static void
{
struct _App *app = data;
if (!strcmp(ev->
key,
"h"))
{
printf(commands);
return;
}
else if (!strcmp(ev->
key,
"Down"))
{
_part_move(app, 0, 1);
}
else if (!strcmp(ev->
key,
"Up"))
{
_part_move(app, 0, -1);
}
else if (!strcmp(ev->
key,
"Left"))
{
_part_move(app, -1, 0);
}
else if (!strcmp(ev->
key,
"Right"))
{
_part_move(app, 1, 0);
}
else if (!strcmp(ev->
key,
"Prior"))
{
_part_move(app, -1, -1);
}
else if (!strcmp(ev->
key,
"Next"))
{
_part_move(app, 1, 1);
}
else if (!strcmp(ev->
key,
"KP_Add"))
{
app->focal += 5;
}
else if (!strcmp(ev->
key,
"KP_Subtract"))
{
app->focal -= 5;
if (app->focal < 5)
app->focal = 5;
}
else if (!strcmp(ev->
key,
"Escape"))
else
{
printf(
"unhandled key: %s\n", ev->
key);
printf(commands);
}
Notice that we also do something else when the numeric keyboard "+" and "-" keys are pressed. We change the focal distance of our global perspective, and that will affect the part that has a map rotation applied to it, with perspective enabled. We also need to call edje_object_calc_force(), otherwise the Edje object has no way to know that we changed the global perspective.
Try playing with these keys and see what happens to the animation when the value of the focal distance changes.
Finally we add a callback for the animation ended signal:
{
struct _App *app = data;
}
The example's window should look like this picture:
The full source code follows:
#ifdef HAVE_CONFIG_H
# include "config.h"
#else
# define EINA_UNUSED
#endif
#ifndef PACKAGE_DATA_DIR
#define PACKAGE_DATA_DIR "."
#endif
#include <Ecore.h>
#define WIDTH 480
#define HEIGHT 320
static const char commands[] = \
"commands are:\n"
"\tDown - move part down\n"
"\tUp - move part up\n"
"\tLeft - move part left\n"
"\tRight - move part right\n"
"\tPrior - move part up-left\n"
"\tNext - move part down-right\n"
"\tInsert - increase focal\n"
"\tSuppr - decrease focal\n"
"\tEsc - exit\n"
"\th - print help\n";
struct _App {
int x, y;
int focal;
};
static void
{
}
static void
_on_canvas_resize(Ecore_Evas *ee)
{
int w, h;
}
static void
_part_move(struct _App *app, int dx, int dy)
{
char emission[64];
if (app->animating)
return;
app->x += dx;
app->y += dy;
if (app->x > 1)
app->x = 1;
if (app->x < 0)
app->x = 0;
if (app->y > 1)
app->y = 1;
if (app->y < 0)
app->y = 0;
snprintf(emission, sizeof(emission), "move,%d,%d", app->x, app->y);
}
static void
{
struct _App *app = data;
if (!strcmp(ev->
key,
"h"))
{
printf(commands);
return;
}
else if (!strcmp(ev->
key,
"Down"))
{
_part_move(app, 0, 1);
}
else if (!strcmp(ev->
key,
"Up"))
{
_part_move(app, 0, -1);
}
else if (!strcmp(ev->
key,
"Left"))
{
_part_move(app, -1, 0);
}
else if (!strcmp(ev->
key,
"Right"))
{
_part_move(app, 1, 0);
}
else if (!strcmp(ev->
key,
"Prior"))
{
_part_move(app, -1, -1);
}
else if (!strcmp(ev->
key,
"Next"))
{
_part_move(app, 1, 1);
}
else if (!strcmp(ev->
key,
"KP_Add"))
{
app->focal += 5;
}
else if (!strcmp(ev->
key,
"KP_Subtract"))
{
app->focal -= 5;
if (app->focal < 5)
app->focal = 5;
}
else if (!strcmp(ev->
key,
"Escape"))
else
{
printf(
"unhandled key: %s\n", ev->
key);
printf(commands);
}
}
static void
{
struct _App *app = data;
}
int
{
const char *edje_file = PACKAGE_DATA_DIR"/perspective.edj";
struct _App app;
Ecore_Evas *ee;
return EXIT_FAILURE;
goto shutdown_ecore_evas;
app.x = 0;
app.y = 0;
app.focal = 50;
if (!ee) goto shutdown_edje;
printf(commands);
return EXIT_SUCCESS;
shutdown_edje:
shutdown_ecore_evas:
return EXIT_FAILURE;
}
The full .edc file
collections {
group {
name: "example/group";
min: 480 320;
parts {
part {
name: "bg";
type: RECT;
mouse_events: 1;
description {
state: "default" 0.0;
}
} // bg
part {
name: "rectangle";
type: RECT;
mouse_events: 0;
description {
state: "default" 0.0;
color: 255 0 0 128;
rel1 {
offset: -5 -5;
to: "title";
}
rel2 {
offset: 4 4;
to: "title";
}
map {
on: 1;
perspective_on: 1;
rotation {
x: 45;
}
}
}
} // rectangle
part {
name: "title";
type: TEXT;
mouse_events: 0;
description {
state: "default" 0.0;
color: 200 200 200 255;
align: 0.0 0.5;
rel1.relative: 0.1 0.1;
rel2.relative: 0.1 0.1;
text {
text: "Perspective example";
font: "Sans";
size: 16;
min: 1 1;
}
map {
on: 1;
perspective_on: 1;
rotation {
x: 45;
}
}
}
description {
state: "right" 0.0;
inherit: "default" 0.0;
rel1.relative: 0.5 0.1;
rel2.relative: 0.5 0.1;
}
description {
state: "bottom" 0.0;
inherit: "default" 0.0;
rel1.relative: 0.1 0.9;
rel2.relative: 0.1 0.9;
}
description {
state: "bottomright" 0.0;
inherit: "default" 0.0;
rel1.relative: 0.5 0.9;
rel2.relative: 0.5 0.9;
}
} // title
}
programs {
program {
name: "move,right";
signal: "move,1,0";
action: STATE_SET "right" 0.0;
transition: SINUSOIDAL 1.0;
target: "title";
after: "animation,end";
}
program {
name: "move,bottom";
signal: "move,0,1";
action: STATE_SET "bottom" 0.0;
transition: SINUSOIDAL 1.0;
target: "title";
after: "animation,end";
}
program {
name: "move,bottomright";
signal: "move,1,1";
action: STATE_SET "bottomright" 0.0;
transition: SINUSOIDAL 1.0;
target: "title";
after: "animation,end";
}
program {
name: "move,default";
signal: "move,0,0";
action: STATE_SET "default" 0.0;
transition: SINUSOIDAL 1.0;
target: "title";
after: "animation,end";
}
program {
name: "animation,end";
action: SIGNAL_EMIT "animation,end" "";
}
}
}
}
To compile use this command:
* gcc -o edje-perspective edje-perspective.c -DPACKAGE_BIN_DIR=\"/Where/enlightenment/is/installed/bin\"
* -DPACKAGE_LIB_DIR=\"/Where/enlightenment/is/installed/lib\"
* -DPACKAGE_DATA_DIR=\"/Where/enlightenment/is/installed/share\"
* `pkg-config --cflags --libs evas ecore ecore-evas edje`
*
* edje_cc perspective.edc
*