View source for LibVLC Media List Management

== Global Description of the available objects ==
The atomic item that represent a media that you can play is a '''libvlc_media''' in LibVLC.

A '''media_list''' is an object that contains several ''libvlc_media''. You can add items to that media_list.

You can play a media_list using a '''media_list_player'''.

== A media descriptor can contain a media list ==
A playlist downloaded from Google video has a corresponding ''libvlc_media''. This ''libvlc_media'' has several subitems. You can access them through libvlc_media_subitems() which returns a media_list.


This explains how a media_list can be hierarchical. To browse it you'll use libvlc_media_list_hierarchy_view(). To view the all the item without hierarchy use libvlc_media_list_flat_view().

== Sample Code ==

 void setup_media_list( libvlc_instance_t * p_vlc, libvlc_drawable_t window )
 {

     libvlc_media_list_t *ml;
     libvlc_media_list_player_t *mlp;
     libvlc_media_player_t *mp;
     libvlc_media_descriptor_t *md1, *md2;
  
     ml = libvlc_media_list_new(vlc);
    
     md1 = libvlc_media_new(vlc, "http://mycool.com/movie1.avi");
     md2 = libvlc_media_new(vlc, "http://mycool.com/movie2.avi");
  
     libvlc_media_list_add(ml, md1);
     libvlc_media_list_add(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);
 }