2934e09ee2c9f3d774b0e7b9884441f568cda3f6
[vlc.git] / src / control / core.c
1 /*****************************************************************************
2  * core.c: Core libvlc new API functions : initialization, exceptions handling
3  *****************************************************************************
4  * Copyright (C) 2005 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Cl´┐Żent Stenac <zorglub@videolan.org>
8  *
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.
13  *
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.
18  *
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  *****************************************************************************/
23 #include <stdarg.h>
24 #include <libvlc_internal.h>
25 #include <vlc/libvlc.h>
26
27 #include <vlc/intf.h>
28
29 /*************************************************************************
30  * Exceptions handling
31  *************************************************************************/
32 inline void libvlc_exception_init( libvlc_exception_t *p_exception )
33 {
34     p_exception->b_raised = 0;
35     p_exception->psz_message = NULL;
36 }
37
38 void libvlc_exception_clear( libvlc_exception_t *p_exception )
39 {
40     if( p_exception->psz_message )
41         free( p_exception->psz_message );
42     p_exception->psz_message = NULL;
43     p_exception->b_raised = 0;
44 }
45
46 inline int libvlc_exception_raised( libvlc_exception_t *p_exception )
47 {
48     return p_exception->b_raised;
49 }
50
51 inline char* libvlc_exception_get_message( libvlc_exception_t *p_exception )
52 {
53     if( p_exception->b_raised == 1 && p_exception->psz_message )
54     {
55         return p_exception->psz_message;
56     }
57     return NULL;
58 }
59
60 inline void libvlc_exception_raise( libvlc_exception_t *p_exception,
61                                     char *psz_format, ... )
62 {
63     va_list args;
64
65     /* does caller care about exceptions ? */
66     if( p_exception == NULL )
67        return;
68
69     /* remove previous exception if it wasn't cleared */
70     if( p_exception->b_raised && p_exception->psz_message )
71     {
72        free(p_exception->psz_message);
73        p_exception->psz_message = NULL;
74     }
75
76     va_start( args, psz_format );
77     vasprintf( &p_exception->psz_message, psz_format, args );
78     va_end( args );
79
80     p_exception->b_raised = 1;
81 }
82
83 libvlc_instance_t * libvlc_new( int argc, char **argv,
84                                 libvlc_exception_t *p_exception )
85 {
86     int i_vlc_id;
87     libvlc_instance_t *p_new;
88     vlc_t *p_vlc;
89
90     i_vlc_id = VLC_Create();
91     p_vlc = (vlc_t* ) vlc_current_object( i_vlc_id );
92
93     if( !p_vlc )
94     {
95         libvlc_exception_raise( p_exception, "VLC initialization failed" );
96         return NULL;
97     }
98     p_new = (libvlc_instance_t *)malloc( sizeof( libvlc_instance_t ) );
99
100     /** \todo Look for interface settings. If we don't have any, add -I dummy */
101     /* Because we probably don't want a GUI by default */
102
103     if( !p_new )
104     {
105         libvlc_exception_raise( p_exception, "Out of memory" );
106         return NULL;
107     }
108
109     VLC_Init( i_vlc_id, argc, argv );
110
111     p_new->p_vlc = p_vlc;
112     p_new->p_playlist = (playlist_t *)vlc_object_find( p_new->p_vlc,
113                                 VLC_OBJECT_PLAYLIST, FIND_CHILD );
114     p_new->p_vlm = NULL;
115
116     if( !p_new->p_playlist )
117     {
118         libvlc_exception_raise( p_exception, "Playlist creation failed" );
119         return NULL;
120     }
121     p_new->i_vlc_id = i_vlc_id;
122
123     return p_new;
124 }
125
126 void libvlc_destroy( libvlc_instance_t *p_instance )
127 {
128     if( p_instance->p_playlist )
129         vlc_object_release( p_instance->p_playlist );
130     vlc_object_release( p_instance->p_vlc );
131     VLC_CleanUp( p_instance->i_vlc_id );
132     VLC_Destroy( p_instance->i_vlc_id );
133 }
134
135 int libvlc_get_vlc_id( libvlc_instance_t *p_instance )
136 {
137     return p_instance->i_vlc_id;
138 }
139