Add ClutterPropertyTransition

ClutterPropertyTransition is a ClutterTransition that animates a
property of a ClutterAnimatable implementation.
This commit is contained in:
Emmanuele Bassi 2012-03-15 11:06:00 +00:00
parent 0c8443f71a
commit 40bcbf9c0d
4 changed files with 382 additions and 0 deletions

View File

@ -102,6 +102,7 @@ source_h = \
$(srcdir)/clutter-page-turn-effect.h \
$(srcdir)/clutter-path-constraint.h \
$(srcdir)/clutter-path.h \
$(srcdir)/clutter-property-transition.h \
$(srcdir)/clutter-script.h \
$(srcdir)/clutter-scriptable.h \
$(srcdir)/clutter-settings.h \
@ -174,6 +175,7 @@ source_c = \
$(srcdir)/clutter-page-turn-effect.c \
$(srcdir)/clutter-path-constraint.c \
$(srcdir)/clutter-path.c \
$(srcdir)/clutter-property-transition.c \
$(srcdir)/clutter-script.c \
$(srcdir)/clutter-script-parser.c \
$(srcdir)/clutter-scriptable.c \

View File

@ -0,0 +1,291 @@
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
* Copyright (C) 2012 Intel Corporation
*
* 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, see <http://www.gnu.org/licenses/>.
*/
/**
* SECTION:clutter-property-transition
* @Title: ClutterPropertyTransition
* @Short_Description: Property transitions
*
* #ClutterPropertyTransition is a specialized #ClutterTransition that
* can be used to tween a property of a #ClutterAnimatable instance.
*
* #ClutterPropertyTransition is available since Clutter 1.10
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "clutter-property-transition.h"
#include "clutter-animatable.h"
#include "clutter-debug.h"
#include "clutter-interval.h"
#include "clutter-private.h"
#include "clutter-transition.h"
struct _ClutterPropertyTransitionPrivate
{
char *property_name;
GParamSpec *pspec;
};
enum
{
PROP_0,
PROP_PROPERTY_NAME,
PROP_LAST
};
static GParamSpec *obj_props[PROP_LAST] = { NULL, };
G_DEFINE_TYPE (ClutterPropertyTransition, clutter_property_transition, CLUTTER_TYPE_TRANSITION)
static void
clutter_property_transition_attached (ClutterTransition *transition,
ClutterAnimatable *animatable)
{
ClutterPropertyTransition *self = CLUTTER_PROPERTY_TRANSITION (transition);
ClutterPropertyTransitionPrivate *priv = self->priv;
if (priv->property_name == NULL)
return;
priv->pspec = clutter_animatable_find_property (animatable,
priv->property_name);
}
static void
clutter_property_transition_detached (ClutterTransition *transition,
ClutterAnimatable *animatable)
{
ClutterPropertyTransition *self = CLUTTER_PROPERTY_TRANSITION (transition);
ClutterPropertyTransitionPrivate *priv = self->priv;
priv->pspec = NULL;
}
static void
clutter_property_transition_compute_value (ClutterTransition *transition,
ClutterAnimatable *animatable,
ClutterInterval *interval,
gdouble progress)
{
ClutterPropertyTransition *self = CLUTTER_PROPERTY_TRANSITION (transition);
ClutterPropertyTransitionPrivate *priv = self->priv;
GValue value = G_VALUE_INIT;
gboolean res;
if (priv->pspec == NULL)
return;
g_value_init (&value, clutter_interval_get_value_type (interval));
res = clutter_animatable_interpolate_value (animatable,
priv->property_name,
interval,
progress,
&value);
if (res)
clutter_animatable_set_final_state (animatable,
priv->property_name,
&value);
g_value_unset (&value);
}
static void
clutter_property_transition_set_property (GObject *gobject,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
ClutterPropertyTransition *self = CLUTTER_PROPERTY_TRANSITION (gobject);
switch (prop_id)
{
case PROP_PROPERTY_NAME:
clutter_property_transition_set_property_name (self,
g_value_get_string (value));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
}
}
static void
clutter_property_transition_get_property (GObject *gobject,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
ClutterPropertyTransitionPrivate *priv = CLUTTER_PROPERTY_TRANSITION (gobject)->priv;
switch (prop_id)
{
case PROP_PROPERTY_NAME:
g_value_set_string (value, priv->property_name);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
}
}
static void
clutter_property_transition_finalize (GObject *gobject)
{
ClutterPropertyTransitionPrivate *priv;
priv = CLUTTER_PROPERTY_TRANSITION (gobject)->priv;
g_free (priv->property_name);
G_OBJECT_CLASS (clutter_property_transition_parent_class)->finalize (gobject);
}
static void
clutter_property_transition_class_init (ClutterPropertyTransitionClass *klass)
{
ClutterTransitionClass *transition_class = CLUTTER_TRANSITION_CLASS (klass);
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
g_type_class_add_private (klass, sizeof (ClutterPropertyTransitionPrivate));
transition_class->attached = clutter_property_transition_attached;
transition_class->detached = clutter_property_transition_detached;
transition_class->compute_value = clutter_property_transition_compute_value;
gobject_class->set_property = clutter_property_transition_set_property;
gobject_class->get_property = clutter_property_transition_get_property;
gobject_class->finalize = clutter_property_transition_finalize;
/**
* ClutterPropertyTransition:property-name:
*
* The name of the property of a #ClutterAnimatable to animate.
*
* Since: 1.10
*/
obj_props[PROP_PROPERTY_NAME] =
g_param_spec_string ("property-name",
P_("Property Name"),
P_("The name of the property to animate"),
NULL,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_properties (gobject_class, PROP_LAST, obj_props);
}
static void
clutter_property_transition_init (ClutterPropertyTransition *self)
{
self->priv =
G_TYPE_INSTANCE_GET_PRIVATE (self, CLUTTER_TYPE_PROPERTY_TRANSITION,
ClutterPropertyTransitionPrivate);
}
/**
* clutter_property_transition_new:
* @animatable: (allow-none): a #ClutterAnimatable, or %NULL
* @property_name: (allow-none): a property of @animatable, or %NULL
*
* Creates a new #ClutterPropertyTransition for @animatable.
*
* Return value: (transfer full): the newly created #ClutterPropertyTransition.
* Use g_object_unref() when done
*
* Since: 1.10
*/
ClutterTransition *
clutter_property_transition_new (ClutterAnimatable *animatable,
const char *property_name)
{
return g_object_new (CLUTTER_TYPE_PROPERTY_TRANSITION,
"animatable", animatable,
"property-name", property_name,
NULL);
}
/**
* clutter_property_transition_set_property_name:
* @transition: a #ClutterPropertyTransition
* @property_name: (allow-none): a property name
*
* Sets the #ClutterPropertyTransition:property-name property of @transition.
*
* Since: 1.10
*/
void
clutter_property_transition_set_property_name (ClutterPropertyTransition *transition,
const char *property_name)
{
ClutterPropertyTransitionPrivate *priv;
ClutterAnimatable *animatable;
g_return_if_fail (CLUTTER_IS_PROPERTY_TRANSITION (transition));
priv = transition->priv;
if (g_strcmp0 (priv->property_name, property_name) == 0)
return;
g_free (priv->property_name);
priv->property_name = g_strdup (property_name);
priv->pspec = NULL;
animatable =
clutter_transition_get_animatable (CLUTTER_TRANSITION (transition));
if (animatable != NULL)
{
priv->pspec = clutter_animatable_find_property (animatable,
priv->property_name);
}
g_object_notify_by_pspec (G_OBJECT (transition),
obj_props[PROP_PROPERTY_NAME]);
}
/**
* clutter_property_transition_get_property_name:
* @transition: a #ClutterPropertyTransition
*
* Retrieves the value of the #ClutterPropertyTransition:property-name
* property.
*
* Return value: the name of the property being animated, or %NULL if
* none is set. The returned string is owned by the @transition and
* it should not be freed.
*
* Since: 1.10
*/
const char *
clutter_property_transition_get_property_name (ClutterPropertyTransition *transition)
{
g_return_val_if_fail (CLUTTER_IS_PROPERTY_TRANSITION (transition), NULL);
return transition->priv->property_name;
}

