### LibVLC Initialization and Playback Setup (Older API)

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This C code demonstrates the initialization of LibVLC and setting up media playback using command-line arguments for the media resource locator (MRL). It configures vmem output parameters.

```c
int main(int argc, char *argv[])
{
    char clock[64], cunlock[64], cdata[64];
    char width[32], height[32], pitch[32];
    libvlc_exception_t ex;
    libvlc_instance_t *libvlc;
    libvlc_media_t *m;
    libvlc_media_player_t *mp;
    char const *vlc_argv[] =
    {
        "-q",
        //"-vvvvv",
        "--plugin-path", VLC_TREE "/modules",
        "--ignore-config", /* Don't use VLC's config files */
        "--noaudio",
        "--vout", "vmem",
        "--vmem-width", width,
        "--vmem-height", height,
        "--vmem-pitch", pitch,
        "--vmem-chroma", "RV16",
        "--vmem-lock", clock,
        "--vmem-unlock", cunlock,
        "--vmem-data", cdata,
    };
    int vlc_argc = sizeof(vlc_argv) / sizeof(*vlc_argv);

    SDL_Surface *screen, *empty;
    SDL_Event event;
    SDL_Rect rect;
    int done = 0, action = 0, pause = 0, n = 0;

    struct ctx ctx;

    /*
     *  Initialise libSDL
     */
    if(SDL_Init(SDL_INIT_VIDEO | SDL_INIT_EVENTTHREAD) == -1)
    {
        printf("cannot initialize SDL\n");
        return EXIT_FAILURE;
    }

    empty = SDL_CreateRGBSurface(SDL_SWSURFACE, VIDEOWIDTH, VIDEOHEIGHT,
                                 32, 0, 0, 0, 0);
    ctx.surf = SDL_CreateRGBSurface(SDL_SWSURFACE, VIDEOWIDTH, VIDEOHEIGHT,
                                    16, 0x001f, 0x07e0, 0xf800, 0);

    ctx.mutex = SDL_CreateMutex();

    int options = SDL_ANYFORMAT | SDL_HWSURFACE | SDL_DOUBLEBUF;

    screen = SDL_SetVideoMode(WIDTH, HEIGHT, 0, options);
    if(!screen)
    {
        printf("cannot set video mode\n");
        return EXIT_FAILURE;
    }

    /*
     *  Initialise libVLC
     */
    sprintf(clock, "%lld", (long long int)(intptr_t)lock);
    sprintf(cunlock, "%lld", (long long int)(intptr_t)unlock);
    sprintf(cdata, "%lld", (long long int)(intptr_t)&ctx);
    sprintf(width, "%i", VIDEOWIDTH);
    sprintf(height, "%i", VIDEOHEIGHT);
    sprintf(pitch, "%i", VIDEOWIDTH * 2);

    if(argc < 2)
    {
        printf("too few arguments (MRL needed)\n");
        return EXIT_FAILURE;
    }
    libvlc_exception_init(&ex);
    libvlc = libvlc_new(vlc_argc, vlc_argv, &ex);
    catch(&ex);
    m = libvlc_media_new(libvlc, argv[1], &ex);
    catch(&ex);
    mp = libvlc_media_player_new_from_media(m, &ex);
    catch(&ex);
    libvlc_media_release(m);

    libvlc_media_player_play(mp, &ex);
    catch(&ex);

    /*
     *  Main loop
     */
    rect.w = 0;
    rect.h = 0;

    while(!done)
    { 
        action = 0;

        /* Keys: enter (fullscreen), space (pause), escape (quit) */
        while( SDL_PollEvent( &event ) ) 
        { 
            switch(event.type)
            {
            case SDL_QUIT:
                done = 1;
                break;
            case SDL_KEYDOWN:
                action = event.key.keysym.sym;
                break;
            }
        }

        switch(action)
        {
        case SDLK_ESCAPE:
            done = 1;
            break;

```

--------------------------------

### Basic libVLC media playback example

Source: https://wiki.videolan.org/LibVLC_Tutorial

A C code snippet demonstrating how to initialize libVLC, create a media player, load a media URL, play it, and then clean up resources. Requires libvlc development headers and libraries.

