VideoLAN Wiki - User contributions [en]

Talk:ExternalAPI

2007-08-20T20:57:20Z

Davidlallen:

Comments

== Exception ==

A "libvcl_exception * libvlc_exception_create(void)" function should be great.
Actualy, the API let use an opaque exception structure but you need to know the structure size anyway !

== Vout ==

toggle_fullscreen() is useless from an embedder point of view: if I am writing an application, I need to set the movie fullscreen or not. Which makes me think that the same reasoning should apply to audio_mute: we should rather have set_mute/get_mute: the status of mute is of interest for an application developer.

[[Zorglub]] Yes. I was thinking about actually putting both options for simplicity.

[[OlivierAubert]] Both options can be a little redundant, but it does not cost much anyway.

== Playlist ==

[[Zorglub]] I don't really know how to handle playlist retrieval as VLC playlist is not a simple list ...

[[OlivierAubert]] Yes, but it is a needed functionality anyway. We can defined a flattened view of the playlist, which will not exactly map to the playlist but be a reasonable view.

== VLM ==

[[Dionoea]] Something like libvlc_vlm_cmd( libvlc_instance *, char *cmd, libvlc_exception ) could be usefull. This would let the enduser do whatever he wants with vlm easily.

== autogeneration? ==

I have been cutting and pasting out of this page into my code, and a number of the function names and arguments are slightly wrong. I have corrected a few. Is there a way to autogenerate *just* these API calls out of the sources? [[User:Davidlallen|Davidlallen]] 22:57, 20 August 2007 (CEST)

LibVLC

2007-08-20T18:00:50Z

Davidlallen:

You can embed libVLC into your application to gain audio/video playing features.

Here are three different tutorials on libVLC:
* [[LibVLC_Visual_C++| Visual C++ Tutorial]] '' (uses "old" legacy API) ''
* [[LibVLC_Tutorial_086c| Tutorial for version 0.8.6c]]
* [[LibVLC_Tutorial|Tutorial for trunk version]]

The documentation on the external API is here: [[ExternalAPI]]

User talk:Davidlallen

2007-08-20T17:39:53Z

Davidlallen:

Hello, I don't really think you should have removed your code from the wiki. It is welcomed! We may however have wanted two differents section/wiki page for 0.8.6 and 0.9.0. Thanks! --[[User:Pdherbemont|Pdherbemont]] 02:53, 20 August 2007 (CEST)

Um, please see the *parent* page on tutorials. I have added a complete working example for 0.8.6c and returned
your page to the way it was. --[[User:davidlallen|davidlallen]] 10:39, 20 August 2007 (PST)

LibVLC Tutorial 086c

2007-08-20T00:47:24Z

Davidlallen:

=== Tutorial for libVLC for version 0.8.6c ===

Tested on cygwin with gcc 3.4, windows xp; instructions also for linux with small code change.
You will want to change the plugin path to where you actually have vlc installed. And you will want to change the video filename to one which actually exists on your system. This will initialize vlc and play the video for ten seconds. After you get this to work, then you will want to look up the external API documentation to see how to use the other interfaces. Note there are two interfaces documented in the
external API page; the first one is the "old" legacy one using calls such as VLC_Init. The second one
is the "current" one using calls such as libvlc_new, which is used in the following code.

=== Code ===

#include <stdio.h>
#include <windows.h>
#include <vlc/libvlc.h>

static void quit_on_exception (libvlc_exception_t *excp) {
if (libvlc_exception_raised (excp)) {
fprintf(stderr, "error: %s\n", libvlc_exception_get_message(excp));
exit(-1);
}
}

int main(int argc, char **argv) {
libvlc_exception_t excp;
libvlc_instance_t *inst;
int item;
char *myarg0 = "-I"; char *myarg1 = "dummy";
char *myarg2 = "--plugin-path=c:\\program files\\videolan\\plugins";
char *myargs[4] = {myarg0, myarg1, myarg2, NULL};
char *filename = "c:\\video\\main\\Everybody_Hates_Chris_Feb_26.mpg";

libvlc_exception_init (&excp);
inst = libvlc_new (3, myargs, &excp);
quit_on_exception (&excp);
item = libvlc_playlist_add (inst, filename, NULL, &excp);
quit_on_exception (&excp);
libvlc_playlist_play (inst, item, 0, NULL, &excp);
quit_on_exception (&excp);
Sleep (10000);
libvlc_destroy (inst);
return 0;
}

=== Compile/link ===

