82e7b4af42beca15155662d84f64aa1aec1528fd
[vlc.git] / extras / MacOSX / Framework / Sources / VLCMediaList.m
1 /*****************************************************************************
2  * VLCMediaList.m: VLC.framework VLCMediaList implementation
3  *****************************************************************************
4  * Copyright (C) 2007 Pierre d'Herbemont
5  * Copyright (C) 2007 the VideoLAN team
6  * $Id$
7  *
8  * Authors: Pierre d'Herbemont <pdherbemont # videolan.org>
9  *
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.
14  *
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.
19  *
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  *****************************************************************************/
24
25 #import "VLCMediaList.h"
26 #import "VLCLibrary.h"
27 #import "VLCEventManager.h"
28 #import "VLCLibVLCBridging.h"
29 #include <vlc/vlc.h>
30 #include <vlc/libvlc.h>
31
32 /* Notification Messages */
33 NSString *VLCMediaListItemAdded        = @"VLCMediaListItemAdded";
34 NSString *VLCMediaListItemDeleted      = @"VLCMediaListItemDeleted";
35
36 // TODO: Documentation
37 @interface VLCMediaList (Private)
38 /* Initializers */
39 - (void)initInternalMediaList;
40
41 /* Libvlc event bridges */
42 - (void)mediaListItemAdded:(NSArray *)args;
43 - (void)mediaListItemRemoved:(NSNumber *)index;
44 @end
45
46 /* libvlc event callback */
47 static void HandleMediaListItemAdded(const libvlc_event_t *event, void *user_data)
48 {
49     NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
50     id self = user_data;
51     [[VLCEventManager sharedManager] callOnMainThreadObject:self 
52                                                  withMethod:@selector(mediaListItemAdded:) 
53                                        withArgumentAsObject:[NSArray arrayWithObject:[NSDictionary dictionaryWithObjectsAndKeys:
54                                                           [VLCMedia mediaWithLibVLCMediaDescriptor:event->u.media_list_item_added.item], @"media",
55                                                           [NSNumber numberWithInt:event->u.media_list_item_added.index], @"index",
56                                                           nil]]];
57     [pool release];
58 }
59
60 static void HandleMediaListItemDeleted( const libvlc_event_t * event, void * user_data)
61 {
62     NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
63     id self = user_data;
64     [[VLCEventManager sharedManager] callOnMainThreadObject:self 
65                                                  withMethod:@selector(mediaListItemRemoved:) 
66                                        withArgumentAsObject:[NSNumber numberWithInt:event->u.media_list_item_deleted.index]];
67     [pool release];
68 }
69
70 @implementation VLCMediaList (KeyValueCodingCompliance)
71 /* For the @"media" key */
72 - (int) countOfMedia
73 {
74     return [self count];
75 }
76
77 - (id) objectInMediaAtIndex:(int)i
78 {
79     return [self mediaAtIndex:i];
80 }
81 @end
82
83 @implementation VLCMediaList
84 - (id)init
85 {
86     if (self = [super init])
87     {
88         // Create a new libvlc media list instance
89         libvlc_exception_t p_e;
90         libvlc_exception_init(&p_e);
91         p_mlist = libvlc_media_list_new([VLCLibrary sharedInstance], &p_e);
92         quit_on_exception(&p_e);
93         
94         // Initialize internals to defaults
95         cachedMedia = [[NSMutableArray alloc] init];
96         delegate = flatAspect = hierarchicalAspect = nil;
97         [self initInternalMediaList];
98     }
99     return self;
100 }
101
102 - (void)release
103 {
104     @synchronized(self)
105     {
106         if([self retainCount] <= 1)
107         {
108             /* We must make sure we won't receive new event after an upcoming dealloc
109              * We also may receive a -retain in some event callback that may occcur
110              * Before libvlc_event_detach. So this can't happen in dealloc */
111             libvlc_event_manager_t * p_em = libvlc_media_list_event_manager(p_mlist, NULL);
112             libvlc_event_detach(p_em, libvlc_MediaListItemDeleted, HandleMediaListItemDeleted, self, NULL);
113             libvlc_event_detach(p_em, libvlc_MediaListItemAdded,   HandleMediaListItemAdded,   self, NULL);
114         }
115         [super release];
116     }
117 }
118
119 - (void)dealloc
120 {
121     // Release allocated memory
122     libvlc_media_list_release(p_mlist);
123     [cachedMedia release];
124     [flatAspect release];
125     [hierarchicalAspect release];
126     [super dealloc];
127 }
128
129 - (NSString *)description
130 {
131     NSMutableString *content = [NSMutableString string];
132     int i;
133     for( i = 0; i < [self count]; i++)
134     {
135         [content appendFormat:@"%@\n", [self mediaAtIndex: i]];
136     }
137     return [NSString stringWithFormat:@"<%@ %p> {\n%@}", [self className], self, content];
138 }
139
140 - (void)setDelegate:(id)value
141 {
142     delegate = value;
143 }
144
145 - (id)delegate
146 {
147     return delegate;
148 }
149
150 - (void)lock
151 {
152     libvlc_media_list_lock( p_mlist );
153 }
154
155 - (void)unlock
156 {
157     libvlc_media_list_unlock( p_mlist );
158 }
159
160 - (int)addMedia:(VLCMedia *)media
161 {
162     int index = [self count];
163     [self insertMedia:media atIndex:index];
164     return index;
165 }
166
167 - (void)insertMedia:(VLCMedia *)media atIndex: (int)index
168 {
169     [media retain];
170
171     // Add it to the libvlc's medialist
172     libvlc_exception_t p_e;
173     libvlc_exception_init( &p_e );
174     libvlc_media_list_insert_media_descriptor( p_mlist, [media libVLCMediaDescriptor], index, &p_e );
175     quit_on_exception( &p_e );
176 }
177
178 - (void)removeMediaAtIndex:(int)index
179 {
180     [[self mediaAtIndex:index] release];
181
182     // Remove it from the libvlc's medialist
183     libvlc_exception_t p_e;
184     libvlc_exception_init( &p_e );
185     libvlc_media_list_remove_index( p_mlist, index, &p_e );
186     quit_on_exception( &p_e );
187 }
188
189 - (VLCMedia *)mediaAtIndex:(int)index
190 {
191     return [cachedMedia objectAtIndex:index];
192 }
193
194 - (int)count
195 {
196     return [cachedMedia count];
197 }
198
199 - (int)indexOfMedia:(VLCMedia *)media
200 {
201     libvlc_exception_t p_e;
202     libvlc_exception_init( &p_e );
203     int result = libvlc_media_list_index_of_item( p_mlist, [media libVLCMediaDescriptor], &p_e );
204     quit_on_exception( &p_e );
205     
206     return result;
207 }
208
209 - (BOOL)isReadOnly
210 {
211     libvlc_exception_t p_e;
212     libvlc_exception_init( &p_e );
213     BOOL isReadOnly = libvlc_media_list_is_readonly( p_mlist );
214     quit_on_exception( &p_e );
215     
216     return isReadOnly;
217 }
218
219 /* Media list aspect */
220 - (VLCMediaListAspect *)hierarchicalAspect
221 {
222     if( hierarchicalAspect )
223         return hierarchicalAspect;
224     libvlc_media_list_view_t * p_mlv = libvlc_media_list_hierarchical_view( p_mlist, NULL );
225     hierarchicalAspect = [[VLCMediaListAspect mediaListAspectWithLibVLCMediaListView: p_mlv andMediaList:self] retain];
226     libvlc_media_list_view_release( p_mlv );
227     return hierarchicalAspect;
228 }
229
230 - (VLCMediaListAspect *)hierarchicalNodeAspect
231 {
232     if( hierarchicalAspect )
233         return hierarchicalAspect;
234     libvlc_media_list_view_t * p_mlv = libvlc_media_list_hierarchical_node_view( p_mlist, NULL );
235     hierarchicalAspect = [[VLCMediaListAspect mediaListAspectWithLibVLCMediaListView: p_mlv andMediaList:self] retain];
236     libvlc_media_list_view_release( p_mlv );
237     return hierarchicalAspect;
238 }
239
240 - (VLCMediaListAspect *)flatAspect
241 {
242     if( flatAspect )
243         return flatAspect;
244     libvlc_media_list_view_t * p_mlv = libvlc_media_list_flat_view( p_mlist, NULL );
245     flatAspect = [[VLCMediaListAspect mediaListAspectWithLibVLCMediaListView: p_mlv andMediaList:self] retain];
246     libvlc_media_list_view_release( p_mlv );
247     return flatAspect;
248 }
249
250 @end
251
252 @implementation VLCMediaList (LibVLCBridging)
253 + (id)mediaListWithLibVLCMediaList:(void *)p_new_mlist;
254 {
255     return [[[VLCMediaList alloc] initWithLibVLCMediaList:p_new_mlist] autorelease];
256 }
257
258 - (id)initWithLibVLCMediaList:(void *)p_new_mlist;
259 {
260     if( self = [super init] )
261     {
262         p_mlist = p_new_mlist;
263         libvlc_media_list_retain(p_mlist);
264         libvlc_media_list_lock(p_mlist);
265         cachedMedia = [[NSMutableArray alloc] initWithCapacity:libvlc_media_list_count(p_mlist, NULL)];
266         int i, count = libvlc_media_list_count(p_mlist, NULL);
267         for( i = 0; i < count; i++ )
268         {
269             libvlc_media_descriptor_t * p_md = libvlc_media_list_item_at_index(p_mlist, i, NULL);
270             [cachedMedia addObject:[VLCMedia mediaWithLibVLCMediaDescriptor: p_md]];
271             libvlc_media_descriptor_release(p_md);
272         }
273         [self initInternalMediaList];
274         libvlc_media_list_unlock(p_mlist);
275     }
276     return self;
277 }
278
279 - (void *)libVLCMediaList
280 {
281     return p_mlist;
282 }
283 @end
284
285 @implementation VLCMediaList (Private)
286 - (void)initInternalMediaList
287 {
288     // Add event callbacks
289     libvlc_exception_t p_e;
290     libvlc_exception_init(&p_e);
291
292     libvlc_event_manager_t *p_em = libvlc_media_list_event_manager( p_mlist, &p_e );
293     libvlc_event_attach( p_em, libvlc_MediaListItemAdded,   HandleMediaListItemAdded,   self, &p_e );
294     libvlc_event_attach( p_em, libvlc_MediaListItemDeleted, HandleMediaListItemDeleted, self, &p_e );
295     
296     quit_on_exception( &p_e );
297 }
298
299 - (void)mediaListItemAdded:(NSArray *)arrayOfArgs
300 {
301     /* We hope to receive index in a nide range, that could change one day */
302     int start = [[[arrayOfArgs objectAtIndex: 0] objectForKey:@"index"] intValue];
303     int end = [[[arrayOfArgs objectAtIndex: [arrayOfArgs count]-1] objectForKey:@"index"] intValue];
304     NSRange range = NSMakeRange(start, end-start);
305     [self willChange:NSKeyValueChangeInsertion valuesAtIndexes:[NSIndexSet indexSetWithIndexesInRange:range] forKey:@"media"];
306     int i = [[[arrayOfArgs objectAtIndex: 0] objectForKey:@"index"] intValue];
307     [arrayOfArgs retain];
308     for( NSDictionary * args in arrayOfArgs )
309     {
310         int index = [[args objectForKey:@"index"] intValue];
311         VLCMedia * media = [args objectForKey:@"media"];
312         /* Sanity check */
313         NSAssert( i == index, @"Expects some troubles, inserted items are not in a range" ); i++;
314         if( index && index >= [cachedMedia count] )
315             index = [cachedMedia count] - 1;
316         [cachedMedia insertObject:media atIndex:index];
317     }
318     [self didChange:NSKeyValueChangeInsertion valuesAtIndexes:[NSIndexSet indexSetWithIndexesInRange:range] forKey:@"media"];
319
320     // Post the notification
321 //    [[NSNotificationCenter defaultCenter] postNotificationName:VLCMediaListItemAdded
322 //                                                        object:self
323 //                                                      userInfo:args];
324
325     // Let the delegate know that the item was added
326   //  if (delegate && [delegate respondsToSelector:@selector(mediaList:mediaAdded:atIndex:)])
327     //    [delegate mediaList:self mediaAdded:media atIndex:index];
328 }
329
330 - (void)mediaListItemRemoved:(NSNumber *)index
331 {
332     [self willChange:NSKeyValueChangeInsertion valuesAtIndexes:[NSIndexSet indexSetWithIndex:[index intValue]] forKey:@"media"];
333     [cachedMedia removeObjectAtIndex:[index intValue]];
334     [self didChange:NSKeyValueChangeInsertion valuesAtIndexes:[NSIndexSet indexSetWithIndex:[index intValue]] forKey:@"media"];
335
336     // Post the notification
337     [[NSNotificationCenter defaultCenter] postNotificationName:VLCMediaListItemDeleted 
338                                                         object:self
339                                                       userInfo:[NSDictionary dictionaryWithObjectsAndKeys:
340                                                           index, @"index",
341                                                           nil]];
342
343     // Let the delegate know that the item is being removed
344     if (delegate && [delegate respondsToSelector:@selector(mediaList:mediaRemovedAtIndex:)])
345         [delegate mediaList:self mediaRemovedAtIndex:[index intValue]];
346 }
347 @end