View File

@ -0,0 +1,88 @@
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
* Copyright (C) 2012 Intel Corporation
*
* 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, see <http://www.gnu.org/licenses/>.
*
* Author: Emmanuele Bassi <ebassi@linux.intel.com>
*/
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
#error "Only <clutter/clutter.h> can be included directly."
#endif
#ifndef __CLUTTER_PROPERTY_TRANSITION_H__
#define __CLUTTER_PROPERTY_TRANSITION_H__
#include <clutter/clutter-types.h>
#include <clutter/clutter-transition.h>
G_BEGIN_DECLS
#define CLUTTER_TYPE_PROPERTY_TRANSITION (clutter_property_transition_get_type ())
#define CLUTTER_PROPERTY_TRANSITION(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), CLUTTER_TYPE_PROPERTY_TRANSITION, ClutterPropertyTransition))
#define CLUTTER_IS_PROPERTY_TRANSITION(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CLUTTER_TYPE_PROPERTY_TRANSITION))
#define CLUTTER_PROPERTY_TRANSITION_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), CLUTTER_TYPE_PROPERTY_TRANSITION, ClutterPropertyTransitionClass))
#define CLUTTER_IS_PROPERTY_TRANSITION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), CLUTTER_TYPE_PROPERTY_TRANSITION))
#define CLUTTER_PROPERTY_TRANSITION_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), CLUTTER_TYPE_PROPERTY_TRANSITION, ClutterPropertyTransitionClass))
typedef struct _ClutterPropertyTransitionPrivate ClutterPropertyTransitionPrivate;
typedef struct _ClutterPropertyTransitionClass ClutterPropertyTransitionClass;
/**
* ClutterPropertyTransition:
*
* The <structname>ClutterPropertyTransition</structname> structure contains
* private data and should only be accessed using the provided API.
*
* Since: 1.10
*/
struct _ClutterPropertyTransition
{
/*< private >*/
ClutterTransition parent_instance;
ClutterPropertyTransitionPrivate *priv;
};
/**
* ClutterPropertyTransitionClass:
*
* The <structname>ClutterPropertyTransitionClass</structname> structure
* contains private data.
*
* Since: 1.10
*/
struct _ClutterPropertyTransitionClass
{
/*< private >*/
ClutterTransitionClass parent_class;
gpointer _padding[8];
};
GType clutter_property_transition_get_type (void) G_GNUC_CONST;
ClutterTransition * clutter_property_transition_new (ClutterAnimatable *animatable,
const char *property_name);
void clutter_property_transition_set_property_name (ClutterPropertyTransition *transition,
const char *property_name);
const char * clutter_property_transition_get_property_name (ClutterPropertyTransition *transition);
G_END_DECLS
#endif /* __CLUTTER_PROPERTY_TRANSITION_H__ */

View File

@ -82,6 +82,7 @@
#include "clutter-page-turn-effect.h"
#include "clutter-path-constraint.h"
#include "clutter-path.h"
#include "clutter-property-transition.h"
#include "clutter-scriptable.h"
#include "clutter-script.h"
#include "clutter-settings.h"