```c
#include <stdio.h>
#include <stdlib.h>
#include <vlc/vlc.h>

int main(int argc, char* argv[])
{
    libvlc_instance_t * inst;
    libvlc_media_player_t *mp;
    libvlc_media_t *m;
    
    /* Load the VLC engine */
    inst = libvlc_new (0, NULL);
 
    /* Create a new item */
    m = libvlc_media_new_location (inst, "http://mycool.movie.com/test.mov");
    //m = libvlc_media_new_path (inst, "/path/to/test.mov");
       
    /* Create a media player playing environement */
    mp = libvlc_media_player_new_from_media (m);
    
    /* No need to keep the media now */
    libvlc_media_release (m);

#if 0
    /* This is a non working code that show how to hooks into a window,
     * if we have a window around */
     libvlc_media_player_set_xwindow (mp, xid);
    /* or on windows */
     libvlc_media_player_set_hwnd (mp, hwnd);
    /* or on mac os */
     libvlc_media_player_set_nsobject (mp, view);
 #endif

    /* play the media_player */
    libvlc_media_player_play (mp);
   
    sleep (10); /* Let it play a bit */
   
    /* Stop playing */
    libvlc_media_player_stop (mp);

    /* Free the media_player */
    libvlc_media_player_release (mp);

    libvlc_release (inst);

    return 0;
}

```

--------------------------------

### Compile libVLC C code with GCC

Source: https://wiki.videolan.org/LibVLC_Tutorial

Basic command to compile a C file using libVLC with GCC. Ensure libvlc is installed and accessible.

```bash
cc example.c -lvlc -o example

```

--------------------------------

### Initialize and Play Video (Linux)

Source: https://wiki.videolan.org/LibVLC_Tutorial_086c

Initializes libVLC, adds a video file to the playlist, plays it for ten seconds, and then destroys the instance. Uses `usleep` for delay and accepts command-line arguments for instance creation.

```c
#include <stdio.h>
#include <stdlib.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 *filename = "/tmp/WorldOfPadman_Intro.avi";

   libvlc_exception_init (&excp);
   inst = libvlc_new (argc, argv, &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);
   usleep (10000000);
   libvlc_destroy (inst);
   return 0;
 }
```

--------------------------------

### Initialize and Play Video (Windows)

Source: https://wiki.videolan.org/LibVLC_Tutorial_086c

Initializes libVLC, adds a video file to the playlist, plays it for ten seconds, and then destroys the instance. Requires setting the plugin path and video filename correctly.

```c
#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 and SDL 2.0 Video Playback Sample

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This C code sample demonstrates how to integrate LibVLC with SDL 2.0 for video playback. It includes initialization of SDL and LibVLC, setting up video rendering callbacks (lock, unlock, display), and a main loop to handle events and rendering. Ensure VLC_PLUGIN_PATH is set or the plugins directory is available.

```c
// libSDL and libVLC sample code.
// License: [http://en.wikipedia.org/wiki/WTFPL WTFPL]

#include <stdio.h>
#include <stdint.h> 
#include <math.h> 
#include <stdlib.h> 
#include <assert.h> 

#include "SDL/SDL.h"
#include "SDL/SDL_mutex.h"

#include "vlc/vlc.h"

#define WIDTH 640
#define HEIGHT 480

#define VIDEOWIDTH 320
#define VIDEOHEIGHT 240

struct context {
    SDL_Renderer *renderer;
    SDL_Texture *texture;
    SDL_mutex *mutex;
    int n;
};

// VLC prepares to render a video frame.
static void *lock(void *data, void **p_pixels) {

    struct context *c = (context *)data;

    int pitch;
    SDL_LockMutex(c->mutex);
    SDL_LockTexture(c->texture, NULL, p_pixels, &pitch);

    return NULL; // Picture identifier, not needed here.
}

// VLC just rendered a video frame.
static void unlock(void *data, void *id, void *const *p_pixels) {

    struct context *c = (context *)data;

    uint16_t *pixels = (uint16_t *)*p_pixels;

    // We can also render stuff.
    int x, y;
    for(y = 10; y < 40; y++) {
        for(x = 10; x < 40; x++) {
            if(x < 13 || y < 13 || x > 36 || y > 36) {
                pixels[y * VIDEOWIDTH + x] = 0xffff;
            } else {
                // RV16 = 5+6+5 pixels per color, BGR.
                pixels[y * VIDEOWIDTH + x] = 0x02ff;
            }
        }
    }

    SDL_UnlockTexture(c->texture);
    SDL_UnlockMutex(c->mutex);
}

