64 How to add a module
65 -------------------
66
67 To add a module to the repository, just add its sources to a Modules.am
68 file. If you add a new directory you will need to create a new Modules.am,
69 inside that directory. Do not forget to add a corresponding
70 Makefile line at the end of configure.ac for this new Modules.am file.
71
72 To have the module built, you need to add a call to VLC_ADD_PLUGIN or
73 VLC_ADD_BUILTINS to configure.ac with your new module name as argument.
74 Look at other modules for guidelines on how to add build and linkage options.
75
76 After changing configure.ac you will always need to rerun bootstrap and
77 configure.
78
79 VLC keeps a cache of its modules (in ~/.cache/vlc/ on Linux), so you'll have to
80 delete it (or use vlc --reset-plugins-cache). Then use vlc -vvv --color --list
81 to check that your plugin is seen by VLC.
65 -------------------
66
67 To add a module to the repository, just add its sources to a Modules.am
68 file. If you add a new directory you will need to create a new Modules.am,
69 inside that directory. Do not forget to add a corresponding
70 Makefile line at the end of configure.ac for this new Modules.am file.
71
72 To have the module built, you need to add a call to VLC_ADD_PLUGIN or
73 VLC_ADD_BUILTINS to configure.ac with your new module name as argument.
74 Look at other modules for guidelines on how to add build and linkage options.
75
76 After changing configure.ac you will always need to rerun bootstrap and
77 configure.
78
79 VLC keeps a cache of its modules (in ~/.cache/vlc/ on Linux), so you'll have to
80 delete it (or use vlc --reset-plugins-cache). Then use vlc -vvv --color --list
81 to check that your plugin is seen by VLC.
VLC提供的模块说明如上图。下面分别讲解了如何添加模块目录和添加模块，源代码见最后。
一、添加“模块目录。
(1) 在Modules目录下新建MyModules子目录，加入“模块源代码”mymdule1.c
(2) 添加Modules.am文件
SOURCES_mymodule1 = mymodule1.c
libvlc_LTLIBRARIES += \
$(NULL)
$(NULL)
(3) 修改Modules/Makefile.am文件，添加MyModules子目录
BASE_SUBDIRS = \
....
MyModules
....
MyModules
(4) 修改根目录下的configure.ac文件，添加模块，支持编译
dnl
dnl mymodules
dnl
VLC_ADD_PLUGIN([mymodule1])
dnl mymodules
dnl
VLC_ADD_PLUGIN([mymodule1])
(4) 运行./bootstrap
./configure**.sh (自己定义的configure文件)
二、添加“模块”
例如：在Demux目录下添加MyModule1模块
(1) 修改Demux目录下的Modules.am文件，增加1行
SOURCES_mymodule1 = mymodule1.c
(2) 复制MyModule1.c到Demux目录
(3) 修改根目录下的configure.ac文件，添加模块，支持编译
dnl
dnl mymodules
dnl
VLC_ADD_PLUGIN([mymodule1])
dnl mymodules
dnl
VLC_ADD_PLUGIN([mymodule1])
(4) 运行./bootstrap
./configure**.sh (自己定义的configure文件)
附：MyModule1.c源代码：
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif
#include <vlc_common.h>
#include <vlc_plugin.h>
/*****************************************************************************
* Local prototypes.
*****************************************************************************/
static int Open ( vlc_object_t * );
static void Close ( vlc_object_t * );
/*****************************************************************************
* Module descriptor
*****************************************************************************/
vlc_module_begin()
add_shortcut( "testmodule" )
set_description("testmodle plug-in")
set_callbacks( Open, Close )
set_capability( "testing", 0 )
set_category( CAT_INPUT )
vlc_module_end ()
/*****************************************************************************
* Open: initialize interface
*****************************************************************************/
static int Open( vlc_object_t *p_this )
{
msg_Dbg(p_this,"Using test module...\n");
return VLC_SUCCESS;
}
/*****************************************************************************
* Close: destroy interface
*****************************************************************************/
static void Close( vlc_object_t *p_this )
{
msg_Dbg(p_this,"Close test module!\n");
}
