python: generate versioned module for libvlc 3.0
authorOlivier Aubert <contact@olivieraubert.net>
Thu, 4 Jan 2018 22:35:00 +0000 (23:35 +0100)
committerOlivier Aubert <contact@olivieraubert.net>
Thu, 4 Jan 2018 22:45:55 +0000 (23:45 +0100)
15 files changed:
Makefile
README.module
README.rst
generated/3.0/COPYING [new file with mode: 0644]
generated/3.0/MANIFEST.in [new file with mode: 0644]
generated/3.0/README.module [new file with mode: 0644]
generated/3.0/distribute_setup.py [new file with mode: 0644]
generated/3.0/examples/gtk2vlc.py [new file with mode: 0755]
generated/3.0/examples/gtkvlc.py [new file with mode: 0755]
generated/3.0/examples/qtvlc.py [new file with mode: 0755]
generated/3.0/examples/tkvlc.py [new file with mode: 0755]
generated/3.0/examples/wxvlc.py [new file with mode: 0755]
generated/3.0/setup.py [new file with mode: 0644]
generated/3.0/vlc.py [new file with mode: 0644]
generated/dev/vlc.py

index 29d8a7b..4d9b04f 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -3,7 +3,7 @@ DEV_INCLUDE_DIR=../../include/vlc
 INSTALLED_INCLUDE_DIR=/usr/include/vlc
 
 DEV_PATH=generated/dev
-VERSIONED_PATH=generated/2.2
+VERSIONED_PATH=generated/3.0
 
 MODULE_NAME=$(DEV_PATH)/vlc.py
 VERSIONED_NAME=$(VERSIONED_PATH)/vlc.py
index ed5fc34..e01f02c 100644 (file)
@@ -4,7 +4,7 @@ Python ctypes-based bindings libvlc
 The bindings use ctypes to directly call the libvlc dynamic lib, and
 the code is generated from the include files defining the public
 API. The same module should be compatible with various versions of
-libvlc 2.*. However, there may be incompatible changes between major
+libvlc 3.*. However, there may be incompatible changes between major
 versions.
 
 License
@@ -27,30 +27,25 @@ Documentation building needs epydoc. An online build is available at
 <http://olivieraubert.net/vlc/python-ctypes/>
 
 The module offers two ways of accessing the API - a raw access to all
-exported methods, and more convenient wrapper classes :
+exported methods, and more convenient wrapper classes.
 
-- Raw access: methods are available as attributes of the vlc
-  module. Use their docstring (any introspective shell like ipython is
-  your friend) to explore them.
+Using wrapper classes
++++++++++++++++++++++
 
-- Wrapper classes: most major structures of the libvlc API (Instance,
-  Media, MediaPlayer, etc) are wrapped as classes, with shorter method
-  names.
+Most major structures of the libvlc API (Instance, Media, MediaPlayer,
+  etc) are wrapped as classes, with shorter method names and some
+  adaptations to provide a more pythonic API:
 
+   >>> import vlc
+   >>> p=vlc.MediaPlayer('file:///tmp/foo.avi')
+   >>> p.play()
+   >>> p.get_instance() # returns the corresponding instance
 
-- Using raw access:
-
-    >>> import vlc
-    >>> vlc.libvlc_get_version()
-    '1.0.0 Goldeneye'
-    >>> e=vlc.VLCException()
-    >>> i=vlc.libvlc_new(0, [], e)
-    >>> i
-    <vlc.Instance object at 0x8384a4c>
-    >>> vlc.libvlc_audio_get_volume(i,e)
-    50
+In this case, a default ``vlc.Instance`` will be instanciated and
+stored in ``vlc._default_instance``. It will be used to instanciate
+the various classes (``Media``, ``MediaList``, ``MediaPlayer``, etc).
 
-- Using wrapper classes:
+You also can use wrapper methods closer to the original libvlc API:
 
    >>> import vlc
    >>> i=vlc.Instance('--no-audio', '--fullscreen')
@@ -63,13 +58,20 @@ exported methods, and more convenient wrapper classes :
    >>> p.set_media(m)
    >>> p.play()
 
-or even shorter:
+Using raw access
+++++++++++++++++
 
-   >>> import vlc
-   >>> p=vlc.MediaPlayer('file:///tmp/foo.avi')
-   >>> p.play()
-   >>> p.get_instance() # returns the corresponding instance
+Libvlc methods are available as attributes of the vlc module (as
+  vlc.libvlc_*). Use their docstring (any introspective shell like
+  ipython is your friend) to explore them, or refer to the online
+  documentation at http://olivieraubert.net/vlc/python-ctypes/
 
-In this latter case, a default ``vlc.Instance`` will be instanciated and
-stored in ``vlc._default_instance``. It will be used to instanciate the
-various classes (``Media``, ``MediaList``, ``MediaPlayer``, etc).
+    >>> import vlc
+    >>> vlc.libvlc_get_version()
+    '3.0.0-rc2 Vetinari'
+    >>> e=vlc.VLCException()
+    >>> i=vlc.libvlc_new(0, [], e)
+    >>> i
+    <vlc.Instance object at 0x8384a4c>
+    >>> vlc.libvlc_audio_get_volume(i,e)
+    50
index 69a8c00..86c16c8 100644 (file)
@@ -8,9 +8,9 @@ file.
 
 The bindings generator generates ctypes-bindings from the include
 files defining the public API. The same generated module should be
-compatible with various versions of libvlc 2.*. However, there may be
-incompatible changes between major versions. A 2.2 specific binding is
-provided.
+compatible with various versions of libvlc 2.* and 3.*. However, there
+may be incompatible changes between major versions. Versioned bindings
+for 2.2 and 3.0 are provided in the repository.
 
 License
 -------
