/* * 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 . */ /** * 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; }