MLT 7.14.0
mlt_frame.h
Go to the documentation of this file.
1
23#ifndef MLT_FRAME_H
24#define MLT_FRAME_H
25
26#include "mlt_audio.h"
27#include "mlt_image.h"
28#include "mlt_properties.h"
29#include "mlt_deque.h"
30#include "mlt_service.h"
31
36typedef int ( *mlt_get_image )( mlt_frame self, uint8_t **buffer, mlt_image_format *format, int *width, int *height, int writable );
37
42typedef int ( *mlt_get_audio )( mlt_frame self, void **buffer, mlt_audio_format *format, int *frequency, int *channels, int *samples );
43
76{
86 int ( *convert_image )( mlt_frame self, uint8_t **image, mlt_image_format *input, mlt_image_format output );
87
95 int ( *convert_audio )( mlt_frame self, void **audio, mlt_audio_format *input, mlt_audio_format output );
96
101};
102
103#define MLT_FRAME_PROPERTIES( frame ) ( &( frame )->parent )
104#define MLT_FRAME_SERVICE_STACK( frame ) ( ( frame )->stack_service )
105#define MLT_FRAME_IMAGE_STACK( frame ) ( ( frame )->stack_image )
106#define MLT_FRAME_AUDIO_STACK( frame ) ( ( frame )->stack_audio )
107
113extern int mlt_frame_set_aspect_ratio( mlt_frame self, double value );
117extern int mlt_frame_set_image( mlt_frame self, uint8_t *image, int size, mlt_destructor destroy );
118extern int mlt_frame_set_alpha( mlt_frame self, uint8_t *alpha, int size, mlt_destructor destroy );
119extern void mlt_frame_replace_image( mlt_frame self, uint8_t *image, mlt_image_format format, int width, int height );
120extern int mlt_frame_get_image( mlt_frame self, uint8_t **buffer, mlt_image_format *format, int *width, int *height, int writable );
121extern uint8_t *mlt_frame_get_alpha( mlt_frame self );
122extern uint8_t *mlt_frame_get_alpha_size( mlt_frame self, int *size );
123extern int mlt_frame_get_audio( mlt_frame self, void **buffer, mlt_audio_format *format, int *frequency, int *channels, int *samples );
124extern int mlt_frame_set_audio( mlt_frame self, void *buffer, mlt_audio_format, int size, mlt_destructor );
125extern unsigned char *mlt_frame_get_waveform( mlt_frame self, int w, int h );
128extern int mlt_frame_push_frame( mlt_frame self, mlt_frame that );
130extern int mlt_frame_push_service( mlt_frame self, void *that );
131extern void *mlt_frame_pop_service( mlt_frame self );
132extern int mlt_frame_push_service_int( mlt_frame self, int that );
134extern int mlt_frame_push_audio( mlt_frame self, void *that );
135extern void *mlt_frame_pop_audio( mlt_frame self );
138extern void mlt_frame_close( mlt_frame self );
141extern mlt_frame mlt_frame_clone( mlt_frame self, int is_deep );
142
143/* convenience functions */
144extern void mlt_frame_write_ppm( mlt_frame frame );
145
147#define RGB2YUV_601_SCALED(r, g, b, y, u, v)\
148 y = ((263*r + 516*g + 100*b) >> 10) + 16;\
149 u = ((-152*r - 300*g + 450*b) >> 10) + 128;\
150 v = ((450*r - 377*g - 73*b) >> 10) + 128;
152#define RGB2UV_601_SCALED(r, g, b, u, v)\
153 u = ((-152*r - 300*g + 450*b) >> 10) + 128;\
154 v = ((450*r - 377*g - 73*b) >> 10) + 128;
155
157#define YUV2RGB_601_SCALED( y, u, v, r, g, b ) \
158 r = ((1192 * ( y - 16 ) + 1634 * ( v - 128 ) ) >> 10 ); \
159 g = ((1192 * ( y - 16 ) - 832 * ( v - 128 ) - 401 * ( u - 128 ) ) >> 10 ); \
160 b = ((1192 * ( y - 16 ) + 2066 * ( u - 128 ) ) >> 10 ); \
161 r = r < 0 ? 0 : r > 255 ? 255 : r; \
162 g = g < 0 ? 0 : g > 255 ? 255 : g; \
163 b = b < 0 ? 0 : b > 255 ? 255 : b;
164
165#endif
Audio class.
double ended queue
mlt_position mlt_frame_get_position(mlt_frame self)
uint8_t * mlt_frame_get_alpha_size(mlt_frame self, int *size)
double mlt_frame_get_aspect_ratio(mlt_frame self)
int mlt_frame_set_alpha(mlt_frame self, uint8_t *alpha, int size, mlt_destructor destroy)
int mlt_frame_push_audio(mlt_frame self, void *that)
mlt_properties mlt_frame_unique_properties(mlt_frame self, mlt_service service)
int mlt_frame_is_test_card(mlt_frame self)
mlt_frame mlt_frame_clone(mlt_frame self, int is_deep)
void mlt_frame_write_ppm(mlt_frame frame)
Definition mlt_frame.c:816
int mlt_frame_set_aspect_ratio(mlt_frame self, double value)
mlt_frame mlt_frame_pop_frame(mlt_frame self)
int mlt_frame_set_image(mlt_frame self, uint8_t *image, int size, mlt_destructor destroy)
mlt_frame mlt_frame_init(mlt_service service)
int mlt_frame_is_test_audio(mlt_frame self)
int mlt_frame_set_position(mlt_frame self, mlt_position value)
mlt_properties mlt_frame_properties(mlt_frame self)
void mlt_frame_close(mlt_frame self)
void mlt_frame_replace_image(mlt_frame self, uint8_t *image, mlt_image_format format, int width, int height)
int mlt_frame_pop_service_int(mlt_frame self)
int mlt_frame_push_service_int(mlt_frame self, int that)
int mlt_frame_push_get_image(mlt_frame self, mlt_get_image get_image)
mlt_producer mlt_frame_get_original_producer(mlt_frame self)
int mlt_frame_push_service(mlt_frame self, void *that)
mlt_deque mlt_frame_service_stack(mlt_frame self)
mlt_position mlt_frame_original_position(mlt_frame self)
int mlt_frame_get_audio(mlt_frame self, void **buffer, mlt_audio_format *format, int *frequency, int *channels, int *samples)
int mlt_frame_set_audio(mlt_frame self, void *buffer, mlt_audio_format, int size, mlt_destructor)
void * mlt_frame_pop_service(mlt_frame self)
mlt_properties mlt_frame_get_unique_properties(mlt_frame self, mlt_service service)
int mlt_frame_get_image(mlt_frame self, uint8_t **buffer, mlt_image_format *format, int *width, int *height, int writable)
mlt_get_image mlt_frame_pop_get_image(mlt_frame self)
unsigned char * mlt_frame_get_waveform(mlt_frame self, int w, int h)
int(* mlt_get_image)(mlt_frame self, uint8_t **buffer, mlt_image_format *format, int *width, int *height, int writable)
Callback function to get video data.
Definition mlt_frame.h:36
int mlt_frame_push_frame(mlt_frame self, mlt_frame that)
int(* mlt_get_audio)(mlt_frame self, void **buffer, mlt_audio_format *format, int *frequency, int *channels, int *samples)
Callback function to get audio data.
Definition mlt_frame.h:42
void * mlt_frame_pop_audio(mlt_frame self)
uint8_t * mlt_frame_get_alpha(mlt_frame self)
Image class.
Properties class declaration.
interface declaration for all service classes
int32_t mlt_position
Definition mlt_types.h:181
void(* mlt_destructor)(void *)
pointer to destructor function
Definition mlt_types.h:233
mlt_image_format
The set of supported image formats.
Definition mlt_types.h:46
mlt_audio_format
The set of supported audio formats.
Definition mlt_types.h:62
Double-Ended Queue (deque) class.
Definition mlt_deque.c:50
Frame class.
Definition mlt_frame.h:76
mlt_deque stack_service
a general purpose data stack
Definition mlt_frame.h:99
int(* convert_image)(mlt_frame self, uint8_t **image, mlt_image_format *input, mlt_image_format output)
Convert the image format (callback function).
Definition mlt_frame.h:86
int is_processing
indicates if a frame is or was processed by the parallel consumer
Definition mlt_frame.h:100
struct mlt_properties_s parent
A frame extends properties.
Definition mlt_frame.h:77
mlt_deque stack_image
the image processing stack of operations and data
Definition mlt_frame.h:97
int(* convert_audio)(mlt_frame self, void **audio, mlt_audio_format *input, mlt_audio_format output)
Convert the audio format (callback function).
Definition mlt_frame.h:95
mlt_deque stack_audio
the audio processing stack of operations and data
Definition mlt_frame.h:98
Producer abstract service class.
Definition mlt_producer.h:70
Properties class.
Definition mlt_properties.h:40
Service abstract base class.
Definition mlt_service.h:58