Vlc基础数据结构记录

1．  Vlc基础数据结构

hongxianzhao@hotmail.com

1.1  基础数据结构 struct vlc_object_t，相关文件为src\misc\objects.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()。相关文件为src\libvlc.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等。相关文件为src\misc\variables.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之间的同步。相关文件为src\misc\block.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;

};