// VLC wants to display a video frame.
static void display(void *data, void *id) {

    struct context *c = (context *)data;

    SDL_Rect rect;
    rect.w = VIDEOWIDTH;
    rect.h = VIDEOHEIGHT;
    rect.x = (int)((1. + .5 * sin(0.03 * c->n)) * (WIDTH - VIDEOWIDTH) / 2);
    rect.y = (int)((1. + .5 * cos(0.03 * c->n)) * (HEIGHT - VIDEOHEIGHT) / 2);

    SDL_SetRenderDrawColor(c->renderer, 0, 80, 0, 255);
    SDL_RenderClear(c->renderer);
    SDL_RenderCopy(c->renderer, c->texture, NULL, &rect);
    SDL_RenderPresent(c->renderer);
}

static void quit(int c) {
    SDL_Quit();
    exit(c);
}

int main(int argc, char *argv[]) {

    libvlc_instance_t *libvlc;
    libvlc_media_t *m;
    libvlc_media_player_t *mp;
    char const *vlc_argv[] = {

        "--no-audio", // Don't play audio.
        "--no-xlib", // Don't use Xlib.

        // Apply a video filter.
        //"--video-filter", "sepia",
        //"--sepia-intensity=200"
    };
    int vlc_argc = sizeof(vlc_argv) / sizeof(*vlc_argv);

    SDL_Event event;
    int done = 0, action = 0, pause = 0, n = 0;

    struct context context;

    if(argc < 2) {
        printf("Usage: %s <filename>\n", argv[0]);
        return EXIT_FAILURE;
    }

    // Initialise libSDL.
    if(SDL_Init(SDL_INIT_VIDEO) < 0) {
        printf("Could not initialize SDL: %s.\n", SDL_GetError());
        return EXIT_FAILURE;
    }

    // Create SDL graphics objects.
    SDL_Window * window = SDL_CreateWindow(
            "Fartplayer",
            SDL_WINDOWPOS_UNDEFINED,
            SDL_WINDOWPOS_UNDEFINED,
            WIDTH, HEIGHT,
            SDL_WINDOW_SHOWN|SDL_WINDOW_RESIZABLE);
    if (!window) {
        fprintf(stderr, "Couldn't create window: %s\n", SDL_GetError());
        quit(3);
    }

    context.renderer = SDL_CreateRenderer(window, -1, 0);
    if (!context.renderer) {
        fprintf(stderr, "Couldn't create renderer: %s\n", SDL_GetError());
        quit(4);
    }

    context.texture = SDL_CreateTexture(
            context.renderer,
            SDL_PIXELFORMAT_BGR565, SDL_TEXTUREACCESS_STREAMING,
            VIDEOWIDTH, VIDEOHEIGHT);
    if (!context.texture) {
        fprintf(stderr, "Couldn't create texture: %s\n", SDL_GetError());
        quit(5);
    }

    context.mutex = SDL_CreateMutex();

    // If you don't have this variable set you must have plugins directory
    // with the executable or libvlc_new() will not work!
    printf("VLC_PLUGIN_PATH=%s\n", getenv("VLC_PLUGIN_PATH"));

    // Initialise libVLC.
    libvlc = libvlc_new(vlc_argc, vlc_argv);
    if(NULL == libvlc) {
        printf("LibVLC initialization failure.\n");
        return EXIT_FAILURE;
    }

    m = libvlc_media_new_path(libvlc, argv[1]);
    mp = libvlc_media_player_new_from_media(m);
    libvlc_media_release(m);

    libvlc_video_set_callbacks(mp, lock, unlock, display, &context);
    libvlc_video_set_format(mp, "RV16", VIDEOWIDTH, VIDEOHEIGHT, VIDEOWIDTH*2);
    libvlc_media_player_play(mp);

    // Main loop.
    while(!done) {

        action = 0;

        // Keys: enter (fullscreen), space (pause), escape (quit).
        while( SDL_PollEvent( &event )) {

            switch(event.type) {
                case SDL_QUIT:
                    done = 1;
                    break;
                case SDL_KEYDOWN:
                    action = event.key.keysym.sym;
                    break;
            }
        }

        switch(action) {
            case SDLK_ESCAPE:
            case SDLK_q:
                done = 1;
                break;

```

--------------------------------

### Sample LibVLC Code for Media Playback

Source: https://wiki.videolan.org/LibVLC_Tutorial_0.9

This C code demonstrates initializing LibVLC, creating a media player, playing a media stream from a URL, and stopping playback. Ensure you have the necessary headers and libraries, and adjust plugin paths if on Windows or macOS.

```c
#include <stdio.h>
#include <stdlib.h>
#include <vlc/vlc.h>

// Uncomment this line if you get a "sleep was not declared in this scope"
// #include <unistd.h>

static void raise(libvlc_exception_t * ex)
{
    if (libvlc_exception_raised (ex))
    {
         fprintf (stderr, "error: %s\n", libvlc_exception_get_message(ex));
         exit (-1);
    }
}
int main(int argc, char* argv[])
{
    const char * const vlc_args[] = {
              "-I", "dummy", /* Don't use any interface */
              "--ignore-config", /* Don't use VLC's config */
              "--plugin-path=/set/your/path/to/libvlc/module/if/you/are/on/windows/or/macosx" };
    libvlc_exception_t ex;
    libvlc_instance_t * inst;
    libvlc_media_player_t *mp;
    libvlc_media_t *m;
    
    libvlc_exception_init (&ex);
    /* init vlc modules, should be done only once */
    inst = libvlc_new (sizeof(vlc_args) / sizeof(vlc_args[0]), vlc_args, &ex);
    raise (&ex);
 
    /* Create a new item */
    m = libvlc_media_new (inst, "http://mycool.movie.com/test.mov", &ex);
    raise (&ex);
   
    /* XXX: demo art and meta information fetching */
   
    /* Create a media player playing environement */
    mp = libvlc_media_player_new_from_media (m, &ex);
    raise (&ex);
    
    /* No need to keep the media now */
    libvlc_media_release (m);

#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_player_set_drawable (mp, drawable, &ex);
     raise (&ex);
#endif

    /* play the media_player */
    libvlc_media_player_play (mp, &ex);
    raise (&ex);
   
    sleep (10); /* Let it play a bit */
   
    /* Stop playing */
#warning There is known deadlock bug here. Please update to LibVLC 1.1!
    libvlc_media_player_stop (mp, &ex);

    /* Free the media_player */
    libvlc_media_player_release (mp);

    libvlc_release (inst);
    raise (&ex);

    return 0;
}
```

--------------------------------

### Create and Release Media List

Source: https://wiki.videolan.org/LibVLC_Memory_Management

Demonstrates creating a media list with libvlc_media_list_new and releasing its memory with libvlc_media_list_release. Ensure to release objects obtained via new to prevent memory leaks.

```c
 libvlc_media_list_t *p_ml = libvlc_media_list_new(libvlc_inst)
 
 /* Free the memory used by media_list release */
 libvlc_media_list_release(p_ml);
```

--------------------------------

### Render Video to SDL Surface with LibVLC

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This C code snippet shows how to initialize SDL and LibVLC, set up video rendering callbacks, and play a video file into a custom SDL surface. It requires LibVLC 1.1.1 or later and SDL 2.0.

```c
/* libSDL and libVLC sample code
 * Copyright © 2008 Sam Hocevar <sam@zoy.org>
 * license: [http://en.wikipedia.org/wiki/WTFPL WTFPL] */

#include <stdio.h>
#include <stdint.h>
#include <math.h>
#include <stdlib.h>
#include <assert.h>

#include <SDL/SDL.h>
#include <SDL/SDL_mutex.h>

#include <vlc/vlc.h>

#define WIDTH 640
#define HEIGHT 480

#define VIDEOWIDTH 320
#define VIDEOHEIGHT 240

struct ctx
{
    SDL_Surface *surf;
    SDL_mutex *mutex;
};

static void *lock(void *data, void **p_pixels)
{
    struct ctx *ctx = data;

    SDL_LockMutex(ctx->mutex);
    SDL_LockSurface(ctx->surf);
    *p_pixels = ctx->surf->pixels;
    return NULL; /* picture identifier, not needed here */
}

static void unlock(void *data, void *id, void *const *p_pixels)
{
    struct ctx *ctx = data;

    /* VLC just rendered the video, but we can also render stuff */
    uint16_t *pixels = *p_pixels;
    int x, y;

    for(y = 10; y < 40; y++)
        for(x = 10; x < 40; x++)
            if(x < 13 || y < 13 || x > 36 || y > 36)
                pixels[y * VIDEOWIDTH + x] = 0xffff;
            else
                pixels[y * VIDEOWIDTH + x] = 0x0;

    SDL_UnlockSurface(ctx->surf);
    SDL_UnlockMutex(ctx->mutex);

    assert(id == NULL); /* picture identifier, not needed here */
}

static void display(void *data, void *id)
{
    /* VLC wants to display the video */
    (void) data;
    assert(id == NULL);
}

int main(int argc, char *argv[])
{
    libvlc_instance_t *libvlc;
    libvlc_media_t *m;
    libvlc_media_player_t *mp;
    char const *vlc_argv[] =
    {
        "--no-audio", /* skip any audio track */
        "--no-xlib", /* tell VLC to not use Xlib */
    };
    int vlc_argc = sizeof(vlc_argv) / sizeof(*vlc_argv);

    SDL_Surface *screen, *empty;
    SDL_Event event;
    SDL_Rect rect;
    int done = 0, action = 0, pause = 0, n = 0;

    struct ctx ctx;

    if(argc < 2)
    {
        printf("Usage: %s <filename>\n", argv[0]);
        return EXIT_FAILURE;
    }

    /*
     *  Initialise libSDL
     */
    if(SDL_Init(SDL_INIT_VIDEO | SDL_INIT_EVENTTHREAD) == -1)
    {
        printf("cannot initialize SDL\n");
        return EXIT_FAILURE;
    }

    empty = SDL_CreateRGBSurface(SDL_SWSURFACE, VIDEOWIDTH, VIDEOHEIGHT,
                                 32, 0, 0, 0, 0);
    ctx.surf = SDL_CreateRGBSurface(SDL_SWSURFACE, VIDEOWIDTH, VIDEOHEIGHT,
                                    16, 0x001f, 0x07e0, 0xf800, 0);

    ctx.mutex = SDL_CreateMutex();

    int options = SDL_ANYFORMAT | SDL_HWSURFACE | SDL_DOUBLEBUF;

    screen = SDL_SetVideoMode(WIDTH, HEIGHT, 0, options);
    if(!screen)
    {
        printf("cannot set video mode\n");
        return EXIT_FAILURE;
    }

    /*
     *  Initialise libVLC
     */
    libvlc = libvlc_new(vlc_argc, vlc_argv);
    m = libvlc_media_new_path(libvlc, argv[1]);
    mp = libvlc_media_player_new_from_media(m);
    libvlc_media_release(m);

    libvlc_video_set_callbacks(mp, lock, unlock, display, &ctx);
    libvlc_video_set_format(mp, "RV16", VIDEOWIDTH, VIDEOHEIGHT, VIDEOWIDTH*2);
    libvlc_media_player_play(mp);

    /*
     *  Main loop
     */
    rect.w = 0;
    rect.h = 0;

    while(!done)
    {
        action = 0;

        /* Keys: enter (fullscreen), space (pause), escape (quit) */
        while( SDL_PollEvent( &event ) ) 
        {
            switch(event.type)
            {
            case SDL_QUIT:
                done = 1;
                break;
            case SDL_KEYDOWN:
                action = event.key.keysym.sym;
                break;
            }
        }

        switch(action)
        {
        case SDLK_ESCAPE:
            done = 1;
            break;
        case SDLK_RETURN:
            options ^= SDL_FULLSCREEN;
            screen = SDL_SetVideoMode(WIDTH, HEIGHT, 0, options);
            break;
        case ' ':
            pause = !pause;
            break;
        }

        rect.x = (int)((1. + .5 * sin(0.03 * n)) * (WIDTH - VIDEOWIDTH) / 2);
        rect.y = (int)((1. + .5 * cos(0.03 * n)) * (HEIGHT - VIDEOHEIGHT) / 2);

        if(!pause)
            n++;

        /* Blitting the surface does not prevent it from being locked and
         * written to by another thread, so we use this additional mutex. */
        SDL_LockMutex(ctx.mutex);
        SDL_BlitSurface(ctx.surf, NULL, screen, &rect);
        SDL_UnlockMutex(ctx.mutex);

        SDL_Flip(screen);
        SDL_Delay(10);

        SDL_BlitSurface(empty, NULL, screen, &rect);
    }

    /*
     * Stop stream and clean up libVLC
     */
    libvlc_media_player_stop(mp);
    libvlc_media_player_release(mp);
    libvlc_release(libvlc);

    /*
     * Close window and clean up libSDL
     */
    SDL_DestroyMutex(ctx.mutex);
    SDL_FreeSurface(ctx.surf);
    SDL_FreeSurface(empty);

    SDL_Quit();

```

--------------------------------

### Play Media List with libVLC

Source: https://wiki.videolan.org/LibVLC_Media_List_Management

This function demonstrates how to create a media list, add media items to it, and play the list using a media list player. It requires libvlc instance and a drawable window for playback.

```c
 void play_media(libvlc_instance_t *vlc, libvlc_drawable_t window)
 {

     libvlc_media_list_t *ml;
     libvlc_media_list_player_t *mlp;
     libvlc_media_player_t *mp;
     libvlc_media_t *md1, *md2;
  
     ml = libvlc_media_list_new(vlc);
    
     md1 = libvlc_media_new_path(vlc, "http://mycool.com/movie1.avi");
     md2 = libvlc_media_new_path(vlc, "http://mycool.com/movie2.avi");
  
     libvlc_media_list_add_media(ml, md1);
     libvlc_media_list_add_media(ml, md2);
  
     libvlc_media_release(md1);
     libvlc_media_release(md2);
  
     mlp = libvlc_media_list_player_new(vlc);
  
     mp = libvlc_media_player_new(vlc);
  
     /* Use our media list */
     libvlc_media_list_player_set_media_list(mlp, ml);

     /* Use a given media player */
     libvlc_media_list_player_set_media_player(mlp, p_mp);
  
     /* Get our media instance to use our window */
     libvlc_media_player_set_drawable(mlp, window);
  
     /* Play */
     libvlc_media_list_player_play(mlp);
  
     /* Let it play forever */
     while(1) sleep(300);
 }
```

--------------------------------

### Compile, Link, and Run Commands (Linux)

Source: https://wiki.videolan.org/LibVLC_Tutorial_086c

Commands to compile, link, and run a libVLC application on Linux. Sets environment variables for source and library paths.

```bash
$ export VLC_SRC=/tmp/vlc-0.8.6c
$ gcc -I ${VLC_SRC}/include/ -lvlc -L ${VLC_SRC}/src/.libs/ demo.c -o demo
$ export LD_LIBRARY_PATH=${VLC_SRC}/src/.libs/ 
$ ./demo --plugin-path ${VLC_SRC}
```

--------------------------------

### Clean Up LibVLC Resources

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This snippet shows the process of stopping the media player, releasing the media player instance, and releasing the libVLC instance. It also includes error handling for potential exceptions.

```c
    /*
     * Stop stream and clean up libVLC
     */
    libvlc_media_player_stop(mp, &ex);
    catch(&ex);

    libvlc_media_player_release(mp);
    libvlc_release(libvlc);

```

--------------------------------

### Compile libVLC C code with pkg-config

Source: https://wiki.videolan.org/LibVLC_Tutorial

Compile C code using libVLC on Linux/BSD with pkg-config for flags. This separates compilation and linking steps.

```bash
pkg-config --print-errors 'libvlc >= 1.1.0'
cc -c example.c -o example.o $(pkg-config --cflags libvlc)
cc example.o -o example $(pkg-config --libs libvlc)

```

--------------------------------

### Handle SDL Key Events and Update Video Mode

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This snippet handles the SDLK_RETURN key press to toggle fullscreen mode by changing video options and updating the screen. It also handles the spacebar to toggle playback pause.

```c
        case SDLK_RETURN:
            options ^= SDL_FULLSCREEN;
            screen = SDL_SetVideoMode(WIDTH, HEIGHT, 0, options);
            break;
        case ' ':
            pause = !pause;
            break;
        }

```

--------------------------------

### Thread-Safe Surface Blitting and Display Update

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This code demonstrates how to safely blit a video surface to the screen and update the display. It uses an SDL mutex to prevent race conditions when another thread might be writing to the surface. A delay is introduced, and the previous frame is cleared.

```c
        /* Blitting the surface does not prevent it from being locked and
         * written to by another thread, so we use this additional mutex. */
        SDL_LockMutex(ctx.mutex);
        SDL_BlitSurface(ctx.surf, NULL, screen, &rect);
        SDL_UnlockMutex(ctx.mutex);

        SDL_Flip(screen);
        SDL_Delay(10);

        SDL_BlitSurface(empty, NULL, screen, &rect);
    }

```

--------------------------------

### Link LibVLC Library

Source: https://wiki.videolan.org/LibVLC_Tutorial_0.9

Command to link the LibVLC library when compiling a C program.

```bash
cc example.c -lvlc -o example
```

--------------------------------

### SDL Event Loop and LibVLC Playback Control

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This snippet shows the main event loop for an SDL application integrated with LibVLC. It handles user input for pausing and quitting, and includes LibVLC cleanup.

```c
            case ' ': 
                printf("Pause toggle.\n");
                pause = !pause;
                break;
        }

        if(!pause) { context.n++; } 

        SDL_Delay(1000/10);
    }

    // Stop stream and clean up libVLC.
    libvlc_media_player_stop(mp);
    libvlc_media_player_release(mp);
    libvlc_release(libvlc);

    // Close window and clean up libSDL.
    SDL_DestroyMutex(context.mutex);
    SDL_DestroyRenderer(context.renderer);

    quit(0);

    return 0;
}

