]> git.sesse.net Git - mlt/blobdiff - src/framework/mlt_playlist.h
Restrict auto-profile frame rate to a sane value.
[mlt] / src / framework / mlt_playlist.h
index f5e02d323891e605e0e1adddb6103b0cd57d59f6..04eeccb85415786c706df3895c33006f176b3f2f 100644 (file)
@@ -1,8 +1,9 @@
 /**
  * \file mlt_playlist.h
  * \brief playlist service class
+ * \see mlt_playlist_s
  *
- * Copyright (C) 2003-2008 Ushodaya Enterprises Limited
+ * Copyright (C) 2003-2009 Ushodaya Enterprises Limited
  * \author Charles Yates <charles.yates@pandora.be>
  *
  * This library is free software; you can redistribute it and/or
@@ -25,7 +26,7 @@
 
 #include "mlt_producer.h"
 
-/** \brief structure for returning clip information
+/** \brief structure for returning clip information from a playlist entry
  */
 
 typedef struct
@@ -62,6 +63,11 @@ typedef struct playlist_entry_s playlist_entry;
  * which is a way to add filters as a playlist entry - useful only in a multitrack. See FxCut on the wiki.
  * \properties \em mix_in
  * \properties \em mix_out
+ * \properties \em hide Set to 1 to hide the video (make it an audio-only track),
+ * 2 to hide the audio (make it a video-only track), or 3 to hide audio and video (hidden track).
+ * This property only applies when using a multitrack or transition.
+ * \event \em playlist-next The playlist fires this when it moves to the next item in the list.
+ * The listener receives one argument that is the index of the entry that just completed.
  */
 
 struct mlt_playlist_s
@@ -79,6 +85,7 @@ struct mlt_playlist_s
 #define MLT_PLAYLIST_PROPERTIES( playlist )    MLT_SERVICE_PROPERTIES( MLT_PLAYLIST_SERVICE( playlist ) )
 
 extern mlt_playlist mlt_playlist_init( );
+extern mlt_playlist mlt_playlist_new( mlt_profile profile );
 extern mlt_producer mlt_playlist_producer( mlt_playlist self );
 extern mlt_service mlt_playlist_service( mlt_playlist self );
 extern mlt_properties mlt_playlist_properties( mlt_playlist self );
@@ -86,7 +93,8 @@ extern int mlt_playlist_count( mlt_playlist self );
 extern int mlt_playlist_clear( mlt_playlist self );
 extern int mlt_playlist_append( mlt_playlist self, mlt_producer producer );
 extern int mlt_playlist_append_io( mlt_playlist self, mlt_producer producer, mlt_position in, mlt_position out );
-extern int mlt_playlist_blank( mlt_playlist self, mlt_position length );
+extern int mlt_playlist_blank( mlt_playlist self, mlt_position out );
+extern int mlt_playlist_blank_time( mlt_playlist self, const char *length );
 extern mlt_position mlt_playlist_clip( mlt_playlist self, mlt_whence whence, int index );
 extern int mlt_playlist_current_clip( mlt_playlist self );
 extern mlt_producer mlt_playlist_current( mlt_playlist self );
@@ -100,6 +108,8 @@ extern int mlt_playlist_split( mlt_playlist self, int clip, mlt_position positio
 extern int mlt_playlist_split_at( mlt_playlist self, mlt_position position, int left );
 extern int mlt_playlist_join( mlt_playlist self, int clip, int count, int merge );
 extern int mlt_playlist_mix( mlt_playlist self, int clip, int length, mlt_transition transition );
+extern int mlt_playlist_mix_in( mlt_playlist self, int clip, int length );
+extern int mlt_playlist_mix_out( mlt_playlist self, int clip, int length );
 extern int mlt_playlist_mix_add( mlt_playlist self, int clip, mlt_transition transition );
 extern mlt_producer mlt_playlist_get_clip( mlt_playlist self, int clip );
 extern mlt_producer mlt_playlist_get_clip_at( mlt_playlist self, mlt_position position );
@@ -108,7 +118,7 @@ extern int mlt_playlist_clip_is_mix( mlt_playlist self, int clip );
 extern void mlt_playlist_consolidate_blanks( mlt_playlist self, int keep_length );
 extern int mlt_playlist_is_blank( mlt_playlist self, int clip );
 extern int mlt_playlist_is_blank_at( mlt_playlist self, mlt_position position );
-extern void mlt_playlist_insert_blank( mlt_playlist self, int clip, int length );
+extern void mlt_playlist_insert_blank( mlt_playlist self, int clip, int out );
 extern void mlt_playlist_pad_blanks( mlt_playlist self, mlt_position position, int length, int find );
 extern mlt_producer mlt_playlist_replace_with_blank( mlt_playlist self, int clip );
 extern int mlt_playlist_insert_at( mlt_playlist self, mlt_position position, mlt_producer producer, int mode );