-/*
- * mlt_playlist.c -- playlist service class
- * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
- * Author: Charles Yates <charles.yates@pandora.be>
+/**
+ * \file mlt_playlist.c
+ * \brief playlist service class
+ * \see mlt_playlist_s
*
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
+ * Copyright (C) 2003-2009 Ushodaya Enterprises Limited
+ * \author Charles Yates <charles.yates@pandora.be>
*
- * This program is distributed in the hope that it will be useful,
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
*
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software Foundation,
- * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
-#include "config.h"
-
#include "mlt_playlist.h"
+#include "mlt_tractor.h"
+#include "mlt_multitrack.h"
+#include "mlt_field.h"
#include "mlt_frame.h"
+#include "mlt_transition.h"
#include <stdio.h>
#include <stdlib.h>
+#include <string.h>
-/** Virtual playlist entry.
+/** \brief Virtual playlist entry used by mlt_playlist_s
*/
-typedef struct
+struct playlist_entry_s
{
mlt_producer producer;
- mlt_timecode in;
- mlt_timecode playtime;
-}
-playlist_entry;
-
-/** Private definition.
-*/
-
-struct mlt_playlist_s
-{
- struct mlt_producer_s parent;
- struct mlt_producer_s blank;
-
- int size;
- int count;
- playlist_entry **list;
+ mlt_position frame_in;
+ mlt_position frame_out;
+ mlt_position frame_count;
+ int repeat;
+ mlt_position producer_length;
+ mlt_event event;
+ int preservation_hack;
};
-/** Forward declarations
+/* Forward declarations
*/
static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index );
+static int mlt_playlist_unmix( mlt_playlist this, int clip );
+static int mlt_playlist_resize_mix( mlt_playlist this, int clip, int in, int out );
-/** Constructor.
-*/
+/** Construct a playlist.
+ *
+ * Sets the resource property to "<playlist>".
+ * Set the mlt_type to property to "mlt_producer".
+ * \public \memberof mlt_playlist_s
+ * \return a new playlist
+ */
mlt_playlist mlt_playlist_init( )
{
// Override the producer get_frame
producer->get_frame = producer_get_frame;
+ // Define the destructor
+ producer->close = ( mlt_destructor )mlt_playlist_close;
+ producer->close_object = this;
+
// Initialise blank
mlt_producer_init( &this->blank, NULL );
+ mlt_properties_set( MLT_PRODUCER_PROPERTIES( &this->blank ), "mlt_service", "blank" );
+ mlt_properties_set( MLT_PRODUCER_PROPERTIES( &this->blank ), "resource", "blank" );
// Indicate that this producer is a playlist
- mlt_properties_set_data( mlt_playlist_properties( this ), "playlist", this, 0, NULL, NULL );
+ mlt_properties_set_data( MLT_PLAYLIST_PROPERTIES( this ), "playlist", this, 0, NULL, NULL );
+
+ // Specify the eof condition
+ mlt_properties_set( MLT_PLAYLIST_PROPERTIES( this ), "eof", "pause" );
+ mlt_properties_set( MLT_PLAYLIST_PROPERTIES( this ), "resource", "<playlist>" );
+ mlt_properties_set( MLT_PLAYLIST_PROPERTIES( this ), "mlt_type", "mlt_producer" );
+ mlt_properties_set_position( MLT_PLAYLIST_PROPERTIES( this ), "in", 0 );
+ mlt_properties_set_position( MLT_PLAYLIST_PROPERTIES( this ), "out", -1 );
+ mlt_properties_set_position( MLT_PLAYLIST_PROPERTIES( this ), "length", 0 );
+
+ this->size = 10;
+ this->list = malloc( this->size * sizeof( playlist_entry * ) );
}
-
+
return this;
}
/** Get the producer associated to this playlist.
-*/
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return the producer interface
+ * \see MLT_PLAYLIST_PRODUCER
+ */
mlt_producer mlt_playlist_producer( mlt_playlist this )
{
- return &this->parent;
+ return this != NULL ? &this->parent : NULL;
}
/** Get the service associated to this playlist.
-*/
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return the service interface
+ * \see MLT_PLAYLIST_SERVICE
+ */
mlt_service mlt_playlist_service( mlt_playlist this )
{
- return mlt_producer_service( &this->parent );
+ return MLT_PRODUCER_SERVICE( &this->parent );
}
-/** Get the propertues associated to this playlist.
-*/
+/** Get the properties associated to this playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return the playlist's properties list
+ * \see MLT_PLAYLIST_PROPERTIES
+ */
mlt_properties mlt_playlist_properties( mlt_playlist this )
{
- return mlt_producer_properties( &this->parent );
+ return MLT_PRODUCER_PROPERTIES( &this->parent );
+}
+
+/** Refresh the playlist after a clip has been changed.
+ *
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return false
+ */
+
+static int mlt_playlist_virtual_refresh( mlt_playlist this )
+{
+ // Obtain the properties
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+ int i = 0;
+ mlt_position frame_count = 0;
+
+ for ( i = 0; i < this->count; i ++ )
+ {
+ // Get the producer
+ mlt_producer producer = this->list[ i ]->producer;
+ if ( producer )
+ {
+ int current_length = mlt_producer_get_out( producer ) - mlt_producer_get_in( producer ) + 1;
+
+ // Check if the length of the producer has changed
+ if ( this->list[ i ]->frame_in != mlt_producer_get_in( producer ) ||
+ this->list[ i ]->frame_out != mlt_producer_get_out( producer ) )
+ {
+ // This clip should be removed...
+ if ( current_length < 1 )
+ {
+ this->list[ i ]->frame_in = 0;
+ this->list[ i ]->frame_out = -1;
+ this->list[ i ]->frame_count = 0;
+ }
+ else
+ {
+ this->list[ i ]->frame_in = mlt_producer_get_in( producer );
+ this->list[ i ]->frame_out = mlt_producer_get_out( producer );
+ this->list[ i ]->frame_count = current_length;
+ }
+
+ // Update the producer_length
+ this->list[ i ]->producer_length = current_length;
+ }
+ }
+
+ // Calculate the frame_count
+ this->list[ i ]->frame_count = ( this->list[ i ]->frame_out - this->list[ i ]->frame_in + 1 ) * this->list[ i ]->repeat;
+
+ // Update the frame_count for this clip
+ frame_count += this->list[ i ]->frame_count;
+ }
+
+ // Refresh all properties
+ mlt_events_block( properties, properties );
+ mlt_properties_set_position( properties, "length", frame_count );
+ mlt_events_unblock( properties, properties );
+ mlt_properties_set_position( properties, "out", frame_count - 1 );
+
+ return 0;
+}
+
+/** Listener for producers on the playlist.
+ *
+ * Refreshes the playlist whenever an entry receives producer-changed.
+ * \private \memberof mlt_playlist_s
+ * \param producer a producer
+ * \param this a playlist
+ */
+
+static void mlt_playlist_listener( mlt_producer producer, mlt_playlist this )
+{
+ mlt_playlist_virtual_refresh( this );
}
/** Append to the virtual playlist.
-*/
+ *
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param source a producer
+ * \param in the producer's starting time
+ * \param out the producer's ending time
+ * \return true if there was an error
+ */
-static int mlt_playlist_virtual_append( mlt_playlist this, mlt_producer producer, mlt_timecode in, mlt_timecode out )
+static int mlt_playlist_virtual_append( mlt_playlist this, mlt_producer source, mlt_position in, mlt_position out )
{
- // Get the fps of the first producer
- double fps = mlt_properties_get_double( mlt_playlist_properties( this ), "first_fps" );
+ mlt_producer producer = NULL;
+ mlt_properties properties = NULL;
+ mlt_properties parent = NULL;
+
+ // If we have a cut, then use the in/out points from the cut
+ if ( mlt_producer_is_blank( source ) )
+ {
+ // Make sure the blank is long enough to accomodate the length specified
+ if ( out - in + 1 > mlt_producer_get_length( &this->blank ) )
+ {
+ mlt_properties blank_props = MLT_PRODUCER_PROPERTIES( &this->blank );
+ mlt_events_block( blank_props, blank_props );
+ mlt_producer_set_in_and_out( &this->blank, in, out );
+ mlt_events_unblock( blank_props, blank_props );
+ }
- mlt_timecode playtime = mlt_producer_get_playtime( mlt_playlist_producer( this ) ) + out - in;
+ // Now make sure the cut comes from this this->blank
+ if ( source == NULL )
+ {
+ producer = mlt_producer_cut( &this->blank, in, out );
+ }
+ else if ( !mlt_producer_is_cut( source ) || mlt_producer_cut_parent( source ) != &this->blank )
+ {
+ producer = mlt_producer_cut( &this->blank, in, out );
+ }
+ else
+ {
+ producer = source;
+ mlt_properties_inc_ref( MLT_PRODUCER_PROPERTIES( producer ) );
+ }
- // If fps is 0
- if ( fps == 0 )
+ properties = MLT_PRODUCER_PROPERTIES( producer );
+ }
+ else if ( mlt_producer_is_cut( source ) )
{
- // Inherit it from the producer
- fps = mlt_producer_get_fps( producer );
+ producer = source;
+ if ( in == -1 )
+ in = mlt_producer_get_in( producer );
+ if ( out == -1 || out > mlt_producer_get_out( producer ) )
+ out = mlt_producer_get_out( producer );
+ properties = MLT_PRODUCER_PROPERTIES( producer );
+ mlt_properties_inc_ref( properties );
}
- else if ( fps != mlt_properties_get_double( mlt_producer_properties( producer ), "fps" ) )
+ else
{
- // Generate a warning for now - the following attempt to fix may fail
- fprintf( stderr, "Warning: fps mismatch on playlist producer %d\n", this->count );
+ producer = mlt_producer_cut( source, in, out );
+ if ( in == -1 || in < mlt_producer_get_in( producer ) )
+ in = mlt_producer_get_in( producer );
+ if ( out == -1 || out > mlt_producer_get_out( producer ) )
+ out = mlt_producer_get_out( producer );
+ properties = MLT_PRODUCER_PROPERTIES( producer );
+ }
- // It should be safe to impose fps on an image producer, but not necessarily safe for video
- mlt_properties_set_double( mlt_producer_properties( producer ), "fps", fps );
+ // Fetch the cuts parent properties
+ parent = MLT_PRODUCER_PROPERTIES( mlt_producer_cut_parent( producer ) );
+
+ // Remove fezzik normalisers for fx cuts
+ if ( mlt_properties_get_int( parent, "meta.fx_cut" ) )
+ {
+ mlt_service service = MLT_PRODUCER_SERVICE( mlt_producer_cut_parent( producer ) );
+ mlt_filter filter = mlt_service_filter( service, 0 );
+ while ( filter != NULL && mlt_properties_get_int( MLT_FILTER_PROPERTIES( filter ), "_fezzik" ) )
+ {
+ mlt_service_detach( service, filter );
+ filter = mlt_service_filter( service, 0 );
+ }
+ mlt_properties_set_int( MLT_PRODUCER_PROPERTIES( producer ), "meta.fx_cut", 1 );
}
// Check that we have room
{
int i;
this->list = realloc( this->list, ( this->size + 10 ) * sizeof( playlist_entry * ) );
- for ( i = this->size; i < this->size + 10; i ++ )
- this->list[ i ] = NULL;
+ for ( i = this->size; i < this->size + 10; i ++ ) this->list[ i ] = NULL;
this->size += 10;
}
+ // Create the entry
this->list[ this->count ] = calloc( sizeof( playlist_entry ), 1 );
- this->list[ this->count ]->producer = producer;
- this->list[ this->count ]->in = in;
- this->list[ this->count ]->playtime = out - in;
-
- this->count ++;
-
- mlt_properties_set_double( mlt_playlist_properties( this ), "first_fps", fps );
- mlt_properties_set_double( mlt_playlist_properties( this ), "fps", fps );
- mlt_properties_set_timecode( mlt_playlist_properties( this ), "length", playtime );
- mlt_properties_set_timecode( mlt_playlist_properties( this ), "out", playtime );
+ if ( this->list[ this->count ] != NULL )
+ {
+ this->list[ this->count ]->producer = producer;
+ this->list[ this->count ]->frame_in = in;
+ this->list[ this->count ]->frame_out = out;
+ this->list[ this->count ]->frame_count = out - in + 1;
+ this->list[ this->count ]->repeat = 1;
+ this->list[ this->count ]->producer_length = mlt_producer_get_out( producer ) - mlt_producer_get_in( producer ) + 1;
+ this->list[ this->count ]->event = mlt_events_listen( parent, this, "producer-changed", ( mlt_listener )mlt_playlist_listener );
+ mlt_event_inc_ref( this->list[ this->count ]->event );
+ mlt_properties_set( properties, "eof", "pause" );
+ mlt_producer_set_speed( producer, 0 );
+ this->count ++;
+ }
- return 0;
+ return mlt_playlist_virtual_refresh( this );
}
-/** Seek in the virtual playlist.
-*/
+/** Locate a producer by index.
+ *
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param[in, out] position the time at which to locate the producer, returns the time relative to the producer's starting point
+ * \param[out] clip the index of the playlist entry
+ * \param[out] total the duration of the playlist up to and including this producer
+ * \return a producer or NULL if not found
+ */
-static mlt_producer mlt_playlist_virtual_seek( mlt_playlist this )
+static mlt_producer mlt_playlist_locate( mlt_playlist this, mlt_position *position, int *clip, int *total )
{
- // Default producer to blank
- mlt_producer producer = &this->blank;
-
- // Map playlist position to real producer in virtual playlist
- mlt_timecode position = mlt_producer_position( &this->parent );
-
- // Loop through the virtual playlist
- int i = 0;
+ // Default producer to NULL
+ mlt_producer producer = NULL;
- for ( i = 0; i < this->count; i ++ )
+ // Loop for each producer until found
+ for ( *clip = 0; *clip < this->count; *clip += 1 )
{
- if ( position < this->list[ i ]->playtime )
+ // Increment the total
+ *total += this->list[ *clip ]->frame_count;
+
+ // Check if the position indicates that we have found the clip
+ // Note that 0 length clips get skipped automatically
+ if ( *position < this->list[ *clip ]->frame_count )
{
// Found it, now break
- producer = this->list[ i ]->producer;
- position += this->list[ i ]->in;
+ producer = this->list[ *clip ]->producer;
break;
}
else
{
// Decrement position by length of this entry
- position -= this->list[ i ]->playtime;
+ *position -= this->list[ *clip ]->frame_count;
+ }
+ }
+
+ return producer;
+}
+
+/** Seek in the virtual playlist.
+ *
+ * This gets the producer at the current position and seeks on the producer
+ * while doing repeat and end-of-file handling. This is also responsible for
+ * closing producers previous to the preceding playlist if the autoclose
+ * property is set.
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param[out] progressive true if the producer should be displayed progressively
+ * \return the service interface of the producer at the play head
+ * \see producer_get_frame
+ */
+
+static mlt_service mlt_playlist_virtual_seek( mlt_playlist this, int *progressive )
+{
+ // Map playlist position to real producer in virtual playlist
+ mlt_position position = mlt_producer_frame( &this->parent );
+
+ // Keep the original position since we change it while iterating through the list
+ mlt_position original = position;
+
+ // Clip index and total
+ int i = 0;
+ int total = 0;
+
+ // Locate the producer for the position
+ mlt_producer producer = mlt_playlist_locate( this, &position, &i, &total );
+
+ // Get the properties
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+
+ // Automatically close previous producers if requested
+ if ( i > 1 // keep immediate previous in case app wants to get info about what just finished
+ && position < 2 // tolerate off-by-one error on going to next clip
+ && mlt_properties_get_int( properties, "autoclose" ) )
+ {
+ int j;
+ // They might have jumped ahead!
+ for ( j = 0; j < i - 1; j++ )
+ {
+ mlt_service_lock( MLT_PRODUCER_SERVICE( this->list[ j ]->producer ) );
+ mlt_producer p = this->list[ j ]->producer;
+ if ( p )
+ {
+ this->list[ j ]->producer = NULL;
+ mlt_service_unlock( MLT_PRODUCER_SERVICE( p ) );
+ mlt_producer_close( p );
+ }
+ // If p is null, the lock will not have been "taken"
}
}
+ // Get the eof handling
+ char *eof = mlt_properties_get( properties, "eof" );
+
// Seek in real producer to relative position
- mlt_producer_seek( producer, position );
+ if ( producer != NULL )
+ {
+ int count = this->list[ i ]->frame_count / this->list[ i ]->repeat;
+ *progressive = count == 1;
+ mlt_producer_seek( producer, (int)position % count );
+ }
+ else if ( !strcmp( eof, "pause" ) && total > 0 )
+ {
+ playlist_entry *entry = this->list[ this->count - 1 ];
+ int count = entry->frame_count / entry->repeat;
+ mlt_producer this_producer = MLT_PLAYLIST_PRODUCER( this );
+ mlt_producer_seek( this_producer, original - 1 );
+ producer = entry->producer;
+ mlt_producer_seek( producer, (int)entry->frame_out % count );
+ mlt_producer_set_speed( this_producer, 0 );
+ mlt_producer_set_speed( producer, 0 );
+ *progressive = count == 1;
+ }
+ else if ( !strcmp( eof, "loop" ) && total > 0 )
+ {
+ playlist_entry *entry = this->list[ 0 ];
+ mlt_producer this_producer = MLT_PLAYLIST_PRODUCER( this );
+ mlt_producer_seek( this_producer, 0 );
+ producer = entry->producer;
+ mlt_producer_seek( producer, 0 );
+ }
+ else
+ {
+ producer = &this->blank;
+ }
- return producer;
+ return MLT_PRODUCER_SERVICE( producer );
}
+/** Invoked when a producer indicates that it has prematurely reached its end.
+ *
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return a producer
+ * \see producer_get_frame
+ */
+
static mlt_producer mlt_playlist_virtual_set_out( mlt_playlist this )
{
// Default producer to blank
mlt_producer producer = &this->blank;
// Map playlist position to real producer in virtual playlist
- mlt_timecode position = mlt_producer_position( &this->parent );
+ mlt_position position = mlt_producer_frame( &this->parent );
// Loop through the virtual playlist
int i = 0;
for ( i = 0; i < this->count; i ++ )
{
- if ( position < this->list[ i ]->playtime )
+ if ( position < this->list[ i ]->frame_count )
{
// Found it, now break
producer = this->list[ i ]->producer;
- position += this->list[ i ]->in;
break;
}
else
{
// Decrement position by length of this entry
- position -= this->list[ i ]->playtime;
+ position -= this->list[ i ]->frame_count;
}
}
// Seek in real producer to relative position
- if ( i < this->count )
+ if ( i < this->count && this->list[ i ]->frame_out != position )
{
- fprintf( stderr, "END OF CLIP %d AT %e\n", i, position );
- this->list[ i ]->playtime = position - this->list[ i ]->in;
+ // Update the frame_count for the changed clip (hmmm)
+ this->list[ i ]->frame_out = position;
+ this->list[ i ]->frame_count = this->list[ i ]->frame_out - this->list[ i ]->frame_in + 1;
+
+ // Refresh the playlist
+ mlt_playlist_virtual_refresh( this );
}
return producer;
}
-static int mlt_playlist_current_clip( mlt_playlist this )
+/** Obtain the current clips index.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return the index of the playlist entry at the current position
+ */
+
+int mlt_playlist_current_clip( mlt_playlist this )
{
// Map playlist position to real producer in virtual playlist
- mlt_timecode position = mlt_producer_position( &this->parent );
+ mlt_position position = mlt_producer_frame( &this->parent );
// Loop through the virtual playlist
int i = 0;
for ( i = 0; i < this->count; i ++ )
{
- if ( position < this->list[ i ]->playtime )
+ if ( position < this->list[ i ]->frame_count )
{
// Found it, now break
break;
else
{
// Decrement position by length of this entry
- position -= this->list[ i ]->playtime;
+ position -= this->list[ i ]->frame_count;
}
}
return i;
}
-/** Get the timecode which corresponds to the start of the next clip.
-*/
+/** Obtain the current clips producer.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return the producer at the current position
+ */
+
+mlt_producer mlt_playlist_current( mlt_playlist this )
+{
+ int i = mlt_playlist_current_clip( this );
+ if ( i < this->count )
+ return this->list[ i ]->producer;
+ else
+ return &this->blank;
+}
+
+/** Get the position which corresponds to the start of the next clip.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param whence the location from which to make the index relative:
+ * start of playlist, end of playlist, or current position
+ * \param index the playlist entry index relative to whence
+ * \return the time at which the referenced clip starts
+ */
-mlt_timecode mlt_playlist_clip( mlt_playlist this, mlt_whence whence, int index )
+mlt_position mlt_playlist_clip( mlt_playlist this, mlt_whence whence, int index )
{
- mlt_timecode position = 0;
+ mlt_position position = 0;
int absolute_clip = index;
int i = 0;
else if ( absolute_clip > this->count )
absolute_clip = this->count;
- // Now determine the timecode
+ // Now determine the position
for ( i = 0; i < absolute_clip; i ++ )
- position += this->list[ i ]->playtime;
+ position += this->list[ i ]->frame_count;
return position;
}
+/** Get all the info about the clip specified.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param info a clip info struct
+ * \param index a playlist entry index
+ * \return true if there was an error
+ */
+
+int mlt_playlist_get_clip_info( mlt_playlist this, mlt_playlist_clip_info *info, int index )
+{
+ int error = index < 0 || index >= this->count || this->list[ index ]->producer == NULL;
+ memset( info, 0, sizeof( mlt_playlist_clip_info ) );
+ if ( !error )
+ {
+ mlt_producer producer = mlt_producer_cut_parent( this->list[ index ]->producer );
+ mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
+ info->clip = index;
+ info->producer = producer;
+ info->cut = this->list[ index ]->producer;
+ info->start = mlt_playlist_clip( this, mlt_whence_relative_start, index );
+ info->resource = mlt_properties_get( properties, "resource" );
+ info->frame_in = this->list[ index ]->frame_in;
+ info->frame_out = this->list[ index ]->frame_out;
+ info->frame_count = this->list[ index ]->frame_count;
+ info->repeat = this->list[ index ]->repeat;
+ info->length = mlt_producer_get_length( producer );
+ info->fps = mlt_producer_get_fps( producer );
+ }
+
+ return error;
+}
+
+/** Get number of clips in the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return the number of playlist entries
+ */
+
+int mlt_playlist_count( mlt_playlist this )
+{
+ return this->count;
+}
+
+/** Clear the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \return true if there was an error
+ */
+
+int mlt_playlist_clear( mlt_playlist this )
+{
+ int i;
+ for ( i = 0; i < this->count; i ++ )
+ {
+ mlt_event_close( this->list[ i ]->event );
+ mlt_producer_close( this->list[ i ]->producer );
+ }
+ this->count = 0;
+ return mlt_playlist_virtual_refresh( this );
+}
+
/** Append a producer to the playlist.
-*/
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param producer the producer to append
+ * \return true if there was an error
+ */
int mlt_playlist_append( mlt_playlist this, mlt_producer producer )
{
// Append to virtual list
- return mlt_playlist_virtual_append( this, producer, 0, mlt_producer_get_playtime( producer ) );
+ return mlt_playlist_virtual_append( this, producer, 0, mlt_producer_get_playtime( producer ) - 1 );
+}
+
+/** Append a producer to the playlist with in/out points.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param producer the producer to append
+ * \param in the starting point on the producer
+ * \param out the ending point on the producer
+ * \return true if there was an error
+ */
+
+int mlt_playlist_append_io( mlt_playlist this, mlt_producer producer, mlt_position in, mlt_position out )
+{
+ // Append to virtual list
+ if ( in != -1 && out != -1 )
+ return mlt_playlist_virtual_append( this, producer, in, out );
+ else
+ return mlt_playlist_append( this, producer );
}
/** Append a blank to the playlist of a given length.
-*/
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param length the ending time of the blank entry, not its duration
+ * \return true if there was an error
+ */
-int mlt_playlist_blank( mlt_playlist this, mlt_timecode length )
+int mlt_playlist_blank( mlt_playlist this, mlt_position length )
{
// Append to the virtual list
- return mlt_playlist_virtual_append( this, &this->blank, 0, length );
+ if (length >= 0)
+ return mlt_playlist_virtual_append( this, &this->blank, 0, length );
+ else
+ return 1;
}
-/** Get the current frame.
-*/
+/** Insert a producer into the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param producer the producer to insert
+ * \param where the producer's playlist entry index
+ * \param in the starting point on the producer
+ * \param out the ending point on the producer
+ * \return true if there was an error
+ */
-static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index )
+int mlt_playlist_insert( mlt_playlist this, mlt_producer producer, int where, mlt_position in, mlt_position out )
{
- // Get this mlt_playlist
- mlt_playlist this = producer->child;
+ // Append to end
+ mlt_events_block( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_append_io( this, producer, in, out );
- // Get the real producer
- mlt_producer real = mlt_playlist_virtual_seek( this );
+ // Move to the position specified
+ mlt_playlist_move( this, this->count - 1, where );
+ mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( this ), this );
- // Get the frame
- mlt_service_get_frame( mlt_producer_service( real ), frame, index );
+ return mlt_playlist_virtual_refresh( this );
+}
- // Check if we're at the end of the clip
- mlt_properties properties = mlt_frame_properties( *frame );
- if ( mlt_properties_get_int( properties, "end_of_clip" ) )
- mlt_playlist_virtual_set_out( this );
+/** Remove an entry in the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param where the playlist entry index
+ * \return true if there was an error
+ */
- // Update timecode on the frame we're creating
- mlt_frame_set_timecode( *frame, mlt_producer_position( producer ) );
+int mlt_playlist_remove( mlt_playlist this, int where )
+{
+ int error = where < 0 || where >= this->count;
+ if ( error == 0 && mlt_playlist_unmix( this, where ) != 0 )
+ {
+ // We need to know the current clip and the position within the playlist
+ int current = mlt_playlist_current_clip( this );
+ mlt_position position = mlt_producer_position( MLT_PLAYLIST_PRODUCER( this ) );
- // Position ourselves on the next frame
- mlt_producer_prepare_next( producer );
+ // We need all the details about the clip we're removing
+ mlt_playlist_clip_info where_info;
+ playlist_entry *entry = this->list[ where ];
+ mlt_properties properties = MLT_PRODUCER_PROPERTIES( entry->producer );
+
+ // Loop variable
+ int i = 0;
+
+ // Get the clip info
+ mlt_playlist_get_clip_info( this, &where_info, where );
+
+ // Make sure the clip to be removed is valid and correct if necessary
+ if ( where < 0 )
+ where = 0;
+ if ( where >= this->count )
+ where = this->count - 1;
+
+ // Reorganise the list
+ for ( i = where + 1; i < this->count; i ++ )
+ this->list[ i - 1 ] = this->list[ i ];
+ this->count --;
+
+ if ( entry->preservation_hack == 0 )
+ {
+ // Decouple from mix_in/out if necessary
+ if ( mlt_properties_get_data( properties, "mix_in", NULL ) != NULL )
+ {
+ mlt_properties mix = mlt_properties_get_data( properties, "mix_in", NULL );
+ mlt_properties_set_data( mix, "mix_out", NULL, 0, NULL, NULL );
+ }
+ if ( mlt_properties_get_data( properties, "mix_out", NULL ) != NULL )
+ {
+ mlt_properties mix = mlt_properties_get_data( properties, "mix_out", NULL );
+ mlt_properties_set_data( mix, "mix_in", NULL, 0, NULL, NULL );
+ }
+
+ if ( mlt_properties_ref_count( MLT_PRODUCER_PROPERTIES( entry->producer ) ) == 1 )
+ mlt_producer_clear( entry->producer );
+ }
+
+ // Close the producer associated to the clip info
+ mlt_event_close( entry->event );
+ mlt_producer_close( entry->producer );
+
+ // Correct position
+ if ( where == current )
+ mlt_producer_seek( MLT_PLAYLIST_PRODUCER( this ), where_info.start );
+ else if ( where < current && this->count > 0 )
+ mlt_producer_seek( MLT_PLAYLIST_PRODUCER( this ), position - where_info.frame_count );
+ else if ( this->count == 0 )
+ mlt_producer_seek( MLT_PLAYLIST_PRODUCER( this ), 0 );
+
+ // Free the entry
+ free( entry );
+
+ // Refresh the playlist
+ mlt_playlist_virtual_refresh( this );
+ }
+
+ return error;
+}
+
+/** Move an entry in the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param src an entry index
+ * \param dest an entry index
+ * \return false
+ */
+
+int mlt_playlist_move( mlt_playlist this, int src, int dest )
+{
+ int i;
+
+ /* We need to ensure that the requested indexes are valid and correct it as necessary */
+ if ( src < 0 )
+ src = 0;
+ if ( src >= this->count )
+ src = this->count - 1;
+
+ if ( dest < 0 )
+ dest = 0;
+ if ( dest >= this->count )
+ dest = this->count - 1;
+
+ if ( src != dest && this->count > 1 )
+ {
+ int current = mlt_playlist_current_clip( this );
+ mlt_position position = mlt_producer_position( MLT_PLAYLIST_PRODUCER( this ) );
+ playlist_entry *src_entry = NULL;
+
+ // We need all the details about the current clip
+ mlt_playlist_clip_info current_info;
+
+ mlt_playlist_get_clip_info( this, ¤t_info, current );
+ position -= current_info.start;
+
+ if ( current == src )
+ current = dest;
+ else if ( current > src && current < dest )
+ current ++;
+ else if ( current == dest )
+ current = src;
+
+ src_entry = this->list[ src ];
+ if ( src > dest )
+ {
+ for ( i = src; i > dest; i -- )
+ this->list[ i ] = this->list[ i - 1 ];
+ }
+ else
+ {
+ for ( i = src; i < dest; i ++ )
+ this->list[ i ] = this->list[ i + 1 ];
+ }
+ this->list[ dest ] = src_entry;
+
+ mlt_playlist_get_clip_info( this, ¤t_info, current );
+ mlt_producer_seek( MLT_PLAYLIST_PRODUCER( this ), current_info.start + position );
+ mlt_playlist_virtual_refresh( this );
+ }
return 0;
}
-/** Close the playlist.
-*/
+/** Repeat the specified clip n times.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip a playlist entry index
+ * \param repeat the number of times to repeat the clip
+ * \return true if there was an error
+ */
-void mlt_playlist_close( mlt_playlist this )
+int mlt_playlist_repeat_clip( mlt_playlist this, int clip, int repeat )
+{
+ int error = repeat < 1 || clip < 0 || clip >= this->count;
+ if ( error == 0 )
+ {
+ playlist_entry *entry = this->list[ clip ];
+ entry->repeat = repeat;
+ mlt_playlist_virtual_refresh( this );
+ }
+ return error;
+}
+
+/** Resize the specified clip.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \param in the new starting time on the clip's producer
+ * \param out the new ending time on the clip's producer
+ * \return true if there was an error
+ */
+
+int mlt_playlist_resize_clip( mlt_playlist this, int clip, mlt_position in, mlt_position out )
+{
+ int error = clip < 0 || clip >= this->count;
+ if ( error == 0 && mlt_playlist_resize_mix( this, clip, in, out ) != 0 )
+ {
+ playlist_entry *entry = this->list[ clip ];
+ mlt_producer producer = entry->producer;
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+
+ mlt_events_block( properties, properties );
+
+ if ( mlt_producer_is_blank( producer ) )
+ {
+ // Make sure the blank is long enough to accomodate the length specified
+ if ( out - in + 1 > mlt_producer_get_length( &this->blank ) )
+ {
+ mlt_properties blank_props = MLT_PRODUCER_PROPERTIES( &this->blank );
+ mlt_properties_set_int( blank_props, "length", out - in + 1 );
+ mlt_properties_set_int( MLT_PRODUCER_PROPERTIES( producer ), "length", out - in + 1 );
+ mlt_producer_set_in_and_out( &this->blank, 0, out - in );
+ }
+ }
+
+ if ( in <= -1 )
+ in = 0;
+ if ( out <= -1 || out >= mlt_producer_get_length( producer ) )
+ out = mlt_producer_get_length( producer ) - 1;
+
+ if ( out < in )
+ {
+ mlt_position t = in;
+ in = out;
+ out = t;
+ }
+
+ mlt_producer_set_in_and_out( producer, in, out );
+ mlt_events_unblock( properties, properties );
+ mlt_playlist_virtual_refresh( this );
+ }
+ return error;
+}
+
+/** Split a clip on the playlist at the given position.
+ *
+ * This splits after the specified frame.
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \param position the time at which to split relative to the beginning of the clip or its end if negative
+ * \return true if there was an error
+ */
+
+int mlt_playlist_split( mlt_playlist this, int clip, mlt_position position )
{
- mlt_producer_close( &this->parent );
- mlt_producer_close( &this->blank );
- free( this );
+ int error = clip < 0 || clip >= this->count;
+ if ( error == 0 )
+ {
+ playlist_entry *entry = this->list[ clip ];
+ position = position < 0 ? entry->frame_count + position - 1 : position;
+ if ( position >= 0 && position < entry->frame_count - 1 )
+ {
+ int in = entry->frame_in;
+ int out = entry->frame_out;
+ mlt_events_block( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_resize_clip( this, clip, in, in + position );
+ if ( !mlt_producer_is_blank( entry->producer ) )
+ {
+ int i = 0;
+ mlt_properties entry_properties = MLT_PRODUCER_PROPERTIES( entry->producer );
+ mlt_producer split = mlt_producer_cut( entry->producer, in + position + 1, out );
+ mlt_properties split_properties = MLT_PRODUCER_PROPERTIES( split );
+ mlt_playlist_insert( this, split, clip + 1, 0, -1 );
+ for ( i = 0; i < mlt_properties_count( entry_properties ); i ++ )
+ {
+ char *name = mlt_properties_get_name( entry_properties, i );
+ if ( name != NULL && !strncmp( name, "meta.", 5 ) )
+ mlt_properties_set( split_properties, name, mlt_properties_get_value( entry_properties, i ) );
+ }
+ mlt_producer_close( split );
+ }
+ else
+ {
+ mlt_playlist_insert( this, &this->blank, clip + 1, 0, out - position - 1 );
+ }
+ mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_virtual_refresh( this );
+ }
+ else
+ {
+ error = 1;
+ }
+ }
+ return error;
+}
+
+/** Split the playlist at the absolute position.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position the time at which to split relative to the beginning of the clip
+ * \param left true to split before the frame starting at position
+ * \return true if there was an error
+ */
+
+int mlt_playlist_split_at( mlt_playlist this, mlt_position position, int left )
+{
+ int result = this == NULL ? -1 : 0;
+ if ( !result )
+ {
+ if ( position >= 0 && position < mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( this ) ) )
+ {
+ int clip = mlt_playlist_get_clip_index_at( this, position );
+ mlt_playlist_clip_info info;
+ mlt_playlist_get_clip_info( this, &info, clip );
+ if ( left && position != info.start )
+ mlt_playlist_split( this, clip, position - info.start - 1 );
+ else if ( !left )
+ mlt_playlist_split( this, clip, position - info.start );
+ result = position;
+ }
+ else if ( position <= 0 )
+ {
+ result = 0;
+ }
+ else
+ {
+ result = mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( this ) );
+ }
+ }
+ return result;
+}
+
+/** Join 1 or more consecutive clips.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the starting playlist entry index
+ * \param count the number of entries to merge
+ * \param merge ignored
+ * \return true if there was an error
+ */
+
+int mlt_playlist_join( mlt_playlist this, int clip, int count, int merge )
+{
+ int error = clip < 0 || clip >= this->count;
+ if ( error == 0 )
+ {
+ int i = clip;
+ mlt_playlist new_clip = mlt_playlist_init( );
+ mlt_events_block( MLT_PLAYLIST_PROPERTIES( this ), this );
+ if ( clip + count >= this->count )
+ count = this->count - clip - 1;
+ for ( i = 0; i <= count; i ++ )
+ {
+ playlist_entry *entry = this->list[ clip ];
+ mlt_playlist_append( new_clip, entry->producer );
+ mlt_playlist_repeat_clip( new_clip, i, entry->repeat );
+ entry->preservation_hack = 1;
+ mlt_playlist_remove( this, clip );
+ }
+ mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_insert( this, MLT_PLAYLIST_PRODUCER( new_clip ), clip, 0, -1 );
+ mlt_playlist_close( new_clip );
+ }
+ return error;
+}
+
+/** Mix consecutive clips for a specified length and apply transition if specified.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \param length the number of frames over which to create the mix
+ * \param transition the transition to use for the mix
+ * \return true if there was an error
+ */
+
+int mlt_playlist_mix( mlt_playlist this, int clip, int length, mlt_transition transition )
+{
+ int error = ( clip < 0 || clip + 1 >= this->count );
+ if ( error == 0 )
+ {
+ playlist_entry *clip_a = this->list[ clip ];
+ playlist_entry *clip_b = this->list[ clip + 1 ];
+ mlt_producer track_a = NULL;
+ mlt_producer track_b = NULL;
+ mlt_tractor tractor = mlt_tractor_new( );
+ mlt_events_block( MLT_PLAYLIST_PROPERTIES( this ), this );
+
+ // Check length is valid for both clips and resize if necessary.
+ int max_size = clip_a->frame_count > clip_b->frame_count ? clip_a->frame_count : clip_b->frame_count;
+ length = length > max_size ? max_size : length;
+
+ // Create the a and b tracks/cuts if necessary - note that no cuts are required if the length matches
+ if ( length != clip_a->frame_count )
+ track_a = mlt_producer_cut( clip_a->producer, clip_a->frame_out - length + 1, clip_a->frame_out );
+ else
+ track_a = clip_a->producer;
+
+ if ( length != clip_b->frame_count )
+ track_b = mlt_producer_cut( clip_b->producer, clip_b->frame_in, clip_b->frame_in + length - 1 );
+ else
+ track_b = clip_b->producer;
+
+ // Set the tracks on the tractor
+ mlt_tractor_set_track( tractor, track_a, 0 );
+ mlt_tractor_set_track( tractor, track_b, 1 );
+
+ // Insert the mix object into the playlist
+ mlt_playlist_insert( this, MLT_TRACTOR_PRODUCER( tractor ), clip + 1, -1, -1 );
+ mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mlt_mix", tractor, 0, NULL, NULL );
+
+ // Attach the transition
+ if ( transition != NULL )
+ {
+ mlt_field field = mlt_tractor_field( tractor );
+ mlt_field_plant_transition( field, transition, 0, 1 );
+ mlt_transition_set_in_and_out( transition, 0, length - 1 );
+ }
+
+ // Close our references to the tracks if we created new cuts above (the tracks can still be used here)
+ if ( track_a != clip_a->producer )
+ mlt_producer_close( track_a );
+ if ( track_b != clip_b->producer )
+ mlt_producer_close( track_b );
+
+ // Check if we have anything left on the right hand clip
+ if ( track_b == clip_b->producer )
+ {
+ clip_b->preservation_hack = 1;
+ mlt_playlist_remove( this, clip + 2 );
+ }
+ else if ( clip_b->frame_out - clip_b->frame_in > length )
+ {
+ mlt_playlist_resize_clip( this, clip + 2, clip_b->frame_in + length, clip_b->frame_out );
+ mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_b->producer ), "mix_in", tractor, 0, NULL, NULL );
+ mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_out", clip_b->producer, 0, NULL, NULL );
+ }
+ else
+ {
+ mlt_producer_clear( clip_b->producer );
+ mlt_playlist_remove( this, clip + 2 );
+ }
+
+ // Check if we have anything left on the left hand clip
+ if ( track_a == clip_a->producer )
+ {
+ clip_a->preservation_hack = 1;
+ mlt_playlist_remove( this, clip );
+ }
+ else if ( clip_a->frame_out - clip_a->frame_in > length )
+ {
+ mlt_playlist_resize_clip( this, clip, clip_a->frame_in, clip_a->frame_out - length );
+ mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( clip_a->producer ), "mix_out", tractor, 0, NULL, NULL );
+ mlt_properties_set_data( MLT_TRACTOR_PROPERTIES( tractor ), "mix_in", clip_a->producer, 0, NULL, NULL );
+ }
+ else
+ {
+ mlt_producer_clear( clip_a->producer );
+ mlt_playlist_remove( this, clip );
+ }
+
+ // Unblock and force a fire off of change events to listeners
+ mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_virtual_refresh( this );
+ mlt_tractor_close( tractor );
+ }
+ return error;
+}
+
+/** Add a transition to an existing mix.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \param transition a transition
+ * \return true if there was an error
+ */
+
+int mlt_playlist_mix_add( mlt_playlist this, int clip, mlt_transition transition )
+{
+ mlt_producer producer = mlt_producer_cut_parent( mlt_playlist_get_clip( this, clip ) );
+ mlt_properties properties = producer != NULL ? MLT_PRODUCER_PROPERTIES( producer ) : NULL;
+ mlt_tractor tractor = properties != NULL ? mlt_properties_get_data( properties, "mlt_mix", NULL ) : NULL;
+ int error = transition == NULL || tractor == NULL;
+ if ( error == 0 )
+ {
+ mlt_field field = mlt_tractor_field( tractor );
+ mlt_field_plant_transition( field, transition, 0, 1 );
+ mlt_transition_set_in_and_out( transition, 0, this->list[ clip ]->frame_count - 1 );
+ }
+ return error;
+}
+
+/** Return the clip at the clip index.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of a playlist entry
+ * \return a producer or NULL if there was an error
+ */
+
+mlt_producer mlt_playlist_get_clip( mlt_playlist this, int clip )
+{
+ if ( clip >= 0 && clip < this->count )
+ return this->list[ clip ]->producer;
+ return NULL;
+}
+
+/** Return the clip at the specified position.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position a time relative to the beginning of the playlist
+ * \return a producer or NULL if not found
+ */
+
+mlt_producer mlt_playlist_get_clip_at( mlt_playlist this, mlt_position position )
+{
+ int index = 0, total = 0;
+ return mlt_playlist_locate( this, &position, &index, &total );
+}
+
+/** Return the clip index of the specified position.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position a time relative to the beginning of the playlist
+ * \return the index of the playlist entry
+ */
+
+int mlt_playlist_get_clip_index_at( mlt_playlist this, mlt_position position )
+{
+ int index = 0, total = 0;
+ mlt_playlist_locate( this, &position, &index, &total );
+ return index;
+}
+
+/** Determine if the clip is a mix.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \return true if the producer is a mix
+ */
+
+int mlt_playlist_clip_is_mix( mlt_playlist this, int clip )
+{
+ mlt_producer producer = mlt_producer_cut_parent( mlt_playlist_get_clip( this, clip ) );
+ mlt_properties properties = producer != NULL ? MLT_PRODUCER_PROPERTIES( producer ) : NULL;
+ mlt_tractor tractor = properties != NULL ? mlt_properties_get_data( properties, "mlt_mix", NULL ) : NULL;
+ return tractor != NULL;
+}
+
+/** Remove a mixed clip - ensure that the cuts included in the mix find their way
+ * back correctly on to the playlist.
+ *
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \return true if there was an error
+ */
+
+static int mlt_playlist_unmix( mlt_playlist this, int clip )
+{
+ int error = ( clip < 0 || clip >= this->count );
+
+ // Ensure that the clip request is actually a mix
+ if ( error == 0 )
+ {
+ mlt_producer producer = mlt_producer_cut_parent( this->list[ clip ]->producer );
+ mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
+ error = mlt_properties_get_data( properties, "mlt_mix", NULL ) == NULL ||
+ this->list[ clip ]->preservation_hack;
+ }
+
+ if ( error == 0 )
+ {
+ playlist_entry *mix = this->list[ clip ];
+ mlt_tractor tractor = ( mlt_tractor )mlt_producer_cut_parent( mix->producer );
+ mlt_properties properties = MLT_TRACTOR_PROPERTIES( tractor );
+ mlt_producer clip_a = mlt_properties_get_data( properties, "mix_in", NULL );
+ mlt_producer clip_b = mlt_properties_get_data( properties, "mix_out", NULL );
+ int length = mlt_producer_get_playtime( MLT_TRACTOR_PRODUCER( tractor ) );
+ mlt_events_block( MLT_PLAYLIST_PROPERTIES( this ), this );
+
+ if ( clip_a != NULL )
+ {
+ mlt_producer_set_in_and_out( clip_a, mlt_producer_get_in( clip_a ), mlt_producer_get_out( clip_a ) + length );
+ }
+ else
+ {
+ mlt_producer cut = mlt_tractor_get_track( tractor, 0 );
+ mlt_playlist_insert( this, cut, clip, -1, -1 );
+ clip ++;
+ }
+
+ if ( clip_b != NULL )
+ {
+ mlt_producer_set_in_and_out( clip_b, mlt_producer_get_in( clip_b ) - length, mlt_producer_get_out( clip_b ) );
+ }
+ else
+ {
+ mlt_producer cut = mlt_tractor_get_track( tractor, 1 );
+ mlt_playlist_insert( this, cut, clip + 1, -1, -1 );
+ }
+
+ mlt_properties_set_data( properties, "mlt_mix", NULL, 0, NULL, NULL );
+ mlt_playlist_remove( this, clip );
+ mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_virtual_refresh( this );
+ }
+ return error;
+}
+
+/** Resize a mix clip.
+ *
+ * \private \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \param in the new starting point
+ * \param out the new ending point
+ * \return true if there was an error
+ */
+
+static int mlt_playlist_resize_mix( mlt_playlist this, int clip, int in, int out )
+{
+ int error = ( clip < 0 || clip >= this->count );
+
+ // Ensure that the clip request is actually a mix
+ if ( error == 0 )
+ {
+ mlt_producer producer = mlt_producer_cut_parent( this->list[ clip ]->producer );
+ mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
+ error = mlt_properties_get_data( properties, "mlt_mix", NULL ) == NULL;
+ }
+
+ if ( error == 0 )
+ {
+ playlist_entry *mix = this->list[ clip ];
+ mlt_tractor tractor = ( mlt_tractor )mlt_producer_cut_parent( mix->producer );
+ mlt_properties properties = MLT_TRACTOR_PROPERTIES( tractor );
+ mlt_producer clip_a = mlt_properties_get_data( properties, "mix_in", NULL );
+ mlt_producer clip_b = mlt_properties_get_data( properties, "mix_out", NULL );
+ mlt_producer track_a = mlt_tractor_get_track( tractor, 0 );
+ mlt_producer track_b = mlt_tractor_get_track( tractor, 1 );
+ int length = out - in + 1;
+ int length_diff = length - mlt_producer_get_playtime( MLT_TRACTOR_PRODUCER( tractor ) );
+ mlt_events_block( MLT_PLAYLIST_PROPERTIES( this ), this );
+
+ if ( clip_a != NULL )
+ mlt_producer_set_in_and_out( clip_a, mlt_producer_get_in( clip_a ), mlt_producer_get_out( clip_a ) - length_diff );
+
+ if ( clip_b != NULL )
+ mlt_producer_set_in_and_out( clip_b, mlt_producer_get_in( clip_b ) + length_diff, mlt_producer_get_out( clip_b ) );
+
+ mlt_producer_set_in_and_out( track_a, mlt_producer_get_in( track_a ) - length_diff, mlt_producer_get_out( track_a ) );
+ mlt_producer_set_in_and_out( track_b, mlt_producer_get_in( track_b ), mlt_producer_get_out( track_b ) + length_diff );
+ mlt_producer_set_in_and_out( MLT_MULTITRACK_PRODUCER( mlt_tractor_multitrack( tractor ) ), in, out );
+ mlt_producer_set_in_and_out( MLT_TRACTOR_PRODUCER( tractor ), in, out );
+ mlt_properties_set_position( MLT_PRODUCER_PROPERTIES( mix->producer ), "length", out - in + 1 );
+ mlt_producer_set_in_and_out( mix->producer, in, out );
+
+ mlt_events_unblock( MLT_PLAYLIST_PROPERTIES( this ), this );
+ mlt_playlist_virtual_refresh( this );
+ }
+ return error;
+}
+
+/** Consolidate adjacent blank producers.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param keep_length set false to remove the last entry if it is blank
+ */
+
+void mlt_playlist_consolidate_blanks( mlt_playlist this, int keep_length )
+{
+ if ( this != NULL )
+ {
+ int i = 0;
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+
+ mlt_events_block( properties, properties );
+ for ( i = 1; i < this->count; i ++ )
+ {
+ playlist_entry *left = this->list[ i - 1 ];
+ playlist_entry *right = this->list[ i ];
+
+ if ( mlt_producer_is_blank( left->producer ) && mlt_producer_is_blank( right->producer ) )
+ {
+ mlt_playlist_resize_clip( this, i - 1, 0, left->frame_count + right->frame_count - 1 );
+ mlt_playlist_remove( this, i -- );
+ }
+ }
+
+ if ( !keep_length && this->count > 0 )
+ {
+ playlist_entry *last = this->list[ this->count - 1 ];
+ if ( mlt_producer_is_blank( last->producer ) )
+ mlt_playlist_remove( this, this->count - 1 );
+ }
+
+ mlt_events_unblock( properties, properties );
+ mlt_playlist_virtual_refresh( this );
+ }
+}
+
+/** Determine if the specified clip index is a blank.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \return true if there was an error
+ */
+
+int mlt_playlist_is_blank( mlt_playlist this, int clip )
+{
+ return this == NULL || mlt_producer_is_blank( mlt_playlist_get_clip( this, clip ) );
+}
+
+/** Determine if the specified position is a blank.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position a time relative to the start or end (negative) of the playlist
+ * \return true if there was an error
+ */
+
+int mlt_playlist_is_blank_at( mlt_playlist this, mlt_position position )
+{
+ return this == NULL || mlt_producer_is_blank( mlt_playlist_get_clip_at( this, position ) );
+}
+
+/** Replace the specified clip with a blank and return the clip.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \return a producer or NULL if there was an error
+ */
+
+mlt_producer mlt_playlist_replace_with_blank( mlt_playlist this, int clip )
+{
+ mlt_producer producer = NULL;
+ if ( !mlt_playlist_is_blank( this, clip ) )
+ {
+ playlist_entry *entry = this->list[ clip ];
+ int in = entry->frame_in;
+ int out = entry->frame_out;
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+ producer = entry->producer;
+ mlt_properties_inc_ref( MLT_PRODUCER_PROPERTIES( producer ) );
+ mlt_events_block( properties, properties );
+ mlt_playlist_remove( this, clip );
+ mlt_playlist_blank( this, out - in );
+ mlt_playlist_move( this, this->count - 1, clip );
+ mlt_events_unblock( properties, properties );
+ mlt_playlist_virtual_refresh( this );
+ mlt_producer_set_in_and_out( producer, in, out );
+ }
+ return producer;
+}
+
+/** Insert blank space.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the new blank section
+ * \param length the ending time of the new blank section (duration - 1)
+ */
+
+void mlt_playlist_insert_blank( mlt_playlist this, int clip, int length )
+{
+ if ( this != NULL && length >= 0 )
+ {
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+ mlt_events_block( properties, properties );
+ mlt_playlist_blank( this, length );
+ mlt_playlist_move( this, this->count - 1, clip );
+ mlt_events_unblock( properties, properties );
+ mlt_playlist_virtual_refresh( this );
+ }
+}
+
+/** Resize a blank entry.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position the time at which the blank entry exists relative to the start or end (negative) of the playlist.
+ * \param length the additional amount of blank frames to add
+ * \param find true to fist locate the blank after the clip at position
+ */
+void mlt_playlist_pad_blanks( mlt_playlist this, mlt_position position, int length, int find )
+{
+ if ( this != NULL && length != 0 )
+ {
+ int clip = mlt_playlist_get_clip_index_at( this, position );
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+ mlt_events_block( properties, properties );
+ if ( find && clip < this->count && !mlt_playlist_is_blank( this, clip ) )
+ clip ++;
+ if ( clip < this->count && mlt_playlist_is_blank( this, clip ) )
+ {
+ mlt_playlist_clip_info info;
+ mlt_playlist_get_clip_info( this, &info, clip );
+ if ( info.frame_out + length > info.frame_in )
+ mlt_playlist_resize_clip( this, clip, info.frame_in, info.frame_out + length );
+ else
+ mlt_playlist_remove( this, clip );
+ }
+ else if ( find && clip < this->count && length > 0 )
+ {
+ mlt_playlist_insert_blank( this, clip, length );
+ }
+ mlt_events_unblock( properties, properties );
+ mlt_playlist_virtual_refresh( this );
+ }
+}
+
+/** Insert a clip at a specific time.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position the time at which to insert
+ * \param producer the producer to insert
+ * \param mode true if you want to overwrite any blank section
+ * \return true if there was an error
+ */
+
+int mlt_playlist_insert_at( mlt_playlist this, mlt_position position, mlt_producer producer, int mode )
+{
+ int ret = this == NULL || position < 0 || producer == NULL;
+ if ( ret == 0 )
+ {
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+ int length = mlt_producer_get_playtime( producer );
+ int clip = mlt_playlist_get_clip_index_at( this, position );
+ mlt_playlist_clip_info info;
+ mlt_playlist_get_clip_info( this, &info, clip );
+ mlt_events_block( properties, this );
+ if ( clip < this->count && mlt_playlist_is_blank( this, clip ) )
+ {
+ // Split and move to new clip if need be
+ if ( position != info.start && mlt_playlist_split( this, clip, position - info.start - 1 ) == 0 )
+ mlt_playlist_get_clip_info( this, &info, ++ clip );
+
+ // Split again if need be
+ if ( length < info.frame_count )
+ mlt_playlist_split( this, clip, length - 1 );
+
+ // Remove
+ mlt_playlist_remove( this, clip );
+
+ // Insert
+ mlt_playlist_insert( this, producer, clip, -1, -1 );
+ ret = clip;
+ }
+ else if ( clip < this->count )
+ {
+ if ( position > info.start + info.frame_count / 2 )
+ clip ++;
+ if ( mode == 1 && clip < this->count && mlt_playlist_is_blank( this, clip ) )
+ {
+ mlt_playlist_get_clip_info( this, &info, clip );
+ if ( length < info.frame_count )
+ mlt_playlist_split( this, clip, length );
+ mlt_playlist_remove( this, clip );
+ }
+ mlt_playlist_insert( this, producer, clip, -1, -1 );
+ ret = clip;
+ }
+ else
+ {
+ if ( mode == 1 ) {
+ if ( position == info.start )
+ mlt_playlist_remove( this, clip );
+ else
+ mlt_playlist_blank( this, position - mlt_properties_get_int( properties, "length" ) - 1 );
+ }
+ mlt_playlist_append( this, producer );
+ ret = this->count - 1;
+ }
+ mlt_events_unblock( properties, this );
+ mlt_playlist_virtual_refresh( this );
+ }
+ else
+ {
+ ret = -1;
+ }
+ return ret;
+}
+
+/** Get the time at which the clip starts relative to the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \return the starting time
+ */
+
+int mlt_playlist_clip_start( mlt_playlist this, int clip )
+{
+ mlt_playlist_clip_info info;
+ if ( mlt_playlist_get_clip_info( this, &info, clip ) == 0 )
+ return info.start;
+ return clip < 0 ? 0 : mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( this ) );
+}
+
+/** Get the playable duration of the clip.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \return the duration of the playlist entry
+ */
+
+int mlt_playlist_clip_length( mlt_playlist this, int clip )
+{
+ mlt_playlist_clip_info info;
+ if ( mlt_playlist_get_clip_info( this, &info, clip ) == 0 )
+ return info.frame_count;
+ return 0;
+}
+
+/** Get the duration of a blank space.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param clip the index of the playlist entry
+ * \param bounded the maximum number of blank entries or 0 for all
+ * \return the duration of a blank section
+ */
+
+int mlt_playlist_blanks_from( mlt_playlist this, int clip, int bounded )
+{
+ int count = 0;
+ mlt_playlist_clip_info info;
+ if ( this != NULL && clip < this->count )
+ {
+ mlt_playlist_get_clip_info( this, &info, clip );
+ if ( mlt_playlist_is_blank( this, clip ) )
+ count += info.frame_count;
+ if ( bounded == 0 )
+ bounded = this->count;
+ for ( clip ++; clip < this->count && bounded >= 0; clip ++ )
+ {
+ mlt_playlist_get_clip_info( this, &info, clip );
+ if ( mlt_playlist_is_blank( this, clip ) )
+ count += info.frame_count;
+ else
+ bounded --;
+ }
+ }
+ return count;
+}
+
+/** Remove a portion of the playlist by time.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ * \param position the starting time
+ * \param length the duration of time to remove
+ * \return the new entry index at the position
+ */
+
+int mlt_playlist_remove_region( mlt_playlist this, mlt_position position, int length )
+{
+ int index = mlt_playlist_get_clip_index_at( this, position );
+ if ( index >= 0 && index < this->count )
+ {
+ mlt_properties properties = MLT_PLAYLIST_PROPERTIES( this );
+ int clip_start = mlt_playlist_clip_start( this, index );
+ int clip_length = mlt_playlist_clip_length( this, index );
+ int list_length = mlt_producer_get_playtime( MLT_PLAYLIST_PRODUCER( this ) );
+ mlt_events_block( properties, this );
+
+ if ( position + length > list_length )
+ length -= ( position + length - list_length );
+
+ if ( clip_start < position )
+ {
+ mlt_playlist_split( this, index ++, position - clip_start );
+ clip_length -= position - clip_start;
+ }
+
+ while( length > 0 )
+ {
+ if ( mlt_playlist_clip_length( this, index ) > length )
+ mlt_playlist_split( this, index, length );
+ length -= mlt_playlist_clip_length( this, index );
+ mlt_playlist_remove( this, index );
+ }
+
+ mlt_playlist_consolidate_blanks( this, 0 );
+ mlt_events_unblock( properties, this );
+ mlt_playlist_virtual_refresh( this );
+
+ // Just to be sure, we'll get the clip index again...
+ index = mlt_playlist_get_clip_index_at( this, position );
+ }
+ return index;
+}
+
+/** Not implemented
+ *
+ * \deprecated not implemented
+ * \public \memberof mlt_playlist_s
+ * \param this
+ * \param position
+ * \param length
+ * \param new_position
+ * \return
+ */
+
+int mlt_playlist_move_region( mlt_playlist this, mlt_position position, int length, int new_position )
+{
+ if ( this != NULL )
+ {
+ }
+ return 0;
+}
+
+/** Get the current frame.
+ *
+ * The implementation of the get_frame virtual function.
+ * \private \memberof mlt_playlist_s
+ * \param producer a producer
+ * \param frame a frame by reference
+ * \param index the time at which to get the frame
+ * \return false
+ */
+
+static int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index )
+{
+ // Check that we have a producer
+ if ( producer == NULL )
+ {
+ *frame = NULL;
+ return -1;
+ }
+
+ // Get this mlt_playlist
+ mlt_playlist this = producer->child;
+
+ // Need to ensure the frame is deinterlaced when repeating 1 frame
+ int progressive = 0;
+
+ // Get the real producer
+ mlt_service real = mlt_playlist_virtual_seek( this, &progressive );
+
+ // Check that we have a producer
+ if ( real == NULL )
+ {
+ *frame = mlt_frame_init( MLT_PRODUCER_SERVICE( producer ) );
+ return 0;
+ }
+
+ // Get the frame
+ if ( !mlt_properties_get_int( MLT_SERVICE_PROPERTIES( real ), "meta.fx_cut" ) )
+ {
+ mlt_service_get_frame( real, frame, index );
+ }
+ else
+ {
+ mlt_producer parent = mlt_producer_cut_parent( ( mlt_producer )real );
+ *frame = mlt_frame_init( MLT_PRODUCER_SERVICE( parent ) );
+ mlt_properties_set_int( MLT_FRAME_PROPERTIES( *frame ), "fx_cut", 1 );
+ mlt_frame_push_service( *frame, NULL );
+ mlt_frame_push_audio( *frame, NULL );
+ mlt_service_apply_filters( MLT_PRODUCER_SERVICE( parent ), *frame, 0 );
+ mlt_service_apply_filters( real, *frame, 0 );
+ mlt_deque_pop_front( MLT_FRAME_IMAGE_STACK( *frame ) );
+ mlt_deque_pop_front( MLT_FRAME_AUDIO_STACK( *frame ) );
+ }
+
+ // Check if we're at the end of the clip
+ mlt_properties properties = MLT_FRAME_PROPERTIES( *frame );
+ if ( mlt_properties_get_int( properties, "end_of_clip" ) )
+ mlt_playlist_virtual_set_out( this );
+
+ // Set the consumer progressive property
+ if ( progressive )
+ {
+ mlt_properties_set_int( properties, "consumer_deinterlace", progressive );
+ mlt_properties_set_int( properties, "test_audio", 1 );
+ }
+
+ // Check for notifier and call with appropriate argument
+ mlt_properties playlist_properties = MLT_PRODUCER_PROPERTIES( producer );
+ void ( *notifier )( void * ) = mlt_properties_get_data( playlist_properties, "notifier", NULL );
+ if ( notifier != NULL )
+ {
+ void *argument = mlt_properties_get_data( playlist_properties, "notifier_arg", NULL );
+ notifier( argument );
+ }
+
+ // Update position on the frame we're creating
+ mlt_frame_set_position( *frame, mlt_producer_frame( producer ) );
+
+ // Position ourselves on the next frame
+ mlt_producer_prepare_next( producer );
+
+ return 0;
+}
+
+/** Close the playlist.
+ *
+ * \public \memberof mlt_playlist_s
+ * \param this a playlist
+ */
+
+void mlt_playlist_close( mlt_playlist this )
+{
+ if ( this != NULL && mlt_properties_dec_ref( MLT_PLAYLIST_PROPERTIES( this ) ) <= 0 )
+ {
+ int i = 0;
+ this->parent.close = NULL;
+ for ( i = 0; i < this->count; i ++ )
+ {
+ mlt_event_close( this->list[ i ]->event );
+ mlt_producer_close( this->list[ i ]->producer );
+ free( this->list[ i ] );
+ }
+ mlt_producer_close( &this->blank );
+ mlt_producer_close( &this->parent );
+ free( this->list );
+ free( this );
+ }
}