```

--------------------------------

### Makefile for Windows Compilation

Source: https://wiki.videolan.org/LibVLC_Tutorial_086c

Makefile to compile a C program using libVLC on Windows. It specifies include paths and library locations.

```makefile
VLC_INST = "C:\\Program files\\VideoLAN\\VLC"
VLC_SRC = "C:\\tools\\vlc-0.8.6c\"
demo: demo.c
   gcc -o demo demo.c -I$(VLC_SRC)/include \
   -L$(VLC_INST) -llibvlc
```

--------------------------------

### Update Video Surface Position and Blit

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

Calculates the position for blitting a video surface based on time and trigonometric functions, then blits the surface to the screen. This is done within a loop that increments a counter if not paused.

```c
        rect.x = (int)((1. + .5 * sin(0.03 * n)) * (WIDTH - VIDEOWIDTH) / 2);
        rect.y = (int)((1. + .5 * cos(0.03 * n)) * (HEIGHT - VIDEOHEIGHT) / 2);

        if(!pause)
            n++;

```

--------------------------------

### Clean Up SDL Resources

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This section details the cleanup process for SDL resources, including destroying the mutex, freeing surfaces, and quitting the SDL library. This ensures no memory leaks occur.

```c
    /*
     * Close window and clean up libSDL
     */
    SDL_DestroyMutex(ctx.mutex);
    SDL_FreeSurface(ctx.surf);
    SDL_FreeSurface(empty);

    SDL_Quit();

    return 0;
}

