2 * mlt_playlist.c -- playlist service class
3 * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
4 * Author: Charles Yates <charles.yates@pandora.be>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software Foundation,
18 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 #include "mlt_playlist.h"
24 #include "mlt_frame.h"
29 /** Virtual playlist entry.
34 mlt_producer producer;
36 mlt_timecode playtime;
40 /** Private definition.
45 struct mlt_producer_s parent;
46 struct mlt_producer_s blank;
50 playlist_entry **list;
53 /** Forward declarations
56 static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index );
61 mlt_playlist mlt_playlist_init( )
63 mlt_playlist this = calloc( sizeof( struct mlt_playlist_s ), 1 );
66 mlt_producer producer = &this->parent;
68 // Construct the producer
69 mlt_producer_init( producer, this );
71 // Override the producer get_frame
72 producer->get_frame = producer_get_frame;
75 mlt_producer_init( &this->blank, NULL );
77 // Indicate that this producer is a playlist
78 mlt_properties_set_data( mlt_playlist_properties( this ), "playlist", this, 0, NULL, NULL );
84 /** Get the producer associated to this playlist.
87 mlt_producer mlt_playlist_producer( mlt_playlist this )
92 /** Get the service associated to this playlist.
95 mlt_service mlt_playlist_service( mlt_playlist this )
97 return mlt_producer_service( &this->parent );
100 /** Get the propertues associated to this playlist.
103 mlt_properties mlt_playlist_properties( mlt_playlist this )
105 return mlt_producer_properties( &this->parent );
108 static int mlt_playlist_virtual_refresh( mlt_playlist this )
112 // Get the fps of the first producer
113 double fps = mlt_properties_get_double( mlt_playlist_properties( this ), "first_fps" );
114 mlt_timecode playtime = 0;
116 for ( i = 0; i < this->count; i ++ )
119 mlt_producer producer = this->list[ i ]->producer;
124 // Inherit it from the producer
125 fps = mlt_producer_get_fps( producer );
127 else if ( fps != mlt_properties_get_double( mlt_producer_properties( producer ), "fps" ) )
129 // Generate a warning for now - the following attempt to fix may fail
130 fprintf( stderr, "Warning: fps mismatch on playlist producer %d\n", this->count );
132 // It should be safe to impose fps on an image producer, but not necessarily safe for video
133 mlt_properties_set_double( mlt_producer_properties( producer ), "fps", fps );
136 // Update the playtime for this clip
137 playtime += this->list[ i ]->playtime;
140 // Refresh all properties
141 mlt_properties_set_double( mlt_playlist_properties( this ), "first_fps", fps );
142 mlt_properties_set_double( mlt_playlist_properties( this ), "fps", fps );
143 mlt_properties_set_timecode( mlt_playlist_properties( this ), "length", playtime );
144 mlt_properties_set_timecode( mlt_playlist_properties( this ), "out", playtime );
149 /** Append to the virtual playlist.
152 static int mlt_playlist_virtual_append( mlt_playlist this, mlt_producer producer, mlt_timecode in, mlt_timecode out )
154 // Check that we have room
155 if ( this->count >= this->size )
158 this->list = realloc( this->list, ( this->size + 10 ) * sizeof( playlist_entry * ) );
159 for ( i = this->size; i < this->size + 10; i ++ )
160 this->list[ i ] = NULL;
164 this->list[ this->count ] = calloc( sizeof( playlist_entry ), 1 );
165 this->list[ this->count ]->producer = producer;
166 this->list[ this->count ]->in = in;
167 this->list[ this->count ]->playtime = out - in;
171 return mlt_playlist_virtual_refresh( this );
174 /** Seek in the virtual playlist.
177 static mlt_producer mlt_playlist_virtual_seek( mlt_playlist this )
179 // Default producer to blank
180 mlt_producer producer = &this->blank;
182 // Map playlist position to real producer in virtual playlist
183 mlt_timecode position = mlt_producer_position( &this->parent );
185 // Loop through the virtual playlist
188 for ( i = 0; i < this->count; i ++ )
190 if ( position < this->list[ i ]->playtime )
192 // Found it, now break
193 producer = this->list[ i ]->producer;
194 position += this->list[ i ]->in;
199 // Decrement position by length of this entry
200 position -= this->list[ i ]->playtime;
204 // Seek in real producer to relative position
205 mlt_producer_seek( producer, position );
210 static mlt_producer mlt_playlist_virtual_set_out( mlt_playlist this )
212 // Default producer to blank
213 mlt_producer producer = &this->blank;
215 // Map playlist position to real producer in virtual playlist
216 mlt_timecode position = mlt_producer_position( &this->parent );
218 // Loop through the virtual playlist
221 for ( i = 0; i < this->count; i ++ )
223 if ( position < this->list[ i ]->playtime )
225 // Found it, now break
226 producer = this->list[ i ]->producer;
227 position += this->list[ i ]->in;
232 // Decrement position by length of this entry
233 position -= this->list[ i ]->playtime;
237 // Seek in real producer to relative position
238 if ( i < this->count )
240 // Update the playtime for the changed clip (hmmm)
241 this->list[ i ]->playtime = position - this->list[ i ]->in;
243 // Refresh the playlist
244 mlt_playlist_virtual_refresh( this );
250 int mlt_playlist_current_clip( mlt_playlist this )
252 // Map playlist position to real producer in virtual playlist
253 mlt_timecode position = mlt_producer_position( &this->parent );
255 // Loop through the virtual playlist
258 for ( i = 0; i < this->count; i ++ )
260 if ( position < this->list[ i ]->playtime )
262 // Found it, now break
267 // Decrement position by length of this entry
268 position -= this->list[ i ]->playtime;
275 mlt_producer mlt_playlist_current( mlt_playlist this )
277 int i = mlt_playlist_current_clip( this );
278 if ( i < this->count )
279 return this->list[ i ]->producer;
284 /** Get the timecode which corresponds to the start of the next clip.
287 mlt_timecode mlt_playlist_clip( mlt_playlist this, mlt_whence whence, int index )
289 mlt_timecode position = 0;
290 int absolute_clip = index;
293 // Determine the absolute clip
296 case mlt_whence_relative_start:
297 absolute_clip = index;
300 case mlt_whence_relative_current:
301 absolute_clip = mlt_playlist_current_clip( this ) + index;
304 case mlt_whence_relative_end:
305 absolute_clip = this->count - index;
309 // Check that we're in a valid range
310 if ( absolute_clip < 0 )
312 else if ( absolute_clip > this->count )
313 absolute_clip = this->count;
315 // Now determine the timecode
316 for ( i = 0; i < absolute_clip; i ++ )
317 position += this->list[ i ]->playtime;
322 int mlt_playlist_get_clip_info( mlt_playlist this, mlt_playlist_clip_info *info, int index )
324 int error = index < 0 || index >= this->count;
327 mlt_producer producer = this->list[ index ]->producer;
328 mlt_properties properties = mlt_producer_properties( producer );
329 info->resource = mlt_properties_get( properties, "resource" );
330 info->in = this->list[ index ]->in;
331 info->out = this->list[ index ]->in + this->list[ index ]->playtime;
332 info->playtime = this->list[ index ]->playtime;
333 info->length = mlt_producer_get_length( producer );
334 info->fps = mlt_producer_get_fps( producer );
339 /** Get number of clips in the playlist.
342 int mlt_playlist_count( mlt_playlist this )
347 /** Clear the playlist.
350 int mlt_playlist_clear( mlt_playlist this )
353 return mlt_playlist_virtual_refresh( this );
356 /** Append a producer to the playlist.
359 int mlt_playlist_append( mlt_playlist this, mlt_producer producer )
361 // Append to virtual list
362 return mlt_playlist_virtual_append( this, producer, 0, mlt_producer_get_playtime( producer ) );
365 /** Append a producer to the playlist with in/out points.
368 int mlt_playlist_append_io( mlt_playlist this, mlt_producer producer, double in, double out )
370 // Append to virtual list
371 if ( in != -1 && out != -1 )
372 return mlt_playlist_virtual_append( this, producer, in, out - in );
374 return mlt_playlist_virtual_append( this, producer, 0, mlt_producer_get_playtime( producer ) );
377 /** Append a blank to the playlist of a given length.
380 int mlt_playlist_blank( mlt_playlist this, mlt_timecode length )
382 // Append to the virtual list
383 return mlt_playlist_virtual_append( this, &this->blank, 0, length );
386 /** Get the current frame.
389 static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index )
391 // Get this mlt_playlist
392 mlt_playlist this = producer->child;
394 // Get the real producer
395 mlt_producer real = mlt_playlist_virtual_seek( this );
398 mlt_service_get_frame( mlt_producer_service( real ), frame, index );
400 // Check if we're at the end of the clip
401 mlt_properties properties = mlt_frame_properties( *frame );
402 if ( mlt_properties_get_int( properties, "end_of_clip" ) )
403 mlt_playlist_virtual_set_out( this );
405 // Check for notifier and call with appropriate argument
406 mlt_properties playlist_properties = mlt_producer_properties( producer );
407 void ( *notifier )( void * ) = mlt_properties_get_data( playlist_properties, "notifier", NULL );
408 if ( notifier != NULL )
410 void *argument = mlt_properties_get_data( playlist_properties, "notifier_arg", NULL );
411 notifier( argument );
414 // Update timecode on the frame we're creating
415 mlt_frame_set_timecode( *frame, mlt_producer_position( producer ) );
417 // Position ourselves on the next frame
418 mlt_producer_prepare_next( producer );
423 /** Close the playlist.
426 void mlt_playlist_close( mlt_playlist this )
428 mlt_producer_close( &this->parent );
429 mlt_producer_close( &this->blank );