2 * mlt_playlist.c -- playlist service class
3 * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
4 * Author: Charles Yates <charles.yates@pandora.be>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software Foundation,
18 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 #include "mlt_playlist.h"
24 #include "mlt_frame.h"
30 /** Virtual playlist entry.
35 mlt_producer producer
;
39 mlt_timecode playtime
;
43 /** Private definition.
48 struct mlt_producer_s parent
;
49 struct mlt_producer_s blank
;
53 playlist_entry
**list
;
56 /** Forward declarations
59 static int producer_get_frame( mlt_producer producer
, mlt_frame_ptr frame
, int index
);
64 mlt_playlist
mlt_playlist_init( )
66 mlt_playlist
this = calloc( sizeof( struct mlt_playlist_s
), 1 );
69 mlt_producer producer
= &this->parent
;
71 // Construct the producer
72 mlt_producer_init( producer
, this );
74 // Override the producer get_frame
75 producer
->get_frame
= producer_get_frame
;
78 mlt_producer_init( &this->blank
, NULL
);
80 // Indicate that this producer is a playlist
81 mlt_properties_set_data( mlt_playlist_properties( this ), "playlist", this, 0, NULL
, NULL
);
83 // Specify the eof condition
84 mlt_properties_set( mlt_playlist_properties( this ), "eof", "pause" );
90 /** Get the producer associated to this playlist.
93 mlt_producer
mlt_playlist_producer( mlt_playlist
this )
98 /** Get the service associated to this playlist.
101 mlt_service
mlt_playlist_service( mlt_playlist
this )
103 return mlt_producer_service( &this->parent
);
106 /** Get the propertues associated to this playlist.
109 mlt_properties
mlt_playlist_properties( mlt_playlist
this )
111 return mlt_producer_properties( &this->parent
);
114 static int mlt_playlist_virtual_refresh( mlt_playlist
this )
118 // Get the fps of the first producer
119 double fps
= mlt_properties_get_double( mlt_playlist_properties( this ), "first_fps" );
120 mlt_timecode playtime
= 0;
122 for ( i
= 0; i
< this->count
; i
++ )
125 mlt_producer producer
= this->list
[ i
]->producer
;
130 // Inherit it from the producer
131 fps
= mlt_producer_get_fps( producer
);
133 else if ( fps
!= mlt_properties_get_double( mlt_producer_properties( producer
), "fps" ) )
135 // Generate a warning for now - the following attempt to fix may fail
136 fprintf( stderr
, "Warning: fps mismatch on playlist producer %d\n", this->count
);
138 // It should be safe to impose fps on an image producer, but not necessarily safe for video
139 mlt_properties_set_double( mlt_producer_properties( producer
), "fps", fps
);
142 // Update the playtime for this clip
143 playtime
+= this->list
[ i
]->playtime
;
146 // Refresh all properties
147 mlt_properties_set_double( mlt_playlist_properties( this ), "first_fps", fps
);
148 mlt_properties_set_double( mlt_playlist_properties( this ), "fps", fps
== 0 ?
25 : fps
);
149 mlt_properties_set_timecode( mlt_playlist_properties( this ), "length", playtime
);
150 mlt_properties_set_timecode( mlt_playlist_properties( this ), "out", playtime
);
155 /** Append to the virtual playlist.
158 static int mlt_playlist_virtual_append( mlt_playlist
this, mlt_producer producer
, int64_t in
, int64_t out
)
160 double fps
= mlt_properties_get_double( mlt_playlist_properties( this ), "fps" );
161 double playtime
= ( double )( out
- in
+ 1 ) / fps
;
163 // Check that we have room
164 if ( this->count
>= this->size
)
167 this->list
= realloc( this->list
, ( this->size
+ 10 ) * sizeof( playlist_entry
* ) );
168 for ( i
= this->size
; i
< this->size
+ 10; i
++ )
169 this->list
[ i
] = NULL
;
173 this->list
[ this->count
] = calloc( sizeof( playlist_entry
), 1 );
174 this->list
[ this->count
]->producer
= producer
;
175 this->list
[ this->count
]->frame_in
= in
;
176 this->list
[ this->count
]->frame_out
= out
;
177 this->list
[ this->count
]->frame_count
= out
- in
+ 1;
178 this->list
[ this->count
]->playtime
= playtime
;
180 mlt_producer_set_speed( producer
, 0 );
184 return mlt_playlist_virtual_refresh( this );
187 /** Seek in the virtual playlist.
190 static mlt_producer
mlt_playlist_virtual_seek( mlt_playlist
this )
192 // Default producer to blank
193 mlt_producer producer
= NULL
;
195 // Map playlist position to real producer in virtual playlist
196 mlt_timecode pos
= mlt_producer_position( &this->parent
);
197 int64_t position
= mlt_producer_frame_position( &this->parent
, pos
);
200 mlt_properties properties
= mlt_playlist_properties( this );
201 char *eof
= mlt_properties_get( properties
, "eof" );
203 // Loop through the virtual playlist
206 for ( i
= 0; i
< this->count
; i
++ )
208 // Increment the total
209 total
+= this->list
[ i
]->frame_count
;
211 if ( position
< this->list
[ i
]->frame_count
)
213 // Found it, now break
214 producer
= this->list
[ i
]->producer
;
219 // Decrement position by length of this entry
220 position
-= this->list
[ i
]->frame_count
;
224 // Seek in real producer to relative position
225 if ( producer
!= NULL
)
227 position
+= this->list
[ i
]->frame_in
;
228 position
+= mlt_producer_frame_position( producer
, mlt_producer_get_in( producer
) );
229 mlt_producer_seek_frame( producer
, position
);
231 else if ( !strcmp( eof
, "pause" ) && total
> 0 )
233 playlist_entry
*entry
= this->list
[ this->count
- 1 ];
234 mlt_producer this_producer
= mlt_playlist_producer( this );
235 mlt_producer_seek_frame( this_producer
, total
- 1 );
236 producer
= entry
->producer
;
237 position
= mlt_producer_frame_position( producer
, mlt_producer_get_in( producer
) );
238 mlt_producer_seek_frame( producer
, position
+ entry
->frame_out
);
239 mlt_producer_set_speed( producer
, 0 );
243 mlt_producer_seek( mlt_playlist_producer( this ), 0 );
244 producer
= &this->blank
;
250 static mlt_producer
mlt_playlist_virtual_set_out( mlt_playlist
this )
252 // Default producer to blank
253 mlt_producer producer
= &this->blank
;
255 // Map playlist position to real producer in virtual playlist
256 mlt_timecode pos
= mlt_producer_position( &this->parent
);
257 int64_t position
= mlt_producer_frame_position( &this->parent
, pos
);
259 // Loop through the virtual playlist
262 for ( i
= 0; i
< this->count
; i
++ )
264 if ( position
< this->list
[ i
]->frame_count
)
266 // Found it, now break
267 producer
= this->list
[ i
]->producer
;
272 // Decrement position by length of this entry
273 position
-= this->list
[ i
]->frame_count
;
277 // Seek in real producer to relative position
278 if ( i
< this->count
)
280 // Update the playtime for the changed clip (hmmm)
281 this->list
[ i
]->frame_count
= position
+ 1;
282 this->list
[ i
]->frame_out
= position
- this->list
[ i
]->frame_in
;
284 // Refresh the playlist
285 mlt_playlist_virtual_refresh( this );
291 int mlt_playlist_current_clip( mlt_playlist
this )
293 // Map playlist position to real producer in virtual playlist
294 mlt_timecode pos
= mlt_producer_position( &this->parent
);
295 int64_t position
= mlt_producer_frame_position( &this->parent
, pos
);
297 // Loop through the virtual playlist
300 for ( i
= 0; i
< this->count
; i
++ )
302 if ( position
< this->list
[ i
]->frame_count
)
304 // Found it, now break
309 // Decrement position by length of this entry
310 position
-= this->list
[ i
]->frame_count
;
317 mlt_producer
mlt_playlist_current( mlt_playlist
this )
319 int i
= mlt_playlist_current_clip( this );
320 if ( i
< this->count
)
321 return this->list
[ i
]->producer
;
326 /** Get the timecode which corresponds to the start of the next clip.
329 mlt_timecode
mlt_playlist_clip( mlt_playlist
this, mlt_whence whence
, int index
)
331 int64_t position
= 0;
332 int absolute_clip
= index
;
335 // Determine the absolute clip
338 case mlt_whence_relative_start
:
339 absolute_clip
= index
;
342 case mlt_whence_relative_current
:
343 absolute_clip
= mlt_playlist_current_clip( this ) + index
;
346 case mlt_whence_relative_end
:
347 absolute_clip
= this->count
- index
;
351 // Check that we're in a valid range
352 if ( absolute_clip
< 0 )
354 else if ( absolute_clip
> this->count
)
355 absolute_clip
= this->count
;
357 // Now determine the timecode
358 for ( i
= 0; i
< absolute_clip
; i
++ )
359 position
+= this->list
[ i
]->frame_count
;
361 return mlt_producer_time( &this->parent
, position
);
364 int mlt_playlist_get_clip_info( mlt_playlist
this, mlt_playlist_clip_info
*info
, int index
)
366 int error
= index
< 0 || index
>= this->count
;
367 memset( info
, 0, sizeof( mlt_playlist_clip_info
) );
370 mlt_producer producer
= this->list
[ index
]->producer
;
371 mlt_properties properties
= mlt_producer_properties( producer
);
372 info
->producer
= producer
;
373 info
->start
= mlt_playlist_clip( this, mlt_whence_relative_start
, index
);
374 info
->resource
= mlt_properties_get( properties
, "resource" );
375 info
->frame_in
= this->list
[ index
]->frame_in
;
376 info
->in
= mlt_producer_time( producer
, info
->frame_in
);
377 info
->frame_out
= this->list
[ index
]->frame_out
;
378 info
->out
= mlt_producer_time( producer
, info
->frame_out
);
379 info
->playtime
= this->list
[ index
]->playtime
;
380 info
->length
= mlt_producer_get_length( producer
);
381 info
->fps
= mlt_producer_get_fps( producer
);
386 /** Get number of clips in the playlist.
389 int mlt_playlist_count( mlt_playlist
this )
394 /** Clear the playlist.
397 int mlt_playlist_clear( mlt_playlist
this )
400 mlt_properties_set_double( mlt_playlist_properties( this ), "first_fps", 0 );
401 return mlt_playlist_virtual_refresh( this );
404 /** Append a producer to the playlist.
407 int mlt_playlist_append( mlt_playlist
this, mlt_producer producer
)
409 // Append to virtual list
410 int64_t in
= mlt_producer_frame_position( producer
, mlt_producer_get_in( producer
) );
411 int64_t out
= mlt_producer_frame_position( producer
, mlt_producer_get_out( producer
) );
412 return mlt_playlist_virtual_append( this, producer
, 0, out
- in
);
415 /** Append a producer to the playlist with in/out points.
418 int mlt_playlist_append_io( mlt_playlist
this, mlt_producer producer
, double in
, double out
)
420 // Append to virtual list
421 if ( in
!= -1 && out
!= -1 )
423 int64_t fin
= mlt_producer_frame_position( producer
, in
);
424 int64_t fout
= mlt_producer_frame_position( producer
, out
);
425 return mlt_playlist_virtual_append( this, producer
, 0, fout
- fin
);
429 return mlt_playlist_append( this, producer
);
433 /** Append a blank to the playlist of a given length.
436 int mlt_playlist_blank( mlt_playlist
this, mlt_timecode length
)
438 // Append to the virtual list
439 int64_t fout
= mlt_producer_frame_position( &this->blank
, length
);
440 return mlt_playlist_virtual_append( this, &this->blank
, 0, fout
);
443 /** Insert a producer into the playlist.
446 int mlt_playlist_insert( mlt_playlist
this, mlt_producer producer
, int where
, mlt_timecode in
, mlt_timecode out
)
451 int mlt_playlist_remove( mlt_playlist
this, int where
)
456 int mlt_playlist_move( mlt_playlist
this, int from
, int to
)
461 int mlt_playlist_resize_clip( mlt_playlist
this, int clip
, mlt_timecode in
, mlt_timecode out
)
463 int error
= clip
< 0 || clip
>= this->count
;
466 playlist_entry
*entry
= this->list
[ clip
];
467 mlt_producer producer
= entry
->producer
;
471 if ( out
<= -1 || out
>= mlt_producer_get_out( producer
) )
472 out
= mlt_producer_get_out( producer
);
481 int64_t fin
= mlt_producer_frame_position( producer
, in
);
482 int64_t fout
= mlt_producer_frame_position( producer
, out
);
484 entry
->frame_in
= fin
;
485 entry
->frame_out
= fout
;
486 entry
->frame_count
= fout
- fin
+ 1;
487 entry
->playtime
= out
- in
;
488 mlt_playlist_virtual_refresh( this );
493 /** Get the current frame.
496 static int producer_get_frame( mlt_producer producer
, mlt_frame_ptr frame
, int index
)
498 // Get this mlt_playlist
499 mlt_playlist
this = producer
->child
;
501 // Get the real producer
502 mlt_producer real
= mlt_playlist_virtual_seek( this );
505 mlt_service_get_frame( mlt_producer_service( real
), frame
, index
);
507 // Check if we're at the end of the clip
508 mlt_properties properties
= mlt_frame_properties( *frame
);
509 if ( mlt_properties_get_int( properties
, "end_of_clip" ) )
510 mlt_playlist_virtual_set_out( this );
512 // Check for notifier and call with appropriate argument
513 mlt_properties playlist_properties
= mlt_producer_properties( producer
);
514 void ( *notifier
)( void * ) = mlt_properties_get_data( playlist_properties
, "notifier", NULL
);
515 if ( notifier
!= NULL
)
517 void *argument
= mlt_properties_get_data( playlist_properties
, "notifier_arg", NULL
);
518 notifier( argument
);
521 // Update timecode on the frame we're creating
522 mlt_frame_set_timecode( *frame
, mlt_producer_position( producer
) );
524 // Position ourselves on the next frame
525 mlt_producer_prepare_next( producer
);
530 /** Close the playlist.
533 void mlt_playlist_close( mlt_playlist
this )
535 mlt_producer_close( &this->parent
);
536 mlt_producer_close( &this->blank
);