2fe0c7a978a0ccc8bee0a5ca5c30585fa1d17e8c
[melted] / src / miracle / miracle_unit.c
1 /*
2 * miracle_unit.c -- DV Transmission Unit Implementation
3 * Copyright (C) 2002-2003 Ushodaya Enterprises Limited
4 * Author: Dan Dennedy <dan@dennedy.org>
5 *
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.
10 *
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.
15 *
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.
19 */
20
21 #ifdef HAVE_CONFIG_H
22 #include <config.h>
23 #endif
24
25 #include <stdio.h>
26 #include <unistd.h>
27 #include <sys/ioctl.h>
28 #include <sys/mman.h>
29 #include <sys/poll.h>
30 #include <sys/types.h>
31 #include <fcntl.h>
32 #include <stdlib.h>
33 #include <string.h>
34 #include <errno.h>
35 #include <signal.h>
36 #include <limits.h>
37
38 #include <sys/mman.h>
39
40 #include "miracle_unit.h"
41 #include "miracle_log.h"
42 #include "miracle_local.h"
43
44 #include <framework/mlt.h>
45
46 /* Forward references */
47 static void miracle_unit_status_communicate( miracle_unit );
48
49 /** Allocate a new DV transmission unit.
50
51 \return A new miracle_unit handle.
52 */
53
54 miracle_unit miracle_unit_init( int index, char *constructor )
55 {
56 miracle_unit this = NULL;
57 mlt_consumer consumer = NULL;
58
59 char *id = strdup( constructor );
60 char *arg = strchr( id, ':' );
61
62 if ( arg != NULL )
63 *arg ++ = '\0';
64
65 consumer = mlt_factory_consumer( id, arg );
66
67 if ( consumer != NULL )
68 {
69 mlt_playlist playlist = mlt_playlist_init( );
70 this = calloc( sizeof( miracle_unit_t ), 1 );
71 this->properties = mlt_properties_new( );
72 this->producers = mlt_properties_new( );
73 mlt_properties_init( this->properties, this );
74 mlt_properties_set_int( this->properties, "unit", index );
75 mlt_properties_set_int( this->properties, "generation", 0 );
76 mlt_properties_set( this->properties, "constructor", constructor );
77 mlt_properties_set( this->properties, "id", id );
78 mlt_properties_set( this->properties, "arg", arg );
79 mlt_properties_set_data( this->properties, "consumer", consumer, 0, ( mlt_destructor )mlt_consumer_close, NULL );
80 mlt_properties_set_data( this->properties, "playlist", playlist, 0, ( mlt_destructor )mlt_playlist_close, NULL );
81 mlt_consumer_connect( consumer, mlt_playlist_service( playlist ) );
82 }
83
84 return this;
85 }
86
87 static char *strip_root( miracle_unit unit, char *file )
88 {
89 mlt_properties properties = unit->properties;
90 char *root = mlt_properties_get( properties, "root" );
91 if ( file != NULL && root != NULL )
92 {
93 int length = strlen( root );
94 if ( root[ length - 1 ] == '/' )
95 length --;
96 if ( !strncmp( file, root, length ) )
97 file += length;
98 }
99 return file;
100 }
101
102 /** Communicate the current status to all threads waiting on the notifier.
103 */
104
105 static void miracle_unit_status_communicate( miracle_unit unit )
106 {
107 if ( unit != NULL )
108 {
109 mlt_properties properties = unit->properties;
110 char *root_dir = mlt_properties_get( properties, "root" );
111 valerie_notifier notifier = mlt_properties_get_data( properties, "notifier", NULL );
112 valerie_status_t status;
113
114 if ( root_dir != NULL && notifier != NULL )
115 {
116 if ( miracle_unit_get_status( unit, &status ) == 0 )
117 /* if ( !( ( status.status == unit_playing || status.status == unit_paused ) &&
118 strcmp( status.clip, "" ) &&
119 !strcmp( status.tail_clip, "" ) &&
120 status.position == 0 &&
121 status.in == 0 &&
122 status.out == 0 ) ) */
123 valerie_notifier_put( notifier, &status );
124 }
125 }
126 }
127
128 /** Set the notifier info
129 */
130
131 void miracle_unit_set_notifier( miracle_unit this, valerie_notifier notifier, char *root_dir )
132 {
133 mlt_properties properties = this->properties;
134 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
135 mlt_properties playlist_properties = mlt_playlist_properties( playlist );
136
137 mlt_properties_set( properties, "root", root_dir );
138 mlt_properties_set_data( properties, "notifier", notifier, 0, NULL, NULL );
139 mlt_properties_set_data( playlist_properties, "notifier_arg", this, 0, NULL, NULL );
140 mlt_properties_set_data( playlist_properties, "notifier", miracle_unit_status_communicate, 0, NULL, NULL );
141
142 miracle_unit_status_communicate( this );
143 }
144
145 static mlt_producer create_producer( char *file )
146 {
147 return mlt_factory_producer( "fezzik", file );
148 }
149
150 /** Create or locate a producer for the file specified.
151 */
152
153 static mlt_producer locate_producer( miracle_unit unit, char *file )
154 {
155 // Get the unit properties
156 mlt_properties properties = unit->producers;
157
158 // Check if we already have loaded this file
159 mlt_producer result = mlt_properties_get_data( properties, file, NULL );
160
161 if ( result == NULL )
162 {
163 // Create the producer
164 result = create_producer( file );
165
166 // Now store the result
167 if ( result != NULL )
168 mlt_properties_set_data( properties, file, result, 0, ( mlt_destructor )mlt_producer_close, NULL );
169 }
170
171 return result;
172 }
173
174 /** Update the generation count.
175 */
176
177 static void update_generation( miracle_unit unit )
178 {
179 mlt_properties properties = unit->properties;
180 int generation = mlt_properties_get_int( properties, "generation" );
181 mlt_properties_set_int( properties, "generation", ++ generation );
182 }
183
184 /** Wipe all clips on the playlist for this unit.
185 */
186
187 static void clear_unit( miracle_unit unit )
188 {
189 mlt_properties properties = unit->properties;
190 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
191 mlt_producer producer = mlt_playlist_producer( playlist );
192
193 mlt_playlist_clear( playlist );
194 mlt_producer_seek( producer, 0 );
195
196 if ( unit->old_producers != NULL )
197 mlt_properties_close( unit->old_producers );
198 unit->old_producers = unit->producers;
199 unit->producers = mlt_properties_new( );
200
201 update_generation( unit );
202 }
203
204 /** Wipe all but the playing clip from the unit.
205 */
206
207 static void clean_unit( miracle_unit unit )
208 {
209 mlt_properties properties = unit->properties;
210 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
211 mlt_playlist_clip_info info;
212 int current = mlt_playlist_current_clip( playlist );
213 mlt_producer producer = mlt_playlist_producer( playlist );
214 mlt_position position = mlt_producer_frame( producer );
215 double speed = mlt_producer_get_speed( producer );
216 mlt_playlist_get_clip_info( playlist, &info, current );
217
218 if ( info.resource != NULL )
219 {
220 void *instance = mlt_properties_get_data( unit->producers, info.resource, NULL );
221 position -= info.start;
222 mlt_properties_set_data( unit->producers, info.resource, instance, 0, NULL, NULL );
223 clear_unit( unit );
224 mlt_playlist_append_io( playlist, instance, info.frame_in, info.frame_out );
225 mlt_properties_set_data( unit->producers, info.resource, instance, 0, ( mlt_destructor )mlt_producer_close, NULL );
226 mlt_producer_seek( producer, position );
227 mlt_producer_set_speed( producer, speed );
228 }
229
230 update_generation( unit );
231 }
232
233 /** Generate a report on all loaded clips.
234 */
235
236 void miracle_unit_report_list( miracle_unit unit, valerie_response response )
237 {
238 int i;
239 mlt_properties properties = unit->properties;
240 int generation = mlt_properties_get_int( properties, "generation" );
241 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
242
243 valerie_response_printf( response, 1024, "%d\n", generation );
244
245 for ( i = 0; i < mlt_playlist_count( playlist ); i ++ )
246 {
247 mlt_playlist_clip_info info;
248 mlt_playlist_get_clip_info( playlist , &info, i );
249 valerie_response_printf( response, 10240, "%d \"%s\" %d %d %d %d %.2f\n",
250 i,
251 strip_root( unit, info.resource ),
252 info.frame_in,
253 info.frame_out,
254 info.frame_count,
255 info.length,
256 info.fps );
257 }
258 valerie_response_printf( response, 1024, "\n" );
259 }
260
261 /** Load a clip into the unit clearing existing play list.
262
263 \todo error handling
264 \param unit A miracle_unit handle.
265 \param clip The absolute file name of the clip to load.
266 \param in The starting frame (-1 for 0)
267 \param out The ending frame (-1 for maximum)
268 */
269
270 valerie_error_code miracle_unit_load( miracle_unit unit, char *clip, int32_t in, int32_t out, int flush )
271 {
272 // Now try to create an producer
273 mlt_producer instance = create_producer( clip );
274
275 if ( instance != NULL )
276 {
277 clear_unit( unit );
278 mlt_properties properties = unit->properties;
279 mlt_properties_set_data( unit->producers, clip, instance, 0, ( mlt_destructor )mlt_producer_close, NULL );
280 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
281 mlt_consumer consumer = mlt_properties_get_data( unit->properties, "consumer", NULL );
282 mlt_consumer_purge( consumer );
283 mlt_playlist_append_io( playlist, instance, in, out );
284 miracle_log( LOG_DEBUG, "loaded clip %s", clip );
285 miracle_unit_status_communicate( unit );
286 return valerie_ok;
287 }
288
289 return valerie_invalid_file;
290 }
291
292 valerie_error_code miracle_unit_insert( miracle_unit unit, char *clip, int index, int32_t in, int32_t out )
293 {
294 mlt_producer instance = locate_producer( unit, clip );
295
296 if ( instance != NULL )
297 {
298 mlt_properties properties = unit->properties;
299 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
300 fprintf( stderr, "inserting clip %s before %d\n", clip, index );
301 mlt_playlist_insert( playlist, instance, index, in, out );
302 miracle_log( LOG_DEBUG, "inserted clip %s at %d", clip, index );
303 update_generation( unit );
304 miracle_unit_status_communicate( unit );
305 return valerie_ok;
306 }
307
308 return valerie_invalid_file;
309 }
310
311 valerie_error_code miracle_unit_remove( miracle_unit unit, int index )
312 {
313 mlt_properties properties = unit->properties;
314 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
315 mlt_playlist_remove( playlist, index );
316 miracle_log( LOG_DEBUG, "removed clip at %d", index );
317 update_generation( unit );
318 miracle_unit_status_communicate( unit );
319 return valerie_ok;
320 }
321
322 valerie_error_code miracle_unit_clean( miracle_unit unit )
323 {
324 clean_unit( unit );
325 miracle_log( LOG_DEBUG, "Cleaned playlist" );
326 miracle_unit_status_communicate( unit );
327 return valerie_ok;
328 }
329
330 valerie_error_code miracle_unit_clear( miracle_unit unit )
331 {
332 mlt_consumer consumer = mlt_properties_get_data( unit->properties, "consumer", NULL );
333 clear_unit( unit );
334 mlt_consumer_purge( consumer );
335 miracle_log( LOG_DEBUG, "Cleared playlist" );
336 miracle_unit_status_communicate( unit );
337 return valerie_ok;
338 }
339
340 valerie_error_code miracle_unit_move( miracle_unit unit, int src, int dest )
341 {
342 mlt_properties properties = unit->properties;
343 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
344 mlt_playlist_move( playlist, src, dest );
345 miracle_log( LOG_DEBUG, "moved clip %d to %d", src, dest );
346 update_generation( unit );
347 miracle_unit_status_communicate( unit );
348 return valerie_ok;
349 }
350
351 /** Add a clip to the unit play list.
352
353 \todo error handling
354 \param unit A miracle_unit handle.
355 \param clip The absolute file name of the clip to load.
356 \param in The starting frame (-1 for 0)
357 \param out The ending frame (-1 for maximum)
358 */
359
360 valerie_error_code miracle_unit_append( miracle_unit unit, char *clip, int32_t in, int32_t out )
361 {
362 mlt_producer instance = locate_producer( unit, clip );
363
364 if ( instance != NULL )
365 {
366 mlt_properties properties = unit->properties;
367 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
368 mlt_playlist_append_io( playlist, instance, in, out );
369 miracle_log( LOG_DEBUG, "appended clip %s", clip );
370 update_generation( unit );
371 miracle_unit_status_communicate( unit );
372 return valerie_ok;
373 }
374
375 return valerie_invalid_file;
376 }
377
378 /** Start playing the unit.
379
380 \todo error handling
381 \param unit A miracle_unit handle.
382 \param speed An integer that specifies the playback rate as a
383 percentage multiplied by 100.
384 */
385
386 void miracle_unit_play( miracle_unit_t *unit, int speed )
387 {
388 mlt_properties properties = unit->properties;
389 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
390 mlt_producer producer = mlt_playlist_producer( playlist );
391 mlt_consumer consumer = mlt_properties_get_data( unit->properties, "consumer", NULL );
392 mlt_producer_set_speed( producer, ( double )speed / 1000 );
393 mlt_consumer_start( consumer );
394 miracle_unit_status_communicate( unit );
395 }
396
397 /** Stop playback.
398
399 Terminates the dv_pump and halts dv1394 transmission.
400
401 \param unit A miracle_unit handle.
402 */
403
404 void miracle_unit_terminate( miracle_unit unit )
405 {
406 mlt_consumer consumer = mlt_properties_get_data( unit->properties, "consumer", NULL );
407 mlt_playlist playlist = mlt_properties_get_data( unit->properties, "playlist", NULL );
408 mlt_producer producer = mlt_playlist_producer( playlist );
409 mlt_producer_set_speed( producer, 0 );
410 mlt_consumer_stop( consumer );
411 miracle_unit_status_communicate( unit );
412 }
413
414 /** Query the status of unit playback.
415
416 \param unit A miracle_unit handle.
417 \return 1 if the unit is not playing, 0 if playing.
418 */
419
420 int miracle_unit_has_terminated( miracle_unit unit )
421 {
422 mlt_consumer consumer = mlt_properties_get_data( unit->properties, "consumer", NULL );
423 return mlt_consumer_is_stopped( consumer );
424 }
425
426 /** Transfer the currently loaded clip to another unit
427 */
428
429 int miracle_unit_transfer( miracle_unit dest_unit, miracle_unit src_unit )
430 {
431 int i;
432 mlt_properties dest_properties = dest_unit->properties;
433 mlt_playlist dest_playlist = mlt_properties_get_data( dest_properties, "playlist", NULL );
434 mlt_properties src_properties = src_unit->properties;
435 mlt_playlist src_playlist = mlt_properties_get_data( src_properties, "playlist", NULL );
436
437 for ( i = 0; i < mlt_playlist_count( src_playlist ); i ++ )
438 {
439 mlt_playlist_clip_info info;
440 mlt_playlist_get_clip_info( src_playlist, &info, i );
441 mlt_producer producer = locate_producer( dest_unit, info.resource );
442 if ( producer != NULL )
443 {
444 mlt_playlist_append_io( dest_playlist, producer, info.frame_in, info.frame_out );
445 if ( i == 0 )
446 {
447 miracle_unit_change_position( dest_unit, mlt_playlist_count( dest_playlist ) - 1, 0 );
448 clean_unit( dest_unit );
449 }
450 }
451 }
452
453 return 0;
454 }
455
456 /** Determine if unit is offline.
457 */
458
459 int miracle_unit_is_offline( miracle_unit unit )
460 {
461 return 0;
462 }
463
464 /** Obtain the status for a given unit
465 */
466
467 int miracle_unit_get_status( miracle_unit unit, valerie_status status )
468 {
469 int error = unit == NULL;
470
471 memset( status, 0, sizeof( valerie_status_t ) );
472
473 if ( !error )
474 {
475 mlt_properties properties = unit->properties;
476 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
477 mlt_producer producer = mlt_playlist_producer( playlist );
478 mlt_producer clip = mlt_playlist_current( playlist );
479
480 mlt_playlist_clip_info info;
481 int clip_index = mlt_playlist_current_clip( playlist );
482 mlt_playlist_get_clip_info( playlist, &info, clip_index );
483
484 if ( info.resource != NULL && strcmp( info.resource, "" ) )
485 {
486 strncpy( status->clip, strip_root( unit, info.resource ), sizeof( status->clip ) );
487 status->speed = (int)( mlt_producer_get_speed( producer ) * 1000.0 );
488 status->fps = mlt_producer_get_fps( producer );
489 status->in = info.frame_in;
490 status->out = info.frame_out;
491 status->position = mlt_producer_position( clip );
492 status->length = mlt_producer_get_length( clip );
493 strncpy( status->tail_clip, strip_root( unit, info.resource ), sizeof( status->tail_clip ) );
494 status->tail_in = info.frame_in;
495 status->tail_out = info.frame_out;
496 status->tail_position = mlt_producer_position( clip );
497 status->tail_length = mlt_producer_get_length( clip );
498 status->clip_index = mlt_playlist_current_clip( playlist );
499 status->seek_flag = 1;
500 }
501
502 status->generation = mlt_properties_get_int( properties, "generation" );
503
504 if ( miracle_unit_has_terminated( unit ) )
505 status->status = unit_stopped;
506 else if ( !strcmp( status->clip, "" ) )
507 status->status = unit_not_loaded;
508 else if ( status->speed == 0 )
509 status->status = unit_paused;
510 else
511 status->status = unit_playing;
512 }
513 else
514 {
515 status->status = unit_undefined;
516 }
517
518 status->unit = mlt_properties_get_int( unit->properties, "unit" );
519
520 return error;
521 }
522
523 /** Change position in the playlist.
524 */
525
526 void miracle_unit_change_position( miracle_unit unit, int clip, int32_t position )
527 {
528 mlt_properties properties = unit->properties;
529 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
530 mlt_producer producer = mlt_playlist_producer( playlist );
531 mlt_playlist_clip_info info;
532
533 if ( clip < 0 )
534 {
535 clip = 0;
536 position = 0;
537 }
538 else if ( clip >= mlt_playlist_count( playlist ) )
539 {
540 clip = mlt_playlist_count( playlist ) - 1;
541 position = LONG_MAX;
542 }
543
544 if ( mlt_playlist_get_clip_info( playlist, &info, clip ) == 0 )
545 {
546 int32_t frame_start = info.start;
547 int32_t frame_offset = position;
548
549 if ( frame_offset < 0 )
550 frame_offset = info.frame_out;
551 if ( frame_offset < info.frame_in )
552 frame_offset = info.frame_in;
553 if ( frame_offset >= info.frame_out )
554 frame_offset = info.frame_out;
555
556 mlt_producer_seek( producer, frame_start + frame_offset - info.frame_in );
557 }
558
559 miracle_unit_status_communicate( unit );
560 }
561
562 /** Get the index of the current clip.
563 */
564
565 int miracle_unit_get_current_clip( miracle_unit unit )
566 {
567 mlt_properties properties = unit->properties;
568 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
569 int clip_index = mlt_playlist_current_clip( playlist );
570 return clip_index;
571 }
572
573 /** Set a clip's in point
574 */
575
576 int miracle_unit_set_clip_in( miracle_unit unit, int index, int32_t position )
577 {
578 mlt_properties properties = unit->properties;
579 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
580 mlt_playlist_clip_info info;
581 int error = mlt_playlist_get_clip_info( playlist, &info, index );
582
583 if ( error == 0 )
584 {
585 miracle_unit_play( unit, 0 );
586 error = mlt_playlist_resize_clip( playlist, index, position, info.frame_out );
587 update_generation( unit );
588 miracle_unit_change_position( unit, index, 0 );
589 }
590
591 return error;
592 }
593
594 /** Set a clip's out point.
595 */
596
597 int miracle_unit_set_clip_out( miracle_unit unit, int index, int32_t position )
598 {
599 mlt_properties properties = unit->properties;
600 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
601 mlt_playlist_clip_info info;
602 int error = mlt_playlist_get_clip_info( playlist, &info, index );
603
604 if ( error == 0 )
605 {
606 miracle_unit_play( unit, 0 );
607 error = mlt_playlist_resize_clip( playlist, index, info.frame_in, position );
608 update_generation( unit );
609 miracle_unit_status_communicate( unit );
610 miracle_unit_change_position( unit, index, -1 );
611 }
612
613 return error;
614 }
615
616 /** Step by specified position.
617 */
618
619 void miracle_unit_step( miracle_unit unit, int32_t offset )
620 {
621 mlt_properties properties = unit->properties;
622 mlt_playlist playlist = mlt_properties_get_data( properties, "playlist", NULL );
623 mlt_producer producer = mlt_playlist_producer( playlist );
624 mlt_position position = mlt_producer_frame( producer );
625 mlt_producer_seek( producer, position + offset );
626 }
627
628 /** Set the unit's clip mode regarding in and out points.
629 */
630
631 //void miracle_unit_set_mode( miracle_unit unit, dv_player_clip_mode mode )
632 //{
633 //dv_player player = miracle_unit_get_dv_player( unit );
634 //if ( player != NULL )
635 //dv_player_set_clip_mode( player, mode );
636 //miracle_unit_status_communicate( unit );
637 //}
638
639 /** Get the unit's clip mode regarding in and out points.
640 */
641
642 //dv_player_clip_mode miracle_unit_get_mode( miracle_unit unit )
643 //{
644 //dv_player player = miracle_unit_get_dv_player( unit );
645 //return dv_player_get_clip_mode( player );
646 //}
647
648 /** Set the unit's clip mode regarding eof handling.
649 */
650
651 //void miracle_unit_set_eof_action( miracle_unit unit, dv_player_eof_action action )
652 //{
653 //dv_player player = miracle_unit_get_dv_player( unit );
654 //dv_player_set_eof_action( player, action );
655 //miracle_unit_status_communicate( unit );
656 //}
657
658 /** Get the unit's clip mode regarding eof handling.
659 */
660
661 //dv_player_eof_action miracle_unit_get_eof_action( miracle_unit unit )
662 //{
663 //dv_player player = miracle_unit_get_dv_player( unit );
664 //return dv_player_get_eof_action( player );
665 //}
666
667 int miracle_unit_set( miracle_unit unit, char *name_value )
668 {
669 mlt_properties properties = NULL;
670
671 if ( strncmp( name_value, "consumer.", 9 ) )
672 {
673 mlt_playlist playlist = mlt_properties_get_data( unit->properties, "playlist", NULL );
674 properties = mlt_playlist_properties( playlist );
675 }
676 else
677 {
678 mlt_consumer consumer = mlt_properties_get_data( unit->properties, "consumer", NULL );
679 properties = mlt_consumer_properties( consumer );
680 name_value += 9;
681 }
682
683 return mlt_properties_parse( properties, name_value );
684 }
685
686 char *miracle_unit_get( miracle_unit unit, char *name )
687 {
688 mlt_playlist playlist = mlt_properties_get_data( unit->properties, "playlist", NULL );
689 mlt_properties properties = mlt_playlist_properties( playlist );
690 return mlt_properties_get( properties, name );
691 }
692
693 /** Release the unit
694
695 \todo error handling
696 \param unit A miracle_unit handle.
697 */
698
699 void miracle_unit_close( miracle_unit unit )
700 {
701 if ( unit != NULL )
702 {
703 miracle_log( LOG_DEBUG, "closing unit..." );
704 miracle_unit_terminate( unit );
705 if ( unit->old_producers != NULL )
706 mlt_properties_close( unit->old_producers );
707 mlt_properties_close( unit->properties );
708 mlt_properties_close( unit->producers );
709 free( unit );
710 miracle_log( LOG_DEBUG, "... unit closed." );
711 }
712 }
713