]> git.sesse.net Git - vlc/blob - include/vlc_objects.h
Changes to the libvlc API:
[vlc] / include / vlc_objects.h
1 /*****************************************************************************
2  * vlc_objects.h: vlc_object_t definition.
3  *****************************************************************************
4  * Copyright (C) 2002 VideoLAN
5  * $Id: vlc_objects.h,v 1.12 2002/10/11 22:32:55 sam Exp $
6  *
7  * Authors: Samuel Hocevar <sam@zoy.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., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
22  *****************************************************************************/
23
24 /* Object types */
25 #define VLC_OBJECT_ROOT       (-1)
26 #define VLC_OBJECT_VLC        (-2)
27 #define VLC_OBJECT_MODULE     (-3)
28 #define VLC_OBJECT_INTF       (-4)
29 #define VLC_OBJECT_PLAYLIST   (-5)
30 #define VLC_OBJECT_ITEM       (-6)
31 #define VLC_OBJECT_INPUT      (-7)
32 #define VLC_OBJECT_DECODER    (-8)
33 #define VLC_OBJECT_VOUT       (-9)
34 #define VLC_OBJECT_AOUT      (-10)
35 #define VLC_OBJECT_SOUT      (-11)
36 #define VLC_OBJECT_GENERIC  (-666)
37
38 /* Object search mode */
39 #define FIND_PARENT         0x0001
40 #define FIND_CHILD          0x0002
41 #define FIND_ANYWHERE       0x0003
42
43 #define FIND_STRICT         0x0010
44
45 /*****************************************************************************
46  * The vlc_object_t type. Yes, it's that simple :-)
47  *****************************************************************************/
48 struct vlc_object_t
49 {
50     VLC_COMMON_MEMBERS
51 };
52
53 /*****************************************************************************
54  * The vlc_list_t object list type
55  *****************************************************************************/
56 struct vlc_list_t
57 {
58     int             i_count;
59     vlc_object_t ** pp_objects;
60
61     /* Private */
62     int             _i_extra;
63     vlc_object_t *  _p_first;
64 };  
65
66 /*****************************************************************************
67  * Prototypes
68  *****************************************************************************/
69 VLC_EXPORT( void *, __vlc_object_create, ( vlc_object_t *, int ) );
70 VLC_EXPORT( void, __vlc_object_destroy, ( vlc_object_t * ) );
71 VLC_EXPORT( void, __vlc_object_attach, ( vlc_object_t *, vlc_object_t * ) );
72 VLC_EXPORT( void, __vlc_object_detach, ( vlc_object_t * ) );
73 VLC_EXPORT( void *, __vlc_object_get, ( vlc_object_t *, int ) );
74 VLC_EXPORT( void *, __vlc_object_find, ( vlc_object_t *, int, int ) );
75 VLC_EXPORT( void, __vlc_object_yield, ( vlc_object_t * ) );
76 VLC_EXPORT( void, __vlc_object_release, ( vlc_object_t * ) );
77 VLC_EXPORT( vlc_list_t *, __vlc_list_find, ( vlc_object_t *, int, int ) );
78 VLC_EXPORT( void, vlc_list_release, ( vlc_list_t * ) );
79
80 VLC_EXPORT( void, __vlc_liststructure, ( vlc_object_t * ) );
81 VLC_EXPORT( void, __vlc_dumpstructure, ( vlc_object_t * ) );
82
83 #define vlc_object_create(a,b) \
84     __vlc_object_create( VLC_OBJECT(a), b )
85
86 #define vlc_object_destroy(a) do { \
87     __vlc_object_destroy( VLC_OBJECT(a) ); \
88     (a) = NULL; } while(0)
89
90 #define vlc_object_detach(a) \
91     __vlc_object_detach( VLC_OBJECT(a) )
92
93 #define vlc_object_attach(a,b) \
94     __vlc_object_attach( VLC_OBJECT(a), VLC_OBJECT(b) )
95
96 #define vlc_object_get(a,b) \
97     __vlc_object_get( VLC_OBJECT(a),b)
98
99 #define vlc_object_find(a,b,c) \
100     __vlc_object_find( VLC_OBJECT(a),b,c)
101
102 #define vlc_object_yield(a) \
103     __vlc_object_yield( VLC_OBJECT(a) )
104
105 #define vlc_object_release(a) \
106     __vlc_object_release( VLC_OBJECT(a) )
107
108 #define vlc_list_find(a,b,c) \
109     __vlc_list_find( VLC_OBJECT(a),b,c)
110
111 #define vlc_liststructure(a) \
112     __vlc_liststructure( VLC_OBJECT(a) )
113
114 #define vlc_dumpstructure(a) \
115     __vlc_dumpstructure( VLC_OBJECT(a) )
116