VLC祥解

功能部份:

VLC媒體播放器的核心是libvlc ，它提供了界面，應用處理功能，如播放列表管理，音頻和視頻解碼和輸出，線程系統。所有libvlc源文件設在的/src目錄及其子目錄：

# config/ ：從命令行和配置文件加載配置，提供功能模塊的讀取和寫入配置

# control/: 提供動作控制功能，如播放/暫停，音量管理，全屏，日誌等。

# extras/: 大多是平台的特殊代碼

# modules/: 模塊管理

# network/: 提供網絡接口（socket管理，網絡錯誤等）

# osd/: 顯示屏幕上的操作

# test/: libvlc測試模塊

# text/: 字符集

# interface/ : 提供代碼中可以調用的接口中,如按鍵後硬件作出反應。

# playlist/: 管理播放功能,如停止,播放,下一首,隨機播放等

# input/: 建立並讀取一個輸入流,並且分離其中的音頻和視頻,然後把分離好的音頻流和視頻流發送給解碼器.

# video_output/ : 初始化視頻播放器,把從解碼器得到的視頻畫面轉化格式(從YUV 轉為 RGB)然後播放它們

# audio_output/ : 初始化音頻混合器,即設置正確的同步頻率,並對從解碼器傳來的音頻流重新取樣

# stream_output/: 輸出音頻流和視頻流到網絡

# misc/: libvlc使用的其他部分功能，如線程系統，消息隊列， CPU的檢測，對像查找系統，或平台的特定代碼。

模塊部份:

VLC媒體播放器的模塊部份,在/modules的子目錄下(詳細說明可以參考其下的List文件),這些模塊只在程序載入它們時有效.每一個模塊，可提供不同的功能，它們會適合的特定文件或某一特定的環境.此外，audio_output/video_output/interface 模塊都寫成了可跨平台的代碼,方便支持新的平台（如beos或服務Mac OS X ）。

插件模塊可以在 src/modules.c 和 include/vlc_modules*.h 提供函數中,動態加載和卸載

LibVLC可以將模塊直接插入到應用程序中,例如不支持動態加載代碼的操作系統.模塊靜態插入到應用程序叫內建.

1.vlc.c 只是入口程序

2.Libvlc.c 是各個模塊的結合點，這要是對接口編程

Vlc_Create(): 兩個重要的數據結構：libvlc_t & vlc_t , 所有的參數傳遞都在這裡面

Vlc_Init(): 初始化參數， module_bank

Vlc_AddInf(): 添加module

3./src/misc/configure.c 命令行參數和參數文件分析

參數文件是~/.vnc/vlcrc。其中可以設置log文件的位置

4./include/ 所有頭文件的集合

5./src/interface/Interface.h 所有module的集合

6./src/misc/Modules.c

其中module_t * __module_Need( vlc_object_t *p_this, const char *psz_capability,

const char *psz_name, vlc_bool_t b_strict ) 方法是尋找合適的interface

如果找到合適的，就調用AllocatePlugin()動態的分配一個。

7.how to link to different modules without OOP

對VLC源代碼閱讀的計劃是從其程序的框架開始，先對其主要的文件進行整理：

1.include/main.h 文件： access to all program variables,主要定義了2個結構體：libvlc_t,vlc_t。

a. struct libvlc_t 根據程序註釋：該結構體只有一個實例，在main函數中被分配，而且只能在main中訪問。它用來存儲一些只能初始化一次的數據，比如說cpu容量或者global lock.

b. struct vlc_t 註釋稱：This structure is a LibVLC instance

libvlc_t,vlc_t在VLC_COMMON_MEMBERS宏中出現，分別定義了 libvlc_t * p_libvlc; vlc_t * p_vlc; 對象，註釋稱為 root of the evil,可見其結構體的重要性.所有的參數傳遞都在這裡面(具體尚不清楚)。

2.include/Vlc_common.h 文件:common definitions,Collection of useful common types and macros definitions,通用類型和宏定義的集合

主要作用是為了將不同的操作系統中的變量定義統一起來,比如說根據將unit_8來統一代表unsiged char類型.

該文件中還定義了VLC_COMMON_MEMBERS宏，該宏中包括了所有VLC基本對象的通用成員變量：these members are common for all vlc objects。

定義導出函數

#ifndef __PLUGIN__

# define VLC_EXPORT( type, name, args ) type name args

#else

# define VLC_EXPORT( type, name, args ) struct _u_n_u_s_e_d_

extern module_symbols_t* p_symbols;

#endif

定義回調函數

typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */

char const *, /* variable name */

vlc_value_t, /* old value */

vlc_value_t, /* new value */

void * ); /* callback data */

3.include/vlc_objects.h 文件:vlc_object_t definition and manipulation methods,vlc_object_t的定義和處理函數

struct vlc_object_t

