1 /*****************************************************************************
2 * vlc_mediacontrol.c: vlc.MediaControl binding
3 *****************************************************************************
4 * Copyright (C) 2006 the VideoLAN team
7 * Authors: Olivier Aubert <oaubert at bat710.univ-lyon1.fr>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
25 /*****************************************************************************
26 * VLC MediaControl object implementation
27 *****************************************************************************/
29 /* The MediaControl constructor takes either an existing vlc.Instance or a
32 MediaControl_new( PyTypeObject *type, PyObject *args, PyObject *kwds )
35 mediacontrol_Exception *exception = NULL;
36 PyObject* py_param = NULL;
37 char** ppsz_args = NULL;
38 libvlc_instance_t* p_instance = NULL;
41 self = PyObject_New( MediaControl, &MediaControl_Type );
43 if( PyArg_ParseTuple( args, "O", &py_param ) )
45 Py_INCREF( py_param );
46 if( PyObject_TypeCheck( py_param, &vlcInstance_Type ) == 1 )
48 p_instance = ((vlcInstance*)py_param)->p_instance;
54 if( ! PySequence_Check( py_param ) )
56 PyErr_SetString( PyExc_TypeError, "Parameter must be a vlc.Instance or a sequence of strings." );
57 Py_DECREF( py_param );
60 i_size = PySequence_Size( py_param );
61 ppsz_args = malloc( ( i_size + 1 ) * sizeof( char * ) );
64 PyErr_SetString( PyExc_MemoryError, "Out of memory" );
65 Py_DECREF( py_param );
69 for ( i_index = 0; i_index < i_size; i_index++ )
72 strdup( PyString_AsString( PyObject_Str(
73 PySequence_GetItem( py_param,
76 ppsz_args[i_size] = NULL;
78 Py_DECREF( py_param );
82 /* No arguments were given. Clear the exception raised
83 by PyArg_ParseTuple. */
87 Py_BEGIN_ALLOW_THREADS
91 self->mc = mediacontrol_new_from_instance( p_instance, exception );
95 self->mc = mediacontrol_new( i_size, ppsz_args, exception );
101 return ( PyObject * )self;
105 MediaControl_dealloc( PyObject *self )
111 MediaControl_get_vlc_instance( PyObject *self, PyObject *args )
115 p_ret = PyObject_New( vlcInstance, &vlcInstance_Type );
118 p_ret->p_instance = mediacontrol_get_libvlc_instance( SELF->mc );
119 return ( PyObject * )p_ret;
123 * Return the current position in the stream. The returned value can
124 be relative or absolute ( according to PositionOrigin ) and the unit
125 is set by PositionKey
128 MediaControl_get_media_position( PyObject *self, PyObject *args )
130 mediacontrol_Position* pos;
131 mediacontrol_Exception* exception = NULL;
135 mediacontrol_PositionOrigin origin;
136 mediacontrol_PositionKey key;
138 if( !PyArg_ParseTuple( args, "OO", &py_origin, &py_key ) )
141 origin = positionOrigin_py_to_c( py_origin );
142 key = positionKey_py_to_c( py_key );
144 Py_BEGIN_ALLOW_THREADS
146 pos = mediacontrol_get_media_position( SELF->mc, origin, key, exception );
150 py_retval = ( PyObject* )position_c_to_py( pos );
155 /** Set the media position */
157 MediaControl_set_media_position( PyObject *self, PyObject *args )
159 mediacontrol_Exception* exception = NULL;
160 mediacontrol_Position *a_position;
163 if( !PyArg_ParseTuple( args, "O", &py_pos ) )
166 a_position = position_py_to_c( py_pos );
169 PyErr_SetString( PyExc_MemoryError, "Out of memory" );
173 Py_BEGIN_ALLOW_THREADS
175 mediacontrol_set_media_position( SELF->mc, a_position, exception );
180 Py_INCREF( Py_None );
185 MediaControl_start( PyObject *self, PyObject *args )
187 mediacontrol_Position *a_position;
188 mediacontrol_Exception *exception = NULL;
191 if( !PyArg_ParseTuple( args, "O", &py_pos ) )
193 /* No argument. Use a default 0 value. */
197 a_position = position_py_to_c( py_pos );
201 Py_BEGIN_ALLOW_THREADS
203 mediacontrol_start( SELF->mc, a_position, exception );
208 Py_INCREF( Py_None );
213 MediaControl_pause( PyObject *self, PyObject *args )
215 mediacontrol_Position *a_position;
216 mediacontrol_Exception *exception = NULL;
219 if( !PyArg_ParseTuple( args, "O", &py_pos ) )
221 /* No argument. Use a default 0 value. */
225 a_position = position_py_to_c( py_pos );
229 Py_BEGIN_ALLOW_THREADS
231 mediacontrol_pause( SELF->mc, a_position, exception );
236 Py_INCREF( Py_None );
241 MediaControl_resume( PyObject *self, PyObject *args )
243 mediacontrol_Position *a_position;
244 mediacontrol_Exception *exception = NULL;
247 if( !PyArg_ParseTuple( args, "O", &py_pos ) )
249 /* No argument. Use a default 0 value. */
253 a_position = position_py_to_c( py_pos );
257 Py_BEGIN_ALLOW_THREADS
259 mediacontrol_start( SELF->mc, a_position, exception );
264 Py_INCREF( Py_None );
269 MediaControl_stop( PyObject *self, PyObject *args )
271 mediacontrol_Position *a_position;
272 mediacontrol_Exception *exception = NULL;
275 if( !PyArg_ParseTuple( args, "O", &py_pos ) )
277 /* No argument. Use a default 0 value. */
281 a_position = position_py_to_c( py_pos );
285 Py_BEGIN_ALLOW_THREADS
287 mediacontrol_stop( SELF->mc, a_position, exception );
292 Py_INCREF( Py_None );
297 MediaControl_exit( PyObject *self, PyObject *args )
299 mediacontrol_exit( SELF->mc );
300 Py_INCREF( Py_None );
305 MediaControl_playlist_add_item( PyObject *self, PyObject *args )
308 mediacontrol_Exception *exception = NULL;
310 if( !PyArg_ParseTuple( args, "s", &psz_file ) )
313 Py_BEGIN_ALLOW_THREADS
315 mediacontrol_playlist_add_item( SELF->mc, psz_file, exception );
319 Py_INCREF( Py_None );
324 MediaControl_playlist_clear( PyObject *self, PyObject *args )
326 mediacontrol_Exception *exception = NULL;
328 Py_BEGIN_ALLOW_THREADS
330 mediacontrol_playlist_clear( SELF->mc, exception );
334 Py_INCREF( Py_None );
339 MediaControl_playlist_get_list( PyObject *self, PyObject *args )
342 mediacontrol_Exception *exception = NULL;
343 mediacontrol_PlaylistSeq* pl;
347 Py_BEGIN_ALLOW_THREADS
349 pl = mediacontrol_playlist_get_list( SELF->mc, exception );
353 i_playlist_size = pl->size;
355 py_retval = PyList_New( i_playlist_size );
357 for ( i_index = 0 ; i_index < i_playlist_size ; i_index++ )
359 PyList_SetItem( py_retval, i_index,
360 Py_BuildValue( "s", pl->data[i_index] ) );
362 mediacontrol_PlaylistSeq__free( pl );
369 MediaControl_snapshot( PyObject *self, PyObject *args )
371 mediacontrol_RGBPicture *p_retval = NULL;
372 mediacontrol_Exception* exception = NULL;
373 mediacontrol_Position *a_position = NULL;
374 PyObject *py_pos = NULL;
375 PyObject *py_obj = NULL;
377 if( !PyArg_ParseTuple( args, "O", &py_pos ) )
380 a_position = position_py_to_c( py_pos );
382 Py_BEGIN_ALLOW_THREADS
384 p_retval = mediacontrol_snapshot( SELF->mc, a_position, exception );
391 Py_INCREF( Py_None );
395 /* FIXME: create a real RGBPicture object */
396 py_obj = PyDict_New();
398 PyDict_SetItemString( py_obj, "width",
399 Py_BuildValue( "i", p_retval->width ) );
400 PyDict_SetItemString( py_obj, "height",
401 Py_BuildValue( "i", p_retval->height ) );
402 PyDict_SetItemString( py_obj, "type",
403 Py_BuildValue( "i", p_retval->type ) );
404 PyDict_SetItemString( py_obj, "data",
405 Py_BuildValue( "s#", p_retval->data, p_retval->size ) );
406 PyDict_SetItemString( py_obj, "date",
407 Py_BuildValue( "L", p_retval->date ) );
413 MediaControl_display_text( PyObject *self, PyObject *args )
415 mediacontrol_Exception* exception = NULL;
416 PyObject *py_begin, *py_end;
418 mediacontrol_Position * begin;
419 mediacontrol_Position * end;
421 if( !PyArg_ParseTuple( args, "sOO", &message, &py_begin, &py_end ) )
424 begin = position_py_to_c( py_begin );
425 end = position_py_to_c( py_end );
427 Py_BEGIN_ALLOW_THREADS
429 mediacontrol_display_text( SELF->mc, message, begin, end, exception );
436 Py_INCREF( Py_None );
441 MediaControl_get_stream_information( PyObject *self, PyObject *args )
443 mediacontrol_StreamInformation *retval = NULL;
444 mediacontrol_Exception* exception = NULL;
447 Py_BEGIN_ALLOW_THREADS
449 retval = mediacontrol_get_stream_information(
450 SELF->mc, mediacontrol_MediaTime, exception );
454 py_obj = PyDict_New( );
456 /* FIXME: create a real StreamInformation object */
457 PyDict_SetItemString( py_obj, "status",
458 Py_BuildValue( "i", retval->streamstatus ) );
459 PyDict_SetItemString( py_obj, "url",
460 Py_BuildValue( "s", retval->url ) );
461 PyDict_SetItemString( py_obj, "position",
462 Py_BuildValue( "L", retval->position ) );
463 PyDict_SetItemString( py_obj, "length",
464 Py_BuildValue( "L", retval->length ) );
473 MediaControl_sound_set_volume( PyObject *self, PyObject *args )
475 mediacontrol_Exception* exception = NULL;
476 unsigned short volume;
478 if( !PyArg_ParseTuple( args, "H", &volume ) )
481 Py_BEGIN_ALLOW_THREADS
483 mediacontrol_sound_set_volume( SELF->mc, volume, exception );
487 Py_INCREF( Py_None );
492 MediaControl_sound_get_volume( PyObject *self, PyObject *args )
494 mediacontrol_Exception* exception = NULL;
496 unsigned short volume;
498 Py_BEGIN_ALLOW_THREADS
500 volume = mediacontrol_sound_get_volume( SELF->mc, exception );
504 py_retval = Py_BuildValue( "H", volume );
509 MediaControl_set_rate( PyObject *self, PyObject *args )
511 mediacontrol_Exception* exception = NULL;
514 if( !PyArg_ParseTuple( args, "i", &rate ) )
517 Py_BEGIN_ALLOW_THREADS
519 mediacontrol_set_rate( SELF->mc, rate, exception );
523 Py_INCREF( Py_None );
528 MediaControl_get_rate( PyObject *self, PyObject *args )
530 mediacontrol_Exception* exception = NULL;
534 Py_BEGIN_ALLOW_THREADS
536 rate = mediacontrol_get_rate( SELF->mc, exception );
540 py_retval = Py_BuildValue( "i", rate );
545 MediaControl_set_fullscreen( PyObject *self, PyObject *args )
547 mediacontrol_Exception* exception = NULL;
550 if( !PyArg_ParseTuple( args, "i", &fs ) )
553 Py_BEGIN_ALLOW_THREADS
555 mediacontrol_set_fullscreen( SELF->mc, fs, exception );
559 Py_INCREF( Py_None );
564 MediaControl_get_fullscreen( PyObject *self, PyObject *args )
566 mediacontrol_Exception* exception = NULL;
570 Py_BEGIN_ALLOW_THREADS
572 fs = mediacontrol_get_fullscreen( SELF->mc, exception );
576 py_retval = Py_BuildValue( "i", fs );
581 MediaControl_set_visual( PyObject *self, PyObject *args )
583 mediacontrol_Exception* exception = NULL;
586 if( !PyArg_ParseTuple( args, "i", &visual ) )
589 Py_BEGIN_ALLOW_THREADS
591 mediacontrol_set_visual( SELF->mc, visual, exception );
595 Py_INCREF( Py_None );
599 static PyMethodDef MediaControl_methods[] =
601 { "get_vlc_instance", MediaControl_get_vlc_instance, METH_VARARGS,
602 "get_vlc_instance( ) -> Instance Get matching vlc.Instance." },
603 { "get_media_position", MediaControl_get_media_position, METH_VARARGS,
604 "get_media_position( origin, key ) -> Position Get current media position." },
605 { "set_media_position", MediaControl_set_media_position, METH_VARARGS,
606 "set_media_position( Position ) Set media position" },
607 { "start", MediaControl_start, METH_VARARGS,
608 "start( Position ) Start the player." },
609 { "pause", MediaControl_pause, METH_VARARGS,
610 "pause( Position ) Pause the player." },
611 { "resume", MediaControl_resume, METH_VARARGS,
612 "resume( Position ) Resume the player" },
613 { "stop", MediaControl_stop, METH_VARARGS,
614 "stop( Position ) Stop the player" },
615 { "exit", MediaControl_exit, METH_VARARGS,
616 "exit( ) Exit the player" },
617 { "playlist_add_item", MediaControl_playlist_add_item, METH_VARARGS,
618 "playlist_add_item( str ) Add an item to the playlist" },
619 { "playlist_get_list", MediaControl_playlist_get_list, METH_VARARGS,
620 "playlist_get_list( ) -> list Get the contents of the playlist" },
621 { "playlist_clear", MediaControl_playlist_clear, METH_VARARGS,
622 "clear( ) Clear the playlist." },
623 { "snapshot", MediaControl_snapshot, METH_VARARGS,
624 "snapshot( Position ) -> dict Take a snapshot" },
625 { "display_text", MediaControl_display_text, METH_VARARGS,
626 "display_text( str, Position, Position ) Display a text on the video" },
627 { "get_stream_information", MediaControl_get_stream_information,
629 "get_stream_information( ) -> dict Get information about the stream"},
630 { "sound_get_volume", MediaControl_sound_get_volume, METH_VARARGS,
631 "sound_get_volume( ) -> int Get the volume" },
632 { "sound_set_volume", MediaControl_sound_set_volume, METH_VARARGS,
633 "sound_set_volume( int ) Set the volume" },
634 { "set_visual", MediaControl_set_visual, METH_VARARGS,
635 "set_visual( int ) Set the embedding window visual ID" },
636 { "get_rate", MediaControl_get_rate, METH_VARARGS,
637 "get_rate( ) -> int Get the rate" },
638 { "set_rate", MediaControl_set_rate, METH_VARARGS,
639 "set_rate( int ) Set the rate" },
640 { "get_fullscreen", MediaControl_get_fullscreen, METH_VARARGS,
641 "get_fullscreen( ) -> int Get the fullscreen status" },
642 { "set_fullscreen", MediaControl_set_fullscreen, METH_VARARGS,
643 "set_fullscreen( int ) Set the fullscreen status" },
644 { NULL, NULL, 0, NULL },
647 static PyTypeObject MediaControl_Type =
649 PyObject_HEAD_INIT( NULL )
651 "vlc.MediaControl", /*tp_name*/
652 sizeof( MediaControl_Type ), /*tp_basicsize*/
654 ( destructor )MediaControl_dealloc, /*tp_dealloc*/
661 0, /*tp_as_sequence*/
669 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/
670 "Control of a VLC instance.\n\nvlc.MediaControl(args): initialisation with a list of VLC parameters.\nvlc.MediaControl(instance): initialisation with an existing vlc.Instance", /* tp_doc */
673 0, /* tp_richcompare */
674 0, /* tp_weaklistoffset */
677 MediaControl_methods, /* tp_methods */
682 0, /* tp_descr_get */
683 0, /* tp_descr_set */
684 0, /* tp_dictoffset */
687 MediaControl_new, /* tp_new */