You can use libvlc without compiling your own copy of the vlc source code. You can use the libvlc.dll which comes in the standard end user installation. But, to access the include files, you will need to download and untar the sources distribution. You only need to untar it; you do not even need to run the configure script.
Set your $path to include the directory which contains libvlc.dll and the plugins directory. For example, add "c:\program files\videolan" in a relatively standard installation. This is so Windows can find the libvlc.dll. Otherwise you have to copy the dll to your current directory.
Use the following Makefile:

VLC_INST = "c:\program files\videolan"
VLC_SRC = "c:\tools\vlc-0.8.6c\"
demo: demo.c
gcc -o demo demo.c -I$(VLC_SRC)/include \
-L$(VLC_INST) -llibvlc

=== Change for linux ===

(Not tested, but pretty simple)

Delete include of windows.h; change "Sleep(10000)" to "sleep(10)". Different capitalization and different time units.

User:Davidlallen

2007-08-20T00:34:06Z

Davidlallen:

I have written my own PVR software in C++/Tcl. Today it uses an old
version of Media Player for playback. That version doesn't support
some newer video formats, like mp4, dvr-ms, ts. So I want to use
libvlc.dll instead. I had some trouble with the libvlc tutorial
pages, so I added my recent experience.

Talk:LibVLC Tutorial 0.9

2007-08-20T00:31:29Z

Davidlallen:

LibVLC Tutorial 086c

2007-08-20T00:28:14Z

Davidlallen: tutorial for libvlc for version 0.8.6c

=== Tutorial for libVLC for version 0.8.6c ===

(Tested on cygwin with gcc 3.4, windows xp; instructions also for linux with small code change)

=== Code ===

nyi

=== Compile/link ===

nyi

=== Change for linux ===

(Not tested, but pretty simple)

Delete include of windows.h; change "Sleep(10000)" to "sleep(10)". Different capitalization and different time units.

LibVLC Tutorial 0.9

2007-08-20T00:23:47Z

Davidlallen:

== LibVLC Tutorial ==

'' This may work with trunk version, does not work with 0.8.6c ''

=== Linking against LibVLC ===

'' not yet written ''

=== Sample LibVLC Code ===

#include <stdio.h>
#include <vlc/libvlc.h>

