2 * melt.c -- MLT command line utility
3 * Copyright (C) 2002-2011 Ushodaya Enterprises Limited
4 * Authors: Charles Yates <charles.yates@pandora.be>
5 * Dan Dennedy <dan@dennedy.org>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software Foundation,
19 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
32 #include <framework/mlt.h>
34 #if defined(__DARWIN__) || defined(WIN32)
40 static void transport_action( mlt_producer producer, char *value )
42 mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
43 mlt_multitrack multitrack = mlt_properties_get_data( properties, "multitrack", NULL );
44 mlt_consumer consumer = mlt_properties_get_data( properties, "transport_consumer", NULL );
46 mlt_properties_set_int( properties, "stats_off", 1 );
48 if ( strlen( value ) == 1 )
53 mlt_properties_set_int( properties, "done", 1 );
56 mlt_producer_set_speed( producer, 1 );
57 mlt_producer_seek( producer, 0 );
60 mlt_producer_set_speed( producer, -10 );
63 mlt_producer_set_speed( producer, -5 );
66 mlt_producer_set_speed( producer, -2 );
69 mlt_producer_set_speed( producer, -1 );
72 mlt_producer_set_speed( producer, 0 );
76 mlt_producer_set_speed( producer, 1 );
79 mlt_producer_set_speed( producer, 2 );
82 mlt_producer_set_speed( producer, 5 );
85 mlt_producer_set_speed( producer, 10 );
88 if ( multitrack != NULL )
91 mlt_position last = -1;
92 fprintf( stderr, "\n" );
93 for ( i = 0; 1; i ++ )
95 mlt_position time = mlt_multitrack_clip( multitrack, mlt_whence_relative_start, i );
99 fprintf( stderr, "%d: %d\n", i, (int)time );
105 if ( multitrack != NULL )
107 mlt_position time = mlt_multitrack_clip( multitrack, mlt_whence_relative_current, 0 );
108 mlt_producer_seek( producer, time );
112 if ( producer != NULL )
114 mlt_position position = mlt_producer_position( producer );
115 mlt_producer_seek( producer, position - ( mlt_producer_get_fps( producer ) * 60 ) );
119 if ( producer != NULL )
121 mlt_position position = mlt_producer_position( producer );
122 mlt_producer_set_speed( producer, 0 );
123 mlt_producer_seek( producer, position - 1 );
127 if ( multitrack != NULL )
129 mlt_position time = mlt_multitrack_clip( multitrack, mlt_whence_relative_current, 1 );
130 mlt_producer_seek( producer, time );
134 if ( multitrack != NULL )
136 mlt_position time = mlt_multitrack_clip( multitrack, mlt_whence_relative_current, -1 );
137 mlt_producer_seek( producer, time );
141 if ( producer != NULL )
143 mlt_position position = mlt_producer_position( producer );
144 if ( mlt_producer_get_speed( producer ) != 0 )
145 mlt_producer_set_speed( producer, 0 );
147 mlt_producer_seek( producer, position + 1 );
151 if ( producer != NULL )
153 mlt_position position = mlt_producer_position( producer );
154 mlt_producer_seek( producer, position + ( mlt_producer_get_fps( producer ) * 60 ) );
159 mlt_properties_set_int( MLT_CONSUMER_PROPERTIES( consumer ), "refresh", 1 );
162 mlt_properties_set_int( properties, "stats_off", 0 );
165 static mlt_consumer create_consumer( mlt_profile profile, char *id )
167 char *myid = id ? strdup( id ) : NULL;
168 char *arg = myid ? strchr( myid, ':' ) : NULL;
171 mlt_consumer consumer = mlt_factory_consumer( profile, myid, arg );
172 if ( consumer != NULL )
174 mlt_properties properties = MLT_CONSUMER_PROPERTIES( consumer );
175 mlt_properties_set_data( properties, "transport_callback", transport_action, 0, NULL, NULL );
182 static void load_consumer( mlt_consumer *consumer, mlt_profile profile, int argc, char **argv )
185 for ( i = 1; i < argc; i ++ )
187 if ( !strcmp( argv[ i ], "-consumer" ) )
190 mlt_consumer_close( *consumer );
191 *consumer = create_consumer( profile, argv[ ++ i ] );
194 mlt_properties properties = MLT_CONSUMER_PROPERTIES( *consumer );
195 while ( argv[ i + 1 ] != NULL && strstr( argv[ i + 1 ], "=" ) )
196 mlt_properties_parse( properties, argv[ ++ i ] );
202 #if defined(__DARWIN__) || defined(WIN32)
204 static void event_handling( mlt_producer producer, mlt_consumer consumer )
208 while ( SDL_PollEvent( &event ) )
213 mlt_properties_set_int( MLT_PRODUCER_PROPERTIES( consumer ), "done", 1 );
217 if ( event.key.keysym.unicode < 0x80 && event.key.keysym.unicode > 0 )
219 char keyboard[ 2 ] = { event.key.keysym.unicode, 0 };
220 transport_action( producer, keyboard );
229 static void transport( mlt_producer producer, mlt_consumer consumer )
231 mlt_properties properties = MLT_PRODUCER_PROPERTIES( producer );
232 int silent = mlt_properties_get_int( MLT_CONSUMER_PROPERTIES( consumer ), "silent" );
233 int progress = mlt_properties_get_int( MLT_CONSUMER_PROPERTIES( consumer ), "progress" );
234 struct timespec tm = { 0, 40000 };
235 int total_length = mlt_producer_get_length( producer );
236 int last_position = 0;
238 if ( mlt_properties_get_int( properties, "done" ) == 0 && !mlt_consumer_is_stopped( consumer ) )
240 if ( !silent && !progress )
244 fprintf( stderr, "+-----+ +-----+ +-----+ +-----+ +-----+ +-----+ +-----+ +-----+ +-----+\n" );
245 fprintf( stderr, "|1=-10| |2= -5| |3= -2| |4= -1| |5= 0| |6= 1| |7= 2| |8= 5| |9= 10|\n" );
246 fprintf( stderr, "+-----+ +-----+ +-----+ +-----+ +-----+ +-----+ +-----+ +-----+ +-----+\n" );
248 fprintf( stderr, "+---------------------------------------------------------------------+\n" );
249 fprintf( stderr, "| H = back 1 minute, L = forward 1 minute |\n" );
250 fprintf( stderr, "| h = previous frame, l = next frame |\n" );
251 fprintf( stderr, "| g = start of clip, j = next clip, k = previous clip |\n" );
252 fprintf( stderr, "| 0 = restart, q = quit, space = play |\n" );
253 fprintf( stderr, "+---------------------------------------------------------------------+\n" );
256 while( mlt_properties_get_int( properties, "done" ) == 0 && !mlt_consumer_is_stopped( consumer ) )
258 int value = ( silent || progress )? -1 : term_read( );
262 char string[ 2 ] = { value, 0 };
263 transport_action( producer, string );
266 #if defined(__DARWIN__) || defined(WIN32)
267 event_handling( producer, consumer );
270 if ( !silent && mlt_properties_get_int( properties, "stats_off" ) == 0 )
274 int current_position = mlt_producer_position( producer );
275 if ( current_position > last_position )
277 fprintf( stderr, "Current Frame: %10d, percentage: %10d\r",
278 current_position, 100 * current_position / total_length );
279 last_position = current_position;
284 fprintf( stderr, "Current Position: %10d\r", (int)mlt_consumer_position( consumer ) );
288 if ( silent || progress )
289 nanosleep( &tm, NULL );
293 fprintf( stderr, "\n" );
297 static void show_usage( char *program_name )
300 "Usage: %s [options] [producer [name=value]* ]+\n"
302 " -attach filter[:arg] [name=value]* Attach a filter to the output\n"
303 " -attach-cut filter[:arg] [name=value]* Attach a filter to a cut\n"
304 " -attach-track filter[:arg] [name=value]* Attach a filter to a track\n"
305 " -attach-clip filter[:arg] [name=value]* Attach a filter to a producer\n"
306 " -audio-track | -hide-video Add an audio-only track\n"
307 " -blank frames Add blank silence to a track\n"
308 " -consumer id[:arg] [name=value]* Set the consumer (sink)\n"
309 " -debug Set the logging level to debug\n"
310 " -filter filter[:arg] [name=value]* Add a filter to the current track\n"
311 " -group [name=value]* Apply properties repeatedly\n"
312 " -help Show this message\n"
313 " -join clips Join multiple clips into one cut\n"
314 " -mix length Add a mix between the last two cuts\n"
315 " -mixer transition Add a transition to the mix\n"
316 " -null-track | -hide-track Add a hidden track\n"
317 " -profile name Set the processing settings\n"
318 " -progress Display progress along with position\n"
319 " -remove Remove the most recent cut\n"
320 " -repeat times Repeat the last cut\n"
321 " -query List all of the registered services\n"
322 " -query \"consumers\" | \"consumer\"=id List consumers or show info about one\n"
323 " -query \"filters\" | \"filter\"=id List filters or show info about one\n"
324 " -query \"producers\" | \"producer\"=id List producers or show info about one\n"
325 " -query \"transitions\" | \"transition\"=id List transitions, show info about one\n"
326 " -query \"profiles\" | \"profile\"=id List profiles, show info about one\n"
327 " -serialise [filename] Write the commands to a text file\n"
328 " -silent Do not display position/transport\n"
329 " -split relative-frame Split the last cut into two cuts\n"
330 " -swap Rearrange the last two cuts\n"
331 " -track Add a track\n"
332 " -transition id[:arg] [name=value]* Add a transition\n"
333 " -verbose Set the logging level to verbose\n"
334 " -version Show the version and copyright\n"
335 " -video-track | -hide-audio Add a video-only track\n"
336 "For more help: <http://www.mltframework.org/>\n",
337 basename( program_name ) );
340 static void guess_profile( mlt_producer melt, mlt_profile profile )
344 mlt_image_format fmt = mlt_image_yuv422;
346 int w = profile->width;
347 int h = profile->height;
349 if ( ! mlt_service_get_frame( MLT_PRODUCER_SERVICE(melt), &fr, 0 ) && fr )
351 mlt_properties_set_double( MLT_FRAME_PROPERTIES( fr ), "consumer_aspect_ratio", mlt_profile_sar( profile ) );
352 if ( ! mlt_frame_get_image( fr, &buffer, &fmt, &w, &h, 0 ) )
354 // Some source properties are not exposed until after the first get_image call.
355 mlt_frame_close( fr );
356 mlt_service_get_frame( MLT_PRODUCER_SERVICE(melt), &fr, 0 );
357 p = MLT_FRAME_PROPERTIES( fr );
358 // mlt_properties_dump(p, stderr);
359 if ( mlt_properties_get_int( p, "meta.media.frame_rate_den" ) && mlt_properties_get_int( p, "meta.media.sample_aspect_den" ) )
361 profile->width = mlt_properties_get_int( p, "meta.media.width" );
362 profile->height = mlt_properties_get_int( p, "meta.media.height" );
363 profile->progressive = mlt_properties_get_int( p, "meta.media.progressive" );
364 profile->frame_rate_num = mlt_properties_get_int( p, "meta.media.frame_rate_num" );
365 profile->frame_rate_den = mlt_properties_get_int( p, "meta.media.frame_rate_den" );
366 // AVCHD is mis-reported as double frame rate.
367 if ( profile->progressive == 0 && (
368 profile->frame_rate_num / profile->frame_rate_den == 50 ||
369 profile->frame_rate_num / profile->frame_rate_den == 59 ) )
370 profile->frame_rate_num /= 2;
371 profile->sample_aspect_num = mlt_properties_get_int( p, "meta.media.sample_aspect_num" );
372 profile->sample_aspect_den = mlt_properties_get_int( p, "meta.media.sample_aspect_den" );
373 profile->colorspace = mlt_properties_get_int( p, "meta.media.colorspace" );
374 profile->display_aspect_num = (int) ( (double) profile->sample_aspect_num * profile->width / profile->sample_aspect_den + 0.5 );
375 profile->display_aspect_den = profile->height;
376 free( profile->description );
377 profile->description = strdup( "automatic" );
378 profile->is_explicit = 0;
382 mlt_frame_close( fr );
383 mlt_producer_seek( melt, 0 );
386 static void query_metadata( mlt_repository repo, mlt_service_type type, const char *typestr, char *id )
388 mlt_properties metadata = mlt_repository_metadata( repo, type, id );
391 char *s = mlt_properties_serialise_yaml( metadata );
392 fprintf( stderr, "%s", s );
397 fprintf( stderr, "# No metadata for %s \"%s\"\n", typestr, id );
401 static void query_services( mlt_repository repo, mlt_service_type type )
403 mlt_properties services = NULL;
404 const char *typestr = NULL;
408 services = mlt_repository_consumers( repo );
409 typestr = "consumers";
412 services = mlt_repository_filters( repo );
416 services = mlt_repository_producers( repo );
417 typestr = "producers";
419 case transition_type:
420 services = mlt_repository_transitions( repo );
421 typestr = "transitions";
426 fprintf( stderr, "---\n%s:\n", typestr );
430 for ( j = 0; j < mlt_properties_count( services ); j++ )
431 fprintf( stderr, " - %s\n", mlt_properties_get_name( services, j ) );
433 fprintf( stderr, "...\n" );
436 static void query_profiles()
438 mlt_properties profiles = mlt_profile_list();
439 fprintf( stderr, "---\nprofiles:\n" );
443 for ( j = 0; j < mlt_properties_count( profiles ); j++ )
444 fprintf( stderr, " - %s\n", mlt_properties_get_name( profiles, j ) );
446 fprintf( stderr, "...\n" );
447 mlt_properties_close( profiles );
450 static void query_profile( const char *id )
452 mlt_properties profiles = mlt_profile_list();
453 mlt_properties profile = mlt_properties_get_data( profiles, id, NULL );
456 char *s = mlt_properties_serialise_yaml( profile );
457 fprintf( stderr, "%s", s );
462 fprintf( stderr, "# No metadata for profile \"%s\"\n", id );
464 mlt_properties_close( profiles );
467 static void on_fatal_error( mlt_properties owner, mlt_consumer consumer )
469 mlt_consumer_stop( consumer );
470 exit( EXIT_FAILURE );
473 int main( int argc, char **argv )
476 mlt_consumer consumer = NULL;
477 mlt_producer melt = NULL;
480 mlt_profile profile = NULL;
483 mlt_profile backup_profile;
485 // Construct the factory
486 mlt_repository repo = mlt_factory_init( NULL );
492 for ( i = 1; i < argc; i ++ )
494 // Check for serialisation switch
495 if ( !strcmp( argv[ i ], "-serialise" ) )
498 if ( name != NULL && strstr( name, ".melt" ) )
499 store = fopen( name, "w" );
502 if ( name == NULL || name[0] == '-' )
507 // Look for the profile option
508 else if ( !strcmp( argv[ i ], "-profile" ) )
510 const char *pname = argv[ ++ i ];
511 if ( pname && pname[0] != '-' )
512 profile = mlt_profile_init( pname );
514 else if ( !strcmp( argv[ i ], "-progress" ) )
518 // Look for the query option
519 else if ( !strcmp( argv[ i ], "-query" ) )
521 const char *pname = argv[ ++ i ];
522 if ( pname && pname[0] != '-' )
524 if ( !strcmp( pname, "consumers" ) || !strcmp( pname, "consumer" ) )
525 query_services( repo, consumer_type );
526 else if ( !strcmp( pname, "filters" ) || !strcmp( pname, "filter" ) )
527 query_services( repo, filter_type );
528 else if ( !strcmp( pname, "producers" ) || !strcmp( pname, "producer" ) )
529 query_services( repo, producer_type );
530 else if ( !strcmp( pname, "transitions" ) || !strcmp( pname, "transition" ) )
531 query_services( repo, transition_type );
532 else if ( !strcmp( pname, "profiles" ) || !strcmp( pname, "profile" ) )
535 else if ( !strncmp( pname, "consumer=", 9 ) )
536 query_metadata( repo, consumer_type, "consumer", strchr( pname, '=' ) + 1 );
537 else if ( !strncmp( pname, "filter=", 7 ) )
538 query_metadata( repo, filter_type, "filter", strchr( pname, '=' ) + 1 );
539 else if ( !strncmp( pname, "producer=", 9 ) )
540 query_metadata( repo, producer_type, "producer", strchr( pname, '=' ) + 1 );
541 else if ( !strncmp( pname, "transition=", 11 ) )
542 query_metadata( repo, transition_type, "transition", strchr( pname, '=' ) + 1 );
543 else if ( !strncmp( pname, "profile=", 8 ) )
544 query_profile( strchr( pname, '=' ) + 1 );
551 query_services( repo, consumer_type );
552 query_services( repo, filter_type );
553 query_services( repo, producer_type );
554 query_services( repo, transition_type );
555 fprintf( stderr, "# You can query the metadata for a specific service using:\n"
556 "# -query <type>=<identifer>\n"
557 "# where <type> is one of: consumer, filter, producer, or transition.\n" );
561 else if ( !strcmp( argv[ i ], "-silent" ) )
565 else if ( !strcmp( argv[ i ], "-verbose" ) )
567 mlt_log_set_level( MLT_LOG_VERBOSE );
569 else if ( !strcmp( argv[ i ], "-version" ) || !strcmp( argv[ i ], "--version" ) )
571 fprintf( stderr, "MLT %s " VERSION "\n"
572 "Copyright (C) 2002-2011 Ushodaya Enterprises Limited\n"
573 "<http://www.mltframework.org/>\n"
574 "This is free software; see the source for copying conditions. There is NO\n"
575 "warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n",
576 basename( argv[0] ) );
579 else if ( !strcmp( argv[ i ], "-debug" ) )
581 mlt_log_set_level( MLT_LOG_DEBUG );
585 // Create profile if not set explicitly
586 if ( getenv( "MLT_PROFILE" ) )
587 profile = mlt_profile_init( NULL );
588 if ( profile == NULL )
589 profile = mlt_profile_init( NULL );
591 profile->is_explicit = 1;
593 // Look for the consumer option to load profile settings from consumer properties
594 backup_profile = mlt_profile_clone( profile );
595 load_consumer( &consumer, profile, argc, argv );
597 // If the consumer changed the profile, then it is explicit.
598 if ( backup_profile && !profile->is_explicit && (
599 profile->width != backup_profile->width ||
600 profile->height != backup_profile->height ||
601 profile->sample_aspect_num != backup_profile->sample_aspect_num ||
602 profile->sample_aspect_den != backup_profile->sample_aspect_den ||
603 profile->frame_rate_den != backup_profile->frame_rate_den ||
604 profile->frame_rate_num != backup_profile->frame_rate_num ||
605 profile->colorspace != backup_profile->colorspace ) )
606 profile->is_explicit = 1;
607 mlt_profile_close( backup_profile );
611 melt = mlt_factory_producer( profile, "melt", &argv[ 1 ] );
615 // Generate an automatic profile if needed.
616 if ( ! profile->is_explicit )
618 guess_profile( melt, profile );
619 mlt_producer_close( melt );
620 melt = mlt_factory_producer( profile, "melt", &argv[ 1 ] );
623 // Reload the consumer with the fully qualified profile.
624 // The producer or guess_profile could have changed the profile.
625 load_consumer( &consumer, profile, argc, argv );
627 // If we have no consumer, default to sdl
628 if ( store == NULL && consumer == NULL )
629 consumer = create_consumer( profile, NULL );
632 // Set transport properties on consumer and produder
633 if ( consumer != NULL && melt != NULL )
635 mlt_properties_set_data( MLT_CONSUMER_PROPERTIES( consumer ), "transport_producer", melt, 0, NULL, NULL );
636 mlt_properties_set_data( MLT_PRODUCER_PROPERTIES( melt ), "transport_consumer", consumer, 0, NULL, NULL );
638 mlt_properties_set_int( MLT_CONSUMER_PROPERTIES( consumer ), "progress", is_progress );
640 mlt_properties_set_int( MLT_CONSUMER_PROPERTIES( consumer ), "silent", is_silent );
643 if ( argc > 1 && melt != NULL && mlt_producer_get_length( melt ) > 0 )
645 // Parse the arguments
646 for ( i = 1; i < argc; i ++ )
648 if ( !strcmp( argv[ i ], "-serialise" ) )
650 if ( store != stdout )
656 fprintf( store, "%s\n", argv[ i ] );
660 while ( argv[ i ] != NULL && argv[ i ][ 0 ] != '-' )
663 fprintf( store, "%s\n", argv[ i ] );
671 if ( consumer != NULL && store == NULL )
673 // Get melt's properties
674 mlt_properties melt_props = MLT_PRODUCER_PROPERTIES( melt );
676 // Get the last group
677 mlt_properties group = mlt_properties_get_data( melt_props, "group", 0 );
679 // Apply group settings
680 mlt_properties properties = MLT_CONSUMER_PROPERTIES( consumer );
681 mlt_properties_inherit( properties, group );
683 // Connect consumer to melt
684 mlt_consumer_connect( consumer, MLT_PRODUCER_SERVICE( melt ) );
686 // Start the consumer
687 mlt_events_listen( properties, consumer, "consumer-fatal-error", ( mlt_listener )on_fatal_error );
688 if ( mlt_consumer_start( consumer ) == 0 )
690 // Transport functionality
691 transport( melt, consumer );
694 mlt_consumer_stop( consumer );
697 else if ( store != NULL && store != stdout && name != NULL )
699 fprintf( stderr, "Project saved as %s.\n", name );
705 show_usage( argv[0] );
708 // Close the producer
710 mlt_producer_close( melt );
712 // Close the consumer
713 if ( consumer != NULL )
714 mlt_consumer_close( consumer );
717 mlt_profile_close( profile );
721 mlt_factory_close( );