libvlc.c File Reference

This file contains functions to create and destroy libvlc instances. More...

Include dependency graph for libvlc.c:

Functions
static void	GetFilenames (libvlc_int_t *, unsigned, const char *const [])
libvlc_int_t *	libvlc_InternalCreate (void)
	Allocate a blank libvlc instance, also setting the exit handler. More...
static void	libvlc_AddInterfaces (libvlc_int_t *libvlc, const char *varname)
int	libvlc_InternalInit (libvlc_int_t *p_libvlc, int i_argc, const char *ppsz_argv[])
	Initialize a libvlc instance This function initializes a previously allocated libvlc instance: More...
void	libvlc_InternalCleanup (libvlc_int_t *p_libvlc)
	Cleanup a libvlc instance. More...
void	libvlc_InternalDestroy (libvlc_int_t *p_libvlc)
	Destroy libvlc instance. More...
int	vlc_MetadataRequest (libvlc_int_t *libvlc, input_item_t *item, input_item_meta_request_option_t i_options, const struct vlc_metadata_cbs *cbs, void *cbs_userdata, int timeout, void *id)
int	libvlc_MetadataRequest (libvlc_int_t *libvlc, input_item_t *item, input_item_meta_request_option_t i_options, const struct vlc_metadata_cbs *cbs, void *cbs_userdata, int timeout, void *id)
	Requests extraction of the meta data for an input item (a.k.a. More...
void	libvlc_MetadataCancel (libvlc_int_t *libvlc, void *id)
	Cancels extraction of the meta data for an input item. More...

Detailed Description

This file contains functions to create and destroy libvlc instances.

Function Documentation

GetFilenames()

static void GetFilenames ( libvlc_int_t *  p_vlc, unsigned  n, const char * const  args[]  )

static

References intf_InsertItem(), msg_Warn, VLC_INPUT_OPTION_TRUSTED, and vlc_path2uri().

Referenced by libvlc_InternalInit().

libvlc_AddInterfaces()

static void libvlc_AddInterfaces ( libvlc_int_t *  libvlc, const char *  varname  )

static

References libvlc_InternalAddIntf(), state, strtok_r(), and var_InheritString().

Referenced by libvlc_InternalInit().

libvlc_InternalCleanup()

void libvlc_InternalCleanup

(

libvlc_int_t *

p_libvlc

)

Cleanup a libvlc instance.

The instance is not completely deallocated

Parameters

p_libvlc

the instance to clean

References config_AutoSaveConfigFile(), intf_DestroyAll(), libvlc_InternalActionsClean(), libvlc_InternalDialogClean(), libvlc_InternalKeystoreClean(), libvlc_MlRelease(), libvlc_priv(), vlc_object_t::logger, libvlc_priv_t::main_playlist, libvlc_priv_t::media_source_provider, module_EndBank(), msg_Dbg, msg_Warn, libvlc_int_t::obj, libvlc_priv_t::p_media_library, libvlc_priv_t::p_thumbnailer, libvlc_priv_t::p_vlm, libvlc_priv_t::parser, system_End(), var_InheritBool(), var_InheritString(), vlc_LogDestroy(), vlc_media_source_provider_Delete(), vlc_playlist_Delete(), vlc_preparser_Deactivate(), vlc_preparser_Delete(), vlc_strerror_c(), vlc_thumbnailer_Release(), vlc_tracer_Destroy(), and vlm_Delete().

Referenced by libvlc_InternalInit().

libvlc_InternalCreate()

libvlc_int_t * libvlc_InternalCreate

(

void

)

Allocate a blank libvlc instance, also setting the exit handler.

Vlc's threading system must have been initialized first

References libvlc_priv_t::exit, libvlc_priv_t::interfaces, libvlc_priv(), libvlc_priv_t::lock, libvlc_priv_t::main_playlist, libvlc_priv_t::media_source_provider, libvlc_priv_t::p_vlm, vlc_custom_create, vlc_ExitInit(), and vlc_mutex_init().

libvlc_InternalDestroy()

void libvlc_InternalDestroy

(

libvlc_int_t *

p_libvlc

)

Destroy libvlc instance.

Parameters

p_libvlc

the instance to destroy

References vlc_object_delete.

libvlc_InternalInit()

int libvlc_InternalInit	(	libvlc_int_t *	p_libvlc,
		int	i_argc,
		const char *	ppsz_argv[]
	)

Initialize a libvlc instance This function initializes a previously allocated libvlc instance:

• CPU detection
• gettext initialization
• message queue, module bank and playlist initialization
• configuration and commandline parsing

References _, config_CmdLineEarlyScan(), config_LoadCmdLine(), config_LoadConfigFile(), config_PrintHelp(), config_SaveConfigFile, GetFilenames(), intf_InsertItem(), libvlc_AddInterfaces(), libvlc_InternalActionsInit(), libvlc_InternalCleanup(), libvlc_InternalDialogInit(), libvlc_InternalKeystoreInit(), libvlc_MlCreate(), libvlc_priv(), libvlc_priv_t::media_source_provider, module_InitBank(), module_LoadPlugins(), msg_Dbg, msg_Err, msg_Warn, libvlc_priv_t::p_media_library, libvlc_priv_t::p_thumbnailer, libvlc_priv_t::p_vlm, libvlc_priv_t::parser, system_Configure(), system_Init(), unlikely, var_Create(), var_InheritBool(), var_InheritString(), var_SetString(), vlc_bindtextdomain(), vlc_CPU_dump(), VLC_EGENERIC, VLC_ENOMEM, vlc_LogInit(), vlc_LogPreinit(), vlc_media_source_provider_New, VLC_OBJECT, vlc_preparser_New(), VLC_SUCCESS, vlc_threads_setup(), vlc_thumbnailer_Create(), vlc_tracer_Init(), VLC_VAR_ADDRESS, VLC_VAR_BOOL, VLC_VAR_INTEGER, VLC_VAR_STRING, VLC_VAR_VOID, and vlm_New().

libvlc_MetadataCancel()

void libvlc_MetadataCancel	(	libvlc_int_t *	libvlc,
		void *	id
	)

Cancels extraction of the meta data for an input item.

This does nothing if the input item is already processed or if it was not added with libvlc_MetadataRequest()

References libvlc_priv(), libvlc_priv_t::parser, unlikely, and vlc_preparser_Cancel().

Referenced by vlc_media_tree_PreparseCancel().

libvlc_MetadataRequest()

int libvlc_MetadataRequest	(	libvlc_int_t *	libvlc,
		input_item_t *	item,
		input_item_meta_request_option_t	i_options,
		const struct vlc_metadata_cbs *	cbs,
		void *	cbs_userdata,
		int	timeout,
		void *	id
	)

Requests extraction of the meta data for an input item (a.k.a.

preparsing). The actual extraction is asynchronous. It can be cancelled with libvlc_MetadataCancel()

References input_item_t::i_preparse_depth, libvlc_priv(), input_item_t::lock, META_REQUEST_OPTION_SCOPE_ANY, libvlc_priv_t::parser, unlikely, VLC_ENOMEM, vlc_MetadataRequest(), vlc_mutex_lock(), and vlc_mutex_unlock().

vlc_MetadataRequest()

int vlc_MetadataRequest	(	libvlc_int_t *	libvlc,
		input_item_t *	item,
		input_item_meta_request_option_t	i_options,
		const struct vlc_metadata_cbs *	cbs,
		void *	cbs_userdata,
		int	timeout,
		void *	id
	)

References libvlc_priv(), libvlc_priv_t::parser, unlikely, VLC_ENOMEM, and vlc_preparser_Push().

Referenced by libvlc_MetadataRequest(), vlc_media_tree_Preparse(), and vlc_playlist_Preparse().