mlt_frame.h

Go to the documentation of this file.

 
#ifndef MLT_FRAME_H
#define MLT_FRAME_H
 
#include "mlt_audio.h"
#include "mlt_deque.h"
#include "mlt_export.h"
#include "mlt_image.h"
#include "mlt_properties.h"
#include "mlt_service.h"
 
typedef int (*mlt_get_image)(mlt_frame self,
                             uint8_t **buffer,
                             mlt_image_format *format,
                             int *width,
                             int *height,
                             int writable);
 
typedef int (*mlt_get_audio)(mlt_frame self,
                             void **buffer,
                             mlt_audio_format *format,
                             int *frequency,
                             int *channels,
                             int *samples);
 
typedef int (*mlt_convert_image)(mlt_frame self,
                                 uint8_t **image,
                                 mlt_image_format *input,
                                 mlt_image_format output);
 
struct mlt_frame_s
{
    struct mlt_properties_s parent; 
    int (*convert_image)(mlt_frame self,
                         uint8_t **image,
                         mlt_image_format *input,
                         mlt_image_format output);
 
    int (*convert_audio)(mlt_frame self,
                         void **audio,
                         mlt_audio_format *input,
                         mlt_audio_format output);
 
    mlt_deque stack_image;   
    mlt_deque stack_audio;   
    mlt_deque stack_service; 
    int is_processing; 
};
 
#define MLT_FRAME_PROPERTIES(frame) (&(frame)->parent)
#define MLT_FRAME_SERVICE_STACK(frame) ((frame)->stack_service)
#define MLT_FRAME_IMAGE_STACK(frame) ((frame)->stack_image)
#define MLT_FRAME_AUDIO_STACK(frame) ((frame)->stack_audio)
 
MLT_EXPORT mlt_frame mlt_frame_init(mlt_service service);
MLT_EXPORT mlt_properties mlt_frame_properties(mlt_frame self);
MLT_EXPORT int mlt_frame_is_test_card(mlt_frame self);
MLT_EXPORT int mlt_frame_is_test_audio(mlt_frame self);
MLT_EXPORT double mlt_frame_get_aspect_ratio(mlt_frame self);
MLT_EXPORT int mlt_frame_set_aspect_ratio(mlt_frame self, double value);
MLT_EXPORT mlt_position mlt_frame_get_position(mlt_frame self);
MLT_EXPORT mlt_position mlt_frame_original_position(mlt_frame self);
MLT_EXPORT int mlt_frame_set_position(mlt_frame self, mlt_position value);
MLT_EXPORT int mlt_frame_set_image(mlt_frame self, uint8_t *image, int size, mlt_destructor destroy);
MLT_EXPORT int mlt_frame_set_alpha(mlt_frame self, uint8_t *alpha, int size, mlt_destructor destroy);
MLT_EXPORT void mlt_frame_replace_image(
    mlt_frame self, uint8_t *image, mlt_image_format format, int width, int height);
MLT_EXPORT int mlt_frame_get_image(mlt_frame self,
                                   uint8_t **buffer,
                                   mlt_image_format *format,
                                   int *width,
                                   int *height,
                                   int writable);
MLT_EXPORT uint8_t *mlt_frame_get_alpha(mlt_frame self);
MLT_EXPORT uint8_t *mlt_frame_get_alpha_size(mlt_frame self, int *size);
MLT_EXPORT int mlt_frame_get_audio(mlt_frame self,
                                   void **buffer,
                                   mlt_audio_format *format,
                                   int *frequency,
                                   int *channels,
                                   int *samples);
MLT_EXPORT int mlt_frame_set_audio(
    mlt_frame self, void *buffer, mlt_audio_format, int size, mlt_destructor);
