2 * mlt_field.c -- A field for planting multiple transitions and filters
3 * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
4 * Author: Charles Yates <charles.yates@pandora.be>
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 #include "mlt_field.h"
22 #include "mlt_service.h"
23 #include "mlt_filter.h"
24 #include "mlt_transition.h"
25 #include "mlt_multitrack.h"
26 #include "mlt_tractor.h"
31 /** Private structures.
36 // This is the producer we're connected to
40 mlt_multitrack multitrack
;
48 We construct a multitrack and a tractor here.
51 mlt_field
mlt_field_init( )
53 // Initialise the field
54 mlt_field
this = calloc( sizeof( struct mlt_field_s
), 1 );
59 // Construct a multitrack
60 this->multitrack
= mlt_multitrack_init( );
62 // Construct a tractor
63 this->tractor
= mlt_tractor_init( );
65 // The first plant will be connected to the mulitrack
66 this->producer
= MLT_MULTITRACK_SERVICE( this->multitrack
);
68 // Connect the tractor to the multitrack
69 mlt_tractor_connect( this->tractor
, this->producer
);
76 mlt_field
mlt_field_new( mlt_multitrack multitrack
, mlt_tractor tractor
)
78 // Initialise the field
79 mlt_field
this = calloc( sizeof( struct mlt_field_s
), 1 );
84 // Construct a multitrack
85 this->multitrack
= multitrack
;
87 // Construct a tractor
88 this->tractor
= tractor
;
90 // The first plant will be connected to the mulitrack
91 this->producer
= MLT_MULTITRACK_SERVICE( this->multitrack
);
93 // Connect the tractor to the multitrack
94 mlt_tractor_connect( this->tractor
, this->producer
);
101 /** Get the service associated to this field.
104 mlt_service
mlt_field_service( mlt_field
this )
106 return MLT_TRACTOR_SERVICE( this->tractor
);
109 /** Get the multi track.
112 mlt_multitrack
mlt_field_multitrack( mlt_field
this )
114 return this != NULL ?
this->multitrack
: NULL
;
120 mlt_tractor
mlt_field_tractor( mlt_field
this )
122 return this != NULL ?
this->tractor
: NULL
;
125 /** Get the properties associated to this field.
128 mlt_properties
mlt_field_properties( mlt_field
this )
130 return MLT_SERVICE_PROPERTIES( mlt_field_service( this ) );
136 int mlt_field_plant_filter( mlt_field
this, mlt_filter that
, int track
)
138 // Connect the filter to the last producer
139 int result
= mlt_filter_connect( that
, this->producer
, track
);
141 // If sucessful, then we'll use this for connecting in the future
144 // This is now the new producer
145 this->producer
= MLT_FILTER_SERVICE( that
);
147 // Reconnect tractor to new producer
148 mlt_tractor_connect( this->tractor
, this->producer
);
151 mlt_events_fire( mlt_field_properties( this ), "service-changed", NULL
);
157 /** Plant a transition.
160 int mlt_field_plant_transition( mlt_field
this, mlt_transition that
, int a_track
, int b_track
)
162 // Connect the transition to the last producer
163 int result
= mlt_transition_connect( that
, this->producer
, a_track
, b_track
);
165 // If sucessful, then we'll use this for connecting in the future
168 // This is now the new producer
169 this->producer
= MLT_TRANSITION_SERVICE( that
);
171 // Reconnect tractor to new producer
172 mlt_tractor_connect( this->tractor
, this->producer
);
175 mlt_events_fire( mlt_field_properties( this ), "service-changed", NULL
);
184 void mlt_field_close( mlt_field
this )
186 if ( this != NULL
&& mlt_properties_dec_ref( mlt_field_properties( this ) ) <= 0 )
188 //mlt_tractor_close( this->tractor );
189 //mlt_multitrack_close( this->multitrack );