Vlc基础数据结构记录

1．  Vlc基础数据结构

hongxianzhao@hotmail.com

1.1  基础数据结构 struct vlc_object_t，相关文件为srcmiscobjects.c。

定义为：

struct vlc_object_t

{

    VLC_COMMON_MEMBERS

};

其中的VLC_COMMON_MEMBERS为micro，扩展而下：

struct vlc_object_t

{    

const char *psz_object_type;

                                                       

    char *psz_header;                                                       

    int  i_flags;                                                           

                                                     

    volatile bool b_die;                  

    bool b_force;     

                                

    libvlc_int_t *p_libvlc;                 

    vlc_object_t *  p_parent;                           

};

 

1.2 VLC_OBJECT宏把包含vlc_object_t且为第一个字段的数据类型cast成vlc_object_t类型

# define VLC_OBJECT( x ) ((vlc_object_t *)(x))

结构vlc_object_internals_t ，在vlc里malloc一个新的object时，vlc_object_internals_t分配在vlc_object_t的前面，vlc_object_internals_t里面的互斥信号量保护object的访问，特别是里面variable的访问， 宏vlc_internals从object指针cast到vlc_object_internals_t指针， 具体的分配函数为object.c: vlc_custom_create()。相关文件为srclibvlc.h

struct vlc_object_internals

{

    int             i_object_type;

    char           *psz_name;

 

   

    void           *var_root;

    vlc_mutex_t     var_lock;

    vlc_cond_t      var_wait;

 

   

    vlc_thread_t    thread_id;

    bool            b_thread;

 

   

    int             pipes[2];

 

   

    vlc_spinlock_t   ref_spin;

    unsigned         i_refcount;

    vlc_destructor_t pf_destructor;

 

   

    vlc_object_internals_t *next; 

    vlc_object_internals_t *prev; 

    vlc_object_internals_t *first;

#ifndef NDEBUG

    vlc_object_t   *old_parent;

#endif

};

1.3   object的释放函数typedef void (*vlc_destructor_t)(struct vlc_object_t *);

其他模块分配了一个object后，可能也分配有资源，就可以自己定义一个destructor函数，并赋值给vlc_object_t,在释放object时会调用这个函数来释放自己分配的资源。

1.4   struct variable_ops_t和struct variable_t结构，vlc的很多参数都是用variable_t结构来表示并动态创建加入某个object的列表。这个列表的root为vlc_object_internals_t.var_root.

每个variable都有name，还有一个回调列表，当改变了这个变量的值时触发这个回调，当然外界也可以调用var_TriggerCallback来触发回调。Vlc里的很多事件就是基于这个原理，如video的长度，time，position等。相关文件为srcmiscvariables.c。

typedef struct variable_ops_t

{

    int  (*pf_cmp) ( vlc_value_t, vlc_value_t );

    void (*pf_dup) ( vlc_value_t * );

    void (*pf_free) ( vlc_value_t * );

} variable_ops_t;

 

struct variable_t

{

    char *       psz_name;

   

    vlc_value_t  val;

 

   

    char *       psz_text;

 

    const variable_ops_t *ops;

 

    int          i_type;  

    unsigned     i_usage; 

 

   

    vlc_value_t  min, max, step;

 

   

    int          i_default;

   

    vlc_list_t   choices;

   

    vlc_list_t   choices_text;

 

   

    bool   b_incallback;

 

   

    int                i_entries;

   

    callback_entry_t * p_entries;

};

 

1.5   struct vlc_value_t结构，这是一个union，包含了各种通用的数据类型，一般在struct variable_t里用的很多，定义如下：

typedef union

{

    int             i_int;

    bool            b_bool;

    float           f_float;

    char *          psz_string;

    void *          p_address;

    vlc_object_t *  p_object;

    vlc_list_t *    p_list;

    mtime_t         i_time;

    struct { int32_t x; int32_t y; } coords;

 

   

    uint8_t padding[8];

 

} vlc_value_t;

1.6   struct block_t和 struct block_sys_t，vlc里在vout之前的数据都是以block来保存的。从定义里可以看到vlc内部实际是以block_sys_t来分配的，原因是为了适应各种cpu，vlc为block分配的内存有各种align和pading。struct block_fifo_t为保存block的一个先进先出fifo，提供了多个线程访问struct block_fifo_t之间的同步。相关文件为srcmisclock.c。

struct block_t

{

    block_t     *p_next;

 

    uint32_t    i_flags;

 

    mtime_t     i_pts;

    mtime_t     i_dts;

    mtime_t     i_length;

 

int64_t              i64_original_pts;

int64_t              i64_original_dts;

 

    unsigned    i_nb_samples;

    int         i_rate;

 

    size_t      i_buffer;

    uint8_t     *p_buffer;

 

   

    block_free_t pf_release;

};

 

struct block_sys_t

{

    block_t     self;

    size_t      i_allocated_buffer;

    uint8_t     p_allocated_buffer[];

};

 

struct block_fifo_t

{

    vlc_mutex_t         lock;                        

    vlc_cond_t          wait;     

    vlc_cond_t          wait_room;

 

    block_t             *p_first;

    block_t             **pp_last;

    size_t              i_depth;

    size_t              i_size;

    bool          b_force_wake;

};