diff --git a/generated/3.0/COPYING b/generated/3.0/COPYING
new file mode 100644 (file)
index 0000000..4362b49
--- /dev/null
@@ -0,0 +1,502 @@
+                  GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+\f
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+\f
+                  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+\f
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+\f
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+\f
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+\f
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+\f
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+\f
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+                            NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+\f
+           How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the library's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    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
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+  <signature of Ty Coon>, 1 April 1990
+  Ty Coon, President of Vice
+
+That's all there is to it!
diff --git a/generated/3.0/MANIFEST.in b/generated/3.0/MANIFEST.in
new file mode 100644 (file)
index 0000000..e56742d
--- /dev/null
@@ -0,0 +1,5 @@
+include setup.py
+include vlc.py
+include COPYING MANIFEST.in README.module
+include distribute_setup.py
+recursive-include examples *
diff --git a/generated/3.0/README.module b/generated/3.0/README.module
new file mode 100644 (file)
index 0000000..e01f02c
--- /dev/null
@@ -0,0 +1,77 @@
+Python ctypes-based bindings libvlc
+===================================
+
+The bindings use ctypes to directly call the libvlc dynamic lib, and
+the code is generated from the include files defining the public
+API. The same module should be compatible with various versions of
+libvlc 3.*. However, there may be incompatible changes between major
+versions.
+
+License
+-------
+
+The generated module is licensed, like libvlc, under the GNU Lesser
+General Public License 2.1 or later.
+
+Installing the module
+---------------------
+
+You can install the module through PyPI:
+
+    pip install python-vlc
+
+Using the module
+----------------
+
+Documentation building needs epydoc. An online build is available at
+<http://olivieraubert.net/vlc/python-ctypes/>
+
+The module offers two ways of accessing the API - a raw access to all
+exported methods, and more convenient wrapper classes.
+
+Using wrapper classes
++++++++++++++++++++++
+
+Most major structures of the libvlc API (Instance, Media, MediaPlayer,
+  etc) are wrapped as classes, with shorter method names and some
+  adaptations to provide a more pythonic API:
+
+   >>> import vlc
+   >>> p=vlc.MediaPlayer('file:///tmp/foo.avi')
+   >>> p.play()
+   >>> p.get_instance() # returns the corresponding instance
+
+In this case, a default ``vlc.Instance`` will be instanciated and
+stored in ``vlc._default_instance``. It will be used to instanciate
+the various classes (``Media``, ``MediaList``, ``MediaPlayer``, etc).
+
+You also can use wrapper methods closer to the original libvlc API:
+
+   >>> import vlc
+   >>> i=vlc.Instance('--no-audio', '--fullscreen')
+   >>> i.audio_get_volume()
+   50
+   >>> p=i.media_player_new()
+   >>> m=i.media_new('file:///tmp/foo.avi')
+   >>> m.get_mrl()
+   'file:///tmp/foo.avi'
+   >>> p.set_media(m)
+   >>> p.play()
+
+Using raw access
+++++++++++++++++
+
+Libvlc methods are available as attributes of the vlc module (as
+  vlc.libvlc_*). Use their docstring (any introspective shell like
+  ipython is your friend) to explore them, or refer to the online
+  documentation at http://olivieraubert.net/vlc/python-ctypes/
+
+    >>> import vlc
+    >>> vlc.libvlc_get_version()
+    '3.0.0-rc2 Vetinari'
+    >>> e=vlc.VLCException()
+    >>> i=vlc.libvlc_new(0, [], e)
+    >>> i
+    <vlc.Instance object at 0x8384a4c>
+    >>> vlc.libvlc_audio_get_volume(i,e)
+    50
diff --git a/generated/3.0/distribute_setup.py b/generated/3.0/distribute_setup.py
new file mode 100644 (file)
index 0000000..3553b21
--- /dev/null
@@ -0,0 +1,556 @@
+#!python
+"""Bootstrap distribute installation
+
+If you want to use setuptools in your package's setup.py, just include this
+file in the same directory with it, and add this to the top of your setup.py::
+
+    from distribute_setup import use_setuptools
+    use_setuptools()
+
+If you want to require a specific version of setuptools, set a download
+mirror, or use an alternate download directory, you can do so by supplying
+the appropriate options to ``use_setuptools()``.
+
+This file can also be run as a script to install or upgrade setuptools.
+"""
+import os
+import shutil
+import sys
+import time
+import fnmatch
+import tempfile
+import tarfile
+import optparse
+
+from distutils import log
+
+try:
+    from site import USER_SITE
+except ImportError:
+    USER_SITE = None
+
+try:
+    import subprocess
+
+    def _python_cmd(*args):
+        args = (sys.executable,) + args
+        return subprocess.call(args) == 0
+
+except ImportError:
+    # will be used for python 2.3
+    def _python_cmd(*args):
+        args = (sys.executable,) + args
+        # quoting arguments if windows
+        if sys.platform == 'win32':
+            def quote(arg):
+                if ' ' in arg:
+                    return '"%s"' % arg
+                return arg
+            args = [quote(arg) for arg in args]
+        return os.spawnl(os.P_WAIT, sys.executable, *args) == 0
+
+DEFAULT_VERSION = "0.6.49"
+DEFAULT_URL = "http://pypi.python.org/packages/source/d/distribute/"
+SETUPTOOLS_FAKED_VERSION = "0.6c11"
+
+SETUPTOOLS_PKG_INFO = """\
+Metadata-Version: 1.0
+Name: setuptools
+Version: %s
+Summary: xxxx
+Home-page: xxx
+Author: xxx
+Author-email: xxx
+License: xxx
+Description: xxx
+""" % SETUPTOOLS_FAKED_VERSION
+
+
+def _install(tarball, install_args=()):
+    # extracting the tarball
+    tmpdir = tempfile.mkdtemp()
+    log.warn('Extracting in %s', tmpdir)
+    old_wd = os.getcwd()
+    try:
+        os.chdir(tmpdir)
+        tar = tarfile.open(tarball)
+        _extractall(tar)
+        tar.close()
+
+        # going in the directory
+        subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0])
+        os.chdir(subdir)
+        log.warn('Now working in %s', subdir)
+
+        # installing
+        log.warn('Installing Distribute')
+        if not _python_cmd('setup.py', 'install', *install_args):
+            log.warn('Something went wrong during the installation.')
+            log.warn('See the error message above.')
+            # exitcode will be 2
+            return 2
+    finally:
+        os.chdir(old_wd)
+        shutil.rmtree(tmpdir)
+
+
+def _build_egg(egg, tarball, to_dir):
+    # extracting the tarball
+    tmpdir = tempfile.mkdtemp()
+    log.warn('Extracting in %s', tmpdir)
+    old_wd = os.getcwd()
+    try:
+        os.chdir(tmpdir)
+        tar = tarfile.open(tarball)
+        _extractall(tar)
+        tar.close()
+
+        # going in the directory
+        subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0])
+        os.chdir(subdir)
+        log.warn('Now working in %s', subdir)
+
+        # building an egg
+        log.warn('Building a Distribute egg in %s', to_dir)
+        _python_cmd('setup.py', '-q', 'bdist_egg', '--dist-dir', to_dir)
+
+    finally:
+        os.chdir(old_wd)
+        shutil.rmtree(tmpdir)
+    # returning the result
+    log.warn(egg)
+    if not os.path.exists(egg):
+        raise IOError('Could not build the egg.')
+
+
+def _do_download(version, download_base, to_dir, download_delay):
+    egg = os.path.join(to_dir, 'distribute-%s-py%d.%d.egg'
+                       % (version, sys.version_info[0], sys.version_info[1]))
+    if not os.path.exists(egg):
+        tarball = download_setuptools(version, download_base,
+                                      to_dir, download_delay)
+        _build_egg(egg, tarball, to_dir)
+    sys.path.insert(0, egg)
+    import setuptools
+    setuptools.bootstrap_install_from = egg
+
+
+def use_setuptools(version=DEFAULT_VERSION, download_base=DEFAULT_URL,
+                   to_dir=os.curdir, download_delay=15, no_fake=True):
+    # making sure we use the absolute path
+    to_dir = os.path.abspath(to_dir)
+    was_imported = 'pkg_resources' in sys.modules or \
+        'setuptools' in sys.modules
+    try:
+        try:
+            import pkg_resources
+
+            # Setuptools 0.7b and later is a suitable (and preferable)
+            # substitute for any Distribute version.
+            try:
+                pkg_resources.require("setuptools>=0.7b")
+                return
+            except (pkg_resources.DistributionNotFound,
+                    pkg_resources.VersionConflict):
+                pass
+
+            if not hasattr(pkg_resources, '_distribute'):
+                if not no_fake:
+                    _fake_setuptools()
+                raise ImportError
+        except ImportError:
+            return _do_download(version, download_base, to_dir, download_delay)
+        try:
+            pkg_resources.require("distribute>=" + version)
+            return
+        except pkg_resources.VersionConflict:
+            e = sys.exc_info()[1]
+            if was_imported:
+                sys.stderr.write(
+                "The required version of distribute (>=%s) is not available,\n"
+                "and can't be installed while this script is running. Please\n"
+                "install a more recent version first, using\n"
+                "'easy_install -U distribute'."
+                "\n\n(Currently using %r)\n" % (version, e.args[0]))
+                sys.exit(2)
+            else:
+                del pkg_resources, sys.modules['pkg_resources']    # reload ok
+                return _do_download(version, download_base, to_dir,
+                                    download_delay)
+        except pkg_resources.DistributionNotFound:
+            return _do_download(version, download_base, to_dir,
+                                download_delay)
+    finally:
+        if not no_fake:
+            _create_fake_setuptools_pkg_info(to_dir)
+
+
+def download_setuptools(version=DEFAULT_VERSION, download_base=DEFAULT_URL,
+                        to_dir=os.curdir, delay=15):
+    """Download distribute from a specified location and return its filename
+
+    `version` should be a valid distribute version number that is available
+    as an egg for download under the `download_base` URL (which should end
+    with a '/'). `to_dir` is the directory where the egg will be downloaded.
+    `delay` is the number of seconds to pause before an actual download
+    attempt.
+    """
+    # making sure we use the absolute path
+    to_dir = os.path.abspath(to_dir)
+    try:
+        from urllib.request import urlopen
+    except ImportError:
+        from urllib2 import urlopen
+    tgz_name = "distribute-%s.tar.gz" % version
+    url = download_base + tgz_name
+    saveto = os.path.join(to_dir, tgz_name)
+    src = dst = None
+    if not os.path.exists(saveto):  # Avoid repeated downloads
+        try:
+            log.warn("Downloading %s", url)
+            src = urlopen(url)
+            # Read/write all in one block, so we don't create a corrupt file
+            # if the download is interrupted.
+            data = src.read()
+            dst = open(saveto, "wb")
+            dst.write(data)
+        finally:
+            if src:
+                src.close()
+            if dst:
+                dst.close()
+    return os.path.realpath(saveto)
+
+
+def _no_sandbox(function):
+    def __no_sandbox(*args, **kw):
+        try:
+            from setuptools.sandbox import DirectorySandbox
+            if not hasattr(DirectorySandbox, '_old'):
+                def violation(*args):
+                    pass
+                DirectorySandbox._old = DirectorySandbox._violation
+                DirectorySandbox._violation = violation
+                patched = True
+            else:
+                patched = False
+        except ImportError:
+            patched = False
+
+        try:
+            return function(*args, **kw)
+        finally:
+            if patched:
+                DirectorySandbox._violation = DirectorySandbox._old
+                del DirectorySandbox._old
+
+    return __no_sandbox
+
+
+def _patch_file(path, content):
+    """Will backup the file then patch it"""
+    f = open(path)
+    existing_content = f.read()
+    f.close()
+    if existing_content == content:
+        # already patched
+        log.warn('Already patched.')
+        return False
+    log.warn('Patching...')
+    _rename_path(path)
+    f = open(path, 'w')
+    try:
+        f.write(content)
+    finally:
+        f.close()
+    return True
+
+_patch_file = _no_sandbox(_patch_file)
+
+
+def _same_content(path, content):
+    f = open(path)
+    existing_content = f.read()
+    f.close()
+    return existing_content == content
+
+
+def _rename_path(path):
+    new_name = path + '.OLD.%s' % time.time()
+    log.warn('Renaming %s to %s', path, new_name)
+    os.rename(path, new_name)
+    return new_name
+
+
+def _remove_flat_installation(placeholder):
+    if not os.path.isdir(placeholder):
+        log.warn('Unkown installation at %s', placeholder)
+        return False
+    found = False
+    for file in os.listdir(placeholder):
+        if fnmatch.fnmatch(file, 'setuptools*.egg-info'):
+            found = True
+            break
+    if not found:
+        log.warn('Could not locate setuptools*.egg-info')
+        return
+
+    log.warn('Moving elements out of the way...')
+    pkg_info = os.path.join(placeholder, file)
+    if os.path.isdir(pkg_info):
+        patched = _patch_egg_dir(pkg_info)
+    else:
+        patched = _patch_file(pkg_info, SETUPTOOLS_PKG_INFO)
+
+    if not patched:
+        log.warn('%s already patched.', pkg_info)
+        return False
+    # now let's move the files out of the way
+    for element in ('setuptools', 'pkg_resources.py', 'site.py'):
+        element = os.path.join(placeholder, element)
+        if os.path.exists(element):
+            _rename_path(element)
+        else:
+            log.warn('Could not find the %s element of the '
+                     'Setuptools distribution', element)
+    return True
+
+_remove_flat_installation = _no_sandbox(_remove_flat_installation)
+
+
+def _after_install(dist):
+    log.warn('After install bootstrap.')
+    placeholder = dist.get_command_obj('install').install_purelib
+    _create_fake_setuptools_pkg_info(placeholder)
+
+
+def _create_fake_setuptools_pkg_info(placeholder):
+    if not placeholder or not os.path.exists(placeholder):
+        log.warn('Could not find the install location')
+        return
+    pyver = '%s.%s' % (sys.version_info[0], sys.version_info[1])
+    setuptools_file = 'setuptools-%s-py%s.egg-info' % \
+            (SETUPTOOLS_FAKED_VERSION, pyver)
+    pkg_info = os.path.join(placeholder, setuptools_file)
+    if os.path.exists(pkg_info):
+        log.warn('%s already exists', pkg_info)
+        return
+
+    log.warn('Creating %s', pkg_info)
+    try:
+        f = open(pkg_info, 'w')
+    except EnvironmentError:
+        log.warn("Don't have permissions to write %s, skipping", pkg_info)
+        return
+    try:
+        f.write(SETUPTOOLS_PKG_INFO)
+    finally:
+        f.close()
+
+    pth_file = os.path.join(placeholder, 'setuptools.pth')
+    log.warn('Creating %s', pth_file)
+    f = open(pth_file, 'w')
+    try:
+        f.write(os.path.join(os.curdir, setuptools_file))
+    finally:
+        f.close()
+
+_create_fake_setuptools_pkg_info = _no_sandbox(
+    _create_fake_setuptools_pkg_info
+)
+
+
+def _patch_egg_dir(path):
+    # let's check if it's already patched
+    pkg_info = os.path.join(path, 'EGG-INFO', 'PKG-INFO')
+    if os.path.exists(pkg_info):
+        if _same_content(pkg_info, SETUPTOOLS_PKG_INFO):
+            log.warn('%s already patched.', pkg_info)
+            return False
+    _rename_path(path)
+    os.mkdir(path)
+    os.mkdir(os.path.join(path, 'EGG-INFO'))
+    pkg_info = os.path.join(path, 'EGG-INFO', 'PKG-INFO')
+    f = open(pkg_info, 'w')
+    try:
+        f.write(SETUPTOOLS_PKG_INFO)
+    finally:
+        f.close()
+    return True
+
+_patch_egg_dir = _no_sandbox(_patch_egg_dir)
+
+
+def _before_install():
+    log.warn('Before install bootstrap.')
+    _fake_setuptools()
+
+
+def _under_prefix(location):
+    if 'install' not in sys.argv:
+        return True
+    args = sys.argv[sys.argv.index('install') + 1:]
+    for index, arg in enumerate(args):
+        for option in ('--root', '--prefix'):
+            if arg.startswith('%s=' % option):
+                top_dir = arg.split('root=')[-1]
+                return location.startswith(top_dir)
+            elif arg == option:
+                if len(args) > index:
+                    top_dir = args[index + 1]
+                    return location.startswith(top_dir)
+        if arg == '--user' and USER_SITE is not None:
+            return location.startswith(USER_SITE)
+    return True
+
+
+def _fake_setuptools():
+    log.warn('Scanning installed packages')
+    try:
+        import pkg_resources
+    except ImportError:
+        # we're cool
+        log.warn('Setuptools or Distribute does not seem to be installed.')
+        return
+    ws = pkg_resources.working_set
+    try:
+        setuptools_dist = ws.find(
+            pkg_resources.Requirement.parse('setuptools', replacement=False)
+            )
+    except TypeError:
+        # old distribute API
+        setuptools_dist = ws.find(
+            pkg_resources.Requirement.parse('setuptools')
+        )
+
+    if setuptools_dist is None:
+        log.warn('No setuptools distribution found')
+        return
+    # detecting if it was already faked
+    setuptools_location = setuptools_dist.location
+    log.warn('Setuptools installation detected at %s', setuptools_location)
+
+    # if --root or --preix was provided, and if
+    # setuptools is not located in them, we don't patch it
+    if not _under_prefix(setuptools_location):
+        log.warn('Not patching, --root or --prefix is installing Distribute'
+                 ' in another location')
+        return
+
+    # let's see if its an egg
+    if not setuptools_location.endswith('.egg'):
+        log.warn('Non-egg installation')
+        res = _remove_flat_installation(setuptools_location)
+        if not res:
+            return
+    else:
+        log.warn('Egg installation')
+        pkg_info = os.path.join(setuptools_location, 'EGG-INFO', 'PKG-INFO')
+        if (os.path.exists(pkg_info) and
+            _same_content(pkg_info, SETUPTOOLS_PKG_INFO)):
+            log.warn('Already patched.')
+            return
+        log.warn('Patching...')
+        # let's create a fake egg replacing setuptools one
+        res = _patch_egg_dir(setuptools_location)
+        if not res:
+            return
+    log.warn('Patching complete.')
+    _relaunch()
+
+
+def _relaunch():
+    log.warn('Relaunching...')
+    # we have to relaunch the process
+    # pip marker to avoid a relaunch bug
+    _cmd1 = ['-c', 'install', '--single-version-externally-managed']
+    _cmd2 = ['-c', 'install', '--record']
+    if sys.argv[:3] == _cmd1 or sys.argv[:3] == _cmd2:
+        sys.argv[0] = 'setup.py'
+    args = [sys.executable] + sys.argv
+    sys.exit(subprocess.call(args))
+
+
+def _extractall(self, path=".", members=None):
+    """Extract all members from the archive to the current working
+       directory and set owner, modification time and permissions on
+       directories afterwards. `path' specifies a different directory
+       to extract to. `members' is optional and must be a subset of the
+       list returned by getmembers().
+    """
+    import copy
+    import operator
+    from tarfile import ExtractError
+    directories = []
+
+    if members is None:
+        members = self
+
+    for tarinfo in members:
+        if tarinfo.isdir():
+            # Extract directories with a safe mode.
+            directories.append(tarinfo)
+            tarinfo = copy.copy(tarinfo)
+            tarinfo.mode = 448  # decimal for oct 0700
+        self.extract(tarinfo, path)
+
+    # Reverse sort directories.
+    if sys.version_info < (2, 4):
+        def sorter(dir1, dir2):
+            return cmp(dir1.name, dir2.name)
+        directories.sort(sorter)
+        directories.reverse()
+    else:
+        directories.sort(key=operator.attrgetter('name'), reverse=True)
+
+    # Set correct owner, mtime and filemode on directories.
+    for tarinfo in directories:
+        dirpath = os.path.join(path, tarinfo.name)
+        try:
+            self.chown(tarinfo, dirpath)
+            self.utime(tarinfo, dirpath)
+            self.chmod(tarinfo, dirpath)
+        except ExtractError:
+            e = sys.exc_info()[1]
+            if self.errorlevel > 1:
+                raise
+            else:
+                self._dbg(1, "tarfile: %s" % e)
+
+
+def _build_install_args(options):
+    """
+    Build the arguments to 'python setup.py install' on the distribute package
+    """
+    install_args = []
+    if options.user_install:
+        if sys.version_info < (2, 6):
+            log.warn("--user requires Python 2.6 or later")
+            raise SystemExit(1)
+        install_args.append('--user')
+    return install_args
+
+def _parse_args():
+    """
+    Parse the command line for options
+    """
+    parser = optparse.OptionParser()
+    parser.add_option(
+        '--user', dest='user_install', action='store_true', default=False,
+        help='install in user site package (requires Python 2.6 or later)')
+    parser.add_option(
+        '--download-base', dest='download_base', metavar="URL",
+        default=DEFAULT_URL,
+        help='alternative URL from where to download the distribute package')
+    options, args = parser.parse_args()
+    # positional arguments are ignored
+    return options
+
+def main(version=DEFAULT_VERSION):
+    """Install or upgrade setuptools and EasyInstall"""
+    options = _parse_args()
+    tarball = download_setuptools(download_base=options.download_base)
+    return _install(tarball, _build_install_args(options))
+
+if __name__ == '__main__':
+    sys.exit(main())
diff --git a/generated/3.0/examples/gtk2vlc.py b/generated/3.0/examples/gtk2vlc.py
new file mode 100755 (executable)
index 0000000..ee497a6
--- /dev/null
@@ -0,0 +1,170 @@
+#! /usr/bin/python
+
+#
+# gtk example/widget for VLC Python bindings
+# Copyright (C) 2009-2010 the VideoLAN team
+#
+# 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.
+#
+
+"""VLC Gtk Widget classes + example application.
+
+This module provides two helper classes, to ease the embedding of a
+VLC component inside a pygtk application.
+
+VLCWidget is a simple VLC widget.
+
+DecoratedVLCWidget provides simple player controls.
+
+When called as an application, it behaves as a video player.
+
+$Id$
+"""
+
+import gtk
+gtk.gdk.threads_init()
+
+import sys
+import vlc
+
+from gettext import gettext as _
+
+# Create a single vlc.Instance() to be shared by (possible) multiple players.
+instance = vlc.Instance()
+
+class VLCWidget(gtk.DrawingArea):
+    """Simple VLC widget.
+
+    Its player can be controlled through the 'player' attribute, which
+    is a vlc.MediaPlayer() instance.
+    """
+    def __init__(self, *p):
+        gtk.DrawingArea.__init__(self)
+        self.player = instance.media_player_new()
+        def handle_embed(*args):
+            if sys.platform == 'win32':
+                self.player.set_hwnd(self.window.handle)
+            else:
+                self.player.set_xwindow(self.window.xid)
+            return True
+        self.connect("map", handle_embed)
+        self.set_size_request(320, 200)
+
+class DecoratedVLCWidget(gtk.VBox):
+    """Decorated VLC widget.
+
+    VLC widget decorated with a player control toolbar.
+
+    Its player can be controlled through the 'player' attribute, which
+    is a Player instance.
+    """
+    def __init__(self, *p):
+        gtk.VBox.__init__(self)
+        self._vlc_widget = VLCWidget(*p)
+        self.player = self._vlc_widget.player
+        self.pack_start(self._vlc_widget, expand=True)
+        self._toolbar = self.get_player_control_toolbar()
+        self.pack_start(self._toolbar, expand=False)
+
+    def get_player_control_toolbar(self):
+        """Return a player control toolbar
+        """
+        tb = gtk.Toolbar()
+        tb.set_style(gtk.TOOLBAR_ICONS)
+        for text, tooltip, stock, callback in (
+            (_("Play"), _("Play"), gtk.STOCK_MEDIA_PLAY, lambda b: self.player.play()),
+            (_("Pause"), _("Pause"), gtk.STOCK_MEDIA_PAUSE, lambda b: self.player.pause()),
+            (_("Stop"), _("Stop"), gtk.STOCK_MEDIA_STOP, lambda b: self.player.stop()),
+            ):
+            b=gtk.ToolButton(stock)
+            b.set_tooltip_text(tooltip)
+            b.connect("clicked", callback)
+            tb.insert(b, -1)
+        tb.show_all()
+        return tb
+
+class VideoPlayer:
+    """Example simple video player.
+    """
+    def __init__(self):
+        self.vlc = DecoratedVLCWidget()
+
+    def main(self, fname):
+        self.vlc.player.set_media(instance.media_new(fname))
+        w = gtk.Window()
+        w.add(self.vlc)
+        w.show_all()
+        w.connect("destroy", gtk.main_quit)
+        gtk.main()
+
+class MultiVideoPlayer:
+    """Example multi-video player.
+
+    It plays multiple files side-by-side, with per-view and global controls.
+    """
+    def main(self, filenames):
+        # Build main window
+        window=gtk.Window()
+        mainbox=gtk.VBox()
+        videos=gtk.HBox()
+
+        window.add(mainbox)
+        mainbox.add(videos)
+
+        # Create VLC widgets
+        for fname in filenames:
+            v = DecoratedVLCWidget()
+            v.player.set_media(instance.media_new(fname))
+            videos.add(v)
+
+        # Create global toolbar
+        tb = gtk.Toolbar()
+        tb.set_style(gtk.TOOLBAR_ICONS)
+
+        def execute(b, methodname):
+            """Execute the given method on all VLC widgets.
+            """
+            for v in videos.get_children():
+                getattr(v.player, methodname)()
+            return True
+
+        for text, tooltip, stock, callback, arg in (
+            (_("Play"), _("Global play"), gtk.STOCK_MEDIA_PLAY, execute, "play"),
+            (_("Pause"), _("Global pause"), gtk.STOCK_MEDIA_PAUSE, execute, "pause"),
+            (_("Stop"), _("Global stop"), gtk.STOCK_MEDIA_STOP, execute, "stop"),
+            ):
+            b = gtk.ToolButton(stock)
+            b.set_tooltip_text(tooltip)
+            b.connect("clicked", callback, arg)
+            tb.insert(b, -1)
+
+        mainbox.pack_start(tb, expand=False)
+
+        window.show_all()
+        window.connect("destroy", gtk.main_quit)
+        gtk.main()
+
+if __name__ == '__main__':
+    if not sys.argv[1:]:
+       print('You must provide at least 1 movie filename')
+       sys.exit(1)
+    if len(sys.argv[1:]) == 1:
+        # Only 1 file. Simple interface
+        p=VideoPlayer()
+        p.main(sys.argv[1])
+    else:
+        # Multiple files.
+        p=MultiVideoPlayer()
+        p.main(sys.argv[1:])
diff --git a/generated/3.0/examples/gtkvlc.py b/generated/3.0/examples/gtkvlc.py
new file mode 100755 (executable)
index 0000000..b28a93a
--- /dev/null
@@ -0,0 +1,187 @@
+#! /usr/bin/python
+
+#
+# gtk3 example/widget for VLC Python bindings
+# Copyright (C) 2017 Olivier Aubert <contact@olivieraubert.net>
+#
+# 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.
+#
+
+"""VLC Gtk3 Widget classes + example application.
+
+This module provides two helper classes, to ease the embedding of a
+VLC component inside a pygtk application.
+
+VLCWidget is a simple VLC widget.
+
+DecoratedVLCWidget provides simple player controls.
+
+When called as an application, it behaves as a video player.
+"""
+
+import gi
+gi.require_version('Gdk', '3.0')
+gi.require_version('Gtk', '3.0')
+from gi.repository import Gdk
+from gi.repository import Gtk
+
+Gdk.threads_init ()
+
+import sys
+import vlc
+
+from gettext import gettext as _
+
+# Create a single vlc.Instance() to be shared by (possible) multiple players.
+if 'linux' in sys.platform:
+    # Inform libvlc that Xlib is not initialized for threads
+    instance = vlc.Instance("--no-xlib")
+else:
+    instance = vlc.Instance()
+
+class VLCWidget(Gtk.DrawingArea):
+    """Simple VLC widget.
+
+    Its player can be controlled through the 'player' attribute, which
+    is a vlc.MediaPlayer() instance.
+    """
+    __gtype_name__ = 'VLCWidget'
+
+    def __init__(self, *p):
+        Gtk.DrawingArea.__init__(self)
+        self.player = instance.media_player_new()
+        def handle_embed(*args):
+            if sys.platform == 'win32':
+                self.player.set_hwnd(self.get_window().get_handle())
+            else:
+                self.player.set_xwindow(self.get_window().get_xid())
+            return True
+        self.connect("realize", handle_embed)
+        self.set_size_request(320, 200)
+
+class DecoratedVLCWidget(Gtk.VBox):
+    """Decorated VLC widget.
+
+    VLC widget decorated with a player control toolbar.
+
+    Its player can be controlled through the 'player' attribute, which
+    is a Player instance.
+    """
+    __gtype_name__ = 'DecoratedVLCWidget'
+
+    def __init__(self, *p):
+        super(DecoratedVLCWidget, self).__init__()
+        self._vlc_widget = VLCWidget(*p)
+        self.player = self._vlc_widget.player
+        self.add(self._vlc_widget)
+        self._toolbar = self.get_player_control_toolbar()
+        self.pack_start(self._toolbar, False, False, 0)
+        self.show_all()
+
+    def get_player_control_toolbar(self):
+        """Return a player control toolbar
+        """
+        tb = Gtk.Toolbar.new()
+        for text, tooltip, iconname, callback in (
+            (_("Play"), _("Play"), 'gtk-media-play', lambda b: self.player.play()),
+            (_("Pause"), _("Pause"), 'gtk-media-pause', lambda b: self.player.pause()),
+            (_("Stop"), _("Stop"), 'gtk-media-stop', lambda b: self.player.stop()),
+            (_("Quit"), _("Quit"), 'gtk-quit', Gtk.main_quit),
+            ):
+            i = Gtk.Image.new_from_icon_name(iconname, Gtk.IconSize.MENU)
+            b = Gtk.ToolButton(i, text)
+            b.set_tooltip_text(tooltip)
+            b.connect("clicked", callback)
+            tb.insert(b, -1)
+        return tb
+
+class VideoPlayer:
+    """Example simple video player.
+    """
+    def __init__(self):
+        self.vlc = DecoratedVLCWidget()
+
+    def main(self, fname):
+        self.vlc.player.set_media(instance.media_new(fname))
+        w = Gtk.Window()
+        w.add(self.vlc)
+        w.show_all()
+        w.connect("destroy", Gtk.main_quit)
+        Gtk.main()
+
+class MultiVideoPlayer:
+    """Example multi-video player.
+
+    It plays multiple files side-by-side, with per-view and global controls.
+    """
+    def main(self, filenames):
+        # Build main window
+        window=Gtk.Window()
+        mainbox=Gtk.VBox()
+        videos=Gtk.HBox()
+
+        window.add(mainbox)
+        mainbox.add(videos)
+
+        # Create VLC widgets
+        for fname in filenames:
+            v = DecoratedVLCWidget()
+            v.player.set_media(instance.media_new(fname))
+            videos.add(v)
+
+        # Create global toolbar
+        tb = Gtk.Toolbar.new()
+
+        def execute(b, methodname):
+            """Execute the given method on all VLC widgets.
+            """
+            for v in videos.get_children():
+                getattr(v.player, methodname)()
+            return True
+
+        for text, tooltip, iconname, callback, arg in (
+            (_("Play"), _("Global play"), 'gtk-media-play', execute, "play"),
+            (_("Pause"), _("Global pause"), 'gtk-media-pause', execute, "pause"),
+            (_("Stop"), _("Global stop"), 'gtk-media-stop', execute, "stop"),
+            (_("Quit"), _("Quit"), 'gtk-quit', Gtk.main_quit, None),
+            ):
+            i = Gtk.Image.new_from_icon_name(iconname, Gtk.IconSize.MENU)
+            b = Gtk.ToolButton.new(i, text)
+            b.set_tooltip_text(tooltip)
+            b.connect("clicked", callback, arg)
+            tb.insert(b, -1)
+
+        mainbox.pack_start(tb, False, False, 0)
+
+        window.show_all()
+        window.connect("destroy", Gtk.main_quit)
+        Gtk.main()
+
+if __name__ == '__main__':
+    if not sys.argv[1:]:
+       print('You must provide at least 1 movie filename')
+       sys.exit(1)
+    if len(sys.argv[1:]) == 1:
+        # Only 1 file. Simple interface
+        p=VideoPlayer()
+        from evaluator import Evaluator
+        e = Evaluator(globals(), locals())
+        e.popup()
+        p.main(sys.argv[1])
+    else:
+        # Multiple files.
+        p=MultiVideoPlayer()
+        p.main(sys.argv[1:])
+    instance.release()
diff --git a/generated/3.0/examples/qtvlc.py b/generated/3.0/examples/qtvlc.py
new file mode 100755 (executable)
index 0000000..28d8925
--- /dev/null
@@ -0,0 +1,199 @@
+#! /usr/bin/python
+
+#
+# Qt example for VLC Python bindings
+# Copyright (C) 2009-2010 the VideoLAN team
+#
+# 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.
+#
+
+import sys
+import os.path
+import vlc
+from PyQt4 import QtGui, QtCore
+
+class Player(QtGui.QMainWindow):
+    """A simple Media Player using VLC and Qt
+    """
+    def __init__(self, master=None):
+        QtGui.QMainWindow.__init__(self, master)
+        self.setWindowTitle("Media Player")
+
+        # creating a basic vlc instance
+        self.instance = vlc.Instance()
+        # creating an empty vlc media player
+        self.mediaplayer = self.instance.media_player_new()
+
+        self.createUI()
+        self.isPaused = False
+
+    def createUI(self):
+        """Set up the user interface, signals & slots
+        """
+        self.widget = QtGui.QWidget(self)
+        self.setCentralWidget(self.widget)
+
+        # In this widget, the video will be drawn
+        if sys.platform == "darwin": # for MacOS
+            self.videoframe = QtGui.QMacCocoaViewContainer(0)
+        else:
+            self.videoframe = QtGui.QFrame()
+        self.palette = self.videoframe.palette()
+        self.palette.setColor (QtGui.QPalette.Window,
+                               QtGui.QColor(0,0,0))
+        self.videoframe.setPalette(self.palette)
+        self.videoframe.setAutoFillBackground(True)
+
+        self.positionslider = QtGui.QSlider(QtCore.Qt.Horizontal, self)
+        self.positionslider.setToolTip("Position")
+        self.positionslider.setMaximum(1000)
+        self.connect(self.positionslider,
+                     QtCore.SIGNAL("sliderMoved(int)"), self.setPosition)
+
+        self.hbuttonbox = QtGui.QHBoxLayout()
+        self.playbutton = QtGui.QPushButton("Play")
+        self.hbuttonbox.addWidget(self.playbutton)
+        self.connect(self.playbutton, QtCore.SIGNAL("clicked()"),
+                     self.PlayPause)
+
+        self.stopbutton = QtGui.QPushButton("Stop")
+        self.hbuttonbox.addWidget(self.stopbutton)
+        self.connect(self.stopbutton, QtCore.SIGNAL("clicked()"),
+                     self.Stop)
+
+        self.hbuttonbox.addStretch(1)
+        self.volumeslider = QtGui.QSlider(QtCore.Qt.Horizontal, self)
+        self.volumeslider.setMaximum(100)
+        self.volumeslider.setValue(self.mediaplayer.audio_get_volume())
+        self.volumeslider.setToolTip("Volume")
+        self.hbuttonbox.addWidget(self.volumeslider)
+        self.connect(self.volumeslider,
+                     QtCore.SIGNAL("valueChanged(int)"),
+                     self.setVolume)
+
+        self.vboxlayout = QtGui.QVBoxLayout()
+        self.vboxlayout.addWidget(self.videoframe)
+        self.vboxlayout.addWidget(self.positionslider)
+        self.vboxlayout.addLayout(self.hbuttonbox)
+
+        self.widget.setLayout(self.vboxlayout)
+
+        open = QtGui.QAction("&Open", self)
+        self.connect(open, QtCore.SIGNAL("triggered()"), self.OpenFile)
+        exit = QtGui.QAction("&Exit", self)
+        self.connect(exit, QtCore.SIGNAL("triggered()"), sys.exit)
+        menubar = self.menuBar()
+        filemenu = menubar.addMenu("&File")
+        filemenu.addAction(open)
+        filemenu.addSeparator()
+        filemenu.addAction(exit)
+
+        self.timer = QtCore.QTimer(self)
+        self.timer.setInterval(200)
+        self.connect(self.timer, QtCore.SIGNAL("timeout()"),
+                     self.updateUI)
+
+    def PlayPause(self):
+        """Toggle play/pause status
+        """
+        if self.mediaplayer.is_playing():
+            self.mediaplayer.pause()
+            self.playbutton.setText("Play")
+            self.isPaused = True
+        else:
+            if self.mediaplayer.play() == -1:
+                self.OpenFile()
+                return
+            self.mediaplayer.play()
+            self.playbutton.setText("Pause")
+            self.timer.start()
+            self.isPaused = False
+
+    def Stop(self):
+        """Stop player
+        """
+        self.mediaplayer.stop()
+        self.playbutton.setText("Play")
+
+    def OpenFile(self, filename=None):
+        """Open a media file in a MediaPlayer
+        """
+        if filename is None:
+            filename = QtGui.QFileDialog.getOpenFileName(self, "Open File", os.path.expanduser('~'))
+        if not filename:
+            return
+
+        # create the media
+        if sys.version < '3':
+            filename = unicode(filename)
+        self.media = self.instance.media_new(filename)
+        # put the media in the media player
+        self.mediaplayer.set_media(self.media)
+
+        # parse the metadata of the file
+        self.media.parse()
+        # set the title of the track as window title
+        self.setWindowTitle(self.media.get_meta(0))
+
+        # the media player has to be 'connected' to the QFrame
+        # (otherwise a video would be displayed in it's own window)
+        # this is platform specific!
+        # you have to give the id of the QFrame (or similar object) to
+        # vlc, different platforms have different functions for this
+        if sys.platform.startswith('linux'): # for Linux using the X Server
+            self.mediaplayer.set_xwindow(self.videoframe.winId())
+        elif sys.platform == "win32": # for Windows
+            self.mediaplayer.set_hwnd(self.videoframe.winId())
+        elif sys.platform == "darwin": # for MacOS
+            self.mediaplayer.set_nsobject(self.videoframe.winId())
+        self.PlayPause()
+
+    def setVolume(self, Volume):
+        """Set the volume
+        """
+        self.mediaplayer.audio_set_volume(Volume)
+
+    def setPosition(self, position):
+        """Set the position
+        """
+        # setting the position to where the slider was dragged
+        self.mediaplayer.set_position(position / 1000.0)
+        # the vlc MediaPlayer needs a float value between 0 and 1, Qt
+        # uses integer variables, so you need a factor; the higher the
+        # factor, the more precise are the results
+        # (1000 should be enough)
+
+    def updateUI(self):
+        """updates the user interface"""
+        # setting the slider to the desired position
+        self.positionslider.setValue(self.mediaplayer.get_position() * 1000)
+
+        if not self.mediaplayer.is_playing():
+            # no need to call this function if nothing is played
+            self.timer.stop()
+            if not self.isPaused:
+                # after the video finished, the play button stills shows
+                # "Pause", not the desired behavior of a media player
+                # this will fix it
+                self.Stop()
+
+if __name__ == "__main__":
+    app = QtGui.QApplication(sys.argv)
+    player = Player()
+    player.show()
+    player.resize(640, 480)
+    if sys.argv[1:]:
+        player.OpenFile(sys.argv[1])
+    sys.exit(app.exec_())
diff --git a/generated/3.0/examples/tkvlc.py b/generated/3.0/examples/tkvlc.py
new file mode 100755 (executable)
index 0000000..55314ca
--- /dev/null
@@ -0,0 +1,312 @@
+#! /usr/bin/python
+# -*- coding: utf-8 -*-
+
+#
+# tkinter example for VLC Python bindings
+# Copyright (C) 2015 the VideoLAN team
+#
+# 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.
+#
+"""A simple example for VLC python bindings using tkinter. Uses python 3.4
+
+Author: Patrick Fay
+Date: 23-09-2015
+"""
+
+# import external libraries
+import vlc
+import sys
+
+if sys.version_info[0] < 3:
+    import Tkinter as Tk
+    from Tkinter import ttk
+    from Tkinter.filedialog import askopenfilename
+else:
+    import tkinter as Tk
+    from tkinter import ttk
+    from tkinter.filedialog import askopenfilename
+
+# import standard libraries
+import os
+import pathlib
+from threading import Thread, Event
+import time
+import platform
+
+class ttkTimer(Thread):
+    """a class serving same function as wxTimer... but there may be better ways to do this
+    """
+    def __init__(self, callback, tick):
+        Thread.__init__(self)
+        self.callback = callback
+        self.stopFlag = Event()
+        self.tick = tick
+        self.iters = 0
+
+    def run(self):
+        while not self.stopFlag.wait(self.tick):
+            self.iters += 1
+            self.callback()
+
+    def stop(self):
+        self.stopFlag.set()
+
+    def get(self):
+        return self.iters
+
+class Player(Tk.Frame):
+    """The main window has to deal with events.
+    """
+    def __init__(self, parent, title=None):
+        Tk.Frame.__init__(self, parent)
+
+        self.parent = parent
+
+        if title == None:
+            title = "tk_vlc"
+        self.parent.title(title)
+
+        # Menu Bar
+        #   File Menu
+        menubar = Tk.Menu(self.parent)
+        self.parent.config(menu=menubar)
+
+        fileMenu = Tk.Menu(menubar)
+        fileMenu.add_command(label="Open", underline=0, command=self.OnOpen)
+        fileMenu.add_command(label="Exit", underline=1, command=_quit)
+        menubar.add_cascade(label="File", menu=fileMenu)
+
+        # The second panel holds controls
+        self.player = None
+        self.videopanel = ttk.Frame(self.parent)
+        self.canvas = Tk.Canvas(self.videopanel).pack(fill=Tk.BOTH,expand=1)
+        self.videopanel.pack(fill=Tk.BOTH,expand=1)
+
+        ctrlpanel = ttk.Frame(self.parent)
+        pause  = ttk.Button(ctrlpanel, text="Pause", command=self.OnPause)
+        play   = ttk.Button(ctrlpanel, text="Play", command=self.OnPlay)
+        stop   = ttk.Button(ctrlpanel, text="Stop", command=self.OnStop)
+        volume = ttk.Button(ctrlpanel, text="Volume", command=self.OnSetVolume)
+        pause.pack(side=Tk.LEFT)
+        play.pack(side=Tk.LEFT)
+        stop.pack(side=Tk.LEFT)
+        volume.pack(side=Tk.LEFT)
+        self.volume_var = Tk.IntVar()
+        self.volslider = Tk.Scale(ctrlpanel, variable=self.volume_var, command=self.volume_sel,
+                from_=0, to=100, orient=Tk.HORIZONTAL, length=100)
+        self.volslider.pack(side=Tk.LEFT)
+        ctrlpanel.pack(side=Tk.BOTTOM)
+
+        ctrlpanel2 = ttk.Frame(self.parent)
+        self.scale_var = Tk.DoubleVar()
+        self.timeslider_last_val = ""
+        self.timeslider = Tk.Scale(ctrlpanel2, variable=self.scale_var, command=self.scale_sel,
+                from_=0, to=1000, orient=Tk.HORIZONTAL, length=500)
+        self.timeslider.pack(side=Tk.BOTTOM, fill=Tk.X,expand=1)
+        self.timeslider_last_update = time.time()
+        ctrlpanel2.pack(side=Tk.BOTTOM,fill=Tk.X)
+
+
+        # VLC player controls
+        self.Instance = vlc.Instance()
+        self.player = self.Instance.media_player_new()
+
+        # below is a test, now use the File->Open file menu
+        #media = self.Instance.media_new('output.mp4')
+        #self.player.set_media(media)
+        #self.player.play() # hit the player button
+        #self.player.video_set_deinterlace(str_to_bytes('yadif'))
+
+        self.timer = ttkTimer(self.OnTimer, 1.0)
+        self.timer.start()
+        self.parent.update()
+
+        #self.player.set_hwnd(self.GetHandle()) # for windows, OnOpen does does this
+
+
+    def OnExit(self, evt):
+        """Closes the window.
+        """
+        self.Close()
+
+    def OnOpen(self):
+        """Pop up a new dialow window to choose a file, then play the selected file.
+        """
+        # if a file is already running, then stop it.
+        self.OnStop()
+
+        # Create a file dialog opened in the current home directory, where
+        # you can display all kind of files, having as title "Choose a file".
+        p = pathlib.Path(os.path.expanduser("~"))
+        fullname =  askopenfilename(initialdir = p, title = "choose your file",filetypes = (("all files","*.*"),("mp4 files","*.mp4")))
+        if os.path.isfile(fullname):
+            dirname  = os.path.dirname(fullname)
+            filename = os.path.basename(fullname)
+            # Creation
+            self.Media = self.Instance.media_new(str(os.path.join(dirname, filename)))
+            self.player.set_media(self.Media)
+            # Report the title of the file chosen
+            #title = self.player.get_title()
+            #  if an error was encountred while retriving the title, then use
+            #  filename
+            #if title == -1:
+            #    title = filename
+            #self.SetTitle("%s - tkVLCplayer" % title)
+
+            # set the window id where to render VLC's video output
+            if platform.system() == 'Windows':
+                self.player.set_hwnd(self.GetHandle())
+            else:
+                self.player.set_xwindow(self.GetHandle()) # this line messes up windows
+            # FIXME: this should be made cross-platform
+            self.OnPlay()
+
+            # set the volume slider to the current volume
+            #self.volslider.SetValue(self.player.audio_get_volume() / 2)
+            self.volslider.set(self.player.audio_get_volume())
+
+    def OnPlay(self):
+        """Toggle the status to Play/Pause.
+        If no file is loaded, open the dialog window.
+        """
+        # check if there is a file to play, otherwise open a
+        # Tk.FileDialog to select a file
+        if not self.player.get_media():
+            self.OnOpen()
+        else:
+            # Try to launch the media, if this fails display an error message
+            if self.player.play() == -1:
+                self.errorDialog("Unable to play.")
+
+    def GetHandle(self):
+        return self.videopanel.winfo_id()
+
+    #def OnPause(self, evt):
+    def OnPause(self):
+        """Pause the player.
+        """
+        self.player.pause()
+
+    def OnStop(self):
+        """Stop the player.
+        """
+        self.player.stop()
+        # reset the time slider
+        self.timeslider.set(0)
+
+    def OnTimer(self):
+        """Update the time slider according to the current movie time.
+        """
+        if self.player == None:
+            return
+        # since the self.player.get_length can change while playing,
+        # re-set the timeslider to the correct range.
+        length = self.player.get_length()
+        dbl = length * 0.001
+        self.timeslider.config(to=dbl)
+
+        # update the time on the slider
+        tyme = self.player.get_time()
+        if tyme == -1:
+            tyme = 0
+        dbl = tyme * 0.001
+        self.timeslider_last_val = ("%.0f" % dbl) + ".0"
+        # don't want to programatically change slider while user is messing with it.
+        # wait 2 seconds after user lets go of slider
+        if time.time() > (self.timeslider_last_update + 2.0):
+            self.timeslider.set(dbl)
+
+    def scale_sel(self, evt):
+        if self.player == None:
+            return
+        nval = self.scale_var.get()
+        sval = str(nval)
+        if self.timeslider_last_val != sval:
+            # this is a hack. The timer updates the time slider.
+            # This change causes this rtn (the 'slider has changed' rtn) to be invoked.
+            # I can't tell the difference between when the user has manually moved the slider and when
+            # the timer changed the slider. But when the user moves the slider tkinter only notifies
+            # this rtn about once per second and when the slider has quit moving.
+            # Also, the tkinter notification value has no fractional seconds.
+            # The timer update rtn saves off the last update value (rounded to integer seconds) in timeslider_last_val
+            # if the notification time (sval) is the same as the last saved time timeslider_last_val then
+            # we know that this notification is due to the timer changing the slider.
+            # otherwise the notification is due to the user changing the slider.
+            # if the user is changing the slider then I have the timer routine wait for at least
+            # 2 seconds before it starts updating the slider again (so the timer doesn't start fighting with the
+            # user)
+            self.timeslider_last_update = time.time()
+            mval = "%.0f" % (nval * 1000)
+            self.player.set_time(int(mval)) # expects milliseconds
+
+
+    def volume_sel(self, evt):
+        if self.player == None:
+            return
+        volume = self.volume_var.get()
+        if volume > 100:
+            volume = 100
+        if self.player.audio_set_volume(volume) == -1:
+            self.errorDialog("Failed to set volume")
+
+
+
+    def OnToggleVolume(self, evt):
+        """Mute/Unmute according to the audio button.
+        """
+        is_mute = self.player.audio_get_mute()
+
+        self.player.audio_set_mute(not is_mute)
+        # update the volume slider;
+        # since vlc volume range is in [0, 200],
+        # and our volume slider has range [0, 100], just divide by 2.
+        self.volume_var.set(self.player.audio_get_volume())
+
+    def OnSetVolume(self):
+        """Set the volume according to the volume sider.
+        """
+        volume = self.volume_var.get()
+        # vlc.MediaPlayer.audio_set_volume returns 0 if success, -1 otherwise
+        if volume > 100:
+            volume = 100
+        if self.player.audio_set_volume(volume) == -1:
+            self.errorDialog("Failed to set volume")
+
+    def errorDialog(self, errormessage):
+        """Display a simple error dialog.
+        """
+        Tk.tkMessageBox.showerror(self, 'Error', errormessage)
+
+def Tk_get_root():
+    if not hasattr(Tk_get_root, "root"): #(1)
+        Tk_get_root.root= Tk.Tk()  #initialization call is inside the function
+    return Tk_get_root.root
+
+def _quit():
+    print("_quit: bye")
+    root = Tk_get_root()
+    root.quit()     # stops mainloop
+    root.destroy()  # this is necessary on Windows to prevent
+                    # Fatal Python Error: PyEval_RestoreThread: NULL tstate
+    os._exit(1)
+
+if __name__ == "__main__":
+    # Create a Tk.App(), which handles the windowing system event loop
+    root = Tk_get_root()
+    root.protocol("WM_DELETE_WINDOW", _quit)
+
+    player = Player(root, title="tkinter vlc")
+    # show the player window centred and run the application
+    root.mainloop()
diff --git a/generated/3.0/examples/wxvlc.py b/generated/3.0/examples/wxvlc.py
new file mode 100755 (executable)
index 0000000..9e71c63
--- /dev/null
@@ -0,0 +1,230 @@
+#! /usr/bin/python
+# -*- coding: utf-8 -*-
+
+#
+# WX example for VLC Python bindings
+# Copyright (C) 2009-2010 the VideoLAN team
+#
+# 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.
+#
+"""
+A simple example for VLC python bindings using wxPython.
+
+Author: Michele OrrĂ¹
+Date: 23-11-2010
+"""
+
+# import external libraries
+import wx # 2.8
+import vlc
+
+# import standard libraries
+import os
+import sys
+
+class Player(wx.Frame):
+    """The main window has to deal with events.
+    """
+    def __init__(self, title):
+        wx.Frame.__init__(self, None, -1, title,
+                          pos=wx.DefaultPosition, size=(550, 500))
+
+        # Menu Bar
+        #   File Menu
+        self.frame_menubar = wx.MenuBar()
+        self.file_menu = wx.Menu()
+        self.file_menu.Append(1, "&Open", "Open from file..")
+        self.file_menu.AppendSeparator()
+        self.file_menu.Append(2, "&Close", "Quit")
+        self.Bind(wx.EVT_MENU, self.OnOpen, id=1)
+        self.Bind(wx.EVT_MENU, self.OnExit, id=2)
+        self.frame_menubar.Append(self.file_menu, "File")
+        self.SetMenuBar(self.frame_menubar)
+
+        # Panels
+        # The first panel holds the video and it's all black
+        self.videopanel = wx.Panel(self, -1)
+        self.videopanel.SetBackgroundColour(wx.BLACK)
+
+        # The second panel holds controls
+        ctrlpanel = wx.Panel(self, -1 )
+        self.timeslider = wx.Slider(ctrlpanel, -1, 0, 0, 1000)
+        self.timeslider.SetRange(0, 1000)
+        pause  = wx.Button(ctrlpanel, label="Pause")
+        play   = wx.Button(ctrlpanel, label="Play")
+        stop   = wx.Button(ctrlpanel, label="Stop")
+        volume = wx.Button(ctrlpanel, label="Volume")
+        self.volslider = wx.Slider(ctrlpanel, -1, 0, 0, 100, size=(100, -1))
+
+        # Bind controls to events
+        self.Bind(wx.EVT_BUTTON, self.OnPlay, play)
+        self.Bind(wx.EVT_BUTTON, self.OnPause, pause)
+        self.Bind(wx.EVT_BUTTON, self.OnStop, stop)
+        self.Bind(wx.EVT_BUTTON, self.OnToggleVolume, volume)
+        self.Bind(wx.EVT_SLIDER, self.OnSetVolume, self.volslider)
+
+        # Give a pretty layout to the controls
+        ctrlbox = wx.BoxSizer(wx.VERTICAL)
+        box1 = wx.BoxSizer(wx.HORIZONTAL)
+        box2 = wx.BoxSizer(wx.HORIZONTAL)
+        # box1 contains the timeslider
+        box1.Add(self.timeslider, 1)
+        # box2 contains some buttons and the volume controls
+        box2.Add(play, flag=wx.RIGHT, border=5)
+        box2.Add(pause)
+        box2.Add(stop)
+        box2.Add((-1, -1), 1)
+        box2.Add(volume)
+        box2.Add(self.volslider, flag=wx.TOP | wx.LEFT, border=5)
+        # Merge box1 and box2 to the ctrlsizer
+        ctrlbox.Add(box1, flag=wx.EXPAND | wx.BOTTOM, border=10)
+        ctrlbox.Add(box2, 1, wx.EXPAND)
+        ctrlpanel.SetSizer(ctrlbox)
+        # Put everything togheter
+        sizer = wx.BoxSizer(wx.VERTICAL)
+        sizer.Add(self.videopanel, 1, flag=wx.EXPAND)
+        sizer.Add(ctrlpanel, flag=wx.EXPAND | wx.BOTTOM | wx.TOP, border=10)
+        self.SetSizer(sizer)
+        self.SetMinSize((350, 300))
+
+        # finally create the timer, which updates the timeslider
+        self.timer = wx.Timer(self)
+        self.Bind(wx.EVT_TIMER, self.OnTimer, self.timer)
+
+        # VLC player controls
+        self.Instance = vlc.Instance()
+        self.player = self.Instance.media_player_new()
+
+    def OnExit(self, evt):
+        """Closes the window.
+        """
+        self.Close()
+
+    def OnOpen(self, evt):
+        """Pop up a new dialow window to choose a file, then play the selected file.
+        """
+        # if a file is already running, then stop it.
+        self.OnStop(None)
+
+        # Create a file dialog opened in the current home directory, where
+        # you can display all kind of files, having as title "Choose a file".
+        dlg = wx.FileDialog(self, "Choose a file", os.path.expanduser('~'), "",
+                            "*.*", wx.OPEN)
+        if dlg.ShowModal() == wx.ID_OK:
+            dirname = dlg.GetDirectory()
+            filename = dlg.GetFilename()
+            # Creation
+            self.Media = self.Instance.media_new(unicode(os.path.join(dirname, filename)))
+            self.player.set_media(self.Media)
+            # Report the title of the file chosen
+            title = self.player.get_title()
+            #  if an error was encountred while retriving the title, then use
+            #  filename
+            if title == -1:
+                title = filename
+            self.SetTitle("%s - wxVLCplayer" % title)
+
+            # set the window id where to render VLC's video output
+            handle = self.videopanel.GetHandle()
+            if sys.platform.startswith('linux'): # for Linux using the X Server
+                self.player.set_xwindow(handle)
+            elif sys.platform == "win32": # for Windows
+                self.player.set_hwnd(handle)
+            elif sys.platform == "darwin": # for MacOS
+                self.player.set_nsobject(handle)
+            self.OnPlay(None)
+
+            # set the volume slider to the current volume
+            self.volslider.SetValue(self.player.audio_get_volume() / 2)
+
+        # finally destroy the dialog
+        dlg.Destroy()
+
+    def OnPlay(self, evt):
+        """Toggle the status to Play/Pause.
+
+        If no file is loaded, open the dialog window.
+        """
+        # check if there is a file to play, otherwise open a
+        # wx.FileDialog to select a file
+        if not self.player.get_media():
+            self.OnOpen(None)
+        else:
+            # Try to launch the media, if this fails display an error message
+            if self.player.play() == -1:
+                self.errorDialog("Unable to play.")
+            else:
+                self.timer.Start()
+
+    def OnPause(self, evt):
+        """Pause the player.
+        """
+        self.player.pause()
+
+    def OnStop(self, evt):
+        """Stop the player.
+        """
+        self.player.stop()
+        # reset the time slider
+        self.timeslider.SetValue(0)
+        self.timer.Stop()
+
+    def OnTimer(self, evt):
+        """Update the time slider according to the current movie time.
+        """
+        # since the self.player.get_length can change while playing,
+        # re-set the timeslider to the correct range.
+        length = self.player.get_length()
+        self.timeslider.SetRange(-1, length)
+
+        # update the time on the slider
+        time = self.player.get_time()
+        self.timeslider.SetValue(time)
+
+    def OnToggleVolume(self, evt):
+        """Mute/Unmute according to the audio button.
+        """
+        is_mute = self.player.audio_get_mute()
+
+        self.player.audio_set_mute(not is_mute)
+        # update the volume slider;
+        # since vlc volume range is in [0, 200],
+        # and our volume slider has range [0, 100], just divide by 2.
+        self.volslider.SetValue(self.player.audio_get_volume() / 2)
+
+    def OnSetVolume(self, evt):
+        """Set the volume according to the volume sider.
+        """
+        volume = self.volslider.GetValue() * 2
+        # vlc.MediaPlayer.audio_set_volume returns 0 if success, -1 otherwise
+        if self.player.audio_set_volume(volume) == -1:
+            self.errorDialog("Failed to set volume")
+
+    def errorDialog(self, errormessage):
+        """Display a simple error dialog.
+        """
+        edialog = wx.MessageDialog(self, errormessage, 'Error', wx.OK|
+                                                                wx.ICON_ERROR)
+        edialog.ShowModal()
+
+if __name__ == "__main__":
+    # Create a wx.App(), which handles the windowing system event loop
+    app = wx.PySimpleApp()
+    # Create the window containing our small media player
+    player = Player("Simple PyVLC Player")
+    # show the player window centred and run the application
+    player.Centre()
+    player.Show()
+    app.MainLoop()
diff --git a/generated/3.0/setup.py b/generated/3.0/setup.py
new file mode 100644 (file)
index 0000000..2a15dea
--- /dev/null
@@ -0,0 +1,39 @@
+from distribute_setup import use_setuptools
+use_setuptools()
+
+from setuptools import setup
+
+setup(name='python-vlc',
+      version = '3.0.0101',
+      author='Olivier Aubert',
+      author_email='contact@olivieraubert.net',
+      maintainer='Olivier Aubert',
+      maintainer_email='contact@olivieraubert.net',
+      url='http://wiki.videolan.org/PythonBinding',
+      py_modules=['vlc'],
+      keywords = [ 'vlc', 'video' ],
+      license = "GPL",
+      classifiers = [
+          "Development Status :: 5 - Production/Stable",
+          "Intended Audience :: Developers",
+          "License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)",
+          "Operating System :: MacOS :: MacOS X",
+          "Operating System :: Microsoft :: Windows",
+          "Operating System :: POSIX :: Linux",
+          "Operating System :: POSIX :: Other",
+          "Programming Language :: Python",
+          "Programming Language :: Python :: 2",
+          "Programming Language :: Python :: 3",
+          "Topic :: Multimedia",
+          "Topic :: Multimedia :: Sound/Audio",
+          "Topic :: Multimedia :: Video",
+      ],
+      description = "VLC bindings for python.",
+      long_description = """This module provides ctypes-based bindings (see
+      http://wiki.videolan.org/PythonBinding) for the native libvlc
+      API (see http://wiki.videolan.org/LibVLC) of the VLC video
+      player.
+
+      It has been automatically generated from the include files of
+      vlc 3.0.0, using generator 1.1.
+      """)
diff --git a/generated/3.0/vlc.py b/generated/3.0/vlc.py
new file mode 100644 (file)
index 0000000..5f16932
--- /dev/null
@@ -0,0 +1,8440 @@
+#! /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__ = "3.0.0101"
+__libvlc_version__ = "3.0.0"
+__generator_version__ = "1.1"
+build_date  = "Thu Jan  4 23:45:25 2018 3.0.0"
+
+# 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
+    def str_to_bytes(s):
+        """Translate string or bytes to bytes.
+        """
+        if isinstance(s, unicode):
+            return s.encode(DEFAULT_ENCODING)
+        else:
+            return s
+
+    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()
+
+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()
+
+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.
+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
+
+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_
+
+class ListPOINTER(object):
+    """Just like a POINTER but accept a list of ctype as an argument.
+    """
+    def __init__(self, etype):
+        self.etype = etype
+
+    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.
+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
+
+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
+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
+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)
+
+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)
+
+class MediaDiscovererCategory(_Enum):
+    '''Category of a media discoverer
+See libvlc_media_discoverer_list_get().
+    '''
+    _enum_names_ = {
+        0: 'devices',
+        1: 'lan',
+        2: 'podcasts',
+        3: 'localdirs',
+    }
+MediaDiscovererCategory.devices   = MediaDiscovererCategory(0)
+MediaDiscovererCategory.lan       = MediaDiscovererCategory(1)
+MediaDiscovererCategory.localdirs = MediaDiscovererCategory(3)
+MediaDiscovererCategory.podcasts  = MediaDiscovererCategory(2)
+
+class DialogQuestionType(_Enum):
+    '''@defgroup libvlc_dialog libvlc dialog
+@ingroup libvlc
+@{
+@file
+libvlc dialog external api.
+    '''
+    _enum_names_ = {
+        0: 'NORMAL',
+        1: 'WARNING',
+        2: 'CRITICAL',
+    }
+DialogQuestionType.CRITICAL = DialogQuestionType(2)
+DialogQuestionType.NORMAL   = DialogQuestionType(0)
+DialogQuestionType.WARNING  = DialogQuestionType(1)
+
+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',
+        276: 'MediaPlayerESAdded',
+        277: 'MediaPlayerESDeleted',
+        278: 'MediaPlayerESSelected',
+        279: 'MediaPlayerCorked',
+        280: 'MediaPlayerUncorked',
+        281: 'MediaPlayerMuted',
+        282: 'MediaPlayerUnmuted',
+        283: 'MediaPlayerAudioVolume',
+        284: 'MediaPlayerAudioDevice',
+        285: 'MediaPlayerChapterChanged',
+        0x200: 'MediaListItemAdded',
+        513: 'MediaListWillAddItem',
+        514: 'MediaListItemDeleted',
+        515: 'MediaListWillDeleteItem',
+        516: 'MediaListEndReached',
+        0x300: 'MediaListViewItemAdded',
+        769: 'MediaListViewWillAddItem',
+        770: 'MediaListViewItemDeleted',
+        771: 'MediaListViewWillDeleteItem',
+        0x400: 'MediaListPlayerPlayed',
+        1025: 'MediaListPlayerNextItemSet',
+        1026: 'MediaListPlayerStopped',
+        0x500: 'MediaDiscovererStarted',
+        1281: 'MediaDiscovererEnded',
+        1282: 'RendererDiscovererItemAdded',
+        1283: 'RendererDiscovererItemDeleted',
+        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.MediaListEndReached           = EventType(516)
+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.MediaPlayerAudioDevice        = EventType(284)
+EventType.MediaPlayerAudioVolume        = EventType(283)
+EventType.MediaPlayerBackward           = EventType(264)
+EventType.MediaPlayerBuffering          = EventType(259)
+EventType.MediaPlayerChapterChanged     = EventType(285)
+EventType.MediaPlayerCorked             = EventType(279)
+EventType.MediaPlayerESAdded            = EventType(276)
+EventType.MediaPlayerESDeleted          = EventType(277)
+EventType.MediaPlayerESSelected         = EventType(278)
+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.RendererDiscovererItemAdded   = EventType(1282)
+EventType.RendererDiscovererItemDeleted = EventType(1283)
+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)
+
+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',
+        23: 'AlbumArtist',
+        24: 'DiscNumber',
+        25: 'DiscTotal',
+    }
+Meta.Actors      = Meta(22)
+Meta.Album       = Meta(4)
+Meta.AlbumArtist = Meta(23)
+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.DiscNumber  = Meta(24)
+Meta.DiscTotal   = Meta(25)
+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)
+
+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, 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)
+
+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)
+
+class VideoOrient(_Enum):
+    '''N/A
+    '''
+    _enum_names_ = {
+        0: 'left',
+        1: 'right',
+        2: 'left',
+        3: 'right',
+        4: 'top',
+        5: 'bottom',
+        6: 'top',
+        7: 'bottom',
+    }
+VideoOrient.bottom = VideoOrient(5)
+VideoOrient.bottom = VideoOrient(7)
+VideoOrient.left   = VideoOrient(0)
+VideoOrient.left   = VideoOrient(2)
+VideoOrient.right  = VideoOrient(1)
+VideoOrient.right  = VideoOrient(3)
+VideoOrient.top    = VideoOrient(4)
+VideoOrient.top    = VideoOrient(6)
+
+class VideoProjection(_Enum):
+    '''N/A
+    '''
+    _enum_names_ = {
+        0: 'rectangular',
+        1: 'equirectangular',
+        0x100: 'standard',
+    }
+VideoProjection.equirectangular = VideoProjection(1)
+VideoProjection.rectangular     = VideoProjection(0)
+VideoProjection.standard        = VideoProjection(0x100)
+
+class MediaType(_Enum):
+    '''Media type
+See libvlc_media_get_type.
+    '''
+    _enum_names_ = {
+        0: 'unknown',
+        1: 'file',
+        2: 'directory',
+        3: 'disc',
+        4: 'stream',
+        5: 'playlist',
+    }
+MediaType.directory = MediaType(2)
+MediaType.disc      = MediaType(3)
+MediaType.file      = MediaType(1)
+MediaType.playlist  = MediaType(5)
+MediaType.stream    = MediaType(4)
+MediaType.unknown   = MediaType(0)
+
+class MediaParseFlag(_Enum):
+    '''Parse flags used by libvlc_media_parse_with_options()
+See libvlc_media_parse_with_options.
+    '''
+    _enum_names_ = {
+        0x0: 'local',
+        0x1: 'network',
+        0x2: 'local',
+        0x4: 'network',
+        0x8: 'interact',
+    }
+MediaParseFlag.interact = MediaParseFlag(0x8)
+MediaParseFlag.local    = MediaParseFlag(0x0)
+MediaParseFlag.local    = MediaParseFlag(0x2)
+MediaParseFlag.network  = MediaParseFlag(0x1)
+MediaParseFlag.network  = MediaParseFlag(0x4)
+
+class MediaParsedStatus(_Enum):
+    '''Parse status used sent by libvlc_media_parse_with_options() or returned by
+libvlc_media_get_parsed_status()
+See libvlc_media_parse_with_options
+See libvlc_media_get_parsed_status.
+    '''
+    _enum_names_ = {
+        1: 'skipped',
+        2: 'failed',
+        3: 'timeout',
+        4: 'done',
+    }
+MediaParsedStatus.done    = MediaParsedStatus(4)
+MediaParsedStatus.failed  = MediaParsedStatus(2)
+MediaParsedStatus.skipped = MediaParsedStatus(1)
+MediaParsedStatus.timeout = MediaParsedStatus(3)
+
+class MediaSlaveType(_Enum):
+    '''Type of a media slave: subtitle or audio.
+    '''
+    _enum_names_ = {
+        0: 'subtitle',
+        1: 'audio',
+    }
+MediaSlaveType.audio    = MediaSlaveType(1)
+MediaSlaveType.subtitle = MediaSlaveType(0)
+
+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)
+
+class NavigateMode(_Enum):
+    '''Navigation mode.
+    '''
+    _enum_names_ = {
+        0: 'activate',
+        1: 'up',
+        2: 'down',
+        3: 'left',
+        4: 'right',
+        5: 'popup',
+    }
+NavigateMode.activate = NavigateMode(0)
+NavigateMode.down     = NavigateMode(2)
+NavigateMode.left     = NavigateMode(3)
+NavigateMode.popup    = NavigateMode(5)
+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)
+
+class TeletextKey(_Enum):
+    '''Enumeration of teletext keys than can be passed via
+libvlc_video_set_teletext().
+    '''
+    _enum_names_ = {
+        7471104: 'red',
+        6750208: 'green',
+        7929856: 'yellow',
+        6422528: 'blue',
+        6881280: 'index',
+    }
+TeletextKey.blue   = TeletextKey(6422528)
+TeletextKey.green  = TeletextKey(6750208)
+TeletextKey.index  = TeletextKey(6881280)
+TeletextKey.red    = TeletextKey(7471104)
+TeletextKey.yellow = TeletextKey(7929856)
+
+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)
+
+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)
+
+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)
+
+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)
+
+class MediaPlayerRole(_Enum):
+    '''Media player roles.
+\version libvlc 3.0.0 and later.
+see \ref libvlc_media_player_set_role().
+    '''
+    _enum_names_ = {
+        0: '_None',
+        1: 'Music',
+        2: 'Video',
+        3: 'Communication',
+        4: 'Game',
+        5: 'Notification',
+        6: 'Animation',
+        7: 'Production',
+        8: 'Accessibility',
+        9: 'Test',
+    }
+MediaPlayerRole.Accessibility = MediaPlayerRole(8)
+MediaPlayerRole.Animation     = MediaPlayerRole(6)
+MediaPlayerRole.Communication = MediaPlayerRole(3)
+MediaPlayerRole.Game          = MediaPlayerRole(4)
+MediaPlayerRole.Music         = MediaPlayerRole(1)
+MediaPlayerRole.Notification  = MediaPlayerRole(5)
+MediaPlayerRole.Production    = MediaPlayerRole(7)
+MediaPlayerRole.Test          = MediaPlayerRole(9)
+MediaPlayerRole.Video         = MediaPlayerRole(2)
+MediaPlayerRole._None         = MediaPlayerRole(0)
+
+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)
+
+class Callback(ctypes.c_void_p):
+    """Callback function notification.
+    @param p_event: the event triggering the callback.
+    """
+    pass
+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 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
+class MediaOpenCb(ctypes.c_void_p):
+    """Callback prototype to open a custom bitstream input media.
+    The same media item can be opened multiple times. Each time, this callback
+    is invoked. It should allocate and initialize any instance-specific
+    resources, then store them in *datap. The instance resources can be freed
+    in the @ref libvlc_media_close_cb callback.
+    @param opaque: private pointer as passed to L{libvlc_media_new_callbacks}().
+    @return: datap storage space for a private data pointer, sizep byte length of the bitstream or UINT64_MAX if unknown.
+    """
+    pass
+class MediaReadCb(ctypes.c_void_p):
+    """Callback prototype to read data from a custom bitstream input media.
+    @param opaque: private pointer as set by the @ref libvlc_media_open_cb callback.
+    @param buf: start address of the buffer to read data into.
+    @param len: bytes length of the buffer.
+    @return: strictly positive number of bytes read, 0 on end-of-stream, or -1 on non-recoverable error @note If no data is immediately available, then the callback should sleep. @warning The application is responsible for avoiding deadlock situations. In particular, the callback should return an error if playback is stopped; if it does not return, then L{libvlc_media_player_stop}() will never return.
+    """
+    pass
+class MediaSeekCb(ctypes.c_void_p):
+    """Callback prototype to seek a custom bitstream input media.
+    @param opaque: private pointer as set by the @ref libvlc_media_open_cb callback.
+    @param offset: absolute byte offset to seek to.
+    @return: 0 on success, -1 on error.
+    """
+    pass
+class MediaCloseCb(ctypes.c_void_p):
+    """Callback prototype to close a custom bitstream input media.
+    @param opaque: private pointer as set by the @ref libvlc_media_open_cb callback.
+    """
+    pass
+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
+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.
+    @note: 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
+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
+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
+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
+class AudioPlayCb(ctypes.c_void_p):
+    """Callback prototype for audio playback.
+    The LibVLC media player decodes and post-processes the audio signal
+    asynchronously (in an internal thread). Whenever audio samples are ready
+    to be queued to the output, this callback is invoked.
+    The number of samples provided per invocation may depend on the file format,
+    the audio coding algorithm, the decoder plug-in, the post-processing
+    filters and timing. Application must not assume a certain number of samples.
+    The exact format of audio samples is determined by L{libvlc_audio_set_format}()
+    or L{libvlc_audio_set_format_callbacks}() as is the channels layout.
+    Note that the number of samples is per channel. For instance, if the audio
+    track sampling rate is 48000 Hz, then 1200 samples represent 25 milliseconds
+    of audio signal - regardless of the number of audio channels.
+    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
+    @param samples: pointer to a table of audio samples to play back [IN].
+    @param count: number of audio samples to play back.
+    @param pts: expected play time stamp (see libvlc_delay()).
+    """
+    pass
+class AudioPauseCb(ctypes.c_void_p):
+    """Callback prototype for audio pause.
+    LibVLC invokes this callback to pause audio playback.
+    @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
+class AudioResumeCb(ctypes.c_void_p):
+    """Callback prototype for audio resumption.
+    LibVLC invokes this callback to resume audio playback after it was
+    previously paused.
+    @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
+class AudioFlushCb(ctypes.c_void_p):
+    """Callback prototype for audio buffer flush.
+    LibVLC invokes this callback if it needs to discard all pending buffers and
+    stop playback as soon as possible. This typically occurs when the media is
+    stopped.
+    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
+    """
+    pass
+class AudioDrainCb(ctypes.c_void_p):
+    """Callback prototype for audio buffer drain.
+    LibVLC may invoke this callback when the decoded audio track is ending.
+    There will be no further decoded samples for the track, but playback should
+    nevertheless continue until all already pending buffers are rendered.
+    @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
+    """
+    pass
+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
+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
+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
+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 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.
+    ''' 
+    MediaOpenCb = ctypes.CFUNCTYPE(ctypes.POINTER(ctypes.c_int), ctypes.c_void_p, ctypes.POINTER(ctypes.c_void_p), ctypes.POINTER(ctypes.c_uint64))
+    MediaOpenCb.__doc__ = '''Callback prototype to open a custom bitstream input media.
+        The same media item can be opened multiple times. Each time, this callback
+        is invoked. It should allocate and initialize any instance-specific
+        resources, then store them in *datap. The instance resources can be freed
+        in the @ref libvlc_media_close_cb callback.
+        @param opaque: private pointer as passed to L{libvlc_media_new_callbacks}().
+        @return: datap storage space for a private data pointer, sizep byte length of the bitstream or UINT64_MAX if unknown.
+    ''' 
+    MediaReadCb = ctypes.CFUNCTYPE(ctypes.POINTER(ctypes.c_ssize_t), ctypes.c_void_p, ctypes.c_char_p, ctypes.c_size_t)
+    MediaReadCb.__doc__ = '''Callback prototype to read data from a custom bitstream input media.
+        @param opaque: private pointer as set by the @ref libvlc_media_open_cb callback.
+        @param buf: start address of the buffer to read data into.
+        @param len: bytes length of the buffer.
+        @return: strictly positive number of bytes read, 0 on end-of-stream, or -1 on non-recoverable error @note If no data is immediately available, then the callback should sleep. @warning The application is responsible for avoiding deadlock situations. In particular, the callback should return an error if playback is stopped; if it does not return, then L{libvlc_media_player_stop}() will never return.
+    ''' 
+    MediaSeekCb = ctypes.CFUNCTYPE(ctypes.POINTER(ctypes.c_int), ctypes.c_void_p, ctypes.c_uint64)
+    MediaSeekCb.__doc__ = '''Callback prototype to seek a custom bitstream input media.
+        @param opaque: private pointer as set by the @ref libvlc_media_open_cb callback.
+        @param offset: absolute byte offset to seek to.
+        @return: 0 on success, -1 on error.
+    ''' 
+    MediaCloseCb = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p)
+    MediaCloseCb.__doc__ = '''Callback prototype to close a custom bitstream input media.
+        @param opaque: private pointer as set by the @ref libvlc_media_open_cb callback.
+    ''' 
+    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.
+        @note: 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.
+        The LibVLC media player decodes and post-processes the audio signal
+        asynchronously (in an internal thread). Whenever audio samples are ready
+        to be queued to the output, this callback is invoked.
+        The number of samples provided per invocation may depend on the file format,
+        the audio coding algorithm, the decoder plug-in, the post-processing
+        filters and timing. Application must not assume a certain number of samples.
+        The exact format of audio samples is determined by L{libvlc_audio_set_format}()
+        or L{libvlc_audio_set_format_callbacks}() as is the channels layout.
+        Note that the number of samples is per channel. For instance, if the audio
+        track sampling rate is 48000 Hz, then 1200 samples represent 25 milliseconds
+        of audio signal - regardless of the number of audio channels.
+        @param data: data pointer as passed to L{libvlc_audio_set_callbacks}() [IN].
+        @param samples: pointer to a table of audio samples 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.
+        LibVLC invokes this callback to pause audio playback.
+        @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.
+        LibVLC invokes this callback to resume audio playback after it was
+        previously paused.
+        @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.
+        LibVLC invokes this callback if it needs to discard all pending buffers and
+        stop playback as soon as possible. This typically occurs when the media is
+        stopped.
+        @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.
+        LibVLC may invoke this callback when the decoded audio track is ending.
+        There will be no further decoded samples for the track, but playback should
+        nevertheless continue until all already pending buffers are rendered.
+        @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
+
+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)),
+    ]
+
+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)
+
+class MediaEvent(_Cstruct):
+    _fields_ = [
+        ('media_name',    ctypes.c_char_p),
+        ('instance_name', ctypes.c_char_p),
+    ]
+
+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),
+    ]
+
+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  ),
+    ]
+
+class AudioTrack(_Cstruct):
+    _fields_ = [
+        ('channels', ctypes.c_uint),
+        ('rate', ctypes.c_uint),
+        ]
+
+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),
+        ]
+
+class SubtitleTrack(_Cstruct):
+    _fields_ = [
+        ('encoding', ctypes.c_char_p),
+        ]
+
+class MediaTrackTracks(ctypes.Union):
+    _fields_ = [
+        ('audio', ctypes.POINTER(AudioTrack)),
+        ('video', ctypes.POINTER(VideoTrack)),
+        ('subtitle', ctypes.POINTER(SubtitleTrack)),
+        ]
+
+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),
+        ]
+
+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)
+
+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')
+
+class Rectangle(_Cstruct):
+    _fields_ = [
+        ('top',    ctypes.c_int),
+        ('left',   ctypes.c_int),
+        ('bottom', ctypes.c_int),
+        ('right',  ctypes.c_int),
+    ]
+
+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)),
+    ]
+
+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
+
+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       ),
+    ]
+
+class Event(_Cstruct):
+    _fields_ = [
+        ('type',   EventType      ),
+        ('object', ctypes.c_void_p),
+        ('u',      EventUnion     ),
+    ]
+
+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)),
+    ]
+
+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
+
+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),
+    ]
+
+class TitleDescription(_Cstruct):
+    _fields = [
+        ('duration', ctypes.c_longlong),
+        ('name', ctypes.c_char_p),
+        ('menu', ctypes.c_bool),
+    ]
+
+class ChapterDescription(_Cstruct):
+    _fields = [
+        ('time_offset', ctypes.c_longlong),
+        ('duration', ctypes.c_longlong),
+        ('name', ctypes.c_char_p),
+    ]
+
+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)
+        ]
+
+class RDDescription(_Cstruct):
+    _fields = [
+        ('name', ctypes.c_char_p),
+        ('longname', ctypes.c_char_p)
+    ]
+
+# End of header.py #
+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)
+
+    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
+
+    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)
+
+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)
+
+    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
+
+    def media_list_player_new(self):
+        """Create a new MediaListPlayer instance.
+        """
+        p = libvlc_media_list_player_new(self)
+        p._instance = self
+        return p
+
+    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
+
+    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
+
+    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
+
+    def audio_filter_list_get(self):
+        """Returns a list of available audio filters.
+
+        """
+        return module_description_list(libvlc_audio_filter_list_get(self))
+
+    def video_filter_list_get(self):
+        """Returns a list of available video filters.
+
+        """
+        return module_description_list(libvlc_video_filter_list_get(self))
+
+
+    
+    def release(self):
+        '''Decrement the reference count of a libvlc instance, and destroy it
+        if it reaches zero.
+        '''
+        return libvlc_release(self)
+
+    
+    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)
+
+    
+    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))
+
+    
+    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))
+
+    
+    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))
+
+    
+    def log_unset(self):
+        '''Unsets the logging callback.
+        This function deregisters the logging callback for a LibVLC instance.
+        This is rarely needed as the callback is implicitly unset when the instance
+        is destroyed.
+        @note: 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)
+
+    
+    def log_set(self, cb, data):
+        '''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, cb, data)
+
+    
+    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)
+
+    
+    def media_discoverer_new(self, psz_name):
+        '''Create a media discoverer object by name.
+        After this object is created, you should attach to media_list events in
+        order to be notified of new items discovered.
+        You need to call L{media_discoverer_start}() in order to start the
+        discovery.
+        See L{media_discoverer_media_list}
+        See L{media_discoverer_event_manager}
+        See L{media_discoverer_start}.
+        @param psz_name: service name; use L{media_discoverer_list_get}() to get a list of the discoverer names available in this libVLC instance.
+        @return: media discover object or None in case of error.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_discoverer_new(self, str_to_bytes(psz_name))
+
+    
+    def media_discoverer_list_get(self, i_cat, ppp_services):
+        '''Get media discoverer services by category.
+        @param i_cat: category of services to fetch.
+        @param ppp_services: address to store an allocated array of media discoverer services (must be freed with L{media_discoverer_list_release}() by the caller) [OUT].
+        @return: the number of media discoverer services (0 on error).
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_discoverer_list_get(self, i_cat, ppp_services)
+
+    
+    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)
+
+    
+    def vlm_release(self):
+        '''Release the vlm instance related to the given L{Instance}.
+        '''
+        return libvlc_vlm_release(self)
+
+    
+    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)
+
+    
+    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))
+
+    
+    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))
+
+    
+    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)
+
+    
+    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))
+
+    
+    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))
+
+    
+    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))
+
+    
+    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)
+
+    
+    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))
+
+    
+    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)
+
+    
+    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))
+
+    
+    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))
+
+    
+    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))
+
+    
+    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)
+
+    
+    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))
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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))
+
+    
+    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))
+
+    
+    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)
+
+    
+    def media_new_callbacks(self, open_cb, read_cb, seek_cb, close_cb, opaque):
+        '''Create a media with custom callbacks to read the data from.
+        @param open_cb: callback to open the custom bitstream input media.
+        @param read_cb: callback to read data (must not be None).
+        @param seek_cb: callback to seek, or None if seeking is not supported.
+        @param close_cb: callback to close the media, or None if unnecessary.
+        @param opaque: data pointer for the open callback.
+        @return: the newly created media or None on error @note If open_cb is None, the opaque pointer will be passed to read_cb, seek_cb and close_cb, and the stream size will be treated as unknown. @note The callbacks may be called asynchronously (from another thread). A single stream instance need not be reentrant. However the open_cb needs to be reentrant if the media is used by multiple player instances. @warning The callbacks may be used until all or any player instances that were supplied the media item are stopped. See L{media_release}.
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_new_callbacks(self, open_cb, read_cb, seek_cb, close_cb, opaque)
+
+    
+    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))
+
+    
+    def renderer_discoverer_new(self, psz_name):
+        '''Create a renderer discoverer object by name
+        After this object is created, you should attach to events in order to be
+        notified of the discoverer events.
+        You need to call L{renderer_discoverer_start}() in order to start the
+        discovery.
+        See L{renderer_discoverer_event_manager}()
+        See L{renderer_discoverer_start}().
+        @param psz_name: service name; use L{renderer_discoverer_list_get}() to get a list of the discoverer names available in this libVLC instance.
+        @return: media discover object or None in case of error.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_renderer_discoverer_new(self, str_to_bytes(psz_name))
+
+    
+    def renderer_discoverer_list_get(self, ppp_services):
+        '''Get media discoverer services
+        See libvlc_renderer_list_release().
+        @param ppp_services: address to store an allocated array of renderer discoverer services (must be freed with libvlc_renderer_list_release() by the caller) [OUT].
+        @return: the number of media discoverer services (0 on error).
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_renderer_discoverer_list_get(self, ppp_services)
+
+    
+    def audio_output_device_count(self, psz_audio_output):
+        '''Backward compatibility stub. Do not use in new code.
+        \deprecated Use L{audio_output_device_list_get}() instead.
+        @return: always 0.
+        '''
+        return libvlc_audio_output_device_count(self, str_to_bytes(psz_audio_output))
+
+    
+    def audio_output_device_longname(self, psz_output, i_device):
+        '''Backward compatibility stub. Do not use in new code.
+        \deprecated Use L{audio_output_device_list_get}() instead.
+        @return: always None.
+        '''
+        return libvlc_audio_output_device_longname(self, str_to_bytes(psz_output), i_device)
+
+    
+    def audio_output_device_id(self, psz_audio_output, i_device):
+        '''Backward compatibility stub. Do not use in new code.
+        \deprecated Use L{audio_output_device_list_get}() instead.
+        @return: always None.
+        '''
+        return libvlc_audio_output_device_id(self, str_to_bytes(psz_audio_output), i_device)
+
+    
+    def media_discoverer_new_from_name(self, psz_name):
+        '''\deprecated Use L{media_discoverer_new}() and L{media_discoverer_start}().
+        '''
+        return libvlc_media_discoverer_new_from_name(self, str_to_bytes(psz_name))
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def audio_output_list_get(self):
+        '''Gets the list of available audio output modules.
+        @return: list of available audio outputs. It must be freed with In case of error, None is returned.
+        '''
+        return libvlc_audio_output_list_get(self)
+
+    
+    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 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 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))
+
+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
+
+    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()
+
+
+    
+    def free(self):
+        '''Frees memory allocated by L{log_get_iterator}().
+        '''
+        return libvlc_log_iterator_free(self)
+
+    
+    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)
+
+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
+
+    def get_instance(self):
+        return getattr(self, '_instance', None)
+
+    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)
+
+    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
+
+
+    
+    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))
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def duplicate(self):
+        '''Duplicate a media descriptor object.
+        '''
+        return libvlc_media_duplicate(self)
+
+    
+    def get_meta(self, e_meta):
+        '''Read the meta of the media.
+        If the media has not yet been parsed this will return None.
+        See L{parse}
+        See L{parse_with_options}
+        See libvlc_MediaMetaChanged.
+        @param e_meta: the meta to read.
+        @return: the media's meta.
+        '''
+        return libvlc_media_get_meta(self, e_meta)
+
+    
+    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))
+
+    
+    def save_meta(self):
+        '''Save the meta previously set.
+        @return: true if the write operation was successful.
+        '''
+        return libvlc_media_save_meta(self)
+
+    
+    def get_state(self):
+        '''Get current state of media descriptor object. Possible media states are
+        libvlc_NothingSpecial=0, libvlc_Opening, 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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def parse_with_options(self, parse_flag, timeout):
+        '''Parse the media asynchronously with options.
+        This fetches (local or network) art, meta data and/or tracks information.
+        This method is the extended version of L{parse_with_options}().
+        To track when this is over you can listen to libvlc_MediaParsedChanged
+        event. However if this functions returns an error, you will not receive any
+        events.
+        It uses a flag to specify parse options (see libvlc_media_parse_flag_t). All
+        these flags can be combined. By default, media is parsed if it's a local
+        file.
+        @note: Parsing can be aborted with L{parse_stop}().
+        See libvlc_MediaParsedChanged
+        See L{get_meta}
+        See L{tracks_get}
+        See L{get_parsed_status}
+        See libvlc_media_parse_flag_t.
+        @param parse_flag: parse options:
+        @param timeout: maximum time allowed to preparse the media. If -1, the default "preparse-timeout" option will be used as a timeout. If 0, it will wait indefinitely. If > 0, the timeout will be used (in milliseconds).
+        @return: -1 in case of error, 0 otherwise.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_parse_with_options(self, parse_flag, timeout)
+
+    
+    def parse_stop(self):
+        '''Stop the parsing of the media
+        When the media parsing is stopped, the libvlc_MediaParsedChanged event will
+        be sent with the libvlc_media_parsed_status_timeout status.
+        See L{parse_with_options}.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_parse_stop(self)
+
+    
+    def get_parsed_status(self):
+        '''Get Parsed status for media descriptor object.
+        See libvlc_MediaParsedChanged
+        See libvlc_media_parsed_status_t.
+        @return: a value of the libvlc_media_parsed_status_t enum.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_get_parsed_status(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def get_type(self):
+        '''Get the media type of the media descriptor object.
+        @return: media type.
+        @version: LibVLC 3.0.0 and later. See libvlc_media_type_t.
+        '''
+        return libvlc_media_get_type(self)
+
+    
+    def slaves_add(self, i_type, i_priority, psz_uri):
+        '''Add a slave to the current media.
+        A slave is an external input source that may contains an additional subtitle
+        track (like a .srt) or an additional audio track (like a .ac3).
+        @note: This function must be called before the media is parsed (via
+        L{parse_with_options}()) or before the media is played (via
+        L{player_play}()).
+        @param i_type: subtitle or audio.
+        @param i_priority: from 0 (low priority) to 4 (high priority).
+        @param psz_uri: Uri of the slave (should contain a valid scheme).
+        @return: 0 on success, -1 on error.
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_slaves_add(self, i_type, i_priority, str_to_bytes(psz_uri))
+
+    
+    def slaves_clear(self):
+        '''Clear all slaves previously added by L{slaves_add}() or
+        internally.
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_slaves_clear(self)
+
+    
+    def slaves_get(self, ppp_slaves):
+        '''Get a media descriptor's slave list
+        The list will contain slaves parsed by VLC or previously added by
+        L{slaves_add}(). The typical use case of this function is to save
+        a list of slave in a database for a later use.
+        @param ppp_slaves: address to store an allocated array of slaves (must be freed with L{slaves_release}()) [OUT].
+        @return: the number of slaves (zero on error).
+        @version: LibVLC 3.0.0 and later. See L{slaves_add}.
+        '''
+        return libvlc_media_slaves_get(self, ppp_slaves)
+
+    
+    def parse(self):
+        '''Parse a media.
+        This fetches (local) art, meta data and tracks information.
+        The method is synchronous.
+        \deprecated This function could block indefinitely.
+                    Use L{parse_with_options}() instead
+        See L{parse_with_options}
+        See L{get_meta}
+        See L{get_tracks_info}.
+        '''
+        return libvlc_media_parse(self)
+
+    
+    def parse_async(self):
+        '''Parse a media.
+        This fetches (local) art, 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.
+        \deprecated You can't be sure to receive the libvlc_MediaParsedChanged
+                    event (you can wait indefinitely for this event).
+                    Use L{parse_with_options}() instead
+        See L{parse}
+        See libvlc_MediaParsedChanged
+        See L{get_meta}
+        See L{get_tracks_info}.
+        '''
+        return libvlc_media_parse_async(self)
+
+    
+    def is_parsed(self):
+        '''Return true is the media descriptor object is parsed
+        \deprecated This can return true in case of failure.
+                    Use L{get_parsed_status}() instead
+        See libvlc_MediaParsedChanged.
+        @return: true if media object has been parsed otherwise it returns false \libvlc_return_bool.
+        '''
+        return libvlc_media_is_parsed(self)
+
+    
+    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)
+
+    
+    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)
+
+class MediaDiscoverer(_Ctype):
+    '''N/A
+    '''
+
+    def __new__(cls, ptr=_internal_guard):
+        '''(INTERNAL) ctypes wrapper constructor.
+        '''
+        return _Constructor(cls, ptr)
+    
+    def start(self):
+        '''Start media discovery.
+        To stop it, call L{stop}() or
+        L{list_release}() directly.
+        See L{stop}.
+        @return: -1 in case of error, 0 otherwise.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_discoverer_start(self)
+
+    
+    def stop(self):
+        '''Stop media discovery.
+        See L{start}.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_discoverer_stop(self)
+
+    
+    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)
+
+    
+    def media_list(self):
+        '''Get media service discover media list.
+        @return: list of media items.
+        '''
+        return libvlc_media_discoverer_media_list(self)
+
+    
+    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)
+
+    
+    def localized_name(self):
+        '''Get media service discover object its localized name.
+        \deprecated Useless, use L{list_get}() to get the
+        longname of the service discovery.
+        @return: localized name or None if the media_discoverer is not started.
+        '''
+        return libvlc_media_discoverer_localized_name(self)
+
+    @memoize_parameterless
+    def event_manager(self):
+        '''Get event manager from media service discover object.
+        \deprecated Useless, media_discoverer events are only triggered when calling
+        L{start}() and L{stop}().
+        @return: event manager object.
+        '''
+        return libvlc_media_discoverer_event_manager(self)
+
+class MediaLibrary(_Ctype):
+    '''N/A
+    '''
+
+    def __new__(cls, ptr=_internal_guard):
+        '''(INTERNAL) ctypes wrapper constructor.
+        '''
+        return _Constructor(cls, ptr)
+    
+    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)
+
+    
+    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)
+
+    
+    def load(self):
+        '''Load media library.
+        @return: 0 on success, -1 on error.
+        '''
+        return libvlc_media_library_load(self)
+
+    
+    def media_list(self):
+        '''Get media library subitems.
+        @return: media list subitems.
+        '''
+        return libvlc_media_library_media_list(self)
+
+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
+
+    def get_instance(self):
+        return getattr(self, '_instance', None)
+
+    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)
+
+
+    
+    def release(self):
+        '''Release media list created with L{new}().
+        '''
+        return libvlc_media_list_release(self)
+
+    
+    def retain(self):
+        '''Retain reference to a media list.
+        '''
+        return libvlc_media_list_retain(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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]
+
+    
+    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)
+
+    
+    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)
+
+    
+    def lock(self):
+        '''Get lock on media list items.
+        '''
+        return libvlc_media_list_lock(self)
+
+    
+    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)
+
+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()
+
+    def get_instance(self):
+        """Return the associated Instance.
+        """
+        return self._instance  #PYCHOK expected
+
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def get_media_player(self):
+        '''Get media player of the media_list_player instance.
+        @return: media player instance @note the caller is responsible for releasing the returned instance.
+        '''
+        return libvlc_media_list_player_get_media_player(self)
+
+    
+    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)
+
+    
+    def play(self):
+        '''Play media list.
+        '''
+        return libvlc_media_list_player_play(self)
+
+    
+    def pause(self):
+        '''Toggle pause (or resume) media list.
+        '''
+        return libvlc_media_list_player_pause(self)
+
+    
+    def set_pause(self, do_pause):
+        '''Pause or resume media list.
+        @param do_pause: play/resume if zero, pause if non-zero.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_list_player_set_pause(self, do_pause)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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]
+
+    
+    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)
+
+    
+    def stop(self):
+        '''Stop playing media list.
+        '''
+        return libvlc_media_list_player_stop(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+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
+
+    def get_instance(self):
+        """Return the associated Instance.
+        """
+        return self._instance  #PYCHOK expected
+
+    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
+
+    def video_get_spu_description(self):
+        """Get the description of available video subtitles.
+        """
+        return track_description_list(libvlc_video_get_spu_description(self))
+
+    def video_get_title_description(self):
+        """Get the description of available titles.
+        """
+        return track_description_list(libvlc_video_get_title_description(self))
+
+    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))
+
+    def video_get_track_description(self):
+        """Get the description of available video tracks.
+        """
+        return track_description_list(libvlc_video_get_track_description(self))
+
+    def audio_get_track_description(self):
+        """Get the description of available audio tracks.
+        """
+        return track_description_list(libvlc_audio_get_track_description(self))
+
+    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
+
+    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
+
+    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,))
+
+    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)
+
+    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]
+
+    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]
+
+    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,))
+
+
+    
+    def get_fps(self):
+        '''Get movie fps rate
+        This function is provided for backward compatibility. It cannot deal with
+        multiple video tracks. In LibVLC versions prior to 3.0, it would also fail
+        if the file format did not convey the frame rate explicitly.
+        \deprecated Consider using L{media_tracks_get}() instead.
+        @return: frames per second (fps) for this playing movie, or 0 if unspecified.
+        '''
+        return libvlc_media_player_get_fps(self)
+
+    
+    def set_agl(self, drawable):
+        '''\deprecated Use L{set_nsobject}() instead.
+        '''
+        return libvlc_media_player_set_agl(self, drawable)
+
+    
+    def get_agl(self):
+        '''\deprecated Use L{get_nsobject}() instead.
+        '''
+        return libvlc_media_player_get_agl(self)
+
+    
+    def video_set_subtitle_file(self, psz_subtitle):
+        '''Set new video subtitle file.
+        \deprecated Use L{add_slave}() instead.
+        @param psz_subtitle: new video subtitle file.
+        @return: the success status (boolean).
+        '''
+        return libvlc_video_set_subtitle_file(self, str_to_bytes(psz_subtitle))
+
+    
+    def toggle_teletext(self):
+        '''Toggle teletext transparent status on video output.
+        \deprecated use L{video_set_teletext}() instead.
+        '''
+        return libvlc_toggle_teletext(self)
+
+    
+    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)
+
+    
+    def retain(self):
+        '''Retain a reference to a media player object. Use
+        L{release}() to decrement reference count.
+        '''
+        return libvlc_media_player_retain(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def play(self):
+        '''Play.
+        @return: 0 if playback started (and was already started), or -1 on error.
+        '''
+        return libvlc_media_player_play(self)
+
+    
+    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)
+
+    
+    def pause(self):
+        '''Toggle pause (no effect if there is no media).
+        '''
+        return libvlc_media_player_pause(self)
+
+    
+    def stop(self):
+        '''Stop (no effect if there is no media).
+        '''
+        return libvlc_media_player_stop(self)
+
+    
+    def set_renderer(self, p_item):
+        '''Set a renderer to the media player
+        @note: must be called before the first call of L{play}() to
+        take effect.
+        See L{renderer_discoverer_new}.
+        @param p_item: an item discovered by L{renderer_discoverer_start}().
+        @return: 0 on success, -1 on error.
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_media_player_set_renderer(self, p_item)
+
+    
+    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.
+        @warning: Rendering video into custom memory buffers is considerably less
+        efficient than rendering in a custom window as normal.
+        For optimal perfomances, VLC media player renders into a custom window, and
+        does not use this function and associated callbacks. It is B{highly
+        recommended} that other LibVLC-based application do likewise.
+        To embed video in a window, use libvlc_media_player_set_xid() or equivalent
+        depending on the operating system.
+        If window embedding does not fit the application use case, then a custom
+        LibVLC video output display plugin is required to maintain optimal video
+        rendering performances.
+        The following limitations affect performance:
+        - Hardware video decoding acceleration will either be disabled completely,
+          or require (relatively slow) copy from video/DSP memory to main memory.
+        - Sub-pictures (subtitles, on-screen display, etc.) must be blent into the
+          main picture by the CPU instead of the GPU.
+        - Depending on the video format, pixel format conversion, picture scaling,
+          cropping and/or picture re-orientation, must be performed by the CPU
+          instead of the GPU.
+        - Memory copying is required between LibVLC reference picture buffers and
+          application buffers (between lock and unlock callbacks).
+        @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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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:
+        @code.m
+        \@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 Qt see the QMacCocoaViewContainer. Then
+        the following code should work:
+        @code.mm
+        
+            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)
+
+    
+    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)
+
+    
+    def set_xwindow(self, drawable):
+        '''Set an X Window System drawable where the media player should render its
+        video output. The call takes effect when the playback starts. If it is
+        already started, it might need to be stopped before changes apply.
+        If LibVLC was built without X11 output support, then this function has no
+        effects.
+        By default, LibVLC will capture input events on the video rendering area.
+        Use L{video_set_mouse_input}() and L{video_set_key_input}() to
+        disable that and deliver events to the parent window / to the application
+        instead. By design, the X11 protocol delivers input events to only one
+        recipient.
+        @warning
+        The application must call the XInitThreads() function from Xlib before
+        L{new}(), and before any call to XOpenDisplay() directly or via any
+        other library. Failure to call XInitThreads() will seriously impede LibVLC
+        performance. Calling XOpenDisplay() before XInitThreads() will eventually
+        crash the process. That is a limitation of Xlib.
+        @param drawable: X11 window ID @note The specified identifier must correspond to an existing Input/Output class X11 window. Pixmaps are B{not} currently supported. The default X11 server is assumed, i.e. that specified in the DISPLAY environment variable. @warning LibVLC can deal with invalid X11 handle errors, however some display drivers (EGL, GLX, VA and/or VDPAU) can unfortunately not. Thus the window handle must remain valid until playback is stopped, otherwise the process may abort or crash.
+        @bug No more than one window handle per media player instance can be specified. If the media has multiple simultaneously active video tracks, extra tracks will be rendered into external windows beyond the control of the application.
+        '''
+        return libvlc_media_player_set_xwindow(self, drawable)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def set_android_context(self, p_awindow_handler):
+        '''Set the android context.
+        @param p_awindow_handler: org.videolan.libvlc.AWindow jobject owned by the org.videolan.libvlc.MediaPlayer class from the libvlc-android project.
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_player_set_android_context(self, p_awindow_handler)
+
+    
+    def set_evas_object(self, p_evas_object):
+        '''Set the EFL Evas Object.
+        @param p_evas_object: a valid EFL Evas Object (Evas_Object).
+        @return: -1 if an error was detected, 0 otherwise.
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_player_set_evas_object(self, p_evas_object)
+
+    
+    def audio_set_callbacks(self, play, pause, resume, flush, drain, opaque):
+        '''Sets callbacks and private data for decoded audio.
+        Use L{audio_set_format}() or L{audio_set_format_callbacks}()
+        to configure the decoded audio format.
+        @note: The audio callbacks override any other audio output mechanism.
+        If the callbacks are set, LibVLC will B{not} output audio in any way.
+        @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)
+
+    
+    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)
+
+    
+    def audio_set_format_callbacks(self, setup, cleanup):
+        '''Sets decoded audio format via callbacks.
+        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)
+
+    
+    def audio_set_format(self, format, rate, channels):
+        '''Sets a fixed 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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def will_play(self):
+        '''Is the player able to play.
+        @return: boolean \libvlc_return_bool.
+        '''
+        return libvlc_media_player_will_play(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def get_title(self):
+        '''Get movie title.
+        @return: title number currently playing, or -1.
+        '''
+        return libvlc_media_player_get_title(self)
+
+    
+    def get_title_count(self):
+        '''Get movie title count.
+        @return: title number count, or -1.
+        '''
+        return libvlc_media_player_get_title_count(self)
+
+    
+    def previous_chapter(self):
+        '''Set previous chapter (if applicable).
+        '''
+        return libvlc_media_player_previous_chapter(self)
+
+    
+    def next_chapter(self):
+        '''Set next chapter (if applicable).
+        '''
+        return libvlc_media_player_next_chapter(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def next_frame(self):
+        '''Display the next frame (if supported).
+        '''
+        return libvlc_media_player_next_frame(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def add_slave(self, i_type, psz_uri, b_select):
+        '''Add a slave to the current media player.
+        @note: If the player is playing, the slave will be added directly. This call
+        will also update the slave list of the attached L{Media}.
+        @param i_type: subtitle or audio.
+        @param psz_uri: Uri of the slave (should contain a valid scheme).
+        @param b_select: True if this slave should be selected when it's loaded.
+        @return: 0 on success, -1 on error.
+        @version: LibVLC 3.0.0 and later. See L{media_slaves_add}.
+        '''
+        return libvlc_media_player_add_slave(self, i_type, str_to_bytes(psz_uri), b_select)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def get_fullscreen(self):
+        '''Get current fullscreen status.
+        @return: the fullscreen status (boolean) \libvlc_return_bool.
+        '''
+        return libvlc_get_fullscreen(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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))
+
+    
+    def video_update_viewpoint(self, p_viewpoint, b_absolute):
+        '''Update the video viewpoint information.
+        @note: It is safe to call this function before the media player is started.
+        @param p_viewpoint: video viewpoint allocated via L{video_new_viewpoint}().
+        @param b_absolute: if true replace the old viewpoint with the new one. If false, increase/decrease it.
+        @return: -1 in case of error, 0 otherwise @note the values are set asynchronously, it will be used by the next frame displayed.
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_video_update_viewpoint(self, p_viewpoint, b_absolute)
+
+    
+    def video_get_spu(self):
+        '''Get current video subtitle.
+        @return: the video subtitle selected, or -1 if none.
+        '''
+        return libvlc_video_get_spu(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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))
+
+    
+    def video_get_teletext(self):
+        '''Get current teletext page requested or 0 if it's disabled.
+        Teletext is disabled by default, call L{video_set_teletext}() to enable
+        it.
+        @return: the current teletext page requested.
+        '''
+        return libvlc_video_get_teletext(self)
+
+    
+    def video_set_teletext(self, i_page):
+        '''Set new teletext page to retrieve.
+        This function can also be used to send a teletext key.
+        @param i_page: teletex page number requested. This value can be 0 to disable teletext, a number in the range ]0;1000[ to show the requested page, or a \ref libvlc_teletext_key_t. 100 is the default teletext page.
+        '''
+        return libvlc_video_set_teletext(self, i_page)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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 of a file or a folder to save the screenshot into.
+        @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)
+
+    
+    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))
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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))
+
+    
+    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)
+
+    
+    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)
+
+    
+    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))
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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 succeeded, -1 on error.
+        '''
+        return libvlc_audio_output_set(self, str_to_bytes(psz_name))
+
+    
+    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 with L{audio_output_device_list_release}().
+        @version: LibVLC 2.2.0 or later.
+        '''
+        return libvlc_audio_output_device_enum(self)
+
+    
+    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))
+
+    
+    def audio_output_device_get(self):
+        '''Get the current audio output device identifier.
+        This complements L{audio_output_device_set}().
+        @warning: The initial value for the current audio output device identifier
+        may not be set or may be some unknown value. A LibVLC application should
+        compare this value against the known device identifiers (e.g. those that
+        were previously retrieved by a call to L{audio_output_device_enum} or
+        L{audio_output_device_list_get}) to find the current audio output device.
+        It is possible that the selected audio output device changes (an external
+        change) without a call to L{audio_output_device_set}. That may make this
+        method unsuitable to use if a LibVLC application is attempting to track
+        dynamic audio device changes as they happen.
+        @return: the current audio output device identifier None if no device is selected or in case of error (the result must be released with free() or L{free}()).
+        @version: LibVLC 3.0.0 or later.
+        '''
+        return libvlc_audio_output_device_get(self)
+
+    
+    def audio_toggle_mute(self):
+        '''Toggle mute status.
+        '''
+        return libvlc_audio_toggle_mute(self)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    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)
+
+    
+    def get_role(self):
+        '''Gets the media role.
+        @return: the media player role (\ref libvlc_media_player_role_t).
+        @version: LibVLC 3.0.0 and later.
+        '''
+        return libvlc_media_player_get_role(self)
+
+    
+    def set_role(self, role):
+        '''Sets the media role.
+        @param role: the media player role (\ref libvlc_media_player_role_t).
+        @return: 0 on success, -1 on error.
+        '''
+        return libvlc_media_player_set_role(self, role)
+
+
+ # LibVLC __version__ functions #
+
+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()
+
+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)
+
+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.
+    @note
+    LibVLC may create threads. Therefore, any thread-unsafe process
+    initialization must be performed before calling L{libvlc_new}(). In particular
+    and where applicable:
+    - setlocale() and textdomain(),
+    - setenv(), unsetenv() and putenv(),
+    - with the X11 display system, XInitThreads()
+      (see also L{libvlc_media_player_set_xwindow}()) and
+    - on Microsoft Windows, SetErrorMode().
+    - sigprocmask() shall never be invoked; pthread_sigmask() can be used.
+    On POSIX systems, the SIGCHLD signal B{must not} be ignored, i.e. the
+    signal handler must set to SIG_DFL or a function pointer, not SIG_IGN.
+    Also while LibVLC is active, the wait() function shall not be called, and
+    any call to waitpid() shall use a strictly positive value for the first
+    parameter (i.e. the PID). Failure to follow those rules may lead to a
+    deadlock or a busy loop.
+    Also on POSIX systems, it is recommended that the SIGPIPE signal be blocked,
+    even if it is not, in principles, necessary, e.g.:
+    @code
+    @endcode
+    On Microsoft Windows Vista/2008, the process error mode
+    SEM_FAILCRITICALERRORS flag B{must} be set before using LibVLC.
+    On later versions, that is optional and unnecessary.
+    Also on Microsoft Windows (Vista and any later version), setting the default
+    DLL directories to SYSTEM32 exclusively is strongly recommended for
+    security reasons:
+    @code
+    @endcode.
+    @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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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()
+
+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()
+
+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)
+
+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)
+
+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)
+
+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)
+
+def libvlc_log_get_context(ctx):
+    '''Gets log message debug infos.
+    This function retrieves self-debug information about a log message:
+    - the name of the VLC module emitting the message,
+    - the name of the source code module (i.e. file) and
+    - the line number within the source code module.
+    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)
+
+def libvlc_log_get_object(ctx, id):
+    '''Gets log message info.
+    This function retrieves meta-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)
+
+def libvlc_log_unset(p_instance):
+    '''Unsets the logging callback.
+    This function deregisters the logging callback for a LibVLC instance.
+    This is rarely needed as the callback is implicitly unset when the instance
+    is destroyed.
+    @note: 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)
+
+def libvlc_log_set(p_instance, cb, data):
+    '''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(p_instance, cb, data)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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()
+
+def libvlc_media_discoverer_new(p_inst, psz_name):
+    '''Create a media discoverer object by name.
+    After this object is created, you should attach to media_list events in
+    order to be notified of new items discovered.
+    You need to call L{libvlc_media_discoverer_start}() in order to start the
+    discovery.
+    See L{libvlc_media_discoverer_media_list}
+    See L{libvlc_media_discoverer_event_manager}
+    See L{libvlc_media_discoverer_start}.
+    @param p_inst: libvlc instance.
+    @param psz_name: service name; use L{libvlc_media_discoverer_list_get}() to get a list of the discoverer names available in this libVLC instance.
+    @return: media discover object or None in case of error.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_media_discoverer_new', None) or \
+        _Cfunction('libvlc_media_discoverer_new', ((1,), (1,),), class_result(MediaDiscoverer),
+                    ctypes.c_void_p, Instance, ctypes.c_char_p)
+    return f(p_inst, psz_name)
+
+def libvlc_media_discoverer_start(p_mdis):
+    '''Start media discovery.
+    To stop it, call L{libvlc_media_discoverer_stop}() or
+    L{libvlc_media_discoverer_list_release}() directly.
+    See L{libvlc_media_discoverer_stop}.
+    @param p_mdis: media discover object.
+    @return: -1 in case of error, 0 otherwise.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_media_discoverer_start', None) or \
+        _Cfunction('libvlc_media_discoverer_start', ((1,),), None,
+                    ctypes.c_int, MediaDiscoverer)
+    return f(p_mdis)
+
+def libvlc_media_discoverer_stop(p_mdis):
+    '''Stop media discovery.
+    See L{libvlc_media_discoverer_start}.
+    @param p_mdis: media discover object.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_media_discoverer_stop', None) or \
+        _Cfunction('libvlc_media_discoverer_stop', ((1,),), None,
+                    None, MediaDiscoverer)
+    return f(p_mdis)
+
+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)
+
+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)
+
+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)
+
+def libvlc_media_discoverer_list_get(p_inst, i_cat, ppp_services):
+    '''Get media discoverer services by category.
+    @param p_inst: libvlc instance.
+    @param i_cat: category of services to fetch.
+    @param ppp_services: address to store an allocated array of media discoverer services (must be freed with L{libvlc_media_discoverer_list_release}() by the caller) [OUT].
+    @return: the number of media discoverer services (0 on error).
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_media_discoverer_list_get', None) or \
+        _Cfunction('libvlc_media_discoverer_list_get', ((1,), (1,), (1,),), None,
+                    ctypes.c_size_t, Instance, MediaDiscovererCategory, ctypes.POINTER(ctypes.POINTER(MediaDiscovererDescription)))
+    return f(p_inst, i_cat, ppp_services)
+
+def libvlc_media_discoverer_list_release(pp_services, i_count):
+    '''Release an array of media discoverer services.
+    @param pp_services: array to release.
+    @param i_count: number of elements in the array.
+    @version: LibVLC 3.0.0 and later. See L{libvlc_media_discoverer_list_get}().
+    '''
+    f = _Cfunctions.get('libvlc_media_discoverer_list_release', None) or \
+        _Cfunction('libvlc_media_discoverer_list_release', ((1,), (1,),), None,
+                    None, ctypes.POINTER(MediaDiscovererDescription), ctypes.c_size_t)
+    return f(pp_services, i_count)
+
+def libvlc_dialog_set_context(p_id, p_context):
+    '''Associate an opaque pointer with the dialog id.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_dialog_set_context', None) or \
+        _Cfunction('libvlc_dialog_set_context', ((1,), (1,),), None,
+                    None, ctypes.c_void_p, ctypes.c_void_p)
+    return f(p_id, p_context)
+
+def libvlc_dialog_get_context(p_id):
+    '''Return the opaque pointer associated with the dialog id.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_dialog_get_context', None) or \
+        _Cfunction('libvlc_dialog_get_context', ((1,),), None,
+                    ctypes.c_void_p, ctypes.c_void_p)
+    return f(p_id)
+
+def libvlc_dialog_post_login(p_id, psz_username, psz_password, b_store):
+    '''Post a login answer
+    After this call, p_id won't be valid anymore
+    See libvlc_dialog_cbs.pf_display_login.
+    @param p_id: id of the dialog.
+    @param psz_username: valid and non empty string.
+    @param psz_password: valid string (can be empty).
+    @param b_store: if true, store the credentials.
+    @return: 0 on success, or -1 on error.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_dialog_post_login', None) or \
+        _Cfunction('libvlc_dialog_post_login', ((1,), (1,), (1,), (1,),), None,
+                    ctypes.c_int, ctypes.c_void_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_bool)
+    return f(p_id, psz_username, psz_password, b_store)
+
+def libvlc_dialog_post_action(p_id, i_action):
+    '''Post a question answer
+    After this call, p_id won't be valid anymore
+    See libvlc_dialog_cbs.pf_display_question.
+    @param p_id: id of the dialog.
+    @param i_action: 1 for action1, 2 for action2.
+    @return: 0 on success, or -1 on error.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_dialog_post_action', None) or \
+        _Cfunction('libvlc_dialog_post_action', ((1,), (1,),), None,
+                    ctypes.c_int, ctypes.c_void_p, ctypes.c_int)
+    return f(p_id, i_action)
+
+def libvlc_dialog_dismiss(p_id):
+    '''Dismiss a dialog
+    After this call, p_id won't be valid anymore
+    See libvlc_dialog_cbs.pf_cancel.
+    @param p_id: id of the dialog.
+    @return: 0 on success, or -1 on error.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_dialog_dismiss', None) or \
+        _Cfunction('libvlc_dialog_dismiss', ((1,),), None,
+                    ctypes.c_int, ctypes.c_void_p)
+    return f(p_id)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+def libvlc_media_new_callbacks(instance, open_cb, read_cb, seek_cb, close_cb, opaque):
+    '''Create a media with custom callbacks to read the data from.
+    @param instance: LibVLC instance.
+    @param open_cb: callback to open the custom bitstream input media.
+    @param read_cb: callback to read data (must not be None).
+    @param seek_cb: callback to seek, or None if seeking is not supported.
+    @param close_cb: callback to close the media, or None if unnecessary.
+    @param opaque: data pointer for the open callback.
+    @return: the newly created media or None on error @note If open_cb is None, the opaque pointer will be passed to read_cb, seek_cb and close_cb, and the stream size will be treated as unknown. @note The callbacks may be called asynchronously (from another thread). A single stream instance need not be reentrant. However the open_cb needs to be reentrant if the media is used by multiple player instances. @warning The callbacks may be used until all or any player instances that were supplied the media item are stopped. See L{libvlc_media_release}.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_media_new_callbacks', None) or \
+        _Cfunction('libvlc_media_new_callbacks', ((1,), (1,), (1,), (1,), (1,), (1,),), class_result(Media),
+                    ctypes.c_void_p, Instance, MediaOpenCb, MediaReadCb, MediaSeekCb, MediaCloseCb, ctypes.c_void_p)
+    return f(instance, open_cb, read_cb, seek_cb, close_cb, opaque)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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.
+    See L{libvlc_media_parse}
+    See L{libvlc_media_parse_with_options}
+    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)
+
+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)
+
+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)
+
+def libvlc_media_get_state(p_md):
+    '''Get current state of media descriptor object. Possible media states are
+    libvlc_NothingSpecial=0, libvlc_Opening, 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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+def libvlc_media_parse_with_options(p_md, parse_flag, timeout):
+    '''Parse the media asynchronously with options.
+    This fetches (local or network) art, meta data and/or tracks information.
+    This method is the extended version of L{libvlc_media_parse_with_options}().
+    To track when this is over you can listen to libvlc_MediaParsedChanged
+    event. However if this functions returns an error, you will not receive any
+    events.
+    It uses a flag to specify parse options (see libvlc_media_parse_flag_t). All
+    these flags can be combined. By default, media is parsed if it's a local
+    file.
+    @note: Parsing can be aborted with L{libvlc_media_parse_stop}().
+    See libvlc_MediaParsedChanged
+    See L{libvlc_media_get_meta}
+    See L{libvlc_media_tracks_get}
+    See L{libvlc_media_get_parsed_status}
+    See libvlc_media_parse_flag_t.
+    @param p_md: media descriptor object.
+    @param parse_flag: parse options:
+    @param timeout: maximum time allowed to preparse the media. If -1, the default "preparse-timeout" option will be used as a timeout. If 0, it will wait indefinitely. If > 0, the timeout will be used (in milliseconds).
+    @return: -1 in case of error, 0 otherwise.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_media_parse_with_options', None) or \
+        _Cfunction('libvlc_media_parse_with_options', ((1,), (1,), (1,),), None,
+                    ctypes.c_int, Media, MediaParseFlag, ctypes.c_int)
+    return f(p_md, parse_flag, timeout)
+
+def libvlc_media_parse_stop(p_md):
+    '''Stop the parsing of the media
+    When the media parsing is stopped, the libvlc_MediaParsedChanged event will
+    be sent with the libvlc_media_parsed_status_timeout status.
+    See L{libvlc_media_parse_with_options}.
+    @param p_md: media descriptor object.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_media_parse_stop', None) or \
+        _Cfunction('libvlc_media_parse_stop', ((1,),), None,
+                    None, Media)
+    return f(p_md)
+
+def libvlc_media_get_parsed_status(p_md):
+    '''Get Parsed status for media descriptor object.
+    See libvlc_MediaParsedChanged
+    See libvlc_media_parsed_status_t.
+    @param p_md: media descriptor object.
+    @return: a value of the libvlc_media_parsed_status_t enum.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_media_get_parsed_status', None) or \
+        _Cfunction('libvlc_media_get_parsed_status', ((1,),), None,
+                    MediaParsedStatus, Media)
+    return f(p_md)
+
+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)
+
+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)
+
+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)
+
+def libvlc_media_get_codec_description(i_type, i_codec):
+    '''Get codec description from media elementary stream.
+    @param i_type: i_type from L{MediaTrack}.
+    @param i_codec: i_codec or i_original_fourcc from L{MediaTrack}.
+    @return: codec description.
+    @version: LibVLC 3.0.0 and later. See L{MediaTrack}.
+    '''
+    f = _Cfunctions.get('libvlc_media_get_codec_description', None) or \
+        _Cfunction('libvlc_media_get_codec_description', ((1,), (1,),), None,
+                    ctypes.c_char_p, TrackType, ctypes.c_uint32)
+    return f(i_type, i_codec)
+
+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)
+
+def libvlc_media_get_type(p_md):
+    '''Get the media type of the media descriptor object.
+    @param p_md: media descriptor object.
+    @return: media type.
+    @version: LibVLC 3.0.0 and later. See libvlc_media_type_t.
+    '''
+    f = _Cfunctions.get('libvlc_media_get_type', None) or \
+        _Cfunction('libvlc_media_get_type', ((1,),), None,
+                    MediaType, Media)
+    return f(p_md)
+
+def libvlc_media_slaves_add(p_md, i_type, i_priority, psz_uri):
+    '''Add a slave to the current media.
+    A slave is an external input source that may contains an additional subtitle
+    track (like a .srt) or an additional audio track (like a .ac3).
+    @note: This function must be called before the media is parsed (via
+    L{libvlc_media_parse_with_options}()) or before the media is played (via
+    L{libvlc_media_player_play}()).
+    @param p_md: media descriptor object.
+    @param i_type: subtitle or audio.
+    @param i_priority: from 0 (low priority) to 4 (high priority).
+    @param psz_uri: Uri of the slave (should contain a valid scheme).
+    @return: 0 on success, -1 on error.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_media_slaves_add', None) or \
+        _Cfunction('libvlc_media_slaves_add', ((1,), (1,), (1,), (1,),), None,
+                    ctypes.c_int, Media, MediaSlaveType, ctypes.c_int, ctypes.c_char_p)
+    return f(p_md, i_type, i_priority, psz_uri)
+
+def libvlc_media_slaves_clear(p_md):
+    '''Clear all slaves previously added by L{libvlc_media_slaves_add}() or
+    internally.
+    @param p_md: media descriptor object.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_media_slaves_clear', None) or \
+        _Cfunction('libvlc_media_slaves_clear', ((1,),), None,
+                    None, Media)
+    return f(p_md)
+
+def libvlc_media_slaves_get(p_md, ppp_slaves):
+    '''Get a media descriptor's slave list
+    The list will contain slaves parsed by VLC or previously added by
+    L{libvlc_media_slaves_add}(). The typical use case of this function is to save
+    a list of slave in a database for a later use.
+    @param p_md: media descriptor object.
+    @param ppp_slaves: address to store an allocated array of slaves (must be freed with L{libvlc_media_slaves_release}()) [OUT].
+    @return: the number of slaves (zero on error).
+    @version: LibVLC 3.0.0 and later. See L{libvlc_media_slaves_add}.
+    '''
+    f = _Cfunctions.get('libvlc_media_slaves_get', None) or \
+        _Cfunction('libvlc_media_slaves_get', ((1,), (1,),), None,
+                    ctypes.c_int, Media, ctypes.POINTER(ctypes.POINTER(MediaSlave)))
+    return f(p_md, ppp_slaves)
+
+def libvlc_media_slaves_release(pp_slaves, i_count):
+    '''Release a media descriptor's slave list.
+    @param pp_slaves: slave array to release.
+    @param i_count: number of elements in the array.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_media_slaves_release', None) or \
+        _Cfunction('libvlc_media_slaves_release', ((1,), (1,),), None,
+                    None, ctypes.POINTER(MediaSlave), ctypes.c_int)
+    return f(pp_slaves, i_count)
+
+def libvlc_renderer_item_hold(p_item):
+    '''Hold a renderer item, i.e. creates a new reference
+    This functions need to called from the libvlc_RendererDiscovererItemAdded
+    callback if the libvlc user wants to use this item after. (for display or
+    for passing it to the mediaplayer for example).
+    @return: the current item.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_item_hold', None) or \
+        _Cfunction('libvlc_renderer_item_hold', ((1,),), None,
+                    ctypes.c_void_p, ctypes.c_void_p)
+    return f(p_item)
+
+def libvlc_renderer_item_release(p_item):
+    '''Releases a renderer item, i.e. decrements its reference counter.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_item_release', None) or \
+        _Cfunction('libvlc_renderer_item_release', ((1,),), None,
+                    None, ctypes.c_void_p)
+    return f(p_item)
+
+def libvlc_renderer_item_name(p_item):
+    '''Get the human readable name of a renderer item.
+    @return: the name of the item (can't be None, must *not* be freed).
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_item_name', None) or \
+        _Cfunction('libvlc_renderer_item_name', ((1,),), None,
+                    ctypes.c_char_p, ctypes.c_void_p)
+    return f(p_item)
+
+def libvlc_renderer_item_type(p_item):
+    '''Get the type (not translated) of a renderer item. For now, the type can only
+    be "chromecast" ("upnp", "airplay" may come later).
+    @return: the type of the item (can't be None, must *not* be freed).
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_item_type', None) or \
+        _Cfunction('libvlc_renderer_item_type', ((1,),), None,
+                    ctypes.c_char_p, ctypes.c_void_p)
+    return f(p_item)
+
+def libvlc_renderer_item_icon_uri(p_item):
+    '''Get the icon uri of a renderer item.
+    @return: the uri of the item's icon (can be None, must *not* be freed).
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_item_icon_uri', None) or \
+        _Cfunction('libvlc_renderer_item_icon_uri', ((1,),), None,
+                    ctypes.c_char_p, ctypes.c_void_p)
+    return f(p_item)
+
+def libvlc_renderer_item_flags(p_item):
+    '''Get the flags of a renderer item
+    See LIBVLC_RENDERER_CAN_AUDIO
+    See LIBVLC_RENDERER_CAN_VIDEO.
+    @return: bitwise flag: capabilities of the renderer, see.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_item_flags', None) or \
+        _Cfunction('libvlc_renderer_item_flags', ((1,),), None,
+                    ctypes.c_int, ctypes.c_void_p)
+    return f(p_item)
+
+def libvlc_renderer_discoverer_new(p_inst, psz_name):
+    '''Create a renderer discoverer object by name
+    After this object is created, you should attach to events in order to be
+    notified of the discoverer events.
+    You need to call L{libvlc_renderer_discoverer_start}() in order to start the
+    discovery.
+    See L{libvlc_renderer_discoverer_event_manager}()
+    See L{libvlc_renderer_discoverer_start}().
+    @param p_inst: libvlc instance.
+    @param psz_name: service name; use L{libvlc_renderer_discoverer_list_get}() to get a list of the discoverer names available in this libVLC instance.
+    @return: media discover object or None in case of error.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_new', None) or \
+        _Cfunction('libvlc_renderer_discoverer_new', ((1,), (1,),), None,
+                    ctypes.c_void_p, Instance, ctypes.c_char_p)
+    return f(p_inst, psz_name)
+
+def libvlc_renderer_discoverer_release(p_rd):
+    '''Release a renderer discoverer object.
+    @param p_rd: renderer discoverer object.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_release', None) or \
+        _Cfunction('libvlc_renderer_discoverer_release', ((1,),), None,
+                    None, ctypes.c_void_p)
+    return f(p_rd)
+
+def libvlc_renderer_discoverer_start(p_rd):
+    '''Start renderer discovery
+    To stop it, call L{libvlc_renderer_discoverer_stop}() or
+    L{libvlc_renderer_discoverer_release}() directly.
+    See L{libvlc_renderer_discoverer_stop}().
+    @param p_rd: renderer discoverer object.
+    @return: -1 in case of error, 0 otherwise.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_start', None) or \
+        _Cfunction('libvlc_renderer_discoverer_start', ((1,),), None,
+                    ctypes.c_int, ctypes.c_void_p)
+    return f(p_rd)
+
+def libvlc_renderer_discoverer_stop(p_rd):
+    '''Stop renderer discovery.
+    See L{libvlc_renderer_discoverer_start}().
+    @param p_rd: renderer discoverer object.
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_stop', None) or \
+        _Cfunction('libvlc_renderer_discoverer_stop', ((1,),), None,
+                    None, ctypes.c_void_p)
+    return f(p_rd)
+
+def libvlc_renderer_discoverer_event_manager(p_rd):
+    '''Get the event manager of the renderer discoverer
+    The possible events to attach are @ref libvlc_RendererDiscovererItemAdded
+    and @ref libvlc_RendererDiscovererItemDeleted.
+    The @ref libvlc_renderer_item_t struct passed to event callbacks is owned by
+    VLC, users should take care of holding/releasing this struct for their
+    internal usage.
+    See libvlc_event_t.u.renderer_discoverer_item_added.item
+    See libvlc_event_t.u.renderer_discoverer_item_removed.item.
+    @return: a valid event manager (can't fail).
+    @version: LibVLC 3.0.0 or later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_event_manager', None) or \
+        _Cfunction('libvlc_renderer_discoverer_event_manager', ((1,),), class_result(EventManager),
+                    ctypes.c_void_p, ctypes.c_void_p)
+    return f(p_rd)
+
+def libvlc_renderer_discoverer_list_get(p_inst, ppp_services):
+    '''Get media discoverer services
+    See libvlc_renderer_list_release().
+    @param p_inst: libvlc instance.
+    @param ppp_services: address to store an allocated array of renderer discoverer services (must be freed with libvlc_renderer_list_release() by the caller) [OUT].
+    @return: the number of media discoverer services (0 on error).
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_list_get', None) or \
+        _Cfunction('libvlc_renderer_discoverer_list_get', ((1,), (1,),), None,
+                    ctypes.c_size_t, Instance, ctypes.POINTER(ctypes.POINTER(RDDescription)))
+    return f(p_inst, ppp_services)
+
+def libvlc_renderer_discoverer_list_release(pp_services, i_count):
+    '''Release an array of media discoverer services
+    See L{libvlc_renderer_discoverer_list_get}().
+    @param pp_services: array to release.
+    @param i_count: number of elements in the array.
+    @version: LibVLC 3.0.0 and later.
+    '''
+    f = _Cfunctions.get('libvlc_renderer_discoverer_list_release', None) or \
+        _Cfunction('libvlc_renderer_discoverer_list_release', ((1,), (1,),), None,
+                    None, ctypes.POINTER(RDDescription), ctypes.c_size_t)
+    return f(pp_services, i_count)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+def libvlc_media_player_get_fps(p_mi):
+    '''Get movie fps rate
+    This function is provided for backward compatibility. It cannot deal with
+    multiple video tracks. In LibVLC versions prior to 3.0, it would also fail
+    if the file format did not convey the frame rate explicitly.
+    \deprecated Consider using L{libvlc_media_tracks_get}() instead.
+    @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)
+
+def libvlc_media_player_set_agl(p_mi, drawable):
+    '''\deprecated Use L{libvlc_media_player_set_nsobject}() instead.
+    '''
+    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)
+
+def libvlc_media_player_get_agl(p_mi):
+    '''\deprecated Use L{libvlc_media_player_get_nsobject}() instead.
+    '''
+    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)
+
+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)
+
+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)
+
+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)
+
+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. It must be freed with L{libvlc_track_description_list_release}().
+    '''
+    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)
+
+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. It must be freed with L{libvlc_track_description_list_release}().
+    '''
+    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)
+
+def libvlc_video_set_subtitle_file(p_mi, psz_subtitle):
+    '''Set new video subtitle file.
+    \deprecated Use L{libvlc_media_player_add_slave}() instead.
+    @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)
+
+def libvlc_toggle_teletext(p_mi):
+    '''Toggle teletext transparent status on video output.
+    \deprecated use L{libvlc_video_set_teletext}() instead.
+    @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)
+
+def libvlc_audio_output_device_count(p_instance, psz_audio_output):
+    '''Backward compatibility stub. Do not use in new code.
+    \deprecated Use L{libvlc_audio_output_device_list_get}() instead.
+    @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_audio_output)
+
+def libvlc_audio_output_device_longname(p_instance, psz_output, i_device):
+    '''Backward compatibility stub. Do not use in new code.
+    \deprecated Use L{libvlc_audio_output_device_list_get}() instead.
+    @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_output, i_device)
+
+def libvlc_audio_output_device_id(p_instance, psz_audio_output, i_device):
+    '''Backward compatibility stub. Do not use in new code.
+    \deprecated Use L{libvlc_audio_output_device_list_get}() instead.
+    @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_audio_output, i_device)
+
+def libvlc_media_parse(p_md):
+    '''Parse a media.
+    This fetches (local) art, meta data and tracks information.
+    The method is synchronous.
+    \deprecated This function could block indefinitely.
+                Use L{libvlc_media_parse_with_options}() instead
+    See L{libvlc_media_parse_with_options}
+    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)
+
+def libvlc_media_parse_async(p_md):
+    '''Parse a media.
+    This fetches (local) art, 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.
+    \deprecated You can't be sure to receive the libvlc_MediaParsedChanged
+                event (you can wait indefinitely for this event).
+                Use L{libvlc_media_parse_with_options}() instead
+    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)
+
+def libvlc_media_is_parsed(p_md):
+    '''Return true is the media descriptor object is parsed
+    \deprecated This can return true in case of failure.
+                Use L{libvlc_media_get_parsed_status}() instead
+    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)
+
+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)
+
+def libvlc_media_discoverer_new_from_name(p_inst, psz_name):
+    '''\deprecated Use L{libvlc_media_discoverer_new}() and L{libvlc_media_discoverer_start}().
+    '''
+    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)
+
+def libvlc_media_discoverer_localized_name(p_mdis):
+    '''Get media service discover object its localized name.
+    \deprecated Useless, use L{libvlc_media_discoverer_list_get}() to get the
+    longname of the service discovery.
+    @param p_mdis: media discover object.
+    @return: localized name or None if the media_discoverer is not started.
+    '''
+    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)
+
+def libvlc_media_discoverer_event_manager(p_mdis):
+    '''Get event manager from media service discover object.
+    \deprecated Useless, media_discoverer events are only triggered when calling
+    L{libvlc_media_discoverer_start}() and L{libvlc_media_discoverer_stop}().
+    @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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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)
+
+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.