gdkPixbufAnimationIterAdvance     package:RGtk2     R Documentation

_g_d_k_P_i_x_b_u_f_A_n_i_m_a_t_i_o_n_I_t_e_r_A_d_v_a_n_c_e

_D_e_s_c_r_i_p_t_i_o_n:

     Possibly advances an animation to a new frame. Chooses the frame
     based on the start time passed to 'gdkPixbufAnimationGetIter'.

_U_s_a_g_e:

     gdkPixbufAnimationIterAdvance(object, current.time)

_A_r_g_u_m_e_n_t_s:

'object': ['GdkPixbufAnimationIter']  a 'GdkPixbufAnimationIter'

'current.time': ['GTimeVal']  current time

_D_e_t_a_i_l_s:

     'current.time' would normally come from 'gGetCurrentTime()', and
     must be greater than or equal to the time passed to
     'gdkPixbufAnimationGetIter', and must increase or remain unchanged
     each time 'gdkPixbufAnimationIterGetPixbuf' is called. That is,
     you can't go backward in time; animations only play forward.

     As a shortcut, pass 'NULL' for the current time and
     'gGetCurrentTime()' will be invoked on your behalf. So you only
     need to explicitly pass 'current.time' if you're doing something
     odd like playing the animation at double speed.

     If this function returns 'FALSE', there's no need to update the
     animation display, assuming the display had been rendered prior to
     advancing; if 'TRUE', you need to call
     'gdkAnimationIterGetPixbuf()' and update the display with the new
     pixbuf.

_V_a_l_u_e:

     [logical] 'TRUE' if the image may need updating

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

