brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

state: Allow setting a NULL state

Browse Source 
Allow setting a %NULL state. This has the effect of unsetting the current
state and stopping all animation. This allows you to, for example, start
a state transition, set the state to NULL, alter the state transition
and then resume it again, by just setting it.
This commit is contained in:
Chris Lord 2010-10-21 16:51:45 +01:00
parent 9c5f09f32d
commit 5700b34b9c
1 changed files with 18 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
clutter/clutter-state.c
View File

@ -468,10 +468,21 @@ clutter_state_change (ClutterState *state,
GList *k;
g_return_val_if_fail (CLUTTER_IS_STATE (state), NULL);
g_return_val_if_fail (target_state_name != NULL, NULL);
priv = state->priv;
/* If we've been asked to change state to NULL, reset the
* ClutterState to its initial state, but leave the keys
* alone.
*/
if (!target_state_name)
{
priv->source_state_name = priv->target_state_name = NULL;
clutter_timeline_stop (priv->timeline);
clutter_timeline_rewind (priv->timeline);
return NULL;
}
if (target_state_name != NULL)
target_state_name = g_intern_string (target_state_name);
@ -567,11 +578,14 @@ clutter_state_change (ClutterState *state,
* @state: a #ClutterState
* @target_state_name: the state to transition to
*
* Change the current state of #ClutterState to @target_state_name
* Change the current state of #ClutterState to @target_state_name.
*
* The state will animate during its transition, see
* #clutter_state_warp_to_state for animation-free state switching.
*
* Setting a %NULL state will stop the current animation and unset
* the current state, but keys will be left intact.
*
* Return value: (transfer none): the #ClutterTimeline that drives the
* state transition. The returned timeline is owned by the #ClutterState
* and it should not be unreferenced
@ -590,10 +604,10 @@ clutter_state_set_state (ClutterState *state,
* @state: a #ClutterState
* @target_state_name: the state to transition to
*
* Change the current state of #ClutterState to @target_state_name
*
* Change to the specified target state immediately with no animation.
*
* See clutter_state_set_state().
*
* Return value: (transfer none): the #ClutterTimeline that drives the
* state transition. The returned timeline is owned by the #ClutterState
* and it should not be unreferenced