2 * producer_westley.c -- a libxml2 parser of mlt service networks
3 * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
4 * Author: Dan Dennedy <dan@dennedy.org>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library 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 GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 // TODO: destroy unreferenced producers (they are currently destroyed
22 // when the returned producer is closed).
24 #include <framework/mlt.h>
31 #include <libxml/parser.h>
32 #include <libxml/parserInternals.h> // for xmlCreateFileParserCtxt
33 #include <libxml/tree.h>
35 #define STACK_SIZE 1000
36 #define BRANCH_SIG_LEN 4000
43 extern xmlDocPtr westley_make_doc( mlt_service service );
60 mlt_dummy_filter_type,
61 mlt_dummy_transition_type,
62 mlt_dummy_producer_type,
65 struct deserialise_context_s
67 enum service_type stack_types[ STACK_SIZE ];
68 mlt_service stack_service[ STACK_SIZE ];
69 int stack_service_size;
70 mlt_properties producer_map;
71 mlt_properties destructors;
75 xmlNodePtr stack_node[ STACK_SIZE ];
78 int entity_is_replace;
80 int branch[ STACK_SIZE ];
81 const xmlChar *publicId;
82 const xmlChar *systemId;
83 mlt_properties params;
86 typedef struct deserialise_context_s *deserialise_context;
88 /** Convert the numerical current branch address to a dot-delimited string.
90 static char *serialise_branch( deserialise_context this, char *s )
95 for ( i = 0; i < this->depth; i++ )
97 int len = strlen( s );
98 snprintf( s + len, BRANCH_SIG_LEN - len, "%d.", this->branch[ i ] );
106 static int context_push_service( deserialise_context this, mlt_service that, enum service_type type )
108 int ret = this->stack_service_size >= STACK_SIZE - 1;
111 this->stack_service[ this->stack_service_size ] = that;
112 this->stack_types[ this->stack_service_size++ ] = type;
114 // Record the tree branch on which this service lives
115 if ( that != NULL && mlt_properties_get( MLT_SERVICE_PROPERTIES( that ), "_westley_branch" ) == NULL )
117 char s[ BRANCH_SIG_LEN ];
118 mlt_properties_set( MLT_SERVICE_PROPERTIES( that ), "_westley_branch", serialise_branch( this, s ) );
127 static mlt_service context_pop_service( deserialise_context this, enum service_type *type )
129 mlt_service result = NULL;
130 if ( this->stack_service_size > 0 )
132 result = this->stack_service[ -- this->stack_service_size ];
134 *type = this->stack_types[ this->stack_service_size ];
142 static int context_push_node( deserialise_context this, xmlNodePtr node )
144 int ret = this->stack_node_size >= STACK_SIZE - 1;
146 this->stack_node[ this->stack_node_size ++ ] = node;
153 static xmlNodePtr context_pop_node( deserialise_context this )
155 xmlNodePtr result = NULL;
156 if ( this->stack_node_size > 0 )
157 result = this->stack_node[ -- this->stack_node_size ];
162 // Set the destructor on a new service
163 static void track_service( mlt_properties properties, void *service, mlt_destructor destructor )
165 int registered = mlt_properties_get_int( properties, "registered" );
166 char *key = mlt_properties_get( properties, "registered" );
167 mlt_properties_set_data( properties, key, service, 0, destructor, NULL );
168 mlt_properties_set_int( properties, "registered", ++ registered );
172 // Prepend the property value with the document root
173 static inline void qualify_property( deserialise_context context, mlt_properties properties, char *name )
175 char *resource = mlt_properties_get( properties, name );
176 if ( resource != NULL && resource[0] )
178 // Qualify file name properties
179 char *root = mlt_properties_get( context->producer_map, "root" );
180 if ( root != NULL && strcmp( root, "" ) )
182 char *full_resource = malloc( strlen( root ) + strlen( resource ) + 2 );
183 if ( resource[ 0 ] != '/' && strchr( resource, ':' ) == NULL )
185 strcpy( full_resource, root );
186 strcat( full_resource, "/" );
187 strcat( full_resource, resource );
191 strcpy( full_resource, resource );
193 mlt_properties_set( properties, name, full_resource );
194 free( full_resource );
200 /** This function adds a producer to a playlist or multitrack when
201 there is no entry or track element.
204 static int add_producer( deserialise_context context, mlt_service service, mlt_position in, mlt_position out )
206 // Return value (0 = service remains top of stack, 1 means it can be removed)
209 // Get the parent producer
210 enum service_type type = mlt_invalid_type;
211 mlt_service container = context_pop_service( context, &type );
214 if ( service != NULL && container != NULL )
216 char *container_branch = mlt_properties_get( MLT_SERVICE_PROPERTIES( container ), "_westley_branch" );
217 char *service_branch = mlt_properties_get( MLT_SERVICE_PROPERTIES( service ), "_westley_branch" );
218 contained = !strncmp( container_branch, service_branch, strlen( container_branch ) );
223 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
224 char *hide_s = mlt_properties_get( properties, "hide" );
226 // Indicate that this service is no longer top of stack
231 case mlt_tractor_type:
233 mlt_multitrack multitrack = mlt_tractor_multitrack( MLT_TRACTOR( container ) );
234 mlt_multitrack_connect( multitrack, MLT_PRODUCER( service ), mlt_multitrack_count( multitrack ) );
237 case mlt_multitrack_type:
239 mlt_multitrack_connect( MLT_MULTITRACK( container ),
240 MLT_PRODUCER( service ),
241 mlt_multitrack_count( MLT_MULTITRACK( container ) ) );
244 case mlt_playlist_type:
246 mlt_playlist_append_io( MLT_PLAYLIST( container ), MLT_PRODUCER( service ), in, out );
251 fprintf( stderr, "Producer defined inside something that isn't a container\n" );
255 // Set the hide state of the track producer
256 if ( hide_s != NULL )
258 if ( strcmp( hide_s, "video" ) == 0 )
259 mlt_properties_set_int( properties, "hide", 1 );
260 else if ( strcmp( hide_s, "audio" ) == 0 )
261 mlt_properties_set_int( properties, "hide", 2 );
262 else if ( strcmp( hide_s, "both" ) == 0 )
263 mlt_properties_set_int( properties, "hide", 3 );
267 // Put the parent producer back
268 if ( container != NULL )
269 context_push_service( context, container, type );
274 /** Attach filters defined on that to this.
277 static void attach_filters( mlt_service this, mlt_service that )
282 mlt_filter filter = NULL;
283 for ( i = 0; ( filter = mlt_service_filter( that, i ) ) != NULL; i ++ )
285 mlt_service_attach( this, filter );
286 attach_filters( MLT_FILTER_SERVICE( filter ), MLT_FILTER_SERVICE( filter ) );
291 static void on_start_tractor( deserialise_context context, const xmlChar *name, const xmlChar **atts)
293 mlt_tractor tractor = mlt_tractor_new( );
294 mlt_service service = MLT_TRACTOR_SERVICE( tractor );
295 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
297 track_service( context->destructors, service, (mlt_destructor) mlt_tractor_close );
299 for ( ; atts != NULL && *atts != NULL; atts += 2 )
300 mlt_properties_set( MLT_SERVICE_PROPERTIES( service ), (char*) atts[0], atts[1] == NULL ? "" : (char*) atts[1] );
302 mlt_properties_set_int( MLT_TRACTOR_PROPERTIES( tractor ), "global_feed", 1 );
304 if ( mlt_properties_get( properties, "id" ) != NULL )
305 mlt_properties_set_data( context->producer_map, mlt_properties_get( properties, "id" ), service, 0, NULL, NULL );
307 context_push_service( context, service, mlt_tractor_type );
310 static void on_end_tractor( deserialise_context context, const xmlChar *name )
313 enum service_type type;
314 mlt_service tractor = context_pop_service( context, &type );
316 if ( tractor != NULL && type == mlt_tractor_type )
318 // See if the tractor should be added to a playlist or multitrack
319 if ( add_producer( context, tractor, 0, mlt_producer_get_out( MLT_PRODUCER( tractor ) ) ) == 0 )
320 context_push_service( context, tractor, type );
324 fprintf( stderr, "Invalid state for tractor\n" );
328 static void on_start_multitrack( deserialise_context context, const xmlChar *name, const xmlChar **atts)
330 enum service_type type;
331 mlt_service parent = context_pop_service( context, &type );
333 // If we don't have a parent, then create one now, providing we're in a state where we can
334 if ( parent == NULL || ( type == mlt_playlist_type || type == mlt_multitrack_type ) )
336 mlt_tractor tractor = NULL;
337 // Push the parent back
338 if ( parent != NULL )
339 context_push_service( context, parent, type );
341 // Create a tractor to contain the multitrack
342 tractor = mlt_tractor_new( );
343 parent = MLT_TRACTOR_SERVICE( tractor );
344 track_service( context->destructors, parent, (mlt_destructor) mlt_tractor_close );
345 type = mlt_tractor_type;
347 // Flag it as a synthesised tractor for clean up later
348 mlt_properties_set_int( MLT_SERVICE_PROPERTIES( parent ), "fezzik_synth", 1 );
351 if ( type == mlt_tractor_type )
353 mlt_service service = MLT_SERVICE( mlt_tractor_multitrack( MLT_TRACTOR( parent ) ) );
354 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
355 for ( ; atts != NULL && *atts != NULL; atts += 2 )
356 mlt_properties_set( properties, (char*) atts[0], atts[1] == NULL ? "" : (char*) atts[1] );
358 if ( mlt_properties_get( properties, "id" ) != NULL )
359 mlt_properties_set_data( context->producer_map, mlt_properties_get( properties,"id" ), service, 0, NULL, NULL );
361 context_push_service( context, parent, type );
362 context_push_service( context, service, mlt_multitrack_type );
366 fprintf( stderr, "Invalid multitrack position\n" );
370 static void on_end_multitrack( deserialise_context context, const xmlChar *name )
372 // Get the multitrack from the stack
373 enum service_type type;
374 mlt_service service = context_pop_service( context, &type );
376 if ( service == NULL || type != mlt_multitrack_type )
377 fprintf( stderr, "End multitrack in the wrong state...\n" );
380 static void on_start_playlist( deserialise_context context, const xmlChar *name, const xmlChar **atts)
382 mlt_playlist playlist = mlt_playlist_init( );
383 mlt_service service = MLT_PLAYLIST_SERVICE( playlist );
384 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
386 track_service( context->destructors, service, (mlt_destructor) mlt_playlist_close );
388 for ( ; atts != NULL && *atts != NULL; atts += 2 )
390 mlt_properties_set( properties, (char*) atts[0], atts[1] == NULL ? "" : (char*) atts[1] );
392 // Out will be overwritten later as we append, so we need to save it
393 if ( xmlStrcmp( atts[ 0 ], _x("out") ) == 0 )
394 mlt_properties_set( properties, "_westley.out", ( char* )atts[ 1 ] );
397 if ( mlt_properties_get( properties, "id" ) != NULL )
398 mlt_properties_set_data( context->producer_map, mlt_properties_get( properties, "id" ), service, 0, NULL, NULL );
400 context_push_service( context, service, mlt_playlist_type );
403 static void on_end_playlist( deserialise_context context, const xmlChar *name )
405 // Get the playlist from the stack
406 enum service_type type;
407 mlt_service service = context_pop_service( context, &type );
409 if ( service != NULL && type == mlt_playlist_type )
411 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
412 mlt_position in = mlt_properties_get_position( properties, "in" );
413 mlt_position out = mlt_properties_get_position( properties, "out" );
415 // See if the playlist should be added to a playlist or multitrack
416 if ( add_producer( context, service, in, out ) == 0 )
417 context_push_service( context, service, type );
421 fprintf( stderr, "Invalid state of playlist end\n" );
425 static void on_start_producer( deserialise_context context, const xmlChar *name, const xmlChar **atts)
427 // use a dummy service to hold properties to allow arbitrary nesting
428 mlt_service service = calloc( 1, sizeof( struct mlt_service_s ) );
429 mlt_service_init( service, NULL );
431 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
433 context_push_service( context, service, mlt_dummy_producer_type );
435 for ( ; atts != NULL && *atts != NULL; atts += 2 )
436 mlt_properties_set( properties, (char*) atts[0], atts[1] == NULL ? "" : (char*) atts[1] );
439 // Parse a SMIL clock value (as produced by Kino 0.9.1) and return position in frames
440 static mlt_position parse_clock_value( char *value, double fps )
442 // This implementation expects a fully specified clock value - no optional
444 char *pos, *copy = strdup( value );
446 mlt_position result = -1;
449 pos = strchr( value, ':' );
456 pos = strchr( value, ':' );
463 pos = strchr( value, '.' );
472 result = ( fps * ( ( (hh * 3600) + (mm * 60) + ss ) * 1000 + ms ) / 1000 + 0.5 );
477 static void on_end_producer( deserialise_context context, const xmlChar *name )
479 enum service_type type;
480 mlt_service service = context_pop_service( context, &type );
481 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
483 if ( service != NULL && type == mlt_dummy_producer_type )
485 mlt_service producer = NULL;
487 qualify_property( context, properties, "resource" );
488 char *resource = mlt_properties_get( properties, "resource" );
490 // Let Kino-SMIL src be a synonym for resource
491 if ( resource == NULL )
493 qualify_property( context, properties, "src" );
494 resource = mlt_properties_get( properties, "src" );
497 // Instantiate the producer
498 if ( mlt_properties_get( properties, "mlt_service" ) != NULL )
501 strncpy( temp, mlt_properties_get( properties, "mlt_service" ), 1024 );
502 if ( resource != NULL )
505 strncat( temp, resource, 1023 - strlen( temp ) );
507 producer = MLT_SERVICE( mlt_factory_producer( context->profile, "fezzik", temp ) );
510 // Just in case the plugin requested doesn't exist...
511 if ( producer == NULL && resource != NULL )
512 producer = MLT_SERVICE( mlt_factory_producer( context->profile, "fezzik", resource ) );
514 if ( producer == NULL )
515 producer = MLT_SERVICE( mlt_factory_producer( context->profile, "fezzik", "+INVALID.txt" ) );
517 if ( producer == NULL )
518 producer = MLT_SERVICE( mlt_factory_producer( context->profile, "fezzik", "colour:red" ) );
520 // Track this producer
521 track_service( context->destructors, producer, (mlt_destructor) mlt_producer_close );
523 // Propogate the properties
524 qualify_property( context, properties, "resource" );
525 qualify_property( context, properties, "luma" );
526 qualify_property( context, properties, "luma.resource" );
527 qualify_property( context, properties, "composite.luma" );
528 qualify_property( context, properties, "producer.resource" );
530 // Handle in/out properties separately
531 mlt_position in = -1;
532 mlt_position out = -1;
535 if ( mlt_properties_get( properties, "in" ) != NULL )
536 in = mlt_properties_get_position( properties, "in" );
537 // Let Kino-SMIL clipBegin be a synonym for in
538 if ( mlt_properties_get( properties, "clipBegin" ) != NULL )
540 if ( strchr( mlt_properties_get( properties, "clipBegin" ), ':' ) )
542 in = parse_clock_value( mlt_properties_get( properties, "clipBegin" ),
543 mlt_producer_get_fps( MLT_PRODUCER( producer ) ) );
545 // Parse frames value
546 in = mlt_properties_get_position( properties, "clipBegin" );
549 if ( mlt_properties_get( properties, "out" ) != NULL )
550 out = mlt_properties_get_position( properties, "out" );
551 // Let Kino-SMIL clipEnd be a synonym for out
552 if ( mlt_properties_get( properties, "clipEnd" ) != NULL )
554 if ( strchr( mlt_properties_get( properties, "clipEnd" ), ':' ) )
556 out = parse_clock_value( mlt_properties_get( properties, "clipEnd" ),
557 mlt_producer_get_fps( MLT_PRODUCER( producer ) ) );
559 // Parse frames value
560 out = mlt_properties_get_position( properties, "clipEnd" );
563 mlt_properties_set( properties, "in", NULL );
564 mlt_properties_set( properties, "out", NULL );
566 // Inherit the properties
567 mlt_properties_inherit( MLT_SERVICE_PROPERTIES( producer ), properties );
569 // Attach all filters from service onto producer
570 attach_filters( producer, service );
572 // Add the producer to the producer map
573 if ( mlt_properties_get( properties, "id" ) != NULL )
574 mlt_properties_set_data( context->producer_map, mlt_properties_get(properties, "id"), producer, 0, NULL, NULL );
576 // See if the producer should be added to a playlist or multitrack
577 if ( add_producer( context, producer, in, out ) == 0 )
579 // Otherwise, set in and out on...
580 if ( in != -1 || out != -1 )
582 // Get the parent service
583 enum service_type type;
584 mlt_service parent = context_pop_service( context, &type );
585 if ( parent != NULL )
587 // Get the parent properties
588 properties = MLT_SERVICE_PROPERTIES( parent );
590 char *resource = mlt_properties_get( properties, "resource" );
592 // Put the parent producer back
593 context_push_service( context, parent, type );
595 // If the parent is a track or entry
596 if ( resource && ( strcmp( resource, "<entry>" ) == 0 ) )
598 mlt_properties_set_position( properties, "in", in );
599 mlt_properties_set_position( properties, "out", out );
603 // Otherwise, set in and out on producer directly
604 mlt_producer_set_in_and_out( MLT_PRODUCER( producer ), in, out );
609 // Otherwise, set in and out on producer directly
610 mlt_producer_set_in_and_out( MLT_PRODUCER( producer ), in, out );
614 // Push the producer onto the stack
615 context_push_service( context, producer, mlt_producer_type );
618 mlt_service_close( service );
622 static void on_start_blank( deserialise_context context, const xmlChar *name, const xmlChar **atts)
624 // Get the playlist from the stack
625 enum service_type type;
626 mlt_service service = context_pop_service( context, &type );
627 mlt_position length = 0;
629 if ( type == mlt_playlist_type && service != NULL )
631 // Look for the length attribute
632 for ( ; atts != NULL && *atts != NULL; atts += 2 )
634 if ( xmlStrcmp( atts[0], _x("length") ) == 0 )
636 length = atoll( _s(atts[1]) );
641 // Append a blank to the playlist
642 mlt_playlist_blank( MLT_PLAYLIST( service ), length - 1 );
644 // Push the playlist back onto the stack
645 context_push_service( context, service, type );
649 fprintf( stderr, "blank without a playlist - a definite no no\n" );
653 static void on_start_entry( deserialise_context context, const xmlChar *name, const xmlChar **atts)
655 mlt_producer entry = NULL;
656 mlt_properties temp = mlt_properties_new( );
658 for ( ; atts != NULL && *atts != NULL; atts += 2 )
660 mlt_properties_set( temp, (char*) atts[0], atts[1] == NULL ? "" : (char*) atts[1] );
662 // Look for the producer attribute
663 if ( xmlStrcmp( atts[ 0 ], _x("producer") ) == 0 )
665 mlt_producer producer = mlt_properties_get_data( context->producer_map, (char*) atts[1], NULL );
666 if ( producer != NULL )
667 mlt_properties_set_data( temp, "producer", producer, 0, NULL, NULL );
671 // If we have a valid entry
672 if ( mlt_properties_get_data( temp, "producer", NULL ) != NULL )
674 mlt_playlist_clip_info info;
675 enum service_type parent_type = invalid_type;
676 mlt_service parent = context_pop_service( context, &parent_type );
677 mlt_producer producer = mlt_properties_get_data( temp, "producer", NULL );
679 if ( parent_type == mlt_playlist_type )
681 // Append the producer to the playlist
682 if ( mlt_properties_get( temp, "in" ) != NULL || mlt_properties_get( temp, "out" ) != NULL )
684 mlt_playlist_append_io( MLT_PLAYLIST( parent ), producer,
685 mlt_properties_get_position( temp, "in" ),
686 mlt_properties_get_position( temp, "out" ) );
690 mlt_playlist_append( MLT_PLAYLIST( parent ), producer );
693 // Handle the repeat property
694 if ( mlt_properties_get_int( temp, "repeat" ) > 0 )
696 mlt_playlist_repeat_clip( MLT_PLAYLIST( parent ),
697 mlt_playlist_count( MLT_PLAYLIST( parent ) ) - 1,
698 mlt_properties_get_int( temp, "repeat" ) );
701 mlt_playlist_get_clip_info( MLT_PLAYLIST( parent ), &info, mlt_playlist_count( MLT_PLAYLIST( parent ) ) - 1 );
706 fprintf( stderr, "Entry not part of a playlist...\n" );
709 context_push_service( context, parent, parent_type );
712 // Push the cut onto the stack
713 context_push_service( context, MLT_PRODUCER_SERVICE( entry ), mlt_entry_type );
715 mlt_properties_close( temp );
718 static void on_end_entry( deserialise_context context, const xmlChar *name )
720 // Get the entry from the stack
721 enum service_type entry_type = invalid_type;
722 mlt_service entry = context_pop_service( context, &entry_type );
724 if ( entry == NULL && entry_type != mlt_entry_type )
726 fprintf( stderr, "Invalid state at end of entry\n" );
730 static void on_start_track( deserialise_context context, const xmlChar *name, const xmlChar **atts)
732 // use a dummy service to hold properties to allow arbitrary nesting
733 mlt_service service = calloc( 1, sizeof( struct mlt_service_s ) );
734 mlt_service_init( service, NULL );
736 // Push the dummy service onto the stack
737 context_push_service( context, service, mlt_entry_type );
739 mlt_properties_set( MLT_SERVICE_PROPERTIES( service ), "resource", "<track>" );
741 for ( ; atts != NULL && *atts != NULL; atts += 2 )
743 mlt_properties_set( MLT_SERVICE_PROPERTIES( service ), (char*) atts[0], atts[1] == NULL ? "" : (char*) atts[1] );
745 // Look for the producer attribute
746 if ( xmlStrcmp( atts[ 0 ], _x("producer") ) == 0 )
748 mlt_producer producer = mlt_properties_get_data( context->producer_map, (char*) atts[1], NULL );
749 if ( producer != NULL )
750 mlt_properties_set_data( MLT_SERVICE_PROPERTIES( service ), "producer", producer, 0, NULL, NULL );
755 static void on_end_track( deserialise_context context, const xmlChar *name )
757 // Get the track from the stack
758 enum service_type track_type;
759 mlt_service track = context_pop_service( context, &track_type );
761 if ( track != NULL && track_type == mlt_entry_type )
763 mlt_properties track_props = MLT_SERVICE_PROPERTIES( track );
764 enum service_type parent_type = invalid_type;
765 mlt_service parent = context_pop_service( context, &parent_type );
766 mlt_multitrack multitrack = NULL;
768 mlt_producer producer = mlt_properties_get_data( track_props, "producer", NULL );
769 mlt_properties producer_props = MLT_PRODUCER_PROPERTIES( producer );
771 if ( parent_type == mlt_tractor_type )
772 multitrack = mlt_tractor_multitrack( MLT_TRACTOR( parent ) );
773 else if ( parent_type == mlt_multitrack_type )
774 multitrack = MLT_MULTITRACK( parent );
776 fprintf( stderr, "track contained in an invalid container\n" );
778 if ( multitrack != NULL )
780 // Set producer i/o if specified
781 if ( mlt_properties_get( track_props, "in" ) != NULL ||
782 mlt_properties_get( track_props, "out" ) != NULL )
784 mlt_producer cut = mlt_producer_cut( MLT_PRODUCER( producer ),
785 mlt_properties_get_position( track_props, "in" ),
786 mlt_properties_get_position( track_props, "out" ) );
787 mlt_multitrack_connect( multitrack, cut, mlt_multitrack_count( multitrack ) );
788 mlt_properties_inherit( MLT_PRODUCER_PROPERTIES( cut ), track_props );
789 track_props = MLT_PRODUCER_PROPERTIES( cut );
790 mlt_producer_close( cut );
794 mlt_multitrack_connect( multitrack, producer, mlt_multitrack_count( multitrack ) );
797 // Set the hide state of the track producer
798 char *hide_s = mlt_properties_get( track_props, "hide" );
799 if ( hide_s != NULL )
801 if ( strcmp( hide_s, "video" ) == 0 )
802 mlt_properties_set_int( producer_props, "hide", 1 );
803 else if ( strcmp( hide_s, "audio" ) == 0 )
804 mlt_properties_set_int( producer_props, "hide", 2 );
805 else if ( strcmp( hide_s, "both" ) == 0 )
806 mlt_properties_set_int( producer_props, "hide", 3 );
810 if ( parent != NULL )
811 context_push_service( context, parent, parent_type );
813 mlt_service_close( track );
817 fprintf( stderr, "Invalid state at end of track\n" );
821 static void on_start_filter( deserialise_context context, const xmlChar *name, const xmlChar **atts)
823 // use a dummy service to hold properties to allow arbitrary nesting
824 mlt_service service = calloc( 1, sizeof( struct mlt_service_s ) );
825 mlt_service_init( service, NULL );
827 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
829 context_push_service( context, service, mlt_dummy_filter_type );
831 // Set the properties
832 for ( ; atts != NULL && *atts != NULL; atts += 2 )
833 mlt_properties_set( properties, (char*) atts[0], (char*) atts[1] );
836 static void on_end_filter( deserialise_context context, const xmlChar *name )
838 enum service_type type;
839 mlt_service service = context_pop_service( context, &type );
840 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
842 enum service_type parent_type = invalid_type;
843 mlt_service parent = context_pop_service( context, &parent_type );
845 if ( service != NULL && type == mlt_dummy_filter_type )
847 mlt_service filter = MLT_SERVICE( mlt_factory_filter( context->profile, mlt_properties_get( properties, "mlt_service" ), NULL ) );
848 mlt_properties filter_props = MLT_SERVICE_PROPERTIES( filter );
850 track_service( context->destructors, filter, (mlt_destructor) mlt_filter_close );
852 // Propogate the properties
853 qualify_property( context, properties, "resource" );
854 qualify_property( context, properties, "luma" );
855 qualify_property( context, properties, "luma.resource" );
856 qualify_property( context, properties, "composite.luma" );
857 qualify_property( context, properties, "producer.resource" );
858 mlt_properties_inherit( filter_props, properties );
860 // Attach all filters from service onto filter
861 attach_filters( filter, service );
863 // Associate the filter with the parent
864 if ( parent != NULL )
866 if ( parent_type == mlt_tractor_type )
868 mlt_field field = mlt_tractor_field( MLT_TRACTOR( parent ) );
869 mlt_field_plant_filter( field, MLT_FILTER( filter ), mlt_properties_get_int( properties, "track" ) );
870 mlt_filter_set_in_and_out( MLT_FILTER( filter ),
871 mlt_properties_get_int( properties, "in" ),
872 mlt_properties_get_int( properties, "out" ) );
876 mlt_service_attach( parent, MLT_FILTER( filter ) );
879 // Put the parent back on the stack
880 context_push_service( context, parent, parent_type );
884 fprintf( stderr, "filter closed with invalid parent...\n" );
887 // Close the dummy filter service
888 mlt_service_close( service );
892 fprintf( stderr, "Invalid top of stack on filter close\n" );
896 static void on_start_transition( deserialise_context context, const xmlChar *name, const xmlChar **atts)
898 // use a dummy service to hold properties to allow arbitrary nesting
899 mlt_service service = calloc( 1, sizeof( struct mlt_service_s ) );
900 mlt_service_init( service, NULL );
902 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
904 context_push_service( context, service, mlt_dummy_transition_type );
906 // Set the properties
907 for ( ; atts != NULL && *atts != NULL; atts += 2 )
908 mlt_properties_set( properties, (char*) atts[0], (char*) atts[1] );
911 static void on_end_transition( deserialise_context context, const xmlChar *name )
913 enum service_type type;
914 mlt_service service = context_pop_service( context, &type );
915 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
917 enum service_type parent_type = invalid_type;
918 mlt_service parent = context_pop_service( context, &parent_type );
920 if ( service != NULL && type == mlt_dummy_transition_type )
922 char *id = mlt_properties_get( properties, "mlt_service" );
923 mlt_service effect = MLT_SERVICE( mlt_factory_transition( context->profile, id, NULL ) );
924 mlt_properties effect_props = MLT_SERVICE_PROPERTIES( effect );
926 track_service( context->destructors, effect, (mlt_destructor) mlt_transition_close );
928 // Propogate the properties
929 qualify_property( context, properties, "resource" );
930 qualify_property( context, properties, "luma" );
931 qualify_property( context, properties, "luma.resource" );
932 qualify_property( context, properties, "composite.luma" );
933 qualify_property( context, properties, "producer.resource" );
934 mlt_properties_inherit( effect_props, properties );
936 // Attach all filters from service onto effect
937 attach_filters( effect, service );
939 // Associate the filter with the parent
940 if ( parent != NULL )
942 if ( parent_type == mlt_tractor_type )
944 mlt_field field = mlt_tractor_field( MLT_TRACTOR( parent ) );
945 if ( mlt_properties_get_int( properties, "a_track" ) == mlt_properties_get_int( properties, "b_track" ) )
946 mlt_properties_set_int( properties, "b_track", mlt_properties_get_int( properties, "a_track" ) + 1 );
947 mlt_field_plant_transition( field, MLT_TRANSITION( effect ),
948 mlt_properties_get_int( properties, "a_track" ),
949 mlt_properties_get_int( properties, "b_track" ) );
950 mlt_transition_set_in_and_out( MLT_TRANSITION( effect ),
951 mlt_properties_get_int( properties, "in" ),
952 mlt_properties_get_int( properties, "out" ) );
956 fprintf( stderr, "Misplaced transition - ignoring\n" );
959 // Put the parent back on the stack
960 context_push_service( context, parent, parent_type );
964 fprintf( stderr, "transition closed with invalid parent...\n" );
967 // Close the dummy filter service
968 mlt_service_close( service );
972 fprintf( stderr, "Invalid top of stack on transition close\n" );
976 static void on_start_property( deserialise_context context, const xmlChar *name, const xmlChar **atts)
978 enum service_type type;
979 mlt_service service = context_pop_service( context, &type );
980 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
983 if ( service != NULL )
985 // Set the properties
986 for ( ; atts != NULL && *atts != NULL; atts += 2 )
988 if ( xmlStrcmp( atts[ 0 ], _x("name") ) == 0 )
989 context->property = strdup( _s(atts[ 1 ]) );
990 else if ( xmlStrcmp( atts[ 0 ], _x("value") ) == 0 )
991 value = _s(atts[ 1 ]);
994 if ( context->property != NULL )
995 mlt_properties_set( properties, context->property, value == NULL ? "" : value );
997 // Tell parser to collect any further nodes for serialisation
998 context->is_value = 1;
1000 context_push_service( context, service, type );
1004 fprintf( stderr, "Property without a service '%s'?\n", ( char * )name );
1008 static void on_end_property( deserialise_context context, const xmlChar *name )
1010 enum service_type type;
1011 mlt_service service = context_pop_service( context, &type );
1012 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
1014 if ( service != NULL )
1016 // Tell parser to stop building a tree
1017 context->is_value = 0;
1019 // See if there is a xml tree for the value
1020 if ( context->property != NULL && context->value_doc != NULL )
1025 // Serialise the tree to get value
1026 xmlDocDumpMemory( context->value_doc, &value, &size );
1027 mlt_properties_set( properties, context->property, _s(value) );
1029 xmlFreeDoc( context->value_doc );
1030 context->value_doc = NULL;
1033 // Close this property handling
1034 free( context->property );
1035 context->property = NULL;
1037 context_push_service( context, service, type );
1041 fprintf( stderr, "Property without a service '%s'??\n", (char *)name );
1045 static void on_start_element( void *ctx, const xmlChar *name, const xmlChar **atts)
1047 struct _xmlParserCtxt *xmlcontext = ( struct _xmlParserCtxt* )ctx;
1048 deserialise_context context = ( deserialise_context )( xmlcontext->_private );
1050 //printf("on_start_element: %s\n", name );
1051 context->branch[ context->depth ] ++;
1054 // Build a tree from nodes within a property value
1055 if ( context->is_value == 1 )
1057 xmlNodePtr node = xmlNewNode( NULL, name );
1059 if ( context->value_doc == NULL )
1062 context->value_doc = xmlNewDoc( _x("1.0") );
1063 xmlDocSetRootElement( context->value_doc, node );
1067 // Append child to tree
1068 xmlAddChild( context->stack_node[ context->stack_node_size - 1 ], node );
1070 context_push_node( context, node );
1072 // Set the attributes
1073 for ( ; atts != NULL && *atts != NULL; atts += 2 )
1074 xmlSetProp( node, atts[ 0 ], atts[ 1 ] );
1076 else if ( xmlStrcmp( name, _x("tractor") ) == 0 )
1077 on_start_tractor( context, name, atts );
1078 else if ( xmlStrcmp( name, _x("multitrack") ) == 0 )
1079 on_start_multitrack( context, name, atts );
1080 else if ( xmlStrcmp( name, _x("playlist") ) == 0 || xmlStrcmp( name, _x("seq") ) == 0 || xmlStrcmp( name, _x("smil") ) == 0 )
1081 on_start_playlist( context, name, atts );
1082 else if ( xmlStrcmp( name, _x("producer") ) == 0 || xmlStrcmp( name, _x("video") ) == 0 )
1083 on_start_producer( context, name, atts );
1084 else if ( xmlStrcmp( name, _x("blank") ) == 0 )
1085 on_start_blank( context, name, atts );
1086 else if ( xmlStrcmp( name, _x("entry") ) == 0 )
1087 on_start_entry( context, name, atts );
1088 else if ( xmlStrcmp( name, _x("track") ) == 0 )
1089 on_start_track( context, name, atts );
1090 else if ( xmlStrcmp( name, _x("filter") ) == 0 )
1091 on_start_filter( context, name, atts );
1092 else if ( xmlStrcmp( name, _x("transition") ) == 0 )
1093 on_start_transition( context, name, atts );
1094 else if ( xmlStrcmp( name, _x("property") ) == 0 )
1095 on_start_property( context, name, atts );
1096 else if ( xmlStrcmp( name, _x("westley") ) == 0 )
1097 for ( ; atts != NULL && *atts != NULL; atts += 2 )
1098 mlt_properties_set( context->producer_map, ( char * )atts[ 0 ], ( char * )atts[ 1 ] );
1101 static void on_end_element( void *ctx, const xmlChar *name )
1103 struct _xmlParserCtxt *xmlcontext = ( struct _xmlParserCtxt* )ctx;
1104 deserialise_context context = ( deserialise_context )( xmlcontext->_private );
1106 //printf("on_end_element: %s\n", name );
1107 if ( context->is_value == 1 && xmlStrcmp( name, _x("property") ) != 0 )
1108 context_pop_node( context );
1109 else if ( xmlStrcmp( name, _x("multitrack") ) == 0 )
1110 on_end_multitrack( context, name );
1111 else if ( xmlStrcmp( name, _x("playlist") ) == 0 || xmlStrcmp( name, _x("seq") ) == 0 || xmlStrcmp( name, _x("smil") ) == 0 )
1112 on_end_playlist( context, name );
1113 else if ( xmlStrcmp( name, _x("track") ) == 0 )
1114 on_end_track( context, name );
1115 else if ( xmlStrcmp( name, _x("entry") ) == 0 )
1116 on_end_entry( context, name );
1117 else if ( xmlStrcmp( name, _x("tractor") ) == 0 )
1118 on_end_tractor( context, name );
1119 else if ( xmlStrcmp( name, _x("property") ) == 0 )
1120 on_end_property( context, name );
1121 else if ( xmlStrcmp( name, _x("producer") ) == 0 || xmlStrcmp( name, _x("video") ) == 0 )
1122 on_end_producer( context, name );
1123 else if ( xmlStrcmp( name, _x("filter") ) == 0 )
1124 on_end_filter( context, name );
1125 else if ( xmlStrcmp( name, _x("transition") ) == 0 )
1126 on_end_transition( context, name );
1128 context->branch[ context->depth ] = 0;
1132 static void on_characters( void *ctx, const xmlChar *ch, int len )
1134 struct _xmlParserCtxt *xmlcontext = ( struct _xmlParserCtxt* )ctx;
1135 deserialise_context context = ( deserialise_context )( xmlcontext->_private );
1136 char *value = calloc( len + 1, 1 );
1137 enum service_type type;
1138 mlt_service service = context_pop_service( context, &type );
1139 mlt_properties properties = MLT_SERVICE_PROPERTIES( service );
1141 if ( service != NULL )
1142 context_push_service( context, service, type );
1145 strncpy( value, (const char*) ch, len );
1147 if ( context->stack_node_size > 0 )
1148 xmlNodeAddContent( context->stack_node[ context->stack_node_size - 1 ], ( xmlChar* )value );
1150 // libxml2 generates an on_characters immediately after a get_entity within
1151 // an element value, and we ignore it because it is called again during
1152 // actual substitution.
1153 else if ( context->property != NULL && context->entity_is_replace == 0 )
1155 char *s = mlt_properties_get( properties, context->property );
1158 // Append new text to existing content
1159 char *new = calloc( strlen( s ) + len + 1, 1 );
1161 strcat( new, value );
1162 mlt_properties_set( properties, context->property, new );
1166 mlt_properties_set( properties, context->property, value );
1168 context->entity_is_replace = 0;
1173 /** Convert parameters parsed from resource into entity declarations.
1175 static void params_to_entities( deserialise_context context )
1177 if ( context->params != NULL )
1181 // Add our params as entitiy declarations
1182 for ( i = 0; i < mlt_properties_count( context->params ); i++ )
1184 xmlChar *name = ( xmlChar* )mlt_properties_get_name( context->params, i );
1185 xmlAddDocEntity( context->entity_doc, name, XML_INTERNAL_GENERAL_ENTITY,
1186 context->publicId, context->systemId, ( xmlChar* )mlt_properties_get( context->params, _s(name) ) );
1190 mlt_properties_close( context->params );
1191 context->params = NULL;
1195 // The following 3 facilitate entity substitution in the SAX parser
1196 static void on_internal_subset( void *ctx, const xmlChar* name,
1197 const xmlChar* publicId, const xmlChar* systemId )
1199 struct _xmlParserCtxt *xmlcontext = ( struct _xmlParserCtxt* )ctx;
1200 deserialise_context context = ( deserialise_context )( xmlcontext->_private );
1202 context->publicId = publicId;
1203 context->systemId = systemId;
1204 xmlCreateIntSubset( context->entity_doc, name, publicId, systemId );
1206 // Override default entities with our parameters
1207 params_to_entities( context );
1210 // TODO: Check this with Dan... I think this is for westley parameterisation
1211 // but it's breaking standard escaped entities (like < etc).
1212 static void on_entity_declaration( void *ctx, const xmlChar* name, int type,
1213 const xmlChar* publicId, const xmlChar* systemId, xmlChar* content)
1215 struct _xmlParserCtxt *xmlcontext = ( struct _xmlParserCtxt* )ctx;
1216 deserialise_context context = ( deserialise_context )( xmlcontext->_private );
1218 xmlAddDocEntity( context->entity_doc, name, type, publicId, systemId, content );
1221 // TODO: Check this functionality (see on_entity_declaration)
1222 static xmlEntityPtr on_get_entity( void *ctx, const xmlChar* name )
1224 struct _xmlParserCtxt *xmlcontext = ( struct _xmlParserCtxt* )ctx;
1225 deserialise_context context = ( deserialise_context )( xmlcontext->_private );
1226 xmlEntityPtr e = NULL;
1228 // Setup for entity declarations if not ready
1229 if ( xmlGetIntSubset( context->entity_doc ) == NULL )
1231 xmlCreateIntSubset( context->entity_doc, _x("westley"), _x(""), _x("") );
1232 context->publicId = _x("");
1233 context->systemId = _x("");
1236 // Add our parameters if not already
1237 params_to_entities( context );
1239 e = xmlGetPredefinedEntity( name );
1241 // Send signal to on_characters that an entity substitutin is pending
1244 e = xmlGetDocEntity( context->entity_doc, name );
1246 context->entity_is_replace = 1;
1252 /** Convert a hexadecimal character to its value.
1254 static int tohex( char p )
1256 return isdigit( p ) ? p - '0' : tolower( p ) - 'a' + 10;
1259 /** Decode a url-encoded string containing hexadecimal character sequences.
1261 static char *url_decode( char *dest, char *src )
1269 *p ++ = ( tohex( *( src + 1 ) ) << 4 ) | tohex( *( src + 2 ) );
1282 /** Extract the filename from a URL attaching parameters to a properties list.
1284 static void parse_url( mlt_properties properties, char *url )
1287 int n = strlen( url );
1291 for ( i = 0; i < n; i++ )
1308 if ( name != NULL && value != NULL )
1309 mlt_properties_set( properties, name, value );
1315 if ( name != NULL && value != NULL )
1316 mlt_properties_set( properties, name, value );
1319 // Quick workaround to avoid unecessary libxml2 warnings
1320 static int file_exists( char *file )
1322 char *name = strdup( file );
1324 if ( name != NULL && strchr( name, '?' ) )
1325 *( strchr( name, '?' ) ) = '\0';
1328 FILE *f = fopen( name, "r" );
1330 if ( exists ) fclose( f );
1336 mlt_producer producer_westley_init( mlt_profile profile, mlt_service_type servtype, const char *id, char *data )
1338 xmlSAXHandler *sax = calloc( 1, sizeof( xmlSAXHandler ) );
1339 struct deserialise_context_s *context = calloc( 1, sizeof( struct deserialise_context_s ) );
1340 mlt_properties properties = NULL;
1342 struct _xmlParserCtxt *xmlcontext;
1343 int well_formed = 0;
1344 char *filename = NULL;
1345 int info = strcmp( id, "westley-xml" ) ? 0 : 1;
1347 if ( data == NULL || !strcmp( data, "" ) || ( info == 0 && !file_exists( data ) ) )
1350 context = calloc( 1, sizeof( struct deserialise_context_s ) );
1351 if ( context == NULL )
1354 context->producer_map = mlt_properties_new();
1355 context->destructors = mlt_properties_new();
1356 context->params = mlt_properties_new();
1357 context->profile = profile;
1359 // Decode URL and parse parameters
1360 mlt_properties_set( context->producer_map, "root", "" );
1363 filename = strdup( data );
1364 parse_url( context->params, url_decode( filename, data ) );
1366 // We need the directory prefix which was used for the westley
1367 if ( strchr( filename, '/' ) )
1370 mlt_properties_set( context->producer_map, "root", filename );
1371 root = mlt_properties_get( context->producer_map, "root" );
1372 *( strrchr( root, '/' ) ) = '\0';
1374 // If we don't have an absolute path here, we're heading for disaster...
1375 if ( root[ 0 ] != '/' )
1377 char *cwd = getcwd( NULL, 0 );
1378 char *real = malloc( strlen( cwd ) + strlen( root ) + 2 );
1379 sprintf( real, "%s/%s", cwd, root );
1380 mlt_properties_set( context->producer_map, "root", real );
1387 // We need to track the number of registered filters
1388 mlt_properties_set_int( context->destructors, "registered", 0 );
1390 // Setup SAX callbacks
1391 sax->startElement = on_start_element;
1392 sax->endElement = on_end_element;
1393 sax->characters = on_characters;
1394 sax->cdataBlock = on_characters;
1395 sax->internalSubset = on_internal_subset;
1396 sax->entityDecl = on_entity_declaration;
1397 sax->getEntity = on_get_entity;
1399 // Setup libxml2 SAX parsing
1401 xmlSubstituteEntitiesDefault( 1 );
1402 // This is used to facilitate entity substitution in the SAX parser
1403 context->entity_doc = xmlNewDoc( _x("1.0") );
1405 xmlcontext = xmlCreateFileParserCtxt( filename );
1407 xmlcontext = xmlCreateMemoryParserCtxt( data, strlen( data ) );
1409 // Invalid context - clean up and return NULL
1410 if ( xmlcontext == NULL )
1412 mlt_properties_close( context->producer_map );
1413 mlt_properties_close( context->destructors );
1414 mlt_properties_close( context->params );
1421 xmlcontext->sax = sax;
1422 xmlcontext->_private = ( void* )context;
1425 xmlParseDocument( xmlcontext );
1426 well_formed = xmlcontext->wellFormed;
1428 // Cleanup after parsing
1429 xmlFreeDoc( context->entity_doc );
1431 xmlcontext->sax = NULL;
1432 xmlcontext->_private = NULL;
1433 xmlFreeParserCtxt( xmlcontext );
1434 xmlMemoryDump( ); // for debugging
1436 // Get the last producer on the stack
1437 enum service_type type;
1438 mlt_service service = context_pop_service( context, &type );
1439 if ( well_formed && service != NULL )
1441 // Verify it is a producer service (mlt_type="mlt_producer")
1442 // (producer, playlist, multitrack)
1443 char *type = mlt_properties_get( MLT_SERVICE_PROPERTIES( service ), "mlt_type" );
1444 if ( type == NULL || ( strcmp( type, "mlt_producer" ) != 0 && strcmp( type, "producer" ) != 0 ) )
1449 xmlDocPtr doc = westley_make_doc( service );
1450 xmlDocFormatDump( stdout, doc, 1 );
1455 if ( well_formed && service != NULL )
1457 char *title = mlt_properties_get( context->producer_map, "title" );
1459 // Need the complete producer list for various reasons
1460 properties = context->destructors;
1462 // Now make sure we don't have a reference to the service in the properties
1463 for ( i = mlt_properties_count( properties ) - 1; i >= 1; i -- )
1465 char *name = mlt_properties_get_name( properties, i );
1466 if ( mlt_properties_get_data( properties, name, NULL ) == service )
1468 mlt_properties_set_data( properties, name, service, 0, NULL, NULL );
1473 // We are done referencing destructor property list
1474 // Set this var to service properties for convenience
1475 properties = MLT_SERVICE_PROPERTIES( service );
1478 mlt_properties_set( properties, "title", title );
1480 // Optimise for overlapping producers
1481 mlt_producer_optimise( MLT_PRODUCER( service ) );
1483 // Handle deep copies
1484 if ( getenv( "MLT_WESTLEY_DEEP" ) == NULL )
1486 // Now assign additional properties
1488 mlt_properties_set( properties, "resource", data );
1490 // This tells consumer_westley not to deep copy
1491 mlt_properties_set( properties, "westley", "was here" );
1495 // Allow the project to be edited
1496 mlt_properties_set( properties, "_westley", "was here" );
1497 mlt_properties_set_int( properties, "_mlt_service_hidden", 1 );
1502 // Return null if not well formed
1507 mlt_properties_close( context->producer_map );
1508 if ( context->params != NULL )
1509 mlt_properties_close( context->params );
1510 mlt_properties_close( context->destructors );
1514 return MLT_PRODUCER( service );