1 /*****************************************************************************
2 * event.c: New libvlc event control API
3 *****************************************************************************
4 * Copyright (C) 2007 the VideoLAN team
7 * Authors: Filippo Carone <filippo@carone.org>
8 * Pierre d'Herbemont <pdherbemont # videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 #include "libvlc_internal.h"
26 #include <vlc/libvlc.h>
27 #include <vlc_playlist.h>
34 /**************************************************************************
35 * handle_event (private)
37 * Callback from the vlc variables
38 **************************************************************************/
39 static int handle_event( vlc_object_t *p_this, char const *psz_cmd,
40 vlc_value_t oldval, vlc_value_t newval,
43 /* This is thread safe, as the var_*Callback already provide the locking
44 * facility for p_data */
45 struct libvlc_callback_entry_t *entry = p_data;
48 event.type = entry->i_event_type;
50 if (event.type == libvlc_VolumeChanged)
52 if(!strcmp(psz_cmd, "intf-change"))
54 input_thread_t * p_input = (input_thread_t *)p_this;
56 var_Get( p_input, "time", &val );
58 /* Only send event at a reasonable time precision (500ms) */
59 /* (FIXME: this should be configurable) */
60 if ((val.i_time % I64C(500000)) != 0)
62 /* Don't send this event */
66 event.u.input_position_changed.new_position = val.i_time;
69 event.u.input_position_changed.new_position = newval.i_time;
71 event.u.input_position_changed.new_position *= 1000LL;
73 else if (event.type == libvlc_InputPositionChanged)
75 event.u.volume_changed.new_volume = newval.i_int;
78 /* Call the client entry */
79 entry->f_callback( entry->p_instance, &event, entry->p_user_data );
84 /**************************************************************************
85 * get_input (private) :
87 * Utility function, Object should be released by vlc_object_release
89 **************************************************************************/
90 static input_thread_t * get_input(libvlc_instance_t * p_instance)
92 libvlc_media_instance_t * p_mi;
93 input_thread_t * p_input;
95 p_mi = libvlc_playlist_get_media_instance( p_instance, NULL );
100 p_input = libvlc_get_input_thread( p_mi, NULL );
102 libvlc_media_instance_release( p_mi );
107 /**************************************************************************
108 * install_input_event (private) :
110 * vlc variables callback, used to install input event.
111 * Can be called manually though.
112 **************************************************************************/
113 static int install_input_event( vlc_object_t *p_this, char const *psz_cmd,
114 vlc_value_t oldval, vlc_value_t newval,
117 libvlc_instance_t * p_instance = p_data;
118 struct libvlc_callback_entry_list_t *p_listitem;
119 input_thread_t * p_input = get_input( p_instance );
124 vlc_mutex_lock( &p_instance->instance_lock );
126 p_listitem = p_instance->p_callback_list;
128 for( ; p_listitem ; p_listitem = p_listitem->next )
130 if (p_listitem->elmt->i_event_type == libvlc_InputPositionChanged)
132 /* FIXME: here we shouldn't listen on intf-change, we have to provide
133 * in vlc core a more accurate callback */
134 var_AddCallback( p_input, "intf-change", handle_event, p_listitem->elmt );
135 var_AddCallback( p_input, "time", handle_event, p_listitem->elmt );
139 vlc_mutex_unlock( &p_instance->instance_lock );
140 vlc_object_release( p_input );
144 /**************************************************************************
145 * add_callback_to_list (private) :
147 * callback list utility function.
148 **************************************************************************/
149 static inline void add_callback_to_list( struct libvlc_callback_entry_t *entry,
150 struct libvlc_callback_entry_list_t **list )
152 struct libvlc_callback_entry_list_t *new_listitem;
154 /* malloc/free strategy:
155 * - alloc-ded in add_callback_entry
156 * - free-ed by libvlc_event_remove_callback
157 * - free-ed in libvlc_destroy threw libvlc_event_remove_callback
158 * when entry is destroyed
160 new_listitem = malloc( sizeof( struct libvlc_callback_entry_list_t ) );
161 new_listitem->elmt = entry;
162 new_listitem->next = *list;
163 new_listitem->prev = NULL;
166 (*list)->prev = new_listitem;
168 *list = new_listitem;
171 /**************************************************************************
172 * remove_variable_callback (private) :
174 * Delete the appropriate vlc variables callback for an event.
175 **************************************************************************/
176 static int remove_variable_callback( libvlc_instance_t *p_instance,
177 struct libvlc_callback_entry_t * p_entry )
179 input_thread_t * p_input = get_input( p_instance );
180 int res = VLC_SUCCESS;
182 /* Note: Appropriate lock should be held by the caller */
184 switch ( p_entry->i_event_type )
186 case libvlc_VolumeChanged:
187 res = var_DelCallback( p_instance->p_libvlc_int, "volume-change",
188 handle_event, p_entry );
190 case libvlc_InputPositionChanged:
191 /* We may not be deleting the right p_input callback, in this case this
193 var_DelCallback( p_input, "intf-change", handle_event, p_entry );
194 var_DelCallback( p_input, "position", handle_event, p_entry );
199 vlc_object_release( p_input );
205 * Internal libvlc functions
208 /**************************************************************************
209 * libvlc_event_init (internal) :
211 * initialization function.
212 **************************************************************************/
213 void libvlc_event_init( libvlc_instance_t *p_instance, libvlc_exception_t *p_e )
215 playlist_t *p_playlist = p_instance->p_libvlc_int->p_playlist;
218 RAISEVOID ("Can't listen to input event");
220 /* Install a Callback for input changes, so
221 * so we can track input event */
222 var_AddCallback( p_playlist, "playlist-current",
223 install_input_event, p_instance );
226 /**************************************************************************
227 * libvlc_event_fini (internal) :
229 * finalization function.
230 **************************************************************************/
231 void libvlc_event_fini( libvlc_instance_t *p_instance, libvlc_exception_t *p_e )
233 playlist_t *p_playlist = p_instance->p_libvlc_int->p_playlist;
234 libvlc_exception_t p_e_unused;
236 libvlc_event_remove_all_callbacks( p_instance, &p_e_unused );
239 RAISEVOID ("Can't unregister input events");
241 var_DelCallback( p_playlist, "playlist-current",
242 install_input_event, p_instance );
246 * Public libvlc functions
249 /**************************************************************************
250 * libvlc_event_add_callback (public) :
252 * Add a callback for an event.
253 **************************************************************************/
254 void libvlc_event_add_callback( libvlc_instance_t *p_instance,
255 libvlc_event_type_t i_event_type,
256 libvlc_callback_t f_callback,
258 libvlc_exception_t *p_e )
260 struct libvlc_callback_entry_t *entry;
261 vlc_value_t unused1, unused2;
262 int res = VLC_SUCCESS;
265 RAISEVOID (" Callback function is null ");
267 /* malloc/free strategy:
268 * - alloc-ded in libvlc_event_add_callback
269 * - free-ed by libvlc_event_add_callback on error
270 * - free-ed by libvlc_event_remove_callback
271 * - free-ed in libvlc_destroy threw libvlc_event_remove_callback
272 * when entry is destroyed
274 entry = malloc( sizeof( struct libvlc_callback_entry_t ) );
275 entry->f_callback = f_callback;
276 entry->i_event_type = i_event_type;
277 entry->p_user_data = user_data;
279 switch ( i_event_type )
281 case libvlc_VolumeChanged:
282 res = var_AddCallback( p_instance->p_libvlc_int, "volume-change",
283 handle_event, entry );
285 case libvlc_InputPositionChanged:
286 install_input_event( NULL, NULL, unused1, unused2, p_instance);
290 RAISEVOID( "Unsupported event." );
293 if (res != VLC_SUCCESS)
296 RAISEVOID("Internal callback registration was not successful. Callback not registered.");
299 vlc_mutex_lock( &p_instance->instance_lock );
300 add_callback_to_list( entry, &p_instance->p_callback_list );
301 vlc_mutex_unlock( &p_instance->instance_lock );
306 /**************************************************************************
307 * libvlc_event_remove_callback (public) :
309 * Remove a callback for an event.
310 **************************************************************************/
311 void libvlc_event_remove_callback( libvlc_instance_t *p_instance,
312 libvlc_event_type_t i_event_type,
313 libvlc_callback_t f_callback,
315 libvlc_exception_t *p_e )
317 struct libvlc_callback_entry_list_t *p_listitem;
319 vlc_mutex_lock( &p_instance->instance_lock );
321 p_listitem = p_instance->p_callback_list;
325 if( p_listitem->elmt->f_callback == f_callback
326 && ( p_listitem->elmt->i_event_type == i_event_type )
327 && ( p_listitem->elmt->p_user_data == p_user_data )
331 remove_variable_callback( p_instance, p_listitem->elmt ); /* FIXME: We should warn on error */
333 if( p_listitem->prev )
334 p_listitem->prev->next = p_listitem->next;
336 p_instance->p_callback_list = p_listitem->next;
339 p_listitem->next->prev = p_listitem->prev;
341 free( p_listitem->elmt );
347 p_listitem = p_listitem->next;
349 vlc_mutex_unlock( &p_instance->instance_lock );
352 /**************************************************************************
353 * libvlc_event_remove_all_callbacks (public) :
355 * Remove all callbacks for all events.
356 **************************************************************************/
357 void libvlc_event_remove_all_callbacks( libvlc_instance_t *p_instance,
358 libvlc_exception_t *p_e )
360 struct libvlc_callback_entry_list_t *p_listitem;
362 vlc_mutex_lock( &p_instance->instance_lock );
364 p_listitem = p_instance->p_callback_list;
368 remove_variable_callback( p_instance, p_listitem->elmt ); /* FIXME: We could warn on error */
369 p_listitem = p_listitem->next;
372 p_instance->p_callback_list = NULL;
374 vlc_mutex_unlock( &p_instance->instance_lock );