MLT_EXPORT unsigned char *mlt_frame_get_waveform(mlt_frame self, int w, int h);
MLT_EXPORT int mlt_frame_push_get_image(mlt_frame self, mlt_get_image get_image);
MLT_EXPORT mlt_get_image mlt_frame_pop_get_image(mlt_frame self);
MLT_EXPORT int mlt_frame_push_frame(mlt_frame self, mlt_frame that);
MLT_EXPORT mlt_frame mlt_frame_pop_frame(mlt_frame self);
MLT_EXPORT int mlt_frame_push_service(mlt_frame self, void *that);
MLT_EXPORT void *mlt_frame_pop_service(mlt_frame self);
MLT_EXPORT int mlt_frame_push_service_int(mlt_frame self, int that);
MLT_EXPORT int mlt_frame_pop_service_int(mlt_frame self);
MLT_EXPORT int mlt_frame_push_audio(mlt_frame self, void *that);
MLT_EXPORT void *mlt_frame_pop_audio(mlt_frame self);
MLT_EXPORT int mlt_frame_prepend_image_from_service(mlt_frame self, mlt_frame source);
MLT_EXPORT int mlt_frame_push_image_with_fx_cut(mlt_frame self, mlt_frame fx);
MLT_EXPORT mlt_deque mlt_frame_service_stack(mlt_frame self);
MLT_EXPORT mlt_producer mlt_frame_get_original_producer(mlt_frame self);
MLT_EXPORT void mlt_frame_close(mlt_frame self);
MLT_EXPORT mlt_properties mlt_frame_unique_properties(mlt_frame self, mlt_service service);
MLT_EXPORT mlt_properties mlt_frame_get_unique_properties(mlt_frame self, mlt_service service);
MLT_EXPORT void mlt_frame_append_convert_image(mlt_frame self, mlt_convert_image convert);
MLT_EXPORT void mlt_frame_prepend_convert_image(mlt_frame self, mlt_convert_image convert);
MLT_EXPORT int mlt_frame_has_convert_image(mlt_frame self);
MLT_EXPORT int mlt_frame_convert_image(mlt_frame self,
                                       uint8_t **image,
                                       mlt_image_format *format,
                                       mlt_image_format output);
MLT_EXPORT int mlt_frame_next_convert_image(mlt_frame self,
                                            uint8_t **image,
                                            mlt_image_format *format,
                                            mlt_image_format output);
MLT_EXPORT void mlt_frame_copy_convert_image(mlt_frame dst, mlt_frame src);
MLT_EXPORT mlt_frame mlt_frame_clone(mlt_frame self, int is_deep);
MLT_EXPORT mlt_frame mlt_frame_clone_audio(mlt_frame self, int is_deep);
MLT_EXPORT mlt_frame mlt_frame_clone_image(mlt_frame self, int is_deep);
 
/* convenience functions */
MLT_EXPORT void mlt_frame_write_ppm(mlt_frame frame);
 
#define RGB2YUV_601_SCALED(r, g, b, y, u, v) \
    y = ((263 * r + 516 * g + 100 * b) >> 10) + 16; \
    u = ((-152 * r - 300 * g + 450 * b) >> 10) + 128; \
    v = ((450 * r - 377 * g - 73 * b) >> 10) + 128;
#define RGB2UV_601_SCALED(r, g, b, u, v) \
    u = ((-152 * r - 300 * g + 450 * b) >> 10) + 128; \
    v = ((450 * r - 377 * g - 73 * b) >> 10) + 128;
 
#define YUV2RGB_601_SCALED(y, u, v, r, g, b) \
    r = ((1192 * (y - 16) + 1634 * (v - 128)) >> 10); \
    g = ((1192 * (y - 16) - 832 * (v - 128) - 401 * (u - 128)) >> 10); \
    b = ((1192 * (y - 16) + 2066 * (u - 128)) >> 10); \
    r = r < 0 ? 0 : r > 255 ? 255 : r; \
    g = g < 0 ? 0 : g > 255 ? 255 : g; \
    b = b < 0 ? 0 : b > 255 ? 255 : b;
 
#endif