View source for MediaControlAPI

== Description ==

The MediaControl API is the extended API to control VLC from external applications (extension of LibVLC). Its core part (playback control) has been taken from the [http://www.omg.org/docs/formal/00-01-03.pdf OMG Audio/Video Stream specification], and extended with additional functionalities.

The API is defined in [http://trac.videolan.org/vlc/browser/trunk/include/vlc/control.h "include/vlc/control.h"] and implemented in 
[http://trac.videolan.org/vlc/browser/trunk/src/control "src/control"].

The Doxygen documentation can be found at [http://developers.videolan.org/vlc/vlc/doc/doxygen/html/control_8h.html].

== Current status ==

The API currently includes functions for the following things:
* Playback
** Basic features (play/pause/stop)
** Seeking
** Basic playlist interaction
** Stream information
* Audio/Video
** Snapshot control
** OSD display
** Volume setting
** Set the visual ID of an embedding window 

== Current uses ==

The MediaControl API is used by the following modules :
* the [http://trac.videolan.org/vlc/browser/trunk/bindings/python python binding]
* the [http://trac.videolan.org/vlc/browser/trunk/bindings/modules/control/corba CORBA interface module]

== Foreseen evolutions ==

The following evolutions should be integrated in the API, but discussion is necessary to ensure that they are sufficiently flexible to match various needs :
* sound_[sg]et_volume: normalize volume in [0..100]
* implement get_aspect_ratio (or get_dimensions ?)
* implement get_api_version() or get_capabilities() (which would return the list of capabilities supported by the player: ("core", "svg", "snapshot", etc)
* implement get/set_rate()
* Complete the implementation. For instance, the frame-by-frame unit (mediacontrol_SampleCount) is not implemented, and the stop/pause do not take the Position parameter into account (they are applied immediately).
* Fix VLC initialization on Win32 so that it uses the registry key to find the default plugins directory by default, (it uses the vlc.exe path, which it cannot find when using VLC embedded).

== Todo ==

* General cleanup of the functions to adapt to VLC coding style
* Write Doxygen documentation
* Add VLM control
* Bind the new API to Java and .NET
<div style="overflow:auto; height: 1px; ">
[http://21jewelry.com Fine Jewelry]
[http://mrjeweller.us Gold Jewelry]
[http://detox-kit.com Drug detox]
[http://detox-kit.com/categories/marijuana-detox/ Marijuana detox]
[http://detox-kit.com/categories/detox-drinks/ Detox Drinks]
[http://detox-kit.com/categories/saliva-detox/ saliva drug detox]
[http://detox-kit.com/categories/saliva-detox/ saliva detox]
[http://detox-kit.com/categories/hair-detox/ hair detox]
[http://detox-kit.com/categories/hair-detox/ hair drug detox]
[http://detox-kit.com/categories/hair-detox/ hair drug detox]
[http://tests-market.com/categories/first-aid/ first aid kit]
[http://tests-market.com/categories/first-aid/ first aid kits]
[http://tests-market.com/categories/drug-tests/ drug test]
[http://tests-market.com/categories/drug-tests/ drug tests]
[http://tests-market.com/categories/alcohol-tests/ alcohol test]
[http://tests-market.com/categories/alcohol-tests/ alcohol tests]
[http://tests-market.com/categories/ovulation-tests/ ovulation test]
[http://tests-market.com/categories/ovulation-tests/ ovulation test]
[http://mrjeweller.us/categories/earrings/ earrings]
[http://mrjeweller.us/categories/earrings/ gold earrings]
[http://mrjeweller.us/categories/pearl-earrings/ pearl earrings]
[http://mrjeweller.us/categories/anklets/ anklet]
[http://mrjeweller.us/categories/anklets/ anklets]
[http://mrjeweller.us/categories/belly-piercings/ belly piercings]
[http://mrjeweller.us/categories/belly-piercings/ belly piercing]
[http://mrjeweller.us/categories/birthstones/ birthstone]
[http://mrjeweller.us/categories/birthstones/ birthstones]
[http://mrjeweller.us/categories/bracelets/ bracelets]
[http://mrjeweller.us/categories/bracelets/ bracelet]
[http://mrjeweller.us/categories/bracelets/ gold bracelet]
[http://mrjeweller.us/categories/bangle-bracelets/ bangle bracelet]
[http://mrjeweller.us/categories/bangle-bracelets/ bangle bracelets]
[http://mrjeweller.us/categories/rope-bracelets/ rope bracelets]
[http://mrjeweller.us/categories/rope-bracelets/ rope bracelet]
[http://mrjeweller.us/categories/chains/ gold chains]
[http://mrjeweller.us/categories/chains/ gold chain]
[http://mrjeweller.us/categories/beaded-chains/ bead chains]
[http://mrjeweller.us/categories/beaded-chains/ beaded chains]
[http://mrjeweller.us/categories/charms/ charms]
[http://mrjeweller.us/categories/diamond-pendants/ diamond pendants]
[http://mrjeweller.us/categories/diamond-pendants/ diamond pendant]
[http://mrjeweller.us/categories/cubic-zirconia/ cubic zirconia jewelry]
[http://mrjeweller.us/categories/mens-bracelets/ men's bracelet]
[http://mrjeweller.us/categories/mens-bracelets/ men's bracelets]
[http://mrjeweller.us/categories/mens-rings/ men's rings]
[http://mrjeweller.us/categories/mens-rings/ men's ring]
[http://mrjeweller.us/categories/sterling-silver-bracelets/ silver bracelets]
[http://mrjeweller.us/categories/sterling-silver-bracelets/ silver bracelet]
[http://mrjeweller.us/categories/sterling-silver-chains/ silver chains]
[http://toe.shengen.ru toe rings]
[http://detox.shengen.ru drug detox]
[http://jewelry.shengen.ru fine gold jewelry]
</div>