2 * factory.c -- the factory method interfaces
3 * Copyright (c) 2008 Marco Gittler <g.marco@freenet.de>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 #include <framework/mlt.h>
27 #include <sys/types.h>
37 #define FREI0R_PLUGIN_PATH "\\lib\\frei0r-1"
38 #elif defined(__DARWIN__) && defined(RELOCATABLE)
40 #define FREI0R_PLUGIN_PATH "/lib/frei0r-1"
43 #define FREI0R_PLUGIN_PATH "/usr/lib/frei0r-1:/usr/lib64/frei0r-1:/opt/local/lib/frei0r-1:/usr/local/lib/frei0r-1:$HOME/.frei0r-1/lib"
46 #define GET_FREI0R_PATH (getenv("FREI0R_PATH") ? getenv("FREI0R_PATH") : getenv("MLT_FREI0R_PLUGIN_PATH") ? getenv("MLT_FREI0R_PLUGIN_PATH") : FREI0R_PLUGIN_PATH)
48 #define CLAMP( x, min, max ) ((x) < (min) ? (min) : (x) > (max) ? (max) : (x))
50 extern mlt_filter filter_frei0r_init( mlt_profile profile, mlt_service_type type, const char *id, char *arg );
51 extern mlt_frame filter_process( mlt_filter this, mlt_frame frame );
52 extern void filter_close( mlt_filter this );
53 extern int producer_get_frame( mlt_producer producer, mlt_frame_ptr frame, int index );
54 extern void producer_close( mlt_producer this );
55 extern void transition_close( mlt_transition this );
56 extern mlt_frame transition_process( mlt_transition transition, mlt_frame a_frame, mlt_frame b_frame );
58 static char* get_frei0r_path()
61 char *dirname = malloc( strlen( mlt_environment( "MLT_APPDIR" ) ) + strlen( FREI0R_PLUGIN_PATH ) + 1 );
62 strcpy( dirname, mlt_environment( "MLT_APPDIR" ) );
63 strcat( dirname, FREI0R_PLUGIN_PATH );
65 #elif defined(__DARWIN__) && defined(RELOCATABLE)
66 char *dirname = malloc( strlen( mlt_environment( "MLT_APPDIR" ) ) + strlen( FREI0R_PLUGIN_PATH ) + 1 );
67 strcpy( dirname, mlt_environment( "MLT_APPDIR" ) );
68 strcat( dirname, FREI0R_PLUGIN_PATH );
71 return strdup( GET_FREI0R_PATH );
75 static void check_thread_safe( mlt_properties properties, const char *name )
77 char dirname[PATH_MAX];
78 snprintf( dirname, PATH_MAX, "%s/frei0r/not_thread_safe.txt", mlt_environment( "MLT_DATA" ) );
79 mlt_properties not_thread_safe = mlt_properties_load( dirname );
82 for ( i = 0; i < mlt_properties_count( not_thread_safe ); i++ )
84 if ( strcmp( name, mlt_properties_get_name( not_thread_safe, i ) ) == 0 )
86 mlt_properties_set_int( properties, "_not_thread_safe", 1 );
90 mlt_properties_close( not_thread_safe );
93 static mlt_properties fill_param_info ( mlt_service_type type, const char *service_name, char *name )
95 char file[ PATH_MAX ];
96 char servicetype[ 1024 ]="";
97 struct stat stat_buff;
101 strcpy ( servicetype , "producer" );
104 strcpy ( servicetype , "filter" );
106 case transition_type:
107 strcpy ( servicetype , "transition" ) ;
110 strcpy ( servicetype , "" );
113 snprintf( file, PATH_MAX, "%s/frei0r/%s_%s.yml", mlt_environment( "MLT_DATA" ), servicetype, service_name );
114 memset(&stat_buff, 0, sizeof(stat_buff));
115 stat(file,&stat_buff);
117 if (S_ISREG(stat_buff.st_mode)){
118 return mlt_properties_parse_yaml( file );
121 void* handle=dlopen(name,RTLD_LAZY);
122 if (!handle) return NULL;
123 void (*plginfo)(f0r_plugin_info_t*)=dlsym(handle,"f0r_get_plugin_info");
124 void (*param_info)(f0r_param_info_t*,int param_index)=dlsym(handle,"f0r_get_param_info");
125 void (*f0r_init)(void)=dlsym(handle,"f0r_init");
126 void (*f0r_deinit)(void)=dlsym(handle,"f0r_deinit");
127 f0r_instance_t (*f0r_construct)(unsigned int , unsigned int)=dlsym(handle, "f0r_construct");
128 void (*f0r_destruct)(f0r_instance_t)=dlsym(handle, "f0r_destruct");
129 void (*f0r_get_param_value)(f0r_instance_t instance, f0r_param_t param, int param_index)=dlsym(handle,"f0r_get_param_value" );
130 if (!plginfo || !param_info) {
134 mlt_properties metadata = mlt_properties_new();
135 f0r_plugin_info_t info;
140 f0r_instance_t instance = f0r_construct(720, 576);
147 snprintf ( string, sizeof(string) , "%d" , info.minor_version );
148 mlt_properties_set_double ( metadata, "schema_version" , 0.1 );
149 mlt_properties_set ( metadata, "title" , info.name );
150 mlt_properties_set_double ( metadata, "version",
151 info.major_version + info.minor_version / pow( 10, strlen( string ) ) );
152 mlt_properties_set ( metadata, "identifier" , service_name );
153 mlt_properties_set ( metadata, "description" , info.explanation );
154 mlt_properties_set ( metadata, "creator" , info.author );
157 mlt_properties_set ( metadata, "type" , "producer" );
160 mlt_properties_set ( metadata, "type" , "filter" );
162 case transition_type:
163 mlt_properties_set ( metadata, "type" , "transition" );
169 mlt_properties tags = mlt_properties_new ( );
170 mlt_properties_set_data ( metadata , "tags" , tags , 0 , ( mlt_destructor )mlt_properties_close, NULL );
171 mlt_properties_set ( tags , "0" , "Video" );
173 mlt_properties parameter = mlt_properties_new ( );
174 mlt_properties_set_data ( metadata , "parameters" , parameter , 0 , ( mlt_destructor )mlt_properties_close, NULL );
176 for (j=0;j<info.num_params;j++){
177 snprintf ( string , sizeof(string), "%d" , j );
178 mlt_properties pnum = mlt_properties_new ( );
179 mlt_properties_set_data ( parameter , string , pnum , 0 , ( mlt_destructor )mlt_properties_close, NULL );
180 f0r_param_info_t paraminfo;
181 param_info(¶minfo,j);
182 mlt_properties_set ( pnum , "identifier" , string );
183 mlt_properties_set ( pnum , "title" , paraminfo.name );
184 mlt_properties_set ( pnum , "description" , paraminfo.explanation);
185 if ( paraminfo.type == F0R_PARAM_DOUBLE ){
187 mlt_properties_set ( pnum , "type" , "float" );
188 mlt_properties_set ( pnum , "minimum" , "0" );
189 mlt_properties_set ( pnum , "maximum" , "1" );
190 f0r_get_param_value( instance, &deflt, j);
191 mlt_properties_set_double ( pnum, "default", CLAMP(deflt, 0.0, 1.0) );
192 mlt_properties_set ( pnum , "mutable" , "yes" );
193 mlt_properties_set ( pnum , "widget" , "spinner" );
195 if ( paraminfo.type == F0R_PARAM_BOOL ){
197 mlt_properties_set ( pnum , "type" , "boolean" );
198 mlt_properties_set ( pnum , "minimum" , "0" );
199 mlt_properties_set ( pnum , "maximum" , "1" );
200 f0r_get_param_value( instance, &deflt, j);
201 mlt_properties_set_int ( pnum, "default", deflt != 0.0 );
202 mlt_properties_set ( pnum , "mutable" , "yes" );
203 mlt_properties_set ( pnum , "widget" , "checkbox" );
205 if ( paraminfo.type == F0R_PARAM_COLOR ){
207 f0r_param_color_t deflt = {0, 0, 0};
209 mlt_properties_set ( pnum , "type" , "color" );
210 f0r_get_param_value( instance, &deflt, j);
211 sprintf( colorstr, "#%02x%02x%02x", (unsigned) CLAMP(deflt.r * 255, 0 , 255),
212 (unsigned) CLAMP(deflt.g * 255, 0 , 255), (unsigned) CLAMP(deflt.b * 255, 0 , 255));
214 mlt_properties_set ( pnum , "default", colorstr );
215 mlt_properties_set ( pnum , "mutable" , "yes" );
216 mlt_properties_set ( pnum , "widget" , "color" );
218 if ( paraminfo.type == F0R_PARAM_STRING ){
220 mlt_properties_set ( pnum , "type" , "string" );
221 f0r_get_param_value( instance, &deflt, j );
222 mlt_properties_set ( pnum , "default", deflt );
223 mlt_properties_set ( pnum , "mutable" , "yes" );
224 mlt_properties_set ( pnum , "widget" , "text" );
227 f0r_destruct(instance);
235 static void * load_lib( mlt_profile profile, mlt_service_type type , void* handle, const char *name ){
238 void (*f0r_get_plugin_info)(f0r_plugin_info_t*),
239 *f0r_construct , *f0r_update , *f0r_destruct,
240 (*f0r_get_param_info)(f0r_param_info_t* info, int param_index),
241 (*f0r_init)(void) , *f0r_deinit ,
242 (*f0r_set_param_value)(f0r_instance_t instance, f0r_param_t param, int param_index),
243 (*f0r_get_param_value)(f0r_instance_t instance, f0r_param_t param, int param_index),
244 (*f0r_update2) (f0r_instance_t instance, double time, const uint32_t* inframe1,
245 const uint32_t* inframe2,const uint32_t* inframe3, uint32_t* outframe);
247 if ( ( f0r_construct = dlsym(handle, "f0r_construct") ) &&
248 (f0r_destruct = dlsym(handle,"f0r_destruct") ) &&
249 (f0r_get_plugin_info = dlsym(handle,"f0r_get_plugin_info") ) &&
250 (f0r_get_param_info = dlsym(handle,"f0r_get_param_info") ) &&
251 (f0r_set_param_value= dlsym(handle,"f0r_set_param_value" ) ) &&
252 (f0r_get_param_value= dlsym(handle,"f0r_get_param_value" ) ) &&
253 (f0r_init= dlsym(handle,"f0r_init" ) ) &&
254 (f0r_deinit= dlsym(handle,"f0r_deinit" ) )
257 f0r_update=dlsym(handle,"f0r_update");
258 f0r_update2=dlsym(handle,"f0r_update2");
260 f0r_plugin_info_t info;
261 f0r_get_plugin_info(&info);
264 mlt_properties properties=NULL;
267 if (type == producer_type && info.plugin_type == F0R_PLUGIN_TYPE_SOURCE ){
268 mlt_producer this = mlt_producer_new( profile );
271 this->get_frame = producer_get_frame;
272 this->close = ( mlt_destructor )producer_close;
274 properties=MLT_PRODUCER_PROPERTIES ( this );
276 for (i=0;i<info.num_params;i++){
277 f0r_param_info_t pinfo;
278 f0r_get_param_info(&pinfo,i);
284 } else if (type == filter_type && info.plugin_type == F0R_PLUGIN_TYPE_FILTER ){
285 mlt_filter this = mlt_filter_new( );
288 this->process = filter_process;
289 this->close = filter_close;
291 properties=MLT_FILTER_PROPERTIES ( this );
293 for (i=0;i<info.num_params;i++){
294 f0r_param_info_t pinfo;
295 f0r_get_param_info(&pinfo,i);
301 }else if (type == transition_type && info.plugin_type == F0R_PLUGIN_TYPE_MIXER2){
302 mlt_transition transition = mlt_transition_new( );
303 if ( transition != NULL )
305 transition->process = transition_process;
306 transition->close = transition_close;
307 properties=MLT_TRANSITION_PROPERTIES( transition );
308 mlt_properties_set_int(properties, "_transition_type", 1 );
313 check_thread_safe( properties, name );
314 mlt_properties_set_data(properties, "_dlclose_handle", handle , sizeof ( handle ) , NULL , NULL );
315 mlt_properties_set_data(properties, "_dlclose", dlclose , sizeof (void*) , NULL , NULL );
316 mlt_properties_set_data(properties, "f0r_construct", f0r_construct , sizeof( f0r_construct ),NULL,NULL);
317 mlt_properties_set_data(properties, "f0r_update", f0r_update , sizeof( f0r_update ),NULL,NULL);
319 mlt_properties_set_data(properties, "f0r_update2", f0r_update2 , sizeof( f0r_update2 ),NULL,NULL);
320 mlt_properties_set_data(properties, "f0r_destruct", f0r_destruct , sizeof( f0r_destruct ),NULL,NULL);
321 mlt_properties_set_data(properties, "f0r_get_plugin_info", f0r_get_plugin_info , sizeof(void*),NULL,NULL);
322 mlt_properties_set_data(properties, "f0r_get_param_info", f0r_get_param_info , sizeof(void*),NULL,NULL);
323 mlt_properties_set_data(properties, "f0r_set_param_value", f0r_set_param_value , sizeof(void*),NULL,NULL);
324 mlt_properties_set_data(properties, "f0r_get_param_value", f0r_get_param_value , sizeof(void*),NULL,NULL);
326 // Let frei0r plugin version be serialized using same format as metadata
327 snprintf( minor, sizeof( minor ), "%d", info.minor_version );
328 mlt_properties_set_double( properties, "version", info.major_version + info.minor_version / pow( 10, strlen( minor ) ) );
330 // Use the global param name map for backwards compatibility when
331 // param names change and setting frei0r params by name instead of index.
332 mlt_properties param_name_map = mlt_properties_get_data( mlt_global_properties(), "frei0r.param_name_map", NULL );
333 if ( param_name_map ) {
334 // Lookup my plugin in the map
335 param_name_map = mlt_properties_get_data( param_name_map, name, NULL );
336 mlt_properties_set_data( properties, "_param_name_map", param_name_map, 0, NULL, NULL );
341 mlt_log_error( NULL, "frei0r plugin \"%s\" is missing a function\n", name );
347 static void * create_frei0r_item ( mlt_profile profile, mlt_service_type type, const char *id, void *arg){
349 mlt_tokeniser tokeniser = mlt_tokeniser_init ( );
350 char *frei0r_path = get_frei0r_path();
351 int dircount=mlt_tokeniser_parse_new (
358 char soname[PATH_MAX];
359 char *myid = strdup( id );
362 char *firstname = strtok( myid, "." );
364 char *save_firstptr = NULL;
365 char *firstname = strtok_r( myid, ".", &save_firstptr );
367 char* directory = mlt_tokeniser_get_string (tokeniser, dircount);
370 firstname = strtok( NULL, "." );
372 firstname = strtok_r( NULL, ".", &save_firstptr );
374 if (strncmp(directory, "$HOME", 5))
375 snprintf(soname, PATH_MAX, "%s/%s" LIBSUF, directory, firstname );
377 snprintf(soname, PATH_MAX, "%s%s/%s" LIBSUF, getenv("HOME"), strchr(directory, '/'), firstname );
381 void* handle=dlopen(soname,RTLD_LAZY);
384 ret=load_lib ( profile , type , handle, firstname );
391 mlt_tokeniser_close ( tokeniser );
400 mlt_tokeniser tokeniser = mlt_tokeniser_init ( );
401 char *frei0r_path = get_frei0r_path();
402 int dircount=mlt_tokeniser_parse_new (
407 char dirname[PATH_MAX];
408 snprintf( dirname, PATH_MAX, "%s/frei0r/blacklist.txt", mlt_environment( "MLT_DATA" ) );
409 mlt_properties blacklist = mlt_properties_load( dirname );
411 // Load a param name map into global properties for backwards compatibility when
412 // param names change and setting frei0r params by name instead of index.
413 snprintf( dirname, PATH_MAX, "%s/frei0r/param_name_map.yml", mlt_environment( "MLT_DATA" ) );
414 mlt_properties_set_data( mlt_global_properties(), "frei0r.param_name_map",
415 mlt_properties_parse_yaml( dirname ), 0, (mlt_destructor) mlt_properties_close, NULL );
419 mlt_properties direntries = mlt_properties_new();
420 char* directory = mlt_tokeniser_get_string (tokeniser, dircount);
422 if (strncmp(directory, "$HOME", 5))
423 snprintf(dirname, PATH_MAX, "%s", directory);
425 snprintf(dirname, PATH_MAX, "%s%s", getenv("HOME"), strchr(directory, '/'));
426 mlt_properties_dir_list(direntries, dirname ,"*" LIBSUF, 1);
428 for (i=0; i<mlt_properties_count(direntries);i++){
429 char* name=mlt_properties_get_value(direntries,i);
430 char* shortname=name+strlen(dirname)+1;
432 char* firstname = strtok( shortname, "." );
434 char *save_firstptr = NULL;
435 char* firstname = strtok_r( shortname, ".", &save_firstptr );
437 char pluginname[1024]="frei0r.";
439 strncat( pluginname, firstname, sizeof( pluginname ) - strlen( pluginname ) -1 );
441 if ( firstname && mlt_properties_get( blacklist, firstname ) )
444 void* handle=dlopen(strcat(name, LIBSUF),RTLD_LAZY);
446 void (*plginfo)(f0r_plugin_info_t*)=dlsym(handle,"f0r_get_plugin_info");
449 f0r_plugin_info_t info;
451 if (firstname && info.plugin_type==F0R_PLUGIN_TYPE_SOURCE){
452 if (mlt_properties_get(mlt_repository_producers(repository), pluginname))
457 MLT_REGISTER( producer_type, pluginname, create_frei0r_item );
458 MLT_REGISTER_METADATA( producer_type, pluginname, fill_param_info, strdup(name) );
460 else if (firstname && info.plugin_type==F0R_PLUGIN_TYPE_FILTER){
461 if (mlt_properties_get(mlt_repository_filters(repository), pluginname))
466 MLT_REGISTER( filter_type, pluginname, create_frei0r_item );
467 MLT_REGISTER_METADATA( filter_type, pluginname, fill_param_info, strdup(name) );
469 else if (firstname && info.plugin_type==F0R_PLUGIN_TYPE_MIXER2 ){
470 if (mlt_properties_get(mlt_repository_transitions(repository), pluginname))
475 MLT_REGISTER( transition_type, pluginname, create_frei0r_item );
476 MLT_REGISTER_METADATA( transition_type, pluginname, fill_param_info, strdup(name) );
482 mlt_properties_close(direntries);
484 mlt_tokeniser_close ( tokeniser );
485 mlt_properties_close( blacklist );