static void quit_on_exception( libvlc_exception_t * excp )
{
if( libvlc_exception_raised( &excp );
{
fprintf(stderr, "error: %s\n", libvlc_exception_get_message(excp) );
exit(-1);
}
}
int main(int argc, char* argv[])
{
char *vlc_args = {"-I", "dummy", "--module-path=/set/your/path/to/libvlc/module"};
libvlc_exception_t excp;
libvlc_instance_t * inst;
libvlc_media_instance_t *mi;
libvlc_media_descriptor_t *md;

libvlc_exception_init( &excp );
/* init vlc modules, should be done only once */
inst = libvlc_new( args, 3, &excp );
quit_on_exception( &excp );

/* Create a new item */
md = libvlc_media_descriptor_new( int, "http://mycool.movie.com/test.mov", &excp );
quit_on_exception( &excp );

/* XXX: demo art and meta information fetching */

/* Create a media instance playing environement */
mi = libvlc_media_instance_new_from_media_descriptor( int, md, &excp );
quit_on_exception( &excp );

/* No need to keep the media descriptor now */
libvlc_media_descriptor_release( md );

#if 0
/* This is a non working code that show how to hooks into a window,
* if we have a window around */
libvlc_drawable_t drawable = xdrawable;
/* or on windows */
libvlc_drawable_t drawable = hwnd;

libvlc_media_instance_set_drawable( mi, drawable, &excp );
quit_on_exception( &excp );
#endif

/* play the media_instance */
libvlc_media_instance_play( mi, &excp );
quit_on_exception( &excp );

sleep(10); /* Let it play a bit */

/* Stop playing */
libvlc_media_instance_stop( mi, &excp );

/* Free the media_instance */
libvlc_media_instance_release( mi, &excp );

libvlc_instance_destroy( inst );

return 0;
}

LibVLC

2007-08-20T00:20:46Z

Davidlallen:

You can embed libVLC into your application to gain audio/video playing features.

Here are the different tutorial on libVLC you can found here:
* [[LibVLC_Visual_C++| Visual C++ Tutorial]] '' (uses "old" legacy API) ''
* [[LibVLC_Tutorial_086c| Tutorial for version 0.8.6c]]
* [[LibVLC_Tutorial|Tutorial for trunk version]]

Talk:LibVLC Tutorial 0.9

2007-08-19T19:06:49Z

Davidlallen:

This code doesn't appear to compile. I am using gcc 3.4.
But some of the problems are obvious, eg line 6, the
parentheses don't match.

What version of libvlc was used to create the tutorial?
Functions libvlc_media_... don't appear to exist in the
latest release version, 0.8.6c. If an unreleased version
is used for the tutorial, that would be fine, if the
text mentioned that.

---

I am new to this wiki, and I don't want to jump too far
ahead. However, I have modified the tutorial code so
that it compiles and runs on cygwin gcc 3.4 and windows
XP, using the latest released vlc version 0.8.6c.

I will paste the code here, in the talk page, in
case it would be a violation of etiquette to just dump
the code on the main page. Note the code on the main
page has syntax errors at least, and either it has
big prototyping problems or else the related API's
are substantially different in whatever vlc version the
author used to compile against.

Note for linux, remove <windows.h>, change
"Sleep (10000)" to "sleep (10)".

#include <stdio.h>
#include <windows.h>
#include <vlc/libvlc.h>

static void quit_on_exception (libvlc_exception_t *excp) {
if (libvlc_exception_raised (excp)) {
fprintf(stderr, "error: %s\n", libvlc_exception_get_message(excp));
exit(-1);
}
}

int main(int argc, char **argv) {
libvlc_exception_t excp;
libvlc_instance_t *inst;
int item;
char *myarg0 = "-I"; char *myarg1 = "dummy";
char *myarg2 = "--plugin-path=c:\\program files\\videolan\\plugins";
char *myargs[4] = {myarg0, myarg1, myarg2, NULL};
char *filename = "c:\\video\\main\\Everybody_Hates_Chris_Feb_26.mpg";

libvlc_exception_init (&excp);
inst = libvlc_new (3, myargs, &excp);
quit_on_exception (&excp);
item = libvlc_playlist_add (inst, filename, NULL, &excp);
quit_on_exception (&excp);
libvlc_playlist_play (inst, item, 0, NULL, &excp);
quit_on_exception (&excp);
Sleep (10000);
libvlc_destroy (inst);
return 0;
}

LibVLC Tutorial 0.9

2007-08-19T18:25:53Z

Davidlallen:

== LibVLC Tutorial ==

=== Linking against LibVLC ===

Using libvlc 0.8.6c and cygwin gcc 3.4, you can link with libvlc like this:

1. Set your $path to include the directory which contains libvlc.dll and
the plugins directory. For example, add "c:\program files\videolan" in
a relatively standard installation.

2. In your Makefile, define a variable which points to your installation:
VLC_INST = "c:\program files\videolan"

3. In your Makefile, add the -L and -l option to gcc:
-L$(VLC_INST) -llibvlc

=== Sample LibVLC Code ===

#include <stdio.h>
#include <vlc/libvlc.h>

static void quit_on_exception( libvlc_exception_t * excp )
{
if( libvlc_exception_raised( &excp );
{
fprintf(stderr, "error: %s\n", libvlc_exception_get_message(excp) );
exit(-1);
}
}
int main(int argc, char* argv[])
{
char *vlc_args = {"-I", "dummy", "--module-path=/set/your/path/to/libvlc/module"};
libvlc_exception_t excp;
libvlc_instance_t * inst;
libvlc_media_instance_t *mi;
libvlc_media_descriptor_t *md;

libvlc_exception_init( &excp );
/* init vlc modules, should be done only once */
inst = libvlc_new( args, 3, &excp );
quit_on_exception( &excp );

/* Create a new item */
md = libvlc_media_descriptor_new( int, "http://mycool.movie.com/test.mov", &excp );
quit_on_exception( &excp );

/* XXX: demo art and meta information fetching */

/* Create a media instance playing environement */
mi = libvlc_media_instance_new_from_media_descriptor( int, md, &excp );
quit_on_exception( &excp );

/* No need to keep the media descriptor now */
libvlc_media_descriptor_release( md );

#if 0
/* This is a non working code that show how to hooks into a window,
* if we have a window around */
libvlc_drawable_t drawable = xdrawable;
/* or on windows */
libvlc_drawable_t drawable = hwnd;

libvlc_media_instance_set_drawable( mi, drawable, &excp );
quit_on_exception( &excp );
#endif

/* play the media_instance */
libvlc_media_instance_play( mi, &excp );
quit_on_exception( &excp );

sleep(10); /* Let it play a bit */

/* Stop playing */
libvlc_media_instance_stop( mi, &excp );

/* Free the media_instance */
libvlc_media_instance_release( mi, &excp );

libvlc_instance_destroy( inst );

return 0;
}

Talk:LibVLC Tutorial 0.9

2007-08-19T18:20:16Z

Davidlallen: