diff --git a/docs/.buildinfo b/docs/.buildinfo index 2b134510..022a96fc 100644 --- a/docs/.buildinfo +++ b/docs/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 8020ebe066f0d54b096fd89678222a29 +config: 9280651401cf5d9593ef84f00ccf13b8 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/README.html b/docs/README.html index 6f2399f5..4bcb4e8d 100644 --- a/docs/README.html +++ b/docs/README.html @@ -58,7 +58,7 @@
Docs home
- v1.1.2 + v1.2.0
@@ -88,8 +88,7 @@
  • From source
    • -
  • Binary install
    • -
  • Dependencies
    • +
  • Binary install (currently only for windows)
  • Usage
    • +
  • Dependencies +
  • Contributing @@ -179,7 +184,7 @@

    Pympress is a free software, distributed under the terms of the GPL license (version 2 or, at your option, any later version).

    Pympress was originally created and maintained by Schnouki, on his repo.

    @@ -188,89 +193,119 @@

    Installing

    If you have python

    +

    First, make sure you have all the dependencies.

    Using pip

    -

    Run the following command in your shell (or replace python3 -m pip with python -m pip or just pip):

    -
    python3 -m pip install pympress
+
    Run the following command in your shell (or replace python3 -m pip with python -m pip or just pip, and ):
    
+
    python3 -m pip install pympress
 
    
 
    
 
    Or you can get it from github:
    
-
    python3 -m pip install git+https://github.com/Cimbali/pympress#egg=pympress
+
    python3 -m pip install git+https://github.com/Cimbali/pympress#egg=pympress
 
    
 
    
-
    If you don't have pip, see the python documentation on installing. You may also want to check that you have all the dependencies.
    
+
    If you don’t have pip, see the python documentation on installing.
    
 
    
 
    
 
    From source
    
-
    If you also want the source code, you can clone this repo or grab the latest releases' source, open a console where you put the code, and type python3 -m pip install . (or, if you plan on modifying that code, python3 -m pip install -e .). Same remarks as above apply.
    
+
    If you also want the source code, you can clone this repo or grab the latest releases’ source, open a console where you put the code, and type python3 -m pip install . (or, if you plan on modifying that code, python3 -m pip install -e .).
    
+
    
+
    
+
    
+
    Binary install (currently only for windows)
    
+
    Grab the latest installer for your platform and execute it.
+If you don’t want to know about source code or dependencies, this is for you.
    
+
    Packages with ‘amd64’ in the name are for 64 bit machines, ‘x86’ for 32 bit machines. The ‘vlc’ suffix indicates that the installer ships VLC as well, so try it if the other version fails to read videos.
    
+
    If you get an error message along the lines of “MSVCP100.dll is missing”, get the Visual C++ redistributables from Microsoft (x86 (32 bit) or x64 (64 bits)). Those libraries really should already be installed on your system.
    -
    -

    Binary install

    -

    If you don't want to know about source code or dependencies, this is for you. -Grab the latest installer for your platform and execute it. You're done!

    -

    Currently binaries are only available for windows (.msi files). Choose packages with 'amd64' in the name if you have a 64 bit machine, 'x86' if you have a 32 bit machine. The 'vlc' suffix indicates that this installer ships VLC as well to support video, so try it if the other version fails to read videos.

    -

    On windows, in the unlikely event you get an error message along the lines of "MSVCP100.dll is missing", you can download this package from Microsoft for x86 (32 bit) or for x64 (64 bits). Those libraries really should already be installed on your system.

    +
    +

    Usage

    +
    +

    Opening a file

    +

    Simply start Pympress and it will ask you what file you want to open. +You can also start pympress from the command line with a file to open like so: +pympress slides.pdf +or +python3 -m pympress slides.pdf

    +
    +
    +

    Functionalities

    +

    All functionalities are available from the menus of the window with slide previews. Don’t be afraid to experiment with them!

    +

    Keyboard shortcuts are also listed in these menus. Some more usual shortcuts are often available, for example Ctrl+L, and F11 also toggle fullscreen, though the main shortcut is just F.

    +

    A few of the fancier functionalities are listed here:

    +
      +

    • Swap screens: If Pympress mixed up which screen is the projector and which is not, press S

      +
      • +

    • Go To Slide: To jump to a selected slide without flashing through the whole presentation on the projector, press G or click the “current slide” box.

      +

      A spin box will appear, and you will be able to navigate through your slides in the presenter window only by scrolling your mouse, with the Home/Up/Down/End keys, with the + and - buttons of the spin box, or simply by typing in the number of the slide. Press Enter to validate going to the new slide or Esc to cancel.

      +
      • +

    • Estimated talk time: Click the Time estimation box and set your planned talk duration. You can also pass this on the command line through the -ett flag. The color will allow you to see at a glance how much time you have left.

      +
      • +

    • Adjust screen centering: If your slides’ form factor doesn’t fit the projectors’ and you don’t want the slide centered in the window, use the “Screen Center” option in the “Presentation” menu.

      +
      • +

    • Resize Current/Next slide: You can drag the bar between both slides on the Presenter window to adjust their relative sizes to your liking.

      +
      • +

    • Preferences: Some of your choices are saved in a configuration file, in ~/.config/pympress or ~/.pympress on linux, and in %APPDATA%/pympress.ini on windows.

      +
      • +

    • Cache: For efficiency, Pympress caches rendered pages (up to 200 by default). If this is too memory consuming for you, you can change this number in the configuration file.

      +
      • +
    +
    -

    Dependencies

    +

    Dependencies

    Pympress relies on:

    • Python, 3.x or 2.7 (with setuptools, which is usually shipped by default with python).
    • Poppler, the PDF rendering library.
    • Gtk+ 3, a toolkit for creating graphical user interfaces, and its dependencies, specifically:
      • Cairo (and python bindings for cairo), the graphics library which is used to pre-render and draw over PDF pages.
        • -
      • Gdk, a lower-level graphics library to handles icons.
        • +
      • Gdk, a lower-level graphics library to handle icons.
    • PyGi, the python bindings for Gtk+3. PyGi is also known as pygobject3, just pygobject or python3-gi.
        -
      • Introspection bindings for poppler may be shipped separately, ensure you have those as well (typelib-1_0-Poppler-0_18 on OpenSUSE, gir1.2-poppler-0.18 on Ubuntu)
        • +
      • Introspection bindings for poppler may be shipped separately, ensure you have those as well (typelib-1_0-Poppler-0_18 on OpenSUSE, gir1.2-poppler-0.18 on Ubuntu)
    • optionally VLC, to play videos (with the same bitness as Python)
    -

    On windows GTK+3, Poppler and their python bindings are all shipped together in the PyGi installer. Be sure to check the supported Python versions (up to 3.4 at the time of writing), they appear in the FEATURES list in the linked page. Be sure to tick all the necessary dependencies in the installer (Poppler, Cairo, Gdk-Pixbuf).

    -

    On other platforms they are often installed by default, or easily available through your package or software manager. +

    +

    On linux platforms

    +

    The dependencies are often installed by default, or easily available through your package or software manager. For example, on ubuntu, you can run the following as root to make sure you have all the prerequisites assuming you use python3:

    -
    apt-get install python3 python3-pip libgtk-3-0 libpoppler-glib8 libcairo2 python3-gi python3-cairo gir1.2-gtk-3.0 gir1.2-poppler-0.18
+
    apt-get install python3 python3-pip libgtk-3-0 libpoppler-glib8 libcairo2 python3-gi python3-cairo gir1.2-gtk-3.0 gir1.2-poppler-0.18
 
    
 
    
 
    Different distributions might have different package naming conventions, for example the equivalent on OpenSUSE would be:
    
-
    zypper in python3 python3-pip libgtk-3-0 libpoppler-glib8 libcairo2 python3-gobject python3-gobject-Gdk python3-cairo typelib-1_0-GdkPixbuf-2_0 typelib-1_0-Gtk-3_0 typelib-1_0-Poppler-0_18
+
    zypper in python3 python3-pip libgtk-3-0 libpoppler-glib8 libcairo2 python3-gobject python3-gobject-Gdk python3-cairo typelib-1_0-GdkPixbuf-2_0 typelib-1_0-Gtk-3_0 typelib-1_0-Poppler-0_18
 
    
 
    
 
    
+
    
+
    On windows
    
+
    There are two ways to get the dependencies:
    
+
      
+
    1. using MSYS2 (replace x86_64 with i686 if you’re using a 32 bit machine):
      
+
       pacman -S --needed mingw-w64-x86_64-gtk3 mingw-w64-x86_64-cairo mingw-w64-x86_64-poppler mingw-w64-x86_64-python3 mingw-w64-x86_64-vlc python3-pip mingw-w64-x86_64-python3-pip mingw-w64-x86_64-python3-gobject mingw-w64-x86_64-python3-cairo
+
      
 
      
-
      
-
      Usage
      
-
      
-
      Opening a file
      
-
      Simply start Pympress and it will ask you what file you want to open.
-You can also start pympress from the command line with a file to open like so:
-pympress slides.pdf
      
-
      
-
      
-
      Functionalities
      
-
      All functionalities are available from the menus of the window with slide previews. Don't be afraid to experiment with them!
      
-
      Keyboard shortcuts are also listed in these menus. Some more usual shortcuts are often available, for example Ctrl+L, and F11 also toggle fullscreen, though the main shortcut is just F.
      
-
      A few of the fancier functionalities are listed here:
      
-
        
-
      • Swap screens: If Pympress mixed up which screen is the projector and which is not, press S
        
 
        • 
-
      • Go To Slide: To jump to a selected slide without flashing through the whole presentation on the projector, press G or click the "current  slide" box.
        
-
        A spin box will appear, and you will be able to navigate through your slides in the presenter window only by scrolling your mouse, with the Home/Up/Down/End keys, with the + and - buttons of the spin box, or simply by typing in the number of the slide. Press Enter to validate going to the new slide or Esc to cancel.
        
-
        • 
-
      • Estimated talk time: Click the Time estimation box and set your planned talk duration. You can also pass this on the command line through the -ett flag. The color will allow you to see at a glance how much time you have left.
        
-
        • 
-
      • Adjust screen centering: If your slides' form factor doesn't fit the projectors' and you don't want the slide centered in the window, use the "Screen Center" option in the "Presentation" menu.
        
-
        • 
-
      • Resize Current/Next slide: You can drag the bar between both slides on the Presenter window to adjust their relative sizes to your liking.
        
-
        • 
-
      • Preferences: Some of your choices are saved in a configuration file, in ~/.config/pympress or ~/.pympress on linux, and in %APPDATA%/pympress.ini on windows.
        
-
        • 
-
      • Cache: For efficiency, Pympress caches rendered pages (up to 200 by default). If this is too memory consuming for you, you can change this number in the configuration file.
        
+
      • Using PyGobjectWin32. Be sure to check the supported Python versions (up to 3.4 at the time of writing), they appear in the FEATURES list in the linked page.
        
 
        • 
+
    
+
      
+
    • Install native python for windows
      • 
+
    • Get GTK+3, Poppler and their python bindings by executing the PyGi installer.  Be sure to tick all the necessary dependencies in the installer (Poppler, Cairo, Gdk-Pixbuf).
      • 
 
    
+
    Alternately, you can build your Gtk+3 stack from source using MSVC, see the Gnome wiki and this python script that compiles the whole Gtk+3 stack
    
+
    
+
    
+
    On macOS
    
+
    Dependencies can be installed using Homebrew:
    
+
    brew install gtk+3 poppler gobject-introspection
+
    
+
    
 
    
 
    
 
    
@@ -279,8 +314,8 @@
 Pympress has inline sphinx documentation (Google style, contains rst syntax), and the docs folder contains the documentation generated from it, hosted on the github pages of this repo.
    
 
    
 
    Translations
    
-
    If you want to add a translation, check if pympress/share/locale/<language>/pympress.po already exists. If not, take the template file as input and translate all the strings, then add it to the repo in pympress/share/locale/<language>/pympress.po.
-Finally pass this .po file to msgfmt and add the output to the repo at pympress/share/locale/<language>/LC_MESSAGES/pympress.mo.
    
+
    If you want to add a translation, check if pympress/share/locale/<language>/pympress.po already exists. If not, take the template file as input and translate all the strings, then add it to the repo in pympress/share/locale/<language>/pympress.po.
+Finally pass this .po file to msgfmt and add the output to the repo at pympress/share/locale/<language>/LC_MESSAGES/pympress.mo.
    
 
    
 
    
 
@@ -328,7 +363,7 @@
     
-
-
-
-
-
-   
-  
    
-
-    
-    
-
-    
    
-
-      
-      
-
-
-      
-      
    
-        
    
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
    
-
-  
-
-  
-  
    
-
    
-          
    
-           
    
-            
-  
    Source code for ctypes
    -"""create and manipulate C data types in Python"""
-
-import os as _os, sys as _sys
-
-__version__ = "1.1.0"
-
-from _ctypes import Union, Structure, Array
-from _ctypes import _Pointer
-from _ctypes import CFuncPtr as _CFuncPtr
-from _ctypes import __version__ as _ctypes_version
-from _ctypes import RTLD_LOCAL, RTLD_GLOBAL
-from _ctypes import ArgumentError
-
-from struct import calcsize as _calcsize
-
-if __version__ != _ctypes_version:
-    raise Exception("Version number mismatch", __version__, _ctypes_version)
-
-if _os.name == "nt":
-    from _ctypes import FormatError
-
-DEFAULT_MODE = RTLD_LOCAL
-if _os.name == "posix" and _sys.platform == "darwin":
-    # On OS X 10.3, we use RTLD_GLOBAL as default mode
-    # because RTLD_LOCAL does not work at least on some
-    # libraries.  OS X 10.3 is Darwin 7, so we check for
-    # that.
-
-    if int(_os.uname().release.split('.')[0]) < 8:
-        DEFAULT_MODE = RTLD_GLOBAL
-
-from _ctypes import FUNCFLAG_CDECL as _FUNCFLAG_CDECL, \
-     FUNCFLAG_PYTHONAPI as _FUNCFLAG_PYTHONAPI, \
-     FUNCFLAG_USE_ERRNO as _FUNCFLAG_USE_ERRNO, \
-     FUNCFLAG_USE_LASTERROR as _FUNCFLAG_USE_LASTERROR
-
-# WINOLEAPI -> HRESULT
-# WINOLEAPI_(type)
-#
-# STDMETHODCALLTYPE
-#
-# STDMETHOD(name)
-# STDMETHOD_(type, name)
-#
-# STDAPICALLTYPE
-
-def create_string_buffer(init, size=None):
-    """create_string_buffer(aBytes) -> character array
-    create_string_buffer(anInteger) -> character array
-    create_string_buffer(aBytes, anInteger) -> character array
-    """
-    if isinstance(init, bytes):
-        if size is None:
-            size = len(init)+1
-        buftype = c_char * size
-        buf = buftype()
-        buf.value = init
-        return buf
-    elif isinstance(init, int):
-        buftype = c_char * init
-        buf = buftype()
-        return buf
-    raise TypeError(init)
-
-def c_buffer(init, size=None):
-##    "deprecated, use create_string_buffer instead"
-##    import warnings
-##    warnings.warn("c_buffer is deprecated, use create_string_buffer instead",
-##                  DeprecationWarning, stacklevel=2)
-    return create_string_buffer(init, size)
-
-_c_functype_cache = {}
-def CFUNCTYPE(restype, *argtypes, **kw):
-    """CFUNCTYPE(restype, *argtypes,
-                 use_errno=False, use_last_error=False) -> function prototype.
-
-    restype: the result type
-    argtypes: a sequence specifying the argument types
-
-    The function prototype can be called in different ways to create a
-    callable object:
-
-    prototype(integer address) -> foreign function
-    prototype(callable) -> create and return a C callable function from callable
-    prototype(integer index, method name[, paramflags]) -> foreign function calling a COM method
-    prototype((ordinal number, dll object)[, paramflags]) -> foreign function exported by ordinal
-    prototype((function name, dll object)[, paramflags]) -> foreign function exported by name
-    """
-    flags = _FUNCFLAG_CDECL
-    if kw.pop("use_errno", False):
-        flags |= _FUNCFLAG_USE_ERRNO
-    if kw.pop("use_last_error", False):
-        flags |= _FUNCFLAG_USE_LASTERROR
-    if kw:
-        raise ValueError("unexpected keyword argument(s) %s" % kw.keys())
-    try:
-        return _c_functype_cache[(restype, argtypes, flags)]
-    except KeyError:
-        class CFunctionType(_CFuncPtr):
-            _argtypes_ = argtypes
-            _restype_ = restype
-            _flags_ = flags
-        _c_functype_cache[(restype, argtypes, flags)] = CFunctionType
-        return CFunctionType
-
-if _os.name == "nt":
-    from _ctypes import LoadLibrary as _dlopen
-    from _ctypes import FUNCFLAG_STDCALL as _FUNCFLAG_STDCALL
-
-    _win_functype_cache = {}
-    def WINFUNCTYPE(restype, *argtypes, **kw):
-        # docstring set later (very similar to CFUNCTYPE.__doc__)
-        flags = _FUNCFLAG_STDCALL
-        if kw.pop("use_errno", False):
-            flags |= _FUNCFLAG_USE_ERRNO
-        if kw.pop("use_last_error", False):
-            flags |= _FUNCFLAG_USE_LASTERROR
-        if kw:
-            raise ValueError("unexpected keyword argument(s) %s" % kw.keys())
-        try:
-            return _win_functype_cache[(restype, argtypes, flags)]
-        except KeyError:
-            class WinFunctionType(_CFuncPtr):
-                _argtypes_ = argtypes
-                _restype_ = restype
-                _flags_ = flags
-            _win_functype_cache[(restype, argtypes, flags)] = WinFunctionType
-            return WinFunctionType
-    if WINFUNCTYPE.__doc__:
-        WINFUNCTYPE.__doc__ = CFUNCTYPE.__doc__.replace("CFUNCTYPE", "WINFUNCTYPE")
-
-elif _os.name == "posix":
-    from _ctypes import dlopen as _dlopen
-
-from _ctypes import sizeof, byref, addressof, alignment, resize
-from _ctypes import get_errno, set_errno
-from _ctypes import _SimpleCData
-
-def _check_size(typ, typecode=None):
-    # Check if sizeof(ctypes_type) against struct.calcsize.  This
-    # should protect somewhat against a misconfigured libffi.
-    from struct import calcsize
-    if typecode is None:
-        # Most _type_ codes are the same as used in struct
-        typecode = typ._type_
-    actual, required = sizeof(typ), calcsize(typecode)
-    if actual != required:
-        raise SystemError("sizeof(%s) wrong: %d instead of %d" % \
-                          (typ, actual, required))
-
-class py_object(_SimpleCData):
-    _type_ = "O"
-    def __repr__(self):
-        try:
-            return super().__repr__()
-        except ValueError:
-            return "%s(<NULL>)" % type(self).__name__
-_check_size(py_object, "P")
-
-class c_short(_SimpleCData):
-    _type_ = "h"
-_check_size(c_short)
-
-class c_ushort(_SimpleCData):
-    _type_ = "H"
-_check_size(c_ushort)
-
-class c_long(_SimpleCData):
-    _type_ = "l"
-_check_size(c_long)
-
-class c_ulong(_SimpleCData):
-    _type_ = "L"
-_check_size(c_ulong)
-
-if _calcsize("i") == _calcsize("l"):
-    # if int and long have the same size, make c_int an alias for c_long
-    c_int = c_long
-    c_uint = c_ulong
-else:
-    class c_int(_SimpleCData):
-        _type_ = "i"
-    _check_size(c_int)
-
-    class c_uint(_SimpleCData):
-        _type_ = "I"
-    _check_size(c_uint)
-
-class c_float(_SimpleCData):
-    _type_ = "f"
-_check_size(c_float)
-
-class c_double(_SimpleCData):
-    _type_ = "d"
-_check_size(c_double)
-
-class c_longdouble(_SimpleCData):
-    _type_ = "g"
-if sizeof(c_longdouble) == sizeof(c_double):
-    c_longdouble = c_double
-
-if _calcsize("l") == _calcsize("q"):
-    # if long and long long have the same size, make c_longlong an alias for c_long
-    c_longlong = c_long
-    c_ulonglong = c_ulong
-else:
-    class c_longlong(_SimpleCData):
-        _type_ = "q"
-    _check_size(c_longlong)
-
-    class c_ulonglong(_SimpleCData):
-        _type_ = "Q"
-    ##    def from_param(cls, val):
-    ##        return ('d', float(val), val)
-    ##    from_param = classmethod(from_param)
-    _check_size(c_ulonglong)
-
-class c_ubyte(_SimpleCData):
-    _type_ = "B"
-c_ubyte.__ctype_le__ = c_ubyte.__ctype_be__ = c_ubyte
-# backward compatibility:
-##c_uchar = c_ubyte
-_check_size(c_ubyte)
-
-class c_byte(_SimpleCData):
-    _type_ = "b"
-c_byte.__ctype_le__ = c_byte.__ctype_be__ = c_byte
-_check_size(c_byte)
-
-class c_char(_SimpleCData):
-    _type_ = "c"
-c_char.__ctype_le__ = c_char.__ctype_be__ = c_char
-_check_size(c_char)
-
-class c_char_p(_SimpleCData):
-    _type_ = "z"
-    def __repr__(self):
-        return "%s(%s)" % (self.__class__.__name__, c_void_p.from_buffer(self).value)
-_check_size(c_char_p, "P")
-
-class c_void_p(_SimpleCData):
-    _type_ = "P"
-c_voidp = c_void_p # backwards compatibility (to a bug)
-_check_size(c_void_p)
-
-class c_bool(_SimpleCData):
-    _type_ = "?"
-
-from _ctypes import POINTER, pointer, _pointer_type_cache
-
-class c_wchar_p(_SimpleCData):
-    _type_ = "Z"
-    def __repr__(self):
-        return "%s(%s)" % (self.__class__.__name__, c_void_p.from_buffer(self).value)
-
-class c_wchar(_SimpleCData):
-    _type_ = "u"
-
-def _reset_cache():
-    _pointer_type_cache.clear()
-    _c_functype_cache.clear()
-    if _os.name == "nt":
-        _win_functype_cache.clear()
-    # _SimpleCData.c_wchar_p_from_param
-    POINTER(c_wchar).from_param = c_wchar_p.from_param
-    # _SimpleCData.c_char_p_from_param
-    POINTER(c_char).from_param = c_char_p.from_param
-    _pointer_type_cache[None] = c_void_p
-    # XXX for whatever reasons, creating the first instance of a callback
-    # function is needed for the unittests on Win64 to succeed.  This MAY
-    # be a compiler bug, since the problem occurs only when _ctypes is
-    # compiled with the MS SDK compiler.  Or an uninitialized variable?
-    CFUNCTYPE(c_int)(lambda: None)
-
-def create_unicode_buffer(init, size=None):
-    """create_unicode_buffer(aString) -> character array
-    create_unicode_buffer(anInteger) -> character array
-    create_unicode_buffer(aString, anInteger) -> character array
-    """
-    if isinstance(init, str):
-        if size is None:
-            size = len(init)+1
-        buftype = c_wchar * size
-        buf = buftype()
-        buf.value = init
-        return buf
-    elif isinstance(init, int):
-        buftype = c_wchar * init
-        buf = buftype()
-        return buf
-    raise TypeError(init)
-
-
-# XXX Deprecated
-def SetPointerType(pointer, cls):
-    if _pointer_type_cache.get(cls, None) is not None:
-        raise RuntimeError("This type already exists in the cache")
-    if id(pointer) not in _pointer_type_cache:
-        raise RuntimeError("What's this???")
-    pointer.set_type(cls)
-    _pointer_type_cache[cls] = pointer
-    del _pointer_type_cache[id(pointer)]
-
-# XXX Deprecated
-def ARRAY(typ, len):
-    return typ * len
-
-################################################################
-
-
-class CDLL(object):
-    """An instance of this class represents a loaded dll/shared
-    library, exporting functions using the standard C calling
-    convention (named 'cdecl' on Windows).
-
-    The exported functions can be accessed as attributes, or by
-    indexing with the function name.  Examples:
-
-    <obj>.qsort -> callable object
-    <obj>['qsort'] -> callable object
-
-    Calling the functions releases the Python GIL during the call and
-    reacquires it afterwards.
-    """
-    _func_flags_ = _FUNCFLAG_CDECL
-    _func_restype_ = c_int
-    # default values for repr
-    _name = '<uninitialized>'
-    _handle = 0
-    _FuncPtr = None
-
-    def __init__(self, name, mode=DEFAULT_MODE, handle=None,
-                 use_errno=False,
-                 use_last_error=False):
-        self._name = name
-        flags = self._func_flags_
-        if use_errno:
-            flags |= _FUNCFLAG_USE_ERRNO
-        if use_last_error:
-            flags |= _FUNCFLAG_USE_LASTERROR
-
-        class _FuncPtr(_CFuncPtr):
-            _flags_ = flags
-            _restype_ = self._func_restype_
-        self._FuncPtr = _FuncPtr
-
-        if handle is None:
-            self._handle = _dlopen(self._name, mode)
-        else:
-            self._handle = handle
-
-    def __repr__(self):
-        return "<%s '%s', handle %x at %#x>" % \
-               (self.__class__.__name__, self._name,
-                (self._handle & (_sys.maxsize*2 + 1)),
-                id(self) & (_sys.maxsize*2 + 1))
-
-    def __getattr__(self, name):
-        if name.startswith('__') and name.endswith('__'):
-            raise AttributeError(name)
-        func = self.__getitem__(name)
-        setattr(self, name, func)
-        return func
-
-    def __getitem__(self, name_or_ordinal):
-        func = self._FuncPtr((name_or_ordinal, self))
-        if not isinstance(name_or_ordinal, int):
-            func.__name__ = name_or_ordinal
-        return func
-
-class PyDLL(CDLL):
-    """This class represents the Python library itself.  It allows
-    accessing Python API functions.  The GIL is not released, and
-    Python exceptions are handled correctly.
-    """
-    _func_flags_ = _FUNCFLAG_CDECL | _FUNCFLAG_PYTHONAPI
-
-if _os.name == "nt":
-
-    class WinDLL(CDLL):
-        """This class represents a dll exporting functions using the
-        Windows stdcall calling convention.
-        """
-        _func_flags_ = _FUNCFLAG_STDCALL
-
-    # XXX Hm, what about HRESULT as normal parameter?
-    # Mustn't it derive from c_long then?
-    from _ctypes import _check_HRESULT, _SimpleCData
-    class HRESULT(_SimpleCData):
-        _type_ = "l"
-        # _check_retval_ is called with the function's result when it
-        # is used as restype.  It checks for the FAILED bit, and
-        # raises an OSError if it is set.
-        #
-        # The _check_retval_ method is implemented in C, so that the
-        # method definition itself is not included in the traceback
-        # when it raises an error - that is what we want (and Python
-        # doesn't have a way to raise an exception in the caller's
-        # frame).
-        _check_retval_ = _check_HRESULT
-
-    class OleDLL(CDLL):
-        """This class represents a dll exporting functions using the
-        Windows stdcall calling convention, and returning HRESULT.
-        HRESULT error values are automatically raised as OSError
-        exceptions.
-        """
-        _func_flags_ = _FUNCFLAG_STDCALL
-        _func_restype_ = HRESULT
-
-class LibraryLoader(object):
-    def __init__(self, dlltype):
-        self._dlltype = dlltype
-
-    def __getattr__(self, name):
-        if name[0] == '_':
-            raise AttributeError(name)
-        dll = self._dlltype(name)
-        setattr(self, name, dll)
-        return dll
-
-    def __getitem__(self, name):
-        return getattr(self, name)
-
-    def LoadLibrary(self, name):
-        return self._dlltype(name)
-
-cdll = LibraryLoader(CDLL)
-pydll = LibraryLoader(PyDLL)
-
-if _os.name == "nt":
-    pythonapi = PyDLL("python dll", None, _sys.dllhandle)
-elif _sys.platform == "cygwin":
-    pythonapi = PyDLL("libpython%d.%d.dll" % _sys.version_info[:2])
-else:
-    pythonapi = PyDLL(None)
-
-
-if _os.name == "nt":
-    windll = LibraryLoader(WinDLL)
-    oledll = LibraryLoader(OleDLL)
-
-    if _os.name == "nt":
-        GetLastError = windll.kernel32.GetLastError
-    else:
-        GetLastError = windll.coredll.GetLastError
-    from _ctypes import get_last_error, set_last_error
-
-    def WinError(code=None, descr=None):
-        if code is None:
-            code = GetLastError()
-        if descr is None:
-            descr = FormatError(code).strip()
-        return OSError(None, descr, None, code)
-
-if sizeof(c_uint) == sizeof(c_void_p):
-    c_size_t = c_uint
-    c_ssize_t = c_int
-elif sizeof(c_ulong) == sizeof(c_void_p):
-    c_size_t = c_ulong
-    c_ssize_t = c_long
-elif sizeof(c_ulonglong) == sizeof(c_void_p):
-    c_size_t = c_ulonglong
-    c_ssize_t = c_longlong
-
-# functions
-
-from _ctypes import _memmove_addr, _memset_addr, _string_at_addr, _cast_addr
-
-## void *memmove(void *, const void *, size_t);
-memmove = CFUNCTYPE(c_void_p, c_void_p, c_void_p, c_size_t)(_memmove_addr)
-
-## void *memset(void *, int, size_t)
-memset = CFUNCTYPE(c_void_p, c_void_p, c_int, c_size_t)(_memset_addr)
-
-def PYFUNCTYPE(restype, *argtypes):
-    class CFunctionType(_CFuncPtr):
-        _argtypes_ = argtypes
-        _restype_ = restype
-        _flags_ = _FUNCFLAG_CDECL | _FUNCFLAG_PYTHONAPI
-    return CFunctionType
-
-_cast = PYFUNCTYPE(py_object, c_void_p, py_object, py_object)(_cast_addr)
-def cast(obj, typ):
-    return _cast(obj, obj, typ)
-
-_string_at = PYFUNCTYPE(py_object, c_void_p, c_int)(_string_at_addr)
-def string_at(ptr, size=-1):
-    """string_at(addr[, size]) -> string
-
-    Return the string at addr."""
-    return _string_at(ptr, size)
-
-try:
-    from _ctypes import _wstring_at_addr
-except ImportError:
-    pass
-else:
-    _wstring_at = PYFUNCTYPE(py_object, c_void_p, c_int)(_wstring_at_addr)
-    def wstring_at(ptr, size=-1):
-        """wstring_at(addr[, size]) -> string
-
-        Return the string at addr."""
-        return _wstring_at(ptr, size)
-
-
-if _os.name == "nt": # COM stuff
-    def DllGetClassObject(rclsid, riid, ppv):
-        try:
-            ccom = __import__("comtypes.server.inprocserver", globals(), locals(), ['*'])
-        except ImportError:
-            return -2147221231 # CLASS_E_CLASSNOTAVAILABLE
-        else:
-            return ccom.DllGetClassObject(rclsid, riid, ppv)
-
-    def DllCanUnloadNow():
-        try:
-            ccom = __import__("comtypes.server.inprocserver", globals(), locals(), ['*'])
-        except ImportError:
-            return 0 # S_OK
-        return ccom.DllCanUnloadNow()
-
-from ctypes._endian import BigEndianStructure, LittleEndianStructure
-
-# Fill in specifically-sized types
-c_int8 = c_byte
-c_uint8 = c_ubyte
-for kind in [c_short, c_int, c_long, c_longlong]:
-    if sizeof(kind) == 2: c_int16 = kind
-    elif sizeof(kind) == 4: c_int32 = kind
-    elif sizeof(kind) == 8: c_int64 = kind
-for kind in [c_ushort, c_uint, c_ulong, c_ulonglong]:
-    if sizeof(kind) == 2: c_uint16 = kind
-    elif sizeof(kind) == 4: c_uint32 = kind
-    elif sizeof(kind) == 8: c_uint64 = kind
-del(kind)
-
-_reset_cache()
-
    
-
-           
    
-           
    
-            
-           
    
-          
    
-          
    
-  
-
-  
    
-
-  
    
-    
    
-        © Copyright 2009-2011, Thomas Jost; 2015-2017 Cimbali.
-
-    
    
-  
    
-  Built with Sphinx using a theme provided by Read the Docs. 
-
-
    
-
-        
    
-      
    
-
-    
    
-
-  
    
-  
-
-
-  
-
-    
-      
-      
-      
-
-  
-
-  
-  
-    
-  
-
-  
-  
-  
-   
-
-
-
\ No newline at end of file
diff --git a/docs/_modules/gi/overrides/Gdk.html b/docs/_modules/gi/overrides/Gdk.html
index 86d5ccff..83f61b46 100644
--- a/docs/_modules/gi/overrides/Gdk.html
+++ b/docs/_modules/gi/overrides/Gdk.html
@@ -57,7 +57,7 @@
 	
    
 	 Docs home
 	
    
-		v1.1.2
+		v1.2.0
 	
    
 
 	
@@ -83,6 +83,7 @@
 
  • What is Pympress?
    • 
 
  • Installing
    • 
 
  • Usage
    • 
+
  • Dependencies
    • 
 
  • Contributing
    • 
 
  • Pympress package
    • 
 
@@ -643,7 +644,7 @@ 
    Source code for gi.overrides.Gdk
         
-
-
-
-
-
-   
-  
    
-
-    
-    
-
-    
    
-
-      
-      
-
-
-      
-      
    
-        
    
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
    
-
-  
-
-  
-  
    
-
    
-          
    
-           
    
-            
-  
    Source code for pympress.callbacks
    -#       callbacks.py
-#
-#       Copyright 2017 Cimbali <me@cimba.li>
-#
-#       This program is free software; you can redistribute it and/or modify
-#       it under the terms of the GNU General Public License as published by
-#       the Free Software Foundation; either version 2 of the License, or
-#       (at your option) any later version.
-#
-#       This program is distributed in the hope that it will be useful,
-#       but WITHOUT ANY WARRANTY; without even the implied warranty of
-#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#       GNU General Public License for more details.
-#
-#       You should have received a copy of the GNU General Public License
-#       along with this program; if not, write to the Free Software
-#       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
-#       MA 02110-1301, USA.
-
-"""
-:mod:`pympress.callbacks` -- Defines callbacks the UI has to implement
-----------------------------------------------------------------------
-"""
-
-from __future__ import print_function
-
-import logging
-logger = logging.getLogger(__name__)
-
-
-
    [docs]class UICallbacks(object):
-
-
    [docs]    def get_current_page(self):
-        """ Statically get page and page type
-
-        Returns:
-            (:class:`~pympress.document.Page`, `int`): The current page, and one
-            of `~pympress.ui.PDF_REGULAR`, `~pympress.ui.PDF_CONTENT_PAGE`, or `~pympress.ui.PDF_NOTES_PAGE`
-        """
-        raise NotImplementedError
    
-
-
-
    [docs]    def goto_page(self, page_number):
-        """ Go to the given page number.
-
-        Args:
-            page_number (`int`): the desired page number.
-        """
-        raise NotImplementedError
    
-
-
-
    [docs]    def on_page_change(self, unpause = True):
-        """ Statically notify the UI of a page change (typically from document)
-
-        Args:
-            unpause (`bool`): whether to unpause the click while updating the page
-        """
-        raise NotImplementedError
    
-
-
-
    [docs]    def redraw_current_slide(self):
-        """ Static way to queue a redraw of the current slides (in both winows)
-        """
-        raise NotImplementedError
    
-
-
-
    [docs]class EditableButton(object):
-
-
    [docs]    def start_editing(self):
-        """ Static way to start the label editing.
-        """
-        raise NotImplementedError
    
-
-
-
    [docs]    def stop_editing(self):
-        """ Make sure that the current page number is not being edited.
-        """
-        raise NotImplementedError
    
-
-# Instance of a class inheriting from :class:`~callbacks.UICallbacks`, that will handle the above-defined callbacks
-ui = None
-
-# Instance of a class inheriting from :class:`~callbacks.EditableButtonCallbacks`
-page_number = None
-
-# Instance of a class inheriting from :class:`~callbacks.EditableButtonCallbacks`
-talk_time = None
-
-
-
    
-
-           
    
-           
    
-            
-           
    
-          
    
-          
    
-  
-
-  
    
-
-  
    
-    
    
-        © Copyright 2009-2011, Thomas Jost; 2015-2017 Cimbali.
-
-    
    
-  
    
-  Built with Sphinx using a theme provided by Read the Docs. 
-
-
    
-
-        
    
-      
    
-
-    
    
-
-  
    
-  
-
-
-  
-
-    
-      
-      
-      
-
-  
-
-  
-  
-    
-  
-
-  
-  
-  
-   
-
-
-
\ No newline at end of file
diff --git a/docs/_modules/pympress/config.html b/docs/_modules/pympress/config.html
index b4e479bc..30cb789a 100644
--- a/docs/_modules/pympress/config.html
+++ b/docs/_modules/pympress/config.html
@@ -57,7 +57,7 @@
 	
    
 	 Docs home
 	
    
-		v1.1.2
+		v1.2.0
 	
    
 
 	
@@ -83,6 +83,7 @@
 
  • What is Pympress?
    • 
 
  • Installing
    • 
 
  • Usage
    • 
+
  • Dependencies
    • 
 
  • Contributing
    • 
 
  • Pympress package
    • 
 
@@ -191,6 +192,7 @@ 
    Source code for pympress.config
     
 import os.path
 import json
+from collections import deque
 
 try:
     import configparser
@@ -244,13 +246,11 @@ 
    Source code for pympress.config
     
    [docs]class Config(configparser.ConfigParser, object): # python 2 fix
     """ Manage configuration :Get the configuration from its file and store its back.
     """
-    #: `dict`-tree of presenter layout for the notes mode
-    notes_layout = {}
-    #: `dict`-tree of presenter layout for the non-notes mode
-    plain_layout = {}
+    #: `dict`-tree of presenter layouts for various modes
+    layout = {}
 
-    #: Set of strings that are the valid names of widgets from the presenter window that can be dynamically rearranged
-    placeable_widgets = {"notes", "current", "next", "annotations"}
+    #: Map of strings that are the valid representations of widgets from the presenter window that can be dynamically rearranged, mapping to their names
+    placeable_widgets = {"notes": "p_frame_notes", "current": "p_frame_cur", "next": "p_frame_next", "annotations": "p_frame_annot", "highlight": "scribble_overlay"}
 
 
    [docs]    @staticmethod
     def path_to_config():
@@ -324,6 +324,9 @@ 
    Source code for pympress.config
             if not config.has_option('layout', 'plain'):
             config.set('layout', 'plain', '')
 
+        if not config.has_option('layout', 'highlight'):
+            config.set('layout', 'highlight', '')
+
         if not config.has_option('scribble', 'color'):
             config.set('scribble', 'color', Gdk.RGBA(1., 0., 0., 1.).to_string())
 
@@ -337,8 +340,8 @@ 
    Source code for pympress.config
             """ Save the configuration to its file.
         """
         # serialize the layouts
-        self.set('layout', 'notes', json.dumps(self.notes_layout, indent=4))
-        self.set('layout', 'plain', json.dumps(self.plain_layout, indent=4))
+        for layout_name in self.layout:
+            self.set('layout', layout_name, json.dumps(self.layout[layout_name], indent=4))
 
         with open(self.path_to_config(), 'w') as configfile:
             self.write(configfile)
    
@@ -354,12 +357,13 @@ 
    Source code for pympress.config
             self.set(window, start_conf, 'on' if check_item.get_active() else 'off')
    
 
 
-
    [docs]    def validate_layout(self, layout, expected_widgets):
+
    [docs]    def validate_layout(self, layout, expected_widgets, optional_widgets = set()):
         """ Validate layout: check whether the layout of widgets built from the config string is valid.
 
         Args:
             layout (`dict`): the json-parsed config string
-            expected_widgets (`set`): strings with the names of widgets for this layout
+            expected_widgets (`set`): strings with the names of widgets that have to be used in this layout
+            optional_widgets (`set`): strings with the names of widgets that may or may not be used in this layout
 
 
         Layout must have all self.placeable_widgets (leaves of the tree, as `str`) and only allowed properties
@@ -373,12 +377,12 @@ 
    Source code for pympress.config
             of all the resizeable items (if and only if resizeable).
         """
 
-        next_visits = [layout]
+        next_visits = deque([layout])
         widget_seen = set()
         while next_visits:
-            w_desc = next_visits.pop(0)
+            w_desc = next_visits.popleft()
             if type(w_desc) is str:
-                if w_desc not in expected_widgets:
+                if w_desc not in expected_widgets and w_desc not in optional_widgets:
                     raise ValueError('Unrecognized widget "{}", pick one of: {}'.format(w_desc, ', '.join(expected_widgets)))
                 elif w_desc in widget_seen:
                     raise ValueError('Duplicate widget "{}", all expected_widgets can only appear once'.format(w_desc))
@@ -398,7 +402,7 @@ 
    Source code for pympress.config
                         elif type(w_desc['proportions']) is not list or any(type(n) is not float for n in w_desc['proportions']) or len(w_desc['proportions']) != len(w_desc['children']) or abs(sum(w_desc['proportions']) - 1) > 1e-10:
                         raise ValueError('"proportions" must be a list of floats (one per separator), between 0 and 1, at node {}'.format(w_desc))
 
-                next_visits += w_desc['children']
+                next_visits.extend(w_desc['children'])
             else:
                 raise ValueError('Unexpected type {}, nodes must be dicts or strings, at node {}'.format(type(w_desc), w_desc))
         widget_missing = expected_widgets - widget_seen
@@ -409,23 +413,26 @@ 
    Source code for pympress.config
     
    [docs]    def load_window_layouts(self):
         """ Parse and validate layouts loaded from config, with fallbacks if needed.
         """
-        default_notes_layout = '{"resizeable":true, "orientation":"horizontal", "children":["notes", {"resizeable":false, "children":["current", "next"], "orientation":"vertical"}], "proportions": [0.60, 0.40]}'
-        default_plain_layout = '{"resizeable":true, "orientation":"horizontal", "children":["current", {"resizeable":true, "orientation":"vertical", "children":["next", "annotations"], "proportions":[0.55, 0.45]}], "proportions":[0.67, 0.33]}'
-
-        # Log error and keep default layout
-        try:
-            self.notes_layout = layout_from_json(self.get('layout', 'notes'))
-            self.validate_layout(self.notes_layout, self.placeable_widgets - {"annotations"})
-        except ValueError as e:
-            logger.exception('Invalid layout')
-            self.notes_layout = layout_from_json(default_notes_layout)
-
-        try:
-            self.plain_layout = layout_from_json(self.get('layout', 'plain'))
-            self.validate_layout(self.plain_layout, self.placeable_widgets - {"notes"})
-        except ValueError as e:
-            logger.exception('Invalid layout')
-            self.plain_layout = layout_from_json(default_plain_layout)
    
+        default_layout = {
+            'notes':     '{"resizeable":true, "orientation":"horizontal", "children":["notes", {"resizeable":false, "children":["current", "next"], "orientation":"vertical"}], "proportions": [0.60, 0.40]}',
+            'plain':     '{"resizeable":true, "orientation":"horizontal", "children":["current", {"resizeable":true, "orientation":"vertical", "children":["next", "annotations"], "proportions":[0.55, 0.45]}], "proportions":[0.67, 0.33]}',
+            'highlight': '{"resizeable":true, "orientation":"horizontal", "children":["highlight", {"resizeable":true, "orientation":"vertical", "children":["next", "annotations"], "proportions":[0.55, 0.45]}], "proportions":[0.67, 0.33]}'
+        }
+
+        widget_reqs = {
+            'notes':     (set(self.placeable_widgets.keys()) - {"annotations", "highlight"},),
+            'plain':     (set(self.placeable_widgets.keys()) - {"notes", "highlight"},),
+            'highlight': ({"highlight"}, set(self.placeable_widgets.keys()) - {"highlight"})
+        }
+
+        for layout_name in default_layout:
+            # Log error and keep default layout
+            try:
+                self.layout[layout_name] = layout_from_json(self.get('layout', layout_name))
+                self.validate_layout(self.layout[layout_name] , *widget_reqs[layout_name])
+            except ValueError as e:
+                logger.exception('Invalid layout')
+                self.layout[layout_name] = layout_from_json(default_layout[layout_name])
    
 
 
 
    [docs]    def widget_layout_to_tree(self, widget, pane_handle_pos):
@@ -441,9 +448,16 @@ 
    Source code for pympress.config
             """
         orientation_names = {Gtk.Orientation.HORIZONTAL:'horizontal', Gtk.Orientation.VERTICAL:'vertical'}
 
-        if issubclass(type(widget), Gtk.Box):
-            node = {'resizeable': False, 'children': [self.widget_layout_to_tree(c, pane_handle_pos) for c in widget.get_children()],
+        name = widget.get_name()
+        matching_widget_names = [k for k, v in self.placeable_widgets.items() if v == name]
+
+        if matching_widget_names:
+            return matching_widget_names[0]
+
+        elif issubclass(type(widget), Gtk.Box):
+            return {'resizeable': False, 'children': [self.widget_layout_to_tree(c, pane_handle_pos) for c in widget.get_children()],
                     'orientation': orientation_names[widget.get_orientation()]}
+
         elif issubclass(type(widget), Gtk.Paned):
             proportions = [1]
             reverse_children = []
@@ -470,51 +484,27 @@ 
    Source code for pympress.config
     
             reverse_children.append(left_pane)
 
-            node = {'resizeable': True, 'children': [self.widget_layout_to_tree(c, pane_handle_pos) for c in reversed(reverse_children)],
+            return {'resizeable': True, 'children': [self.widget_layout_to_tree(c, pane_handle_pos) for c in reversed(reverse_children)],
                     'proportions': proportions, 'orientation': orientation_names[orientation]}
 
-        else:
-            name = widget.get_name()
-            if name.startswith('p_frame_') and name[len('p_frame_'):] in self.placeable_widgets:
-                node = name[len('p_frame_'):]
-            else:
-                raise ValueError('Error serializing layout: widget of type {} is not an expected container or named widget: {}'.format(type(widget), widget))
-
-        return node
    
+        raise ValueError('Error serializing layout: widget of type {} is not an expected container or named widget: "{}"'.format(type(widget), name))
    
 
 
-
    [docs]    def get_notes_layout(self):
-        """ Getter for the notes layout.
+
    [docs]    def get_layout(self, layout_name):
+        """ Getter for the `~layout_name` layout.
         """
-        return self.notes_layout
    
+        return self.layout[layout_name]
    
 
 
-
    [docs]    def get_plain_layout(self):
-        """ Getter for the plain layout.
-        """
-        return self.plain_layout
    
-
-
-
    [docs]    def update_notes_layout(self, widget, pane_handle_pos):
+
    [docs]    def update_layout(self, layout_name, widget, pane_handle_pos):
         """ Setter for the notes layout.
 
         Args:
+            layout_name (`str`): the name of the layout to update
             widget (:class:`~Gtk.Widget`): the widget that will contain the layout.
             pane_handle_pos (`dict`): Map of :class:`~Gtk.Paned` to the relative position (float between 0 and 1) of its handle
         """
-        self.notes_layout = self.widget_layout_to_tree(widget, pane_handle_pos)
    
-
-
-
    [docs]    def update_plain_layout(self, widget, pane_handle_pos):
-        """ Setter for the plain layout.
-
-        Args:
-            widget (:class:`~Gtk.Widget`): the widget that will contain the layout.
-            pane_handle_pos (`dict`): Map of :class:`~Gtk.Paned` to the relative position (float between 0 and 1) of its handle
-        """
-        self.plain_layout = self.widget_layout_to_tree(widget, pane_handle_pos)
    
-
-
+        self.layout[layout_name] = self.widget_layout_to_tree(widget, pane_handle_pos)
    
 
    
 
            
    
@@ -551,7 +541,7 @@ 
    Source code for pympress.config
         
-
-
-
-
-
-   
-  
    
-
-    
-    
-
-    
    
-
-      
-      
-
-
-      
-      
    
-        
    
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
    
-
-  
-
-  
-  
    
-
    
-          
    
-           
    
-            
-  
    Source code for pympress.page_number
    -#       page_number.py
-#
-#       Copyright 2017 Cimbali <me@cimba.li>
-#
-#       This program is free software; you can redistribute it and/or modify
-#       it under the terms of the GNU General Public License as published by
-#       the Free Software Foundation; either version 2 of the License, or
-#       (at your option) any later version.
-#
-#       This program is distributed in the hope that it will be useful,
-#       but WITHOUT ANY WARRANTY; without even the implied warranty of
-#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#       GNU General Public License for more details.
-#
-#       You should have received a copy of the GNU General Public License
-#       along with this program; if not, write to the Free Software
-#       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
-#       MA 02110-1301, USA.
-
-"""
-:mod:`pympress.page_number` -- Manages the display of page numbers
-------------------------------------------------------------------
-"""
-
-from __future__ import print_function
-
-import logging
-logger = logging.getLogger(__name__)
-
-import gi
-gi.require_version('Gtk', '3.0')
-from gi.repository import Gtk, Gdk, GLib
-import time
-
-from pympress import callbacks, editable_label
-
-
    [docs]class PageNumber(editable_label.EditableLabel):
-    #: Slide counter :class:`~Gtk.Label` for the current slide.
-    label_cur = None
-    #: Slide counter :class:`~Gtk.Label` for the last slide.
-    label_last = None
-    #: :class:`~Gtk.EventBox` associated with the slide counter label in the Presenter window.
-    eb_cur = None
-    #: :class:`~Gtk.HBox` containing the slide counter label in the Presenter window.
-    hb_cur = None
-    #: :class:`~Gtk.SpinButton` used to switch to another slide by typing its number.
-    spin_cur = None
-
-    #: `int` holding the maximum page number in the document
-    max_page_number = 1
-
-
-    def __init__(self, builder):
-        """ Load all the widgets we need from the spinner.
-
-        Args:
-            builder (:class:`~pympress.builder.Builder`): A builder from which to load widgets
-        """
-        super(PageNumber, self).__init__()
-
-        builder.load_widgets(self)
-
-        # Initially (from XML) both the spinner and the current page label are visible.
-        self.hb_cur.remove(self.spin_cur)
-
-        self.shortcut_key = 'G'
-        callbacks.page_number = self
-
-
-
    [docs]    def set_last(self, num_pages):
-        """ Set the max number of pages, both on display and as the range of values for the spinner.
-
-        Args:
-            num_pages (`int`): The maximum page number
-        """
-        self.max_page_number = num_pages
-        self.label_last.set_text("/{}".format(num_pages))
-        self.spin_cur.set_range(1, num_pages)
    
-
-
-
    [docs]    def validate(self):
-        """ Get the page number from the spinner and go to that page
-        """
-        try:
-            page_nb = int(self.spin_cur.get_buffer().get_text()) - 1
-        except:
-            page_nb = int(self.spin_cur.get_value()) - 1
-        callbacks.ui.goto_page(page_nb)
    
-
-
-
    [docs]    def cancel(self):
-        """ Make the UI re-display the pages from before editing the current page.
-        """
-        GLib.idle_add(callbacks.ui.on_page_change, False)
    
-
-
-
    [docs]    def more_actions(self, event, name):
-        """ Implement directions (left/right/home/end) keystrokes, otherwise pass on to :func:`~Gtk.SpinButton.do_key_press_event()`
-        """
-        if name == 'home':
-            self.spin_cur.set_value(1)
-        elif name == 'end':
-            self.spin_cur.set_value(self.max_page_number)
-        elif name == 'left':
-            self.spin_cur.set_value(self.spin_cur.get_value() - 1)
-        elif name == 'right':
-            self.spin_cur.set_value(self.spin_cur.get_value() + 1)
-        else:
-            return Gtk.SpinButton.do_key_press_event(self.spin_cur, event)
-
-        return True
    
-
-
-
    [docs]    def on_scroll(self, widget, event):
-        """ Scroll event. Pass it on to the spin button if we're currently editing the page number.
-
-        Args:
-            widget (:class:`~Gtk.Widget`):  the widget which has received the event.
-            event (:class:`~Gdk.Event`):  the GTK event.
-
-        Returns:
-            `bool`: whether the event was consumed
-        """
-        if not self.editing:
-            return False
-        else:
-            return Gtk.SpinButton.do_scroll_event(self.spin_cur, event)
    
-
-
-
    [docs]    def swap_label_for_entry(self):
-        """ Perform the actual work of starting the editing.
-        """
-        callbacks.talk_time.stop_editing()
-
-        # Replace label with entry
-        self.hb_cur.remove(self.label_cur)
-        self.spin_cur.show()
-        self.hb_cur.add(self.spin_cur)
-        self.hb_cur.reorder_child(self.spin_cur, 0)
-        self.spin_cur.grab_focus()
-
-        self.spin_cur.set_value(int(self.label_cur.get_text()))
-        self.spin_cur.select_region(0, -1)
-
-        self.editing = True
    
-
-
-
    [docs]    def restore_label(self):
-        """ Make sure that the current page number is displayed in a label and not in an entry.
-        If it is an entry, then replace it with the label.
-        """
-        if self.label_cur not in self.hb_cur:
-            self.hb_cur.remove(self.spin_cur)
-            self.hb_cur.pack_start(self.label_cur, True, True, 0)
-            self.hb_cur.reorder_child(self.label_cur, 0)
-
-        self.editing = False
    
-
-
-
    [docs]    def update_page_numbers(self, cur_nb):
-        """ Update the displayed page numbers.
-
-        Args:
-            cur_nb (`int`): The current page number, in documentation numbering (range [0..max - 1])
-        """
-        cur = str(cur_nb+1)
-
-        self.label_cur.set_text(cur)
-        self.restore_label()
    
-
-
-
    
-
-           
    
-           
    
-            
-           
    
-          
    
-          
    
-  
-
-  
    
-
-  
    
-    
    
-        © Copyright 2009-2011, Thomas Jost; 2015-2017 Cimbali.
-
-    
    
-  
    
-  Built with Sphinx using a theme provided by Read the Docs. 
-
-
    
-
-        
    
-      
    
-
-    
    
-
-  
    
-  
-
-
-  
-
-    
-      
-      
-      
-
-  
-
-  
-  
-    
-  
-
-  
-  
-  
-   
-
-
-
\ No newline at end of file
diff --git a/docs/_modules/pympress/pointer.html b/docs/_modules/pympress/pointer.html
index 03fd53e2..f9aeca91 100644
--- a/docs/_modules/pympress/pointer.html
+++ b/docs/_modules/pympress/pointer.html
@@ -57,7 +57,7 @@
 	
    
 	 Docs home
 	
    
-		v1.1.2
+		v1.2.0
 	
    
 
 	
@@ -83,6 +83,7 @@
 
  • What is Pympress?
    • 
 
  • Installing
    • 
 
  • Usage
    • 
+
  • Dependencies
    • 
 
  • Contributing
    • 
 
  • Pympress package
    • 
 
@@ -274,7 +275,8 @@ 
    Source code for pympress.pointer
             if self.show_pointer == POINTER_SHOW:
             x = ww * self.pointer_pos[0] - self.pointer.get_width() / 2
             y = wh * self.pointer_pos[1] - self.pointer.get_height() / 2
-            Gdk.cairo_set_source_pixbuf(cairo_context, self.pointer, x, y)
    
+            Gdk.cairo_set_source_pixbuf(cairo_context, self.pointer, x, y)
+            cairo_context.paint()
    
 
 
 
    [docs]    def track_pointer(self, widget, event):
@@ -366,7 +368,7 @@ 
    Source code for pympress.pointer
         
-
-
-
-
-
-   
-  
    
-
-    
-    
-
-    
    
-
-      
-      
-
-
-      
-      
    
-        
    
-          
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
    
-
-  
-
-  
-  
    
-
    
-          
    
-           
    
-            
-  
    Source code for vlc
    -#! /usr/bin/python
-# -*- coding: utf-8 -*-
-
-# Python ctypes bindings for VLC
-#
-# Copyright (C) 2009-2017 the VideoLAN team
-# $Id: $
-#
-# Authors: Olivier Aubert <contact at olivieraubert.net>
-#          Jean Brouwers <MrJean1 at gmail.com>
-#          Geoff Salmon <geoff.salmon at gmail.com>
-#
-# This library is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as
-# published by the Free Software Foundation; either version 2.1 of the
-# License, or (at your option) any later version.
-#
-# This library is distributed in the hope that it will be useful, but
-# WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-# Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public
-# License along with this library; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301 USA
-
-"""This module provides bindings for the LibVLC public API, see
-U{http://wiki.videolan.org/LibVLC}.
-
-You can find the documentation and a README file with some examples
-at U{http://www.olivieraubert.net/vlc/python-ctypes/}.
-
-Basically, the most important class is L{Instance}, which is used
-to create a libvlc instance.  From this instance, you then create
-L{MediaPlayer} and L{MediaListPlayer} instances.
-
-Alternatively, you may create instances of the L{MediaPlayer} and
-L{MediaListPlayer} class directly and an instance of L{Instance}
-will be implicitly created.  The latter can be obtained using the
-C{get_instance} method of L{MediaPlayer} and L{MediaListPlayer}.
-"""
-
-import ctypes
-from ctypes.util import find_library
-import os
-import sys
-import functools
-
-# Used by EventManager in override.py
-from inspect import getargspec
-
-import logging
-logger = logging.getLogger(__name__)
-
-__version__ = "2.2.6100"
-__libvlc_version__ = "2.2.6"
-__generator_version__ = "1.0"
-build_date  = "Tue Oct 10 18:56:50 2017 2.2.6"
-
-# The libvlc doc states that filenames are expected to be in UTF8, do
-# not rely on sys.getfilesystemencoding() which will be confused,
-# esp. on windows.
-DEFAULT_ENCODING = 'utf-8'
-
-if sys.version_info[0] > 2:
-    str = str
-    unicode = str
-    bytes = bytes
-    basestring = (str, bytes)
-    PYTHON3 = True
-    def str_to_bytes(s):
-        """Translate string or bytes to bytes.
-        """
-        if isinstance(s, str):
-            return bytes(s, DEFAULT_ENCODING)
-        else:
-            return s
-
-    def bytes_to_str(b):
-        """Translate bytes to string.
-        """
-        if isinstance(b, bytes):
-            return b.decode(DEFAULT_ENCODING)
-        else:
-            return b
-else:
-    str = str
-    unicode = unicode
-    bytes = str
-    basestring = basestring
-    PYTHON3 = False
-
    [docs]    def str_to_bytes(s):
-        """Translate string or bytes to bytes.
-        """
-        if isinstance(s, unicode):
-            return s.encode(DEFAULT_ENCODING)
-        else:
-            return s
    
-
-
    [docs]    def bytes_to_str(b):
-        """Translate bytes to unicode string.
-        """
-        if isinstance(b, str):
-            return unicode(b, DEFAULT_ENCODING)
-        else:
-            return b
    
-
-# Internal guard to prevent internal classes to be directly
-# instanciated.
-_internal_guard = object()
-
-
    [docs]def find_lib():
-    dll = None
-    plugin_path = os.environ.get('PYTHON_VLC_MODULE_PATH', None)
-    if 'PYTHON_VLC_LIB_PATH' in os.environ:
-        try:
-            dll = ctypes.CDLL(os.environ['PYTHON_VLC_LIB_PATH'])
-        except OSError:
-            logger.error("Cannot load lib specified by PYTHON_VLC_LIB_PATH env. variable")
-            sys.exit(1)
-    if plugin_path and not os.path.isdir(plugin_path):
-        logger.error("Invalid PYTHON_VLC_MODULE_PATH specified. Please fix.")
-        sys.exit(1)
-    if dll is not None:
-        return dll, plugin_path
-
-    if sys.platform.startswith('linux'):
-        p = find_library('vlc')
-        try:
-            dll = ctypes.CDLL(p)
-        except OSError:  # may fail
-            dll = ctypes.CDLL('libvlc.so.5')
-    elif sys.platform.startswith('win'):
-        libname = 'libvlc.dll'
-        p = find_library(libname)
-        if p is None:
-            try:  # some registry settings
-                # leaner than win32api, win32con
-                if PYTHON3:
-                    import winreg as w
-                else:
-                    import _winreg as w
-                for r in w.HKEY_LOCAL_MACHINE, w.HKEY_CURRENT_USER:
-                    try:
-                        r = w.OpenKey(r, 'Software\\VideoLAN\\VLC')
-                        plugin_path, _ = w.QueryValueEx(r, 'InstallDir')
-                        w.CloseKey(r)
-                        break
-                    except w.error:
-                        pass
-            except ImportError:  # no PyWin32
-                pass
-            if plugin_path is None:
-                # try some standard locations.
-                programfiles = os.environ["ProgramFiles"]
-                homedir = os.environ["HOMEDRIVE"]
-                for p in ('{programfiles}\\VideoLan{libname}', '{homedir}:\\VideoLan{libname}',
-                          '{programfiles}{libname}',           '{homedir}:{libname}'):
-                    p = p.format(homedir = homedir,
-                                 programfiles = programfiles,
-                                 libname = '\\VLC\\' + libname)
-                    if os.path.exists(p):
-                        plugin_path = os.path.dirname(p)
-                        break
-            if plugin_path is not None:  # try loading
-                p = os.getcwd()
-                os.chdir(plugin_path)
-                 # if chdir failed, this will raise an exception
-                dll = ctypes.CDLL(libname)
-                 # restore cwd after dll has been loaded
-                os.chdir(p)
-            else:  # may fail
-                dll = ctypes.CDLL(libname)
-        else:
-            plugin_path = os.path.dirname(p)
-            dll = ctypes.CDLL(p)
-
-    elif sys.platform.startswith('darwin'):
-        # FIXME: should find a means to configure path
-        d = '/Applications/VLC.app/Contents/MacOS/'
-        p = d + 'lib/libvlc.dylib'
-        if os.path.exists(p):
-            dll = ctypes.CDLL(p)
-            for p in ('modules', 'plugins'):
-                p = d + p
-                if os.path.isdir(p):
-                    plugin_path = p
-                    break
-        else:  # hope, some PATH is set...
-            dll = ctypes.CDLL('libvlc.dylib')
-
-    else:
-        raise NotImplementedError('%s: %s not supported' % (sys.argv[0], sys.platform))
-
-    return (dll, plugin_path)
    
-
-# plugin_path used on win32 and MacOS in override.py
-dll, plugin_path  = find_lib()
-
-
    [docs]class VLCException(Exception):
-    """Exception raised by libvlc methods.
-    """
-    pass
    
-
-try:
-    _Ints = (int, long)
-except NameError:  # no long in Python 3+
-    _Ints =  int
-_Seqs = (list, tuple)
-
-# Used for handling *event_manager() methods.
-
    [docs]class memoize_parameterless(object):
-    """Decorator. Caches a parameterless method's return value each time it is called.
-
-    If called later with the same arguments, the cached value is returned
-    (not reevaluated).
-    Adapted from https://wiki.python.org/moin/PythonDecoratorLibrary
-    """
-    def __init__(self, func):
-        self.func = func
-        self._cache = {}
-
-    def __call__(self, obj):
-        try:
-            return self._cache[obj]
-        except KeyError:
-            v = self._cache[obj] = self.func(obj)
-            return v
-
-    def __repr__(self):
-        """Return the function's docstring.
-        """
-        return self.func.__doc__
-
-    def __get__(self, obj, objtype):
-      """Support instance methods.
-      """
-      return functools.partial(self.__call__, obj)
    
-
-# Default instance. It is used to instanciate classes directly in the
-# OO-wrapper.
-_default_instance = None
-
-
    [docs]def get_default_instance():
-    """Return the default VLC.Instance.
-    """
-    global _default_instance
-    if _default_instance is None:
-        _default_instance = Instance()
-    return _default_instance
    
-
-_Cfunctions = {}  # from LibVLC __version__
-_Globals = globals()  # sys.modules[__name__].__dict__
-
-def _Cfunction(name, flags, errcheck, *types):
-    """(INTERNAL) New ctypes function binding.
-    """
-    if hasattr(dll, name) and name in _Globals:
-        p = ctypes.CFUNCTYPE(*types)
-        f = p((name, dll), flags)
-        if errcheck is not None:
-            f.errcheck = errcheck
-        # replace the Python function
-        # in this module, but only when
-        # running as python -O or -OO
-        if __debug__:
-            _Cfunctions[name] = f
-        else:
-            _Globals[name] = f
-        return f
-    raise NameError('no function %r' % (name,))
-
-def _Cobject(cls, ctype):
-    """(INTERNAL) New instance from ctypes.
-    """
-    o = object.__new__(cls)
-    o._as_parameter_ = ctype
-    return o
-
-def _Constructor(cls, ptr=_internal_guard):
-    """(INTERNAL) New wrapper from ctypes.
-    """
-    if ptr == _internal_guard:
-        raise VLCException("(INTERNAL) ctypes class. You should get references for this class through methods of the LibVLC API.")
-    if ptr is None or ptr == 0:
-        return None
-    return _Cobject(cls, ctypes.c_void_p(ptr))
-
-class _Cstruct(ctypes.Structure):
-    """(INTERNAL) Base class for ctypes structures.
-    """
-    _fields_ = []  # list of 2-tuples ('name', ctyptes.<type>)
-
-    def __str__(self):
-        l = [' %s:\t%s' % (n, getattr(self, n)) for n, _ in self._fields_]
-        return '\n'.join([self.__class__.__name__] + l)
-
-    def __repr__(self):
-        return '%s.%s' % (self.__class__.__module__, self)
-
-class _Ctype(object):
-    """(INTERNAL) Base class for ctypes.
-    """
-    @staticmethod
-    def from_param(this):  # not self
-        """(INTERNAL) ctypes parameter conversion method.
-        """
-        if this is None:
-            return None
-        return this._as_parameter_
-
-
    [docs]class ListPOINTER(object):
-    """Just like a POINTER but accept a list of ctype as an argument.
-    """
-    def __init__(self, etype):
-        self.etype = etype
-
-
    [docs]    def from_param(self, param):
-        if isinstance(param, _Seqs):
-            return (self.etype * len(param))(*param)
-        else:
-            return ctypes.POINTER(param)
    
-
-# errcheck functions for some native functions.
-
    [docs]def string_result(result, func, arguments):
-    """Errcheck function. Returns a string and frees the original pointer.
-
-    It assumes the result is a char *.
-    """
-    if result:
-        # make a python string copy
-        s = bytes_to_str(ctypes.string_at(result))
-        # free original string ptr
-        libvlc_free(result)
-        return s
-    return None
    
-
-
    [docs]def class_result(classname):
-    """Errcheck function. Returns a function that creates the specified class.
-    """
-    def wrap_errcheck(result, func, arguments):
-        if result is None:
-            return None
-        return classname(result)
-    return wrap_errcheck
    
-
-# Wrapper for the opaque struct libvlc_log_t
-
    [docs]class Log(ctypes.Structure):
-    pass
    
-Log_ptr = ctypes.POINTER(Log)
-
-# FILE* ctypes wrapper, copied from
-# http://svn.python.org/projects/ctypes/trunk/ctypeslib/ctypeslib/contrib/pythonhdr.py
-
    [docs]class FILE(ctypes.Structure):
-    pass
    
-FILE_ptr = ctypes.POINTER(FILE)
-
-if PYTHON3:
-    PyFile_FromFd = ctypes.pythonapi.PyFile_FromFd
-    PyFile_FromFd.restype = ctypes.py_object
-    PyFile_FromFd.argtypes = [ctypes.c_int,
-                              ctypes.c_char_p,
-                              ctypes.c_char_p,
-                              ctypes.c_int,
-                              ctypes.c_char_p,
-                              ctypes.c_char_p,
-                              ctypes.c_char_p,
-                              ctypes.c_int ]
-
-    PyFile_AsFd = ctypes.pythonapi.PyObject_AsFileDescriptor
-    PyFile_AsFd.restype = ctypes.c_int
-    PyFile_AsFd.argtypes = [ctypes.py_object]
-else:
-    PyFile_FromFile = ctypes.pythonapi.PyFile_FromFile
-    PyFile_FromFile.restype = ctypes.py_object
-    PyFile_FromFile.argtypes = [FILE_ptr,
-                                ctypes.c_char_p,
-                                ctypes.c_char_p,
-                                ctypes.CFUNCTYPE(ctypes.c_int, FILE_ptr)]
-
-    PyFile_AsFile = ctypes.pythonapi.PyFile_AsFile
-    PyFile_AsFile.restype = FILE_ptr
-    PyFile_AsFile.argtypes = [ctypes.py_object]
-
- # Generated enum types #
-
-class _Enum(ctypes.c_uint):
-    '''(INTERNAL) Base class
-    '''
-    _enum_names_ = {}
-
-    def __str__(self):
-        n = self._enum_names_.get(self.value, '') or ('FIXME_(%r)' % (self.value,))
-        return '.'.join((self.__class__.__name__, n))
-
-    def __hash__(self):
-        return self.value
-
-    def __repr__(self):
-        return '.'.join((self.__class__.__module__, self.__str__()))
-
-    def __eq__(self, other):
-        return ( (isinstance(other, _Enum) and self.value == other.value)
-              or (isinstance(other, _Ints) and self.value == other) )
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-
    [docs]class LogLevel(_Enum):
-    '''Logging messages level.
-\note future libvlc versions may define new levels.
-    '''
-    _enum_names_ = {
-        0: 'DEBUG',
-        2: 'NOTICE',
-        3: 'WARNING',
-        4: 'ERROR',
-    }
    
-LogLevel.DEBUG   = LogLevel(0)
-LogLevel.ERROR   = LogLevel(4)
-LogLevel.NOTICE  = LogLevel(2)
-LogLevel.WARNING = LogLevel(3)
-
-
    [docs]class EventType(_Enum):
-    '''Event types.
-    '''
-    _enum_names_ = {
-        0: 'MediaMetaChanged',
-        1: 'MediaSubItemAdded',
-        2: 'MediaDurationChanged',
-        3: 'MediaParsedChanged',
-        4: 'MediaFreed',
-        5: 'MediaStateChanged',
-        6: 'MediaSubItemTreeAdded',
-        0x100: 'MediaPlayerMediaChanged',
-        257: 'MediaPlayerNothingSpecial',
-        258: 'MediaPlayerOpening',
-        259: 'MediaPlayerBuffering',
-        260: 'MediaPlayerPlaying',
-        261: 'MediaPlayerPaused',
-        262: 'MediaPlayerStopped',
-        263: 'MediaPlayerForward',
-        264: 'MediaPlayerBackward',
-        265: 'MediaPlayerEndReached',
-        266: 'MediaPlayerEncounteredError',
-        267: 'MediaPlayerTimeChanged',
-        268: 'MediaPlayerPositionChanged',
-        269: 'MediaPlayerSeekableChanged',
-        270: 'MediaPlayerPausableChanged',
-        271: 'MediaPlayerTitleChanged',
-        272: 'MediaPlayerSnapshotTaken',
-        273: 'MediaPlayerLengthChanged',
-        274: 'MediaPlayerVout',
-        275: 'MediaPlayerScrambledChanged',
-        279: 'MediaPlayerCorked',
-        280: 'MediaPlayerUncorked',
-        281: 'MediaPlayerMuted',
-        282: 'MediaPlayerUnmuted',
-        283: 'MediaPlayerAudioVolume',
-        0x200: 'MediaListItemAdded',
-        513: 'MediaListWillAddItem',
-        514: 'MediaListItemDeleted',
-        515: 'MediaListWillDeleteItem',
-        0x300: 'MediaListViewItemAdded',
-        769: 'MediaListViewWillAddItem',
-        770: 'MediaListViewItemDeleted',
-        771: 'MediaListViewWillDeleteItem',
-        0x400: 'MediaListPlayerPlayed',
-        1025: 'MediaListPlayerNextItemSet',
-        1026: 'MediaListPlayerStopped',
-        0x500: 'MediaDiscovererStarted',
-        1281: 'MediaDiscovererEnded',
-        0x600: 'VlmMediaAdded',
-        1537: 'VlmMediaRemoved',
-        1538: 'VlmMediaChanged',
-        1539: 'VlmMediaInstanceStarted',
-        1540: 'VlmMediaInstanceStopped',
-        1541: 'VlmMediaInstanceStatusInit',
-        1542: 'VlmMediaInstanceStatusOpening',
-        1543: 'VlmMediaInstanceStatusPlaying',
-        1544: 'VlmMediaInstanceStatusPause',
-        1545: 'VlmMediaInstanceStatusEnd',
-        1546: 'VlmMediaInstanceStatusError',
-    }
    
-EventType.MediaDiscovererEnded          = EventType(1281)
-EventType.MediaDiscovererStarted        = EventType(0x500)
-EventType.MediaDurationChanged          = EventType(2)
-EventType.MediaFreed                    = EventType(4)
-EventType.MediaListItemAdded            = EventType(0x200)
-EventType.MediaListItemDeleted          = EventType(514)
-EventType.MediaListPlayerNextItemSet    = EventType(1025)
-EventType.MediaListPlayerPlayed         = EventType(0x400)
-EventType.MediaListPlayerStopped        = EventType(1026)
-EventType.MediaListViewItemAdded        = EventType(0x300)
-EventType.MediaListViewItemDeleted      = EventType(770)
-EventType.MediaListViewWillAddItem      = EventType(769)
-EventType.MediaListViewWillDeleteItem   = EventType(771)
-EventType.MediaListWillAddItem          = EventType(513)
-EventType.MediaListWillDeleteItem       = EventType(515)
-EventType.MediaMetaChanged              = EventType(0)
-EventType.MediaParsedChanged            = EventType(3)
-EventType.MediaPlayerAudioVolume        = EventType(283)
-EventType.MediaPlayerBackward           = EventType(264)
-EventType.MediaPlayerBuffering          = EventType(259)
-EventType.MediaPlayerCorked             = EventType(279)
-EventType.MediaPlayerEncounteredError   = EventType(266)
-EventType.MediaPlayerEndReached         = EventType(265)
-EventType.MediaPlayerForward            = EventType(263)
-EventType.MediaPlayerLengthChanged      = EventType(273)
-EventType.MediaPlayerMediaChanged       = EventType(0x100)
-EventType.MediaPlayerMuted              = EventType(281)
-EventType.MediaPlayerNothingSpecial     = EventType(257)
-EventType.MediaPlayerOpening            = EventType(258)
-EventType.MediaPlayerPausableChanged    = EventType(270)
-EventType.MediaPlayerPaused             = EventType(261)
-EventType.MediaPlayerPlaying            = EventType(260)
-EventType.MediaPlayerPositionChanged    = EventType(268)
-EventType.MediaPlayerScrambledChanged   = EventType(275)
-EventType.MediaPlayerSeekableChanged    = EventType(269)
-EventType.MediaPlayerSnapshotTaken      = EventType(272)
-EventType.MediaPlayerStopped            = EventType(262)
-EventType.MediaPlayerTimeChanged        = EventType(267)
-EventType.MediaPlayerTitleChanged       = EventType(271)
-EventType.MediaPlayerUncorked           = EventType(280)
-EventType.MediaPlayerUnmuted            = EventType(282)
-EventType.MediaPlayerVout               = EventType(274)
-EventType.MediaStateChanged             = EventType(5)
-EventType.MediaSubItemAdded             = EventType(1)
-EventType.MediaSubItemTreeAdded         = EventType(6)
-EventType.VlmMediaAdded                 = EventType(0x600)
-EventType.VlmMediaChanged               = EventType(1538)
-EventType.VlmMediaInstanceStarted       = EventType(1539)
-EventType.VlmMediaInstanceStatusEnd     = EventType(1545)
-EventType.VlmMediaInstanceStatusError   = EventType(1546)
-EventType.VlmMediaInstanceStatusInit    = EventType(1541)
-EventType.VlmMediaInstanceStatusOpening = EventType(1542)
-EventType.VlmMediaInstanceStatusPause   = EventType(1544)
-EventType.VlmMediaInstanceStatusPlaying = EventType(1543)
-EventType.VlmMediaInstanceStopped       = EventType(1540)
-EventType.VlmMediaRemoved               = EventType(1537)
-
-
    [docs]class Meta(_Enum):
-    '''Meta data types.
-    '''
-    _enum_names_ = {
-        0: 'Title',
-        1: 'Artist',
-        2: 'Genre',
-        3: 'Copyright',
-        4: 'Album',
-        5: 'TrackNumber',
-        6: 'Description',
-        7: 'Rating',
-        8: 'Date',
-        9: 'Setting',
-        10: 'URL',
-        11: 'Language',
-        12: 'NowPlaying',
-        13: 'Publisher',
-        14: 'EncodedBy',
-        15: 'ArtworkURL',
-        16: 'TrackID',
-        17: 'TrackTotal',
-        18: 'Director',
-        19: 'Season',
-        20: 'Episode',
-        21: 'ShowName',
-        22: 'Actors',
-    }
    
-Meta.Actors      = Meta(22)
-Meta.Album       = Meta(4)
-Meta.Artist      = Meta(1)
-Meta.ArtworkURL  = Meta(15)
-Meta.Copyright   = Meta(3)
-Meta.Date        = Meta(8)
-Meta.Description = Meta(6)
-Meta.Director    = Meta(18)
-Meta.EncodedBy   = Meta(14)
-Meta.Episode     = Meta(20)
-Meta.Genre       = Meta(2)
-Meta.Language    = Meta(11)
-Meta.NowPlaying  = Meta(12)
-Meta.Publisher   = Meta(13)
-Meta.Rating      = Meta(7)
-Meta.Season      = Meta(19)
-Meta.Setting     = Meta(9)
-Meta.ShowName    = Meta(21)
-Meta.Title       = Meta(0)
-Meta.TrackID     = Meta(16)
-Meta.TrackNumber = Meta(5)
-Meta.TrackTotal  = Meta(17)
-Meta.URL         = Meta(10)
-
-
    [docs]class State(_Enum):
-    '''Note the order of libvlc_state_t enum must match exactly the order of
-See mediacontrol_playerstatus, See input_state_e enums,
-and videolan.libvlc.state (at bindings/cil/src/media.cs).
-expected states by web plugins are:
-idle/close=0, opening=1, buffering=2, playing=3, paused=4,
-stopping=5, ended=6, error=7.
-    '''
-    _enum_names_ = {
-        0: 'NothingSpecial',
-        1: 'Opening',
-        2: 'Buffering',
-        3: 'Playing',
-        4: 'Paused',
-        5: 'Stopped',
-        6: 'Ended',
-        7: 'Error',
-    }
    
-State.Buffering      = State(2)
-State.Ended          = State(6)
-State.Error          = State(7)
-State.NothingSpecial = State(0)
-State.Opening        = State(1)
-State.Paused         = State(4)
-State.Playing        = State(3)
-State.Stopped        = State(5)
-
-
    [docs]class TrackType(_Enum):
-    '''N/A
-    '''
-    _enum_names_ = {
-        -1: 'unknown',
-        0: 'audio',
-        1: 'video',
-        2: 'text',
-    }
    
-TrackType.audio   = TrackType(0)
-TrackType.text    = TrackType(2)
-TrackType.unknown = TrackType(-1)
-TrackType.video   = TrackType(1)
-
-
    [docs]class VideoMarqueeOption(_Enum):
-    '''Marq options definition.
-    '''
-    _enum_names_ = {
-        0: 'Enable',
-        1: 'Text',
-        2: 'Color',
-        3: 'Opacity',
-        4: 'Position',
-        5: 'Refresh',
-        6: 'Size',
-        7: 'Timeout',
-        8: 'marquee_X',
-        9: 'marquee_Y',
-    }
    
-VideoMarqueeOption.Color     = VideoMarqueeOption(2)
-VideoMarqueeOption.Enable    = VideoMarqueeOption(0)
-VideoMarqueeOption.Opacity   = VideoMarqueeOption(3)
-VideoMarqueeOption.Position  = VideoMarqueeOption(4)
-VideoMarqueeOption.Refresh   = VideoMarqueeOption(5)
-VideoMarqueeOption.Size      = VideoMarqueeOption(6)
-VideoMarqueeOption.Text      = VideoMarqueeOption(1)
-VideoMarqueeOption.Timeout   = VideoMarqueeOption(7)
-VideoMarqueeOption.marquee_X = VideoMarqueeOption(8)
-VideoMarqueeOption.marquee_Y = VideoMarqueeOption(9)
-
-
-NavigateMode.activate = NavigateMode(0)
-NavigateMode.down     = NavigateMode(2)
-NavigateMode.left     = NavigateMode(3)
-NavigateMode.right    = NavigateMode(4)
-NavigateMode.up       = NavigateMode(1)
-
-class Position(_Enum):
-    '''Enumeration of values used to set position (e.g. of video title).
-    '''
-    _enum_names_ = {
-        -1: 'disable',
-        0: 'center',
-        1: 'left',
-        2: 'right',
-        3: 'top',
-        4: 'left',
-        5: 'right',
-        6: 'bottom',
-        7: 'left',
-        8: 'right',
-    }
-Position.bottom  = Position(6)
-Position.center  = Position(0)
-Position.disable = Position(-1)
-Position.left    = Position(1)
-Position.left    = Position(4)
-Position.left    = Position(7)
-Position.right   = Position(2)
-Position.right   = Position(5)
-Position.right   = Position(8)
-Position.top     = Position(3)
-
-
    [docs]class VideoLogoOption(_Enum):
-    '''Option values for libvlc_video_{get,set}_logo_{int,string}.
-    '''
-    _enum_names_ = {
-        0: 'enable',
-        1: 'file',
-        2: 'logo_x',
-        3: 'logo_y',
-        4: 'delay',
-        5: 'repeat',
-        6: 'opacity',
-        7: 'position',
-    }
    
-VideoLogoOption.delay    = VideoLogoOption(4)
-VideoLogoOption.enable   = VideoLogoOption(0)
-VideoLogoOption.file     = VideoLogoOption(1)
-VideoLogoOption.logo_x   = VideoLogoOption(2)
-VideoLogoOption.logo_y   = VideoLogoOption(3)
-VideoLogoOption.opacity  = VideoLogoOption(6)
-VideoLogoOption.position = VideoLogoOption(7)
-VideoLogoOption.repeat   = VideoLogoOption(5)
-
-
    [docs]class VideoAdjustOption(_Enum):
-    '''Option values for libvlc_video_{get,set}_adjust_{int,float,bool}.
-    '''
-    _enum_names_ = {
-        0: 'Enable',
-        1: 'Contrast',
-        2: 'Brightness',
-        3: 'Hue',
-        4: 'Saturation',
-        5: 'Gamma',
-    }
    
-VideoAdjustOption.Brightness = VideoAdjustOption(2)
-VideoAdjustOption.Contrast   = VideoAdjustOption(1)
-VideoAdjustOption.Enable     = VideoAdjustOption(0)
-VideoAdjustOption.Gamma      = VideoAdjustOption(5)
-VideoAdjustOption.Hue        = VideoAdjustOption(3)
-VideoAdjustOption.Saturation = VideoAdjustOption(4)
-
-
    [docs]class AudioOutputDeviceTypes(_Enum):
-    '''Audio device types.
-    '''
-    _enum_names_ = {
-        -1: 'Error',
-        1: 'Mono',
-        2: 'Stereo',
-        4: '_2F2R',
-        5: '_3F2R',
-        6: '_5_1',
-        7: '_6_1',
-        8: '_7_1',
-        10: 'SPDIF',
-    }
    
-AudioOutputDeviceTypes.Error  = AudioOutputDeviceTypes(-1)
-AudioOutputDeviceTypes.Mono   = AudioOutputDeviceTypes(1)
-AudioOutputDeviceTypes.SPDIF  = AudioOutputDeviceTypes(10)
-AudioOutputDeviceTypes.Stereo = AudioOutputDeviceTypes(2)
-AudioOutputDeviceTypes._2F2R  = AudioOutputDeviceTypes(4)
-AudioOutputDeviceTypes._3F2R  = AudioOutputDeviceTypes(5)
-AudioOutputDeviceTypes._5_1   = AudioOutputDeviceTypes(6)
-AudioOutputDeviceTypes._6_1   = AudioOutputDeviceTypes(7)
-AudioOutputDeviceTypes._7_1   = AudioOutputDeviceTypes(8)
-
-
    [docs]class AudioOutputChannel(_Enum):
-    '''Audio channels.
-    '''
-    _enum_names_ = {
-        -1: 'Error',
-        1: 'Stereo',
-        2: 'RStereo',
-        3: 'Left',
-        4: 'Right',
-        5: 'Dolbys',
-    }
    
-AudioOutputChannel.Dolbys  = AudioOutputChannel(5)
-AudioOutputChannel.Error   = AudioOutputChannel(-1)
-AudioOutputChannel.Left    = AudioOutputChannel(3)
-AudioOutputChannel.RStereo = AudioOutputChannel(2)
-AudioOutputChannel.Right   = AudioOutputChannel(4)
-AudioOutputChannel.Stereo  = AudioOutputChannel(1)
-
-
    [docs]class PlaybackMode(_Enum):
-    '''Defines playback modes for playlist.
-    '''
-    _enum_names_ = {
-        0: 'default',
-        1: 'loop',
-        2: 'repeat',
-    }
    
-PlaybackMode.default = PlaybackMode(0)
-PlaybackMode.loop    = PlaybackMode(1)
-PlaybackMode.repeat  = PlaybackMode(2)
-
-
    [docs]class Callback(ctypes.c_void_p):
-    """Callback function notification.
-    @param p_event: the event triggering the callback.
-    """
-    pass
    
-
    [docs]class LogCb(ctypes.c_void_p):
-    """Callback prototype for LibVLC log message handler.
-    @param data: data pointer as given to L{libvlc_log_set}().
-    @param level: message level (@ref enum libvlc_log_level).
-    @param ctx: message context (meta-information about the message).
-    @param fmt: printf() format string (as defined by ISO C11).
-    @param args: variable argument list for the format @note Log message handlers B{must} be thread-safe. @warning The message context pointer, the format string parameters and the variable arguments are only valid until the callback returns.
-    """
-    pass
    
-
    [docs]class VideoLockCb(ctypes.c_void_p):
-    """Callback prototype to allocate and lock a picture buffer.
-    Whenever a new video frame needs to be decoded, the lock callback is
-    invoked. Depending on the video chroma, one or three pixel planes of
-    adequate dimensions must be returned via the second parameter. Those
-    planes must be aligned on 32-bytes boundaries.
-    @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() [IN].
-    @param planes: start address of the pixel planes (LibVLC allocates the array of void pointers, this callback must initialize the array) [OUT].
-    @return: a private pointer for the display and unlock callbacks to identify the picture buffers.
-    """
-    pass
    
-
    [docs]class VideoUnlockCb(ctypes.c_void_p):
-    """Callback prototype to unlock a picture buffer.
-    When the video frame decoding is complete, the unlock callback is invoked.
-    This callback might not be needed at all. It is only an indication that the
-    application can now read the pixel values if it needs to.
-    @warning: A picture buffer is unlocked after the picture is decoded,
-    but before the picture is displayed.
-    @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() [IN].
-    @param picture: private pointer returned from the @ref libvlc_video_lock_cb callback [IN].
-    @param planes: pixel planes as defined by the @ref libvlc_video_lock_cb callback (this parameter is only for convenience) [IN].
-    """
-    pass
    
-
    [docs]class VideoDisplayCb(ctypes.c_void_p):
-    """Callback prototype to display a picture.
-    When the video frame needs to be shown, as determined by the media playback
-    clock, the display callback is invoked.
-    @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() [IN].
-    @param picture: private pointer returned from the @ref libvlc_video_lock_cb callback [IN].
-    """
-    pass
    
-
    [docs]class VideoFormatCb(ctypes.c_void_p):
-    """Callback prototype to configure picture buffers format.
-    This callback gets the format of the video as output by the video decoder
-    and the chain of video filters (if any). It can opt to change any parameter
-    as it needs. In that case, LibVLC will attempt to convert the video format
-    (rescaling and chroma conversion) but these operations can be CPU intensive.
-    @param opaque: pointer to the private pointer passed to L{libvlc_video_set_callbacks}() [IN/OUT].
-    @param chroma: pointer to the 4 bytes video format identifier [IN/OUT].
-    @param width: pointer to the pixel width [IN/OUT].
-    @param height: pointer to the pixel height [IN/OUT].
-    @param pitches: table of scanline pitches in bytes for each pixel plane (the table is allocated by LibVLC) [OUT].
-    @return: lines table of scanlines count for each plane.
-    """
-    pass
    
-
    [docs]class VideoCleanupCb(ctypes.c_void_p):
-    """Callback prototype to configure picture buffers format.
-    @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() (and possibly modified by @ref libvlc_video_format_cb) [IN].
-    """
-    pass
    
-
    [docs]class AudioPlayCb(ctypes.c_void_p):
-    """Callback prototype for audio playback.
-    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    @param samples: pointer to the first audio sample to play back [IN].
-    @param count: number of audio samples to play back.
-    @param pts: expected play time stamp (see libvlc_delay()).
-    """
-    pass
    
-
    [docs]class AudioPauseCb(ctypes.c_void_p):
-    """Callback prototype for audio pause.
-    @note: The pause callback is never called if the audio is already paused.
-    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    @param pts: time stamp of the pause request (should be elapsed already).
-    """
-    pass
    
-
    [docs]class AudioResumeCb(ctypes.c_void_p):
-    """Callback prototype for audio resumption (i.e. restart from pause).
-    @note: The resume callback is never called if the audio is not paused.
-    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    @param pts: time stamp of the resumption request (should be elapsed already).
-    """
-    pass
    
-
    [docs]class AudioFlushCb(ctypes.c_void_p):
-    """Callback prototype for audio buffer flush
-    (i.e. discard all pending buffers and stop playback as soon as possible).
-    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    """
-    pass
    
-
    [docs]class AudioDrainCb(ctypes.c_void_p):
-    """Callback prototype for audio buffer drain
-    (i.e. wait for pending buffers to be played).
-    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    """
-    pass
    
-
    [docs]class AudioSetVolumeCb(ctypes.c_void_p):
-    """Callback prototype for audio volume change.
-    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    @param volume: software volume (1. = nominal, 0. = mute).
-    @param mute: muted flag.
-    """
-    pass
    
-
    [docs]class AudioSetupCb(ctypes.c_void_p):
-    """Callback prototype to setup the audio playback.
-    This is called when the media player needs to create a new audio output.
-    @param opaque: pointer to the data pointer passed to L{libvlc_audio_set_callbacks}() [IN/OUT].
-    @param format: 4 bytes sample format [IN/OUT].
-    @param rate: sample rate [IN/OUT].
-    @param channels: channels count [IN/OUT].
-    @return: 0 on success, anything else to skip audio playback.
-    """
-    pass
    
-
    [docs]class AudioCleanupCb(ctypes.c_void_p):
-    """Callback prototype for audio playback cleanup.
-    This is called when the media player no longer needs an audio output.
-    @param opaque: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    """
-    pass
    
-
    [docs]class CallbackDecorators(object):
-    "Class holding various method decorators for callback functions."
-    Callback = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_void_p)
-    Callback.__doc__ = '''Callback function notification.
-        @param p_event: the event triggering the callback.
-    ''' 
-    LogCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_int, Log_ptr, ctypes.c_char_p, ctypes.c_void_p)
-    LogCb.__doc__ = '''Callback prototype for LibVLC log message handler.
-        @param data: data pointer as given to L{libvlc_log_set}().
-        @param level: message level (@ref enum libvlc_log_level).
-        @param ctx: message context (meta-information about the message).
-        @param fmt: printf() format string (as defined by ISO C11).
-        @param args: variable argument list for the format @note Log message handlers B{must} be thread-safe. @warning The message context pointer, the format string parameters and the variable arguments are only valid until the callback returns.
-    ''' 
-    VideoLockCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.POINTER(ctypes.c_void_p))
-    VideoLockCb.__doc__ = '''Callback prototype to allocate and lock a picture buffer.
-        Whenever a new video frame needs to be decoded, the lock callback is
-        invoked. Depending on the video chroma, one or three pixel planes of
-        adequate dimensions must be returned via the second parameter. Those
-        planes must be aligned on 32-bytes boundaries.
-        @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() [IN].
-        @param planes: start address of the pixel planes (LibVLC allocates the array of void pointers, this callback must initialize the array) [OUT].
-        @return: a private pointer for the display and unlock callbacks to identify the picture buffers.
-    ''' 
-    VideoUnlockCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_void_p, ctypes.POINTER(ctypes.c_void_p))
-    VideoUnlockCb.__doc__ = '''Callback prototype to unlock a picture buffer.
-        When the video frame decoding is complete, the unlock callback is invoked.
-        This callback might not be needed at all. It is only an indication that the
-        application can now read the pixel values if it needs to.
-        @warning: A picture buffer is unlocked after the picture is decoded,
-        but before the picture is displayed.
-        @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() [IN].
-        @param picture: private pointer returned from the @ref libvlc_video_lock_cb callback [IN].
-        @param planes: pixel planes as defined by the @ref libvlc_video_lock_cb callback (this parameter is only for convenience) [IN].
-    ''' 
-    VideoDisplayCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_void_p)
-    VideoDisplayCb.__doc__ = '''Callback prototype to display a picture.
-        When the video frame needs to be shown, as determined by the media playback
-        clock, the display callback is invoked.
-        @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() [IN].
-        @param picture: private pointer returned from the @ref libvlc_video_lock_cb callback [IN].
-    ''' 
-    VideoFormatCb = ctypes.CFUNCTYPE(ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_void_p), ctypes.c_char_p, ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint))
-    VideoFormatCb.__doc__ = '''Callback prototype to configure picture buffers format.
-        This callback gets the format of the video as output by the video decoder
-        and the chain of video filters (if any). It can opt to change any parameter
-        as it needs. In that case, LibVLC will attempt to convert the video format
-        (rescaling and chroma conversion) but these operations can be CPU intensive.
-        @param opaque: pointer to the private pointer passed to L{libvlc_video_set_callbacks}() [IN/OUT].
-        @param chroma: pointer to the 4 bytes video format identifier [IN/OUT].
-        @param width: pointer to the pixel width [IN/OUT].
-        @param height: pointer to the pixel height [IN/OUT].
-        @param pitches: table of scanline pitches in bytes for each pixel plane (the table is allocated by LibVLC) [OUT].
-        @return: lines table of scanlines count for each plane.
-    ''' 
-    VideoCleanupCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p)
-    VideoCleanupCb.__doc__ = '''Callback prototype to configure picture buffers format.
-        @param opaque: private pointer as passed to L{libvlc_video_set_callbacks}() (and possibly modified by @ref libvlc_video_format_cb) [IN].
-    ''' 
-    AudioPlayCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_void_p, ctypes.c_uint, ctypes.c_int64)
-    AudioPlayCb.__doc__ = '''Callback prototype for audio playback.
-        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-        @param samples: pointer to the first audio sample to play back [IN].
-        @param count: number of audio samples to play back.
-        @param pts: expected play time stamp (see libvlc_delay()).
-    ''' 
-    AudioPauseCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_int64)
-    AudioPauseCb.__doc__ = '''Callback prototype for audio pause.
-        @note: The pause callback is never called if the audio is already paused.
-        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-        @param pts: time stamp of the pause request (should be elapsed already).
-    ''' 
-    AudioResumeCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_int64)
-    AudioResumeCb.__doc__ = '''Callback prototype for audio resumption (i.e. restart from pause).
-        @note: The resume callback is never called if the audio is not paused.
-        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-        @param pts: time stamp of the resumption request (should be elapsed already).
-    ''' 
-    AudioFlushCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_int64)
-    AudioFlushCb.__doc__ = '''Callback prototype for audio buffer flush
-        (i.e. discard all pending buffers and stop playback as soon as possible).
-        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    ''' 
-    AudioDrainCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p)
-    AudioDrainCb.__doc__ = '''Callback prototype for audio buffer drain
-        (i.e. wait for pending buffers to be played).
-        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    ''' 
-    AudioSetVolumeCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_float, ctypes.c_bool)
-    AudioSetVolumeCb.__doc__ = '''Callback prototype for audio volume change.
-        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-        @param volume: software volume (1. = nominal, 0. = mute).
-        @param mute: muted flag.
-    ''' 
-    AudioSetupCb = ctypes.CFUNCTYPE(ctypes.POINTER(ctypes.c_int), ctypes.POINTER(ctypes.c_void_p), ctypes.c_char_p, ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint))
-    AudioSetupCb.__doc__ = '''Callback prototype to setup the audio playback.
-        This is called when the media player needs to create a new audio output.
-        @param opaque: pointer to the data pointer passed to L{libvlc_audio_set_callbacks}() [IN/OUT].
-        @param format: 4 bytes sample format [IN/OUT].
-        @param rate: sample rate [IN/OUT].
-        @param channels: channels count [IN/OUT].
-        @return: 0 on success, anything else to skip audio playback.
-    ''' 
-    AudioCleanupCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p)
-    AudioCleanupCb.__doc__ = '''Callback prototype for audio playback cleanup.
-        This is called when the media player no longer needs an audio output.
-        @param opaque: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
-    ''' 
    
-cb = CallbackDecorators
- # End of generated enum types #
-
- # From libvlc_structures.h
-
-
    [docs]class AudioOutput(_Cstruct):
-
-    def __str__(self):
-        return '%s(%s:%s)' % (self.__class__.__name__, self.name, self.description)
    
-
-AudioOutput._fields_ = [  # recursive struct
-    ('name',        ctypes.c_char_p),
-    ('description', ctypes.c_char_p),
-    ('next',        ctypes.POINTER(AudioOutput)),
-    ]
-
-
    [docs]class LogMessage(_Cstruct):
-    _fields_ = [
-        ('size',     ctypes.c_uint  ),
-        ('severity', ctypes.c_int   ),
-        ('type',     ctypes.c_char_p),
-        ('name',     ctypes.c_char_p),
-        ('header',   ctypes.c_char_p),
-        ('message',  ctypes.c_char_p),
-    ]
-
-    def __init__(self):
-        super(LogMessage, self).__init__()
-        self.size = ctypes.sizeof(self)
-
-    def __str__(self):
-        return '%s(%d:%s): %s' % (self.__class__.__name__, self.severity, self.type, self.message)
    
-
-
    [docs]class MediaEvent(_Cstruct):
-    _fields_ = [
-        ('media_name',    ctypes.c_char_p),
-        ('instance_name', ctypes.c_char_p),
-    ]
    
-
-
    [docs]class MediaStats(_Cstruct):
-    _fields_ = [
-        ('read_bytes',          ctypes.c_int  ),
-        ('input_bitrate',       ctypes.c_float),
-        ('demux_read_bytes',    ctypes.c_int  ),
-        ('demux_bitrate',       ctypes.c_float),
-        ('demux_corrupted',     ctypes.c_int  ),
-        ('demux_discontinuity', ctypes.c_int  ),
-        ('decoded_video',       ctypes.c_int  ),
-        ('decoded_audio',       ctypes.c_int  ),
-        ('displayed_pictures',  ctypes.c_int  ),
-        ('lost_pictures',       ctypes.c_int  ),
-        ('played_abuffers',     ctypes.c_int  ),
-        ('lost_abuffers',       ctypes.c_int  ),
-        ('sent_packets',        ctypes.c_int  ),
-        ('sent_bytes',          ctypes.c_int  ),
-        ('send_bitrate',        ctypes.c_float),
-    ]
    
-
-
    [docs]class MediaTrackInfo(_Cstruct):
-    _fields_ = [
-        ('codec',              ctypes.c_uint32),
-        ('id',                 ctypes.c_int   ),
-        ('type',               TrackType      ),
-        ('profile',            ctypes.c_int   ),
-        ('level',              ctypes.c_int   ),
-        ('channels_or_height', ctypes.c_uint  ),
-        ('rate_or_width',      ctypes.c_uint  ),
-    ]
    
-
-
    [docs]class AudioTrack(_Cstruct):
-    _fields_ = [
-        ('channels', ctypes.c_uint),
-        ('rate', ctypes.c_uint),
-        ]
    
-
-
    [docs]class VideoTrack(_Cstruct):
-    _fields_ = [
-        ('height', ctypes.c_uint),
-        ('width', ctypes.c_uint),
-        ('sar_num', ctypes.c_uint),
-        ('sar_den', ctypes.c_uint),
-        ('frame_rate_num', ctypes.c_uint),
-        ('frame_rate_den', ctypes.c_uint),
-        ]
    
-
-
    [docs]class SubtitleTrack(_Cstruct):
-    _fields_ = [
-        ('encoding', ctypes.c_char_p),
-        ]
    
-
-
    [docs]class MediaTrackTracks(ctypes.Union):
-    _fields_ = [
-        ('audio', ctypes.POINTER(AudioTrack)),
-        ('video', ctypes.POINTER(VideoTrack)),
-        ('subtitle', ctypes.POINTER(SubtitleTrack)),
-        ]
    
-
-
    [docs]class MediaTrack(_Cstruct):
-    _anonymous_ = ("u",)
-    _fields_ = [
-        ('codec',              ctypes.c_uint32),
-        ('original_fourcc',    ctypes.c_uint32),
-        ('id',                 ctypes.c_int   ),
-        ('type',               TrackType      ),
-        ('profile',            ctypes.c_int   ),
-        ('level',              ctypes.c_int   ),
-
-        ('u',                  MediaTrackTracks),
-        ('bitrate',            ctypes.c_uint),
-        ('language',           ctypes.c_char_p),
-        ('description',        ctypes.c_char_p),
-        ]
    
-
-
    [docs]class PlaylistItem(_Cstruct):
-    _fields_ = [
-        ('id',   ctypes.c_int   ),
-        ('uri',  ctypes.c_char_p),
-        ('name', ctypes.c_char_p),
-    ]
-
-    def __str__(self):
-        return '%s #%d %s (uri %s)' % (self.__class__.__name__, self.id, self.name, self.uri)
    
-
-
    [docs]class Position(object):
-    """Enum-like, immutable window position constants.
-
-       See e.g. VideoMarqueeOption.Position.
-    """
-    Center       = 0
-    Left         = 1
-    CenterLeft   = 1
-    Right        = 2
-    CenterRight  = 2
-    Top          = 4
-    TopCenter    = 4
-    TopLeft      = 5
-    TopRight     = 6
-    Bottom       = 8
-    BottomCenter = 8
-    BottomLeft   = 9
-    BottomRight  = 10
-    def __init__(self, *unused):
-        raise TypeError('constants only')
-    def __setattr__(self, *unused):  #PYCHOK expected
-        raise TypeError('immutable constants')
    
-
-
    [docs]class Rectangle(_Cstruct):
-    _fields_ = [
-        ('top',    ctypes.c_int),
-        ('left',   ctypes.c_int),
-        ('bottom', ctypes.c_int),
-        ('right',  ctypes.c_int),
-    ]
    
-
-
    [docs]class TrackDescription(_Cstruct):
-
-    def __str__(self):
-        return '%s(%d:%s)' % (self.__class__.__name__, self.id, self.name)
    
-
-TrackDescription._fields_ = [  # recursive struct
-    ('id',   ctypes.c_int   ),
-    ('name', ctypes.c_char_p),
-    ('next', ctypes.POINTER(TrackDescription)),
-    ]
-
-
    [docs]def track_description_list(head):
-    """Convert a TrackDescription linked list to a Python list (and release the former).
-    """
-    r = []
-    if head:
-        item = head
-        while item:
-            item = item.contents
-            r.append((item.id, item.name))
-            item = item.next
-        try:
-            libvlc_track_description_release(head)
-        except NameError:
-            libvlc_track_description_list_release(head)
-
-    return r
    
-
-
    [docs]class EventUnion(ctypes.Union):
-    _fields_ = [
-        ('meta_type',    ctypes.c_uint    ),
-        ('new_child',    ctypes.c_uint    ),
-        ('new_duration', ctypes.c_longlong),
-        ('new_status',   ctypes.c_int     ),
-        ('media',        ctypes.c_void_p  ),
-        ('new_state',    ctypes.c_uint    ),
-        # FIXME: Media instance
-        ('new_cache', ctypes.c_float   ),
-        ('new_position', ctypes.c_float   ),
-        ('new_time',     ctypes.c_longlong),
-        ('new_title',    ctypes.c_int     ),
-        ('new_seekable', ctypes.c_longlong),
-        ('new_pausable', ctypes.c_longlong),
-        ('new_scrambled', ctypes.c_longlong),
-        ('new_count', ctypes.c_longlong),
-        # FIXME: Skipped MediaList and MediaListView...
-        ('filename',     ctypes.c_char_p  ),
-        ('new_length',   ctypes.c_longlong),
-        ('media_event',  MediaEvent       ),
-    ]
    
-
-
    [docs]class Event(_Cstruct):
-    _fields_ = [
-        ('type',   EventType      ),
-        ('object', ctypes.c_void_p),
-        ('u',      EventUnion     ),
-    ]
    
-
-
    [docs]class ModuleDescription(_Cstruct):
-
-    def __str__(self):
-        return '%s %s (%s)' % (self.__class__.__name__, self.shortname, self.name)
    
-
-ModuleDescription._fields_ = [  # recursive struct
-    ('name',      ctypes.c_char_p),
-    ('shortname', ctypes.c_char_p),
-    ('longname',  ctypes.c_char_p),
-    ('help',      ctypes.c_char_p),
-    ('next',      ctypes.POINTER(ModuleDescription)),
-    ]
-
-
    [docs]def module_description_list(head):
-    """Convert a ModuleDescription linked list to a Python list (and release the former).
-    """
-    r = []
-    if head:
-        item = head
-        while item:
-            item = item.contents
-            r.append((item.name, item.shortname, item.longname, item.help))
-            item = item.next
-        libvlc_module_description_list_release(head)
-    return r
    
-
-
    [docs]class AudioOutputDevice(_Cstruct):
-
-    def __str__(self):
-        return '%s(%d:%s)' % (self.__class__.__name__, self.id, self.name)
    
-
-AudioOutputDevice._fields_ = [  # recursive struct
-    ('next', ctypes.POINTER(AudioOutputDevice)),
-    ('device',   ctypes.c_char_p   ),
-    ('description', ctypes.c_char_p),
-    ]
-
-
    [docs]class TitleDescription(_Cstruct):
-    _fields = [
-        ('duration', ctypes.c_longlong),
-        ('name', ctypes.c_char_p),
-        ('menu', ctypes.c_bool),
-    ]
    
-
-
    [docs]class ChapterDescription(_Cstruct):
-    _fields = [
-        ('time_offset', ctypes.c_longlong),
-        ('duration', ctypes.c_longlong),
-        ('name', ctypes.c_char_p),
-    ]
    
-
-
    [docs]class VideoViewpoint(_Cstruct):
-    _fields = [
-        ('yaw', ctypes.c_float),
-        ('pitch', ctypes.c_float),
-        ('roll', ctypes.c_float),
-        ('field_of_view', ctypes.c_float),
-    ]
    
-
-# This struct depends on the MediaSlaveType enum that is defined only
-# in > 2.2
-if 'MediaSlaveType' in locals():
-    class MediaSlave(_Cstruct):
-        _fields = [
-            ('psz_uri', ctypes.c_char_p),
-            ('i_type', MediaSlaveType),
-            ('i_priority', ctypes.c_uint)
-        ]
-
-
    [docs]class RDDescription(_Cstruct):
-    _fields = [
-        ('name', ctypes.c_char_p),
-        ('longname', ctypes.c_char_p)
-    ]
    
-
-# End of header.py #
-
    [docs]class EventManager(_Ctype):
-    '''Create an event manager with callback handler.
-
-    This class interposes the registration and handling of
-    event notifications in order to (a) remove the need for
-    decorating each callback functions with the decorator
-    '@callbackmethod', (b) allow any number of positional
-    and/or keyword arguments to the callback (in addition
-    to the Event instance) and (c) to preserve the Python
-    objects such that the callback and argument objects
-    remain alive (i.e. are not garbage collected) until
-    B{after} the notification has been unregistered.
-
-    @note: Only a single notification can be registered
-    for each event type in an EventManager instance.
-    
-    '''
-
-    _callback_handler = None
-    _callbacks = {}
-
-    def __new__(cls, ptr=_internal_guard):
-        if ptr == _internal_guard:
-            raise VLCException("(INTERNAL) ctypes class.\nYou should get a reference to EventManager through the MediaPlayer.event_manager() method.")
-        return _Constructor(cls, ptr)
-
-
    [docs]    def event_attach(self, eventtype, callback, *args, **kwds):
-        """Register an event notification.
-
-        @param eventtype: the desired event type to be notified about.
-        @param callback: the function to call when the event occurs.
-        @param args: optional positional arguments for the callback.
-        @param kwds: optional keyword arguments for the callback.
-        @return: 0 on success, ENOMEM on error.
-
-        @note: The callback function must have at least one argument,
-        an Event instance.  Any other, optional positional and keyword
-        arguments are in B{addition} to the first one.
-        """
-        if not isinstance(eventtype, EventType):
-            raise VLCException("%s required: %r" % ('EventType', eventtype))
-        if not hasattr(callback, '__call__'):  # callable()
-            raise VLCException("%s required: %r" % ('callable', callback))
-         # check that the callback expects arguments
-        if not any(getargspec(callback)[:2]):  # list(...)
-            raise VLCException("%s required: %r" % ('argument', callback))
-
-        if self._callback_handler is None:
-            _called_from_ctypes = ctypes.CFUNCTYPE(None, ctypes.POINTER(Event), ctypes.c_void_p)
-            @_called_from_ctypes
-            def _callback_handler(event, k):
-                """(INTERNAL) handle callback call from ctypes.
-
-                @note: We cannot simply make this an EventManager
-                method since ctypes does not prepend self as the
-                first parameter, hence this closure.
-                """
-                try: # retrieve Python callback and arguments
-                    call, args, kwds = self._callbacks[k]
-                     # deref event.contents to simplify callback code
-                    call(event.contents, *args, **kwds)
-                except KeyError:  # detached?
-                    pass
-            self._callback_handler = _callback_handler
-            self._callbacks = {}
-
-        k = eventtype.value
-        r = libvlc_event_attach(self, k, self._callback_handler, k)
-        if not r:
-            self._callbacks[k] = (callback, args, kwds)
-        return r
    
-
-
    [docs]    def event_detach(self, eventtype):
-        """Unregister an event notification.
-
-        @param eventtype: the event type notification to be removed.
-        """
-        if not isinstance(eventtype, EventType):
-            raise VLCException("%s required: %r" % ('EventType', eventtype))
-
-        k = eventtype.value
-        if k in self._callbacks:
-            del self._callbacks[k] # remove, regardless of libvlc return value
-            libvlc_event_detach(self, k, self._callback_handler, k)
    
-
-
    [docs]class Instance(_Ctype):
-    '''Create a new Instance instance.
-
-    It may take as parameter either:
-      - a string
-      - a list of strings as first parameters
-      - the parameters given as the constructor parameters (must be strings)
-    
-    '''
-
-    def __new__(cls, *args):
-        if len(args) == 1:
-            # Only 1 arg. It is either a C pointer, or an arg string,
-            # or a tuple.
-            i = args[0]
-            if isinstance(i, _Ints):
-                return _Constructor(cls, i)
-            elif isinstance(i, basestring):
-                args = i.strip().split()
-            elif isinstance(i, _Seqs):
-                args = list(i)
-            else:
-                raise VLCException('Instance %r' % (args,))
-        else:
-            args = list(args)
-
-        if not args:  # no parameters passed
-            args = ['vlc']
-        elif args[0] != 'vlc':
-            args.insert(0, 'vlc')
-
-        if plugin_path is not None:
-            # set plugin_path if detected, win32 and MacOS,
-            # if the user did not specify it itself.
-            os.environ.setdefault('VLC_PLUGIN_PATH', plugin_path)
-
-        if PYTHON3:
-            args = [ str_to_bytes(a) for a in args ]
-        return libvlc_new(len(args), args)
-
-
    [docs]    def media_player_new(self, uri=None):
-        """Create a new MediaPlayer instance.
-
-        @param uri: an optional URI to play in the player.
-        """
-        p = libvlc_media_player_new(self)
-        if uri:
-            p.set_media(self.media_new(uri))
-        p._instance = self
-        return p
    
-
-
    [docs]    def media_list_player_new(self):
-        """Create a new MediaListPlayer instance.
-        """
-        p = libvlc_media_list_player_new(self)
-        p._instance = self
-        return p
    
-
-
    [docs]    def media_new(self, mrl, *options):
-        """Create a new Media instance.
-
-        If mrl contains a colon (:) preceded by more than 1 letter, it
-        will be treated as a URL. Else, it will be considered as a
-        local path. If you need more control, directly use
-        media_new_location/media_new_path methods.
-
-        Options can be specified as supplementary string parameters,
-        but note that many options cannot be set at the media level,
-        and rather at the Instance level. For instance, the marquee
-        filter must be specified when creating the vlc.Instance or
-        vlc.MediaPlayer.
-
-        Alternatively, options can be added to the media using the
-        Media.add_options method (with the same limitation).
-
-        @param options: optional media option=value strings
-        """
-        if ':' in mrl and mrl.index(':') > 1:
-            # Assume it is a URL
-            m = libvlc_media_new_location(self, str_to_bytes(mrl))
-        else:
-            # Else it should be a local path.
-            m = libvlc_media_new_path(self, str_to_bytes(os.path.normpath(mrl)))
-        for o in options:
-            libvlc_media_add_option(m, str_to_bytes(o))
-        m._instance = self
-        return m
    
-
-
    [docs]    def media_list_new(self, mrls=None):
-        """Create a new MediaList instance.
-        @param mrls: optional list of MRL strings
-        """
-        l = libvlc_media_list_new(self)
-        # We should take the lock, but since we did not leak the
-        # reference, nobody else can access it.
-        if mrls:
-            for m in mrls:
-                l.add_media(m)
-        l._instance = self
-        return l
    
-
-
    [docs]    def audio_output_enumerate_devices(self):
-        """Enumerate the defined audio output devices.
-
-        @return: list of dicts {name:, description:, devices:}
-        """
-        r = []
-        head = libvlc_audio_output_list_get(self)
-        if head:
-            i = head
-            while i:
-                i = i.contents
-                d = [{'id':       libvlc_audio_output_device_id      (self, i.name, d),
-                      'longname': libvlc_audio_output_device_longname(self, i.name, d)}
-                   for d in range(libvlc_audio_output_device_count   (self, i.name))]
-                r.append({'name': i.name, 'description': i.description, 'devices': d})
-                i = i.next
-            libvlc_audio_output_list_release(head)
-        return r
    
-
-
    [docs]    def audio_filter_list_get(self):
-        """Returns a list of available audio filters.
-
-        """
-        return module_description_list(libvlc_audio_filter_list_get(self))
    
-
-
    [docs]    def video_filter_list_get(self):
-        """Returns a list of available video filters.
-
-        """
-        return module_description_list(libvlc_video_filter_list_get(self))
    
-
-
-    
-
    [docs]    def release(self):
-        '''Decrement the reference count of a libvlc instance, and destroy it
-        if it reaches zero.
-        '''
-        return libvlc_release(self)
    
-
-    
-
    [docs]    def retain(self):
-        '''Increments the reference count of a libvlc instance.
-        The initial reference count is 1 after L{new}() returns.
-        '''
-        return libvlc_retain(self)
    
-
-    
-
    [docs]    def add_intf(self, name):
-        '''Try to start a user interface for the libvlc instance.
-        @param name: interface name, or None for default.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_add_intf(self, str_to_bytes(name))
    
-
-    
-
    [docs]    def wait(self):
-        '''Waits until an interface causes the instance to exit.
-        You should start at least one interface first, using L{add_intf}().
-        '''
-        return libvlc_wait(self)
    
-
-    
-
    [docs]    def set_user_agent(self, name, http):
-        '''Sets the application name. LibVLC passes this as the user agent string
-        when a protocol requires it.
-        @param name: human-readable application name, e.g. "FooBar player 1.2.3".
-        @param http: HTTP User Agent, e.g. "FooBar/1.2.3 Python/2.6.0".
-        @version: LibVLC 1.1.1 or later.
-        '''
-        return libvlc_set_user_agent(self, str_to_bytes(name), str_to_bytes(http))
    
-
-    
-
    [docs]    def set_app_id(self, id, version, icon):
-        '''Sets some meta-information about the application.
-        See also L{set_user_agent}().
-        @param id: Java-style application identifier, e.g. "com.acme.foobar".
-        @param version: application version numbers, e.g. "1.2.3".
-        @param icon: application icon name, e.g. "foobar".
-        @version: LibVLC 2.1.0 or later.
-        '''
-        return libvlc_set_app_id(self, str_to_bytes(id), str_to_bytes(version), str_to_bytes(icon))
    
-
-    
-
    [docs]    def log_unset(self):
-        '''Unsets the logging callback for a LibVLC instance. This is rarely needed:
-        the callback is implicitly unset when the instance is destroyed.
-        This function will wait for any pending callbacks invocation to complete
-        (causing a deadlock if called from within the callback).
-        @version: LibVLC 2.1.0 or later.
-        '''
-        return libvlc_log_unset(self)
    
-
-    
-
    [docs]    def log_set(self, data, p_instance):
-        '''Sets the logging callback for a LibVLC instance.
-        This function is thread-safe: it will wait for any pending callbacks
-        invocation to complete.
-        @param data: opaque data pointer for the callback function @note Some log messages (especially debug) are emitted by LibVLC while is being initialized. These messages cannot be captured with this interface. @warning A deadlock may occur if this function is called from the callback.
-        @param p_instance: libvlc instance.
-        @version: LibVLC 2.1.0 or later.
-        '''
-        return libvlc_log_set(self, data, p_instance)
    
-
-    
-
    [docs]    def log_set_file(self, stream):
-        '''Sets up logging to a file.
-        @param stream: FILE pointer opened for writing (the FILE pointer must remain valid until L{log_unset}()).
-        @version: LibVLC 2.1.0 or later.
-        '''
-        return libvlc_log_set_file(self, stream)
    
-
-    
-
    [docs]    def get_log_verbosity(self):
-        '''Always returns minus one.
-        This function is only provided for backward compatibility.
-        @return: always -1.
-        '''
-        return libvlc_get_log_verbosity(self)
    
-
-    
-
    [docs]    def set_log_verbosity(self, level):
-        '''This function does nothing.
-        It is only provided for backward compatibility.
-        @param level: ignored.
-        '''
-        return libvlc_set_log_verbosity(self, level)
    
-
-    
-
    [docs]    def log_open(self):
-        '''This function does nothing useful.
-        It is only provided for backward compatibility.
-        @return: an unique pointer or None on error.
-        '''
-        return libvlc_log_open(self)
    
-
-    
-
    [docs]    def media_discoverer_new_from_name(self, psz_name):
-        '''Discover media service by name.
-        @param psz_name: service name.
-        @return: media discover object or None in case of error.
-        '''
-        return libvlc_media_discoverer_new_from_name(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def media_library_new(self):
-        '''Create an new Media Library object.
-        @return: a new object or None on error.
-        '''
-        return libvlc_media_library_new(self)
    
-
-    
-
    [docs]    def vlm_release(self):
-        '''Release the vlm instance related to the given L{Instance}.
-        '''
-        return libvlc_vlm_release(self)
    
-
-    
-
    [docs]    def vlm_add_broadcast(self, psz_name, psz_input, psz_output, i_options, ppsz_options, b_enabled, b_loop):
-        '''Add a broadcast, with one input.
-        @param psz_name: the name of the new broadcast.
-        @param psz_input: the input MRL.
-        @param psz_output: the output MRL (the parameter to the "sout" variable).
-        @param i_options: number of additional options.
-        @param ppsz_options: additional options.
-        @param b_enabled: boolean for enabling the new broadcast.
-        @param b_loop: Should this broadcast be played in loop ?
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_add_broadcast(self, str_to_bytes(psz_name), str_to_bytes(psz_input), str_to_bytes(psz_output), i_options, ppsz_options, b_enabled, b_loop)
    
-
-    
-
    [docs]    def vlm_add_vod(self, psz_name, psz_input, i_options, ppsz_options, b_enabled, psz_mux):
-        '''Add a vod, with one input.
-        @param psz_name: the name of the new vod media.
-        @param psz_input: the input MRL.
-        @param i_options: number of additional options.
-        @param ppsz_options: additional options.
-        @param b_enabled: boolean for enabling the new vod.
-        @param psz_mux: the muxer of the vod media.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_add_vod(self, str_to_bytes(psz_name), str_to_bytes(psz_input), i_options, ppsz_options, b_enabled, str_to_bytes(psz_mux))
    
-
-    
-
    [docs]    def vlm_del_media(self, psz_name):
-        '''Delete a media (VOD or broadcast).
-        @param psz_name: the media to delete.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_del_media(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def vlm_set_enabled(self, psz_name, b_enabled):
-        '''Enable or disable a media (VOD or broadcast).
-        @param psz_name: the media to work on.
-        @param b_enabled: the new status.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_set_enabled(self, str_to_bytes(psz_name), b_enabled)
    
-
-    
-
    [docs]    def vlm_set_output(self, psz_name, psz_output):
-        '''Set the output for a media.
-        @param psz_name: the media to work on.
-        @param psz_output: the output MRL (the parameter to the "sout" variable).
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_set_output(self, str_to_bytes(psz_name), str_to_bytes(psz_output))
    
-
-    
-
    [docs]    def vlm_set_input(self, psz_name, psz_input):
-        '''Set a media's input MRL. This will delete all existing inputs and
-        add the specified one.
-        @param psz_name: the media to work on.
-        @param psz_input: the input MRL.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_set_input(self, str_to_bytes(psz_name), str_to_bytes(psz_input))
    
-
-    
-
    [docs]    def vlm_add_input(self, psz_name, psz_input):
-        '''Add a media's input MRL. This will add the specified one.
-        @param psz_name: the media to work on.
-        @param psz_input: the input MRL.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_add_input(self, str_to_bytes(psz_name), str_to_bytes(psz_input))
    
-
-    
-
    [docs]    def vlm_set_loop(self, psz_name, b_loop):
-        '''Set a media's loop status.
-        @param psz_name: the media to work on.
-        @param b_loop: the new status.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_set_loop(self, str_to_bytes(psz_name), b_loop)
    
-
-    
-
    [docs]    def vlm_set_mux(self, psz_name, psz_mux):
-        '''Set a media's vod muxer.
-        @param psz_name: the media to work on.
-        @param psz_mux: the new muxer.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_set_mux(self, str_to_bytes(psz_name), str_to_bytes(psz_mux))
    
-
-    
-
    [docs]    def vlm_change_media(self, psz_name, psz_input, psz_output, i_options, ppsz_options, b_enabled, b_loop):
-        '''Edit the parameters of a media. This will delete all existing inputs and
-        add the specified one.
-        @param psz_name: the name of the new broadcast.
-        @param psz_input: the input MRL.
-        @param psz_output: the output MRL (the parameter to the "sout" variable).
-        @param i_options: number of additional options.
-        @param ppsz_options: additional options.
-        @param b_enabled: boolean for enabling the new broadcast.
-        @param b_loop: Should this broadcast be played in loop ?
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_change_media(self, str_to_bytes(psz_name), str_to_bytes(psz_input), str_to_bytes(psz_output), i_options, ppsz_options, b_enabled, b_loop)
    
-
-    
-
    [docs]    def vlm_play_media(self, psz_name):
-        '''Play the named broadcast.
-        @param psz_name: the name of the broadcast.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_play_media(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def vlm_stop_media(self, psz_name):
-        '''Stop the named broadcast.
-        @param psz_name: the name of the broadcast.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_stop_media(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def vlm_pause_media(self, psz_name):
-        '''Pause the named broadcast.
-        @param psz_name: the name of the broadcast.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_pause_media(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def vlm_seek_media(self, psz_name, f_percentage):
-        '''Seek in the named broadcast.
-        @param psz_name: the name of the broadcast.
-        @param f_percentage: the percentage to seek to.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_vlm_seek_media(self, str_to_bytes(psz_name), f_percentage)
    
-
-    
-
    [docs]    def vlm_show_media(self, psz_name):
-        '''Return information about the named media as a JSON
-        string representation.
-        This function is mainly intended for debugging use,
-        if you want programmatic access to the state of
-        a vlm_media_instance_t, please use the corresponding
-        libvlc_vlm_get_media_instance_xxx -functions.
-        Currently there are no such functions available for
-        vlm_media_t though.
-        @param psz_name: the name of the media, if the name is an empty string, all media is described.
-        @return: string with information about named media, or None on error.
-        '''
-        return libvlc_vlm_show_media(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def vlm_get_media_instance_position(self, psz_name, i_instance):
-        '''Get vlm_media instance position by name or instance id.
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: position as float or -1. on error.
-        '''
-        return libvlc_vlm_get_media_instance_position(self, str_to_bytes(psz_name), i_instance)
    
-
-    
-
    [docs]    def vlm_get_media_instance_time(self, psz_name, i_instance):
-        '''Get vlm_media instance time by name or instance id.
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: time as integer or -1 on error.
-        '''
-        return libvlc_vlm_get_media_instance_time(self, str_to_bytes(psz_name), i_instance)
    
-
-    
-
    [docs]    def vlm_get_media_instance_length(self, psz_name, i_instance):
-        '''Get vlm_media instance length by name or instance id.
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: length of media item or -1 on error.
-        '''
-        return libvlc_vlm_get_media_instance_length(self, str_to_bytes(psz_name), i_instance)
    
-
-    
-
    [docs]    def vlm_get_media_instance_rate(self, psz_name, i_instance):
-        '''Get vlm_media instance playback rate by name or instance id.
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: playback rate or -1 on error.
-        '''
-        return libvlc_vlm_get_media_instance_rate(self, str_to_bytes(psz_name), i_instance)
    
-
-    
-
    [docs]    def vlm_get_media_instance_title(self, psz_name, i_instance):
-        '''Get vlm_media instance title number by name or instance id.
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: title as number or -1 on error.
-        @bug: will always return 0.
-        '''
-        return libvlc_vlm_get_media_instance_title(self, str_to_bytes(psz_name), i_instance)
    
-
-    
-
    [docs]    def vlm_get_media_instance_chapter(self, psz_name, i_instance):
-        '''Get vlm_media instance chapter number by name or instance id.
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: chapter as number or -1 on error.
-        @bug: will always return 0.
-        '''
-        return libvlc_vlm_get_media_instance_chapter(self, str_to_bytes(psz_name), i_instance)
    
-
-    
-
    [docs]    def vlm_get_media_instance_seekable(self, psz_name, i_instance):
-        '''Is libvlc instance seekable ?
-        @param psz_name: name of vlm media instance.
-        @param i_instance: instance id.
-        @return: 1 if seekable, 0 if not, -1 if media does not exist.
-        @bug: will always return 0.
-        '''
-        return libvlc_vlm_get_media_instance_seekable(self, str_to_bytes(psz_name), i_instance)
    
-
-    @memoize_parameterless
-    def vlm_get_event_manager(self):
-        '''Get libvlc_event_manager from a vlm media.
-        The p_event_manager is immutable, so you don't have to hold the lock.
-        @return: libvlc_event_manager.
-        '''
-        return libvlc_vlm_get_event_manager(self)
-
-    
-
    [docs]    def media_new_location(self, psz_mrl):
-        '''Create a media with a certain given media resource location,
-        for instance a valid URL.
-        @note: To refer to a local file with this function,
-        the file://... URI syntax B{must} be used (see IETF RFC3986).
-        We recommend using L{media_new_path}() instead when dealing with
-        local files.
-        See L{media_release}.
-        @param psz_mrl: the media location.
-        @return: the newly created media or None on error.
-        '''
-        return libvlc_media_new_location(self, str_to_bytes(psz_mrl))
    
-
-    
-
    [docs]    def media_new_path(self, path):
-        '''Create a media for a certain file path.
-        See L{media_release}.
-        @param path: local filesystem path.
-        @return: the newly created media or None on error.
-        '''
-        return libvlc_media_new_path(self, str_to_bytes(path))
    
-
-    
-
    [docs]    def media_new_fd(self, fd):
-        '''Create a media for an already open file descriptor.
-        The file descriptor shall be open for reading (or reading and writing).
-        Regular file descriptors, pipe read descriptors and character device
-        descriptors (including TTYs) are supported on all platforms.
-        Block device descriptors are supported where available.
-        Directory descriptors are supported on systems that provide fdopendir().
-        Sockets are supported on all platforms where they are file descriptors,
-        i.e. all except Windows.
-        @note: This library will B{not} automatically close the file descriptor
-        under any circumstance. Nevertheless, a file descriptor can usually only be
-        rendered once in a media player. To render it a second time, the file
-        descriptor should probably be rewound to the beginning with lseek().
-        See L{media_release}.
-        @param fd: open file descriptor.
-        @return: the newly created media or None on error.
-        @version: LibVLC 1.1.5 and later.
-        '''
-        return libvlc_media_new_fd(self, fd)
    
-
-    
-
    [docs]    def media_new_as_node(self, psz_name):
-        '''Create a media as an empty node with a given name.
-        See L{media_release}.
-        @param psz_name: the name of the node.
-        @return: the new empty media or None on error.
-        '''
-        return libvlc_media_new_as_node(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def playlist_play(self, i_id, i_options, ppsz_options):
-        '''Start playing (if there is any item in the playlist).
-        Additionnal playlist item options can be specified for addition to the
-        item before it is played.
-        @param i_id: the item to play. If this is a negative number, the next item will be selected. Otherwise, the item with the given ID will be played.
-        @param i_options: the number of options to add to the item.
-        @param ppsz_options: the options to add to the item.
-        '''
-        return libvlc_playlist_play(self, i_id, i_options, ppsz_options)
    
-
-    
-
    [docs]    def audio_output_list_get(self):
-        '''Gets the list of available audio output modules.
-        @return: list of available audio outputs. It must be freed it with In case of error, None is returned.
-        '''
-        return libvlc_audio_output_list_get(self)
    
-
-    
-
    [docs]    def audio_output_device_count(self, psz_name):
-        '''Backward compatibility stub. Do not use in new code.
-        Use L{audio_output_device_list_get}() instead.
-        @param psz_name: name.
-        @return: always 0.
-        '''
-        return libvlc_audio_output_device_count(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def audio_output_device_longname(self, psz_name, int):
-        '''Backward compatibility stub. Do not use in new code.
-        Use L{audio_output_device_list_get}() instead.
-        @param psz_name: name.
-        @param int: index.
-        @return: always None.
-        '''
-        return libvlc_audio_output_device_longname(self, str_to_bytes(psz_name), int)
    
-
-    
-
    [docs]    def audio_output_device_id(self, psz_name, int):
-        '''Backward compatibility stub. Do not use in new code.
-        Use L{audio_output_device_list_get}() instead.
-        @param psz_name: name.
-        @param int: index.
-        @return: always None.
-        '''
-        return libvlc_audio_output_device_id(self, str_to_bytes(psz_name), int)
    
-
-    
-
    [docs]    def audio_output_device_list_get(self, aout):
-        '''Gets a list of audio output devices for a given audio output module,
-        See L{audio_output_device_set}().
-        @note: Not all audio outputs support this. In particular, an empty (None)
-        list of devices does B{not} imply that the specified audio output does
-        not work.
-        @note: The list might not be exhaustive.
-        @warning: Some audio output devices in the list might not actually work in
-        some circumstances. By default, it is recommended to not specify any
-        explicit audio device.
-        @param psz_aout: audio output name (as returned by L{audio_output_list_get}()).
-        @return: A None-terminated linked list of potential audio output devices. It must be freed it with L{audio_output_device_list_release}().
-        @version: LibVLC 2.1.0 or later.
-        '''
-        return libvlc_audio_output_device_list_get(self, str_to_bytes(aout))
    
-
-
    [docs]class LogIterator(_Ctype):
-    '''Create a new VLC log iterator.
-    
-    '''
-
-    def __new__(cls, ptr=_internal_guard):
-        '''(INTERNAL) ctypes wrapper constructor.
-        '''
-        return _Constructor(cls, ptr)
-
-    def __iter__(self):
-        return self
-
-
    [docs]    def next(self):
-        if self.has_next():
-            b = LogMessage()
-            i = libvlc_log_iterator_next(self, b)
-            return i.contents
-        raise StopIteration
    
-
-    def __next__(self):
-        return self.next()
-
-
-    
-
    [docs]    def free(self):
-        '''Frees memory allocated by L{log_get_iterator}().
-        '''
-        return libvlc_log_iterator_free(self)
    
-
-    
-
    [docs]    def has_next(self):
-        '''Always returns zero.
-        This function is only provided for backward compatibility.
-        @return: always zero.
-        '''
-        return libvlc_log_iterator_has_next(self)
    
-
-
    [docs]class Media(_Ctype):
-    '''Create a new Media instance.
-
-    Usage: Media(MRL, *options)
-
-    See vlc.Instance.media_new documentation for details.
-    
-    '''
-
-    def __new__(cls, *args):
-        if args:
-            i = args[0]
-            if isinstance(i, _Ints):
-                return _Constructor(cls, i)
-            if isinstance(i, Instance):
-                return i.media_new(*args[1:])
-
-        o = get_default_instance().media_new(*args)
-        return o
-
-
    [docs]    def get_instance(self):
-        return getattr(self, '_instance', None)
    
-
-
    [docs]    def add_options(self, *options):
-        """Add a list of options to the media.
-
-        Options must be written without the double-dash. Warning: most
-        audio and video options, such as text renderer, have no
-        effects on an individual media. These options must be set at
-        the vlc.Instance or vlc.MediaPlayer instanciation.
-
-        @param options: optional media option=value strings
-        """
-        for o in options:
-            self.add_option(o)
    
-
-
    [docs]    def tracks_get(self):
-        """Get media descriptor's elementary streams description
-        Note, you need to call L{parse}() or play the media at least once
-        before calling this function.
-        Not doing this will result in an empty array.
-        The result must be freed with L{tracks_release}.
-        @version: LibVLC 2.1.0 and later.
-        """
-        mediaTrack_pp = ctypes.POINTER(MediaTrack)()
-        n = libvlc_media_tracks_get(self, ctypes.byref(mediaTrack_pp))
-        info = ctypes.cast(mediaTrack_pp, ctypes.POINTER(ctypes.POINTER(MediaTrack) * n))
-        try:
-            contents = info.contents
-        except ValueError:
-            # Media not parsed, no info.
-            return None
-        tracks = ( contents[i].contents for i in range(len(contents)) )
-        # libvlc_media_tracks_release(mediaTrack_pp, n)
-        return tracks
    
-
-
-    
-
    [docs]    def add_option(self, psz_options):
-        '''Add an option to the media.
-        This option will be used to determine how the media_player will
-        read the media. This allows to use VLC's advanced
-        reading/streaming options on a per-media basis.
-        @note: The options are listed in 'vlc --long-help' from the command line,
-        e.g. "-sout-all". Keep in mind that available options and their semantics
-        vary across LibVLC versions and builds.
-        @warning: Not all options affects L{Media} objects:
-        Specifically, due to architectural issues most audio and video options,
-        such as text renderer options, have no effects on an individual media.
-        These options must be set through L{new}() instead.
-        @param psz_options: the options (as a string).
-        '''
-        return libvlc_media_add_option(self, str_to_bytes(psz_options))
    
-
-    
-
    [docs]    def add_option_flag(self, psz_options, i_flags):
-        '''Add an option to the media with configurable flags.
-        This option will be used to determine how the media_player will
-        read the media. This allows to use VLC's advanced
-        reading/streaming options on a per-media basis.
-        The options are detailed in vlc --long-help, for instance
-        "--sout-all". Note that all options are not usable on medias:
-        specifically, due to architectural issues, video-related options
-        such as text renderer options cannot be set on a single media. They
-        must be set on the whole libvlc instance instead.
-        @param psz_options: the options (as a string).
-        @param i_flags: the flags for this option.
-        '''
-        return libvlc_media_add_option_flag(self, str_to_bytes(psz_options), i_flags)
    
-
-    
-
    [docs]    def retain(self):
-        '''Retain a reference to a media descriptor object (libvlc_media_t). Use
-        L{release}() to decrement the reference count of a
-        media descriptor object.
-        '''
-        return libvlc_media_retain(self)
    
-
-    
-
    [docs]    def release(self):
-        '''Decrement the reference count of a media descriptor object. If the
-        reference count is 0, then L{release}() will release the
-        media descriptor object. It will send out an libvlc_MediaFreed event
-        to all listeners. If the media descriptor object has been released it
-        should not be used again.
-        '''
-        return libvlc_media_release(self)
    
-
-    
-
    [docs]    def get_mrl(self):
-        '''Get the media resource locator (mrl) from a media descriptor object.
-        @return: string with mrl of media descriptor object.
-        '''
-        return libvlc_media_get_mrl(self)
    
-
-    
-
    [docs]    def duplicate(self):
-        '''Duplicate a media descriptor object.
-        '''
-        return libvlc_media_duplicate(self)
    
-
-    
-
    [docs]    def get_meta(self, e_meta):
-        '''Read the meta of the media.
-        If the media has not yet been parsed this will return None.
-        This methods automatically calls L{parse_async}(), so after calling
-        it you may receive a libvlc_MediaMetaChanged event. If you prefer a synchronous
-        version ensure that you call L{parse}() before get_meta().
-        See L{parse}
-        See L{parse_async}
-        See libvlc_MediaMetaChanged.
-        @param e_meta: the meta to read.
-        @return: the media's meta.
-        '''
-        return libvlc_media_get_meta(self, e_meta)
    
-
-    
-
    [docs]    def set_meta(self, e_meta, psz_value):
-        '''Set the meta of the media (this function will not save the meta, call
-        L{save_meta} in order to save the meta).
-        @param e_meta: the meta to write.
-        @param psz_value: the media's meta.
-        '''
-        return libvlc_media_set_meta(self, e_meta, str_to_bytes(psz_value))
    
-
-    
-
    [docs]    def save_meta(self):
-        '''Save the meta previously set.
-        @return: true if the write operation was successful.
-        '''
-        return libvlc_media_save_meta(self)
    
-
-    
-
    [docs]    def get_state(self):
-        '''Get current state of media descriptor object. Possible media states
-        are defined in libvlc_structures.c ( libvlc_NothingSpecial=0,
-        libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused,
-        libvlc_Stopped, libvlc_Ended,
-        libvlc_Error).
-        See libvlc_state_t.
-        @return: state of media descriptor object.
-        '''
-        return libvlc_media_get_state(self)
    
-
-    
-
    [docs]    def get_stats(self, p_stats):
-        '''Get the current statistics about the media.
-        @param p_stats:: structure that contain the statistics about the media (this structure must be allocated by the caller).
-        @return: true if the statistics are available, false otherwise \libvlc_return_bool.
-        '''
-        return libvlc_media_get_stats(self, p_stats)
    
-
-    
-
    [docs]    def subitems(self):
-        '''Get subitems of media descriptor object. This will increment
-        the reference count of supplied media descriptor object. Use
-        L{list_release}() to decrement the reference counting.
-        @return: list of media descriptor subitems or None.
-        '''
-        return libvlc_media_subitems(self)
    
-
-    @memoize_parameterless
-    def event_manager(self):
-        '''Get event manager from media descriptor object.
-        NOTE: this function doesn't increment reference counting.
-        @return: event manager object.
-        '''
-        return libvlc_media_event_manager(self)
-
-    
-
    [docs]    def get_duration(self):
-        '''Get duration (in ms) of media descriptor object item.
-        @return: duration of media item or -1 on error.
-        '''
-        return libvlc_media_get_duration(self)
    
-
-    
-
    [docs]    def parse(self):
-        '''Parse a media.
-        This fetches (local) meta data and tracks information.
-        The method is synchronous.
-        See L{parse_async}
-        See L{get_meta}
-        See L{get_tracks_info}.
-        '''
-        return libvlc_media_parse(self)
    
-
-    
-
    [docs]    def parse_async(self):
-        '''Parse a media.
-        This fetches (local) meta data and tracks information.
-        The method is the asynchronous of L{parse}().
-        To track when this is over you can listen to libvlc_MediaParsedChanged
-        event. However if the media was already parsed you will not receive this
-        event.
-        See L{parse}
-        See libvlc_MediaParsedChanged
-        See L{get_meta}
-        See L{get_tracks_info}.
-        '''
-        return libvlc_media_parse_async(self)
    
-
-    
-
    [docs]    def is_parsed(self):
-        '''Get Parsed status for media descriptor object.
-        See libvlc_MediaParsedChanged.
-        @return: true if media object has been parsed otherwise it returns false \libvlc_return_bool.
-        '''
-        return libvlc_media_is_parsed(self)
    
-
-    
-
    [docs]    def set_user_data(self, p_new_user_data):
-        '''Sets media descriptor's user_data. user_data is specialized data
-        accessed by the host application, VLC.framework uses it as a pointer to
-        an native object that references a L{Media} pointer.
-        @param p_new_user_data: pointer to user data.
-        '''
-        return libvlc_media_set_user_data(self, p_new_user_data)
    
-
-    
-
    [docs]    def get_user_data(self):
-        '''Get media descriptor's user_data. user_data is specialized data
-        accessed by the host application, VLC.framework uses it as a pointer to
-        an native object that references a L{Media} pointer.
-        '''
-        return libvlc_media_get_user_data(self)
    
-
-    
-
    [docs]    def get_tracks_info(self):
-        '''Get media descriptor's elementary streams description
-        Note, you need to call L{parse}() or play the media at least once
-        before calling this function.
-        Not doing this will result in an empty array.
-        \deprecated Use L{tracks_get} instead.
-        @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed by the caller) [OUT].
-        @return: the number of Elementary Streams.
-        '''
-        return libvlc_media_get_tracks_info(self)
    
-
-    
-
    [docs]    def player_new_from_media(self):
-        '''Create a Media Player object from a Media.
-        @return: a new media player object, or None on error.
-        '''
-        return libvlc_media_player_new_from_media(self)
    
-
-
    [docs]class MediaDiscoverer(_Ctype):
-    '''N/A
-    '''
-
-    def __new__(cls, ptr=_internal_guard):
-        '''(INTERNAL) ctypes wrapper constructor.
-        '''
-        return _Constructor(cls, ptr)
-    
-
    [docs]    def release(self):
-        '''Release media discover object. If the reference count reaches 0, then
-        the object will be released.
-        '''
-        return libvlc_media_discoverer_release(self)
    
-
-    
-
    [docs]    def localized_name(self):
-        '''Get media service discover object its localized name.
-        @return: localized name.
-        '''
-        return libvlc_media_discoverer_localized_name(self)
    
-
-    
-
    [docs]    def media_list(self):
-        '''Get media service discover media list.
-        @return: list of media items.
-        '''
-        return libvlc_media_discoverer_media_list(self)
    
-
-    @memoize_parameterless
-    def event_manager(self):
-        '''Get event manager from media service discover object.
-        @return: event manager object.
-        '''
-        return libvlc_media_discoverer_event_manager(self)
-
-    
-
    [docs]    def is_running(self):
-        '''Query if media service discover object is running.
-        @return: true if running, false if not \libvlc_return_bool.
-        '''
-        return libvlc_media_discoverer_is_running(self)
    
-
-
    [docs]class MediaLibrary(_Ctype):
-    '''N/A
-    '''
-
-    def __new__(cls, ptr=_internal_guard):
-        '''(INTERNAL) ctypes wrapper constructor.
-        '''
-        return _Constructor(cls, ptr)
-    
-
    [docs]    def release(self):
-        '''Release media library object. This functions decrements the
-        reference count of the media library object. If it reaches 0,
-        then the object will be released.
-        '''
-        return libvlc_media_library_release(self)
    
-
-    
-
    [docs]    def retain(self):
-        '''Retain a reference to a media library object. This function will
-        increment the reference counting for this object. Use
-        L{release}() to decrement the reference count.
-        '''
-        return libvlc_media_library_retain(self)
    
-
-    
-
    [docs]    def load(self):
-        '''Load media library.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_media_library_load(self)
    
-
-    
-
    [docs]    def media_list(self):
-        '''Get media library subitems.
-        @return: media list subitems.
-        '''
-        return libvlc_media_library_media_list(self)
    
-
-
    [docs]class MediaList(_Ctype):
-    '''Create a new MediaList instance.
-
-    Usage: MediaList(list_of_MRLs)
-
-    See vlc.Instance.media_list_new documentation for details.
-    
-    '''
-
-    def __new__(cls, *args):
-        if args:
-            i = args[0]
-            if isinstance(i, _Ints):
-                return _Constructor(cls, i)
-            if isinstance(i, Instance):
-                return i.media_list_new(*args[1:])
-
-        o = get_default_instance().media_list_new(*args)
-        return o
-
-
    [docs]    def get_instance(self):
-        return getattr(self, '_instance', None)
    
-
-
    [docs]    def add_media(self, mrl):
-        """Add media instance to media list.
-
-        The L{lock} should be held upon entering this function.
-        @param mrl: a media instance or a MRL.
-        @return: 0 on success, -1 if the media list is read-only.
-        """
-        if isinstance(mrl, basestring):
-            mrl = (self.get_instance() or get_default_instance()).media_new(mrl)
-        return libvlc_media_list_add_media(self, mrl)
    
-
-
-    
-
    [docs]    def release(self):
-        '''Release media list created with L{new}().
-        '''
-        return libvlc_media_list_release(self)
    
-
-    
-
    [docs]    def retain(self):
-        '''Retain reference to a media list.
-        '''
-        return libvlc_media_list_retain(self)
    
-
-    
-
    [docs]    def set_media(self, p_md):
-        '''Associate media instance with this media list instance.
-        If another media instance was present it will be released.
-        The L{lock} should NOT be held upon entering this function.
-        @param p_md: media instance to add.
-        '''
-        return libvlc_media_list_set_media(self, p_md)
    
-
-    
-
    [docs]    def media(self):
-        '''Get media instance from this media list instance. This action will increase
-        the refcount on the media instance.
-        The L{lock} should NOT be held upon entering this function.
-        @return: media instance.
-        '''
-        return libvlc_media_list_media(self)
    
-
-    
-
    [docs]    def insert_media(self, p_md, i_pos):
-        '''Insert media instance in media list on a position
-        The L{lock} should be held upon entering this function.
-        @param p_md: a media instance.
-        @param i_pos: position in array where to insert.
-        @return: 0 on success, -1 if the media list is read-only.
-        '''
-        return libvlc_media_list_insert_media(self, p_md, i_pos)
    
-
-    
-
    [docs]    def remove_index(self, i_pos):
-        '''Remove media instance from media list on a position
-        The L{lock} should be held upon entering this function.
-        @param i_pos: position in array where to insert.
-        @return: 0 on success, -1 if the list is read-only or the item was not found.
-        '''
-        return libvlc_media_list_remove_index(self, i_pos)
    
-
-    
-
    [docs]    def count(self):
-        '''Get count on media list items
-        The L{lock} should be held upon entering this function.
-        @return: number of items in media list.
-        '''
-        return libvlc_media_list_count(self)
    
-
-    def __len__(self):
-        return libvlc_media_list_count(self)
-
-    
-
    [docs]    def item_at_index(self, i_pos):
-        '''List media instance in media list at a position
-        The L{lock} should be held upon entering this function.
-        @param i_pos: position in array where to insert.
-        @return: media instance at position i_pos, or None if not found. In case of success, L{media_retain}() is called to increase the refcount on the media.
-        '''
-        return libvlc_media_list_item_at_index(self, i_pos)
    
-
-    def __getitem__(self, i):
-        return libvlc_media_list_item_at_index(self, i)
-
-    def __iter__(self):
-        for i in range(len(self)):
-            yield self[i]
-
-    
-
    [docs]    def index_of_item(self, p_md):
-        '''Find index position of List media instance in media list.
-        Warning: the function will return the first matched position.
-        The L{lock} should be held upon entering this function.
-        @param p_md: media instance.
-        @return: position of media instance or -1 if media not found.
-        '''
-        return libvlc_media_list_index_of_item(self, p_md)
    
-
-    
-
    [docs]    def is_readonly(self):
-        '''This indicates if this media list is read-only from a user point of view.
-        @return: 1 on readonly, 0 on readwrite \libvlc_return_bool.
-        '''
-        return libvlc_media_list_is_readonly(self)
    
-
-    
-
    [docs]    def lock(self):
-        '''Get lock on media list items.
-        '''
-        return libvlc_media_list_lock(self)
    
-
-    
-
    [docs]    def unlock(self):
-        '''Release lock on media list items
-        The L{lock} should be held upon entering this function.
-        '''
-        return libvlc_media_list_unlock(self)
    
-
-    @memoize_parameterless
-    def event_manager(self):
-        '''Get libvlc_event_manager from this media list instance.
-        The p_event_manager is immutable, so you don't have to hold the lock.
-        @return: libvlc_event_manager.
-        '''
-        return libvlc_media_list_event_manager(self)
    
-
-
    [docs]class MediaListPlayer(_Ctype):
-    '''Create a new MediaListPlayer instance.
-
-    It may take as parameter either:
-      - a vlc.Instance
-      - nothing
-    
-    '''
-
-    def __new__(cls, arg=None):
-        if arg is None:
-            i = get_default_instance()
-        elif isinstance(arg, Instance):
-            i = arg
-        elif isinstance(arg, _Ints):
-            return _Constructor(cls, arg)
-        else:
-            raise TypeError('MediaListPlayer %r' % (arg,))
-
-        return i.media_list_player_new()
-
-
    [docs]    def get_instance(self):
-        """Return the associated Instance.
-        """
-        return self._instance  #PYCHOK expected
    
-
-
-    
-
    [docs]    def release(self):
-        '''Release a media_list_player after use
-        Decrement the reference count of a media player object. If the
-        reference count is 0, then L{release}() will
-        release the media player object. If the media player object
-        has been released, then it should not be used again.
-        '''
-        return libvlc_media_list_player_release(self)
    
-
-    
-
    [docs]    def retain(self):
-        '''Retain a reference to a media player list object. Use
-        L{release}() to decrement reference count.
-        '''
-        return libvlc_media_list_player_retain(self)
    
-
-    @memoize_parameterless
-    def event_manager(self):
-        '''Return the event manager of this media_list_player.
-        @return: the event manager.
-        '''
-        return libvlc_media_list_player_event_manager(self)
-
-    
-
    [docs]    def set_media_player(self, p_mi):
-        '''Replace media player in media_list_player with this instance.
-        @param p_mi: media player instance.
-        '''
-        return libvlc_media_list_player_set_media_player(self, p_mi)
    
-
-    
-
    [docs]    def set_media_list(self, p_mlist):
-        '''Set the media list associated with the player.
-        @param p_mlist: list of media.
-        '''
-        return libvlc_media_list_player_set_media_list(self, p_mlist)
    
-
-    
-
    [docs]    def play(self):
-        '''Play media list.
-        '''
-        return libvlc_media_list_player_play(self)
    
-
-    
-
    [docs]    def pause(self):
-        '''Toggle pause (or resume) media list.
-        '''
-        return libvlc_media_list_player_pause(self)
    
-
-    
-
    [docs]    def is_playing(self):
-        '''Is media list playing?
-        @return: true for playing and false for not playing \libvlc_return_bool.
-        '''
-        return libvlc_media_list_player_is_playing(self)
    
-
-    
-
    [docs]    def get_state(self):
-        '''Get current libvlc_state of media list player.
-        @return: libvlc_state_t for media list player.
-        '''
-        return libvlc_media_list_player_get_state(self)
    
-
-    
-
    [docs]    def play_item_at_index(self, i_index):
-        '''Play media list item at position index.
-        @param i_index: index in media list to play.
-        @return: 0 upon success -1 if the item wasn't found.
-        '''
-        return libvlc_media_list_player_play_item_at_index(self, i_index)
    
-
-    def __getitem__(self, i):
-        return libvlc_media_list_player_play_item_at_index(self, i)
-
-    def __iter__(self):
-        for i in range(len(self)):
-            yield self[i]
-
-    
-
    [docs]    def play_item(self, p_md):
-        '''Play the given media item.
-        @param p_md: the media instance.
-        @return: 0 upon success, -1 if the media is not part of the media list.
-        '''
-        return libvlc_media_list_player_play_item(self, p_md)
    
-
-    
-
    [docs]    def stop(self):
-        '''Stop playing media list.
-        '''
-        return libvlc_media_list_player_stop(self)
    
-
-    
-
    [docs]    def next(self):
-        '''Play next item from media list.
-        @return: 0 upon success -1 if there is no next item.
-        '''
-        return libvlc_media_list_player_next(self)
    
-
-    
-
    [docs]    def previous(self):
-        '''Play previous item from media list.
-        @return: 0 upon success -1 if there is no previous item.
-        '''
-        return libvlc_media_list_player_previous(self)
    
-
-    
-
    [docs]    def set_playback_mode(self, e_mode):
-        '''Sets the playback mode for the playlist.
-        @param e_mode: playback mode specification.
-        '''
-        return libvlc_media_list_player_set_playback_mode(self, e_mode)
    
-
-
    [docs]class MediaPlayer(_Ctype):
-    '''Create a new MediaPlayer instance.
-
-    It may take as parameter either:
-      - a string (media URI), options... In this case, a vlc.Instance will be created.
-      - a vlc.Instance, a string (media URI), options...
-    
-    '''
-
-    def __new__(cls, *args):
-        if len(args) == 1 and isinstance(args[0], _Ints):
-            return _Constructor(cls, args[0])
-
-        if args and isinstance(args[0], Instance):
-            instance = args[0]
-            args = args[1:]
-        else:
-            instance = get_default_instance()
-
-        o = instance.media_player_new()
-        if args:
-            o.set_media(instance.media_new(*args))
-        return o
-
-
    [docs]    def get_instance(self):
-        """Return the associated Instance.
-        """
-        return self._instance  #PYCHOK expected
    
-
-
    [docs]    def set_mrl(self, mrl, *options):
-        """Set the MRL to play.
-
-        Warning: most audio and video options, such as text renderer,
-        have no effects on an individual media. These options must be
-        set at the vlc.Instance or vlc.MediaPlayer instanciation.
-
-        @param mrl: The MRL
-        @param options: optional media option=value strings
-        @return: the Media object
-        """
-        m = self.get_instance().media_new(mrl, *options)
-        self.set_media(m)
-        return m
    
-
-
    [docs]    def video_get_spu_description(self):
-        """Get the description of available video subtitles.
-        """
-        return track_description_list(libvlc_video_get_spu_description(self))
    
-
-
    [docs]    def video_get_title_description(self):
-        """Get the description of available titles.
-        """
-        return track_description_list(libvlc_video_get_title_description(self))
    
-
-
    [docs]    def video_get_chapter_description(self, title):
-        """Get the description of available chapters for specific title.
-
-        @param title: selected title (int)
-        """
-        return track_description_list(libvlc_video_get_chapter_description(self, title))
    
-
-
    [docs]    def video_get_track_description(self):
-        """Get the description of available video tracks.
-        """
-        return track_description_list(libvlc_video_get_track_description(self))
    
-
-
    [docs]    def audio_get_track_description(self):
-        """Get the description of available audio tracks.
-        """
-        return track_description_list(libvlc_audio_get_track_description(self))
    
-
-
    [docs]    def get_full_title_descriptions(self):
-        '''Get the full description of available titles.
-        @return: the titles list
-        @version: LibVLC 3.0.0 and later.
-        '''
-        titleDescription_pp = ctypes.POINTER(TitleDescription)()
-        n = libvlc_media_player_get_full_title_descriptions(self, ctypes.byref(titleDescription_pp))
-        info = ctypes.cast(ctypes.titleDescription_pp, ctypes.POINTER(ctypes.POINTER(TitleDescription) * n))
-        return info
    
-
-
    [docs]    def get_full_chapter_descriptions(self, i_chapters_of_title):
-        '''Get the full description of available chapters.
-        @param i_chapters_of_title: index of the title to query for chapters (uses current title if set to -1).
-        @return: the chapters list
-        @version: LibVLC 3.0.0 and later.
-        '''
-        chapterDescription_pp = ctypes.POINTER(ChapterDescription)()
-        n = libvlc_media_player_get_full_chapter_descriptions(self, ctypes.byref(chapterDescription_pp))
-        info = ctypes.cast(ctypes.chapterDescription_pp, ctypes.POINTER(ctypes.POINTER(ChapterDescription) * n))
-        return info
    
-
-
    [docs]    def video_get_size(self, num=0):
-        """Get the video size in pixels as 2-tuple (width, height).
-
-        @param num: video number (default 0).
-        """
-        r = libvlc_video_get_size(self, num)
-        if isinstance(r, tuple) and len(r) == 2:
-            return r
-        else:
-            raise VLCException('invalid video number (%s)' % (num,))
    
-
-
    [docs]    def set_hwnd(self, drawable):
-        """Set a Win32/Win64 API window handle (HWND).
-
-        Specify where the media player should render its video
-        output. If LibVLC was built without Win32/Win64 API output
-        support, then this has no effects.
-
-        @param drawable: windows handle of the drawable.
-        """
-        if not isinstance(drawable, ctypes.c_void_p):
-            drawable = ctypes.c_void_p(int(drawable))
-        libvlc_media_player_set_hwnd(self, drawable)
    
-
-
    [docs]    def video_get_width(self, num=0):
-        """Get the width of a video in pixels.
-
-        @param num: video number (default 0).
-        """
-        return self.video_get_size(num)[0]
    
-
-
    [docs]    def video_get_height(self, num=0):
-        """Get the height of a video in pixels.
-
-        @param num: video number (default 0).
-        """
-        return self.video_get_size(num)[1]
    
-
-
    [docs]    def video_get_cursor(self, num=0):
-        """Get the mouse pointer coordinates over a video as 2-tuple (x, y).
-
-        Coordinates are expressed in terms of the decoded video resolution,
-        B{not} in terms of pixels on the screen/viewport.  To get the
-        latter, you must query your windowing system directly.
-
-        Either coordinate may be negative or larger than the corresponding
-        size of the video, if the cursor is outside the rendering area.
-
-        @warning: The coordinates may be out-of-date if the pointer is not
-        located on the video rendering area.  LibVLC does not track the
-        mouse pointer if the latter is outside the video widget.
-
-        @note: LibVLC does not support multiple mouse pointers (but does
-        support multiple input devices sharing the same pointer).
-
-        @param num: video number (default 0).
-        """
-        r = libvlc_video_get_cursor(self, num)
-        if isinstance(r, tuple) and len(r) == 2:
-            return r
-        raise VLCException('invalid video number (%s)' % (num,))
    
-
-
-    
-
    [docs]    def release(self):
-        '''Release a media_player after use
-        Decrement the reference count of a media player object. If the
-        reference count is 0, then L{release}() will
-        release the media player object. If the media player object
-        has been released, then it should not be used again.
-        '''
-        return libvlc_media_player_release(self)
    
-
-    
-
    [docs]    def retain(self):
-        '''Retain a reference to a media player object. Use
-        L{release}() to decrement reference count.
-        '''
-        return libvlc_media_player_retain(self)
    
-
-    
-
    [docs]    def set_media(self, p_md):
-        '''Set the media that will be used by the media_player. If any,
-        previous md will be released.
-        @param p_md: the Media. Afterwards the p_md can be safely destroyed.
-        '''
-        return libvlc_media_player_set_media(self, p_md)
    
-
-    
-
    [docs]    def get_media(self):
-        '''Get the media used by the media_player.
-        @return: the media associated with p_mi, or None if no media is associated.
-        '''
-        return libvlc_media_player_get_media(self)
    
-
-    @memoize_parameterless
-    def event_manager(self):
-        '''Get the Event Manager from which the media player send event.
-        @return: the event manager associated with p_mi.
-        '''
-        return libvlc_media_player_event_manager(self)
-
-    
-
    [docs]    def is_playing(self):
-        '''is_playing.
-        @return: 1 if the media player is playing, 0 otherwise \libvlc_return_bool.
-        '''
-        return libvlc_media_player_is_playing(self)
    
-
-    
-
    [docs]    def play(self):
-        '''Play.
-        @return: 0 if playback started (and was already started), or -1 on error.
-        '''
-        return libvlc_media_player_play(self)
    
-
-    
-
    [docs]    def set_pause(self, do_pause):
-        '''Pause or resume (no effect if there is no media).
-        @param do_pause: play/resume if zero, pause if non-zero.
-        @version: LibVLC 1.1.1 or later.
-        '''
-        return libvlc_media_player_set_pause(self, do_pause)
    
-
-    
-
    [docs]    def pause(self):
-        '''Toggle pause (no effect if there is no media).
-        '''
-        return libvlc_media_player_pause(self)
    
-
-    
-
    [docs]    def stop(self):
-        '''Stop (no effect if there is no media).
-        '''
-        return libvlc_media_player_stop(self)
    
-
-    
-
    [docs]    def video_set_callbacks(self, lock, unlock, display, opaque):
-        '''Set callbacks and private data to render decoded video to a custom area
-        in memory.
-        Use L{video_set_format}() or L{video_set_format_callbacks}()
-        to configure the decoded format.
-        @param lock: callback to lock video memory (must not be None).
-        @param unlock: callback to unlock video memory (or None if not needed).
-        @param display: callback to display video (or None if not needed).
-        @param opaque: private pointer for the three callbacks (as first parameter).
-        @version: LibVLC 1.1.1 or later.
-        '''
-        return libvlc_video_set_callbacks(self, lock, unlock, display, opaque)
    
-
-    
-
    [docs]    def video_set_format(self, chroma, width, height, pitch):
-        '''Set decoded video chroma and dimensions.
-        This only works in combination with L{video_set_callbacks}(),
-        and is mutually exclusive with L{video_set_format_callbacks}().
-        @param chroma: a four-characters string identifying the chroma (e.g. "RV32" or "YUYV").
-        @param width: pixel width.
-        @param height: pixel height.
-        @param pitch: line pitch (in bytes).
-        @version: LibVLC 1.1.1 or later.
-        @bug: All pixel planes are expected to have the same pitch. To use the YCbCr color space with chrominance subsampling, consider using L{video_set_format_callbacks}() instead.
-        '''
-        return libvlc_video_set_format(self, str_to_bytes(chroma), width, height, pitch)
    
-
-    
-
    [docs]    def video_set_format_callbacks(self, setup, cleanup):
-        '''Set decoded video chroma and dimensions. This only works in combination with
-        L{video_set_callbacks}().
-        @param setup: callback to select the video format (cannot be None).
-        @param cleanup: callback to release any allocated resources (or None).
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_video_set_format_callbacks(self, setup, cleanup)
    
-
-    
-
    [docs]    def set_nsobject(self, drawable):
-        '''Set the NSView handler where the media player should render its video output.
-        Use the vout called "macosx".
-        The drawable is an NSObject that follow the VLCOpenGLVideoViewEmbedding
-        protocol:
-        @begincode
-        \@protocol VLCOpenGLVideoViewEmbedding <NSObject>
-        - (void)addVoutSubview:(NSView *)view;
-        - (void)removeVoutSubview:(NSView *)view;
-        \@end
-        @endcode
-        Or it can be an NSView object.
-        If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then
-        the following code should work:
-        @begincode
-        
-            NSView *video = [[NSView alloc] init];
-            QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent);
-            L{set_nsobject}(mp, video);
-            [video release];
-        
-        @endcode
-        You can find a live example in VLCVideoView in VLCKit.framework.
-        @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol.
-        '''
-        return libvlc_media_player_set_nsobject(self, drawable)
    
-
-    
-
    [docs]    def get_nsobject(self):
-        '''Get the NSView handler previously set with L{set_nsobject}().
-        @return: the NSView handler or 0 if none where set.
-        '''
-        return libvlc_media_player_get_nsobject(self)
    
-
-    
-
    [docs]    def set_agl(self, drawable):
-        '''Set the agl handler where the media player should render its video output.
-        @param drawable: the agl handler.
-        '''
-        return libvlc_media_player_set_agl(self, drawable)
    
-
-    
-
    [docs]    def get_agl(self):
-        '''Get the agl handler previously set with L{set_agl}().
-        @return: the agl handler or 0 if none where set.
-        '''
-        return libvlc_media_player_get_agl(self)
    
-
-    
-
    [docs]    def set_xwindow(self, drawable):
-        '''Set an X Window System drawable where the media player should render its
-        video output. If LibVLC was built without X11 output support, then this has
-        no effects.
-        The specified identifier must correspond to an existing Input/Output class
-        X11 window. Pixmaps are B{not} supported. The caller shall ensure that
-        the X11 server is the same as the one the VLC instance has been configured
-        with. This function must be called before video playback is started;
-        otherwise it will only take effect after playback stop and restart.
-        @param drawable: the ID of the X window.
-        '''
-        return libvlc_media_player_set_xwindow(self, drawable)
    
-
-    
-
    [docs]    def get_xwindow(self):
-        '''Get the X Window System window identifier previously set with
-        L{set_xwindow}(). Note that this will return the identifier
-        even if VLC is not currently using it (for instance if it is playing an
-        audio-only input).
-        @return: an X window ID, or 0 if none where set.
-        '''
-        return libvlc_media_player_get_xwindow(self)
    
-
-    
-
    [docs]    def get_hwnd(self):
-        '''Get the Windows API window handle (HWND) previously set with
-        L{set_hwnd}(). The handle will be returned even if LibVLC
-        is not currently outputting any video to it.
-        @return: a window handle or None if there are none.
-        '''
-        return libvlc_media_player_get_hwnd(self)
    
-
-    
-
    [docs]    def audio_set_callbacks(self, play, pause, resume, flush, drain, opaque):
-        '''Set callbacks and private data for decoded audio.
-        Use L{audio_set_format}() or L{audio_set_format_callbacks}()
-        to configure the decoded audio format.
-        @param play: callback to play audio samples (must not be None).
-        @param pause: callback to pause playback (or None to ignore).
-        @param resume: callback to resume playback (or None to ignore).
-        @param flush: callback to flush audio buffers (or None to ignore).
-        @param drain: callback to drain audio buffers (or None to ignore).
-        @param opaque: private pointer for the audio callbacks (as first parameter).
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_audio_set_callbacks(self, play, pause, resume, flush, drain, opaque)
    
-
-    
-
    [docs]    def audio_set_volume_callback(self, set_volume):
-        '''Set callbacks and private data for decoded audio. This only works in
-        combination with L{audio_set_callbacks}().
-        Use L{audio_set_format}() or L{audio_set_format_callbacks}()
-        to configure the decoded audio format.
-        @param set_volume: callback to apply audio volume, or None to apply volume in software.
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_audio_set_volume_callback(self, set_volume)
    
-
-    
-
    [docs]    def audio_set_format_callbacks(self, setup, cleanup):
-        '''Set decoded audio format. This only works in combination with
-        L{audio_set_callbacks}().
-        @param setup: callback to select the audio format (cannot be None).
-        @param cleanup: callback to release any allocated resources (or None).
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_audio_set_format_callbacks(self, setup, cleanup)
    
-
-    
-
    [docs]    def audio_set_format(self, format, rate, channels):
-        '''Set decoded audio format.
-        This only works in combination with L{audio_set_callbacks}(),
-        and is mutually exclusive with L{audio_set_format_callbacks}().
-        @param format: a four-characters string identifying the sample format (e.g. "S16N" or "FL32").
-        @param rate: sample rate (expressed in Hz).
-        @param channels: channels count.
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_audio_set_format(self, str_to_bytes(format), rate, channels)
    
-
-    
-
    [docs]    def get_length(self):
-        '''Get the current movie length (in ms).
-        @return: the movie length (in ms), or -1 if there is no media.
-        '''
-        return libvlc_media_player_get_length(self)
    
-
-    
-
    [docs]    def get_time(self):
-        '''Get the current movie time (in ms).
-        @return: the movie time (in ms), or -1 if there is no media.
-        '''
-        return libvlc_media_player_get_time(self)
    
-
-    
-
    [docs]    def set_time(self, i_time):
-        '''Set the movie time (in ms). This has no effect if no media is being played.
-        Not all formats and protocols support this.
-        @param i_time: the movie time (in ms).
-        '''
-        return libvlc_media_player_set_time(self, i_time)
    
-
-    
-
    [docs]    def get_position(self):
-        '''Get movie position as percentage between 0.0 and 1.0.
-        @return: movie position, or -1. in case of error.
-        '''
-        return libvlc_media_player_get_position(self)
    
-
-    
-
    [docs]    def set_position(self, f_pos):
-        '''Set movie position as percentage between 0.0 and 1.0.
-        This has no effect if playback is not enabled.
-        This might not work depending on the underlying input format and protocol.
-        @param f_pos: the position.
-        '''
-        return libvlc_media_player_set_position(self, f_pos)
    
-
-    
-
    [docs]    def set_chapter(self, i_chapter):
-        '''Set movie chapter (if applicable).
-        @param i_chapter: chapter number to play.
-        '''
-        return libvlc_media_player_set_chapter(self, i_chapter)
    
-
-    
-
    [docs]    def get_chapter(self):
-        '''Get movie chapter.
-        @return: chapter number currently playing, or -1 if there is no media.
-        '''
-        return libvlc_media_player_get_chapter(self)
    
-
-    
-
    [docs]    def get_chapter_count(self):
-        '''Get movie chapter count.
-        @return: number of chapters in movie, or -1.
-        '''
-        return libvlc_media_player_get_chapter_count(self)
    
-
-    
-
    [docs]    def will_play(self):
-        '''Is the player able to play.
-        @return: boolean \libvlc_return_bool.
-        '''
-        return libvlc_media_player_will_play(self)
    
-
-    
-
    [docs]    def get_chapter_count_for_title(self, i_title):
-        '''Get title chapter count.
-        @param i_title: title.
-        @return: number of chapters in title, or -1.
-        '''
-        return libvlc_media_player_get_chapter_count_for_title(self, i_title)
    
-
-    
-
    [docs]    def set_title(self, i_title):
-        '''Set movie title.
-        @param i_title: title number to play.
-        '''
-        return libvlc_media_player_set_title(self, i_title)
    
-
-    
-
    [docs]    def get_title(self):
-        '''Get movie title.
-        @return: title number currently playing, or -1.
-        '''
-        return libvlc_media_player_get_title(self)
    
-
-    
-
    [docs]    def get_title_count(self):
-        '''Get movie title count.
-        @return: title number count, or -1.
-        '''
-        return libvlc_media_player_get_title_count(self)
    
-
-    
-
    [docs]    def previous_chapter(self):
-        '''Set previous chapter (if applicable).
-        '''
-        return libvlc_media_player_previous_chapter(self)
    
-
-    
-
    [docs]    def next_chapter(self):
-        '''Set next chapter (if applicable).
-        '''
-        return libvlc_media_player_next_chapter(self)
    
-
-    
-
    [docs]    def get_rate(self):
-        '''Get the requested movie play rate.
-        @warning: Depending on the underlying media, the requested rate may be
-        different from the real playback rate.
-        @return: movie play rate.
-        '''
-        return libvlc_media_player_get_rate(self)
    
-
-    
-
    [docs]    def set_rate(self, rate):
-        '''Set movie play rate.
-        @param rate: movie play rate to set.
-        @return: -1 if an error was detected, 0 otherwise (but even then, it might not actually work depending on the underlying media protocol).
-        '''
-        return libvlc_media_player_set_rate(self, rate)
    
-
-    
-
    [docs]    def get_state(self):
-        '''Get current movie state.
-        @return: the current state of the media player (playing, paused, ...) See libvlc_state_t.
-        '''
-        return libvlc_media_player_get_state(self)
    
-
-    
-
    [docs]    def get_fps(self):
-        '''Get movie fps rate.
-        @return: frames per second (fps) for this playing movie, or 0 if unspecified.
-        '''
-        return libvlc_media_player_get_fps(self)
    
-
-    
-
    [docs]    def has_vout(self):
-        '''How many video outputs does this media player have?
-        @return: the number of video outputs.
-        '''
-        return libvlc_media_player_has_vout(self)
    
-
-    
-
    [docs]    def is_seekable(self):
-        '''Is this media player seekable?
-        @return: true if the media player can seek \libvlc_return_bool.
-        '''
-        return libvlc_media_player_is_seekable(self)
    
-
-    
-
    [docs]    def can_pause(self):
-        '''Can this media player be paused?
-        @return: true if the media player can pause \libvlc_return_bool.
-        '''
-        return libvlc_media_player_can_pause(self)
    
-
-    
-
    [docs]    def program_scrambled(self):
-        '''Check if the current program is scrambled.
-        @return: true if the current program is scrambled \libvlc_return_bool.
-        @version: LibVLC 2.2.0 or later.
-        '''
-        return libvlc_media_player_program_scrambled(self)
    
-
-    
-
    [docs]    def next_frame(self):
-        '''Display the next frame (if supported).
-        '''
-        return libvlc_media_player_next_frame(self)
    
-
-    
-
    [docs]    def navigate(self, navigate):
-        '''Navigate through DVD Menu.
-        @param navigate: the Navigation mode.
-        @version: libVLC 2.0.0 or later.
-        '''
-        return libvlc_media_player_navigate(self, navigate)
    
-
-    
-
    [docs]    def set_video_title_display(self, position, timeout):
-        '''Set if, and how, the video title will be shown when media is played.
-        @param position: position at which to display the title, or libvlc_position_disable to prevent the title from being displayed.
-        @param timeout: title display timeout in milliseconds (ignored if libvlc_position_disable).
-        @version: libVLC 2.1.0 or later.
-        '''
-        return libvlc_media_player_set_video_title_display(self, position, timeout)
    
-
-    
-
    [docs]    def toggle_fullscreen(self):
-        '''Toggle fullscreen status on non-embedded video outputs.
-        @warning: The same limitations applies to this function
-        as to L{set_fullscreen}().
-        '''
-        return libvlc_toggle_fullscreen(self)
    
-
-    
-
    [docs]    def set_fullscreen(self, b_fullscreen):
-        '''Enable or disable fullscreen.
-        @warning: With most window managers, only a top-level windows can be in
-        full-screen mode. Hence, this function will not operate properly if
-        L{set_xwindow}() was used to embed the video in a
-        non-top-level window. In that case, the embedding window must be reparented
-        to the root window B{before} fullscreen mode is enabled. You will want
-        to reparent it back to its normal parent when disabling fullscreen.
-        @param b_fullscreen: boolean for fullscreen status.
-        '''
-        return libvlc_set_fullscreen(self, b_fullscreen)
    
-
-    
-
    [docs]    def get_fullscreen(self):
-        '''Get current fullscreen status.
-        @return: the fullscreen status (boolean) \libvlc_return_bool.
-        '''
-        return libvlc_get_fullscreen(self)
    
-
-    
-
    [docs]    def video_set_key_input(self, on):
-        '''Enable or disable key press events handling, according to the LibVLC hotkeys
-        configuration. By default and for historical reasons, keyboard events are
-        handled by the LibVLC video widget.
-        @note: On X11, there can be only one subscriber for key press and mouse
-        click events per window. If your application has subscribed to those events
-        for the X window ID of the video widget, then LibVLC will not be able to
-        handle key presses and mouse clicks in any case.
-        @warning: This function is only implemented for X11 and Win32 at the moment.
-        @param on: true to handle key press events, false to ignore them.
-        '''
-        return libvlc_video_set_key_input(self, on)
    
-
-    
-
    [docs]    def video_set_mouse_input(self, on):
-        '''Enable or disable mouse click events handling. By default, those events are
-        handled. This is needed for DVD menus to work, as well as a few video
-        filters such as "puzzle".
-        See L{video_set_key_input}().
-        @warning: This function is only implemented for X11 and Win32 at the moment.
-        @param on: true to handle mouse click events, false to ignore them.
-        '''
-        return libvlc_video_set_mouse_input(self, on)
    
-
-    
-
    [docs]    def video_get_scale(self):
-        '''Get the current video scaling factor.
-        See also L{video_set_scale}().
-        @return: the currently configured zoom factor, or 0. if the video is set to fit to the output window/drawable automatically.
-        '''
-        return libvlc_video_get_scale(self)
    
-
-    
-
    [docs]    def video_set_scale(self, f_factor):
-        '''Set the video scaling factor. That is the ratio of the number of pixels on
-        screen to the number of pixels in the original decoded video in each
-        dimension. Zero is a special value; it will adjust the video to the output
-        window/drawable (in windowed mode) or the entire screen.
-        Note that not all video outputs support scaling.
-        @param f_factor: the scaling factor, or zero.
-        '''
-        return libvlc_video_set_scale(self, f_factor)
    
-
-    
-
    [docs]    def video_get_aspect_ratio(self):
-        '''Get current video aspect ratio.
-        @return: the video aspect ratio or None if unspecified (the result must be released with free() or L{free}()).
-        '''
-        return libvlc_video_get_aspect_ratio(self)
    
-
-    
-
    [docs]    def video_set_aspect_ratio(self, psz_aspect):
-        '''Set new video aspect ratio.
-        @param psz_aspect: new video aspect-ratio or None to reset to default @note Invalid aspect ratios are ignored.
-        '''
-        return libvlc_video_set_aspect_ratio(self, str_to_bytes(psz_aspect))
    
-
-    
-
    [docs]    def video_get_spu(self):
-        '''Get current video subtitle.
-        @return: the video subtitle selected, or -1 if none.
-        '''
-        return libvlc_video_get_spu(self)
    
-
-    
-
    [docs]    def video_get_spu_count(self):
-        '''Get the number of available video subtitles.
-        @return: the number of available video subtitles.
-        '''
-        return libvlc_video_get_spu_count(self)
    
-
-    
-
    [docs]    def video_set_spu(self, i_spu):
-        '''Set new video subtitle.
-        @param i_spu: video subtitle track to select (i_id from track description).
-        @return: 0 on success, -1 if out of range.
-        '''
-        return libvlc_video_set_spu(self, i_spu)
    
-
-    
-
    [docs]    def video_set_subtitle_file(self, psz_subtitle):
-        '''Set new video subtitle file.
-        @param psz_subtitle: new video subtitle file.
-        @return: the success status (boolean).
-        '''
-        return libvlc_video_set_subtitle_file(self, str_to_bytes(psz_subtitle))
    
-
-    
-
    [docs]    def video_get_spu_delay(self):
-        '''Get the current subtitle delay. Positive values means subtitles are being
-        displayed later, negative values earlier.
-        @return: time (in microseconds) the display of subtitles is being delayed.
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_video_get_spu_delay(self)
    
-
-    
-
    [docs]    def video_set_spu_delay(self, i_delay):
-        '''Set the subtitle delay. This affects the timing of when the subtitle will
-        be displayed. Positive values result in subtitles being displayed later,
-        while negative values will result in subtitles being displayed earlier.
-        The subtitle delay will be reset to zero each time the media changes.
-        @param i_delay: time (in microseconds) the display of subtitles should be delayed.
-        @return: 0 on success, -1 on error.
-        @version: LibVLC 2.0.0 or later.
-        '''
-        return libvlc_video_set_spu_delay(self, i_delay)
    
-
-    
-
    [docs]    def video_get_crop_geometry(self):
-        '''Get current crop filter geometry.
-        @return: the crop filter geometry or None if unset.
-        '''
-        return libvlc_video_get_crop_geometry(self)
    
-
-    
-
    [docs]    def video_set_crop_geometry(self, psz_geometry):
-        '''Set new crop filter geometry.
-        @param psz_geometry: new crop filter geometry (None to unset).
-        '''
-        return libvlc_video_set_crop_geometry(self, str_to_bytes(psz_geometry))
    
-
-    
-
    [docs]    def video_get_teletext(self):
-        '''Get current teletext page requested.
-        @return: the current teletext page requested.
-        '''
-        return libvlc_video_get_teletext(self)
    
-
-    
-
    [docs]    def video_set_teletext(self, i_page):
-        '''Set new teletext page to retrieve.
-        @param i_page: teletex page number requested.
-        '''
-        return libvlc_video_set_teletext(self, i_page)
    
-
-    
-
    [docs]    def toggle_teletext(self):
-        '''Toggle teletext transparent status on video output.
-        '''
-        return libvlc_toggle_teletext(self)
    
-
-    
-
    [docs]    def video_get_track_count(self):
-        '''Get number of available video tracks.
-        @return: the number of available video tracks (int).
-        '''
-        return libvlc_video_get_track_count(self)
    
-
-    
-
    [docs]    def video_get_track(self):
-        '''Get current video track.
-        @return: the video track ID (int) or -1 if no active input.
-        '''
-        return libvlc_video_get_track(self)
    
-
-    
-
    [docs]    def video_set_track(self, i_track):
-        '''Set video track.
-        @param i_track: the track ID (i_id field from track description).
-        @return: 0 on success, -1 if out of range.
-        '''
-        return libvlc_video_set_track(self, i_track)
    
-
-    
-
    [docs]    def video_take_snapshot(self, num, psz_filepath, i_width, i_height):
-        '''Take a snapshot of the current video window.
-        If i_width AND i_height is 0, original size is used.
-        If i_width XOR i_height is 0, original aspect-ratio is preserved.
-        @param num: number of video output (typically 0 for the first/only one).
-        @param psz_filepath: the path where to save the screenshot to.
-        @param i_width: the snapshot's width.
-        @param i_height: the snapshot's height.
-        @return: 0 on success, -1 if the video was not found.
-        '''
-        return libvlc_video_take_snapshot(self, num, str_to_bytes(psz_filepath), i_width, i_height)
    
-
-    
-
    [docs]    def video_set_deinterlace(self, psz_mode):
-        '''Enable or disable deinterlace filter.
-        @param psz_mode: type of deinterlace filter, None to disable.
-        '''
-        return libvlc_video_set_deinterlace(self, str_to_bytes(psz_mode))
    
-
-    
-
    [docs]    def video_get_marquee_int(self, option):
-        '''Get an integer marquee option value.
-        @param option: marq option to get See libvlc_video_marquee_int_option_t.
-        '''
-        return libvlc_video_get_marquee_int(self, option)
    
-
-    
-
    [docs]    def video_get_marquee_string(self, option):
-        '''Get a string marquee option value.
-        @param option: marq option to get See libvlc_video_marquee_string_option_t.
-        '''
-        return libvlc_video_get_marquee_string(self, option)
    
-
-    
-
    [docs]    def video_set_marquee_int(self, option, i_val):
-        '''Enable, disable or set an integer marquee option
-        Setting libvlc_marquee_Enable has the side effect of enabling (arg !0)
-        or disabling (arg 0) the marq filter.
-        @param option: marq option to set See libvlc_video_marquee_int_option_t.
-        @param i_val: marq option value.
-        '''
-        return libvlc_video_set_marquee_int(self, option, i_val)
    
-
-    
-
    [docs]    def video_set_marquee_string(self, option, psz_text):
-        '''Set a marquee string option.
-        @param option: marq option to set See libvlc_video_marquee_string_option_t.
-        @param psz_text: marq option value.
-        '''
-        return libvlc_video_set_marquee_string(self, option, str_to_bytes(psz_text))
    
-
-    
-
    [docs]    def video_get_logo_int(self, option):
-        '''Get integer logo option.
-        @param option: logo option to get, values of libvlc_video_logo_option_t.
-        '''
-        return libvlc_video_get_logo_int(self, option)
    
-
-    
-
    [docs]    def video_set_logo_int(self, option, value):
-        '''Set logo option as integer. Options that take a different type value
-        are ignored.
-        Passing libvlc_logo_enable as option value has the side effect of
-        starting (arg !0) or stopping (arg 0) the logo filter.
-        @param option: logo option to set, values of libvlc_video_logo_option_t.
-        @param value: logo option value.
-        '''
-        return libvlc_video_set_logo_int(self, option, value)
    
-
-    
-
    [docs]    def video_set_logo_string(self, option, psz_value):
-        '''Set logo option as string. Options that take a different type value
-        are ignored.
-        @param option: logo option to set, values of libvlc_video_logo_option_t.
-        @param psz_value: logo option value.
-        '''
-        return libvlc_video_set_logo_string(self, option, str_to_bytes(psz_value))
    
-
-    
-
    [docs]    def video_get_adjust_int(self, option):
-        '''Get integer adjust option.
-        @param option: adjust option to get, values of libvlc_video_adjust_option_t.
-        @version: LibVLC 1.1.1 and later.
-        '''
-        return libvlc_video_get_adjust_int(self, option)
    
-
-    
-
    [docs]    def video_set_adjust_int(self, option, value):
-        '''Set adjust option as integer. Options that take a different type value
-        are ignored.
-        Passing libvlc_adjust_enable as option value has the side effect of
-        starting (arg !0) or stopping (arg 0) the adjust filter.
-        @param option: adust option to set, values of libvlc_video_adjust_option_t.
-        @param value: adjust option value.
-        @version: LibVLC 1.1.1 and later.
-        '''
-        return libvlc_video_set_adjust_int(self, option, value)
    
-
-    
-
    [docs]    def video_get_adjust_float(self, option):
-        '''Get float adjust option.
-        @param option: adjust option to get, values of libvlc_video_adjust_option_t.
-        @version: LibVLC 1.1.1 and later.
-        '''
-        return libvlc_video_get_adjust_float(self, option)
    
-
-    
-
    [docs]    def video_set_adjust_float(self, option, value):
-        '''Set adjust option as float. Options that take a different type value
-        are ignored.
-        @param option: adust option to set, values of libvlc_video_adjust_option_t.
-        @param value: adjust option value.
-        @version: LibVLC 1.1.1 and later.
-        '''
-        return libvlc_video_set_adjust_float(self, option, value)
    
-
-    
-
    [docs]    def audio_output_set(self, psz_name):
-        '''Selects an audio output module.
-        @note: Any change will take be effect only after playback is stopped and
-        restarted. Audio output cannot be changed while playing.
-        @param psz_name: name of audio output, use psz_name of See L{AudioOutput}.
-        @return: 0 if function succeded, -1 on error.
-        '''
-        return libvlc_audio_output_set(self, str_to_bytes(psz_name))
    
-
-    
-
    [docs]    def audio_output_device_enum(self):
-        '''Gets a list of potential audio output devices,
-        See L{audio_output_device_set}().
-        @note: Not all audio outputs support enumerating devices.
-        The audio output may be functional even if the list is empty (None).
-        @note: The list may not be exhaustive.
-        @warning: Some audio output devices in the list might not actually work in
-        some circumstances. By default, it is recommended to not specify any
-        explicit audio device.
-        @return: A None-terminated linked list of potential audio output devices. It must be freed it with L{audio_output_device_list_release}().
-        @version: LibVLC 2.2.0 or later.
-        '''
-        return libvlc_audio_output_device_enum(self)
    
-
-    
-
    [docs]    def audio_output_device_set(self, module, device_id):
-        '''Configures an explicit audio output device.
-        If the module paramater is None, audio output will be moved to the device
-        specified by the device identifier string immediately. This is the
-        recommended usage.
-        A list of adequate potential device strings can be obtained with
-        L{audio_output_device_enum}().
-        However passing None is supported in LibVLC version 2.2.0 and later only;
-        in earlier versions, this function would have no effects when the module
-        parameter was None.
-        If the module parameter is not None, the device parameter of the
-        corresponding audio output, if it exists, will be set to the specified
-        string. Note that some audio output modules do not have such a parameter
-        (notably MMDevice and PulseAudio).
-        A list of adequate potential device strings can be obtained with
-        L{audio_output_device_list_get}().
-        @note: This function does not select the specified audio output plugin.
-        L{audio_output_set}() is used for that purpose.
-        @warning: The syntax for the device parameter depends on the audio output.
-        Some audio output modules require further parameters (e.g. a channels map
-        in the case of ALSA).
-        @param module: If None, current audio output module. if non-None, name of audio output module.
-        @param device_id: device identifier string.
-        @return: Nothing. Errors are ignored (this is a design bug).
-        '''
-        return libvlc_audio_output_device_set(self, str_to_bytes(module), str_to_bytes(device_id))
    
-
-    
-
    [docs]    def audio_toggle_mute(self):
-        '''Toggle mute status.
-        '''
-        return libvlc_audio_toggle_mute(self)
    
-
-    
-
    [docs]    def audio_get_mute(self):
-        '''Get current mute status.
-        @return: the mute status (boolean) if defined, -1 if undefined/unapplicable.
-        '''
-        return libvlc_audio_get_mute(self)
    
-
-    
-
    [docs]    def audio_set_mute(self, status):
-        '''Set mute status.
-        @param status: If status is true then mute, otherwise unmute @warning This function does not always work. If there are no active audio playback stream, the mute status might not be available. If digital pass-through (S/PDIF, HDMI...) is in use, muting may be unapplicable. Also some audio output plugins do not support muting at all. @note To force silent playback, disable all audio tracks. This is more efficient and reliable than mute.
-        '''
-        return libvlc_audio_set_mute(self, status)
    
-
-    
-
    [docs]    def audio_get_volume(self):
-        '''Get current software audio volume.
-        @return: the software volume in percents (0 = mute, 100 = nominal / 0dB).
-        '''
-        return libvlc_audio_get_volume(self)
    
-
-    
-
    [docs]    def audio_set_volume(self, i_volume):
-        '''Set current software audio volume.
-        @param i_volume: the volume in percents (0 = mute, 100 = 0dB).
-        @return: 0 if the volume was set, -1 if it was out of range.
-        '''
-        return libvlc_audio_set_volume(self, i_volume)
    
-
-    
-
    [docs]    def audio_get_track_count(self):
-        '''Get number of available audio tracks.
-        @return: the number of available audio tracks (int), or -1 if unavailable.
-        '''
-        return libvlc_audio_get_track_count(self)
    
-
-    
-
    [docs]    def audio_get_track(self):
-        '''Get current audio track.
-        @return: the audio track ID or -1 if no active input.
-        '''
-        return libvlc_audio_get_track(self)
    
-
-    
-
    [docs]    def audio_set_track(self, i_track):
-        '''Set current audio track.
-        @param i_track: the track ID (i_id field from track description).
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_audio_set_track(self, i_track)
    
-
-    
-
    [docs]    def audio_get_channel(self):
-        '''Get current audio channel.
-        @return: the audio channel See libvlc_audio_output_channel_t.
-        '''
-        return libvlc_audio_get_channel(self)
    
-
-    
-
    [docs]    def audio_set_channel(self, channel):
-        '''Set current audio channel.
-        @param channel: the audio channel, See libvlc_audio_output_channel_t.
-        @return: 0 on success, -1 on error.
-        '''
-        return libvlc_audio_set_channel(self, channel)
    
-
-    
-
    [docs]    def audio_get_delay(self):
-        '''Get current audio delay.
-        @return: the audio delay (microseconds).
-        @version: LibVLC 1.1.1 or later.
-        '''
-        return libvlc_audio_get_delay(self)
    
-
-    
-
    [docs]    def audio_set_delay(self, i_delay):
-        '''Set current audio delay. The audio delay will be reset to zero each time the media changes.
-        @param i_delay: the audio delay (microseconds).
-        @return: 0 on success, -1 on error.
-        @version: LibVLC 1.1.1 or later.
-        '''
-        return libvlc_audio_set_delay(self, i_delay)
    
-
-    
-
    [docs]    def set_equalizer(self, p_equalizer):
-        '''Apply new equalizer settings to a media player.
-        The equalizer is first created by invoking L{audio_equalizer_new}() or
-        L{audio_equalizer_new_from_preset}().
-        It is possible to apply new equalizer settings to a media player whether the media
-        player is currently playing media or not.
-        Invoking this method will immediately apply the new equalizer settings to the audio
-        output of the currently playing media if there is any.
-        If there is no currently playing media, the new equalizer settings will be applied
-        later if and when new media is played.
-        Equalizer settings will automatically be applied to subsequently played media.
-        To disable the equalizer for a media player invoke this method passing None for the
-        p_equalizer parameter.
-        The media player does not keep a reference to the supplied equalizer so it is safe
-        for an application to release the equalizer reference any time after this method
-        returns.
-        @param p_equalizer: opaque equalizer handle, or None to disable the equalizer for this media player.
-        @return: zero on success, -1 on error.
-        @version: LibVLC 2.2.0 or later.
-        '''
-        return libvlc_media_player_set_equalizer(self, p_equalizer)
    
-
-
- # LibVLC __version__ functions #
-
-
    [docs]def libvlc_clearerr():
-    '''Clears the LibVLC error status for the current thread. This is optional.
-    By default, the error status is automatically overridden when a new error
-    occurs, and destroyed when the thread exits.
-    '''
-    f = _Cfunctions.get('libvlc_clearerr', None) or \
-        _Cfunction('libvlc_clearerr', (), None,
-                    None)
-    return f()
    
-
-
    [docs]def libvlc_vprinterr(fmt, ap):
-    '''Sets the LibVLC error status and message for the current thread.
-    Any previous error is overridden.
-    @param fmt: the format string.
-    @param ap: the arguments.
-    @return: a nul terminated string in any case.
-    '''
-    f = _Cfunctions.get('libvlc_vprinterr', None) or \
-        _Cfunction('libvlc_vprinterr', ((1,), (1,),), None,
-                    ctypes.c_char_p, ctypes.c_char_p, ctypes.c_void_p)
-    return f(fmt, ap)
    
-
-
    [docs]def libvlc_new(argc, argv):
-    '''Create and initialize a libvlc instance.
-    This functions accept a list of "command line" arguments similar to the
-    main(). These arguments affect the LibVLC instance default configuration.
-    @param argc: the number of arguments (should be 0).
-    @param argv: list of arguments (should be None).
-    @return: the libvlc instance or None in case of error.
-    @version Arguments are meant to be passed from the command line to LibVLC, just like VLC media player does. The list of valid arguments depends on the LibVLC version, the operating system and platform, and set of available LibVLC plugins. Invalid or unsupported arguments will cause the function to fail (i.e. return None). Also, some arguments may alter the behaviour or otherwise interfere with other LibVLC functions. @warning There is absolutely no warranty or promise of forward, backward and cross-platform compatibility with regards to L{libvlc_new}() arguments. We recommend that you do not use them, other than when debugging.
-    '''
-    f = _Cfunctions.get('libvlc_new', None) or \
-        _Cfunction('libvlc_new', ((1,), (1,),), class_result(Instance),
-                    ctypes.c_void_p, ctypes.c_int, ListPOINTER(ctypes.c_char_p))
-    return f(argc, argv)
    
-
-
    [docs]def libvlc_release(p_instance):
-    '''Decrement the reference count of a libvlc instance, and destroy it
-    if it reaches zero.
-    @param p_instance: the instance to destroy.
-    '''
-    f = _Cfunctions.get('libvlc_release', None) or \
-        _Cfunction('libvlc_release', ((1,),), None,
-                    None, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_retain(p_instance):
-    '''Increments the reference count of a libvlc instance.
-    The initial reference count is 1 after L{libvlc_new}() returns.
-    @param p_instance: the instance to reference.
-    '''
-    f = _Cfunctions.get('libvlc_retain', None) or \
-        _Cfunction('libvlc_retain', ((1,),), None,
-                    None, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_add_intf(p_instance, name):
-    '''Try to start a user interface for the libvlc instance.
-    @param p_instance: the instance.
-    @param name: interface name, or None for default.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_add_intf', None) or \
-        _Cfunction('libvlc_add_intf', ((1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p)
-    return f(p_instance, name)
    
-
-
    [docs]def libvlc_wait(p_instance):
-    '''Waits until an interface causes the instance to exit.
-    You should start at least one interface first, using L{libvlc_add_intf}().
-    @param p_instance: the instance @warning This function wastes one thread doing basically nothing. libvlc_set_exit_handler() should be used instead.
-    '''
-    f = _Cfunctions.get('libvlc_wait', None) or \
-        _Cfunction('libvlc_wait', ((1,),), None,
-                    None, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_set_user_agent(p_instance, name, http):
-    '''Sets the application name. LibVLC passes this as the user agent string
-    when a protocol requires it.
-    @param p_instance: LibVLC instance.
-    @param name: human-readable application name, e.g. "FooBar player 1.2.3".
-    @param http: HTTP User Agent, e.g. "FooBar/1.2.3 Python/2.6.0".
-    @version: LibVLC 1.1.1 or later.
-    '''
-    f = _Cfunctions.get('libvlc_set_user_agent', None) or \
-        _Cfunction('libvlc_set_user_agent', ((1,), (1,), (1,),), None,
-                    None, Instance, ctypes.c_char_p, ctypes.c_char_p)
-    return f(p_instance, name, http)
    
-
-
    [docs]def libvlc_set_app_id(p_instance, id, version, icon):
-    '''Sets some meta-information about the application.
-    See also L{libvlc_set_user_agent}().
-    @param p_instance: LibVLC instance.
-    @param id: Java-style application identifier, e.g. "com.acme.foobar".
-    @param version: application version numbers, e.g. "1.2.3".
-    @param icon: application icon name, e.g. "foobar".
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_set_app_id', None) or \
-        _Cfunction('libvlc_set_app_id', ((1,), (1,), (1,), (1,),), None,
-                    None, Instance, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p)
-    return f(p_instance, id, version, icon)
    
-
-
    [docs]def libvlc_get_version():
-    '''Retrieve libvlc version.
-    Example: "1.1.0-git The Luggage".
-    @return: a string containing the libvlc version.
-    '''
-    f = _Cfunctions.get('libvlc_get_version', None) or \
-        _Cfunction('libvlc_get_version', (), None,
-                    ctypes.c_char_p)
-    return f()
    
-
-
    [docs]def libvlc_get_compiler():
-    '''Retrieve libvlc compiler version.
-    Example: "gcc version 4.2.3 (Ubuntu 4.2.3-2ubuntu6)".
-    @return: a string containing the libvlc compiler version.
-    '''
-    f = _Cfunctions.get('libvlc_get_compiler', None) or \
-        _Cfunction('libvlc_get_compiler', (), None,
-                    ctypes.c_char_p)
-    return f()
    
-
-
    [docs]def libvlc_get_changeset():
-    '''Retrieve libvlc changeset.
-    Example: "aa9bce0bc4".
-    @return: a string containing the libvlc changeset.
-    '''
-    f = _Cfunctions.get('libvlc_get_changeset', None) or \
-        _Cfunction('libvlc_get_changeset', (), None,
-                    ctypes.c_char_p)
-    return f()
    
-
-def libvlc_free(ptr):
-    '''Frees an heap allocation returned by a LibVLC function.
-    If you know you're using the same underlying C run-time as the LibVLC
-    implementation, then you can call ANSI C free() directly instead.
-    @param ptr: the pointer.
-    '''
-    f = _Cfunctions.get('libvlc_free', None) or \
-        _Cfunction('libvlc_free', ((1,),), None,
-                    None, ctypes.c_void_p)
-    return f(ptr)
-
-
    [docs]def libvlc_event_attach(p_event_manager, i_event_type, f_callback, user_data):
-    '''Register for an event notification.
-    @param p_event_manager: the event manager to which you want to attach to. Generally it is obtained by vlc_my_object_event_manager() where my_object is the object you want to listen to.
-    @param i_event_type: the desired event to which we want to listen.
-    @param f_callback: the function to call when i_event_type occurs.
-    @param user_data: user provided data to carry with the event.
-    @return: 0 on success, ENOMEM on error.
-    '''
-    f = _Cfunctions.get('libvlc_event_attach', None) or \
-        _Cfunction('libvlc_event_attach', ((1,), (1,), (1,), (1,),), None,
-                    ctypes.c_int, EventManager, ctypes.c_uint, Callback, ctypes.c_void_p)
-    return f(p_event_manager, i_event_type, f_callback, user_data)
    
-
-
    [docs]def libvlc_event_detach(p_event_manager, i_event_type, f_callback, p_user_data):
-    '''Unregister an event notification.
-    @param p_event_manager: the event manager.
-    @param i_event_type: the desired event to which we want to unregister.
-    @param f_callback: the function to call when i_event_type occurs.
-    @param p_user_data: user provided data to carry with the event.
-    '''
-    f = _Cfunctions.get('libvlc_event_detach', None) or \
-        _Cfunction('libvlc_event_detach', ((1,), (1,), (1,), (1,),), None,
-                    None, EventManager, ctypes.c_uint, Callback, ctypes.c_void_p)
-    return f(p_event_manager, i_event_type, f_callback, p_user_data)
    
-
-
    [docs]def libvlc_event_type_name(event_type):
-    '''Get an event's type name.
-    @param event_type: the desired event.
-    '''
-    f = _Cfunctions.get('libvlc_event_type_name', None) or \
-        _Cfunction('libvlc_event_type_name', ((1,),), None,
-                    ctypes.c_char_p, ctypes.c_uint)
-    return f(event_type)
    
-
-
    [docs]def libvlc_log_get_context(ctx):
-    '''Gets debugging information about a log message: the name of the VLC module
-    emitting the message and the message location within the source code.
-    The returned module name and file name will be None if unknown.
-    The returned line number will similarly be zero if unknown.
-    @param ctx: message context (as passed to the @ref libvlc_log_cb callback).
-    @return: module module name storage (or None), file source code file name storage (or None), line source code file line number storage (or None).
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_log_get_context', None) or \
-        _Cfunction('libvlc_log_get_context', ((1,), (2,), (2,), (2,),), None,
-                    None, Log_ptr, ListPOINTER(ctypes.c_char_p), ListPOINTER(ctypes.c_char_p), ctypes.POINTER(ctypes.c_uint))
-    return f(ctx)
    
-
-
    [docs]def libvlc_log_get_object(ctx, id):
-    '''Gets VLC object information about a log message: the type name of the VLC
-    object emitting the message, the object header if any and a temporaly-unique
-    object identifier. This information is mainly meant for B{manual}
-    troubleshooting.
-    The returned type name may be "generic" if unknown, but it cannot be None.
-    The returned header will be None if unset; in current versions, the header
-    is used to distinguish for VLM inputs.
-    The returned object ID will be zero if the message is not associated with
-    any VLC object.
-    @param ctx: message context (as passed to the @ref libvlc_log_cb callback).
-    @return: name object name storage (or None), header object header (or None), line source code file line number storage (or None).
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_log_get_object', None) or \
-        _Cfunction('libvlc_log_get_object', ((1,), (2,), (2,), (1,),), None,
-                    None, Log_ptr, ListPOINTER(ctypes.c_char_p), ListPOINTER(ctypes.c_char_p), ctypes.POINTER(ctypes.c_uint))
-    return f(ctx, id)
    
-
-
    [docs]def libvlc_log_unset(p_instance):
-    '''Unsets the logging callback for a LibVLC instance. This is rarely needed:
-    the callback is implicitly unset when the instance is destroyed.
-    This function will wait for any pending callbacks invocation to complete
-    (causing a deadlock if called from within the callback).
-    @param p_instance: libvlc instance.
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_log_unset', None) or \
-        _Cfunction('libvlc_log_unset', ((1,),), None,
-                    None, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_log_set(cb, data, p_instance):
-    '''Sets the logging callback for a LibVLC instance.
-    This function is thread-safe: it will wait for any pending callbacks
-    invocation to complete.
-    @param cb: callback function pointer.
-    @param data: opaque data pointer for the callback function @note Some log messages (especially debug) are emitted by LibVLC while is being initialized. These messages cannot be captured with this interface. @warning A deadlock may occur if this function is called from the callback.
-    @param p_instance: libvlc instance.
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_log_set', None) or \
-        _Cfunction('libvlc_log_set', ((1,), (1,), (1,),), None,
-                    None, Instance, LogCb, ctypes.c_void_p)
-    return f(cb, data, p_instance)
    
-
-
    [docs]def libvlc_log_set_file(p_instance, stream):
-    '''Sets up logging to a file.
-    @param p_instance: libvlc instance.
-    @param stream: FILE pointer opened for writing (the FILE pointer must remain valid until L{libvlc_log_unset}()).
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_log_set_file', None) or \
-        _Cfunction('libvlc_log_set_file', ((1,), (1,),), None,
-                    None, Instance, FILE_ptr)
-    return f(p_instance, stream)
    
-
-
    [docs]def libvlc_get_log_verbosity(p_instance):
-    '''Always returns minus one.
-    This function is only provided for backward compatibility.
-    @param p_instance: ignored.
-    @return: always -1.
-    '''
-    f = _Cfunctions.get('libvlc_get_log_verbosity', None) or \
-        _Cfunction('libvlc_get_log_verbosity', ((1,),), None,
-                    ctypes.c_uint, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_set_log_verbosity(p_instance, level):
-    '''This function does nothing.
-    It is only provided for backward compatibility.
-    @param p_instance: ignored.
-    @param level: ignored.
-    '''
-    f = _Cfunctions.get('libvlc_set_log_verbosity', None) or \
-        _Cfunction('libvlc_set_log_verbosity', ((1,), (1,),), None,
-                    None, Instance, ctypes.c_uint)
-    return f(p_instance, level)
    
-
-
    [docs]def libvlc_log_open(p_instance):
-    '''This function does nothing useful.
-    It is only provided for backward compatibility.
-    @param p_instance: libvlc instance.
-    @return: an unique pointer or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_log_open', None) or \
-        _Cfunction('libvlc_log_open', ((1,),), None,
-                    Log_ptr, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_log_close(p_log):
-    '''Frees memory allocated by L{libvlc_log_open}().
-    @param p_log: libvlc log instance or None.
-    '''
-    f = _Cfunctions.get('libvlc_log_close', None) or \
-        _Cfunction('libvlc_log_close', ((1,),), None,
-                    None, Log_ptr)
-    return f(p_log)
    
-
-
    [docs]def libvlc_log_count(p_log):
-    '''Always returns zero.
-    This function is only provided for backward compatibility.
-    @param p_log: ignored.
-    @return: always zero.
-    '''
-    f = _Cfunctions.get('libvlc_log_count', None) or \
-        _Cfunction('libvlc_log_count', ((1,),), None,
-                    ctypes.c_uint, Log_ptr)
-    return f(p_log)
    
-
-
    [docs]def libvlc_log_clear(p_log):
-    '''This function does nothing.
-    It is only provided for backward compatibility.
-    @param p_log: ignored.
-    '''
-    f = _Cfunctions.get('libvlc_log_clear', None) or \
-        _Cfunction('libvlc_log_clear', ((1,),), None,
-                    None, Log_ptr)
-    return f(p_log)
    
-
-
    [docs]def libvlc_log_get_iterator(p_log):
-    '''This function does nothing useful.
-    It is only provided for backward compatibility.
-    @param p_log: ignored.
-    @return: an unique pointer or None on error or if the parameter was None.
-    '''
-    f = _Cfunctions.get('libvlc_log_get_iterator', None) or \
-        _Cfunction('libvlc_log_get_iterator', ((1,),), class_result(LogIterator),
-                    ctypes.c_void_p, Log_ptr)
-    return f(p_log)
    
-
-
    [docs]def libvlc_log_iterator_free(p_iter):
-    '''Frees memory allocated by L{libvlc_log_get_iterator}().
-    @param p_iter: libvlc log iterator or None.
-    '''
-    f = _Cfunctions.get('libvlc_log_iterator_free', None) or \
-        _Cfunction('libvlc_log_iterator_free', ((1,),), None,
-                    None, LogIterator)
-    return f(p_iter)
    
-
-
    [docs]def libvlc_log_iterator_has_next(p_iter):
-    '''Always returns zero.
-    This function is only provided for backward compatibility.
-    @param p_iter: ignored.
-    @return: always zero.
-    '''
-    f = _Cfunctions.get('libvlc_log_iterator_has_next', None) or \
-        _Cfunction('libvlc_log_iterator_has_next', ((1,),), None,
-                    ctypes.c_int, LogIterator)
-    return f(p_iter)
    
-
-
    [docs]def libvlc_log_iterator_next(p_iter, p_buf):
-    '''Always returns None.
-    This function is only provided for backward compatibility.
-    @param p_iter: libvlc log iterator or None.
-    @param p_buf: ignored.
-    @return: always None.
-    '''
-    f = _Cfunctions.get('libvlc_log_iterator_next', None) or \
-        _Cfunction('libvlc_log_iterator_next', ((1,), (1,),), None,
-                    ctypes.POINTER(LogMessage), LogIterator, ctypes.POINTER(LogMessage))
-    return f(p_iter, p_buf)
    
-
-
    [docs]def libvlc_module_description_list_release(p_list):
-    '''Release a list of module descriptions.
-    @param p_list: the list to be released.
-    '''
-    f = _Cfunctions.get('libvlc_module_description_list_release', None) or \
-        _Cfunction('libvlc_module_description_list_release', ((1,),), None,
-                    None, ctypes.POINTER(ModuleDescription))
-    return f(p_list)
    
-
-
    [docs]def libvlc_audio_filter_list_get(p_instance):
-    '''Returns a list of audio filters that are available.
-    @param p_instance: libvlc instance.
-    @return: a list of module descriptions. It should be freed with L{libvlc_module_description_list_release}(). In case of an error, None is returned. See L{ModuleDescription} See L{libvlc_module_description_list_release}.
-    '''
-    f = _Cfunctions.get('libvlc_audio_filter_list_get', None) or \
-        _Cfunction('libvlc_audio_filter_list_get', ((1,),), None,
-                    ctypes.POINTER(ModuleDescription), Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_video_filter_list_get(p_instance):
-    '''Returns a list of video filters that are available.
-    @param p_instance: libvlc instance.
-    @return: a list of module descriptions. It should be freed with L{libvlc_module_description_list_release}(). In case of an error, None is returned. See L{ModuleDescription} See L{libvlc_module_description_list_release}.
-    '''
-    f = _Cfunctions.get('libvlc_video_filter_list_get', None) or \
-        _Cfunction('libvlc_video_filter_list_get', ((1,),), None,
-                    ctypes.POINTER(ModuleDescription), Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_clock():
-    '''Return the current time as defined by LibVLC. The unit is the microsecond.
-    Time increases monotonically (regardless of time zone changes and RTC
-    adjustements).
-    The origin is arbitrary but consistent across the whole system
-    (e.g. the system uptim, the time since the system was booted).
-    @note: On systems that support it, the POSIX monotonic clock is used.
-    '''
-    f = _Cfunctions.get('libvlc_clock', None) or \
-        _Cfunction('libvlc_clock', (), None,
-                    ctypes.c_int64)
-    return f()
    
-
-
    [docs]def libvlc_media_discoverer_new_from_name(p_inst, psz_name):
-    '''Discover media service by name.
-    @param p_inst: libvlc instance.
-    @param psz_name: service name.
-    @return: media discover object or None in case of error.
-    '''
-    f = _Cfunctions.get('libvlc_media_discoverer_new_from_name', None) or \
-        _Cfunction('libvlc_media_discoverer_new_from_name', ((1,), (1,),), class_result(MediaDiscoverer),
-                    ctypes.c_void_p, Instance, ctypes.c_char_p)
-    return f(p_inst, psz_name)
    
-
-
    [docs]def libvlc_media_discoverer_release(p_mdis):
-    '''Release media discover object. If the reference count reaches 0, then
-    the object will be released.
-    @param p_mdis: media service discover object.
-    '''
-    f = _Cfunctions.get('libvlc_media_discoverer_release', None) or \
-        _Cfunction('libvlc_media_discoverer_release', ((1,),), None,
-                    None, MediaDiscoverer)
-    return f(p_mdis)
    
-
-
    [docs]def libvlc_media_discoverer_localized_name(p_mdis):
-    '''Get media service discover object its localized name.
-    @param p_mdis: media discover object.
-    @return: localized name.
-    '''
-    f = _Cfunctions.get('libvlc_media_discoverer_localized_name', None) or \
-        _Cfunction('libvlc_media_discoverer_localized_name', ((1,),), string_result,
-                    ctypes.c_void_p, MediaDiscoverer)
-    return f(p_mdis)
    
-
-
    [docs]def libvlc_media_discoverer_media_list(p_mdis):
-    '''Get media service discover media list.
-    @param p_mdis: media service discover object.
-    @return: list of media items.
-    '''
-    f = _Cfunctions.get('libvlc_media_discoverer_media_list', None) or \
-        _Cfunction('libvlc_media_discoverer_media_list', ((1,),), class_result(MediaList),
-                    ctypes.c_void_p, MediaDiscoverer)
-    return f(p_mdis)
    
-
-
    [docs]def libvlc_media_discoverer_event_manager(p_mdis):
-    '''Get event manager from media service discover object.
-    @param p_mdis: media service discover object.
-    @return: event manager object.
-    '''
-    f = _Cfunctions.get('libvlc_media_discoverer_event_manager', None) or \
-        _Cfunction('libvlc_media_discoverer_event_manager', ((1,),), class_result(EventManager),
-                    ctypes.c_void_p, MediaDiscoverer)
-    return f(p_mdis)
    
-
-
    [docs]def libvlc_media_discoverer_is_running(p_mdis):
-    '''Query if media service discover object is running.
-    @param p_mdis: media service discover object.
-    @return: true if running, false if not \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_discoverer_is_running', None) or \
-        _Cfunction('libvlc_media_discoverer_is_running', ((1,),), None,
-                    ctypes.c_int, MediaDiscoverer)
-    return f(p_mdis)
    
-
-
    [docs]def libvlc_media_library_new(p_instance):
-    '''Create an new Media Library object.
-    @param p_instance: the libvlc instance.
-    @return: a new object or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_library_new', None) or \
-        _Cfunction('libvlc_media_library_new', ((1,),), class_result(MediaLibrary),
-                    ctypes.c_void_p, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_media_library_release(p_mlib):
-    '''Release media library object. This functions decrements the
-    reference count of the media library object. If it reaches 0,
-    then the object will be released.
-    @param p_mlib: media library object.
-    '''
-    f = _Cfunctions.get('libvlc_media_library_release', None) or \
-        _Cfunction('libvlc_media_library_release', ((1,),), None,
-                    None, MediaLibrary)
-    return f(p_mlib)
    
-
-
    [docs]def libvlc_media_library_retain(p_mlib):
-    '''Retain a reference to a media library object. This function will
-    increment the reference counting for this object. Use
-    L{libvlc_media_library_release}() to decrement the reference count.
-    @param p_mlib: media library object.
-    '''
-    f = _Cfunctions.get('libvlc_media_library_retain', None) or \
-        _Cfunction('libvlc_media_library_retain', ((1,),), None,
-                    None, MediaLibrary)
-    return f(p_mlib)
    
-
-
    [docs]def libvlc_media_library_load(p_mlib):
-    '''Load media library.
-    @param p_mlib: media library object.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_library_load', None) or \
-        _Cfunction('libvlc_media_library_load', ((1,),), None,
-                    ctypes.c_int, MediaLibrary)
-    return f(p_mlib)
    
-
-
    [docs]def libvlc_media_library_media_list(p_mlib):
-    '''Get media library subitems.
-    @param p_mlib: media library object.
-    @return: media list subitems.
-    '''
-    f = _Cfunctions.get('libvlc_media_library_media_list', None) or \
-        _Cfunction('libvlc_media_library_media_list', ((1,),), class_result(MediaList),
-                    ctypes.c_void_p, MediaLibrary)
-    return f(p_mlib)
    
-
-
    [docs]def libvlc_vlm_release(p_instance):
-    '''Release the vlm instance related to the given L{Instance}.
-    @param p_instance: the instance.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_release', None) or \
-        _Cfunction('libvlc_vlm_release', ((1,),), None,
-                    None, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_vlm_add_broadcast(p_instance, psz_name, psz_input, psz_output, i_options, ppsz_options, b_enabled, b_loop):
-    '''Add a broadcast, with one input.
-    @param p_instance: the instance.
-    @param psz_name: the name of the new broadcast.
-    @param psz_input: the input MRL.
-    @param psz_output: the output MRL (the parameter to the "sout" variable).
-    @param i_options: number of additional options.
-    @param ppsz_options: additional options.
-    @param b_enabled: boolean for enabling the new broadcast.
-    @param b_loop: Should this broadcast be played in loop ?
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_add_broadcast', None) or \
-        _Cfunction('libvlc_vlm_add_broadcast', ((1,), (1,), (1,), (1,), (1,), (1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int, ListPOINTER(ctypes.c_char_p), ctypes.c_int, ctypes.c_int)
-    return f(p_instance, psz_name, psz_input, psz_output, i_options, ppsz_options, b_enabled, b_loop)
    
-
-
    [docs]def libvlc_vlm_add_vod(p_instance, psz_name, psz_input, i_options, ppsz_options, b_enabled, psz_mux):
-    '''Add a vod, with one input.
-    @param p_instance: the instance.
-    @param psz_name: the name of the new vod media.
-    @param psz_input: the input MRL.
-    @param i_options: number of additional options.
-    @param ppsz_options: additional options.
-    @param b_enabled: boolean for enabling the new vod.
-    @param psz_mux: the muxer of the vod media.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_add_vod', None) or \
-        _Cfunction('libvlc_vlm_add_vod', ((1,), (1,), (1,), (1,), (1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int, ListPOINTER(ctypes.c_char_p), ctypes.c_int, ctypes.c_char_p)
-    return f(p_instance, psz_name, psz_input, i_options, ppsz_options, b_enabled, psz_mux)
    
-
-
    [docs]def libvlc_vlm_del_media(p_instance, psz_name):
-    '''Delete a media (VOD or broadcast).
-    @param p_instance: the instance.
-    @param psz_name: the media to delete.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_del_media', None) or \
-        _Cfunction('libvlc_vlm_del_media', ((1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_vlm_set_enabled(p_instance, psz_name, b_enabled):
-    '''Enable or disable a media (VOD or broadcast).
-    @param p_instance: the instance.
-    @param psz_name: the media to work on.
-    @param b_enabled: the new status.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_set_enabled', None) or \
-        _Cfunction('libvlc_vlm_set_enabled', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, b_enabled)
    
-
-
    [docs]def libvlc_vlm_set_output(p_instance, psz_name, psz_output):
-    '''Set the output for a media.
-    @param p_instance: the instance.
-    @param psz_name: the media to work on.
-    @param psz_output: the output MRL (the parameter to the "sout" variable).
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_set_output', None) or \
-        _Cfunction('libvlc_vlm_set_output', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p)
-    return f(p_instance, psz_name, psz_output)
    
-
-
    [docs]def libvlc_vlm_set_input(p_instance, psz_name, psz_input):
-    '''Set a media's input MRL. This will delete all existing inputs and
-    add the specified one.
-    @param p_instance: the instance.
-    @param psz_name: the media to work on.
-    @param psz_input: the input MRL.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_set_input', None) or \
-        _Cfunction('libvlc_vlm_set_input', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p)
-    return f(p_instance, psz_name, psz_input)
    
-
-
    [docs]def libvlc_vlm_add_input(p_instance, psz_name, psz_input):
-    '''Add a media's input MRL. This will add the specified one.
-    @param p_instance: the instance.
-    @param psz_name: the media to work on.
-    @param psz_input: the input MRL.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_add_input', None) or \
-        _Cfunction('libvlc_vlm_add_input', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p)
-    return f(p_instance, psz_name, psz_input)
    
-
-
    [docs]def libvlc_vlm_set_loop(p_instance, psz_name, b_loop):
-    '''Set a media's loop status.
-    @param p_instance: the instance.
-    @param psz_name: the media to work on.
-    @param b_loop: the new status.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_set_loop', None) or \
-        _Cfunction('libvlc_vlm_set_loop', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, b_loop)
    
-
-
    [docs]def libvlc_vlm_set_mux(p_instance, psz_name, psz_mux):
-    '''Set a media's vod muxer.
-    @param p_instance: the instance.
-    @param psz_name: the media to work on.
-    @param psz_mux: the new muxer.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_set_mux', None) or \
-        _Cfunction('libvlc_vlm_set_mux', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p)
-    return f(p_instance, psz_name, psz_mux)
    
-
-
    [docs]def libvlc_vlm_change_media(p_instance, psz_name, psz_input, psz_output, i_options, ppsz_options, b_enabled, b_loop):
-    '''Edit the parameters of a media. This will delete all existing inputs and
-    add the specified one.
-    @param p_instance: the instance.
-    @param psz_name: the name of the new broadcast.
-    @param psz_input: the input MRL.
-    @param psz_output: the output MRL (the parameter to the "sout" variable).
-    @param i_options: number of additional options.
-    @param ppsz_options: additional options.
-    @param b_enabled: boolean for enabling the new broadcast.
-    @param b_loop: Should this broadcast be played in loop ?
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_change_media', None) or \
-        _Cfunction('libvlc_vlm_change_media', ((1,), (1,), (1,), (1,), (1,), (1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int, ListPOINTER(ctypes.c_char_p), ctypes.c_int, ctypes.c_int)
-    return f(p_instance, psz_name, psz_input, psz_output, i_options, ppsz_options, b_enabled, b_loop)
    
-
-
    [docs]def libvlc_vlm_play_media(p_instance, psz_name):
-    '''Play the named broadcast.
-    @param p_instance: the instance.
-    @param psz_name: the name of the broadcast.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_play_media', None) or \
-        _Cfunction('libvlc_vlm_play_media', ((1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_vlm_stop_media(p_instance, psz_name):
-    '''Stop the named broadcast.
-    @param p_instance: the instance.
-    @param psz_name: the name of the broadcast.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_stop_media', None) or \
-        _Cfunction('libvlc_vlm_stop_media', ((1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_vlm_pause_media(p_instance, psz_name):
-    '''Pause the named broadcast.
-    @param p_instance: the instance.
-    @param psz_name: the name of the broadcast.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_pause_media', None) or \
-        _Cfunction('libvlc_vlm_pause_media', ((1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_vlm_seek_media(p_instance, psz_name, f_percentage):
-    '''Seek in the named broadcast.
-    @param p_instance: the instance.
-    @param psz_name: the name of the broadcast.
-    @param f_percentage: the percentage to seek to.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_seek_media', None) or \
-        _Cfunction('libvlc_vlm_seek_media', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_float)
-    return f(p_instance, psz_name, f_percentage)
    
-
-
    [docs]def libvlc_vlm_show_media(p_instance, psz_name):
-    '''Return information about the named media as a JSON
-    string representation.
-    This function is mainly intended for debugging use,
-    if you want programmatic access to the state of
-    a vlm_media_instance_t, please use the corresponding
-    libvlc_vlm_get_media_instance_xxx -functions.
-    Currently there are no such functions available for
-    vlm_media_t though.
-    @param p_instance: the instance.
-    @param psz_name: the name of the media, if the name is an empty string, all media is described.
-    @return: string with information about named media, or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_show_media', None) or \
-        _Cfunction('libvlc_vlm_show_media', ((1,), (1,),), string_result,
-                    ctypes.c_void_p, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_position(p_instance, psz_name, i_instance):
-    '''Get vlm_media instance position by name or instance id.
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: position as float or -1. on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_position', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_position', ((1,), (1,), (1,),), None,
-                    ctypes.c_float, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_time(p_instance, psz_name, i_instance):
-    '''Get vlm_media instance time by name or instance id.
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: time as integer or -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_time', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_time', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_length(p_instance, psz_name, i_instance):
-    '''Get vlm_media instance length by name or instance id.
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: length of media item or -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_length', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_length', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_rate(p_instance, psz_name, i_instance):
-    '''Get vlm_media instance playback rate by name or instance id.
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: playback rate or -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_rate', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_rate', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_title(p_instance, psz_name, i_instance):
-    '''Get vlm_media instance title number by name or instance id.
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: title as number or -1 on error.
-    @bug: will always return 0.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_title', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_title', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_chapter(p_instance, psz_name, i_instance):
-    '''Get vlm_media instance chapter number by name or instance id.
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: chapter as number or -1 on error.
-    @bug: will always return 0.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_chapter', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_chapter', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_media_instance_seekable(p_instance, psz_name, i_instance):
-    '''Is libvlc instance seekable ?
-    @param p_instance: a libvlc instance.
-    @param psz_name: name of vlm media instance.
-    @param i_instance: instance id.
-    @return: 1 if seekable, 0 if not, -1 if media does not exist.
-    @bug: will always return 0.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_media_instance_seekable', None) or \
-        _Cfunction('libvlc_vlm_get_media_instance_seekable', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, i_instance)
    
-
-
    [docs]def libvlc_vlm_get_event_manager(p_instance):
-    '''Get libvlc_event_manager from a vlm media.
-    The p_event_manager is immutable, so you don't have to hold the lock.
-    @param p_instance: a libvlc instance.
-    @return: libvlc_event_manager.
-    '''
-    f = _Cfunctions.get('libvlc_vlm_get_event_manager', None) or \
-        _Cfunction('libvlc_vlm_get_event_manager', ((1,),), class_result(EventManager),
-                    ctypes.c_void_p, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_media_new_location(p_instance, psz_mrl):
-    '''Create a media with a certain given media resource location,
-    for instance a valid URL.
-    @note: To refer to a local file with this function,
-    the file://... URI syntax B{must} be used (see IETF RFC3986).
-    We recommend using L{libvlc_media_new_path}() instead when dealing with
-    local files.
-    See L{libvlc_media_release}.
-    @param p_instance: the instance.
-    @param psz_mrl: the media location.
-    @return: the newly created media or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_new_location', None) or \
-        _Cfunction('libvlc_media_new_location', ((1,), (1,),), class_result(Media),
-                    ctypes.c_void_p, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_mrl)
    
-
-
    [docs]def libvlc_media_new_path(p_instance, path):
-    '''Create a media for a certain file path.
-    See L{libvlc_media_release}.
-    @param p_instance: the instance.
-    @param path: local filesystem path.
-    @return: the newly created media or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_new_path', None) or \
-        _Cfunction('libvlc_media_new_path', ((1,), (1,),), class_result(Media),
-                    ctypes.c_void_p, Instance, ctypes.c_char_p)
-    return f(p_instance, path)
    
-
-
    [docs]def libvlc_media_new_fd(p_instance, fd):
-    '''Create a media for an already open file descriptor.
-    The file descriptor shall be open for reading (or reading and writing).
-    Regular file descriptors, pipe read descriptors and character device
-    descriptors (including TTYs) are supported on all platforms.
-    Block device descriptors are supported where available.
-    Directory descriptors are supported on systems that provide fdopendir().
-    Sockets are supported on all platforms where they are file descriptors,
-    i.e. all except Windows.
-    @note: This library will B{not} automatically close the file descriptor
-    under any circumstance. Nevertheless, a file descriptor can usually only be
-    rendered once in a media player. To render it a second time, the file
-    descriptor should probably be rewound to the beginning with lseek().
-    See L{libvlc_media_release}.
-    @param p_instance: the instance.
-    @param fd: open file descriptor.
-    @return: the newly created media or None on error.
-    @version: LibVLC 1.1.5 and later.
-    '''
-    f = _Cfunctions.get('libvlc_media_new_fd', None) or \
-        _Cfunction('libvlc_media_new_fd', ((1,), (1,),), class_result(Media),
-                    ctypes.c_void_p, Instance, ctypes.c_int)
-    return f(p_instance, fd)
    
-
-
    [docs]def libvlc_media_new_as_node(p_instance, psz_name):
-    '''Create a media as an empty node with a given name.
-    See L{libvlc_media_release}.
-    @param p_instance: the instance.
-    @param psz_name: the name of the node.
-    @return: the new empty media or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_new_as_node', None) or \
-        _Cfunction('libvlc_media_new_as_node', ((1,), (1,),), class_result(Media),
-                    ctypes.c_void_p, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_media_add_option(p_md, psz_options):
-    '''Add an option to the media.
-    This option will be used to determine how the media_player will
-    read the media. This allows to use VLC's advanced
-    reading/streaming options on a per-media basis.
-    @note: The options are listed in 'vlc --long-help' from the command line,
-    e.g. "-sout-all". Keep in mind that available options and their semantics
-    vary across LibVLC versions and builds.
-    @warning: Not all options affects L{Media} objects:
-    Specifically, due to architectural issues most audio and video options,
-    such as text renderer options, have no effects on an individual media.
-    These options must be set through L{libvlc_new}() instead.
-    @param p_md: the media descriptor.
-    @param psz_options: the options (as a string).
-    '''
-    f = _Cfunctions.get('libvlc_media_add_option', None) or \
-        _Cfunction('libvlc_media_add_option', ((1,), (1,),), None,
-                    None, Media, ctypes.c_char_p)
-    return f(p_md, psz_options)
    
-
-
    [docs]def libvlc_media_add_option_flag(p_md, psz_options, i_flags):
-    '''Add an option to the media with configurable flags.
-    This option will be used to determine how the media_player will
-    read the media. This allows to use VLC's advanced
-    reading/streaming options on a per-media basis.
-    The options are detailed in vlc --long-help, for instance
-    "--sout-all". Note that all options are not usable on medias:
-    specifically, due to architectural issues, video-related options
-    such as text renderer options cannot be set on a single media. They
-    must be set on the whole libvlc instance instead.
-    @param p_md: the media descriptor.
-    @param psz_options: the options (as a string).
-    @param i_flags: the flags for this option.
-    '''
-    f = _Cfunctions.get('libvlc_media_add_option_flag', None) or \
-        _Cfunction('libvlc_media_add_option_flag', ((1,), (1,), (1,),), None,
-                    None, Media, ctypes.c_char_p, ctypes.c_uint)
-    return f(p_md, psz_options, i_flags)
    
-
-
    [docs]def libvlc_media_retain(p_md):
-    '''Retain a reference to a media descriptor object (libvlc_media_t). Use
-    L{libvlc_media_release}() to decrement the reference count of a
-    media descriptor object.
-    @param p_md: the media descriptor.
-    '''
-    f = _Cfunctions.get('libvlc_media_retain', None) or \
-        _Cfunction('libvlc_media_retain', ((1,),), None,
-                    None, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_release(p_md):
-    '''Decrement the reference count of a media descriptor object. If the
-    reference count is 0, then L{libvlc_media_release}() will release the
-    media descriptor object. It will send out an libvlc_MediaFreed event
-    to all listeners. If the media descriptor object has been released it
-    should not be used again.
-    @param p_md: the media descriptor.
-    '''
-    f = _Cfunctions.get('libvlc_media_release', None) or \
-        _Cfunction('libvlc_media_release', ((1,),), None,
-                    None, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_get_mrl(p_md):
-    '''Get the media resource locator (mrl) from a media descriptor object.
-    @param p_md: a media descriptor object.
-    @return: string with mrl of media descriptor object.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_mrl', None) or \
-        _Cfunction('libvlc_media_get_mrl', ((1,),), string_result,
-                    ctypes.c_void_p, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_duplicate(p_md):
-    '''Duplicate a media descriptor object.
-    @param p_md: a media descriptor object.
-    '''
-    f = _Cfunctions.get('libvlc_media_duplicate', None) or \
-        _Cfunction('libvlc_media_duplicate', ((1,),), class_result(Media),
-                    ctypes.c_void_p, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_get_meta(p_md, e_meta):
-    '''Read the meta of the media.
-    If the media has not yet been parsed this will return None.
-    This methods automatically calls L{libvlc_media_parse_async}(), so after calling
-    it you may receive a libvlc_MediaMetaChanged event. If you prefer a synchronous
-    version ensure that you call L{libvlc_media_parse}() before get_meta().
-    See L{libvlc_media_parse}
-    See L{libvlc_media_parse_async}
-    See libvlc_MediaMetaChanged.
-    @param p_md: the media descriptor.
-    @param e_meta: the meta to read.
-    @return: the media's meta.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_meta', None) or \
-        _Cfunction('libvlc_media_get_meta', ((1,), (1,),), string_result,
-                    ctypes.c_void_p, Media, Meta)
-    return f(p_md, e_meta)
    
-
-
    [docs]def libvlc_media_set_meta(p_md, e_meta, psz_value):
-    '''Set the meta of the media (this function will not save the meta, call
-    L{libvlc_media_save_meta} in order to save the meta).
-    @param p_md: the media descriptor.
-    @param e_meta: the meta to write.
-    @param psz_value: the media's meta.
-    '''
-    f = _Cfunctions.get('libvlc_media_set_meta', None) or \
-        _Cfunction('libvlc_media_set_meta', ((1,), (1,), (1,),), None,
-                    None, Media, Meta, ctypes.c_char_p)
-    return f(p_md, e_meta, psz_value)
    
-
-
    [docs]def libvlc_media_save_meta(p_md):
-    '''Save the meta previously set.
-    @param p_md: the media desriptor.
-    @return: true if the write operation was successful.
-    '''
-    f = _Cfunctions.get('libvlc_media_save_meta', None) or \
-        _Cfunction('libvlc_media_save_meta', ((1,),), None,
-                    ctypes.c_int, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_get_state(p_md):
-    '''Get current state of media descriptor object. Possible media states
-    are defined in libvlc_structures.c ( libvlc_NothingSpecial=0,
-    libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused,
-    libvlc_Stopped, libvlc_Ended,
-    libvlc_Error).
-    See libvlc_state_t.
-    @param p_md: a media descriptor object.
-    @return: state of media descriptor object.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_state', None) or \
-        _Cfunction('libvlc_media_get_state', ((1,),), None,
-                    State, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_get_stats(p_md, p_stats):
-    '''Get the current statistics about the media.
-    @param p_md:: media descriptor object.
-    @param p_stats:: structure that contain the statistics about the media (this structure must be allocated by the caller).
-    @return: true if the statistics are available, false otherwise \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_stats', None) or \
-        _Cfunction('libvlc_media_get_stats', ((1,), (1,),), None,
-                    ctypes.c_int, Media, ctypes.POINTER(MediaStats))
-    return f(p_md, p_stats)
    
-
-
    [docs]def libvlc_media_subitems(p_md):
-    '''Get subitems of media descriptor object. This will increment
-    the reference count of supplied media descriptor object. Use
-    L{libvlc_media_list_release}() to decrement the reference counting.
-    @param p_md: media descriptor object.
-    @return: list of media descriptor subitems or None.
-    '''
-    f = _Cfunctions.get('libvlc_media_subitems', None) or \
-        _Cfunction('libvlc_media_subitems', ((1,),), class_result(MediaList),
-                    ctypes.c_void_p, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_event_manager(p_md):
-    '''Get event manager from media descriptor object.
-    NOTE: this function doesn't increment reference counting.
-    @param p_md: a media descriptor object.
-    @return: event manager object.
-    '''
-    f = _Cfunctions.get('libvlc_media_event_manager', None) or \
-        _Cfunction('libvlc_media_event_manager', ((1,),), class_result(EventManager),
-                    ctypes.c_void_p, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_get_duration(p_md):
-    '''Get duration (in ms) of media descriptor object item.
-    @param p_md: media descriptor object.
-    @return: duration of media item or -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_duration', None) or \
-        _Cfunction('libvlc_media_get_duration', ((1,),), None,
-                    ctypes.c_longlong, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_parse(p_md):
-    '''Parse a media.
-    This fetches (local) meta data and tracks information.
-    The method is synchronous.
-    See L{libvlc_media_parse_async}
-    See L{libvlc_media_get_meta}
-    See L{libvlc_media_get_tracks_info}.
-    @param p_md: media descriptor object.
-    '''
-    f = _Cfunctions.get('libvlc_media_parse', None) or \
-        _Cfunction('libvlc_media_parse', ((1,),), None,
-                    None, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_parse_async(p_md):
-    '''Parse a media.
-    This fetches (local) meta data and tracks information.
-    The method is the asynchronous of L{libvlc_media_parse}().
-    To track when this is over you can listen to libvlc_MediaParsedChanged
-    event. However if the media was already parsed you will not receive this
-    event.
-    See L{libvlc_media_parse}
-    See libvlc_MediaParsedChanged
-    See L{libvlc_media_get_meta}
-    See L{libvlc_media_get_tracks_info}.
-    @param p_md: media descriptor object.
-    '''
-    f = _Cfunctions.get('libvlc_media_parse_async', None) or \
-        _Cfunction('libvlc_media_parse_async', ((1,),), None,
-                    None, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_is_parsed(p_md):
-    '''Get Parsed status for media descriptor object.
-    See libvlc_MediaParsedChanged.
-    @param p_md: media descriptor object.
-    @return: true if media object has been parsed otherwise it returns false \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_is_parsed', None) or \
-        _Cfunction('libvlc_media_is_parsed', ((1,),), None,
-                    ctypes.c_int, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_set_user_data(p_md, p_new_user_data):
-    '''Sets media descriptor's user_data. user_data is specialized data
-    accessed by the host application, VLC.framework uses it as a pointer to
-    an native object that references a L{Media} pointer.
-    @param p_md: media descriptor object.
-    @param p_new_user_data: pointer to user data.
-    '''
-    f = _Cfunctions.get('libvlc_media_set_user_data', None) or \
-        _Cfunction('libvlc_media_set_user_data', ((1,), (1,),), None,
-                    None, Media, ctypes.c_void_p)
-    return f(p_md, p_new_user_data)
    
-
-
    [docs]def libvlc_media_get_user_data(p_md):
-    '''Get media descriptor's user_data. user_data is specialized data
-    accessed by the host application, VLC.framework uses it as a pointer to
-    an native object that references a L{Media} pointer.
-    @param p_md: media descriptor object.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_user_data', None) or \
-        _Cfunction('libvlc_media_get_user_data', ((1,),), None,
-                    ctypes.c_void_p, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_get_tracks_info(p_md):
-    '''Get media descriptor's elementary streams description
-    Note, you need to call L{libvlc_media_parse}() or play the media at least once
-    before calling this function.
-    Not doing this will result in an empty array.
-    \deprecated Use L{libvlc_media_tracks_get} instead.
-    @param p_md: media descriptor object.
-    @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed by the caller) [OUT].
-    @return: the number of Elementary Streams.
-    '''
-    f = _Cfunctions.get('libvlc_media_get_tracks_info', None) or \
-        _Cfunction('libvlc_media_get_tracks_info', ((1,), (2,),), None,
-                    ctypes.c_int, Media, ctypes.POINTER(ctypes.c_void_p))
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_tracks_get(p_md, tracks):
-    '''Get media descriptor's elementary streams description
-    Note, you need to call L{libvlc_media_parse}() or play the media at least once
-    before calling this function.
-    Not doing this will result in an empty array.
-    @param p_md: media descriptor object.
-    @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed with L{libvlc_media_tracks_release}.
-    @return: the number of Elementary Streams (zero on error).
-    @version: LibVLC 2.1.0 and later.
-    '''
-    f = _Cfunctions.get('libvlc_media_tracks_get', None) or \
-        _Cfunction('libvlc_media_tracks_get', ((1,), (1,),), None,
-                    ctypes.c_uint, Media, ctypes.POINTER(ctypes.POINTER(MediaTrack)))
-    return f(p_md, tracks)
    
-
-
    [docs]def libvlc_media_tracks_release(p_tracks, i_count):
-    '''Release media descriptor's elementary streams description array.
-    @param p_tracks: tracks info array to release.
-    @param i_count: number of elements in the array.
-    @version: LibVLC 2.1.0 and later.
-    '''
-    f = _Cfunctions.get('libvlc_media_tracks_release', None) or \
-        _Cfunction('libvlc_media_tracks_release', ((1,), (1,),), None,
-                    None, ctypes.POINTER(MediaTrack), ctypes.c_uint)
-    return f(p_tracks, i_count)
    
-
-
    [docs]def libvlc_media_list_new(p_instance):
-    '''Create an empty media list.
-    @param p_instance: libvlc instance.
-    @return: empty media list, or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_new', None) or \
-        _Cfunction('libvlc_media_list_new', ((1,),), class_result(MediaList),
-                    ctypes.c_void_p, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_media_list_release(p_ml):
-    '''Release media list created with L{libvlc_media_list_new}().
-    @param p_ml: a media list created with L{libvlc_media_list_new}().
-    '''
-    f = _Cfunctions.get('libvlc_media_list_release', None) or \
-        _Cfunction('libvlc_media_list_release', ((1,),), None,
-                    None, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_retain(p_ml):
-    '''Retain reference to a media list.
-    @param p_ml: a media list created with L{libvlc_media_list_new}().
-    '''
-    f = _Cfunctions.get('libvlc_media_list_retain', None) or \
-        _Cfunction('libvlc_media_list_retain', ((1,),), None,
-                    None, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_set_media(p_ml, p_md):
-    '''Associate media instance with this media list instance.
-    If another media instance was present it will be released.
-    The L{libvlc_media_list_lock} should NOT be held upon entering this function.
-    @param p_ml: a media list instance.
-    @param p_md: media instance to add.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_set_media', None) or \
-        _Cfunction('libvlc_media_list_set_media', ((1,), (1,),), None,
-                    None, MediaList, Media)
-    return f(p_ml, p_md)
    
-
-
    [docs]def libvlc_media_list_media(p_ml):
-    '''Get media instance from this media list instance. This action will increase
-    the refcount on the media instance.
-    The L{libvlc_media_list_lock} should NOT be held upon entering this function.
-    @param p_ml: a media list instance.
-    @return: media instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_media', None) or \
-        _Cfunction('libvlc_media_list_media', ((1,),), class_result(Media),
-                    ctypes.c_void_p, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_add_media(p_ml, p_md):
-    '''Add media instance to media list
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    @param p_md: a media instance.
-    @return: 0 on success, -1 if the media list is read-only.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_add_media', None) or \
-        _Cfunction('libvlc_media_list_add_media', ((1,), (1,),), None,
-                    ctypes.c_int, MediaList, Media)
-    return f(p_ml, p_md)
    
-
-
    [docs]def libvlc_media_list_insert_media(p_ml, p_md, i_pos):
-    '''Insert media instance in media list on a position
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    @param p_md: a media instance.
-    @param i_pos: position in array where to insert.
-    @return: 0 on success, -1 if the media list is read-only.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_insert_media', None) or \
-        _Cfunction('libvlc_media_list_insert_media', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, MediaList, Media, ctypes.c_int)
-    return f(p_ml, p_md, i_pos)
    
-
-
    [docs]def libvlc_media_list_remove_index(p_ml, i_pos):
-    '''Remove media instance from media list on a position
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    @param i_pos: position in array where to insert.
-    @return: 0 on success, -1 if the list is read-only or the item was not found.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_remove_index', None) or \
-        _Cfunction('libvlc_media_list_remove_index', ((1,), (1,),), None,
-                    ctypes.c_int, MediaList, ctypes.c_int)
-    return f(p_ml, i_pos)
    
-
-
    [docs]def libvlc_media_list_count(p_ml):
-    '''Get count on media list items
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    @return: number of items in media list.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_count', None) or \
-        _Cfunction('libvlc_media_list_count', ((1,),), None,
-                    ctypes.c_int, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_item_at_index(p_ml, i_pos):
-    '''List media instance in media list at a position
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    @param i_pos: position in array where to insert.
-    @return: media instance at position i_pos, or None if not found. In case of success, L{libvlc_media_retain}() is called to increase the refcount on the media.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_item_at_index', None) or \
-        _Cfunction('libvlc_media_list_item_at_index', ((1,), (1,),), class_result(Media),
-                    ctypes.c_void_p, MediaList, ctypes.c_int)
-    return f(p_ml, i_pos)
    
-
-
    [docs]def libvlc_media_list_index_of_item(p_ml, p_md):
-    '''Find index position of List media instance in media list.
-    Warning: the function will return the first matched position.
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    @param p_md: media instance.
-    @return: position of media instance or -1 if media not found.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_index_of_item', None) or \
-        _Cfunction('libvlc_media_list_index_of_item', ((1,), (1,),), None,
-                    ctypes.c_int, MediaList, Media)
-    return f(p_ml, p_md)
    
-
-
    [docs]def libvlc_media_list_is_readonly(p_ml):
-    '''This indicates if this media list is read-only from a user point of view.
-    @param p_ml: media list instance.
-    @return: 1 on readonly, 0 on readwrite \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_is_readonly', None) or \
-        _Cfunction('libvlc_media_list_is_readonly', ((1,),), None,
-                    ctypes.c_int, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_lock(p_ml):
-    '''Get lock on media list items.
-    @param p_ml: a media list instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_lock', None) or \
-        _Cfunction('libvlc_media_list_lock', ((1,),), None,
-                    None, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_unlock(p_ml):
-    '''Release lock on media list items
-    The L{libvlc_media_list_lock} should be held upon entering this function.
-    @param p_ml: a media list instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_unlock', None) or \
-        _Cfunction('libvlc_media_list_unlock', ((1,),), None,
-                    None, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_media_list_event_manager(p_ml):
-    '''Get libvlc_event_manager from this media list instance.
-    The p_event_manager is immutable, so you don't have to hold the lock.
-    @param p_ml: a media list instance.
-    @return: libvlc_event_manager.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_event_manager', None) or \
-        _Cfunction('libvlc_media_list_event_manager', ((1,),), class_result(EventManager),
-                    ctypes.c_void_p, MediaList)
-    return f(p_ml)
    
-
-
    [docs]def libvlc_playlist_play(p_instance, i_id, i_options, ppsz_options):
-    '''Start playing (if there is any item in the playlist).
-    Additionnal playlist item options can be specified for addition to the
-    item before it is played.
-    @param p_instance: the playlist instance.
-    @param i_id: the item to play. If this is a negative number, the next item will be selected. Otherwise, the item with the given ID will be played.
-    @param i_options: the number of options to add to the item.
-    @param ppsz_options: the options to add to the item.
-    '''
-    f = _Cfunctions.get('libvlc_playlist_play', None) or \
-        _Cfunction('libvlc_playlist_play', ((1,), (1,), (1,), (1,),), None,
-                    None, Instance, ctypes.c_int, ctypes.c_int, ListPOINTER(ctypes.c_char_p))
-    return f(p_instance, i_id, i_options, ppsz_options)
    
-
-
    [docs]def libvlc_media_player_new(p_libvlc_instance):
-    '''Create an empty Media Player object.
-    @param p_libvlc_instance: the libvlc instance in which the Media Player should be created.
-    @return: a new media player object, or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_new', None) or \
-        _Cfunction('libvlc_media_player_new', ((1,),), class_result(MediaPlayer),
-                    ctypes.c_void_p, Instance)
-    return f(p_libvlc_instance)
    
-
-
    [docs]def libvlc_media_player_new_from_media(p_md):
-    '''Create a Media Player object from a Media.
-    @param p_md: the media. Afterwards the p_md can be safely destroyed.
-    @return: a new media player object, or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_new_from_media', None) or \
-        _Cfunction('libvlc_media_player_new_from_media', ((1,),), class_result(MediaPlayer),
-                    ctypes.c_void_p, Media)
-    return f(p_md)
    
-
-
    [docs]def libvlc_media_player_release(p_mi):
-    '''Release a media_player after use
-    Decrement the reference count of a media player object. If the
-    reference count is 0, then L{libvlc_media_player_release}() will
-    release the media player object. If the media player object
-    has been released, then it should not be used again.
-    @param p_mi: the Media Player to free.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_release', None) or \
-        _Cfunction('libvlc_media_player_release', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_retain(p_mi):
-    '''Retain a reference to a media player object. Use
-    L{libvlc_media_player_release}() to decrement reference count.
-    @param p_mi: media player object.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_retain', None) or \
-        _Cfunction('libvlc_media_player_retain', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_media(p_mi, p_md):
-    '''Set the media that will be used by the media_player. If any,
-    previous md will be released.
-    @param p_mi: the Media Player.
-    @param p_md: the Media. Afterwards the p_md can be safely destroyed.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_media', None) or \
-        _Cfunction('libvlc_media_player_set_media', ((1,), (1,),), None,
-                    None, MediaPlayer, Media)
-    return f(p_mi, p_md)
    
-
-
    [docs]def libvlc_media_player_get_media(p_mi):
-    '''Get the media used by the media_player.
-    @param p_mi: the Media Player.
-    @return: the media associated with p_mi, or None if no media is associated.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_media', None) or \
-        _Cfunction('libvlc_media_player_get_media', ((1,),), class_result(Media),
-                    ctypes.c_void_p, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_event_manager(p_mi):
-    '''Get the Event Manager from which the media player send event.
-    @param p_mi: the Media Player.
-    @return: the event manager associated with p_mi.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_event_manager', None) or \
-        _Cfunction('libvlc_media_player_event_manager', ((1,),), class_result(EventManager),
-                    ctypes.c_void_p, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_is_playing(p_mi):
-    '''is_playing.
-    @param p_mi: the Media Player.
-    @return: 1 if the media player is playing, 0 otherwise \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_is_playing', None) or \
-        _Cfunction('libvlc_media_player_is_playing', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_play(p_mi):
-    '''Play.
-    @param p_mi: the Media Player.
-    @return: 0 if playback started (and was already started), or -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_play', None) or \
-        _Cfunction('libvlc_media_player_play', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_pause(mp, do_pause):
-    '''Pause or resume (no effect if there is no media).
-    @param mp: the Media Player.
-    @param do_pause: play/resume if zero, pause if non-zero.
-    @version: LibVLC 1.1.1 or later.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_pause', None) or \
-        _Cfunction('libvlc_media_player_set_pause', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_int)
-    return f(mp, do_pause)
    
-
-
    [docs]def libvlc_media_player_pause(p_mi):
-    '''Toggle pause (no effect if there is no media).
-    @param p_mi: the Media Player.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_pause', None) or \
-        _Cfunction('libvlc_media_player_pause', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_stop(p_mi):
-    '''Stop (no effect if there is no media).
-    @param p_mi: the Media Player.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_stop', None) or \
-        _Cfunction('libvlc_media_player_stop', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_callbacks(mp, lock, unlock, display, opaque):
-    '''Set callbacks and private data to render decoded video to a custom area
-    in memory.
-    Use L{libvlc_video_set_format}() or L{libvlc_video_set_format_callbacks}()
-    to configure the decoded format.
-    @param mp: the media player.
-    @param lock: callback to lock video memory (must not be None).
-    @param unlock: callback to unlock video memory (or None if not needed).
-    @param display: callback to display video (or None if not needed).
-    @param opaque: private pointer for the three callbacks (as first parameter).
-    @version: LibVLC 1.1.1 or later.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_callbacks', None) or \
-        _Cfunction('libvlc_video_set_callbacks', ((1,), (1,), (1,), (1,), (1,),), None,
-                    None, MediaPlayer, VideoLockCb, VideoUnlockCb, VideoDisplayCb, ctypes.c_void_p)
-    return f(mp, lock, unlock, display, opaque)
    
-
-
    [docs]def libvlc_video_set_format(mp, chroma, width, height, pitch):
-    '''Set decoded video chroma and dimensions.
-    This only works in combination with L{libvlc_video_set_callbacks}(),
-    and is mutually exclusive with L{libvlc_video_set_format_callbacks}().
-    @param mp: the media player.
-    @param chroma: a four-characters string identifying the chroma (e.g. "RV32" or "YUYV").
-    @param width: pixel width.
-    @param height: pixel height.
-    @param pitch: line pitch (in bytes).
-    @version: LibVLC 1.1.1 or later.
-    @bug: All pixel planes are expected to have the same pitch. To use the YCbCr color space with chrominance subsampling, consider using L{libvlc_video_set_format_callbacks}() instead.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_format', None) or \
-        _Cfunction('libvlc_video_set_format', ((1,), (1,), (1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint, ctypes.c_uint)
-    return f(mp, chroma, width, height, pitch)
    
-
-
    [docs]def libvlc_video_set_format_callbacks(mp, setup, cleanup):
-    '''Set decoded video chroma and dimensions. This only works in combination with
-    L{libvlc_video_set_callbacks}().
-    @param mp: the media player.
-    @param setup: callback to select the video format (cannot be None).
-    @param cleanup: callback to release any allocated resources (or None).
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_format_callbacks', None) or \
-        _Cfunction('libvlc_video_set_format_callbacks', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, VideoFormatCb, VideoCleanupCb)
-    return f(mp, setup, cleanup)
    
-
-
    [docs]def libvlc_media_player_set_nsobject(p_mi, drawable):
-    '''Set the NSView handler where the media player should render its video output.
-    Use the vout called "macosx".
-    The drawable is an NSObject that follow the VLCOpenGLVideoViewEmbedding
-    protocol:
-    @begincode
-    \@protocol VLCOpenGLVideoViewEmbedding <NSObject>
-    - (void)addVoutSubview:(NSView *)view;
-    - (void)removeVoutSubview:(NSView *)view;
-    \@end
-    @endcode
-    Or it can be an NSView object.
-    If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then
-    the following code should work:
-    @begincode
-    
-        NSView *video = [[NSView alloc] init];
-        QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent);
-        L{libvlc_media_player_set_nsobject}(mp, video);
-        [video release];
-    
-    @endcode
-    You can find a live example in VLCVideoView in VLCKit.framework.
-    @param p_mi: the Media Player.
-    @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_nsobject', None) or \
-        _Cfunction('libvlc_media_player_set_nsobject', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_void_p)
-    return f(p_mi, drawable)
    
-
-
    [docs]def libvlc_media_player_get_nsobject(p_mi):
-    '''Get the NSView handler previously set with L{libvlc_media_player_set_nsobject}().
-    @param p_mi: the Media Player.
-    @return: the NSView handler or 0 if none where set.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_nsobject', None) or \
-        _Cfunction('libvlc_media_player_get_nsobject', ((1,),), None,
-                    ctypes.c_void_p, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_agl(p_mi, drawable):
-    '''Set the agl handler where the media player should render its video output.
-    @param p_mi: the Media Player.
-    @param drawable: the agl handler.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_agl', None) or \
-        _Cfunction('libvlc_media_player_set_agl', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint32)
-    return f(p_mi, drawable)
    
-
-
    [docs]def libvlc_media_player_get_agl(p_mi):
-    '''Get the agl handler previously set with L{libvlc_media_player_set_agl}().
-    @param p_mi: the Media Player.
-    @return: the agl handler or 0 if none where set.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_agl', None) or \
-        _Cfunction('libvlc_media_player_get_agl', ((1,),), None,
-                    ctypes.c_uint32, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_xwindow(p_mi, drawable):
-    '''Set an X Window System drawable where the media player should render its
-    video output. If LibVLC was built without X11 output support, then this has
-    no effects.
-    The specified identifier must correspond to an existing Input/Output class
-    X11 window. Pixmaps are B{not} supported. The caller shall ensure that
-    the X11 server is the same as the one the VLC instance has been configured
-    with. This function must be called before video playback is started;
-    otherwise it will only take effect after playback stop and restart.
-    @param p_mi: the Media Player.
-    @param drawable: the ID of the X window.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_xwindow', None) or \
-        _Cfunction('libvlc_media_player_set_xwindow', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint32)
-    return f(p_mi, drawable)
    
-
-
    [docs]def libvlc_media_player_get_xwindow(p_mi):
-    '''Get the X Window System window identifier previously set with
-    L{libvlc_media_player_set_xwindow}(). Note that this will return the identifier
-    even if VLC is not currently using it (for instance if it is playing an
-    audio-only input).
-    @param p_mi: the Media Player.
-    @return: an X window ID, or 0 if none where set.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_xwindow', None) or \
-        _Cfunction('libvlc_media_player_get_xwindow', ((1,),), None,
-                    ctypes.c_uint32, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_hwnd(p_mi, drawable):
-    '''Set a Win32/Win64 API window handle (HWND) where the media player should
-    render its video output. If LibVLC was built without Win32/Win64 API output
-    support, then this has no effects.
-    @param p_mi: the Media Player.
-    @param drawable: windows handle of the drawable.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_hwnd', None) or \
-        _Cfunction('libvlc_media_player_set_hwnd', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_void_p)
-    return f(p_mi, drawable)
    
-
-
    [docs]def libvlc_media_player_get_hwnd(p_mi):
-    '''Get the Windows API window handle (HWND) previously set with
-    L{libvlc_media_player_set_hwnd}(). The handle will be returned even if LibVLC
-    is not currently outputting any video to it.
-    @param p_mi: the Media Player.
-    @return: a window handle or None if there are none.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_hwnd', None) or \
-        _Cfunction('libvlc_media_player_get_hwnd', ((1,),), None,
-                    ctypes.c_void_p, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_set_callbacks(mp, play, pause, resume, flush, drain, opaque):
-    '''Set callbacks and private data for decoded audio.
-    Use L{libvlc_audio_set_format}() or L{libvlc_audio_set_format_callbacks}()
-    to configure the decoded audio format.
-    @param mp: the media player.
-    @param play: callback to play audio samples (must not be None).
-    @param pause: callback to pause playback (or None to ignore).
-    @param resume: callback to resume playback (or None to ignore).
-    @param flush: callback to flush audio buffers (or None to ignore).
-    @param drain: callback to drain audio buffers (or None to ignore).
-    @param opaque: private pointer for the audio callbacks (as first parameter).
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_callbacks', None) or \
-        _Cfunction('libvlc_audio_set_callbacks', ((1,), (1,), (1,), (1,), (1,), (1,), (1,),), None,
-                    None, MediaPlayer, AudioPlayCb, AudioPauseCb, AudioResumeCb, AudioFlushCb, AudioDrainCb, ctypes.c_void_p)
-    return f(mp, play, pause, resume, flush, drain, opaque)
    
-
-
    [docs]def libvlc_audio_set_volume_callback(mp, set_volume):
-    '''Set callbacks and private data for decoded audio. This only works in
-    combination with L{libvlc_audio_set_callbacks}().
-    Use L{libvlc_audio_set_format}() or L{libvlc_audio_set_format_callbacks}()
-    to configure the decoded audio format.
-    @param mp: the media player.
-    @param set_volume: callback to apply audio volume, or None to apply volume in software.
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_volume_callback', None) or \
-        _Cfunction('libvlc_audio_set_volume_callback', ((1,), (1,),), None,
-                    None, MediaPlayer, AudioSetVolumeCb)
-    return f(mp, set_volume)
    
-
-
    [docs]def libvlc_audio_set_format_callbacks(mp, setup, cleanup):
-    '''Set decoded audio format. This only works in combination with
-    L{libvlc_audio_set_callbacks}().
-    @param mp: the media player.
-    @param setup: callback to select the audio format (cannot be None).
-    @param cleanup: callback to release any allocated resources (or None).
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_format_callbacks', None) or \
-        _Cfunction('libvlc_audio_set_format_callbacks', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, AudioSetupCb, AudioCleanupCb)
-    return f(mp, setup, cleanup)
    
-
-
    [docs]def libvlc_audio_set_format(mp, format, rate, channels):
-    '''Set decoded audio format.
-    This only works in combination with L{libvlc_audio_set_callbacks}(),
-    and is mutually exclusive with L{libvlc_audio_set_format_callbacks}().
-    @param mp: the media player.
-    @param format: a four-characters string identifying the sample format (e.g. "S16N" or "FL32").
-    @param rate: sample rate (expressed in Hz).
-    @param channels: channels count.
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_format', None) or \
-        _Cfunction('libvlc_audio_set_format', ((1,), (1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint)
-    return f(mp, format, rate, channels)
    
-
-
    [docs]def libvlc_media_player_get_length(p_mi):
-    '''Get the current movie length (in ms).
-    @param p_mi: the Media Player.
-    @return: the movie length (in ms), or -1 if there is no media.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_length', None) or \
-        _Cfunction('libvlc_media_player_get_length', ((1,),), None,
-                    ctypes.c_longlong, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_get_time(p_mi):
-    '''Get the current movie time (in ms).
-    @param p_mi: the Media Player.
-    @return: the movie time (in ms), or -1 if there is no media.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_time', None) or \
-        _Cfunction('libvlc_media_player_get_time', ((1,),), None,
-                    ctypes.c_longlong, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_time(p_mi, i_time):
-    '''Set the movie time (in ms). This has no effect if no media is being played.
-    Not all formats and protocols support this.
-    @param p_mi: the Media Player.
-    @param i_time: the movie time (in ms).
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_time', None) or \
-        _Cfunction('libvlc_media_player_set_time', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_longlong)
-    return f(p_mi, i_time)
    
-
-
    [docs]def libvlc_media_player_get_position(p_mi):
-    '''Get movie position as percentage between 0.0 and 1.0.
-    @param p_mi: the Media Player.
-    @return: movie position, or -1. in case of error.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_position', None) or \
-        _Cfunction('libvlc_media_player_get_position', ((1,),), None,
-                    ctypes.c_float, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_position(p_mi, f_pos):
-    '''Set movie position as percentage between 0.0 and 1.0.
-    This has no effect if playback is not enabled.
-    This might not work depending on the underlying input format and protocol.
-    @param p_mi: the Media Player.
-    @param f_pos: the position.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_position', None) or \
-        _Cfunction('libvlc_media_player_set_position', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_float)
-    return f(p_mi, f_pos)
    
-
-
    [docs]def libvlc_media_player_set_chapter(p_mi, i_chapter):
-    '''Set movie chapter (if applicable).
-    @param p_mi: the Media Player.
-    @param i_chapter: chapter number to play.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_chapter', None) or \
-        _Cfunction('libvlc_media_player_set_chapter', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_chapter)
    
-
-
    [docs]def libvlc_media_player_get_chapter(p_mi):
-    '''Get movie chapter.
-    @param p_mi: the Media Player.
-    @return: chapter number currently playing, or -1 if there is no media.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_chapter', None) or \
-        _Cfunction('libvlc_media_player_get_chapter', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_get_chapter_count(p_mi):
-    '''Get movie chapter count.
-    @param p_mi: the Media Player.
-    @return: number of chapters in movie, or -1.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_chapter_count', None) or \
-        _Cfunction('libvlc_media_player_get_chapter_count', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_will_play(p_mi):
-    '''Is the player able to play.
-    @param p_mi: the Media Player.
-    @return: boolean \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_will_play', None) or \
-        _Cfunction('libvlc_media_player_will_play', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_get_chapter_count_for_title(p_mi, i_title):
-    '''Get title chapter count.
-    @param p_mi: the Media Player.
-    @param i_title: title.
-    @return: number of chapters in title, or -1.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_chapter_count_for_title', None) or \
-        _Cfunction('libvlc_media_player_get_chapter_count_for_title', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_title)
    
-
-
    [docs]def libvlc_media_player_set_title(p_mi, i_title):
-    '''Set movie title.
-    @param p_mi: the Media Player.
-    @param i_title: title number to play.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_title', None) or \
-        _Cfunction('libvlc_media_player_set_title', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_title)
    
-
-
    [docs]def libvlc_media_player_get_title(p_mi):
-    '''Get movie title.
-    @param p_mi: the Media Player.
-    @return: title number currently playing, or -1.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_title', None) or \
-        _Cfunction('libvlc_media_player_get_title', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_get_title_count(p_mi):
-    '''Get movie title count.
-    @param p_mi: the Media Player.
-    @return: title number count, or -1.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_title_count', None) or \
-        _Cfunction('libvlc_media_player_get_title_count', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_previous_chapter(p_mi):
-    '''Set previous chapter (if applicable).
-    @param p_mi: the Media Player.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_previous_chapter', None) or \
-        _Cfunction('libvlc_media_player_previous_chapter', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_next_chapter(p_mi):
-    '''Set next chapter (if applicable).
-    @param p_mi: the Media Player.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_next_chapter', None) or \
-        _Cfunction('libvlc_media_player_next_chapter', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_get_rate(p_mi):
-    '''Get the requested movie play rate.
-    @warning: Depending on the underlying media, the requested rate may be
-    different from the real playback rate.
-    @param p_mi: the Media Player.
-    @return: movie play rate.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_rate', None) or \
-        _Cfunction('libvlc_media_player_get_rate', ((1,),), None,
-                    ctypes.c_float, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_set_rate(p_mi, rate):
-    '''Set movie play rate.
-    @param p_mi: the Media Player.
-    @param rate: movie play rate to set.
-    @return: -1 if an error was detected, 0 otherwise (but even then, it might not actually work depending on the underlying media protocol).
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_rate', None) or \
-        _Cfunction('libvlc_media_player_set_rate', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_float)
-    return f(p_mi, rate)
    
-
-
    [docs]def libvlc_media_player_get_state(p_mi):
-    '''Get current movie state.
-    @param p_mi: the Media Player.
-    @return: the current state of the media player (playing, paused, ...) See libvlc_state_t.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_state', None) or \
-        _Cfunction('libvlc_media_player_get_state', ((1,),), None,
-                    State, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_get_fps(p_mi):
-    '''Get movie fps rate.
-    @param p_mi: the Media Player.
-    @return: frames per second (fps) for this playing movie, or 0 if unspecified.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_get_fps', None) or \
-        _Cfunction('libvlc_media_player_get_fps', ((1,),), None,
-                    ctypes.c_float, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_has_vout(p_mi):
-    '''How many video outputs does this media player have?
-    @param p_mi: the media player.
-    @return: the number of video outputs.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_has_vout', None) or \
-        _Cfunction('libvlc_media_player_has_vout', ((1,),), None,
-                    ctypes.c_uint, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_is_seekable(p_mi):
-    '''Is this media player seekable?
-    @param p_mi: the media player.
-    @return: true if the media player can seek \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_is_seekable', None) or \
-        _Cfunction('libvlc_media_player_is_seekable', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_can_pause(p_mi):
-    '''Can this media player be paused?
-    @param p_mi: the media player.
-    @return: true if the media player can pause \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_can_pause', None) or \
-        _Cfunction('libvlc_media_player_can_pause', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_program_scrambled(p_mi):
-    '''Check if the current program is scrambled.
-    @param p_mi: the media player.
-    @return: true if the current program is scrambled \libvlc_return_bool.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_program_scrambled', None) or \
-        _Cfunction('libvlc_media_player_program_scrambled', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_next_frame(p_mi):
-    '''Display the next frame (if supported).
-    @param p_mi: the media player.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_next_frame', None) or \
-        _Cfunction('libvlc_media_player_next_frame', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_media_player_navigate(p_mi, navigate):
-    '''Navigate through DVD Menu.
-    @param p_mi: the Media Player.
-    @param navigate: the Navigation mode.
-    @version: libVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_navigate', None) or \
-        _Cfunction('libvlc_media_player_navigate', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, navigate)
    
-
-
    [docs]def libvlc_media_player_set_video_title_display(p_mi, position, timeout):
-    '''Set if, and how, the video title will be shown when media is played.
-    @param p_mi: the media player.
-    @param position: position at which to display the title, or libvlc_position_disable to prevent the title from being displayed.
-    @param timeout: title display timeout in milliseconds (ignored if libvlc_position_disable).
-    @version: libVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_video_title_display', None) or \
-        _Cfunction('libvlc_media_player_set_video_title_display', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, Position, ctypes.c_int)
-    return f(p_mi, position, timeout)
    
-
-
    [docs]def libvlc_track_description_list_release(p_track_description):
-    '''Release (free) L{TrackDescription}.
-    @param p_track_description: the structure to release.
-    '''
-    f = _Cfunctions.get('libvlc_track_description_list_release', None) or \
-        _Cfunction('libvlc_track_description_list_release', ((1,),), None,
-                    None, ctypes.POINTER(TrackDescription))
-    return f(p_track_description)
    
-
-
    [docs]def libvlc_track_description_release(p_track_description):
-    '''\deprecated Use L{libvlc_track_description_list_release} instead.
-    '''
-    f = _Cfunctions.get('libvlc_track_description_release', None) or \
-        _Cfunction('libvlc_track_description_release', ((1,),), None,
-                    None, ctypes.POINTER(TrackDescription))
-    return f(p_track_description)
    
-
-
    [docs]def libvlc_toggle_fullscreen(p_mi):
-    '''Toggle fullscreen status on non-embedded video outputs.
-    @warning: The same limitations applies to this function
-    as to L{libvlc_set_fullscreen}().
-    @param p_mi: the media player.
-    '''
-    f = _Cfunctions.get('libvlc_toggle_fullscreen', None) or \
-        _Cfunction('libvlc_toggle_fullscreen', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_set_fullscreen(p_mi, b_fullscreen):
-    '''Enable or disable fullscreen.
-    @warning: With most window managers, only a top-level windows can be in
-    full-screen mode. Hence, this function will not operate properly if
-    L{libvlc_media_player_set_xwindow}() was used to embed the video in a
-    non-top-level window. In that case, the embedding window must be reparented
-    to the root window B{before} fullscreen mode is enabled. You will want
-    to reparent it back to its normal parent when disabling fullscreen.
-    @param p_mi: the media player.
-    @param b_fullscreen: boolean for fullscreen status.
-    '''
-    f = _Cfunctions.get('libvlc_set_fullscreen', None) or \
-        _Cfunction('libvlc_set_fullscreen', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_int)
-    return f(p_mi, b_fullscreen)
    
-
-
    [docs]def libvlc_get_fullscreen(p_mi):
-    '''Get current fullscreen status.
-    @param p_mi: the media player.
-    @return: the fullscreen status (boolean) \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_get_fullscreen', None) or \
-        _Cfunction('libvlc_get_fullscreen', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_key_input(p_mi, on):
-    '''Enable or disable key press events handling, according to the LibVLC hotkeys
-    configuration. By default and for historical reasons, keyboard events are
-    handled by the LibVLC video widget.
-    @note: On X11, there can be only one subscriber for key press and mouse
-    click events per window. If your application has subscribed to those events
-    for the X window ID of the video widget, then LibVLC will not be able to
-    handle key presses and mouse clicks in any case.
-    @warning: This function is only implemented for X11 and Win32 at the moment.
-    @param p_mi: the media player.
-    @param on: true to handle key press events, false to ignore them.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_key_input', None) or \
-        _Cfunction('libvlc_video_set_key_input', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, on)
    
-
-
    [docs]def libvlc_video_set_mouse_input(p_mi, on):
-    '''Enable or disable mouse click events handling. By default, those events are
-    handled. This is needed for DVD menus to work, as well as a few video
-    filters such as "puzzle".
-    See L{libvlc_video_set_key_input}().
-    @warning: This function is only implemented for X11 and Win32 at the moment.
-    @param p_mi: the media player.
-    @param on: true to handle mouse click events, false to ignore them.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_mouse_input', None) or \
-        _Cfunction('libvlc_video_set_mouse_input', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, on)
    
-
-
    [docs]def libvlc_video_get_size(p_mi, num):
-    '''Get the pixel dimensions of a video.
-    @param p_mi: media player.
-    @param num: number of the video (starting from, and most commonly 0).
-    @return: px pixel width, py pixel height.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_size', None) or \
-        _Cfunction('libvlc_video_get_size', ((1,), (1,), (2,), (2,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint))
-    return f(p_mi, num)
    
-
-
    [docs]def libvlc_video_get_height(p_mi):
-    '''Get current video height.
-    \deprecated Use L{libvlc_video_get_size}() instead.
-    @param p_mi: the media player.
-    @return: the video pixel height or 0 if not applicable.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_height', None) or \
-        _Cfunction('libvlc_video_get_height', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_width(p_mi):
-    '''Get current video width.
-    \deprecated Use L{libvlc_video_get_size}() instead.
-    @param p_mi: the media player.
-    @return: the video pixel width or 0 if not applicable.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_width', None) or \
-        _Cfunction('libvlc_video_get_width', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_cursor(p_mi, num):
-    '''Get the mouse pointer coordinates over a video.
-    Coordinates are expressed in terms of the decoded video resolution,
-    B{not} in terms of pixels on the screen/viewport (to get the latter,
-    you can query your windowing system directly).
-    Either of the coordinates may be negative or larger than the corresponding
-    dimension of the video, if the cursor is outside the rendering area.
-    @warning: The coordinates may be out-of-date if the pointer is not located
-    on the video rendering area. LibVLC does not track the pointer if it is
-    outside of the video widget.
-    @note: LibVLC does not support multiple pointers (it does of course support
-    multiple input devices sharing the same pointer) at the moment.
-    @param p_mi: media player.
-    @param num: number of the video (starting from, and most commonly 0).
-    @return: px abscissa, py ordinate.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_cursor', None) or \
-        _Cfunction('libvlc_video_get_cursor', ((1,), (1,), (2,), (2,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_int), ctypes.POINTER(ctypes.c_int))
-    return f(p_mi, num)
    
-
-
    [docs]def libvlc_video_get_scale(p_mi):
-    '''Get the current video scaling factor.
-    See also L{libvlc_video_set_scale}().
-    @param p_mi: the media player.
-    @return: the currently configured zoom factor, or 0. if the video is set to fit to the output window/drawable automatically.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_scale', None) or \
-        _Cfunction('libvlc_video_get_scale', ((1,),), None,
-                    ctypes.c_float, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_scale(p_mi, f_factor):
-    '''Set the video scaling factor. That is the ratio of the number of pixels on
-    screen to the number of pixels in the original decoded video in each
-    dimension. Zero is a special value; it will adjust the video to the output
-    window/drawable (in windowed mode) or the entire screen.
-    Note that not all video outputs support scaling.
-    @param p_mi: the media player.
-    @param f_factor: the scaling factor, or zero.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_scale', None) or \
-        _Cfunction('libvlc_video_set_scale', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_float)
-    return f(p_mi, f_factor)
    
-
-
    [docs]def libvlc_video_get_aspect_ratio(p_mi):
-    '''Get current video aspect ratio.
-    @param p_mi: the media player.
-    @return: the video aspect ratio or None if unspecified (the result must be released with free() or L{libvlc_free}()).
-    '''
-    f = _Cfunctions.get('libvlc_video_get_aspect_ratio', None) or \
-        _Cfunction('libvlc_video_get_aspect_ratio', ((1,),), string_result,
-                    ctypes.c_void_p, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_aspect_ratio(p_mi, psz_aspect):
-    '''Set new video aspect ratio.
-    @param p_mi: the media player.
-    @param psz_aspect: new video aspect-ratio or None to reset to default @note Invalid aspect ratios are ignored.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_aspect_ratio', None) or \
-        _Cfunction('libvlc_video_set_aspect_ratio', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_char_p)
-    return f(p_mi, psz_aspect)
    
-
-
    [docs]def libvlc_video_get_spu(p_mi):
-    '''Get current video subtitle.
-    @param p_mi: the media player.
-    @return: the video subtitle selected, or -1 if none.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_spu', None) or \
-        _Cfunction('libvlc_video_get_spu', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_spu_count(p_mi):
-    '''Get the number of available video subtitles.
-    @param p_mi: the media player.
-    @return: the number of available video subtitles.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_spu_count', None) or \
-        _Cfunction('libvlc_video_get_spu_count', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_spu_description(p_mi):
-    '''Get the description of available video subtitles.
-    @param p_mi: the media player.
-    @return: list containing description of available video subtitles.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_spu_description', None) or \
-        _Cfunction('libvlc_video_get_spu_description', ((1,),), None,
-                    ctypes.POINTER(TrackDescription), MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_spu(p_mi, i_spu):
-    '''Set new video subtitle.
-    @param p_mi: the media player.
-    @param i_spu: video subtitle track to select (i_id from track description).
-    @return: 0 on success, -1 if out of range.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_spu', None) or \
-        _Cfunction('libvlc_video_set_spu', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_spu)
    
-
-
    [docs]def libvlc_video_set_subtitle_file(p_mi, psz_subtitle):
-    '''Set new video subtitle file.
-    @param p_mi: the media player.
-    @param psz_subtitle: new video subtitle file.
-    @return: the success status (boolean).
-    '''
-    f = _Cfunctions.get('libvlc_video_set_subtitle_file', None) or \
-        _Cfunction('libvlc_video_set_subtitle_file', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_char_p)
-    return f(p_mi, psz_subtitle)
    
-
-
    [docs]def libvlc_video_get_spu_delay(p_mi):
-    '''Get the current subtitle delay. Positive values means subtitles are being
-    displayed later, negative values earlier.
-    @param p_mi: media player.
-    @return: time (in microseconds) the display of subtitles is being delayed.
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_spu_delay', None) or \
-        _Cfunction('libvlc_video_get_spu_delay', ((1,),), None,
-                    ctypes.c_int64, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_spu_delay(p_mi, i_delay):
-    '''Set the subtitle delay. This affects the timing of when the subtitle will
-    be displayed. Positive values result in subtitles being displayed later,
-    while negative values will result in subtitles being displayed earlier.
-    The subtitle delay will be reset to zero each time the media changes.
-    @param p_mi: media player.
-    @param i_delay: time (in microseconds) the display of subtitles should be delayed.
-    @return: 0 on success, -1 on error.
-    @version: LibVLC 2.0.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_spu_delay', None) or \
-        _Cfunction('libvlc_video_set_spu_delay', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int64)
-    return f(p_mi, i_delay)
    
-
-
    [docs]def libvlc_video_get_title_description(p_mi):
-    '''Get the description of available titles.
-    @param p_mi: the media player.
-    @return: list containing description of available titles.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_title_description', None) or \
-        _Cfunction('libvlc_video_get_title_description', ((1,),), None,
-                    ctypes.POINTER(TrackDescription), MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_chapter_description(p_mi, i_title):
-    '''Get the description of available chapters for specific title.
-    @param p_mi: the media player.
-    @param i_title: selected title.
-    @return: list containing description of available chapter for title i_title.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_chapter_description', None) or \
-        _Cfunction('libvlc_video_get_chapter_description', ((1,), (1,),), None,
-                    ctypes.POINTER(TrackDescription), MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_title)
    
-
-
    [docs]def libvlc_video_get_crop_geometry(p_mi):
-    '''Get current crop filter geometry.
-    @param p_mi: the media player.
-    @return: the crop filter geometry or None if unset.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_crop_geometry', None) or \
-        _Cfunction('libvlc_video_get_crop_geometry', ((1,),), string_result,
-                    ctypes.c_void_p, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_crop_geometry(p_mi, psz_geometry):
-    '''Set new crop filter geometry.
-    @param p_mi: the media player.
-    @param psz_geometry: new crop filter geometry (None to unset).
-    '''
-    f = _Cfunctions.get('libvlc_video_set_crop_geometry', None) or \
-        _Cfunction('libvlc_video_set_crop_geometry', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_char_p)
-    return f(p_mi, psz_geometry)
    
-
-
    [docs]def libvlc_video_get_teletext(p_mi):
-    '''Get current teletext page requested.
-    @param p_mi: the media player.
-    @return: the current teletext page requested.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_teletext', None) or \
-        _Cfunction('libvlc_video_get_teletext', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_teletext(p_mi, i_page):
-    '''Set new teletext page to retrieve.
-    @param p_mi: the media player.
-    @param i_page: teletex page number requested.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_teletext', None) or \
-        _Cfunction('libvlc_video_set_teletext', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_page)
    
-
-
    [docs]def libvlc_toggle_teletext(p_mi):
-    '''Toggle teletext transparent status on video output.
-    @param p_mi: the media player.
-    '''
-    f = _Cfunctions.get('libvlc_toggle_teletext', None) or \
-        _Cfunction('libvlc_toggle_teletext', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_track_count(p_mi):
-    '''Get number of available video tracks.
-    @param p_mi: media player.
-    @return: the number of available video tracks (int).
-    '''
-    f = _Cfunctions.get('libvlc_video_get_track_count', None) or \
-        _Cfunction('libvlc_video_get_track_count', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_track_description(p_mi):
-    '''Get the description of available video tracks.
-    @param p_mi: media player.
-    @return: list with description of available video tracks, or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_track_description', None) or \
-        _Cfunction('libvlc_video_get_track_description', ((1,),), None,
-                    ctypes.POINTER(TrackDescription), MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_get_track(p_mi):
-    '''Get current video track.
-    @param p_mi: media player.
-    @return: the video track ID (int) or -1 if no active input.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_track', None) or \
-        _Cfunction('libvlc_video_get_track', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_video_set_track(p_mi, i_track):
-    '''Set video track.
-    @param p_mi: media player.
-    @param i_track: the track ID (i_id field from track description).
-    @return: 0 on success, -1 if out of range.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_track', None) or \
-        _Cfunction('libvlc_video_set_track', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_track)
    
-
-
    [docs]def libvlc_video_take_snapshot(p_mi, num, psz_filepath, i_width, i_height):
-    '''Take a snapshot of the current video window.
-    If i_width AND i_height is 0, original size is used.
-    If i_width XOR i_height is 0, original aspect-ratio is preserved.
-    @param p_mi: media player instance.
-    @param num: number of video output (typically 0 for the first/only one).
-    @param psz_filepath: the path where to save the screenshot to.
-    @param i_width: the snapshot's width.
-    @param i_height: the snapshot's height.
-    @return: 0 on success, -1 if the video was not found.
-    '''
-    f = _Cfunctions.get('libvlc_video_take_snapshot', None) or \
-        _Cfunction('libvlc_video_take_snapshot', ((1,), (1,), (1,), (1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.c_char_p, ctypes.c_int, ctypes.c_int)
-    return f(p_mi, num, psz_filepath, i_width, i_height)
    
-
-
    [docs]def libvlc_video_set_deinterlace(p_mi, psz_mode):
-    '''Enable or disable deinterlace filter.
-    @param p_mi: libvlc media player.
-    @param psz_mode: type of deinterlace filter, None to disable.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_deinterlace', None) or \
-        _Cfunction('libvlc_video_set_deinterlace', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_char_p)
-    return f(p_mi, psz_mode)
    
-
-
    [docs]def libvlc_video_get_marquee_int(p_mi, option):
-    '''Get an integer marquee option value.
-    @param p_mi: libvlc media player.
-    @param option: marq option to get See libvlc_video_marquee_int_option_t.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_marquee_int', None) or \
-        _Cfunction('libvlc_video_get_marquee_int', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, option)
    
-
-
    [docs]def libvlc_video_get_marquee_string(p_mi, option):
-    '''Get a string marquee option value.
-    @param p_mi: libvlc media player.
-    @param option: marq option to get See libvlc_video_marquee_string_option_t.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_marquee_string', None) or \
-        _Cfunction('libvlc_video_get_marquee_string', ((1,), (1,),), string_result,
-                    ctypes.c_void_p, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, option)
    
-
-
    [docs]def libvlc_video_set_marquee_int(p_mi, option, i_val):
-    '''Enable, disable or set an integer marquee option
-    Setting libvlc_marquee_Enable has the side effect of enabling (arg !0)
-    or disabling (arg 0) the marq filter.
-    @param p_mi: libvlc media player.
-    @param option: marq option to set See libvlc_video_marquee_int_option_t.
-    @param i_val: marq option value.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_marquee_int', None) or \
-        _Cfunction('libvlc_video_set_marquee_int', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint, ctypes.c_int)
-    return f(p_mi, option, i_val)
    
-
-
    [docs]def libvlc_video_set_marquee_string(p_mi, option, psz_text):
-    '''Set a marquee string option.
-    @param p_mi: libvlc media player.
-    @param option: marq option to set See libvlc_video_marquee_string_option_t.
-    @param psz_text: marq option value.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_marquee_string', None) or \
-        _Cfunction('libvlc_video_set_marquee_string', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p)
-    return f(p_mi, option, psz_text)
    
-
-
    [docs]def libvlc_video_get_logo_int(p_mi, option):
-    '''Get integer logo option.
-    @param p_mi: libvlc media player instance.
-    @param option: logo option to get, values of libvlc_video_logo_option_t.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_logo_int', None) or \
-        _Cfunction('libvlc_video_get_logo_int', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, option)
    
-
-
    [docs]def libvlc_video_set_logo_int(p_mi, option, value):
-    '''Set logo option as integer. Options that take a different type value
-    are ignored.
-    Passing libvlc_logo_enable as option value has the side effect of
-    starting (arg !0) or stopping (arg 0) the logo filter.
-    @param p_mi: libvlc media player instance.
-    @param option: logo option to set, values of libvlc_video_logo_option_t.
-    @param value: logo option value.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_logo_int', None) or \
-        _Cfunction('libvlc_video_set_logo_int', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint, ctypes.c_int)
-    return f(p_mi, option, value)
    
-
-
    [docs]def libvlc_video_set_logo_string(p_mi, option, psz_value):
-    '''Set logo option as string. Options that take a different type value
-    are ignored.
-    @param p_mi: libvlc media player instance.
-    @param option: logo option to set, values of libvlc_video_logo_option_t.
-    @param psz_value: logo option value.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_logo_string', None) or \
-        _Cfunction('libvlc_video_set_logo_string', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p)
-    return f(p_mi, option, psz_value)
    
-
-
    [docs]def libvlc_video_get_adjust_int(p_mi, option):
-    '''Get integer adjust option.
-    @param p_mi: libvlc media player instance.
-    @param option: adjust option to get, values of libvlc_video_adjust_option_t.
-    @version: LibVLC 1.1.1 and later.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_adjust_int', None) or \
-        _Cfunction('libvlc_video_get_adjust_int', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, option)
    
-
-
    [docs]def libvlc_video_set_adjust_int(p_mi, option, value):
-    '''Set adjust option as integer. Options that take a different type value
-    are ignored.
-    Passing libvlc_adjust_enable as option value has the side effect of
-    starting (arg !0) or stopping (arg 0) the adjust filter.
-    @param p_mi: libvlc media player instance.
-    @param option: adust option to set, values of libvlc_video_adjust_option_t.
-    @param value: adjust option value.
-    @version: LibVLC 1.1.1 and later.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_adjust_int', None) or \
-        _Cfunction('libvlc_video_set_adjust_int', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint, ctypes.c_int)
-    return f(p_mi, option, value)
    
-
-
    [docs]def libvlc_video_get_adjust_float(p_mi, option):
-    '''Get float adjust option.
-    @param p_mi: libvlc media player instance.
-    @param option: adjust option to get, values of libvlc_video_adjust_option_t.
-    @version: LibVLC 1.1.1 and later.
-    '''
-    f = _Cfunctions.get('libvlc_video_get_adjust_float', None) or \
-        _Cfunction('libvlc_video_get_adjust_float', ((1,), (1,),), None,
-                    ctypes.c_float, MediaPlayer, ctypes.c_uint)
-    return f(p_mi, option)
    
-
-
    [docs]def libvlc_video_set_adjust_float(p_mi, option, value):
-    '''Set adjust option as float. Options that take a different type value
-    are ignored.
-    @param p_mi: libvlc media player instance.
-    @param option: adust option to set, values of libvlc_video_adjust_option_t.
-    @param value: adjust option value.
-    @version: LibVLC 1.1.1 and later.
-    '''
-    f = _Cfunctions.get('libvlc_video_set_adjust_float', None) or \
-        _Cfunction('libvlc_video_set_adjust_float', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_uint, ctypes.c_float)
-    return f(p_mi, option, value)
    
-
-
    [docs]def libvlc_audio_output_list_get(p_instance):
-    '''Gets the list of available audio output modules.
-    @param p_instance: libvlc instance.
-    @return: list of available audio outputs. It must be freed it with In case of error, None is returned.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_list_get', None) or \
-        _Cfunction('libvlc_audio_output_list_get', ((1,),), None,
-                    ctypes.POINTER(AudioOutput), Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_audio_output_list_release(p_list):
-    '''Frees the list of available audio output modules.
-    @param p_list: list with audio outputs for release.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_list_release', None) or \
-        _Cfunction('libvlc_audio_output_list_release', ((1,),), None,
-                    None, ctypes.POINTER(AudioOutput))
-    return f(p_list)
    
-
-
    [docs]def libvlc_audio_output_set(p_mi, psz_name):
-    '''Selects an audio output module.
-    @note: Any change will take be effect only after playback is stopped and
-    restarted. Audio output cannot be changed while playing.
-    @param p_mi: media player.
-    @param psz_name: name of audio output, use psz_name of See L{AudioOutput}.
-    @return: 0 if function succeded, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_set', None) or \
-        _Cfunction('libvlc_audio_output_set', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_char_p)
-    return f(p_mi, psz_name)
    
-
-
    [docs]def libvlc_audio_output_device_count(p_instance, psz_name):
-    '''Backward compatibility stub. Do not use in new code.
-    Use L{libvlc_audio_output_device_list_get}() instead.
-    @param p_instance: vlc instance.
-    @param psz_name: name.
-    @return: always 0.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_count', None) or \
-        _Cfunction('libvlc_audio_output_device_count', ((1,), (1,),), None,
-                    ctypes.c_int, Instance, ctypes.c_char_p)
-    return f(p_instance, psz_name)
    
-
-
    [docs]def libvlc_audio_output_device_longname(p_instance, psz_name, int):
-    '''Backward compatibility stub. Do not use in new code.
-    Use L{libvlc_audio_output_device_list_get}() instead.
-    @param p_instance: vlc instance.
-    @param psz_name: name.
-    @param int: index.
-    @return: always None.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_longname', None) or \
-        _Cfunction('libvlc_audio_output_device_longname', ((1,), (1,), (1,),), string_result,
-                    ctypes.c_void_p, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, int)
    
-
-
    [docs]def libvlc_audio_output_device_id(p_instance, psz_name, int):
-    '''Backward compatibility stub. Do not use in new code.
-    Use L{libvlc_audio_output_device_list_get}() instead.
-    @param p_instance: vlc instance.
-    @param psz_name: name.
-    @param int: index.
-    @return: always None.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_id', None) or \
-        _Cfunction('libvlc_audio_output_device_id', ((1,), (1,), (1,),), string_result,
-                    ctypes.c_void_p, Instance, ctypes.c_char_p, ctypes.c_int)
-    return f(p_instance, psz_name, int)
    
-
-
    [docs]def libvlc_audio_output_device_enum(mp):
-    '''Gets a list of potential audio output devices,
-    See L{libvlc_audio_output_device_set}().
-    @note: Not all audio outputs support enumerating devices.
-    The audio output may be functional even if the list is empty (None).
-    @note: The list may not be exhaustive.
-    @warning: Some audio output devices in the list might not actually work in
-    some circumstances. By default, it is recommended to not specify any
-    explicit audio device.
-    @param mp: media player.
-    @return: A None-terminated linked list of potential audio output devices. It must be freed it with L{libvlc_audio_output_device_list_release}().
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_enum', None) or \
-        _Cfunction('libvlc_audio_output_device_enum', ((1,),), None,
-                    ctypes.POINTER(AudioOutputDevice), MediaPlayer)
-    return f(mp)
    
-
-
    [docs]def libvlc_audio_output_device_list_get(p_instance, aout):
-    '''Gets a list of audio output devices for a given audio output module,
-    See L{libvlc_audio_output_device_set}().
-    @note: Not all audio outputs support this. In particular, an empty (None)
-    list of devices does B{not} imply that the specified audio output does
-    not work.
-    @note: The list might not be exhaustive.
-    @warning: Some audio output devices in the list might not actually work in
-    some circumstances. By default, it is recommended to not specify any
-    explicit audio device.
-    @param p_instance: libvlc instance.
-    @param psz_aout: audio output name (as returned by L{libvlc_audio_output_list_get}()).
-    @return: A None-terminated linked list of potential audio output devices. It must be freed it with L{libvlc_audio_output_device_list_release}().
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_list_get', None) or \
-        _Cfunction('libvlc_audio_output_device_list_get', ((1,), (1,),), None,
-                    ctypes.POINTER(AudioOutputDevice), Instance, ctypes.c_char_p)
-    return f(p_instance, aout)
    
-
-
    [docs]def libvlc_audio_output_device_list_release(p_list):
-    '''Frees a list of available audio output devices.
-    @param p_list: list with audio outputs for release.
-    @version: LibVLC 2.1.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_list_release', None) or \
-        _Cfunction('libvlc_audio_output_device_list_release', ((1,),), None,
-                    None, ctypes.POINTER(AudioOutputDevice))
-    return f(p_list)
    
-
-
    [docs]def libvlc_audio_output_device_set(mp, module, device_id):
-    '''Configures an explicit audio output device.
-    If the module paramater is None, audio output will be moved to the device
-    specified by the device identifier string immediately. This is the
-    recommended usage.
-    A list of adequate potential device strings can be obtained with
-    L{libvlc_audio_output_device_enum}().
-    However passing None is supported in LibVLC version 2.2.0 and later only;
-    in earlier versions, this function would have no effects when the module
-    parameter was None.
-    If the module parameter is not None, the device parameter of the
-    corresponding audio output, if it exists, will be set to the specified
-    string. Note that some audio output modules do not have such a parameter
-    (notably MMDevice and PulseAudio).
-    A list of adequate potential device strings can be obtained with
-    L{libvlc_audio_output_device_list_get}().
-    @note: This function does not select the specified audio output plugin.
-    L{libvlc_audio_output_set}() is used for that purpose.
-    @warning: The syntax for the device parameter depends on the audio output.
-    Some audio output modules require further parameters (e.g. a channels map
-    in the case of ALSA).
-    @param mp: media player.
-    @param module: If None, current audio output module. if non-None, name of audio output module.
-    @param device_id: device identifier string.
-    @return: Nothing. Errors are ignored (this is a design bug).
-    '''
-    f = _Cfunctions.get('libvlc_audio_output_device_set', None) or \
-        _Cfunction('libvlc_audio_output_device_set', ((1,), (1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_char_p, ctypes.c_char_p)
-    return f(mp, module, device_id)
    
-
-
    [docs]def libvlc_audio_toggle_mute(p_mi):
-    '''Toggle mute status.
-    @param p_mi: media player @warning Toggling mute atomically is not always possible: On some platforms, other processes can mute the VLC audio playback stream asynchronously. Thus, there is a small race condition where toggling will not work. See also the limitations of L{libvlc_audio_set_mute}().
-    '''
-    f = _Cfunctions.get('libvlc_audio_toggle_mute', None) or \
-        _Cfunction('libvlc_audio_toggle_mute', ((1,),), None,
-                    None, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_get_mute(p_mi):
-    '''Get current mute status.
-    @param p_mi: media player.
-    @return: the mute status (boolean) if defined, -1 if undefined/unapplicable.
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_mute', None) or \
-        _Cfunction('libvlc_audio_get_mute', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_set_mute(p_mi, status):
-    '''Set mute status.
-    @param p_mi: media player.
-    @param status: If status is true then mute, otherwise unmute @warning This function does not always work. If there are no active audio playback stream, the mute status might not be available. If digital pass-through (S/PDIF, HDMI...) is in use, muting may be unapplicable. Also some audio output plugins do not support muting at all. @note To force silent playback, disable all audio tracks. This is more efficient and reliable than mute.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_mute', None) or \
-        _Cfunction('libvlc_audio_set_mute', ((1,), (1,),), None,
-                    None, MediaPlayer, ctypes.c_int)
-    return f(p_mi, status)
    
-
-
    [docs]def libvlc_audio_get_volume(p_mi):
-    '''Get current software audio volume.
-    @param p_mi: media player.
-    @return: the software volume in percents (0 = mute, 100 = nominal / 0dB).
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_volume', None) or \
-        _Cfunction('libvlc_audio_get_volume', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_set_volume(p_mi, i_volume):
-    '''Set current software audio volume.
-    @param p_mi: media player.
-    @param i_volume: the volume in percents (0 = mute, 100 = 0dB).
-    @return: 0 if the volume was set, -1 if it was out of range.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_volume', None) or \
-        _Cfunction('libvlc_audio_set_volume', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_volume)
    
-
-
    [docs]def libvlc_audio_get_track_count(p_mi):
-    '''Get number of available audio tracks.
-    @param p_mi: media player.
-    @return: the number of available audio tracks (int), or -1 if unavailable.
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_track_count', None) or \
-        _Cfunction('libvlc_audio_get_track_count', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_get_track_description(p_mi):
-    '''Get the description of available audio tracks.
-    @param p_mi: media player.
-    @return: list with description of available audio tracks, or None.
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_track_description', None) or \
-        _Cfunction('libvlc_audio_get_track_description', ((1,),), None,
-                    ctypes.POINTER(TrackDescription), MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_get_track(p_mi):
-    '''Get current audio track.
-    @param p_mi: media player.
-    @return: the audio track ID or -1 if no active input.
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_track', None) or \
-        _Cfunction('libvlc_audio_get_track', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_set_track(p_mi, i_track):
-    '''Set current audio track.
-    @param p_mi: media player.
-    @param i_track: the track ID (i_id field from track description).
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_track', None) or \
-        _Cfunction('libvlc_audio_set_track', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int)
-    return f(p_mi, i_track)
    
-
-
    [docs]def libvlc_audio_get_channel(p_mi):
-    '''Get current audio channel.
-    @param p_mi: media player.
-    @return: the audio channel See libvlc_audio_output_channel_t.
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_channel', None) or \
-        _Cfunction('libvlc_audio_get_channel', ((1,),), None,
-                    ctypes.c_int, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_set_channel(p_mi, channel):
-    '''Set current audio channel.
-    @param p_mi: media player.
-    @param channel: the audio channel, See libvlc_audio_output_channel_t.
-    @return: 0 on success, -1 on error.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_channel', None) or \
-        _Cfunction('libvlc_audio_set_channel', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int)
-    return f(p_mi, channel)
    
-
-
    [docs]def libvlc_audio_get_delay(p_mi):
-    '''Get current audio delay.
-    @param p_mi: media player.
-    @return: the audio delay (microseconds).
-    @version: LibVLC 1.1.1 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_get_delay', None) or \
-        _Cfunction('libvlc_audio_get_delay', ((1,),), None,
-                    ctypes.c_int64, MediaPlayer)
-    return f(p_mi)
    
-
-
    [docs]def libvlc_audio_set_delay(p_mi, i_delay):
-    '''Set current audio delay. The audio delay will be reset to zero each time the media changes.
-    @param p_mi: media player.
-    @param i_delay: the audio delay (microseconds).
-    @return: 0 on success, -1 on error.
-    @version: LibVLC 1.1.1 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_set_delay', None) or \
-        _Cfunction('libvlc_audio_set_delay', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_int64)
-    return f(p_mi, i_delay)
    
-
-
    [docs]def libvlc_audio_equalizer_get_preset_count():
-    '''Get the number of equalizer presets.
-    @return: number of presets.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_get_preset_count', None) or \
-        _Cfunction('libvlc_audio_equalizer_get_preset_count', (), None,
-                    ctypes.c_uint)
-    return f()
    
-
-
    [docs]def libvlc_audio_equalizer_get_preset_name(u_index):
-    '''Get the name of a particular equalizer preset.
-    This name can be used, for example, to prepare a preset label or menu in a user
-    interface.
-    @param u_index: index of the preset, counting from zero.
-    @return: preset name, or None if there is no such preset.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_get_preset_name', None) or \
-        _Cfunction('libvlc_audio_equalizer_get_preset_name', ((1,),), None,
-                    ctypes.c_char_p, ctypes.c_uint)
-    return f(u_index)
    
-
-
    [docs]def libvlc_audio_equalizer_get_band_count():
-    '''Get the number of distinct frequency bands for an equalizer.
-    @return: number of frequency bands.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_get_band_count', None) or \
-        _Cfunction('libvlc_audio_equalizer_get_band_count', (), None,
-                    ctypes.c_uint)
-    return f()
    
-
-
    [docs]def libvlc_audio_equalizer_get_band_frequency(u_index):
-    '''Get a particular equalizer band frequency.
-    This value can be used, for example, to create a label for an equalizer band control
-    in a user interface.
-    @param u_index: index of the band, counting from zero.
-    @return: equalizer band frequency (Hz), or -1 if there is no such band.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_get_band_frequency', None) or \
-        _Cfunction('libvlc_audio_equalizer_get_band_frequency', ((1,),), None,
-                    ctypes.c_float, ctypes.c_uint)
-    return f(u_index)
    
-
-
    [docs]def libvlc_audio_equalizer_new():
-    '''Create a new default equalizer, with all frequency values zeroed.
-    The new equalizer can subsequently be applied to a media player by invoking
-    L{libvlc_media_player_set_equalizer}().
-    The returned handle should be freed via L{libvlc_audio_equalizer_release}() when
-    it is no longer needed.
-    @return: opaque equalizer handle, or None on error.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_new', None) or \
-        _Cfunction('libvlc_audio_equalizer_new', (), None,
-                    ctypes.c_void_p)
-    return f()
    
-
-
    [docs]def libvlc_audio_equalizer_new_from_preset(u_index):
-    '''Create a new equalizer, with initial frequency values copied from an existing
-    preset.
-    The new equalizer can subsequently be applied to a media player by invoking
-    L{libvlc_media_player_set_equalizer}().
-    The returned handle should be freed via L{libvlc_audio_equalizer_release}() when
-    it is no longer needed.
-    @param u_index: index of the preset, counting from zero.
-    @return: opaque equalizer handle, or None on error.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_new_from_preset', None) or \
-        _Cfunction('libvlc_audio_equalizer_new_from_preset', ((1,),), None,
-                    ctypes.c_void_p, ctypes.c_uint)
-    return f(u_index)
    
-
-
    [docs]def libvlc_audio_equalizer_release(p_equalizer):
-    '''Release a previously created equalizer instance.
-    The equalizer was previously created by using L{libvlc_audio_equalizer_new}() or
-    L{libvlc_audio_equalizer_new_from_preset}().
-    It is safe to invoke this method with a None p_equalizer parameter for no effect.
-    @param p_equalizer: opaque equalizer handle, or None.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_release', None) or \
-        _Cfunction('libvlc_audio_equalizer_release', ((1,),), None,
-                    None, ctypes.c_void_p)
-    return f(p_equalizer)
    
-
-
    [docs]def libvlc_audio_equalizer_set_preamp(p_equalizer, f_preamp):
-    '''Set a new pre-amplification value for an equalizer.
-    The new equalizer settings are subsequently applied to a media player by invoking
-    L{libvlc_media_player_set_equalizer}().
-    The supplied amplification value will be clamped to the -20.0 to +20.0 range.
-    @param p_equalizer: valid equalizer handle, must not be None.
-    @param f_preamp: preamp value (-20.0 to 20.0 Hz).
-    @return: zero on success, -1 on error.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_set_preamp', None) or \
-        _Cfunction('libvlc_audio_equalizer_set_preamp', ((1,), (1,),), None,
-                    ctypes.c_int, ctypes.c_void_p, ctypes.c_float)
-    return f(p_equalizer, f_preamp)
    
-
-
    [docs]def libvlc_audio_equalizer_get_preamp(p_equalizer):
-    '''Get the current pre-amplification value from an equalizer.
-    @param p_equalizer: valid equalizer handle, must not be None.
-    @return: preamp value (Hz).
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_get_preamp', None) or \
-        _Cfunction('libvlc_audio_equalizer_get_preamp', ((1,),), None,
-                    ctypes.c_float, ctypes.c_void_p)
-    return f(p_equalizer)
    
-
-
    [docs]def libvlc_audio_equalizer_set_amp_at_index(p_equalizer, f_amp, u_band):
-    '''Set a new amplification value for a particular equalizer frequency band.
-    The new equalizer settings are subsequently applied to a media player by invoking
-    L{libvlc_media_player_set_equalizer}().
-    The supplied amplification value will be clamped to the -20.0 to +20.0 range.
-    @param p_equalizer: valid equalizer handle, must not be None.
-    @param f_amp: amplification value (-20.0 to 20.0 Hz).
-    @param u_band: index, counting from zero, of the frequency band to set.
-    @return: zero on success, -1 on error.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_set_amp_at_index', None) or \
-        _Cfunction('libvlc_audio_equalizer_set_amp_at_index', ((1,), (1,), (1,),), None,
-                    ctypes.c_int, ctypes.c_void_p, ctypes.c_float, ctypes.c_uint)
-    return f(p_equalizer, f_amp, u_band)
    
-
-
    [docs]def libvlc_audio_equalizer_get_amp_at_index(p_equalizer, u_band):
-    '''Get the amplification value for a particular equalizer frequency band.
-    @param p_equalizer: valid equalizer handle, must not be None.
-    @param u_band: index, counting from zero, of the frequency band to get.
-    @return: amplification value (Hz); NaN if there is no such frequency band.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_audio_equalizer_get_amp_at_index', None) or \
-        _Cfunction('libvlc_audio_equalizer_get_amp_at_index', ((1,), (1,),), None,
-                    ctypes.c_float, ctypes.c_void_p, ctypes.c_uint)
-    return f(p_equalizer, u_band)
    
-
-
    [docs]def libvlc_media_player_set_equalizer(p_mi, p_equalizer):
-    '''Apply new equalizer settings to a media player.
-    The equalizer is first created by invoking L{libvlc_audio_equalizer_new}() or
-    L{libvlc_audio_equalizer_new_from_preset}().
-    It is possible to apply new equalizer settings to a media player whether the media
-    player is currently playing media or not.
-    Invoking this method will immediately apply the new equalizer settings to the audio
-    output of the currently playing media if there is any.
-    If there is no currently playing media, the new equalizer settings will be applied
-    later if and when new media is played.
-    Equalizer settings will automatically be applied to subsequently played media.
-    To disable the equalizer for a media player invoke this method passing None for the
-    p_equalizer parameter.
-    The media player does not keep a reference to the supplied equalizer so it is safe
-    for an application to release the equalizer reference any time after this method
-    returns.
-    @param p_mi: opaque media player handle.
-    @param p_equalizer: opaque equalizer handle, or None to disable the equalizer for this media player.
-    @return: zero on success, -1 on error.
-    @version: LibVLC 2.2.0 or later.
-    '''
-    f = _Cfunctions.get('libvlc_media_player_set_equalizer', None) or \
-        _Cfunction('libvlc_media_player_set_equalizer', ((1,), (1,),), None,
-                    ctypes.c_int, MediaPlayer, ctypes.c_void_p)
-    return f(p_mi, p_equalizer)
    
-
-
    [docs]def libvlc_media_list_player_new(p_instance):
-    '''Create new media_list_player.
-    @param p_instance: libvlc instance.
-    @return: media list player instance or None on error.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_new', None) or \
-        _Cfunction('libvlc_media_list_player_new', ((1,),), class_result(MediaListPlayer),
-                    ctypes.c_void_p, Instance)
-    return f(p_instance)
    
-
-
    [docs]def libvlc_media_list_player_release(p_mlp):
-    '''Release a media_list_player after use
-    Decrement the reference count of a media player object. If the
-    reference count is 0, then L{libvlc_media_list_player_release}() will
-    release the media player object. If the media player object
-    has been released, then it should not be used again.
-    @param p_mlp: media list player instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_release', None) or \
-        _Cfunction('libvlc_media_list_player_release', ((1,),), None,
-                    None, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_retain(p_mlp):
-    '''Retain a reference to a media player list object. Use
-    L{libvlc_media_list_player_release}() to decrement reference count.
-    @param p_mlp: media player list object.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_retain', None) or \
-        _Cfunction('libvlc_media_list_player_retain', ((1,),), None,
-                    None, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_event_manager(p_mlp):
-    '''Return the event manager of this media_list_player.
-    @param p_mlp: media list player instance.
-    @return: the event manager.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_event_manager', None) or \
-        _Cfunction('libvlc_media_list_player_event_manager', ((1,),), class_result(EventManager),
-                    ctypes.c_void_p, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_set_media_player(p_mlp, p_mi):
-    '''Replace media player in media_list_player with this instance.
-    @param p_mlp: media list player instance.
-    @param p_mi: media player instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_set_media_player', None) or \
-        _Cfunction('libvlc_media_list_player_set_media_player', ((1,), (1,),), None,
-                    None, MediaListPlayer, MediaPlayer)
-    return f(p_mlp, p_mi)
    
-
-
    [docs]def libvlc_media_list_player_set_media_list(p_mlp, p_mlist):
-    '''Set the media list associated with the player.
-    @param p_mlp: media list player instance.
-    @param p_mlist: list of media.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_set_media_list', None) or \
-        _Cfunction('libvlc_media_list_player_set_media_list', ((1,), (1,),), None,
-                    None, MediaListPlayer, MediaList)
-    return f(p_mlp, p_mlist)
    
-
-
    [docs]def libvlc_media_list_player_play(p_mlp):
-    '''Play media list.
-    @param p_mlp: media list player instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_play', None) or \
-        _Cfunction('libvlc_media_list_player_play', ((1,),), None,
-                    None, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_pause(p_mlp):
-    '''Toggle pause (or resume) media list.
-    @param p_mlp: media list player instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_pause', None) or \
-        _Cfunction('libvlc_media_list_player_pause', ((1,),), None,
-                    None, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_is_playing(p_mlp):
-    '''Is media list playing?
-    @param p_mlp: media list player instance.
-    @return: true for playing and false for not playing \libvlc_return_bool.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_is_playing', None) or \
-        _Cfunction('libvlc_media_list_player_is_playing', ((1,),), None,
-                    ctypes.c_int, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_get_state(p_mlp):
-    '''Get current libvlc_state of media list player.
-    @param p_mlp: media list player instance.
-    @return: libvlc_state_t for media list player.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_get_state', None) or \
-        _Cfunction('libvlc_media_list_player_get_state', ((1,),), None,
-                    State, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_play_item_at_index(p_mlp, i_index):
-    '''Play media list item at position index.
-    @param p_mlp: media list player instance.
-    @param i_index: index in media list to play.
-    @return: 0 upon success -1 if the item wasn't found.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_play_item_at_index', None) or \
-        _Cfunction('libvlc_media_list_player_play_item_at_index', ((1,), (1,),), None,
-                    ctypes.c_int, MediaListPlayer, ctypes.c_int)
-    return f(p_mlp, i_index)
    
-
-
    [docs]def libvlc_media_list_player_play_item(p_mlp, p_md):
-    '''Play the given media item.
-    @param p_mlp: media list player instance.
-    @param p_md: the media instance.
-    @return: 0 upon success, -1 if the media is not part of the media list.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_play_item', None) or \
-        _Cfunction('libvlc_media_list_player_play_item', ((1,), (1,),), None,
-                    ctypes.c_int, MediaListPlayer, Media)
-    return f(p_mlp, p_md)
    
-
-
    [docs]def libvlc_media_list_player_stop(p_mlp):
-    '''Stop playing media list.
-    @param p_mlp: media list player instance.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_stop', None) or \
-        _Cfunction('libvlc_media_list_player_stop', ((1,),), None,
-                    None, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_next(p_mlp):
-    '''Play next item from media list.
-    @param p_mlp: media list player instance.
-    @return: 0 upon success -1 if there is no next item.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_next', None) or \
-        _Cfunction('libvlc_media_list_player_next', ((1,),), None,
-                    ctypes.c_int, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_previous(p_mlp):
-    '''Play previous item from media list.
-    @param p_mlp: media list player instance.
-    @return: 0 upon success -1 if there is no previous item.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_previous', None) or \
-        _Cfunction('libvlc_media_list_player_previous', ((1,),), None,
-                    ctypes.c_int, MediaListPlayer)
-    return f(p_mlp)
    
-
-
    [docs]def libvlc_media_list_player_set_playback_mode(p_mlp, e_mode):
-    '''Sets the playback mode for the playlist.
-    @param p_mlp: media list player instance.
-    @param e_mode: playback mode specification.
-    '''
-    f = _Cfunctions.get('libvlc_media_list_player_set_playback_mode', None) or \
-        _Cfunction('libvlc_media_list_player_set_playback_mode', ((1,), (1,),), None,
-                    None, MediaListPlayer, PlaybackMode)
-    return f(p_mlp, e_mode)
    
-
-
-# 4 function(s) blacklisted:
-#  libvlc_audio_output_get_device_type
-#  libvlc_audio_output_set_device_type
-#  libvlc_printerr
-#  libvlc_set_exit_handler
-
-# 32 function(s) not wrapped as methods:
-#  libvlc_audio_equalizer_get_amp_at_index
-#  libvlc_audio_equalizer_get_band_count
-#  libvlc_audio_equalizer_get_band_frequency
-#  libvlc_audio_equalizer_get_preamp
-#  libvlc_audio_equalizer_get_preset_count
-#  libvlc_audio_equalizer_get_preset_name
-#  libvlc_audio_equalizer_new
-#  libvlc_audio_equalizer_new_from_preset
-#  libvlc_audio_equalizer_release
-#  libvlc_audio_equalizer_set_amp_at_index
-#  libvlc_audio_equalizer_set_preamp
-#  libvlc_audio_output_device_list_release
-#  libvlc_audio_output_list_release
-#  libvlc_clearerr
-#  libvlc_clock
-#  libvlc_event_type_name
-#  libvlc_free
-#  libvlc_get_changeset
-#  libvlc_get_compiler
-#  libvlc_get_version
-#  libvlc_log_clear
-#  libvlc_log_close
-#  libvlc_log_count
-#  libvlc_log_get_context
-#  libvlc_log_get_iterator
-#  libvlc_log_get_object
-#  libvlc_media_tracks_release
-#  libvlc_module_description_list_release
-#  libvlc_new
-#  libvlc_track_description_list_release
-#  libvlc_track_description_release
-#  libvlc_vprinterr
-
-# Start of footer.py #
-
-# Backward compatibility
-
    [docs]def callbackmethod(callback):
-    """Now obsolete @callbackmethod decorator."""
-    return callback
    
-
-# libvlc_free is not present in some versions of libvlc. If it is not
-# in the library, then emulate it by calling libc.free
-if not hasattr(dll, 'libvlc_free'):
-    # need to find the free function in the C runtime. This is
-    # platform specific.
-    # For Linux and MacOSX
-    libc_path = find_library('c')
-    if libc_path:
-        libc = ctypes.CDLL(libc_path)
-        libvlc_free = libc.free
-    else:
-        # On win32, it is impossible to guess the proper lib to call
-        # (msvcrt, mingw...). Just ignore the call: it will memleak,
-        # but not prevent to run the application.
-
    [docs]        def libvlc_free(p):
-            pass
    
-
-    # ensure argtypes is right, because default type of int won't
-    # work on 64-bit systems
-    libvlc_free.argtypes = [ ctypes.c_void_p ]
-
-# Version functions
-def _dot2int(v):
-    '''(INTERNAL) Convert 'i.i.i[.i]' str to int.
-    '''
-    t = [int(i) for i in v.split('.')]
-    if len(t) == 3:
-        t.append(0)
-    elif len(t) != 4:
-        raise ValueError('"i.i.i[.i]": %r' % (v,))
-    if min(t) < 0 or max(t) > 255:
-        raise ValueError('[0..255]: %r' % (v,))
-    i = t.pop(0)
-    while t:
-        i = (i << 8) + t.pop(0)
-    return i
-
-
    [docs]def hex_version():
-    """Return the version of these bindings in hex or 0 if unavailable.
-    """
-    try:
-        return _dot2int(__version__)
-    except (NameError, ValueError):
-        return 0
    
-
-
    [docs]def libvlc_hex_version():
-    """Return the libvlc version in hex or 0 if unavailable.
-    """
-    try:
-        return _dot2int(bytes_to_str(libvlc_get_version()).split()[0])
-    except ValueError:
-        return 0
    
-
-
    [docs]def debug_callback(event, *args, **kwds):
-    '''Example callback, useful for debugging.
-    '''
-    l = ['event %s' % (event.type,)]
-    if args:
-        l.extend(map(str, args))
-    if kwds:
-        l.extend(sorted('%s=%s' % t for t in kwds.items()))
-    print('Debug callback (%s)' % ', '.join(l))
    
-
-
-if __name__ == '__main__':
-    logging.basicConfig(level=logging.DEBUG)
-    try:
-        from msvcrt import getch
-    except ImportError:
-        import termios
-        import tty
-
-        def getch():  # getchar(), getc(stdin)  #PYCHOK flake
-            fd = sys.stdin.fileno()
-            old = termios.tcgetattr(fd)
-            try:
-                tty.setraw(fd)
-                ch = sys.stdin.read(1)
-            finally:
-                termios.tcsetattr(fd, termios.TCSADRAIN, old)
-            return ch
-
-    def end_callback(event):
-        print('End of media stream (event %s)' % event.type)
-        sys.exit(0)
-
-    echo_position = False
-    def pos_callback(event, player):
-        if echo_position:
-            sys.stdout.write('\r%s to %.2f%% (%.2f%%)' % (event.type,
-                                                          event.u.new_position * 100,
-                                                          player.get_position() * 100))
-            sys.stdout.flush()
-
-    def print_version():
-        """Print version of this vlc.py and of the libvlc"""
-        try:
-            print('Build date: %s (%#x)' % (build_date, hex_version()))
-            print('LibVLC version: %s (%#x)' % (bytes_to_str(libvlc_get_version()), libvlc_hex_version()))
-            print('LibVLC compiler: %s' % bytes_to_str(libvlc_get_compiler()))
-            if plugin_path:
-                print('Plugin path: %s' % plugin_path)
-        except:
-            print('Error: %s' % sys.exc_info()[1])
-
-    if sys.argv[1:] and '-h' not in sys.argv[1:] and '--help' not in sys.argv[1:]:
-
-        movie = os.path.expanduser(sys.argv.pop())
-        if not os.access(movie, os.R_OK):
-            print('Error: %s file not readable' % movie)
-            sys.exit(1)
-
-        # Need --sub-source=marq in order to use marquee below
-        instance = Instance(["--sub-source=marq"] + sys.argv[1:])
-        try:
-            media = instance.media_new(movie)
-        except (AttributeError, NameError) as e:
-            print('%s: %s (%s %s vs LibVLC %s)' % (e.__class__.__name__, e,
-                                                   sys.argv[0], __version__,
-                                                   libvlc_get_version()))
-            sys.exit(1)
-        player = instance.media_player_new()
-        player.set_media(media)
-        player.play()
-
-        # Some marquee examples.  Marquee requires '--sub-source marq' in the
-        # Instance() call above, see <http://www.videolan.org/doc/play-howto/en/ch04.html>
-        player.video_set_marquee_int(VideoMarqueeOption.Enable, 1)
-        player.video_set_marquee_int(VideoMarqueeOption.Size, 24)  # pixels
-        player.video_set_marquee_int(VideoMarqueeOption.Position, Position.Bottom)
-        if False:  # only one marquee can be specified
-            player.video_set_marquee_int(VideoMarqueeOption.Timeout, 5000)  # millisec, 0==forever
-            t = media.get_mrl()  # movie
-        else:  # update marquee text periodically
-            player.video_set_marquee_int(VideoMarqueeOption.Timeout, 0)  # millisec, 0==forever
-            player.video_set_marquee_int(VideoMarqueeOption.Refresh, 1000)  # millisec (or sec?)
-            ##t = '$L / $D or $P at $T'
-            t = '%Y-%m-%d  %H:%M:%S'
-        player.video_set_marquee_string(VideoMarqueeOption.Text, str_to_bytes(t))
-
-        # Some event manager examples.  Note, the callback can be any Python
-        # callable and does not need to be decorated.  Optionally, specify
-        # any number of positional and/or keyword arguments to be passed
-        # to the callback (in addition to the first one, an Event instance).
-        event_manager = player.event_manager()
-        event_manager.event_attach(EventType.MediaPlayerEndReached,      end_callback)
-        event_manager.event_attach(EventType.MediaPlayerPositionChanged, pos_callback, player)
-
-        def mspf():
-            """Milliseconds per frame"""
-            return int(1000 // (player.get_fps() or 25))
-
-        def print_info():
-            """Print information about the media"""
-            try:
-                print_version()
-                media = player.get_media()
-                print('State: %s' % player.get_state())
-                print('Media: %s' % bytes_to_str(media.get_mrl()))
-                print('Track: %s/%s' % (player.video_get_track(), player.video_get_track_count()))
-                print('Current time: %s/%s' % (player.get_time(), media.get_duration()))
-                print('Position: %s' % player.get_position())
-                print('FPS: %s (%d ms)' % (player.get_fps(), mspf()))
-                print('Rate: %s' % player.get_rate())
-                print('Video size: %s' % str(player.video_get_size(0)))  # num=0
-                print('Scale: %s' % player.video_get_scale())
-                print('Aspect ratio: %s' % player.video_get_aspect_ratio())
-               #print('Window:' % player.get_hwnd()
-            except Exception:
-                print('Error: %s' % sys.exc_info()[1])
-
-        def sec_forward():
-            """Go forward one sec"""
-            player.set_time(player.get_time() + 1000)
-
-        def sec_backward():
-            """Go backward one sec"""
-            player.set_time(player.get_time() - 1000)
-
-        def frame_forward():
-            """Go forward one frame"""
-            player.set_time(player.get_time() + mspf())
-
-        def frame_backward():
-            """Go backward one frame"""
-            player.set_time(player.get_time() - mspf())
-
-        def print_help():
-            """Print help"""
-            print('Single-character commands:')
-            for k, m in sorted(keybindings.items()):
-                m = (m.__doc__ or m.__name__).splitlines()[0]
-                print('  %s: %s.' % (k, m.rstrip('.')))
-            print('0-9: go to that fraction of the movie')
-
-        def quit_app():
-            """Stop and exit"""
-            sys.exit(0)
-
-        def toggle_echo_position():
-            """Toggle echoing of media position"""
-            global echo_position
-            echo_position = not echo_position
-
-        keybindings = {
-            ' ': player.pause,
-            '+': sec_forward,
-            '-': sec_backward,
-            '.': frame_forward,
-            ',': frame_backward,
-            'f': player.toggle_fullscreen,
-            'i': print_info,
-            'p': toggle_echo_position,
-            'q': quit_app,
-            '?': print_help,
-            }
-
-        print('Press q to quit, ? to get help.%s' % os.linesep)
-        while True:
-            k = getch()
-            print('> %s' % k)
-            if k in keybindings:
-                keybindings[k]()
-            elif k.isdigit():
-                 # jump to fraction of the movie.
-                player.set_position(float('0.'+k))
-
-    else:
-        print('Usage: %s [options] <movie_filename>' % sys.argv[0])
-        print('Once launched, type ? for help.')
-        print('')
-        print_version()
-
    
-
-           
    
-           
    
-            
-           
    
-          
    
-          
    
-  
-
-  
    
-
-  
    
-    
    
-        © Copyright 2009-2011, Thomas Jost; 2015-2017 Cimbali.
-
-    
    
-  
    
-  Built with Sphinx using a theme provided by Read the Docs. 
-
-
    
-
-        
    
-      
    
-
-    
    
-
-  
    
-  
-
-
-  
-
-    
-      
-      
-      
-
-  
-
-  
-  
-    
-  
-
-  
-  
-  
-   
-
-
-
\ No newline at end of file
diff --git a/docs/_sources/README.md.txt b/docs/_sources/README.md.txt
index 27658bec..5bc8bc45 100644
--- a/docs/_sources/README.md.txt
+++ b/docs/_sources/README.md.txt
@@ -16,10 +16,11 @@ Pympress was originally created and maintained by [Schnouki](https://github.com/
 # Installing
 
 ## If you have python
+First, make sure you have all [the dependencies](#dependencies).
 
 ### Using pip
 
-Run the following command in your shell (or replace `python3 -m pip` with `python -m pip` or just `pip`):
+Run the following command in your shell (or replace `python3 -m pip` with `python -m pip` or just `pip`, and ):
 
     python3 -m pip install pympress
 
@@ -27,36 +28,61 @@ Or you can get it from github:
 
     python3 -m pip install git+https://github.com/Cimbali/pympress#egg=pympress
 
-If you don't have pip, see [the python documentation on installing](https://docs.python.org/3.5/installing/index.html). You may also want to check that you have all [the dependencies](#dependencies).
+If you don't have pip, see [the python documentation on installing](https://docs.python.org/3.7/installing/index.html).
 
 ### From source
 
-If you also want the source code, you can clone this repo or grab [the latest releases' source](https://github.com/Cimbali/pympress/releases/latest), open a console where you put the code, and type `python3 -m pip install .` (or, if you plan on modifying that code, `python3 -m pip install -e .`). Same remarks as above apply.
+If you also want the source code, you can clone this repo or grab [the latest releases' source](https://github.com/Cimbali/pympress/releases/latest), open a console where you put the code, and type `python3 -m pip install .` (or, if you plan on modifying that code, `python3 -m pip install -e .`).
 
-## Binary install
+## Binary install (currently only for windows)
 
+Grab [the latest installer for your platform](https://github.com/Cimbali/pympress/releases/latest) and execute it.
 If you don't want to know about source code or dependencies, this is for you.
-Grab [the latest installer for your platform](https://github.com/Cimbali/pympress/releases/latest) and execute it. You're done!
 
-Currently binaries are only available for windows (.msi files). Choose packages with 'amd64' in the name if you have a 64 bit machine, 'x86' if you have a 32 bit machine. The 'vlc' suffix indicates that this installer ships VLC as well to support video, so try it if the other version fails to read videos.
+Packages with 'amd64' in the name are for 64 bit machines, 'x86' for 32 bit machines. The 'vlc' suffix indicates that the installer ships VLC as well, so try it if the other version fails to read videos.
 
-On windows, in the unlikely event you get an error message along the lines of "MSVCP100.dll is missing", you can download this package from Microsoft [for x86 (32 bit)](https://www.microsoft.com/en-in/download/details.aspx?id=5555) or [for x64 (64 bits)](https://www.microsoft.com/en-us/download/details.aspx?id=14632). Those libraries really should already be installed on your system.
+If you get an error message along the lines of "MSVCP100.dll is missing", get the Visual C++ redistributables from Microsoft ([x86 (32 bit)](https://www.microsoft.com/en-in/download/details.aspx?id=5555) or [x64 (64 bits)](https://www.microsoft.com/en-us/download/details.aspx?id=14632)). Those libraries really should already be installed on your system.
 
-## Dependencies
+# Usage
+
+## Opening a file
+Simply start Pympress and it will ask you what file you want to open.
+You can also start pympress from the command line with a file to open like so:
+`pympress slides.pdf`
+or
+`python3 -m pympress slides.pdf`
+
+## Functionalities
+
+All functionalities are available from the menus of the window with slide previews. Don't be afraid to experiment with them!
+
+Keyboard shortcuts are also listed in these menus. Some more usual shortcuts are often available, for example `Ctrl`+`L`, and `F11` also toggle fullscreen, though the main shortcut is just `F`.
+
+A few of the fancier functionalities are listed here:
+- **Swap screens**: If Pympress mixed up which screen is the projector and which is not, press `S`
+- **Go To Slide**: To jump to a selected slide without flashing through the whole presentation on the projector, press `G` or click the "current  slide" box.
+
+  A spin box will appear, and you will be able to navigate through your slides in the presenter window only by scrolling your mouse, with the `Home`/`Up`/`Down`/`End` keys, with the + and - buttons of the spin box, or simply by typing in the number of the slide. Press `Enter` to validate going to the new slide or `Esc` to cancel.
+- **Estimated talk time**: Click the `Time estimation` box and set your planned talk duration. You can also pass this on the command line through the `-ett` flag. The color will allow you to see at a glance how much time you have left.
+- **Adjust screen centering**: If your slides' form factor doesn't fit the projectors' and you don't want the slide centered in the window, use the "Screen Center" option in the "Presentation" menu.
+- **Resize Current/Next slide**: You can drag the bar between both slides on the Presenter window to adjust their relative sizes to your liking.
+- **Preferences**: Some of your choices are saved in a configuration file, in *~/.config/pympress* or *~/.pympress* on linux, and in *%APPDATA%/pympress.ini* on windows.
+- **Cache**: For efficiency, Pympress caches rendered pages (up to 200 by default). If this is too memory consuming for you, you can change this number in the configuration file.
+
+# Dependencies
 
 Pympress relies on:
 * Python, 3.x or 2.7 (with [setuptools](https://pypi.python.org/pypi/setuptools), which is usually shipped by default with python).
 * [Poppler](http://poppler.freedesktop.org/), the PDF rendering library.
 * [Gtk+ 3](http://www.gtk.org/), a toolkit for creating graphical user interfaces, and [its dependencies](https://www.gtk.org/overview.php), specifically:
   * [Cairo](https://www.cairographics.org/) (and python bindings for cairo), the graphics library which is used to pre-render and draw over PDF pages.
-  * Gdk, a lower-level graphics library to handles icons.
+  * Gdk, a lower-level graphics library to handle icons.
 * [PyGi, the python bindings for Gtk+3](https://wiki.gnome.org/Projects/PyGObject). PyGi is also known as *pygobject3*, just *pygobject* or *python3-gi*.
   * Introspection bindings for poppler may be shipped separately, ensure you have those as well (`typelib-1_0-Poppler-0_18` on OpenSUSE, `gir1.2-poppler-0.18` on Ubuntu)
 * optionally [VLC](https://www.videolan.org/vlc/), to play videos (with the same bitness as Python)
 
-On windows GTK+3, Poppler and their python bindings are all shipped together in [the PyGi installer](https://sourceforge.net/projects/pygobjectwin32/). *Be sure to check the supported Python versions (up to 3.4 at the time of writing)*, they appear in the FEATURES list in the linked page. Be sure to tick all the necessary dependencies in the installer (Poppler, Cairo, Gdk-Pixbuf).
-
-On other platforms they are often installed by default, or easily available through your package or software manager.
+### On linux platforms
+The dependencies are often installed by default, or easily available through your package or software manager.
 For example, on ubuntu, you can run the following as root to make sure you have all the prerequisites *assuming you use python3*:
 
     apt-get install python3 python3-pip libgtk-3-0 libpoppler-glib8 libcairo2 python3-gi python3-cairo gir1.2-gtk-3.0 gir1.2-poppler-0.18
@@ -65,29 +91,24 @@ Different distributions might have different package naming conventions, for exa
 
     zypper in python3 python3-pip libgtk-3-0 libpoppler-glib8 libcairo2 python3-gobject python3-gobject-Gdk python3-cairo typelib-1_0-GdkPixbuf-2_0 typelib-1_0-Gtk-3_0 typelib-1_0-Poppler-0_18
 
-# Usage
+### On windows
+There are two ways to get the dependencies:
 
-## Opening a file
-Simply start Pympress and it will ask you what file you want to open.
-You can also start pympress from the command line with a file to open like so:
-`pympress slides.pdf`
+1. using MSYS2 (replace x86_64 with i686 if you're using a 32 bit machine):
 
-## Functionalities
+        pacman -S --needed mingw-w64-x86_64-gtk3 mingw-w64-x86_64-cairo mingw-w64-x86_64-poppler mingw-w64-x86_64-python3 mingw-w64-x86_64-vlc python3-pip mingw-w64-x86_64-python3-pip mingw-w64-x86_64-python3-gobject mingw-w64-x86_64-python3-cairo
 
-All functionalities are available from the menus of the window with slide previews. Don't be afraid to experiment with them!
+2. Using PyGobjectWin32. *Be sure to check the supported Python versions (up to 3.4 at the time of writing)*, they appear in the FEATURES list in the linked page.
+  - Install native [python for windows](https://www.python.org/downloads/windows/)
+  - Get GTK+3, Poppler and their python bindings by executing [the PyGi installer](https://sourceforge.net/projects/pygobjectwin32/).  Be sure to tick all the necessary dependencies in the installer (Poppler, Cairo, Gdk-Pixbuf).
 
-Keyboard shortcuts are also listed in these menus. Some more usual shortcuts are often available, for example `Ctrl`+`L`, and `F11` also toggle fullscreen, though the main shortcut is just `F`.
+Alternately, you can build your Gtk+3 stack from source using MSVC, see [the Gnome wiki](https://wiki.gnome.org/Projects/GTK+/Win32/MSVCCompilationOfGTKStack) and [this python script that compiles the whole Gtk+3 stack](https://github.com/wingtk/gvsbuild/)
 
-A few of the fancier functionalities are listed here:
-- **Swap screens**: If Pympress mixed up which screen is the projector and which is not, press `S`
-- **Go To Slide**: To jump to a selected slide without flashing through the whole presentation on the projector, press `G` or click the "current  slide" box.
+### On macOS
 
-  A spin box will appear, and you will be able to navigate through your slides in the presenter window only by scrolling your mouse, with the `Home`/`Up`/`Down`/`End` keys, with the + and - buttons of the spin box, or simply by typing in the number of the slide. Press `Enter` to validate going to the new slide or `Esc` to cancel.
-- **Estimated talk time**: Click the `Time estimation` box and set your planned talk duration. You can also pass this on the command line through the `-ett` flag. The color will allow you to see at a glance how much time you have left.
-- **Adjust screen centering**: If your slides' form factor doesn't fit the projectors' and you don't want the slide centered in the window, use the "Screen Center" option in the "Presentation" menu.
-- **Resize Current/Next slide**: You can drag the bar between both slides on the Presenter window to adjust their relative sizes to your liking.
-- **Preferences**: Some of your choices are saved in a configuration file, in *~/.config/pympress* or *~/.pympress* on linux, and in *%APPDATA%/pympress.ini* on windows.
-- **Cache**: For efficiency, Pympress caches rendered pages (up to 200 by default). If this is too memory consuming for you, you can change this number in the configuration file.
+Dependencies can be installed using [Homebrew](https://brew.sh/):
+
+    brew install gtk+3 poppler gobject-introspection
 
 # Contributing
 
@@ -98,5 +119,3 @@ Pympress has inline sphinx documentation ([Google style](http://www.sphinx-doc.o
 
 If you want to add a translation, check if `pympress/share/locale//pympress.po` already exists. If not, take [the template file](https://github.com/Cimbali/pympress/tree/master/pympress/share/locale/pympress.pot) as input and translate all the strings, then add it to the repo in `pympress/share/locale//pympress.po`.
 Finally pass this .po file to msgfmt and add the output to the repo at `pympress/share/locale//LC_MESSAGES/pympress.mo`.
-
-
diff --git a/docs/_sources/pympress.md.txt b/docs/_sources/pympress.md.txt
index a02bdf2e..06e41fcb 100644
--- a/docs/_sources/pympress.md.txt
+++ b/docs/_sources/pympress.md.txt
@@ -64,7 +64,7 @@ Retructured text (rst) can be used inside the comments and docstrings.
     :undoc-members:
     :show-inheritance:
 
-.. automodule:: pympress.vlcvideo
+.. automodule:: pympress.media_overlay
     :members:
     :undoc-members:
     :show-inheritance:
diff --git a/docs/_static/basic.css b/docs/_static/basic.css
index 3c7223b1..19ced105 100644
--- a/docs/_static/basic.css
+++ b/docs/_static/basic.css
@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- basic theme.
  *
- * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
@@ -82,9 +82,21 @@ div.sphinxsidebar input {
 }
 
 div.sphinxsidebar #searchbox input[type="text"] {
-    width: 170px;
+    float: left;
+    width: 80%;
+    padding: 0.25em;
+    box-sizing: border-box;
+}
+
+div.sphinxsidebar #searchbox input[type="submit"] {
+    float: left;
+    width: 20%;
+    border-left: none;
+    padding: 0.25em;
+    box-sizing: border-box;
 }
 
+
 img {
     border: 0;
     max-width: 100%;
@@ -199,6 +211,11 @@ table.modindextable td {
 
 /* -- general body styles --------------------------------------------------- */
 
+div.body {
+    min-width: 450px;
+    max-width: 800px;
+}
+
 div.body p, div.body dd, div.body li, div.body blockquote {
     -moz-hyphens: auto;
     -ms-hyphens: auto;
@@ -332,6 +349,11 @@ table.docutils {
     border-collapse: collapse;
 }
 
+table.align-center {
+    margin-left: auto;
+    margin-right: auto;
+}
+
 table caption span.caption-number {
     font-style: italic;
 }
diff --git a/docs/_static/doctools.js b/docs/_static/doctools.js
index 24992e64..d8928926 100644
--- a/docs/_static/doctools.js
+++ b/docs/_static/doctools.js
@@ -4,7 +4,7 @@
  *
  * Sphinx JavaScript utilities for all documentation.
  *
- * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
@@ -70,7 +70,9 @@ jQuery.fn.highlightText = function(text, className) {
     if (node.nodeType === 3) {
       var val = node.nodeValue;
       var pos = val.toLowerCase().indexOf(text);
-      if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
+      if (pos >= 0 &&
+          !jQuery(node.parentNode).hasClass(className) &&
+          !jQuery(node.parentNode).hasClass("nohighlight")) {
         var span;
         var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
         if (isInSVG) {
@@ -204,7 +206,7 @@ var Documentation = {
    * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
    */
   fixFirefoxAnchorBug : function() {
-    if (document.location.hash)
+    if (document.location.hash && $.browser.mozilla)
       window.setTimeout(function() {
         document.location.href += '';
       }, 10);
diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js
new file mode 100644
index 00000000..3cd99283
--- /dev/null
+++ b/docs/_static/documentation_options.js
@@ -0,0 +1,9 @@
+var DOCUMENTATION_OPTIONS = {
+    URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
+    VERSION: 'b'0.6-303-gd03398a'',
+    LANGUAGE: 'en',
+    COLLAPSE_INDEX: false,
+    FILE_SUFFIX: '.html',
+    HAS_SOURCE: true,
+    SOURCELINK_SUFFIX: '.txt'
+};
\ No newline at end of file
diff --git a/docs/_static/jquery-3.1.0.js b/docs/_static/jquery-3.2.1.js
similarity index 94%
rename from docs/_static/jquery-3.1.0.js
rename to docs/_static/jquery-3.2.1.js
index f2fc2747..d2d8ca47 100644
--- a/docs/_static/jquery-3.1.0.js
+++ b/docs/_static/jquery-3.2.1.js
@@ -1,16 +1,15 @@
-/*eslint-disable no-unused-vars*/
 /*!
- * jQuery JavaScript Library v3.1.0
+ * jQuery JavaScript Library v3.2.1
  * https://jquery.com/
  *
  * Includes Sizzle.js
  * https://sizzlejs.com/
  *
- * Copyright jQuery Foundation and other contributors
+ * Copyright JS Foundation and other contributors
  * Released under the MIT license
  * https://jquery.org/license
  *
- * Date: 2016-07-07T21:44Z
+ * Date: 2017-03-20T18:59Z
  */
 ( function( global, factory ) {
 
@@ -83,13 +82,13 @@ var support = {};
 		doc.head.appendChild( script ).parentNode.removeChild( script );
 	}
 /* global Symbol */
-// Defining this global in .eslintrc would create a danger of using the global
+// Defining this global in .eslintrc.json would create a danger of using the global
 // unguarded in another place, it seems safer to define global only for this module
 
 
 
 var
-	version = "3.1.0",
+	version = "3.2.1",
 
 	// Define a local copy of jQuery
 	jQuery = function( selector, context ) {
@@ -129,13 +128,14 @@ jQuery.fn = jQuery.prototype = {
 	// Get the Nth element in the matched element set OR
 	// Get the whole matched element set as a clean array
 	get: function( num ) {
-		return num != null ?
 
-			// Return just the one element from the set
-			( num < 0 ? this[ num + this.length ] : this[ num ] ) :
+		// Return all the elements in a clean array
+		if ( num == null ) {
+			return slice.call( this );
+		}
 
-			// Return all the elements in a clean array
-			slice.call( this );
+		// Return just the one element from the set
+		return num < 0 ? this[ num + this.length ] : this[ num ];
 	},
 
 	// Take an array of elements and push it onto the stack
@@ -236,11 +236,11 @@ jQuery.extend = jQuery.fn.extend = function() {
 
 				// Recurse if we're merging plain objects or arrays
 				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
-					( copyIsArray = jQuery.isArray( copy ) ) ) ) {
+					( copyIsArray = Array.isArray( copy ) ) ) ) {
 
 					if ( copyIsArray ) {
 						copyIsArray = false;
-						clone = src && jQuery.isArray( src ) ? src : [];
+						clone = src && Array.isArray( src ) ? src : [];
 
 					} else {
 						clone = src && jQuery.isPlainObject( src ) ? src : {};
@@ -279,8 +279,6 @@ jQuery.extend( {
 		return jQuery.type( obj ) === "function";
 	},
 
-	isArray: Array.isArray,
-
 	isWindow: function( obj ) {
 		return obj != null && obj === obj.window;
 	},
@@ -355,10 +353,6 @@ jQuery.extend( {
 		return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
 	},
 
-	nodeName: function( elem, name ) {
-		return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
-	},
-
 	each: function( obj, callback ) {
 		var length, i = 0;
 
@@ -543,14 +537,14 @@ function isArrayLike( obj ) {
 }
 var Sizzle =
 /*!
- * Sizzle CSS Selector Engine v2.3.0
+ * Sizzle CSS Selector Engine v2.3.3
  * https://sizzlejs.com/
  *
  * Copyright jQuery Foundation and other contributors
  * Released under the MIT license
  * http://jquery.org/license
  *
- * Date: 2016-01-04
+ * Date: 2016-08-08
  */
 (function( window ) {
 
@@ -696,7 +690,7 @@ var i,
 
 	// CSS string/identifier serialization
 	// https://drafts.csswg.org/cssom/#common-serializing-idioms
-	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\x80-\uFFFF\w-]/g,
+	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,
 	fcssescape = function( ch, asCodePoint ) {
 		if ( asCodePoint ) {
 
@@ -723,7 +717,7 @@ var i,
 
 	disabledAncestor = addCombinator(
 		function( elem ) {
-			return elem.disabled === true;
+			return elem.disabled === true && ("form" in elem || "label" in elem);
 		},
 		{ dir: "parentNode", next: "legend" }
 	);
@@ -1009,26 +1003,54 @@ function createButtonPseudo( type ) {
  * @param {Boolean} disabled true for :disabled; false for :enabled
  */
 function createDisabledPseudo( disabled ) {
-	// Known :disabled false positives:
-	// IE: *[disabled]:not(button, input, select, textarea, optgroup, option, menuitem, fieldset)
-	// not IE: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
+
+	// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
 	return function( elem ) {
 
-		// Check form elements and option elements for explicit disabling
-		return "label" in elem && elem.disabled === disabled ||
-			"form" in elem && elem.disabled === disabled ||
+		// Only certain elements can match :enabled or :disabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+		if ( "form" in elem ) {
+
+			// Check for inherited disabledness on relevant non-disabled elements:
+			// * listed form-associated elements in a disabled fieldset
+			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
+			// * option elements in a disabled optgroup
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
+			// All such elements have a "form" property.
+			if ( elem.parentNode && elem.disabled === false ) {
+
+				// Option elements defer to a parent optgroup if present
+				if ( "label" in elem ) {
+					if ( "label" in elem.parentNode ) {
+						return elem.parentNode.disabled === disabled;
+					} else {
+						return elem.disabled === disabled;
+					}
+				}
 
-			// Check non-disabled form elements for fieldset[disabled] ancestors
-			"form" in elem && elem.disabled === false && (
-				// Support: IE6-11+
-				// Ancestry is covered for us
-				elem.isDisabled === disabled ||
+				// Support: IE 6 - 11
+				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
+				return elem.isDisabled === disabled ||
 
-				// Otherwise, assume any non-