2007-04-30 08:39:11 +00:00
|
|
|
/* -*- mode:C; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
|
|
|
|
/*
|
|
|
|
* Clutter.
|
|
|
|
*
|
|
|
|
* An OpenGL based 'interactive canvas' library.
|
|
|
|
*
|
|
|
|
* Authored By Tomas Frydrych <tf@openedhand.com>
|
|
|
|
*
|
|
|
|
* Copyright (C) 2007 OpenedHand
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library; if not, write to the
|
|
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
* Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* SECTION:clutter-behaviour-ellipse
|
|
|
|
* @short_description: elliptic path behaviour.
|
|
|
|
*
|
|
|
|
* #ClutterBehaviourEllipse interpolates actors along a path defined by
|
2007-06-01 10:00:35 +00:00
|
|
|
* an ellipse.
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "clutter-fixed.h"
|
|
|
|
#include "clutter-marshal.h"
|
|
|
|
#include "clutter-behaviour-ellipse.h"
|
|
|
|
#include "clutter-enum-types.h"
|
|
|
|
#include "clutter-private.h"
|
|
|
|
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <memory.h>
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* *
|
|
|
|
* ClutterBehaviourEllipse *
|
|
|
|
* *
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
G_DEFINE_TYPE (ClutterBehaviourEllipse,
|
|
|
|
clutter_behaviour_ellipse,
|
|
|
|
CLUTTER_TYPE_BEHAVIOUR);
|
|
|
|
|
|
|
|
#define CLUTTER_BEHAVIOUR_ELLIPSE_GET_PRIVATE(obj) \
|
|
|
|
(G_TYPE_INSTANCE_GET_PRIVATE ((obj), \
|
|
|
|
CLUTTER_TYPE_BEHAVIOUR_ELLIPSE, \
|
|
|
|
ClutterBehaviourEllipsePrivate))
|
|
|
|
|
|
|
|
enum
|
|
|
|
{
|
|
|
|
PROP_0,
|
|
|
|
|
|
|
|
PROP_CENTER,
|
|
|
|
PROP_WIDTH,
|
|
|
|
PROP_HEIGHT,
|
|
|
|
PROP_ANGLE_BEGIN,
|
|
|
|
PROP_ANGLE_END,
|
2007-05-15 11:51:14 +00:00
|
|
|
PROP_ANGLE_TILT,
|
2007-04-30 08:39:11 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct _ClutterBehaviourEllipsePrivate
|
|
|
|
{
|
|
|
|
/*
|
|
|
|
* Ellipse center
|
|
|
|
*/
|
|
|
|
ClutterKnot center;
|
|
|
|
gint a;
|
|
|
|
gint b;
|
|
|
|
ClutterAngle angle_begin;
|
|
|
|
ClutterAngle angle_end;
|
2007-05-15 11:51:14 +00:00
|
|
|
ClutterAngle angle_tilt;
|
2007-04-30 08:39:11 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_finalize (GObject *object)
|
|
|
|
{
|
|
|
|
G_OBJECT_CLASS (clutter_behaviour_ellipse_parent_class)->finalize (object);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_advance (ClutterBehaviourEllipse * e,
|
|
|
|
ClutterAngle angle,
|
|
|
|
ClutterKnot * knot)
|
|
|
|
{
|
2007-05-15 11:51:14 +00:00
|
|
|
gint x = CFX_INT (e->priv->a * clutter_cosi (angle));
|
|
|
|
gint y = CFX_INT (e->priv->b * clutter_sini (angle));
|
2007-04-30 08:39:11 +00:00
|
|
|
|
2007-05-15 11:51:14 +00:00
|
|
|
if (e->priv->angle_tilt)
|
|
|
|
{
|
2007-05-29 09:21:18 +00:00
|
|
|
/*
|
|
|
|
* x2 = r * cos (angle + tilt)
|
|
|
|
* y2 = r * sin (angle + tilt)
|
|
|
|
*
|
|
|
|
* These can be trasformed to the formulas below using properties of
|
|
|
|
* sin (a + b) and cos (a + b)
|
2007-05-15 11:51:14 +00:00
|
|
|
*
|
|
|
|
*/
|
2007-05-29 09:21:18 +00:00
|
|
|
ClutterFixed x2, y2;
|
2007-05-15 11:51:14 +00:00
|
|
|
|
2007-05-29 09:21:18 +00:00
|
|
|
x2 = x * clutter_cosi (e->priv->angle_tilt) -
|
|
|
|
y * clutter_sini (e->priv->angle_tilt);
|
2007-05-15 11:51:14 +00:00
|
|
|
|
2007-05-29 09:21:18 +00:00
|
|
|
y2 = y * clutter_cosi (e->priv->angle_tilt) +
|
|
|
|
x * clutter_sini (e->priv->angle_tilt);
|
|
|
|
|
|
|
|
knot->x = CFX_INT (x2);
|
|
|
|
knot->y = CFX_INT (y2);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
knot->x = x;
|
|
|
|
knot->y = y;
|
2007-05-15 11:51:14 +00:00
|
|
|
}
|
|
|
|
|
2007-04-30 08:39:35 +00:00
|
|
|
#if 0
|
2007-04-30 08:39:20 +00:00
|
|
|
g_debug ("advancing to angle %d [%d, %d] (a: %d, b: %d)",
|
|
|
|
angle, knot->x, knot->y, e->priv->a, e->priv->b);
|
2007-04-30 08:39:35 +00:00
|
|
|
#endif
|
2007-04-30 08:39:11 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
static void
|
|
|
|
actor_apply_knot_foreach (ClutterBehaviour *behave,
|
|
|
|
ClutterActor *actor,
|
|
|
|
gpointer data)
|
|
|
|
{
|
|
|
|
ClutterKnot *knot = data;
|
|
|
|
clutter_actor_set_position (actor, knot->x, knot->y);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_alpha_notify (ClutterBehaviour * behave,
|
2007-04-30 08:39:20 +00:00
|
|
|
guint32 alpha)
|
2007-04-30 08:39:11 +00:00
|
|
|
{
|
|
|
|
ClutterKnot knot;
|
|
|
|
ClutterBehaviourEllipse * self = CLUTTER_BEHAVIOUR_ELLIPSE (behave);
|
|
|
|
ClutterAngle angle;
|
|
|
|
|
2007-04-30 08:39:20 +00:00
|
|
|
if (self->priv->angle_end >= self->priv->angle_begin)
|
2007-04-30 08:39:11 +00:00
|
|
|
{
|
|
|
|
angle = self->priv->angle_end - self->priv->angle_begin;
|
2007-04-30 08:39:20 +00:00
|
|
|
angle =
|
|
|
|
(angle * alpha) / CLUTTER_ALPHA_MAX_ALPHA + self->priv->angle_begin;
|
2007-04-30 08:39:11 +00:00
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
2007-04-30 08:39:20 +00:00
|
|
|
angle = self->priv->angle_begin - self->priv->angle_end;
|
|
|
|
angle =
|
|
|
|
self->priv->angle_begin - (angle * alpha) / CLUTTER_ALPHA_MAX_ALPHA;
|
2007-04-30 08:39:11 +00:00
|
|
|
}
|
2007-05-31 09:29:12 +00:00
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
clutter_behaviour_ellipse_advance (self, angle, &knot);
|
|
|
|
|
|
|
|
knot.x += self->priv->center.x;
|
|
|
|
knot.y += self->priv->center.y;
|
|
|
|
|
|
|
|
clutter_behaviour_actors_foreach (behave,
|
|
|
|
actor_apply_knot_foreach,
|
|
|
|
&knot);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_set_property (GObject *gobject,
|
|
|
|
guint prop_id,
|
|
|
|
const GValue *value,
|
|
|
|
GParamSpec *pspec)
|
|
|
|
{
|
|
|
|
ClutterBehaviourEllipse * el = CLUTTER_BEHAVIOUR_ELLIPSE (gobject);
|
|
|
|
ClutterBehaviourEllipsePrivate *priv;
|
|
|
|
|
|
|
|
priv = CLUTTER_BEHAVIOUR_ELLIPSE (gobject)->priv;
|
|
|
|
|
|
|
|
switch (prop_id)
|
|
|
|
{
|
|
|
|
case PROP_ANGLE_BEGIN:
|
|
|
|
priv->angle_begin = g_value_get_int (value);
|
|
|
|
break;
|
|
|
|
case PROP_ANGLE_END:
|
|
|
|
priv->angle_end = g_value_get_int (value);
|
|
|
|
break;
|
2007-05-15 11:51:14 +00:00
|
|
|
case PROP_ANGLE_TILT:
|
|
|
|
priv->angle_tilt = g_value_get_int (value);
|
|
|
|
break;
|
2007-04-30 08:39:11 +00:00
|
|
|
case PROP_WIDTH:
|
2007-04-30 08:39:20 +00:00
|
|
|
priv->a = g_value_get_int (value) >> 1;
|
2007-04-30 08:39:11 +00:00
|
|
|
break;
|
|
|
|
case PROP_HEIGHT:
|
2007-04-30 08:39:20 +00:00
|
|
|
priv->b = g_value_get_int (value) >> 1;
|
2007-04-30 08:39:11 +00:00
|
|
|
break;
|
|
|
|
case PROP_CENTER:
|
2007-05-25 12:07:24 +00:00
|
|
|
{
|
|
|
|
ClutterKnot * k = g_value_get_boxed (value);
|
|
|
|
if (k)
|
|
|
|
clutter_behaviour_ellipse_set_center (el, k->x, k->y);
|
|
|
|
}
|
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
break;
|
|
|
|
default:
|
|
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_get_property (GObject *gobject,
|
|
|
|
guint prop_id,
|
|
|
|
GValue *value,
|
|
|
|
GParamSpec *pspec)
|
|
|
|
{
|
|
|
|
ClutterBehaviourEllipsePrivate *priv;
|
|
|
|
|
|
|
|
priv = CLUTTER_BEHAVIOUR_ELLIPSE (gobject)->priv;
|
|
|
|
|
|
|
|
switch (prop_id)
|
|
|
|
{
|
|
|
|
case PROP_ANGLE_BEGIN:
|
|
|
|
g_value_set_int (value, priv->angle_begin);
|
|
|
|
break;
|
|
|
|
case PROP_ANGLE_END:
|
|
|
|
g_value_set_int (value, priv->angle_end);
|
|
|
|
break;
|
2007-05-15 11:51:14 +00:00
|
|
|
case PROP_ANGLE_TILT:
|
|
|
|
g_value_set_int (value, priv->angle_tilt);
|
|
|
|
break;
|
2007-04-30 08:39:11 +00:00
|
|
|
case PROP_WIDTH:
|
|
|
|
g_value_set_int (value, 2 * priv->a);
|
|
|
|
break;
|
|
|
|
case PROP_HEIGHT:
|
|
|
|
g_value_set_int (value, 2 * priv->b);
|
|
|
|
break;
|
|
|
|
case PROP_CENTER:
|
|
|
|
g_value_set_boxed (value, &priv->center);
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2007-07-11 07:16:21 +00:00
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_apply (ClutterBehaviour *behave,
|
|
|
|
ClutterActor *actor)
|
|
|
|
{
|
|
|
|
ClutterKnot knot;
|
|
|
|
ClutterBehaviourEllipse * e = CLUTTER_BEHAVIOUR_ELLIPSE (behave);
|
|
|
|
|
|
|
|
clutter_behaviour_ellipse_advance (e, e->priv->angle_begin, &knot);
|
|
|
|
|
|
|
|
clutter_actor_set_position (actor, knot.x, knot.y);
|
|
|
|
|
|
|
|
if (CLUTTER_BEHAVIOUR_CLASS (clutter_behaviour_ellipse_parent_class)->apply)
|
|
|
|
CLUTTER_BEHAVIOUR_CLASS (clutter_behaviour_ellipse_parent_class)->apply (behave, actor);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_class_init (ClutterBehaviourEllipseClass *klass)
|
|
|
|
{
|
|
|
|
GObjectClass * object_class = G_OBJECT_CLASS (klass);
|
|
|
|
ClutterBehaviourClass * behave_class = CLUTTER_BEHAVIOUR_CLASS (klass);
|
|
|
|
|
|
|
|
object_class->finalize = clutter_behaviour_ellipse_finalize;
|
|
|
|
object_class->set_property = clutter_behaviour_ellipse_set_property;
|
|
|
|
object_class->get_property = clutter_behaviour_ellipse_get_property;
|
|
|
|
|
|
|
|
behave_class->alpha_notify = clutter_behaviour_ellipse_alpha_notify;
|
2007-07-11 07:16:21 +00:00
|
|
|
behave_class->apply = clutter_behaviour_ellipse_apply;
|
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
/**
|
|
|
|
* ClutterBehaviourEllipse:angle-begin:
|
|
|
|
*
|
2007-04-30 08:39:20 +00:00
|
|
|
* The initial angle from where the rotation should begin.
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
g_object_class_install_property (object_class,
|
|
|
|
PROP_ANGLE_BEGIN,
|
|
|
|
g_param_spec_int ("angle-begin",
|
|
|
|
"Angle Begin",
|
|
|
|
"Initial angle",
|
2007-05-31 09:29:12 +00:00
|
|
|
G_MININT, G_MAXINT, 0,
|
2007-04-30 08:39:11 +00:00
|
|
|
CLUTTER_PARAM_READWRITE));
|
|
|
|
/**
|
|
|
|
* ClutterBehaviourEllipse:angle-end:
|
|
|
|
*
|
|
|
|
* The final angle to where the rotation should end.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
g_object_class_install_property (object_class,
|
|
|
|
PROP_ANGLE_END,
|
|
|
|
g_param_spec_int ("angle-end",
|
|
|
|
"Angle End",
|
|
|
|
"Final angle",
|
2007-05-31 09:29:12 +00:00
|
|
|
G_MININT, G_MAXINT, 1024,
|
2007-04-30 08:39:11 +00:00
|
|
|
CLUTTER_PARAM_READWRITE));
|
2007-05-15 11:51:14 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* ClutterBehaviourEllipse:angle-end:
|
|
|
|
*
|
|
|
|
* The final angle to where the rotation should end.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
g_object_class_install_property (object_class,
|
|
|
|
PROP_ANGLE_TILT,
|
|
|
|
g_param_spec_int ("angle-tilt",
|
|
|
|
"Angle Tilt",
|
|
|
|
"Tilt of the ellipse",
|
2007-05-31 09:29:12 +00:00
|
|
|
G_MININT, G_MAXINT, 1024,
|
2007-05-15 11:51:14 +00:00
|
|
|
CLUTTER_PARAM_READWRITE));
|
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
/**
|
|
|
|
* ClutterBehaviourEllipse:width:
|
|
|
|
*
|
|
|
|
* Width of the ellipse.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
g_object_class_install_property (object_class,
|
|
|
|
PROP_WIDTH,
|
|
|
|
g_param_spec_int ("width",
|
|
|
|
"Width",
|
|
|
|
"Width of ellipse",
|
|
|
|
0, G_MAXINT, 100,
|
|
|
|
CLUTTER_PARAM_READWRITE));
|
|
|
|
/**
|
|
|
|
* ClutterBehaviourEllipse:height:
|
|
|
|
*
|
|
|
|
* Height of the ellipse.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
g_object_class_install_property (object_class,
|
|
|
|
PROP_HEIGHT,
|
|
|
|
g_param_spec_int ("height",
|
|
|
|
"Height",
|
|
|
|
"Height of ellipse",
|
|
|
|
0, G_MAXINT, 50,
|
|
|
|
CLUTTER_PARAM_READWRITE));
|
|
|
|
/**
|
|
|
|
* ClutterBehaviourEllipse:center:
|
|
|
|
*
|
|
|
|
* The center of the ellipse.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
g_object_class_install_property (object_class,
|
|
|
|
PROP_CENTER,
|
|
|
|
g_param_spec_boxed ("center",
|
|
|
|
"Center",
|
|
|
|
"Center of ellipse",
|
|
|
|
CLUTTER_TYPE_KNOT,
|
|
|
|
CLUTTER_PARAM_READWRITE));
|
|
|
|
|
|
|
|
g_type_class_add_private (klass, sizeof (ClutterBehaviourEllipsePrivate));
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
clutter_behaviour_ellipse_init (ClutterBehaviourEllipse * self)
|
|
|
|
{
|
|
|
|
ClutterBehaviourEllipsePrivate *priv;
|
|
|
|
|
|
|
|
self->priv = priv = CLUTTER_BEHAVIOUR_ELLIPSE_GET_PRIVATE (self);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_new:
|
|
|
|
* @alpha: a #ClutterAlpha, or %NULL
|
2007-05-25 12:07:24 +00:00
|
|
|
* @x: x coordinace of the center
|
|
|
|
* @y: y coordiance of the center
|
2007-04-30 08:39:11 +00:00
|
|
|
* @width: width of the ellipse
|
2007-04-30 08:39:20 +00:00
|
|
|
* @height: height of the ellipse
|
2007-05-25 12:07:24 +00:00
|
|
|
* @begin: angle in degrees at which movement begins
|
|
|
|
* @end: angle in degrees at which movement ends
|
|
|
|
* @tilt: angle in degrees with which the ellipse should be tilted around its
|
2007-05-15 11:51:14 +00:00
|
|
|
* center
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
2007-04-30 08:39:20 +00:00
|
|
|
* Creates a behaviour that drives actors along an elliptical path with
|
2007-05-31 10:11:06 +00:00
|
|
|
* given center, width and height; the movement begins at angle_begin (with 0
|
|
|
|
* corresponding to 12 o'clock) and ends at angle_end; if angle_end > angle_begin,
|
|
|
|
* the movement is in clockwise direction, counter-clockwise otherwise.
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
|
|
|
* Return value: a #ClutterBehaviour
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
ClutterBehaviour *
|
|
|
|
clutter_behaviour_ellipse_new (ClutterAlpha * alpha,
|
2007-05-25 12:07:24 +00:00
|
|
|
gint x,
|
|
|
|
gint y,
|
2007-04-30 08:39:11 +00:00
|
|
|
gint width,
|
|
|
|
gint height,
|
2007-05-25 12:07:24 +00:00
|
|
|
gdouble begin,
|
|
|
|
gdouble end,
|
|
|
|
gdouble tilt)
|
2007-04-30 08:39:11 +00:00
|
|
|
{
|
|
|
|
ClutterBehaviourEllipse *bc;
|
|
|
|
|
|
|
|
g_return_val_if_fail (alpha == NULL || CLUTTER_IS_ALPHA (alpha), NULL);
|
2007-05-25 12:07:24 +00:00
|
|
|
|
|
|
|
ClutterKnot center;
|
|
|
|
center.x = x;
|
|
|
|
center.y = y;
|
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
bc = g_object_new (CLUTTER_TYPE_BEHAVIOUR_ELLIPSE,
|
|
|
|
"alpha", alpha,
|
2007-05-25 12:07:24 +00:00
|
|
|
"center", ¢er,
|
2007-04-30 08:39:11 +00:00
|
|
|
"width", width,
|
|
|
|
"height", height,
|
2007-05-31 10:11:06 +00:00
|
|
|
"angle-begin", CLUTTER_ANGLE_FROM_DEG (begin) - 256,
|
|
|
|
"angle-end", CLUTTER_ANGLE_FROM_DEG (end) - 256,
|
2007-05-25 12:07:24 +00:00
|
|
|
"angle-tilt", CLUTTER_ANGLE_FROM_DEG (tilt),
|
2007-04-30 08:39:11 +00:00
|
|
|
NULL);
|
|
|
|
|
|
|
|
return CLUTTER_BEHAVIOUR (bc);
|
|
|
|
}
|
|
|
|
|
2007-05-25 12:07:24 +00:00
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_newx:
|
|
|
|
* @alpha: a #ClutterAlpha, or %NULL
|
|
|
|
* @x: x coordinace of the center
|
|
|
|
* @y: y coordiance of the center
|
|
|
|
* @width: width of the ellipse
|
|
|
|
* @height: height of the ellipse
|
|
|
|
* @begin: #ClutterFixed angle in degrees at which movement begins
|
|
|
|
* @end: #ClutterFixed angle in degrees at which movement ends
|
2007-05-31 10:11:06 +00:00
|
|
|
* @tilt: #ClutterFixed angle in degrees with which the ellipse should be
|
|
|
|
* tilted around its center
|
2007-05-25 12:07:24 +00:00
|
|
|
*
|
|
|
|
* Creates a behaviour that drives actors along an elliptical path with
|
2007-05-31 10:11:06 +00:00
|
|
|
* given center, width and height; the movement begins at angle_begin (with 0
|
|
|
|
* corresponding to 12 o'clock) and ends at angle_end; if angle_end > angle_begin,
|
|
|
|
* the movement is in clockwise direction, counter-clockwise otherwise.
|
2007-05-25 12:07:24 +00:00
|
|
|
*
|
|
|
|
* Return value: a #ClutterBehaviour
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
ClutterBehaviour *
|
|
|
|
clutter_behaviour_ellipse_newx (ClutterAlpha * alpha,
|
|
|
|
gint x,
|
|
|
|
gint y,
|
|
|
|
gint width,
|
|
|
|
gint height,
|
|
|
|
ClutterFixed begin,
|
|
|
|
ClutterFixed end,
|
|
|
|
ClutterFixed tilt)
|
|
|
|
{
|
|
|
|
ClutterBehaviourEllipse *bc;
|
|
|
|
|
|
|
|
g_return_val_if_fail (alpha == NULL || CLUTTER_IS_ALPHA (alpha), NULL);
|
|
|
|
|
|
|
|
ClutterKnot center;
|
|
|
|
center.x = x;
|
|
|
|
center.y = y;
|
|
|
|
|
|
|
|
bc = g_object_new (CLUTTER_TYPE_BEHAVIOUR_ELLIPSE,
|
|
|
|
"alpha", alpha,
|
|
|
|
"center", ¢er,
|
|
|
|
"width", width,
|
|
|
|
"height", height,
|
2007-05-31 10:11:06 +00:00
|
|
|
"angle-begin", CLUTTER_ANGLE_FROM_DEGX (begin) - 256,
|
|
|
|
"angle-end", CLUTTER_ANGLE_FROM_DEGX (end) - 256,
|
2007-05-25 12:07:24 +00:00
|
|
|
"angle-tilt", CLUTTER_ANGLE_FROM_DEGX (tilt),
|
|
|
|
NULL);
|
|
|
|
|
|
|
|
return CLUTTER_BEHAVIOUR (bc);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2007-04-30 08:39:11 +00:00
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_center
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
2007-05-25 12:07:24 +00:00
|
|
|
* @x: x coordinace of centre
|
|
|
|
* @y: y coordinace of centre
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
2007-04-30 08:39:20 +00:00
|
|
|
* Sets the center of the elliptical path to the point represented by knot.
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_center (ClutterBehaviourEllipse * self,
|
2007-05-25 12:07:24 +00:00
|
|
|
gint x,
|
|
|
|
gint y)
|
2007-04-30 08:39:11 +00:00
|
|
|
{
|
2007-05-25 12:07:24 +00:00
|
|
|
if (self->priv->center.x != x || self->priv->center.y != y)
|
2007-04-30 08:39:20 +00:00
|
|
|
{
|
|
|
|
g_object_ref (self);
|
2007-05-25 12:07:24 +00:00
|
|
|
self->priv->center.x = x;
|
|
|
|
self->priv->center.y = y;
|
2007-04-30 08:39:20 +00:00
|
|
|
g_object_notify (G_OBJECT (self), "center");
|
|
|
|
g_object_unref (self);
|
|
|
|
}
|
2007-04-30 08:39:11 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_center
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
2007-05-25 12:07:24 +00:00
|
|
|
* @x: location to store the x coordinace of the center, or NULL
|
|
|
|
* @y: location to store the y coordinace of the center, or NULL
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
2007-04-30 08:39:20 +00:00
|
|
|
* Gets the center of the elliptical path path.
|
2007-04-30 08:39:11 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_get_center (ClutterBehaviourEllipse * self,
|
2007-05-25 12:07:24 +00:00
|
|
|
gint * x,
|
|
|
|
gint * y)
|
2007-04-30 08:39:11 +00:00
|
|
|
{
|
2007-05-25 12:07:24 +00:00
|
|
|
if (x)
|
|
|
|
*x = self->priv->center.x;
|
|
|
|
|
|
|
|
if (y)
|
|
|
|
*y = self->priv->center.y;
|
2007-04-30 08:39:11 +00:00
|
|
|
}
|
|
|
|
|
2007-04-30 08:39:20 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_width
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
* @width: width of the ellipse
|
|
|
|
*
|
|
|
|
* Sets the width of the elliptical path.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse * self,
|
|
|
|
gint width)
|
|
|
|
{
|
|
|
|
if (self->priv->a != width >> 1)
|
|
|
|
{
|
|
|
|
g_object_ref (self);
|
|
|
|
self->priv->a = width >> 1;
|
|
|
|
g_object_notify (G_OBJECT (self), "width");
|
|
|
|
g_object_unref (self);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_width
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the width of the elliptical path.
|
2007-05-17 12:03:43 +00:00
|
|
|
*
|
2007-06-01 10:00:35 +00:00
|
|
|
* Return value: the width of the path
|
2007-04-30 08:39:20 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
gint
|
|
|
|
clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse * self)
|
|
|
|
{
|
|
|
|
return self->priv->a << 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_height
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
* @height: height of the ellipse
|
|
|
|
*
|
|
|
|
* Sets the height of the elliptical path.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_height (ClutterBehaviourEllipse * self,
|
|
|
|
gint height)
|
|
|
|
{
|
|
|
|
if (self->priv->b != height >> 1)
|
|
|
|
{
|
|
|
|
g_object_ref (self);
|
|
|
|
self->priv->b = height >> 1;
|
|
|
|
g_object_notify (G_OBJECT (self), "height");
|
|
|
|
g_object_unref (self);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_height
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the height of the elliptical path.
|
2007-05-17 12:03:43 +00:00
|
|
|
*
|
|
|
|
* Return value: the height of the path
|
2007-04-30 08:39:20 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
gint
|
|
|
|
clutter_behaviour_ellipse_get_height (ClutterBehaviourEllipse * self)
|
|
|
|
{
|
|
|
|
return self->priv->b << 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_angle_begin
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
2007-07-11 07:16:21 +00:00
|
|
|
* @angle_begin: angle at which movement begins in degrees
|
2007-04-30 08:39:20 +00:00
|
|
|
*
|
|
|
|
* Sets the angle at which movement begins.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_angle_begin (ClutterBehaviourEllipse * self,
|
2007-07-11 07:16:21 +00:00
|
|
|
gdouble angle_begin)
|
|
|
|
{
|
|
|
|
clutter_behaviour_ellipse_set_angle_beginx (self,
|
|
|
|
CLUTTER_ANGLE_FROM_DEG (angle_begin));
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_angle_beginx
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
* @angle_begin: #ClutterAngle at which movement begins
|
|
|
|
*
|
|
|
|
* Sets the angle at which movement begins.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_angle_beginx (ClutterBehaviourEllipse * self,
|
|
|
|
ClutterAngle angle_begin)
|
2007-04-30 08:39:20 +00:00
|
|
|
{
|
|
|
|
if (self->priv->angle_begin != angle_begin)
|
|
|
|
{
|
|
|
|
g_object_ref (self);
|
|
|
|
self->priv->angle_begin = angle_begin;
|
|
|
|
g_object_notify (G_OBJECT (self), "angle-begin");
|
|
|
|
g_object_unref (self);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_angle_begin
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
2007-05-17 12:03:43 +00:00
|
|
|
* Gets the angle at which movements begins.
|
|
|
|
*
|
2007-07-11 07:16:21 +00:00
|
|
|
* Return value: angle in degrees
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
gdouble
|
|
|
|
clutter_behaviour_ellipse_get_angle_begin (ClutterBehaviourEllipse * self)
|
|
|
|
{
|
|
|
|
return CLUTTER_ANGLE_TO_DEG (self->priv->angle_begin);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_angle_beginx
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the angle at which movements begins.
|
|
|
|
*
|
2007-05-17 12:03:43 +00:00
|
|
|
* Return value: a #ClutterAngle
|
2007-04-30 08:39:20 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
ClutterAngle
|
2007-07-11 07:16:21 +00:00
|
|
|
clutter_behaviour_ellipse_get_angle_beginx (ClutterBehaviourEllipse * self)
|
2007-04-30 08:39:20 +00:00
|
|
|
{
|
|
|
|
return self->priv->angle_begin;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_angle_end
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
2007-07-11 07:16:21 +00:00
|
|
|
* @angle_end: angle at which movement ends in degrees.
|
2007-04-30 08:39:20 +00:00
|
|
|
*
|
|
|
|
* Sets the angle at which movement ends.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_angle_end (ClutterBehaviourEllipse * self,
|
2007-07-11 07:16:21 +00:00
|
|
|
gdouble angle_end)
|
|
|
|
{
|
|
|
|
clutter_behaviour_ellipse_set_angle_endx (self,
|
|
|
|
CLUTTER_ANGLE_FROM_DEG (angle_end));
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_angle_endx
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
* @angle_end: #ClutterAngle at which movement ends
|
|
|
|
*
|
|
|
|
* Sets the angle at which movement ends.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_angle_endx (ClutterBehaviourEllipse * self,
|
|
|
|
ClutterAngle angle_end)
|
2007-04-30 08:39:20 +00:00
|
|
|
{
|
|
|
|
if (self->priv->angle_end != angle_end)
|
|
|
|
{
|
|
|
|
g_object_ref (self);
|
|
|
|
self->priv->angle_end = angle_end;
|
|
|
|
g_object_notify (G_OBJECT (self), "angle-end");
|
|
|
|
g_object_unref (self);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_angle_end
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the at which movements ends.
|
2007-05-17 12:03:43 +00:00
|
|
|
*
|
2007-07-11 07:16:21 +00:00
|
|
|
* Return value: angle in degrees
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
gdouble
|
|
|
|
clutter_behaviour_ellipse_get_angle_end (ClutterBehaviourEllipse * self)
|
|
|
|
{
|
|
|
|
return CLUTTER_ANGLE_TO_DEG (self->priv->angle_end);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_angle_endx
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the angle at which movements ends.
|
|
|
|
*
|
2007-05-17 12:03:43 +00:00
|
|
|
* Return value: a #ClutterAngle
|
2007-04-30 08:39:20 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
ClutterAngle
|
2007-07-11 07:16:21 +00:00
|
|
|
clutter_behaviour_ellipse_get_angle_endx (ClutterBehaviourEllipse * self)
|
2007-04-30 08:39:20 +00:00
|
|
|
{
|
|
|
|
return self->priv->angle_end;
|
|
|
|
}
|
|
|
|
|
2007-05-15 11:51:14 +00:00
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_angle_tilt
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
2007-07-11 07:16:21 +00:00
|
|
|
* @angle_tilt: tilt of the elipse around the center in degrees.
|
2007-05-15 11:51:14 +00:00
|
|
|
*
|
|
|
|
* Sets the angle at which the ellipse should be tilted around it's center.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_angle_tilt (ClutterBehaviourEllipse * self,
|
2007-07-11 07:16:21 +00:00
|
|
|
gdouble angle_tilt)
|
|
|
|
{
|
|
|
|
clutter_behaviour_ellipse_set_angle_tiltx (self,
|
|
|
|
CLUTTER_ANGLE_FROM_DEG (angle_tilt));
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_set_angle_tiltx
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
* @angle_tilt: #ClutterAngle tilt of the elipse around the center
|
|
|
|
*
|
|
|
|
* Sets the angle at which the ellipse should be tilted around it's center.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
clutter_behaviour_ellipse_set_angle_tiltx (ClutterBehaviourEllipse * self,
|
|
|
|
ClutterAngle angle_tilt)
|
2007-05-15 11:51:14 +00:00
|
|
|
{
|
|
|
|
if (self->priv->angle_tilt != angle_tilt)
|
|
|
|
{
|
|
|
|
g_object_ref (self);
|
|
|
|
self->priv->angle_tilt = angle_tilt;
|
|
|
|
g_object_notify (G_OBJECT (self), "angle-tilt");
|
|
|
|
g_object_unref (self);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_angle_tilt
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the tilt of the ellipse around the center.
|
2007-05-17 12:03:43 +00:00
|
|
|
*
|
2007-07-11 07:16:21 +00:00
|
|
|
* Return value: angle in degrees.
|
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
gdouble
|
|
|
|
clutter_behaviour_ellipse_get_angle_tilt (ClutterBehaviourEllipse * self)
|
|
|
|
{
|
|
|
|
return CLUTTER_ANGLE_TO_DEG (self->priv->angle_tilt);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* clutter_behaviour_ellipse_get_angle_tiltx
|
|
|
|
* @self: a #ClutterBehaviourEllipse
|
|
|
|
*
|
|
|
|
* Gets the tilt of the ellipse around the center.
|
|
|
|
*
|
2007-05-17 12:03:43 +00:00
|
|
|
* Return value: a #ClutterAngle
|
2007-05-15 11:51:14 +00:00
|
|
|
*
|
|
|
|
* Since: 0.4
|
|
|
|
*/
|
|
|
|
ClutterAngle
|
2007-07-11 07:16:21 +00:00
|
|
|
clutter_behaviour_ellipse_get_angle_tiltx (ClutterBehaviourEllipse * self)
|
2007-05-15 11:51:14 +00:00
|
|
|
{
|
|
|
|
return self->priv->angle_tilt;
|
|
|
|
}
|
|
|
|
|