/**
* \file mlt_transition.h
* \brief abstraction for all transition services
+ * \see mlt_transition_s
*
- * Copyright (C) 2003-2008 Ushodaya Enterprises Limited
+ * 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
#include "mlt_service.h"
/** \brief Transition abstract service class
+ *
+ * A transition may modify the output of a producer based on the output of a second producer.
*
* \extends mlt_service_s
+ * \properties \em a_track the track index (0-based) of a multitrack of the first producer
+ * \properties \em b_track the track index (0-based) of a multitrack of the second producer
+ * \properties \em accepts_blanks a flag to indicate if the transition should accept blank frames
+ * \properties \em always_active a flag to indicate that the in and out points do not apply
+ * \properties \em _transition_type 1 for video, 2 for audio
*/
struct mlt_transition_s
{
- /* We're implementing service here */
+ /** We're implementing service here */
struct mlt_service_s parent;
- /* public virtual */
+ /** public virtual */
void ( *close )( mlt_transition );
- /* protected transition method */
+ /** protected transition method */
mlt_frame ( *process )( mlt_transition, mlt_frame, mlt_frame );
- /* Protected */
+ /** Protected */
void *child;
- /* track and in/out points */
+ /** track and in/out points */
mlt_service producer;
- /* Private */
+ /** Private */
mlt_frame *frames;
int held;
};
-/** Public final methods
-*/
-
#define MLT_TRANSITION_SERVICE( transition ) ( &( transition )->parent )
#define MLT_TRANSITION_PROPERTIES( transition ) MLT_SERVICE_PROPERTIES( MLT_TRANSITION_SERVICE( transition ) )
extern int mlt_transition_get_b_track( mlt_transition self );
extern mlt_position mlt_transition_get_in( mlt_transition self );
extern mlt_position mlt_transition_get_out( mlt_transition self );
+extern mlt_position mlt_transition_get_length( mlt_transition self );
+extern mlt_position mlt_transition_get_position( mlt_transition self, mlt_frame frame );
+extern double mlt_transition_get_progress( mlt_transition self, mlt_frame frame );
+extern double mlt_transition_get_progress_delta( mlt_transition self, mlt_frame frame );
extern mlt_frame mlt_transition_process( mlt_transition self, mlt_frame a_frame, mlt_frame b_frame );
extern void mlt_transition_close( mlt_transition self );