{

VLC_COMMON_MEMBERS

}; //定義一個結構來使用宏定義的公共成員

VLC中vlm介紹

代碼從兩大部分入手，一個telnet 的deamon。還有就是rtsp的實現部分。結果發現，他們通過了一個橋樑vlm的media進行溝通。

當受到new MEDIANAME vod enabled 就建立一個media。

如果受到setup MEDIANAME input filename.mpg 就讀入流準備分析，建立input流

當受到rtsp的請求後，就建立這個output流

這樣，vod就和別的模塊一致了。rtsp只是一種output流的module。

代碼分析

1. /modules/control/telnet.c

/*****************************************************************************

* Run: main loop

*****************************************************************************/

static void Run( intf_thread_t *p_intf ){

vlm_ExecuteCommand( p_sys->mediatheque, cl->buffer_read,

&message );

}

2. /src/Misc/vlm.c

/*****************************************************************************

* vlm_ExecuteCommand:

*****************************************************************************/

int vlm_ExecuteCommand( vlm_t *p_vlm, const char *psz_command,

vlm_message_t **pp_message)

{

}

vlm_MediaNew( vlm_t *vlm, const char *psz_name, int i_type ){

vlm_media_t *media = malloc( sizeof( vlm_media_t ) );

}

*****************************************************

struct vlm_t

{

VLC_COMMON_MEMBERS

vlc_mutex_t lock;

int i_media;

vlm_media_t **media;

int i_vod;

vod_t *vod;

int i_schedule;

vlm_schedule_t **schedule;

};

*****************************************************

int vlm_MediaSetup( vlm_t *vlm, vlm_media_t *media, const char *psz_cmd,

const char *psz_value ){

if( (p_input = input_CreateThread2( vlm, &media->item, psz_header

) ) )

{

while( !p_input->b_eof && !p_input->b_error ) msleep( 100000 );

input_StopThread( p_input );

input_DestroyThread( p_input );

vlc_object_detach( p_input );

vlc_object_destroy( p_input );

}

3. /src/Input/input.c

input_thread_t *__input_CreateThread2( vlc_object_t *p_parent,

input_item_t *p_item,

char *psz_header )

{

input_thread_t *p_input = NULL; /* thread descriptor */

p_input = Create( p_parent, p_item, psz_header, VLC_FALSE );

/* Now we can attach our new input */

vlc_object_attach( p_input, p_parent );

/* Create thread and wait for its readiness. */

if( vlc_thread_create( p_input, "input", Run,

VLC_THREAD_PRIORITY_INPUT, VLC_TRUE ) )

{

msg_Err( p_input, "cannot create input thread" );

vlc_object_detach( p_input );

vlc_object_destroy( p_input );

return NULL;

}

static input_thread_t *Create( vlc_object_t *p_parent, input_item_t *p_item,

char *psz_header, vlc_bool_t b_quick )

{

}

/*****************************************************************************

* Run: main thread loop

* This is the "normal" thread that spawns the input processing chain,

* reads the stream, cleans up and waits

*****************************************************************************/

static int Run( input_thread_t *p_input )

{

}

=====================================================================================

4. \modules\misc\rtsp.c

static vod_media_t *MediaNew( vod_t *p_vod, const char *psz_name,

input_item_t *p_item )

{

vod_sys_t *p_sys = p_vod->p_sys;

vod_media_t *p_media = malloc( sizeof(vod_media_t) );

int i;

if( !p_media )

{

msg_Err( p_vod, "not enough memory" );

return NULL;

}

memset( p_media, 0, sizeof(vod_media_t) );

p_media->es = 0;

p_media->psz_mux = 0;

p_media->rtsp = 0;

p_media->b_raw = VLC_FALSE;

asprintf( &p_media->psz_rtsp_path, "%s%s", p_sys->psz_path, psz_name );

p_media->p_rtsp_url =

httpd_UrlNewUnique( p_sys->p_rtsp_host, p_media->psz_rtsp_path, NULL,

NULL, NULL );

if( !p_media->p_rtsp_url )

{

msg_Err( p_vod, "cannot create RTSP url (%s)", p_media->psz_rtsp_path);

free( p_media->psz_rtsp_path );

free( p_media );

return NULL;

}

msg_Dbg( p_vod, "created RTSP url: %s", p_media->psz_rtsp_path );

asprintf( &p_media->psz_rtsp_control_v4,

"a=control:rtsp://%%s:%d%s/trackID=%%d\r\n",

p_sys->i_port, p_media->psz_rtsp_path );

asprintf( &p_media->psz_rtsp_control_v6,

"a=control:rtsp://[%%s]:%d%s/trackID=%%d\r\n",

p_sys->i_port, p_media->psz_rtsp_path );

httpd_UrlCatch( p_media->p_rtsp_url, HTTPD_MSG_SETUP,