Difference between revisions of "Python bindings"
| Line 1: | Line 1: | ||
= Python bindings = | = Python bindings = | ||
| − | You can find two versions of python bindings: an old one (see [[Old Python bindings]]), hand-written C-module, and a new | + | You can find two versions of python bindings: an old one (see [[Old Python bindings]]), hand-written C-module, and a new one, which is ctypes-based and automatically generated. |
The old version of the bindings is still maintained for the moment, but the idea is to progressively migrate to the new version. | The old version of the bindings is still maintained for the moment, but the idea is to progressively migrate to the new version. | ||
| Line 7: | Line 7: | ||
The new module features : | The new module features : | ||
| − | * a complete cover of the libvlc/MediaControl API, since | + | * a complete cover of the libvlc/MediaControl API, since it is automatically generated from the include files. |
* no compilation hassle: the generated module is pure python. | * no compilation hassle: the generated module is pure python. | ||
* no versioning hassle: the same module works with multiple VLC versions. | * no versioning hassle: the same module works with multiple VLC versions. | ||
| Line 20: | Line 20: | ||
== Usage == | == Usage == | ||
| − | The vlc.py module is also a runnable example player application (see code at the end of the module, starting from the line "if __name__ == '__main__'). | + | The vlc.py module is also a runnable example player application (see code at the end of the module, starting from the line "if __name__ == '__main__'). A helper module [http://git.videolan.org/?p=vlc.git;a=tree;f=bindings/python-ctypes/vlcwidget.py] provides a pygtk VLCWidget() to ease integration. |
Revision as of 14:39, 4 September 2009
Python bindings
You can find two versions of python bindings: an old one (see Old Python bindings), hand-written C-module, and a new one, which is ctypes-based and automatically generated. The old version of the bindings is still maintained for the moment, but the idea is to progressively migrate to the new version.
Features
The new module features :
- a complete cover of the libvlc/MediaControl API, since it is automatically generated from the include files.
- no compilation hassle: the generated module is pure python.
- no versioning hassle: the same module works with multiple VLC versions.
- a complete documentation.
Download
You can download the vlc.py module from the Advene website. It only depends on ctypes (standard module in python >= 2.5). Put the module in some place accessible by python (either next to your application, or in a directory from sys.path).
Alternatively, you can generate it by yourself using the generate.py program and accompanying files in the vlc source tree (see [1]).
Usage
The vlc.py module is also a runnable example player application (see code at the end of the module, starting from the line "if __name__ == '__main__'). A helper module [2] provides a pygtk VLCWidget() to ease integration.
