3 * \brief playlist service class
6 * Copyright (C) 2003-2009 Ushodaya Enterprises Limited
7 * \author Charles Yates <charles.yates@pandora.be>
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library 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 GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include "mlt_playlist.h"
25 #include "mlt_tractor.h"
26 #include "mlt_multitrack.h"
27 #include "mlt_field.h"
28 #include "mlt_frame.h"
29 #include "mlt_transition.h"
35 /** \brief Virtual playlist entry used by mlt_playlist_s
38 struct playlist_entry_s
40 mlt_producer producer;
41 mlt_position frame_in;
42 mlt_position frame_out;
43 mlt_position frame_count;
45 mlt_position producer_length;
47 int preservation_hack;
50 /* Forward declarations
53 static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index );
54 static int mlt_playlist_unmix( mlt_playlist self, int clip );
55 static int mlt_playlist_resize_mix( mlt_playlist self, int clip, int in, int out );
56 static void mlt_playlist_next( mlt_listener listener, mlt_properties owner, mlt_service self, void **args );
58 /** Construct a playlist.
60 * Sets the resource property to "<playlist>".
61 * Set the mlt_type to property to "mlt_producer".
62 * \public \memberof mlt_playlist_s
63 * \return a new playlist
66 mlt_playlist mlt_playlist_init( )
68 mlt_playlist self = calloc( 1, sizeof( struct mlt_playlist_s ) );
71 mlt_producer producer = &self->parent;
73 // Construct the producer
74 if ( mlt_producer_init( producer, self ) != 0 ) goto error1;
76 // Override the producer get_frame
77 producer->get_frame = producer_get_frame;
79 // Define the destructor
80 producer->close = ( mlt_destructor )mlt_playlist_close;
81 producer->close_object = self;
84 if ( mlt_producer_init( &self->blank, NULL ) != 0 ) goto error1;
85 mlt_properties_set( MLT_PRODUCER_PROPERTIES( &self->blank ), "mlt_service", "blank" );
86 mlt_properties_set( MLT_PRODUCER_PROPERTIES( &self->blank ), "resource", "blank" );
88 // Indicate that this producer is a playlist
89 mlt_properties_set_data( MLT_PLAYLIST_PROPERTIES( self ), "playlist", self, 0, NULL, NULL );
91 // Specify the eof condition
92 mlt_properties_set( MLT_PLAYLIST_PROPERTIES( self ), "eof", "pause" );
93 mlt_properties_set( MLT_PLAYLIST_PROPERTIES( self ), "resource", "<playlist>" );
94 mlt_properties_set( MLT_PLAYLIST_PROPERTIES( self ), "mlt_type", "mlt_producer" );
95 mlt_properties_set_position( MLT_PLAYLIST_PROPERTIES( self ), "in", 0 );
96 mlt_properties_set_position( MLT_PLAYLIST_PROPERTIES( self ), "out", -1 );
97 mlt_properties_set_position( MLT_PLAYLIST_PROPERTIES( self ), "length", 0 );
100 self->list = calloc( self->size, sizeof( playlist_entry * ) );
101 if ( self->list == NULL ) goto error2;
103 mlt_events_register( MLT_PLAYLIST_PROPERTIES( self ), "playlist-next", (mlt_transmitter) mlt_playlist_next );
114 /** Construct a playlist with a profile.
116 * Sets the resource property to "<playlist>".
117 * Set the mlt_type to property to "mlt_producer".
118 * \public \memberof mlt_playlist_s
119 * \param profile the profile to use with the profile
120 * \return a new playlist
123 mlt_playlist mlt_playlist_new( mlt_profile profile )
125 mlt_playlist self = mlt_playlist_init();
127 mlt_properties_set_data( MLT_PLAYLIST_PROPERTIES( self ), "_profile", profile, 0, NULL, NULL );
131 /** Get the producer associated to this playlist.
133 * \public \memberof mlt_playlist_s
134 * \param self a playlist
135 * \return the producer interface
136 * \see MLT_PLAYLIST_PRODUCER
139 mlt_producer mlt_playlist_producer( mlt_playlist self )
141 return self != NULL ? &self->parent : NULL;
144 /** Get the service associated to this playlist.
146 * \public \memberof mlt_playlist_s
147 * \param self a playlist
148 * \return the service interface
149 * \see MLT_PLAYLIST_SERVICE
152 mlt_service mlt_playlist_service( mlt_playlist self )
154 return MLT_PRODUCER_SERVICE( &self->parent );
157 /** Get the properties associated to this playlist.
159 * \public \memberof mlt_playlist_s
160 * \param self a playlist
161 * \return the playlist's properties list
162 * \see MLT_PLAYLIST_PROPERTIES
165 mlt_properties mlt_playlist_properties( mlt_playlist self )
167 return MLT_PRODUCER_PROPERTIES( &self->parent );
170 /** Refresh the playlist after a clip has been changed.
172 * \private \memberof mlt_playlist_s
173 * \param self a playlist
177 static int mlt_playlist_virtual_refresh( mlt_playlist self )
179 // Obtain the properties
180 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
182 mlt_position frame_count = 0;
184 for ( i = 0; i < self->count; i ++ )
187 mlt_producer producer = self->list[ i ]->producer;
190 int current_length = mlt_producer_get_playtime( producer );
192 // Check if the length of the producer has changed
193 if ( self->list[ i ]->frame_in != mlt_producer_get_in( producer ) ||
194 self->list[ i ]->frame_out != mlt_producer_get_out( producer ) )
196 // This clip should be removed...
197 if ( current_length < 1 )
199 self->list[ i ]->frame_in = 0;
200 self->list[ i ]->frame_out = -1;
201 self->list[ i ]->frame_count = 0;
205 self->list[ i ]->frame_in = mlt_producer_get_in( producer );
206 self->list[ i ]->frame_out = mlt_producer_get_out( producer );
207 self->list[ i ]->frame_count = current_length;
210 // Update the producer_length
211 self->list[ i ]->producer_length = current_length;
215 // Calculate the frame_count
216 self->list[ i ]->frame_count = ( self->list[ i ]->frame_out - self->list[ i ]->frame_in + 1 ) * self->list[ i ]->repeat;
218 // Update the frame_count for self clip
219 frame_count += self->list[ i ]->frame_count;
222 // Refresh all properties
223 mlt_events_block( properties, properties );
224 mlt_properties_set_position( properties, "length", frame_count );
225 mlt_events_unblock( properties, properties );
226 mlt_properties_set_position( properties, "out", frame_count - 1 );
231 /** Listener for producers on the playlist.
233 * Refreshes the playlist whenever an entry receives producer-changed.
234 * \private \memberof mlt_playlist_s
235 * \param producer a producer
236 * \param self a playlist
239 static void mlt_playlist_listener( mlt_producer producer, mlt_playlist self )
241 mlt_playlist_virtual_refresh( self );
244 /** Append to the virtual playlist.
246 * \private \memberof mlt_playlist_s
247 * \param self a playlist
248 * \param source a producer
249 * \param in the producer's starting time
250 * \param out the producer's ending time
251 * \return true if there was an error
254 static int mlt_playlist_virtual_append( mlt_playlist self, mlt_producer source, mlt_position in, mlt_position out )
256 mlt_producer producer = NULL;
257 mlt_properties properties = NULL;
258 mlt_properties parent = NULL;
260 // If we have a cut, then use the in/out points from the cut
261 if ( mlt_producer_is_blank( source ) )
263 mlt_position length = out - in + 1;
265 // Make sure the blank is long enough to accomodate the length specified
266 if ( length > mlt_producer_get_length( &self->blank ) )
268 mlt_properties blank_props = MLT_PRODUCER_PROPERTIES( &self->blank );
269 mlt_events_block( blank_props, blank_props );
270 mlt_producer_set_in_and_out( &self->blank, in, out );
271 mlt_events_unblock( blank_props, blank_props );
274 // Now make sure the cut comes from this self->blank
275 if ( source == NULL )
277 producer = mlt_producer_cut( &self->blank, in, out );
279 else if ( !mlt_producer_is_cut( source ) || mlt_producer_cut_parent( source ) != &self->blank )
281 producer = mlt_producer_cut( &self->blank, in, out );
286 mlt_properties_inc_ref( MLT_PRODUCER_PROPERTIES( producer ) );
289 properties = MLT_PRODUCER_PROPERTIES( producer );
291 // Make sure this cut of blank is long enough
292 if ( length > mlt_producer_get_length( producer ) )
293 mlt_properties_set_int( properties, "length", length );
295 else if ( mlt_producer_is_cut( source ) )
299 in = mlt_producer_get_in( producer );
300 if ( out < 0 || out > mlt_producer_get_out( producer ) )
301 out = mlt_producer_get_out( producer );
302 properties = MLT_PRODUCER_PROPERTIES( producer );
303 mlt_properties_inc_ref( properties );
307 producer = mlt_producer_cut( source, in, out );
308 if ( in < 0 || in < mlt_producer_get_in( producer ) )
309 in = mlt_producer_get_in( producer );
310 if ( out < 0 || out > mlt_producer_get_out( producer ) )
311 out = mlt_producer_get_out( producer );
312 properties = MLT_PRODUCER_PROPERTIES( producer );
315 // Fetch the cuts parent properties
316 parent = MLT_PRODUCER_PROPERTIES( mlt_producer_cut_parent( producer ) );
318 // Remove loader normalisers for fx cuts
319 if ( mlt_properties_get_int( parent, "meta.fx_cut" ) )
321 mlt_service service = MLT_PRODUCER_SERVICE( mlt_producer_cut_parent( producer ) );
322 mlt_filter filter = mlt_service_filter( service, 0 );
323 while ( filter != NULL && mlt_properties_get_int( MLT_FILTER_PROPERTIES( filter ), "_loader" ) )
325 mlt_service_detach( service, filter );
326 filter = mlt_service_filter( service, 0 );
328 mlt_properties_set_int( MLT_PRODUCER_PROPERTIES( producer ), "meta.fx_cut", 1 );
331 // Check that we have room
332 if ( self->count >= self->size )
335 self->list = realloc( self->list, ( self->size + 10 ) * sizeof( playlist_entry * ) );
336 for ( i = self->size; i < self->size + 10; i ++ ) self->list[ i ] = NULL;
341 self->list[ self->count ] = calloc( 1, sizeof( playlist_entry ) );
342 if ( self->list[ self->count ] != NULL )
344 self->list[ self->count ]->producer = producer;
345 self->list[ self->count ]->frame_in = in;
346 self->list[ self->count ]->frame_out = out;
347 self->list[ self->count ]->frame_count = out - in + 1;
348 self->list[ self->count ]->repeat = 1;
349 self->list[ self->count ]->producer_length = mlt_producer_get_playtime( producer );
350 self->list[ self->count ]->event = mlt_events_listen( parent, self, "producer-changed", ( mlt_listener )mlt_playlist_listener );
351 mlt_event_inc_ref( self->list[ self->count ]->event );
352 mlt_properties_set( properties, "eof", "pause" );
353 mlt_producer_set_speed( producer, 0 );
357 return mlt_playlist_virtual_refresh( self );
360 /** Locate a producer by index.
362 * \private \memberof mlt_playlist_s
363 * \param self a playlist
364 * \param[in, out] position the time at which to locate the producer, returns the time relative to the producer's starting point
365 * \param[out] clip the index of the playlist entry
366 * \param[out] total the duration of the playlist up to and including this producer
367 * \return a producer or NULL if not found
370 static mlt_producer mlt_playlist_locate( mlt_playlist self, mlt_position *position, int *clip, int *total )
372 // Default producer to NULL
373 mlt_producer producer = NULL;
375 // Loop for each producer until found
376 for ( *clip = 0; *clip < self->count; *clip += 1 )
378 // Increment the total
379 *total += self->list[ *clip ]->frame_count;
381 // Check if the position indicates that we have found the clip
382 // Note that 0 length clips get skipped automatically
383 if ( *position < self->list[ *clip ]->frame_count )
385 // Found it, now break
386 producer = self->list[ *clip ]->producer;
391 // Decrement position by length of self entry
392 *position -= self->list[ *clip ]->frame_count;
399 /** The transmitter for the producer-next event
401 * Invokes the listener.
403 * \private \memberof mlt_playlist_s
404 * \param listener a function pointer that will be invoked
405 * \param owner the events object that will be passed to \p listener
406 * \param self a service that will be passed to \p listener
407 * \param args an array of pointers.
410 static void mlt_playlist_next( mlt_listener listener, mlt_properties owner, mlt_service self, void **args )
413 listener( owner, self, args[ 0 ] );
417 /** Seek in the virtual playlist.
419 * This gets the producer at the current position and seeks on the producer
420 * while doing repeat and end-of-file handling. This is also responsible for
421 * closing producers previous to the preceding playlist if the autoclose
423 * \private \memberof mlt_playlist_s
424 * \param self a playlist
425 * \param[out] progressive true if the producer should be displayed progressively
426 * \return the service interface of the producer at the play head
427 * \see producer_get_frame
430 static mlt_service mlt_playlist_virtual_seek( mlt_playlist self, int *progressive )
432 // Map playlist position to real producer in virtual playlist
433 mlt_position position = mlt_producer_frame( &self->parent );
435 // Keep the original position since we change it while iterating through the list
436 mlt_position original = position;
438 // Clip index and total
442 // Locate the producer for the position
443 mlt_producer producer = mlt_playlist_locate( self, &position, &i, &total );
445 // Get the properties
446 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
448 // Automatically close previous producers if requested
449 if ( i > 1 // keep immediate previous in case app wants to get info about what just finished
450 && position < 2 // tolerate off-by-one error on going to next clip
451 && mlt_properties_get_int( properties, "autoclose" ) )
454 // They might have jumped ahead!
455 for ( j = 0; j < i - 1; j++ )
457 mlt_service_lock( MLT_PRODUCER_SERVICE( self->list[ j ]->producer ) );
458 mlt_producer p = self->list[ j ]->producer;
461 self->list[ j ]->producer = NULL;
462 mlt_service_unlock( MLT_PRODUCER_SERVICE( p ) );
463 mlt_producer_close( p );
465 // If p is null, the lock will not have been "taken"
469 // Get the eof handling
470 char *eof = mlt_properties_get( properties, "eof" );
472 // Seek in real producer to relative position
473 if ( producer != NULL )
475 int count = self->list[ i ]->frame_count / self->list[ i ]->repeat;
476 *progressive = count == 1;
477 mlt_producer_seek( producer, (int)position % count );
479 else if ( !strcmp( eof, "pause" ) && total > 0 )
481 playlist_entry *entry = self->list[ self->count - 1 ];
482 int count = entry->frame_count / entry->repeat;
483 mlt_producer self_producer = MLT_PLAYLIST_PRODUCER( self );
484 mlt_producer_seek( self_producer, original - 1 );
485 producer = entry->producer;
486 mlt_producer_seek( producer, (int)entry->frame_out % count );
487 mlt_producer_set_speed( self_producer, 0 );
488 mlt_producer_set_speed( producer, 0 );
489 *progressive = count == 1;
491 else if ( !strcmp( eof, "loop" ) && total > 0 )
493 playlist_entry *entry = self->list[ 0 ];
494 mlt_producer self_producer = MLT_PLAYLIST_PRODUCER( self );
495 mlt_producer_seek( self_producer, 0 );
496 producer = entry->producer;
497 mlt_producer_seek( producer, 0 );
501 producer = &self->blank;
504 // Determine if we have moved to the next entry in the playlist.
505 if ( original == total - 2 )
506 mlt_events_fire( properties, "playlist-next", i, NULL );
508 return MLT_PRODUCER_SERVICE( producer );
511 /** Invoked when a producer indicates that it has prematurely reached its end.
513 * \private \memberof mlt_playlist_s
514 * \param self a playlist
516 * \see producer_get_frame
519 static mlt_producer mlt_playlist_virtual_set_out( mlt_playlist self )
521 // Default producer to blank
522 mlt_producer producer = &self->blank;
524 // Map playlist position to real producer in virtual playlist
525 mlt_position position = mlt_producer_frame( &self->parent );
527 // Loop through the virtual playlist
530 for ( i = 0; i < self->count; i ++ )
532 if ( position < self->list[ i ]->frame_count )
534 // Found it, now break
535 producer = self->list[ i ]->producer;
540 // Decrement position by length of this entry
541 position -= self->list[ i ]->frame_count;
545 // Seek in real producer to relative position
546 if ( i < self->count && self->list[ i ]->frame_out != position )
548 // Update the frame_count for the changed clip (hmmm)
549 self->list[ i ]->frame_out = position;
550 self->list[ i ]->frame_count = self->list[ i ]->frame_out - self->list[ i ]->frame_in + 1;
552 // Refresh the playlist
553 mlt_playlist_virtual_refresh( self );
559 /** Obtain the current clips index.
561 * \public \memberof mlt_playlist_s
562 * \param self a playlist
563 * \return the index of the playlist entry at the current position
566 int mlt_playlist_current_clip( mlt_playlist self )
568 // Map playlist position to real producer in virtual playlist
569 mlt_position position = mlt_producer_frame( &self->parent );
571 // Loop through the virtual playlist
574 for ( i = 0; i < self->count; i ++ )
576 if ( position < self->list[ i ]->frame_count )
578 // Found it, now break
583 // Decrement position by length of this entry
584 position -= self->list[ i ]->frame_count;
591 /** Obtain the current clips producer.
593 * \public \memberof mlt_playlist_s
594 * \param self a playlist
595 * \return the producer at the current position
598 mlt_producer mlt_playlist_current( mlt_playlist self )
600 int i = mlt_playlist_current_clip( self );
601 if ( i < self->count )
602 return self->list[ i ]->producer;
607 /** Get the position which corresponds to the start of the next clip.
609 * \public \memberof mlt_playlist_s
610 * \param self a playlist
611 * \param whence the location from which to make the index relative:
612 * start of playlist, end of playlist, or current position
613 * \param index the playlist entry index relative to whence
614 * \return the time at which the referenced clip starts
617 mlt_position mlt_playlist_clip( mlt_playlist self, mlt_whence whence, int index )
619 mlt_position position = 0;
620 int absolute_clip = index;
623 // Determine the absolute clip
626 case mlt_whence_relative_start:
627 absolute_clip = index;
630 case mlt_whence_relative_current:
631 absolute_clip = mlt_playlist_current_clip( self ) + index;
634 case mlt_whence_relative_end:
635 absolute_clip = self->count - index;
639 // Check that we're in a valid range
640 if ( absolute_clip < 0 )
642 else if ( absolute_clip > self->count )
643 absolute_clip = self->count;
645 // Now determine the position
646 for ( i = 0; i < absolute_clip; i ++ )
647 position += self->list[ i ]->frame_count;
652 /** Get all the info about the clip specified.
654 * \public \memberof mlt_playlist_s
655 * \param self a playlist
656 * \param info a clip info struct
657 * \param index a playlist entry index
658 * \return true if there was an error
661 int mlt_playlist_get_clip_info( mlt_playlist self, mlt_playlist_clip_info *info, int index )
663 int error = index < 0 || index >= self->count || self->list[ index ]->producer == NULL;
664 memset( info, 0, sizeof( mlt_playlist_clip_info ) );
667 mlt_producer producer = mlt_producer_cut_parent( self->list[ index ]->producer );
668 mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
670 info->producer = producer;
671 info->cut = self->list[ index ]->producer;
672 info->start = mlt_playlist_clip( self, mlt_whence_relative_start, index );
673 info->resource = mlt_properties_get( properties, "resource" );
674 info->frame_in = self->list[ index ]->frame_in;
675 info->frame_out = self->list[ index ]->frame_out;
676 info->frame_count = self->list[ index ]->frame_count;
677 info->repeat = self->list[ index ]->repeat;
678 info->length = mlt_producer_get_length( producer );
679 info->fps = mlt_producer_get_fps( producer );
685 /** Get number of clips in the playlist.
687 * \public \memberof mlt_playlist_s
688 * \param self a playlist
689 * \return the number of playlist entries
692 int mlt_playlist_count( mlt_playlist self )
697 /** Clear the playlist.
699 * \public \memberof mlt_playlist_s
700 * \param self a playlist
701 * \return true if there was an error
704 int mlt_playlist_clear( mlt_playlist self )
707 for ( i = 0; i < self->count; i ++ )
709 mlt_event_close( self->list[ i ]->event );
710 mlt_producer_close( self->list[ i ]->producer );
713 return mlt_playlist_virtual_refresh( self );
716 /** Append a producer to the playlist.
718 * \public \memberof mlt_playlist_s
719 * \param self a playlist
720 * \param producer the producer to append
721 * \return true if there was an error
724 int mlt_playlist_append( mlt_playlist self, mlt_producer producer )
726 // Append to virtual list
727 return mlt_playlist_virtual_append( self, producer, 0, mlt_producer_get_playtime( producer ) - 1 );
730 /** Append a producer to the playlist with in/out points.
732 * \public \memberof mlt_playlist_s
733 * \param self a playlist
734 * \param producer the producer to append
735 * \param in the starting point on the producer; a negative value is the same as 0
736 * \param out the ending point on the producer; a negative value is the same as producer length - 1
737 * \return true if there was an error
740 int mlt_playlist_append_io( mlt_playlist self, mlt_producer producer, mlt_position in, mlt_position out )
742 // Append to virtual list
743 if ( in < 0 && out < 0 )
744 return mlt_playlist_append( self, producer );
746 return mlt_playlist_virtual_append( self, producer, in, out );
749 /** Append a blank to the playlist of a given length.
751 * \public \memberof mlt_playlist_s
752 * \param self a playlist
753 * \param out the ending time of the blank entry, not its duration
754 * \return true if there was an error
757 int mlt_playlist_blank( mlt_playlist self, mlt_position out )
759 // Append to the virtual list
761 return mlt_playlist_virtual_append( self, &self->blank, 0, out );
766 /** Append a blank item to the playlist with duration as a time string.
768 * \public \memberof mlt_playlist_s
769 * \param self a playlist
770 * \param length the duration of the blank entry as a time string
771 * \return true if there was an error
774 int mlt_playlist_blank_time( mlt_playlist self, const char* length )
776 if ( self && length )
778 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
779 mlt_properties_set( properties , "_blank_time", length );
780 mlt_position duration = mlt_properties_get_position( properties, "_blank_time" );
781 return mlt_playlist_blank( self, duration - 1 );
787 /** Insert a producer into the playlist.
789 * \public \memberof mlt_playlist_s
790 * \param self a playlist
791 * \param producer the producer to insert
792 * \param where the producer's playlist entry index
793 * \param in the starting point on the producer
794 * \param out the ending point on the producer
795 * \return true if there was an error
798 int mlt_playlist_insert( mlt_playlist self, mlt_producer producer, int where, mlt_position in, mlt_position out )
801 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
802 mlt_playlist_append_io( self, producer, in, out );
804 // Move to the position specified
805 mlt_playlist_move( self, self->count - 1, where );
806 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
808 return mlt_playlist_virtual_refresh( self );
811 /** Remove an entry in the playlist.
813 * \public \memberof mlt_playlist_s
814 * \param self a playlist
815 * \param where the playlist entry index
816 * \return true if there was an error
819 int mlt_playlist_remove( mlt_playlist self, int where )
821 int error = where < 0 || where >= self->count;
822 if ( error == 0 && mlt_playlist_unmix( self, where ) != 0 )
824 // We need to know the current clip and the position within the playlist
825 int current = mlt_playlist_current_clip( self );
826 mlt_position position = mlt_producer_position( MLT_PLAYLIST_PRODUCER( self ) );
828 // We need all the details about the clip we're removing
829 mlt_playlist_clip_info where_info;
830 playlist_entry *entry = self->list[ where ];
831 mlt_properties properties = MLT_PRODUCER_PROPERTIES( entry->producer );
837 mlt_playlist_get_clip_info( self, &where_info, where );
839 // Reorganise the list
840 for ( i = where + 1; i < self->count; i ++ )
841 self->list[ i - 1 ] = self->list[ i ];
844 if ( entry->preservation_hack == 0 )
846 // Decouple from mix_in/out if necessary
847 if ( mlt_properties_get_data( properties, "mix_in", NULL ) != NULL )
849 mlt_properties mix = mlt_properties_get_data( properties, "mix_in", NULL );
850 mlt_properties_set_data( mix, "mix_out", NULL, 0, NULL, NULL );
852 if ( mlt_properties_get_data( properties, "mix_out", NULL ) != NULL )
854 mlt_properties mix = mlt_properties_get_data( properties, "mix_out", NULL );
855 mlt_properties_set_data( mix, "mix_in", NULL, 0, NULL, NULL );
858 if ( mlt_properties_ref_count( MLT_PRODUCER_PROPERTIES( entry->producer ) ) == 1 )
859 mlt_producer_clear( entry->producer );
862 // Close the producer associated to the clip info
863 mlt_event_close( entry->event );
864 mlt_producer_close( entry->producer );
867 if ( where == current )
868 mlt_producer_seek( MLT_PLAYLIST_PRODUCER( self ), where_info.start );
869 else if ( where < current && self->count > 0 )
870 mlt_producer_seek( MLT_PLAYLIST_PRODUCER( self ), position - where_info.frame_count );
871 else if ( self->count == 0 )
872 mlt_producer_seek( MLT_PLAYLIST_PRODUCER( self ), 0 );
877 // Refresh the playlist
878 mlt_playlist_virtual_refresh( self );
884 /** Move an entry in the playlist.
886 * \public \memberof mlt_playlist_s
887 * \param self a playlist
888 * \param src an entry index
889 * \param dest an entry index
893 int mlt_playlist_move( mlt_playlist self, int src, int dest )
897 /* We need to ensure that the requested indexes are valid and correct it as necessary */
900 if ( src >= self->count )
901 src = self->count - 1;
905 if ( dest >= self->count )
906 dest = self->count - 1;
908 if ( src != dest && self->count > 1 )
910 int current = mlt_playlist_current_clip( self );
911 mlt_position position = mlt_producer_position( MLT_PLAYLIST_PRODUCER( self ) );
912 playlist_entry *src_entry = NULL;
914 // We need all the details about the current clip
915 mlt_playlist_clip_info current_info;
917 mlt_playlist_get_clip_info( self, ¤t_info, current );
918 position -= current_info.start;
920 if ( current == src )
922 else if ( current > src && current < dest )
924 else if ( current == dest )
927 src_entry = self->list[ src ];
930 for ( i = src; i > dest; i -- )
931 self->list[ i ] = self->list[ i - 1 ];
935 for ( i = src; i < dest; i ++ )
936 self->list[ i ] = self->list[ i + 1 ];
938 self->list[ dest ] = src_entry;
940 mlt_playlist_get_clip_info( self, ¤t_info, current );
941 mlt_producer_seek( MLT_PLAYLIST_PRODUCER( self ), current_info.start + position );
942 mlt_playlist_virtual_refresh( self );
948 /** Repeat the specified clip n times.
950 * \public \memberof mlt_playlist_s
951 * \param self a playlist
952 * \param clip a playlist entry index
953 * \param repeat the number of times to repeat the clip
954 * \return true if there was an error
957 int mlt_playlist_repeat_clip( mlt_playlist self, int clip, int repeat )
959 int error = repeat < 1 || clip < 0 || clip >= self->count;
962 playlist_entry *entry = self->list[ clip ];
963 entry->repeat = repeat;
964 mlt_playlist_virtual_refresh( self );
969 /** Resize the specified clip.
971 * \public \memberof mlt_playlist_s
972 * \param self a playlist
973 * \param clip the index of the playlist entry
974 * \param in the new starting time on the clip's producer; a negative value is the same as 0
975 * \param out the new ending time on the clip's producer; a negative value is the same as length - 1
976 * \return true if there was an error
979 int mlt_playlist_resize_clip( mlt_playlist self, int clip, mlt_position in, mlt_position out )
981 int error = clip < 0 || clip >= self->count;
982 if ( error == 0 && mlt_playlist_resize_mix( self, clip, in, out ) != 0 )
984 playlist_entry *entry = self->list[ clip ];
985 mlt_producer producer = entry->producer;
986 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
988 mlt_events_block( properties, properties );
990 if ( mlt_producer_is_blank( producer ) )
992 mlt_position length = out - in + 1;
994 // Make sure the parent blank is long enough to accomodate the length specified
995 if ( length > mlt_producer_get_length( &self->blank ) )
997 mlt_properties blank_props = MLT_PRODUCER_PROPERTIES( &self->blank );
998 mlt_properties_set_int( blank_props, "length", length );
999 mlt_producer_set_in_and_out( &self->blank, 0, out - in );
1001 // Make sure this cut of blank is long enough
1002 if ( length > mlt_producer_get_length( producer ) )
1003 mlt_properties_set_int( MLT_PRODUCER_PROPERTIES( producer ), "length", length );
1008 if ( out < 0 || out >= mlt_producer_get_length( producer ) )
1009 out = mlt_producer_get_length( producer ) - 1;
1013 mlt_position t = in;
1018 mlt_producer_set_in_and_out( producer, in, out );
1019 mlt_events_unblock( properties, properties );
1020 mlt_playlist_virtual_refresh( self );
1025 /** Split a clip on the playlist at the given position.
1027 * This splits after the specified frame.
1028 * \public \memberof mlt_playlist_s
1029 * \param self a playlist
1030 * \param clip the index of the playlist entry
1031 * \param position the time at which to split relative to the beginning of the clip or its end if negative
1032 * \return true if there was an error
1035 int mlt_playlist_split( mlt_playlist self, int clip, mlt_position position )
1037 int error = clip < 0 || clip >= self->count;
1040 playlist_entry *entry = self->list[ clip ];
1041 position = position < 0 ? entry->frame_count + position - 1 : position;
1042 if ( position >= 0 && position < entry->frame_count - 1 )
1044 int in = entry->frame_in;
1045 int out = entry->frame_out;
1046 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1047 mlt_playlist_resize_clip( self, clip, in, in + position );
1048 if ( !mlt_producer_is_blank( entry->producer ) )
1051 mlt_properties entry_properties = MLT_PRODUCER_PROPERTIES( entry->producer );
1052 mlt_producer split = mlt_producer_cut( entry->producer, in + position + 1, out );
1053 mlt_properties split_properties = MLT_PRODUCER_PROPERTIES( split );
1054 mlt_playlist_insert( self, split, clip + 1, 0, -1 );
1055 mlt_properties_lock( entry_properties );
1056 for ( i = 0; i < mlt_properties_count( entry_properties ); i ++ )
1058 char *name = mlt_properties_get_name( entry_properties, i );
1059 if ( name != NULL && !strncmp( name, "meta.", 5 ) )
1060 mlt_properties_set( split_properties, name, mlt_properties_get_value( entry_properties, i ) );
1062 mlt_properties_unlock( entry_properties );
1063 mlt_producer_close( split );
1067 mlt_playlist_insert( self, &self->blank, clip + 1, 0, out - position - 1 );
1069 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1070 mlt_playlist_virtual_refresh( self );
1080 /** Split the playlist at the absolute position.
1082 * \public \memberof mlt_playlist_s
1083 * \param self a playlist
1084 * \param position the time at which to split relative to the beginning of the clip
1085 * \param left true to split before the frame starting at position
1086 * \return true if there was an error
1089 int mlt_playlist_split_at( mlt_playlist self, mlt_position position, int left )
1091 int result = self == NULL ? -1 : 0;
1094 if ( position >= 0 && position < mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( self ) ) )
1096 int clip = mlt_playlist_get_clip_index_at( self, position );
1097 mlt_playlist_clip_info info;
1098 mlt_playlist_get_clip_info( self, &info, clip );
1099 if ( left && position != info.start )
1100 mlt_playlist_split( self, clip, position - info.start - 1 );
1102 mlt_playlist_split( self, clip, position - info.start );
1105 else if ( position <= 0 )
1111 result = mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( self ) );
1117 /** Join 1 or more consecutive clips.
1119 * \public \memberof mlt_playlist_s
1120 * \param self a playlist
1121 * \param clip the starting playlist entry index
1122 * \param count the number of entries to merge
1123 * \param merge ignored
1124 * \return true if there was an error
1127 int mlt_playlist_join( mlt_playlist self, int clip, int count, int merge )
1129 int error = clip < 0 || clip >= self->count;
1133 mlt_playlist new_clip = mlt_playlist_new( mlt_service_profile( MLT_PLAYLIST_SERVICE(self) ) );
1134 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1135 if ( clip + count >= self->count )
1136 count = self->count - clip - 1;
1137 for ( i = 0; i <= count; i ++ )
1139 playlist_entry *entry = self->list[ clip ];
1140 mlt_playlist_append( new_clip, entry->producer );
1141 mlt_playlist_repeat_clip( new_clip, i, entry->repeat );
1142 entry->preservation_hack = 1;
1143 mlt_playlist_remove( self, clip );
1145 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1146 mlt_playlist_insert( self, MLT_PLAYLIST_PRODUCER( new_clip ), clip, 0, -1 );
1147 mlt_playlist_close( new_clip );
1152 /** Mix consecutive clips for a specified length and apply transition if specified.
1154 * This version of the mix function does not utilize any frames beyond the out of
1155 * clip A or before the in point of clip B. It takes the frames needed for the length
1156 * of the transition by adjusting the duration of both clips - the out point for clip A
1157 * and the in point for clip B.
1158 * \public \memberof mlt_playlist_s
1159 * \param self a playlist
1160 * \param clip the index of the playlist entry
1161 * \param length the number of frames over which to create the mix
1162 * \param transition the transition to use for the mix
1163 * \return true if there was an error
1166 int mlt_playlist_mix( mlt_playlist self, int clip, int length, mlt_transition transition )
1168 int error = ( clip < 0 || clip + 1 >= self->count );
1171 playlist_entry *clip_a = self->list[ clip ];
1172 playlist_entry *clip_b = self->list[ clip + 1 ];
1173 mlt_producer track_a = NULL;
1174 mlt_producer track_b = NULL;
1175 mlt_tractor tractor = mlt_tractor_new( );
1177 mlt_service_set_profile( MLT_TRACTOR_SERVICE( tractor ),
1178 mlt_service_profile( MLT_PLAYLIST_SERVICE( self ) ) );
1179 mlt_properties_set_lcnumeric( MLT_TRACTOR_PROPERTIES( tractor ),
1180 mlt_properties_get_lcnumeric( MLT_PLAYLIST_PROPERTIES( self ) ) );
1181 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1183 // Check length is valid for both clips and resize if necessary.
1184 int max_size = clip_a->frame_count > clip_b->frame_count ? clip_a->frame_count : clip_b->frame_count;
1185 length = length > max_size ? max_size : length;
1187 // Create the a and b tracks/cuts if necessary - note that no cuts are required if the length matches
1188 if ( length != clip_a->frame_count )
1189 track_a = mlt_producer_cut( clip_a->producer, clip_a->frame_out - length + 1, clip_a->frame_out );
1191 track_a = clip_a->producer;
1193 if ( length != clip_b->frame_count )
1194 track_b = mlt_producer_cut( clip_b->producer, clip_b->frame_in, clip_b->frame_in + length - 1 );
1196 track_b = clip_b->producer;
1198 // Set the tracks on the tractor
1199 mlt_tractor_set_track( tractor, track_a, 0 );
1200 mlt_tractor_set_track( tractor, track_b, 1 );
1202 // Insert the mix object into the playlist
1203 mlt_playlist_insert( self, MLT_TRACTOR_PRODUCER( tractor ), clip + 1, -1, -1 );
1204 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mlt_mix", tractor, 0, NULL, NULL );
1206 // Attach the transition
1207 if ( transition != NULL )
1209 mlt_field field = mlt_tractor_field( tractor );
1210 mlt_field_plant_transition( field, transition, 0, 1 );
1211 mlt_transition_set_in_and_out( transition, 0, length - 1 );
1214 // Close our references to the tracks if we created new cuts above (the tracks can still be used here)
1215 if ( track_a != clip_a->producer )
1216 mlt_producer_close( track_a );
1217 if ( track_b != clip_b->producer )
1218 mlt_producer_close( track_b );
1220 // Check if we have anything left on the right hand clip
1221 if ( track_b == clip_b->producer )
1223 clip_b->preservation_hack = 1;
1224 mlt_playlist_remove( self, clip + 2 );
1226 else if ( clip_b->frame_out - clip_b->frame_in > length )
1228 mlt_playlist_resize_clip( self, clip + 2, clip_b->frame_in + length, clip_b->frame_out );
1229 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_b->producer ), "mix_in", tractor, 0, NULL, NULL );
1230 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_out", clip_b->producer, 0, NULL, NULL );
1234 mlt_producer_clear( clip_b->producer );
1235 mlt_playlist_remove( self, clip + 2 );
1238 // Check if we have anything left on the left hand clip
1239 if ( track_a == clip_a->producer )
1241 clip_a->preservation_hack = 1;
1242 mlt_playlist_remove( self, clip );
1244 else if ( clip_a->frame_out - clip_a->frame_in > length )
1246 mlt_playlist_resize_clip( self, clip, clip_a->frame_in, clip_a->frame_out - length );
1247 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_a->producer ), "mix_out", tractor, 0, NULL, NULL );
1248 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_in", clip_a->producer, 0, NULL, NULL );
1252 mlt_producer_clear( clip_a->producer );
1253 mlt_playlist_remove( self, clip );
1256 // Unblock and force a fire off of change events to listeners
1257 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1258 mlt_playlist_virtual_refresh( self );
1259 mlt_tractor_close( tractor );
1264 /** Mix consecutive clips for a specified length.
1266 * This version of the mix function maintains the out point of the clip A by occupying the
1267 * beginning of clip B before its current in point. Therefore, it ends up adjusting the in
1268 * point and duration of clip B without affecting the duration of clip A.
1269 * Also, therefore, there must be enough frames after the out point of clip A.
1270 * \public \memberof mlt_playlist_s
1271 * \param self a playlist
1272 * \param clip the index of the playlist entry
1273 * \param length the number of frames over which to create the mix
1274 * \return true if there was an error
1277 int mlt_playlist_mix_in( mlt_playlist self, int clip, int length )
1279 int error = ( clip < 0 || clip + 1 >= self->count );
1282 playlist_entry *clip_a = self->list[ clip ];
1283 playlist_entry *clip_b = self->list[ clip + 1 ];
1284 mlt_producer track_a = NULL;
1285 mlt_producer track_b = NULL;
1286 mlt_tractor tractor = mlt_tractor_new( );
1288 mlt_service_set_profile( MLT_TRACTOR_SERVICE( tractor ),
1289 mlt_service_profile( MLT_PLAYLIST_SERVICE( self ) ) );
1290 mlt_properties_set_lcnumeric( MLT_TRACTOR_PROPERTIES( tractor ),
1291 mlt_properties_get_lcnumeric( MLT_PLAYLIST_PROPERTIES( self ) ) );
1292 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1294 // Check length is valid for both clips and resize if necessary.
1295 int max_size = ( clip_a->frame_out + 1 ) > clip_b->frame_count ? ( clip_a->frame_out + 1 ) : clip_b->frame_count;
1296 length = length > max_size ? max_size : length;
1298 // Create the a and b tracks/cuts if necessary - note that no cuts are required if the length matches
1299 if ( length != clip_a->frame_out + 1 )
1300 track_a = mlt_producer_cut( clip_a->producer, clip_a->frame_out + 1, clip_a->frame_out + length );
1302 track_a = clip_a->producer;
1304 if ( length != clip_b->frame_count )
1305 track_b = mlt_producer_cut( clip_b->producer, clip_b->frame_in, clip_b->frame_in + length - 1 );
1307 track_b = clip_b->producer;
1309 // Set the tracks on the tractor
1310 mlt_tractor_set_track( tractor, track_a, 0 );
1311 mlt_tractor_set_track( tractor, track_b, 1 );
1313 // Insert the mix object into the playlist
1314 mlt_playlist_insert( self, MLT_TRACTOR_PRODUCER( tractor ), clip + 1, -1, -1 );
1315 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mlt_mix", tractor, 0, NULL, NULL );
1317 // Close our references to the tracks if we created new cuts above (the tracks can still be used here)
1318 if ( track_a != clip_a->producer )
1319 mlt_producer_close( track_a );
1320 if ( track_b != clip_b->producer )
1321 mlt_producer_close( track_b );
1323 // Check if we have anything left on the right hand clip
1324 if ( track_b == clip_b->producer )
1326 clip_b->preservation_hack = 1;
1327 mlt_playlist_remove( self, clip + 2 );
1329 else if ( clip_b->frame_out - clip_b->frame_in >= length )
1331 mlt_playlist_resize_clip( self, clip + 2, clip_b->frame_in + length, clip_b->frame_out );
1332 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_b->producer ), "mix_in", tractor, 0, NULL, NULL );
1333 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_out", clip_b->producer, 0, NULL, NULL );
1337 mlt_producer_clear( clip_b->producer );
1338 mlt_playlist_remove( self, clip + 2 );
1341 // Check if we have anything left on the left hand clip
1342 if ( track_a == clip_a->producer )
1344 clip_a->preservation_hack = 1;
1345 mlt_playlist_remove( self, clip );
1347 else if ( clip_a->frame_out - clip_a->frame_in > 0 )
1349 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_a->producer ), "mix_out", tractor, 0, NULL, NULL );
1350 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_in", clip_a->producer, 0, NULL, NULL );
1354 mlt_producer_clear( clip_a->producer );
1355 mlt_playlist_remove( self, clip );
1358 // Unblock and force a fire off of change events to listeners
1359 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1360 mlt_playlist_virtual_refresh( self );
1361 mlt_tractor_close( tractor );
1366 /** Mix consecutive clips for a specified length.
1368 * This version of the mix function maintains the in point of the B clip by occupying the
1369 * end of clip A before its current out point. Therefore, it ends up adjusting the out
1370 * point and duration of clip A without affecting the duration or starting frame of clip B.
1371 * Also, therefore, there must be enough frames before the in point of clip B.
1372 * \public \memberof mlt_playlist_s
1373 * \param self a playlist
1374 * \param clip the index of the playlist entry
1375 * \param length the number of frames over which to create the mix
1376 * \return true if there was an error
1379 int mlt_playlist_mix_out( mlt_playlist self, int clip, int length )
1381 int error = ( clip < 0 || clip + 1 >= self->count );
1384 playlist_entry *clip_a = self->list[ clip ];
1385 playlist_entry *clip_b = self->list[ clip + 1 ];
1386 mlt_producer track_a = NULL;
1387 mlt_producer track_b = NULL;
1388 mlt_tractor tractor = mlt_tractor_new( );
1390 mlt_service_set_profile( MLT_TRACTOR_SERVICE( tractor ),
1391 mlt_service_profile( MLT_PLAYLIST_SERVICE( self ) ) );
1392 mlt_properties_set_lcnumeric( MLT_TRACTOR_PROPERTIES( tractor ),
1393 mlt_properties_get_lcnumeric( MLT_PLAYLIST_PROPERTIES( self ) ) );
1394 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1396 // Check length is valid for both clips and resize if necessary.
1397 int max_size = clip_a->frame_count > clip_b->frame_in ? clip_a->frame_count : clip_b->frame_in;
1398 length = length > max_size ? max_size : length;
1400 // Create the a and b tracks/cuts if necessary - note that no cuts are required if the length matches
1401 if ( length != clip_a->frame_count )
1402 track_a = mlt_producer_cut( clip_a->producer, clip_a->frame_out - length + 1, clip_a->frame_out );
1404 track_a = clip_a->producer;
1406 if ( length != clip_b->frame_in )
1407 track_b = mlt_producer_cut( clip_b->producer, clip_b->frame_in - length + 1, clip_b->frame_in );
1409 track_b = clip_b->producer;
1411 // Set the tracks on the tractor
1412 mlt_tractor_set_track( tractor, track_a, 0 );
1413 mlt_tractor_set_track( tractor, track_b, 1 );
1415 // Insert the mix object into the playlist
1416 mlt_playlist_insert( self, MLT_TRACTOR_PRODUCER( tractor ), clip + 1, -1, -1 );
1417 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mlt_mix", tractor, 0, NULL, NULL );
1419 // Close our references to the tracks if we created new cuts above (the tracks can still be used here)
1420 if ( track_a != clip_a->producer )
1421 mlt_producer_close( track_a );
1422 if ( track_b != clip_b->producer )
1423 mlt_producer_close( track_b );
1425 // Check if we have anything left on the right hand clip
1426 if ( track_b == clip_b->producer )
1428 clip_b->preservation_hack = 1;
1429 mlt_playlist_remove( self, clip + 2 );
1431 else if ( clip_b->frame_out - clip_b->frame_in > 0 )
1433 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_b->producer ), "mix_in", tractor, 0, NULL, NULL );
1434 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_out", clip_b->producer, 0, NULL, NULL );
1438 mlt_producer_clear( clip_b->producer );
1439 mlt_playlist_remove( self, clip + 2 );
1442 // Check if we have anything left on the left hand clip
1443 if ( track_a == clip_a->producer )
1445 clip_a->preservation_hack = 1;
1446 mlt_playlist_remove( self, clip );
1448 else if ( clip_a->frame_out - clip_a->frame_in >= length )
1450 mlt_playlist_resize_clip( self, clip, clip_a->frame_in, clip_a->frame_out - length );
1451 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_a->producer ), "mix_out", tractor, 0, NULL, NULL );
1452 mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_in", clip_a->producer, 0, NULL, NULL );
1456 mlt_producer_clear( clip_a->producer );
1457 mlt_playlist_remove( self, clip );
1460 // Unblock and force a fire off of change events to listeners
1461 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1462 mlt_playlist_virtual_refresh( self );
1463 mlt_tractor_close( tractor );
1468 /** Add a transition to an existing mix.
1470 * \public \memberof mlt_playlist_s
1471 * \param self a playlist
1472 * \param clip the index of the playlist entry
1473 * \param transition a transition
1474 * \return true if there was an error
1477 int mlt_playlist_mix_add( mlt_playlist self, int clip, mlt_transition transition )
1479 mlt_producer producer = mlt_producer_cut_parent( mlt_playlist_get_clip( self, clip ) );
1480 mlt_properties properties = producer != NULL ? MLT_PRODUCER_PROPERTIES( producer ) : NULL;
1481 mlt_tractor tractor = properties != NULL ? mlt_properties_get_data( properties, "mlt_mix", NULL ) : NULL;
1482 int error = transition == NULL || tractor == NULL;
1485 mlt_field field = mlt_tractor_field( tractor );
1486 mlt_field_plant_transition( field, transition, 0, 1 );
1487 mlt_transition_set_in_and_out( transition, 0, self->list[ clip ]->frame_count - 1 );
1492 /** Return the clip at the clip index.
1494 * \public \memberof mlt_playlist_s
1495 * \param self a playlist
1496 * \param clip the index of a playlist entry
1497 * \return a producer or NULL if there was an error
1500 mlt_producer mlt_playlist_get_clip( mlt_playlist self, int clip )
1502 if ( clip >= 0 && clip < self->count )
1503 return self->list[ clip ]->producer;
1507 /** Return the clip at the specified position.
1509 * \public \memberof mlt_playlist_s
1510 * \param self a playlist
1511 * \param position a time relative to the beginning of the playlist
1512 * \return a producer or NULL if not found
1515 mlt_producer mlt_playlist_get_clip_at( mlt_playlist self, mlt_position position )
1517 int index = 0, total = 0;
1518 return mlt_playlist_locate( self, &position, &index, &total );
1521 /** Return the clip index of the specified position.
1523 * \public \memberof mlt_playlist_s
1524 * \param self a playlist
1525 * \param position a time relative to the beginning of the playlist
1526 * \return the index of the playlist entry
1529 int mlt_playlist_get_clip_index_at( mlt_playlist self, mlt_position position )
1531 int index = 0, total = 0;
1532 mlt_playlist_locate( self, &position, &index, &total );
1536 /** Determine if the clip is a mix.
1538 * \public \memberof mlt_playlist_s
1539 * \param self a playlist
1540 * \param clip the index of the playlist entry
1541 * \return true if the producer is a mix
1544 int mlt_playlist_clip_is_mix( mlt_playlist self, int clip )
1546 mlt_producer producer = mlt_producer_cut_parent( mlt_playlist_get_clip( self, clip ) );
1547 mlt_properties properties = producer != NULL ? MLT_PRODUCER_PROPERTIES( producer ) : NULL;
1548 mlt_tractor tractor = properties != NULL ? mlt_properties_get_data( properties, "mlt_mix", NULL ) : NULL;
1549 return tractor != NULL;
1552 /** Remove a mixed clip - ensure that the cuts included in the mix find their way
1553 * back correctly on to the playlist.
1555 * \private \memberof mlt_playlist_s
1556 * \param self a playlist
1557 * \param clip the index of the playlist entry
1558 * \return true if there was an error
1561 static int mlt_playlist_unmix( mlt_playlist self, int clip )
1563 int error = ( clip < 0 || clip >= self->count );
1565 // Ensure that the clip request is actually a mix
1568 mlt_producer producer = mlt_producer_cut_parent( self->list[ clip ]->producer );
1569 mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
1570 error = mlt_properties_get_data( properties, "mlt_mix", NULL ) == NULL ||
1571 self->list[ clip ]->preservation_hack;
1576 playlist_entry *mix = self->list[ clip ];
1577 mlt_tractor tractor = ( mlt_tractor )mlt_producer_cut_parent( mix->producer );
1578 mlt_properties properties = MLT_TRACTOR_PROPERTIES( tractor );
1579 mlt_producer clip_a = mlt_properties_get_data( properties, "mix_in", NULL );
1580 mlt_producer clip_b = mlt_properties_get_data( properties, "mix_out", NULL );
1581 int length = mlt_producer_get_playtime( MLT_TRACTOR_PRODUCER( tractor ) );
1582 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1584 if ( clip_a != NULL )
1586 mlt_producer_set_in_and_out( clip_a, mlt_producer_get_in( clip_a ), mlt_producer_get_out( clip_a ) + length );
1590 mlt_producer cut = mlt_tractor_get_track( tractor, 0 );
1591 mlt_playlist_insert( self, cut, clip, -1, -1 );
1595 if ( clip_b != NULL )
1597 mlt_producer_set_in_and_out( clip_b, mlt_producer_get_in( clip_b ) - length, mlt_producer_get_out( clip_b ) );
1601 mlt_producer cut = mlt_tractor_get_track( tractor, 1 );
1602 mlt_playlist_insert( self, cut, clip + 1, -1, -1 );
1605 mlt_properties_set_data( properties, "mlt_mix", NULL, 0, NULL, NULL );
1606 mlt_playlist_remove( self, clip );
1607 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1608 mlt_playlist_virtual_refresh( self );
1613 /** Resize a mix clip.
1615 * \private \memberof mlt_playlist_s
1616 * \param self a playlist
1617 * \param clip the index of the playlist entry
1618 * \param in the new starting point
1619 * \param out the new ending point
1620 * \return true if there was an error
1623 static int mlt_playlist_resize_mix( mlt_playlist self, int clip, int in, int out )
1625 int error = ( clip < 0 || clip >= self->count );
1627 // Ensure that the clip request is actually a mix
1630 mlt_producer producer = mlt_producer_cut_parent( self->list[ clip ]->producer );
1631 mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
1632 error = mlt_properties_get_data( properties, "mlt_mix", NULL ) == NULL;
1637 playlist_entry *mix = self->list[ clip ];
1638 mlt_tractor tractor = ( mlt_tractor )mlt_producer_cut_parent( mix->producer );
1639 mlt_properties properties = MLT_TRACTOR_PROPERTIES( tractor );
1640 mlt_producer clip_a = mlt_properties_get_data( properties, "mix_in", NULL );
1641 mlt_producer clip_b = mlt_properties_get_data( properties, "mix_out", NULL );
1642 mlt_producer track_a = mlt_tractor_get_track( tractor, 0 );
1643 mlt_producer track_b = mlt_tractor_get_track( tractor, 1 );
1644 int length = out - in + 1;
1645 int length_diff = length - mlt_producer_get_playtime( MLT_TRACTOR_PRODUCER( tractor ) );
1646 mlt_events_block( MLT_PLAYLIST_PROPERTIES( self ), self );
1648 if ( clip_a != NULL )
1649 mlt_producer_set_in_and_out( clip_a, mlt_producer_get_in( clip_a ), mlt_producer_get_out( clip_a ) - length_diff );
1651 if ( clip_b != NULL )
1652 mlt_producer_set_in_and_out( clip_b, mlt_producer_get_in( clip_b ) + length_diff, mlt_producer_get_out( clip_b ) );
1654 mlt_producer_set_in_and_out( track_a, mlt_producer_get_in( track_a ) - length_diff, mlt_producer_get_out( track_a ) );
1655 mlt_producer_set_in_and_out( track_b, mlt_producer_get_in( track_b ), mlt_producer_get_out( track_b ) + length_diff );
1656 mlt_producer_set_in_and_out( MLT_MULTITRACK_PRODUCER( mlt_tractor_multitrack( tractor ) ), in, out );
1657 mlt_producer_set_in_and_out( MLT_TRACTOR_PRODUCER( tractor ), in, out );
1658 mlt_properties_set_position( MLT_PRODUCER_PROPERTIES( mix->producer ), "length", out - in + 1 );
1659 mlt_producer_set_in_and_out( mix->producer, in, out );
1661 mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( self ), self );
1662 mlt_playlist_virtual_refresh( self );
1667 /** Consolidate adjacent blank producers.
1669 * \public \memberof mlt_playlist_s
1670 * \param self a playlist
1671 * \param keep_length set false to remove the last entry if it is blank
1674 void mlt_playlist_consolidate_blanks( mlt_playlist self, int keep_length )
1679 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
1681 mlt_events_block( properties, properties );
1682 for ( i = 1; i < self->count; i ++ )
1684 playlist_entry *left = self->list[ i - 1 ];
1685 playlist_entry *right = self->list[ i ];
1687 if ( mlt_producer_is_blank( left->producer ) && mlt_producer_is_blank( right->producer ) )
1689 mlt_playlist_resize_clip( self, i - 1, 0, left->frame_count + right->frame_count - 1 );
1690 mlt_playlist_remove( self, i -- );
1694 if ( !keep_length && self->count > 0 )
1696 playlist_entry *last = self->list[ self->count - 1 ];
1697 if ( mlt_producer_is_blank( last->producer ) )
1698 mlt_playlist_remove( self, self->count - 1 );
1701 mlt_events_unblock( properties, properties );
1702 mlt_playlist_virtual_refresh( self );
1706 /** Determine if the specified clip index is a blank.
1708 * \public \memberof mlt_playlist_s
1709 * \param self a playlist
1710 * \param clip the index of the playlist entry
1711 * \return true if \p clip is a "blank" producer
1714 int mlt_playlist_is_blank( mlt_playlist self, int clip )
1716 return self == NULL || mlt_producer_is_blank( mlt_playlist_get_clip( self, clip ) );
1719 /** Determine if the specified position is a blank.
1721 * \public \memberof mlt_playlist_s
1722 * \param self a playlist
1723 * \param position a time relative to the start or end (negative) of the playlist
1724 * \return true if there was an error
1727 int mlt_playlist_is_blank_at( mlt_playlist self, mlt_position position )
1729 return self == NULL || mlt_producer_is_blank( mlt_playlist_get_clip_at( self, position ) );
1732 /** Replace the specified clip with a blank and return the clip.
1734 * \public \memberof mlt_playlist_s
1735 * \param self a playlist
1736 * \param clip the index of the playlist entry
1737 * \return a producer or NULL if there was an error
1740 mlt_producer mlt_playlist_replace_with_blank( mlt_playlist self, int clip )
1742 mlt_producer producer = NULL;
1743 if ( !mlt_playlist_is_blank( self, clip ) )
1745 playlist_entry *entry = self->list[ clip ];
1746 int in = entry->frame_in;
1747 int out = entry->frame_out;
1748 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
1749 producer = entry->producer;
1750 mlt_properties_inc_ref( MLT_PRODUCER_PROPERTIES( producer ) );
1751 mlt_events_block( properties, properties );
1752 mlt_playlist_remove( self, clip );
1753 mlt_playlist_blank( self, out - in );
1754 mlt_playlist_move( self, self->count - 1, clip );
1755 mlt_events_unblock( properties, properties );
1756 mlt_playlist_virtual_refresh( self );
1757 mlt_producer_set_in_and_out( producer, in, out );
1762 /** Insert blank space.
1764 * \public \memberof mlt_playlist_s
1765 * \param self a playlist
1766 * \param clip the index of the new blank section
1767 * \param out the ending time of the new blank section (duration - 1)
1770 void mlt_playlist_insert_blank( mlt_playlist self, int clip, int out )
1772 if ( self != NULL && out >= 0 )
1774 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
1775 mlt_events_block( properties, properties );
1776 mlt_playlist_blank( self, out );
1777 mlt_playlist_move( self, self->count - 1, clip );
1778 mlt_events_unblock( properties, properties );
1779 mlt_playlist_virtual_refresh( self );
1783 /** Resize a blank entry.
1785 * \public \memberof mlt_playlist_s
1786 * \param self a playlist
1787 * \param position the time at which the blank entry exists relative to the start or end (negative) of the playlist.
1788 * \param length the additional amount of blank frames to add
1789 * \param find true to fist locate the blank after the clip at position
1791 void mlt_playlist_pad_blanks( mlt_playlist self, mlt_position position, int length, int find )
1793 if ( self != NULL && length != 0 )
1795 int clip = mlt_playlist_get_clip_index_at( self, position );
1796 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
1797 mlt_events_block( properties, properties );
1798 if ( find && clip < self->count && !mlt_playlist_is_blank( self, clip ) )
1800 if ( clip < self->count && mlt_playlist_is_blank( self, clip ) )
1802 mlt_playlist_clip_info info;
1803 mlt_playlist_get_clip_info( self, &info, clip );
1804 if ( info.frame_out + length > info.frame_in )
1805 mlt_playlist_resize_clip( self, clip, info.frame_in, info.frame_out + length );
1807 mlt_playlist_remove( self, clip );
1809 else if ( find && clip < self->count && length > 0 )
1811 mlt_playlist_insert_blank( self, clip, length );
1813 mlt_events_unblock( properties, properties );
1814 mlt_playlist_virtual_refresh( self );
1818 /** Insert a clip at a specific time.
1820 * \public \memberof mlt_playlist_s
1821 * \param self a playlist
1822 * \param position the time at which to insert
1823 * \param producer the producer to insert
1824 * \param mode true if you want to overwrite any blank section
1825 * \return true if there was an error
1828 int mlt_playlist_insert_at( mlt_playlist self, mlt_position position, mlt_producer producer, int mode )
1830 int ret = self == NULL || position < 0 || producer == NULL;
1833 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
1834 int length = mlt_producer_get_playtime( producer );
1835 int clip = mlt_playlist_get_clip_index_at( self, position );
1836 mlt_playlist_clip_info info;
1837 mlt_playlist_get_clip_info( self, &info, clip );
1838 mlt_events_block( properties, self );
1839 if ( clip < self->count && mlt_playlist_is_blank( self, clip ) )
1841 // Split and move to new clip if need be
1842 if ( position != info.start && mlt_playlist_split( self, clip, position - info.start - 1 ) == 0 )
1843 mlt_playlist_get_clip_info( self, &info, ++ clip );
1845 // Split again if need be
1846 if ( length < info.frame_count )
1847 mlt_playlist_split( self, clip, length - 1 );
1850 mlt_playlist_remove( self, clip );
1853 mlt_playlist_insert( self, producer, clip, -1, -1 );
1856 else if ( clip < self->count )
1858 if ( position > info.start + info.frame_count / 2 )
1860 if ( mode == 1 && clip < self->count && mlt_playlist_is_blank( self, clip ) )
1862 mlt_playlist_get_clip_info( self, &info, clip );
1863 if ( length < info.frame_count )
1864 mlt_playlist_split( self, clip, length );
1865 mlt_playlist_remove( self, clip );
1867 mlt_playlist_insert( self, producer, clip, -1, -1 );
1873 if ( position == info.start )
1874 mlt_playlist_remove( self, clip );
1876 mlt_playlist_blank( self, position - mlt_properties_get_int( properties, "length" ) - 1 );
1878 mlt_playlist_append( self, producer );
1879 ret = self->count - 1;
1881 mlt_events_unblock( properties, self );
1882 mlt_playlist_virtual_refresh( self );
1891 /** Get the time at which the clip starts relative to the playlist.
1893 * \public \memberof mlt_playlist_s
1894 * \param self a playlist
1895 * \param clip the index of the playlist entry
1896 * \return the starting time
1899 int mlt_playlist_clip_start( mlt_playlist self, int clip )
1901 mlt_playlist_clip_info info;
1902 if ( mlt_playlist_get_clip_info( self, &info, clip ) == 0 )
1904 return clip < 0 ? 0 : mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( self ) );
1907 /** Get the playable duration of the clip.
1909 * \public \memberof mlt_playlist_s
1910 * \param self a playlist
1911 * \param clip the index of the playlist entry
1912 * \return the duration of the playlist entry
1915 int mlt_playlist_clip_length( mlt_playlist self, int clip )
1917 mlt_playlist_clip_info info;
1918 if ( mlt_playlist_get_clip_info( self, &info, clip ) == 0 )
1919 return info.frame_count;
1923 /** Get the duration of a blank space.
1925 * \public \memberof mlt_playlist_s
1926 * \param self a playlist
1927 * \param clip the index of the playlist entry
1928 * \param bounded the maximum number of blank entries or 0 for all
1929 * \return the duration of a blank section
1932 int mlt_playlist_blanks_from( mlt_playlist self, int clip, int bounded )
1935 mlt_playlist_clip_info info;
1936 if ( self != NULL && clip < self->count )
1938 mlt_playlist_get_clip_info( self, &info, clip );
1939 if ( mlt_playlist_is_blank( self, clip ) )
1940 count += info.frame_count;
1942 bounded = self->count;
1943 for ( clip ++; clip < self->count && bounded >= 0; clip ++ )
1945 mlt_playlist_get_clip_info( self, &info, clip );
1946 if ( mlt_playlist_is_blank( self, clip ) )
1947 count += info.frame_count;
1955 /** Remove a portion of the playlist by time.
1957 * \public \memberof mlt_playlist_s
1958 * \param self a playlist
1959 * \param position the starting time
1960 * \param length the duration of time to remove
1961 * \return the new entry index at the position
1964 int mlt_playlist_remove_region( mlt_playlist self, mlt_position position, int length )
1966 int index = mlt_playlist_get_clip_index_at( self, position );
1967 if ( index >= 0 && index < self->count )
1969 mlt_properties properties = MLT_PLAYLIST_PROPERTIES( self );
1970 int clip_start = mlt_playlist_clip_start( self, index );
1971 int list_length = mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( self ) );
1972 mlt_events_block( properties, self );
1974 if ( position + length > list_length )
1975 length -= ( position + length - list_length );
1977 if ( clip_start < position )
1979 mlt_playlist_split( self, index ++, position - clip_start - 1 );
1984 if ( mlt_playlist_clip_length( self, index ) > length )
1985 mlt_playlist_split( self, index, length - 1 );
1986 length -= mlt_playlist_clip_length( self, index );
1987 mlt_playlist_remove( self, index );
1990 mlt_playlist_consolidate_blanks( self, 0 );
1991 mlt_events_unblock( properties, self );
1992 mlt_playlist_virtual_refresh( self );
1994 // Just to be sure, we'll get the clip index again...
1995 index = mlt_playlist_get_clip_index_at( self, position );
2002 * \deprecated not implemented
2003 * \public \memberof mlt_playlist_s
2007 * \param new_position
2011 int mlt_playlist_move_region( mlt_playlist self, mlt_position position, int length, int new_position )
2019 /** Get the current frame.
2021 * The implementation of the get_frame virtual function.
2022 * \private \memberof mlt_playlist_s
2023 * \param producer a producer
2024 * \param frame a frame by reference
2025 * \param index the time at which to get the frame
2029 static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index )
2031 // Check that we have a producer
2032 if ( producer == NULL )
2038 // Get this mlt_playlist
2039 mlt_playlist self = producer->child;
2041 // Need to ensure the frame is deinterlaced when repeating 1 frame
2042 int progressive = 0;
2044 // Get the real producer
2045 mlt_service real = mlt_playlist_virtual_seek( self, &progressive );
2047 // Check that we have a producer
2050 *frame = mlt_frame_init( MLT_PRODUCER_SERVICE( producer ) );
2055 if ( !mlt_properties_get_int( MLT_SERVICE_PROPERTIES( real ), "meta.fx_cut" ) )
2057 mlt_service_get_frame( real, frame, index );
2061 mlt_producer parent = mlt_producer_cut_parent( ( mlt_producer )real );
2062 *frame = mlt_frame_init( MLT_PRODUCER_SERVICE( parent ) );
2063 mlt_properties_set_int( MLT_FRAME_PROPERTIES( *frame ), "fx_cut", 1 );
2064 mlt_frame_push_service( *frame, NULL );
2065 mlt_frame_push_audio( *frame, NULL );
2066 mlt_service_apply_filters( MLT_PRODUCER_SERVICE( parent ), *frame, 0 );
2067 mlt_service_apply_filters( real, *frame, 0 );
2068 mlt_deque_pop_front( MLT_FRAME_IMAGE_STACK( *frame ) );
2069 mlt_deque_pop_front( MLT_FRAME_AUDIO_STACK( *frame ) );
2072 // Check if we're at the end of the clip
2073 mlt_properties properties = MLT_FRAME_PROPERTIES( *frame );
2074 if ( mlt_properties_get_int( properties, "end_of_clip" ) )
2075 mlt_playlist_virtual_set_out( self );
2077 // Set the consumer progressive property
2080 mlt_properties_set_int( properties, "consumer_deinterlace", progressive );
2081 mlt_properties_set_int( properties, "test_audio", 1 );
2084 // Check for notifier and call with appropriate argument
2085 mlt_properties playlist_properties = MLT_PRODUCER_PROPERTIES( producer );
2086 void ( *notifier )( void * ) = mlt_properties_get_data( playlist_properties, "notifier", NULL );
2087 if ( notifier != NULL )
2089 void *argument = mlt_properties_get_data( playlist_properties, "notifier_arg", NULL );
2090 notifier( argument );
2093 // Update position on the frame we're creating
2094 mlt_frame_set_position( *frame, mlt_producer_frame( producer ) );
2096 // Position ourselves on the next frame
2097 mlt_producer_prepare_next( producer );
2102 /** Close the playlist.
2104 * \public \memberof mlt_playlist_s
2105 * \param self a playlist
2108 void mlt_playlist_close( mlt_playlist self )
2110 if ( self != NULL && mlt_properties_dec_ref( MLT_PLAYLIST_PROPERTIES( self ) ) <= 0 )
2113 self->parent.close = NULL;
2114 for ( i = 0; i < self->count; i ++ )
2116 mlt_event_close( self->list[ i ]->event );
2117 mlt_producer_close( self->list[ i ]->producer );
2118 free( self->list[ i ] );
2120 mlt_producer_close( &self->blank );
2121 mlt_producer_close( &self->parent );