-/*
- * mlt_service.c -- interface for all service classes
- * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
- * Author: Charles Yates <charles.yates@pandora.be>
+/**
+ * \file mlt_service.c
+ * \brief interface definition for all service classes
+ * \see mlt_service_s
+ *
+ * Copyright (C) 2003-2009 Ushodaya Enterprises Limited
+ * \author Charles Yates <charles.yates@pandora.be>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
#include "mlt_service.h"
#include "mlt_filter.h"
#include "mlt_frame.h"
+#include "mlt_cache.h"
+#include "mlt_factory.h"
+#include "mlt_log.h"
+
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <pthread.h>
-/** IMPORTANT NOTES
+
+/* IMPORTANT NOTES
The base service implements a null frame producing service - as such,
- it is functional without extension and will produce test cards frames
+ it is functional without extension and will produce test cards frames
and PAL sized audio frames.
- PLEASE DO NOT CHANGE THIS BEHAVIOUR!!! OVERRIDE THE METHODS THAT
+ PLEASE DO NOT CHANGE THIS BEHAVIOUR!!! OVERRIDE THE METHODS THAT
CONTROL THIS IN EXTENDING CLASSES.
*/
-/** Private service definition.
-*/
+/** \brief private service definition */
typedef struct
{
}
mlt_service_base;
-/** Private methods
-*/
+/* Private methods
+ */
static void mlt_service_disconnect( mlt_service this );
static void mlt_service_connect( mlt_service this, mlt_service that );
static int service_get_frame( mlt_service this, mlt_frame_ptr frame, int index );
static void mlt_service_property_changed( mlt_listener, mlt_properties owner, mlt_service this, void **args );
+static void purge_cache( mlt_service self );
-/** Constructor
-*/
+/** Initialize a service.
+ *
+ * \public \memberof mlt_service_s
+ * \param this the service structure to initialize
+ * \param child pointer to the child object for the subclass
+ * \return true if there was an error
+ */
int mlt_service_init( mlt_service this, void *child )
{
// Associate the methods
this->get_frame = service_get_frame;
-
+
// Initialise the properties
error = mlt_properties_init( &this->parent, this );
if ( error == 0 )
return error;
}
+/** The transmitter for property changes.
+ *
+ * Invokes the listener.
+ *
+ * \private \memberof mlt_service_s
+ * \param listener a function pointer that will be invoked
+ * \param owner a properties list that will be passed to \p listener
+ * \param this a service that will be passed to \p listener
+ * \param args an array of pointers - the first entry is passed as a string to \p listener
+ */
+
static void mlt_service_property_changed( mlt_listener listener, mlt_properties owner, mlt_service this, void **args )
{
if ( listener != NULL )
listener( owner, this, ( char * )args[ 0 ] );
}
+/** Acquire a mutual exclusion lock on this service.
+ *
+ * \public \memberof mlt_service_s
+ * \param this the service to lock
+ */
+
void mlt_service_lock( mlt_service this )
{
if ( this != NULL )
pthread_mutex_lock( &( ( mlt_service_base * )this->local )->mutex );
}
+/** Release a mutual exclusion lock on this service.
+ *
+ * \public \memberof mlt_service_s
+ * \param this the service to unlock
+ */
+
void mlt_service_unlock( mlt_service this )
{
if ( this != NULL )
pthread_mutex_unlock( &( ( mlt_service_base * )this->local )->mutex );
}
+/** Identify the subclass of the service.
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \return the subclass
+ */
+
mlt_service_type mlt_service_identify( mlt_service this )
{
mlt_service_type type = invalid_type;
char *resource = mlt_properties_get( properties, "resource" );
if ( mlt_type == NULL )
type = unknown_type;
- else if ( resource == NULL || !strcmp( resource, "<producer>" ) )
- type = producer_type;
- else if ( !strcmp( resource, "<playlist>" ) )
+ else if (resource != NULL && !strcmp( resource, "<playlist>" ) )
type = playlist_type;
- else if ( !strcmp( resource, "<tractor>" ) )
+ else if (resource != NULL && !strcmp( resource, "<tractor>" ) )
type = tractor_type;
- else if ( !strcmp( resource, "<multitrack>" ) )
+ else if (resource != NULL && !strcmp( resource, "<multitrack>" ) )
type = multitrack_type;
else if ( !strcmp( mlt_type, "producer" ) )
type = producer_type;
return type;
}
-/** Connect a producer service.
- Returns: > 0 warning, == 0 success, < 0 serious error
- 1 = this service does not accept input
- 2 = the producer is invalid
- 3 = the producer is already registered with this consumer
-*/
+/** Connect a producer to the service.
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \param producer a producer
+ * \param index which of potentially multiple producers to this service (0 based)
+ * \return > 0 warning, == 0 success, < 0 serious error,
+ * 1 = this service does not accept input,
+ * 2 = the producer is invalid,
+ * 3 = the producer is already registered with this consumer
+ */
int mlt_service_connect_producer( mlt_service this, mlt_service producer, int index )
{
// Increment the reference count on this producer
if ( producer != NULL )
- {
- mlt_service_lock( producer );
mlt_properties_inc_ref( MLT_SERVICE_PROPERTIES( producer ) );
- mlt_service_unlock( producer );
- }
// Now we disconnect the producer service from its consumer
mlt_service_disconnect( producer );
-
+
// Add the service to index specified
base->in[ index ] = producer;
-
+
// Determine the number of active tracks
if ( index >= base->count )
base->count = index + 1;
}
/** Disconnect this service from its consumer.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ */
static void mlt_service_disconnect( mlt_service this )
{
}
/** Obtain the consumer this service is connected to.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \return the consumer
+ */
mlt_service mlt_service_consumer( mlt_service this )
{
}
/** Obtain the producer this service is connected to.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \return the last-most producer
+ */
mlt_service mlt_service_producer( mlt_service this )
{
return base->count > 0 ? base->in[ base->count - 1 ] : NULL;
}
-/** Associate this service to the consumer.
-*/
+/** Associate this service to a consumer.
+ *
+ * Overwrites connection to any existing consumer.
+ * \private \memberof mlt_service_s
+ * \param this a service
+ * \param that a consumer
+ */
static void mlt_service_connect( mlt_service this, mlt_service that )
{
}
}
-/** Get the first connected producer service.
-*/
+/** Get the first connected producer.
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \return the first producer
+ */
mlt_service mlt_service_get_producer( mlt_service this )
{
if ( base->in != NULL )
producer = base->in[ 0 ];
-
+
return producer;
}
-/** Default implementation of get_frame.
-*/
+/** Default implementation of the get_frame virtual function.
+ *
+ * \private \memberof mlt_service_s
+ * \param this a service
+ * \param[out] frame a frame by reference
+ * \param index as determined by the producer
+ * \return false
+ */
static int service_get_frame( mlt_service this, mlt_frame_ptr frame, int index )
{
}
/** Return the properties object.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \return the properties
+ */
-mlt_properties mlt_service_properties( mlt_service self )
+mlt_properties mlt_service_properties( mlt_service this )
{
- return self != NULL ? &self->parent : NULL;
+ return this != NULL ? &this->parent : NULL;
}
-/** Recursively apply attached filters
-*/
+/** Recursively apply attached filters.
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \param frame a frame
+ * \param index used to track depth of recursion, top caller should supply 0
+ */
void mlt_service_apply_filters( mlt_service this, mlt_frame frame, int index )
{
}
/** Obtain a frame.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \param[out] frame a frame by reference
+ * \param index as determined by the producer
+ * \return true if there was an error
+ */
int mlt_service_get_frame( mlt_service this, mlt_frame_ptr frame, int index )
{
return result;
}
+/** The service-changed event handler.
+ *
+ * \private \memberof mlt_service_s
+ * \param owner ignored
+ * \param this the service on which the "service-changed" event is fired
+ */
+
static void mlt_service_filter_changed( mlt_service owner, mlt_service this )
{
mlt_events_fire( MLT_SERVICE_PROPERTIES( this ), "service-changed", NULL );
}
/** Attach a filter.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \param filter the filter to attach
+ * \return true if there was an error
+ */
int mlt_service_attach( mlt_service this, mlt_filter filter )
{
}
/** Detach a filter.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \param filter the filter to detach
+ * \return true if there was an error
+ */
int mlt_service_detach( mlt_service this, mlt_filter filter )
{
}
/** Retrieve a filter.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \param index which one of potentially multiple filters
+ * \return the filter or null if there was an error
+ */
mlt_filter mlt_service_filter( mlt_service this, int index )
{
}
/** Retrieve the profile.
-*/
+ *
+ * \public \memberof mlt_service_s
+ * \param this a service
+ * \return the profile
+ */
mlt_profile mlt_service_profile( mlt_service this )
{
return mlt_properties_get_data( MLT_SERVICE_PROPERTIES( this ), "_profile", NULL );
}
-/** Close the service.
-*/
+/** Destroy a service.
+ *
+ * \public \memberof mlt_service_s
+ * \param this the service to destroy
+ */
void mlt_service_close( mlt_service this )
{
- mlt_service_lock( this );
if ( this != NULL && mlt_properties_dec_ref( MLT_SERVICE_PROPERTIES( this ) ) <= 0 )
{
- mlt_service_unlock( this );
if ( this->close != NULL )
{
this->close( this->close_object );
free( base->in );
pthread_mutex_destroy( &base->mutex );
free( base );
+ purge_cache( this );
mlt_properties_close( &this->parent );
}
}
}
}
+/** Release a service's cache items.
+ *
+ * \private \memberof mlt_service_s
+ * \param self a service
+ */
+
+static void purge_cache( mlt_service self )
+{
+ mlt_properties caches = mlt_properties_get_data( mlt_global_properties(), "caches", NULL );
+
+ if ( caches )
+ {
+ int i = mlt_properties_count( caches );
+ while ( i-- )
+ {
+ mlt_cache_purge( mlt_properties_get_data_at( caches, i, NULL ), self );
+ mlt_properties_set_data( mlt_global_properties(), mlt_properties_get_name( caches, i ), NULL, 0, NULL, NULL );
+ }
+ }
+}
+
+/** Lookup the cache object for a service.
+ *
+ * \private \memberof mlt_service_s
+ * \param self a service
+ * \param name a name for the object
+ * \return a cache
+ */
+
+static mlt_cache get_cache( mlt_service self, const char *name )
+{
+ mlt_cache result = NULL;
+ mlt_properties caches = mlt_properties_get_data( mlt_global_properties(), "caches", NULL );
+
+ if ( !caches )
+ {
+ caches = mlt_properties_new();
+ mlt_properties_set_data( mlt_global_properties(), "caches", caches, 0, ( mlt_destructor )mlt_properties_close, NULL );
+ }
+ if ( caches )
+ {
+ result = mlt_properties_get_data( caches, name, NULL );
+ if ( !result )
+ {
+ result = mlt_cache_init();
+ mlt_properties_set_data( caches, name, result, 0, ( mlt_destructor )mlt_cache_close, NULL );
+ }
+ }
+
+ return result;
+}
+
+/** Put an object into a service's cache.
+ *
+ * \public \memberof mlt_service_s
+ * \param self a service
+ * \param name a name for the object that is unique to the service class, but not to the instance
+ * \param data an opaque pointer to the object to put into the cache
+ * \param size the number of bytes pointed to by data
+ * \param destructor a function that releases the data
+ */
+
+void mlt_service_cache_put( mlt_service self, const char *name, void* data, int size, mlt_destructor destructor )
+{
+ mlt_log( self, MLT_LOG_DEBUG, "%s: name %s object %p data %p\n", __FUNCTION__, name, self, data );
+ mlt_cache cache = get_cache( self, name );
+
+ if ( cache )
+ mlt_cache_put( cache, self, data, size, destructor );
+}
+
+/** Get an object from a service's cache.
+ *
+ * \public \memberof mlt_service_s
+ * \param self a service
+ * \param name a name for the object that is unique to the service class, but not to the instance
+ * \return a cache item or NULL if an object is not found
+ * \see mlt_cache_item_data
+ */
+
+mlt_cache_item mlt_service_cache_get( mlt_service self, const char *name )
+{
+ mlt_log( self, MLT_LOG_DEBUG, "%s: name %s object %p\n", __FUNCTION__, name, self );
+ mlt_cache_item result = NULL;
+ mlt_cache cache = get_cache( self, name );
+
+ if ( cache )
+ result = mlt_cache_get( cache, self );
+
+ return result;
+}
projects / mlt / blobdiff