```

--------------------------------

### Return 0 from Rendering Function

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

Indicates successful completion of a rendering operation. This is typically the last statement in a rendering callback or function.

```c
return 0;
}
```

--------------------------------

### LibVLC vmem Unlock Callback with Custom Rendering

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This C code defines the 'unlock' function for LibVLC's vmem output. It includes custom rendering logic to draw a border on the video surface before unlocking.

```c
static void unlock(struct ctx *ctx)
{
    /* VLC just rendered the video, but we can also render stuff */
    uint16_t *pixels = (uint16_t *)ctx->surf->pixels;
    int x, y;

    for(y = 10; y < 40; y++)
        for(x = 10; x < 40; x++)
            if(x < 13 || y < 13 || x > 36 || y > 36)
                pixels[y * VIDEOWIDTH + x] = 0xffff;
            else
                pixels[y * VIDEOWIDTH + x] = 0x0;

    SDL_UnlockSurface(ctx->surf);
    SDL_UnlockMutex(ctx->mutex);
}

```

--------------------------------

### LibVLC vmem Lock Callback for Older API

Source: https://wiki.videolan.org/LibVLC_SampleCode_SDL

This C code defines the 'lock' function used as a callback for LibVLC's vmem output module in older versions (pre-0.9.x). It acquires mutex and surface locks.

```c
#ifdef VLC09X
static void * lock(struct ctx *ctx)
{
    SDL_LockMutex(ctx->mutex);
    SDL_LockSurface(ctx->surf);
    return ctx->surf->pixels;
}
#else
static void lock(struct ctx *ctx, void **pp_ret)
{
    SDL_LockMutex(ctx->mutex);
    SDL_LockSurface(ctx->surf);
    *pp_ret = ctx->surf->pixels;
}
#endif

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.