From 50ff8438a0cc2fa5c3750ad9d4b382da73872aaf Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Mon, 18 Apr 2011 21:50:12 +0200 Subject: [PATCH 01/41] Video reimplementations issues --- openlp/core/lib/htmlbuilder.py | 61 + openlp/core/ui/maindisplay.py | 280 +- openlp/core/ui/slidecontroller.py | 50 +- openlp/plugins/media/lib/__init__.py | 46 + openlp/plugins/media/lib/mediacontroller.py | 300 + openlp/plugins/media/lib/mediaitem.py | 54 +- openlp/plugins/media/lib/phononcontroller.py | 81 + openlp/plugins/media/lib/vlc.py | 6106 ++++++++++++++++++ openlp/plugins/media/lib/vlccontroller.py | 49 + openlp/plugins/media/lib/webkitcontroller.py | 77 + openlp/plugins/media/mediaplugin.py | 3 +- 11 files changed, 6921 insertions(+), 186 deletions(-) create mode 100644 openlp/plugins/media/lib/mediacontroller.py create mode 100644 openlp/plugins/media/lib/phononcontroller.py create mode 100644 openlp/plugins/media/lib/vlc.py create mode 100644 openlp/plugins/media/lib/vlccontroller.py create mode 100644 openlp/plugins/media/lib/webkitcontroller.py diff --git a/openlp/core/lib/htmlbuilder.py b/openlp/core/lib/htmlbuilder.py index c4361a421..180da3fbb 100644 --- a/openlp/core/lib/htmlbuilder.py +++ b/openlp/core/lib/htmlbuilder.py @@ -71,6 +71,9 @@ body { #video2 { z-index:3; } +#flash { + z-index:4; +} #alert { position: absolute; left: 0px; @@ -303,6 +306,63 @@ sup { function show_text_complete(){ return (text_opacity()==1); } + + function getFlashMovieObject(movieName) + { + if (window.document[movieName]) + { + return window.document[movieName]; + } + if (navigator.appName.indexOf("Microsoft Internet")==-1) + { + if (document.embeds && document.embeds[movieName]) + return document.embeds[movieName]; + } + else // if (navigator.appName.indexOf("Microsoft Internet")!=-1) + { + return document.getElementById(movieName); + } + } + + function show_flash(state, path){ + var text = document.getElementById('flash'); + var flashMovie=getFlashMovieObject("OpenLPFlashMovie"); + var src = "src = 'file:///" + path + "'"; + var view_parm = " wmode='opaque'" + + " width='" + window.innerWidth + "'" + + " height='" + window.innerHeight + "'"; + var swf_parm = " autostart='false' loop='false' play='false'" + + " hidden='false' swliveconnect='true'" + + " name='OpenLPFlashMovie'>"; + + switch(state){ + case 'load': + text.innerHTML = ""; + flashMovie = getFlashMovieObject("OpenLPFlashMovie"); + text.style.visibility = 'visible'; + flashMovie.Play(); + break; + + case 'play': + text.style.visibility = 'visible'; + flashMovie.Play(); + break; + + case 'rewind': + ret = 'rewind'; + alert(' Wert: ' + flashMovie.TGetProperty("/", 4)); +// flashMovie.TotalFrames() +// PercentLoaded() +// GotoFrame() + break; + case 'stop': + flashMovie.StopPlay(); + text.innerHTML = '' + text.style.visibility = 'hidden'; + break; + } + } + @@ -312,6 +372,7 @@ sup { + %s
diff --git a/openlp/core/ui/maindisplay.py b/openlp/core/ui/maindisplay.py index 5a864957e..63e1c8282 100644 --- a/openlp/core/ui/maindisplay.py +++ b/openlp/core/ui/maindisplay.py @@ -99,28 +99,30 @@ class MainDisplay(DisplayWidget): self.screen = self.screens.current self.setVisible(False) self.setGeometry(self.screen[u'size']) - self.videoWidget = Phonon.VideoWidget(self) - self.videoWidget.setVisible(False) - self.videoWidget.setGeometry(QtCore.QRect(0, 0, - self.screen[u'size'].width(), self.screen[u'size'].height())) - log.debug(u'Setup Phonon for monitor %s' % self.screens.monitor_number) - self.mediaObject = Phonon.MediaObject(self) - self.audio = Phonon.AudioOutput(Phonon.VideoCategory, self.mediaObject) - Phonon.createPath(self.mediaObject, self.videoWidget) - Phonon.createPath(self.mediaObject, self.audio) - QtCore.QObject.connect(self.mediaObject, - QtCore.SIGNAL(u'stateChanged(Phonon::State, Phonon::State)'), - self.videoState) - QtCore.QObject.connect(self.mediaObject, - QtCore.SIGNAL(u'finished()'), - self.videoFinished) - QtCore.QObject.connect(self.mediaObject, - QtCore.SIGNAL(u'tick(qint64)'), - self.videoTick) +# self.videoWidget = Phonon.VideoWidget(self) +# self.videoWidget.setVisible(False) +# self.videoWidget.setGeometry(QtCore.QRect(0, 0, +# self.screen[u'size'].width(), self.screen[u'size'].height())) +# log.debug(u'Setup Phonon for monitor %s' % self.screens.monitor_number) +# self.mediaObject = Phonon.MediaObject(self) +# self.audio = Phonon.AudioOutput(Phonon.VideoCategory, self.mediaObject) +# Phonon.createPath(self.mediaObject, self.videoWidget) +# Phonon.createPath(self.mediaObject, self.audio) +# QtCore.QObject.connect(self.mediaObject, +# QtCore.SIGNAL(u'stateChanged(Phonon::State, Phonon::State)'), +# self.videoState) +# QtCore.QObject.connect(self.mediaObject, +# QtCore.SIGNAL(u'finished()'), +# self.videoFinished) +# QtCore.QObject.connect(self.mediaObject, +# QtCore.SIGNAL(u'tick(qint64)'), +# self.videoTick) + log.debug(u'Setup webView for monitor %s' % self.screens.monitor_number) self.webView = QtWebKit.QWebView(self) self.webView.setGeometry(0, 0, self.screen[u'size'].width(), self.screen[u'size'].height()) + self.webView.settings().setAttribute(QtWebKit.QWebSettings.PluginsEnabled,True) self.page = self.webView.page() self.frame = self.page.mainFrame() QtCore.QObject.connect(self.webView, @@ -173,9 +175,17 @@ class MainDisplay(DisplayWidget): self.primary = False else: self.primary = True + Receiver.send_message(u'media_set_display', self) log.debug( u'Finished setup for monitor %s' % self.screens.monitor_number) + def videoHelper(self, newState, oldState): + """ + Start the video at a predetermined point. + """ + if type(newState) == Phonon.State: + print "Phonon State alt:%d, neu:%d" % (oldState, newState) + def text(self, slide): """ Add the slide text from slideController @@ -201,7 +211,7 @@ class MainDisplay(DisplayWidget): """ log.debug(u'alert to display') if self.height() != self.screen[u'size'].height() \ - or not self.isVisible() or self.videoWidget.isVisible(): + or not self.isVisible():# or self.videoWidget.isVisible(): shrink = True else: shrink = False @@ -282,129 +292,107 @@ class MainDisplay(DisplayWidget): if self.isLive: Receiver.send_message(u'maindisplay_active') - def resetVideo(self): - """ - Used after Video plugin has changed the background - """ - log.debug(u'resetVideo') - if self.phononActive: - self.mediaObject.stop() - self.mediaObject.clearQueue() - self.webView.setVisible(True) - self.videoWidget.setVisible(False) - self.phononActive = False - else: - self.frame.evaluateJavaScript(u'show_video("close");') - self.override = {} - # Update the preview frame. - if self.isLive: - Receiver.send_message(u'maindisplay_active') - - def videoPlay(self): - """ - Responds to the request to play a loaded video - """ - log.debug(u'videoPlay') - if self.phononActive: - self.mediaObject.play() - else: - self.frame.evaluateJavaScript(u'show_video("play");') - # show screen - if self.isLive: - self.setVisible(True) - - def videoPause(self): - """ - Responds to the request to pause a loaded video - """ - log.debug(u'videoPause') - if self.phononActive: - self.mediaObject.pause() - else: - self.frame.evaluateJavaScript(u'show_video("pause");') - - def videoStop(self): - """ - Responds to the request to stop a loaded video - """ - log.debug(u'videoStop') - if self.phononActive: - self.mediaObject.stop() - else: - self.frame.evaluateJavaScript(u'show_video("stop");') - - def videoVolume(self, volume): - """ - Changes the volume of a running video - """ - log.debug(u'videoVolume %d' % volume) - vol = float(volume) / float(10) - if self.phononActive: - self.audio.setVolume(vol) - else: - self.frame.evaluateJavaScript(u'show_video(null, null, %s);' % - str(vol)) - - def video(self, videoPath, volume, isBackground=False): - """ - Loads and starts a video to run with the option of sound - """ - log.debug(u'video') - self.webLoaded = True - self.setGeometry(self.screen[u'size']) - # We are running a background theme - self.override[u'theme'] = u'' - self.override[u'video'] = True - vol = float(volume) / float(10) - if isBackground or not self.usePhonon: - js = u'show_video("init", "%s", %s, true); show_video("play");' % \ - (videoPath.replace(u'\\', u'\\\\'), str(vol)) - self.frame.evaluateJavaScript(js) - else: - self.phononActive = True - self.mediaObject.stop() - self.mediaObject.clearQueue() - self.mediaObject.setCurrentSource(Phonon.MediaSource(videoPath)) - # Need the timer to trigger set the trigger to 200ms - # Value taken from web documentation. - if self.serviceItem.end_time != 0: - self.mediaObject.setTickInterval(200) - self.mediaObject.play() - self.webView.setVisible(False) - self.videoWidget.setVisible(True) - self.audio.setVolume(vol) - # Update the preview frame. - if self.isLive: - Receiver.send_message(u'maindisplay_active') - return self.preview() - - def videoState(self, newState, oldState): - """ - Start the video at a predetermined point. - """ - if newState == Phonon.PlayingState \ - and oldState != Phonon.PausedState \ - and self.serviceItem.start_time > 0: - # set start time in milliseconds - self.mediaObject.seek(self.serviceItem.start_time * 1000) - - def videoFinished(self): - """ - Blank the Video when it has finished so the final frame is not left - hanging - """ - self.videoStop() - self.hideDisplay(HideMode.Blank) - self.phononActive = False - self.videoHide = True - - def videoTick(self, tick): - """ - Triggered on video tick every 200 milli seconds - """ - if tick > self.serviceItem.end_time * 1000: - self.videoFinished() - +# def resetVideo(self): +# """ +# Used after Video plugin has changed the background +# """ +# log.debug(u'resetVideo') +# if self.phononActive: +# self.mediaObject.stop() +# self.mediaObject.clearQueue() +# self.webView.setVisible(True) +# self.videoWidget.setVisible(False) +# self.phononActive = False +# else: +# self.frame.evaluateJavaScript(u'show_video("close");') +# self.override = {} +# # Update the preview frame. +# if self.isLive: +# Receiver.send_message(u'maindisplay_active') +# +# def videoPlay(self): +# """ +# Responds to the request to play a loaded video +# """ +# log.debug(u'videoPlay') +# self.frame.evaluateJavaScript(u'show_flash("play","");') +# self.frame.evaluateJavaScript(u'show_video("stop");') +# return +# if self.phononActive: +# self.mediaObject.play() +# else: +# self.frame.evaluateJavaScript(u'show_video("play");') +# # show screen +# if self.isLive: +# self.setVisible(True) +# +# def videoPause(self): +# """ +# Responds to the request to pause a loaded video +# """ +# log.debug(u'videoPause') +# if self.phononActive: +# self.mediaObject.pause() +# else: +# self.frame.evaluateJavaScript(u'show_video("pause");') +# +# def videoStop(self): +# """ +# Responds to the request to stop a loaded video +# """ +# log.debug(u'videoStop') +# if self.phononActive: +# self.mediaObject.stop() +# else: +# self.frame.evaluateJavaScript(u'show_video("stop");') +# +# def videoVolume(self, volume): +# """ +# Changes the volume of a running video +# """ +# log.debug(u'videoVolume %d' % volume) +# vol = float(volume) / float(10) +# if self.phononActive: +# self.audio.setVolume(vol) +# else: +# self.frame.evaluateJavaScript(u'show_video(null, null, %s);' % +# str(vol)) +# +# def video(self, videoPath, volume, isBackground=False): +# """ +# Loads and starts a video to run with the option of sound +# """ +# log.debug(u'video') +# Receiver.send_message(u'media_video', [self, videoPath, volume, isBackground]) +# return self.preview() +# +# def videoState(self, newState, oldState): +# """ +# Start the video at a predetermined point. +# """ +# if newState == Phonon.PlayingState \ +# and oldState != Phonon.PausedState \ +# and self.serviceItem.start_time > 0: +# # set start time in milliseconds +# self.mediaObject.seek(self.serviceItem.start_time * 1000) +# +# def videoFinished(self): +# """ +# Blank the Video when it has finished so the final frame is not left +# hanging +# """ +# self.videoStop() +# self.hideDisplay(HideMode.Blank) +# self.phononActive = False +# self.videoHide = True +# +# def videoTick(self, tick): +# """ +# Triggered on video tick every 200 milli seconds +# """ +# if tick > self.serviceItem.end_time * 1000: +# self.videoFinished() +# def isWebLoaded(self): """ Called by webView event to show display is fully loaded @@ -515,8 +503,9 @@ class MainDisplay(DisplayWidget): Store the images so they can be replaced when required """ log.debug(u'hideDisplay mode = %d', mode) - if self.phononActive: - self.videoPause() +# if self.phononActive: +# self.videoPause() + Receiver.send_message(u'media_pause', self) if mode == HideMode.Screen: self.frame.evaluateJavaScript(u'show_blank("desktop");') self.setVisible(False) @@ -543,7 +532,8 @@ class MainDisplay(DisplayWidget): self.setVisible(True) if self.phononActive: self.webView.setVisible(False) - self.videoPlay() + #self.videoPlay() + Receiver.send_message(u'media_play', self) self.hideMode = None # Trigger actions when display is active again if self.isLive: diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index 232653326..1984cecc9 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -225,6 +225,9 @@ class SlideController(QtGui.QWidget): self.songMenu.setMenu(QtGui.QMenu( translate('OpenLP.SlideController', 'Go To'), self.toolbar)) self.toolbar.makeWidgetsInvisible([u'Song Menu']) + # Build the seekSlider. + self.seekSlider = QtGui.QSlider(QtCore.Qt.Horizontal) + self.seekSlider.setMaximum(1000) # Build the volumeSlider. self.volumeSlider = QtGui.QSlider(QtCore.Qt.Horizontal) self.volumeSlider.setTickInterval(1) @@ -234,11 +237,11 @@ class SlideController(QtGui.QWidget): else: # Build the seekSlider. self.seekSlider = Phonon.SeekSlider() - self.seekSlider.setGeometry(QtCore.QRect(90, 260, 221, 24)) - self.seekSlider.setObjectName(u'seekSlider') - self.mediabar.addToolbarWidget(u'Seek Slider', self.seekSlider) self.volumeSlider = Phonon.VolumeSlider() - self.volumeSlider.setGeometry(QtCore.QRect(90, 260, 221, 24)) + self.seekSlider.setGeometry(QtCore.QRect(90, 260, 221, 24)) + self.seekSlider.setObjectName(u'seekSlider') + self.mediabar.addToolbarWidget(u'Seek Slider', self.seekSlider) + self.volumeSlider.setGeometry(QtCore.QRect(90, 160, 221, 24)) self.volumeSlider.setObjectName(u'volumeSlider') self.mediabar.addToolbarWidget(u'Audio Volume', self.volumeSlider) self.controllerLayout.addWidget(self.mediabar) @@ -297,6 +300,8 @@ class SlideController(QtGui.QWidget): QtCore.SIGNAL(u'triggered(bool)'), self.onThemeDisplay) QtCore.QObject.connect(self.desktopScreen, QtCore.SIGNAL(u'triggered(bool)'), self.onHideDisplay) + QtCore.QObject.connect(self.seekSlider, + QtCore.SIGNAL(u'sliderReleased()'), self.mediaSeek) QtCore.QObject.connect(self.volumeSlider, QtCore.SIGNAL(u'sliderReleased()'), self.mediaVolume) QtCore.QObject.connect(Receiver.get_receiver(), @@ -392,7 +397,8 @@ class SlideController(QtGui.QWidget): def liveEscape(self): self.display.setVisible(False) - self.display.videoStop() + #self.display.videoStop() + Receiver.send_message('media_stop', self.display) def servicePrevious(self): Receiver.send_message('servicemanager_previous_item') @@ -496,7 +502,7 @@ class SlideController(QtGui.QWidget): len(item.get_frames()) > 1: self.toolbar.makeWidgetsVisible(self.loopList) if item.is_media(): - self.toolbar.setVisible(False) + #self.toolbar.setVisible(False) self.mediabar.setVisible(True) def enablePreviewToolBar(self, item): @@ -509,7 +515,7 @@ class SlideController(QtGui.QWidget): if item.is_capable(ItemCapabilities.AllowsEdit) and item.from_plugin: self.toolbar.makeWidgetsVisible(self.songEditList) elif item.is_media(): - self.toolbar.setVisible(False) + #self.toolbar.setVisible(False) self.mediabar.setVisible(True) self.volumeSlider.setAudioOutput(self.audio) @@ -1028,7 +1034,8 @@ class SlideController(QtGui.QWidget): log.debug(u'SlideController onMediaStart') file = os.path.join(item.get_frame_path(), item.get_frame_title()) if self.isLive: - self.display.video(file, self.volume) + #self.display.video(file, self.volume) + Receiver.send_message(u'media_video', [self.display, file, self.volume, False]) self.volumeSlider.setValue(self.volume) else: self.mediaObject.stop() @@ -1038,13 +1045,24 @@ class SlideController(QtGui.QWidget): self.seekSlider.show() self.onMediaPlay() + def mediaSeek(self): + """ + Respond to the release of Seek Slider + """ + log.debug(u'SlideController mediaSeek') + self.seekPos = self.seekSlider.value() + #self.display.videoVolume(self.volume) + Receiver.send_message(u'media_seek', [self.display, self.seekPos]) + def mediaVolume(self): """ Respond to the release of Volume Slider """ log.debug(u'SlideController mediaVolume') self.volume = self.volumeSlider.value() - self.display.videoVolume(self.volume) + #self.display.videoVolume(self.volume) + Receiver.send_message(u'media_volume', [self.display, self.volume]) + def onMediaPause(self): """ @@ -1052,7 +1070,8 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaPause') if self.isLive: - self.display.videoPause() + #self.display.videoPause() + Receiver.send_message(u'media_pause', self.display) else: self.mediaObject.pause() @@ -1062,7 +1081,8 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaPlay') if self.isLive: - self.display.videoPlay() + Receiver.send_message(u'media_play', self.display) + #self.display.videoPlay() else: self.slidePreview.hide() self.video.show() @@ -1074,7 +1094,8 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaStop') if self.isLive: - self.display.videoStop() + #self.display.videoStop() + Receiver.send_message(u'media_stop', self.display) else: self.mediaObject.stop() self.video.hide() @@ -1085,9 +1106,10 @@ class SlideController(QtGui.QWidget): """ Respond to a request to close the Video """ - log.debug(u'SlideController onMediaStop') + log.debug(u'SlideController onMediaClose') if self.isLive: - self.display.resetVideo() + #self.display.resetVideo() + Receiver.send_message(u'media_reset', self.display) else: self.mediaObject.stop() self.mediaObject.clearQueue() diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 7f63c8108..3a2385ded 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -24,7 +24,53 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### +from PyQt4 import QtCore + +class MediaBackends(object): + """ + An enumeration for possible Backends. + """ + Webkit = 0 + Phonon = 1 + Vlc = 2 + +class MediaController(object): + """ + """ + def __init__(self, parent): + self.parent = parent + self.state = 0 + self.Timer = QtCore.QTimer() + QtCore.QObject.connect(self.Timer, + QtCore.SIGNAL("timeout()"), self.updatePlayer) + + + def load(self, display, path, volume): + pass + + def play(self, display): + pass + + def pause(self, display): + pass + + def stop(self, display): + pass + + def seek(self, display, seekVal): + pass + + def reset(self, display): + pass + + def updatePlayer(self): + pass + from mediaitem import MediaMediaItem from mediatab import MediaTab +from mediacontroller import MediaManager +from webkitcontroller import WebkitController +#from phononcontroller import PhononController +#from vlccontroller import VlcController __all__ = ['MediaMediaItem'] diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py new file mode 100644 index 000000000..7595a80b3 --- /dev/null +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -0,0 +1,300 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 + +############################################################################### +# OpenLP - Open Source Lyrics Projection # +# --------------------------------------------------------------------------- # +# Copyright (c) 2008-2011 Raoul Snyman # +# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # +# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # +# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # +# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # +# --------------------------------------------------------------------------- # +# 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; version 2 of the License. # +# # +# 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., 59 # +# Temple Place, Suite 330, Boston, MA 02111-1307 USA # +############################################################################### + +import logging + +import sys, types +from PyQt4 import QtCore +import vlc + +from PyQt4 import QtCore, QtGui +from PyQt4.phonon import Phonon + +from openlp.core.lib import Receiver +from openlp.plugins.media.lib import MediaBackends +from webkitcontroller import WebkitController +from phononcontroller import PhononController + +log = logging.getLogger(__name__) + +class MediaManager(object): + """ + """ + def __init__(self, parent): + self.parent = parent + + self.availableBackends = [ + MediaBackends.Webkit, + MediaBackends.Phonon, + MediaBackends.Vlc] + self.curDisplayMediaController = {} + self.displayWebkitController = WebkitController(self) + self.displayPhononController = PhononController(self) + #self.displayVlcController = VlcController(self) + + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_set_display'), self.setDisplay) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_video'), self.video) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_play'), self.videoPlay) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_pause'), self.videoPause) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_stop'), self.videoStop) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_seek'), self.videoSeek) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_volume'), self.videoVolume) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_reset'), self.videoReset) + + + def setDisplay(self, display): + print display + #self.setupVlcController(display) + self.setupPhononController(display) + self.setupWebkitController(display) + + + def setupWebkitController(self, display): + #self.displayWebkitController[display] = display.webView + display.webView.raise_() + + def setupPhononController(self, display): + display.phononWidget = Phonon.VideoWidget(display) + display.phononWidget.setVisible(False) + display.phononWidget.setGeometry(QtCore.QRect(0, 0, + display.screen[u'size'].width(), display.screen[u'size'].height())) + display.mediaObject = Phonon.MediaObject(display) + display.audio = Phonon.AudioOutput(Phonon.VideoCategory, display.mediaObject) + Phonon.createPath(display.mediaObject, display.phononWidget) + Phonon.createPath(display.mediaObject, display.audio) + display.phononWidget.raise_() + QtCore.QObject.connect(display.mediaObject, + QtCore.SIGNAL(u'stateChanged(Phonon::State, Phonon::State)'), + display.videoHelper) +# display.mediaObject.stateChanged.connect(self.videoState) +# QtCore.QObject.connect(display.mediaObject, +# QtCore.SIGNAL(u'finished()'), +# self.videoFinished) +# QtCore.QObject.connect(display.mediaObject, +# QtCore.SIGNAL(u'tick(qint64)'), +# self.videoTick) + + #self.displayPhononController[display] = display.mediaObject + + def setupVlcController(self, display): + display.vlcWidget = QtGui.QWidget(display) + instance=vlc.Instance() + self.movieName = None + player=instance.media_player_new(self.movieName) + # 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 == "linux2": # for Linux using the X Server + player.set_xwindow(self.hwnd) + elif sys.platform == "win32": # for Windows + player.set_hwnd(self.hwnd) + elif sys.platform == "darwin": # for MacOS + player.set_agl(self.hwnd) + + display.vlcWidget.setGeometry(QtCore.QRect(0, 0, + display.screen[u'size'].width(), display.screen[u'size'].height())) + display.vlcWidget.raise_() + #self.displayVlcController[display] = player + + def video(self, msg): + """ + Loads and starts a video to run with the option of sound + """ + display = msg[0] + videoPath = msg[1] + volume = msg[2] + isBackground = msg[3] + + log.debug(u'video') + display.webLoaded = True + display.setGeometry(display.screen[u'size']) + # We are running a background theme + display.override[u'theme'] = u'' + display.override[u'video'] = True + vol = float(volume) / float(10) + usePhonon = QtCore.QSettings().value( + u'media/use phonon', QtCore.QVariant(True)).toBool() + if usePhonon: + self.curDisplayMediaController[display] = self.displayPhononController + display.phononWidget.setVisible(True) + display.webView.setVisible(False) + + else: + self.curDisplayMediaController[display] = self.displayWebkitController + display.phononWidget.setVisible(False) + display.webView.setVisible(True) + + self.curDisplayMediaController[display].load(display, videoPath, volume) + if display.isLive: + Receiver.send_message(u'maindisplay_active') + return + if isBackground or not display.usePhonon: + if videoPath.endswith(u'.swf'): + js = u'show_flash("load","%s");' % \ + (videoPath.replace(u'\\', u'\\\\')) + else: + js = u'show_video("init", "%s", %s, true); show_video("play");' % \ + (videoPath.replace(u'\\', u'\\\\'), str(vol)) + display.frame.evaluateJavaScript(js) + else: + display.phononActive = True + display.mediaObject.stop() + display.mediaObject.clearQueue() + display.mediaObject.setCurrentSource(Phonon.MediaSource(videoPath)) + # Need the timer to trigger set the trigger to 200ms + # Value taken from web documentation. + if display.serviceItem.end_time != 0: + display.mediaObject.setTickInterval(200) + display.mediaObject.play() + display.webView.setVisible(False) + display.phononWidget.setVisible(True) + display.audio.setVolume(vol) + # Update the preview frame. + if display.isLive: + Receiver.send_message(u'maindisplay_active') + + def resetVideo(self): + """ + Used after Video plugin has changed the background + """ + log.debug(u'resetVideo') + if display.phononActive: + display.mediaObject.stop() + display.mediaObject.clearQueue() + display.webView.setVisible(True) + display.phononWidget.setVisible(False) + display.phononActive = False + else: + display.frame.evaluateJavaScript(u'show_video("close");') + display.override = {} + # Update the preview frame. + if display.isLive: + Receiver.send_message(u'maindisplay_active') + + def videoPlay(self, display): + """ + Responds to the request to play a loaded video + """ + log.debug(u'videoPlay') + self.curDisplayMediaController[display].play(display) + # show screen + if display.isLive: + display.setVisible(True) + + def videoPause(self, display): + """ + Responds to the request to pause a loaded video + """ + log.debug(u'videoPause') + if display in self.curDisplayMediaController: + self.curDisplayMediaController[display].pause(display) + return + + def videoStop(self, display): + """ + Responds to the request to stop a loaded video + """ + log.debug(u'videoStop') + print type(display) + if type(display) is types.ListType: + return + print display, self.curDisplayMediaController + if display in self.curDisplayMediaController: + self.curDisplayMediaController[display].stop(display) + if display.isLive: + display.setVisible(False) + + + def videoVolume(self, msg): + """ + Changes the volume of a running video + """ + display = msg[0] + volume = msg[1] + log.debug(u'videoVolume %d' % volume) + vol = float(volume) / float(10) + if display.phononActive: + display.audio.setVolume(vol) + else: + display.frame.evaluateJavaScript(u'show_video(null, null, %s);' % + str(vol)) + + def videoState(self, newState, oldState): + """ + Start the video at a predetermined point. + """ + print "display", self.sender() +# if newState == Phonon.PlayingState \ +# and oldState != Phonon.PausedState \ +# and self.serviceItem.start_time > 0: +# # set start time in milliseconds +# self.mediaObject.seek(self.serviceItem.start_time * 1000) + + def videoFinished(self): + """ + Blank the Video when it has finished so the final frame is not left + hanging + """ + display.videoStop() + display.hideDisplay(HideMode.Blank) + display.phononActive = False + display.videoHide = True + + def videoTick(self, tick): + """ + Triggered on video tick every 200 milli seconds + """ + if tick > display.serviceItem.end_time * 1000: + display.videoFinished() + + def videoSeek(self, msg): + """ + Responds to the request to change the seek Slider of a loaded video + """ + log.debug(u'videoSeek') + display = msg[0] + seekVal = msg[1] + if display in self.curDisplayMediaController: + self.curDisplayMediaController[display].seek(display, seekVal) + + def videoReset(self, display): + """ + Responds to the request to reset a loaded video + """ + log.debug(u'videoReset') + if display in self.curDisplayMediaController: + self.curDisplayMediaController[display].reset(display) diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index 7612ab7c9..f1bd0aea4 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -108,7 +108,9 @@ class MediaMediaItem(MediaManagerItem): filename = unicode(item.data(QtCore.Qt.UserRole).toString()) if os.path.exists(filename): (path, name) = os.path.split(filename) - self.parent.liveController.display.video(filename, 0, True) + #self.parent.liveController.display.video(filename, 0, True) + Receiver.send_message(u'media_video', + [self.parent.liveController.display, filename, 0, True]) self.resetAction.setVisible(True) else: critical_error_message_box(UiStrings.LiveBGError, @@ -129,35 +131,35 @@ class MediaMediaItem(MediaManagerItem): unicode(translate('MediaPlugin.MediaItem', 'The file %s no longer exists.')) % filename) return False - self.mediaObject.stop() - self.mediaObject.clearQueue() - self.mediaObject.setCurrentSource(Phonon.MediaSource(filename)) - if not self.mediaStateWait(Phonon.StoppedState): +# self.mediaObject.stop() +# self.mediaObject.clearQueue() +# self.mediaObject.setCurrentSource(Phonon.MediaSource(filename)) +# if not self.mediaStateWait(Phonon.StoppedState): # Due to string freeze, borrow a message from presentations # This will be corrected in 1.9.6 - critical_error_message_box( - translate('PresentationPlugin.MediaItem', 'Unsupported File'), - unicode(translate('PresentationPlugin.MediaItem', - 'Unsupported File'))) - return False +# critical_error_message_box( +# translate('PresentationPlugin.MediaItem', 'Unsupported File'), +# unicode(translate('PresentationPlugin.MediaItem', +# 'Unsupported File'))) + #return False # File too big for processing if os.path.getsize(filename) <= 52428800: # 50MiB - self.mediaObject.play() - if not self.mediaStateWait(Phonon.PlayingState) \ - or self.mediaObject.currentSource().type() \ - == Phonon.MediaSource.Invalid: - # Due to string freeze, borrow a message from presentations - # This will be corrected in 1.9.6 - self.mediaObject.stop() - critical_error_message_box( - translate('PresentationPlugin.MediaItem', - 'Unsupported File'), - unicode(translate('PresentationPlugin.MediaItem', - 'Unsupported File'))) - return False - self.mediaLength = self.mediaObject.totalTime() / 1000 - self.mediaObject.stop() - service_item.media_length = self.mediaLength +# self.mediaObject.play() +# if not self.mediaStateWait(Phonon.PlayingState) \ +# or self.mediaObject.currentSource().type() \ +# == Phonon.MediaSource.Invalid: +# # Due to string freeze, borrow a message from presentations +# # This will be corrected in 1.9.6 +# self.mediaObject.stop() +# critical_error_message_box( +# translate('PresentationPlugin.MediaItem', +# 'Unsupported File'), +# unicode(translate('PresentationPlugin.MediaItem', +# 'Unsupported File'))) +# #return False +# self.mediaLength = self.mediaObject.totalTime() / 1000 +# self.mediaObject.stop() +# service_item.media_length = self.mediaLength service_item.add_capability( ItemCapabilities.AllowsVariableStartTime) service_item.title = unicode(self.plugin.nameStrings[u'singular']) diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py new file mode 100644 index 000000000..40bbb275a --- /dev/null +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -0,0 +1,81 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 + +############################################################################### +# OpenLP - Open Source Lyrics Projection # +# --------------------------------------------------------------------------- # +# Copyright (c) 2008-2011 Raoul Snyman # +# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # +# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # +# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # +# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # +# --------------------------------------------------------------------------- # +# 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; version 2 of the License. # +# # +# 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., 59 # +# Temple Place, Suite 330, Boston, MA 02111-1307 USA # +############################################################################### + +from PyQt4.phonon import Phonon + +from openlp.plugins.media.lib import MediaController + +class PhononController(MediaController): + """ + """ + def __init__(self, parent): + self.parent = parent + MediaController.__init__(self, parent) + + def load(self, display, path, volume): + display.phononActive = True + display.mediaObject.stop() + display.mediaObject.clearQueue() + display.mediaObject.setCurrentSource(Phonon.MediaSource(path)) + # Need the timer to trigger set the trigger to 200ms + # Value taken from web documentation. + vol = float(volume) / float(10) + if display.serviceItem.end_time != 0: + display.mediaObject.setTickInterval(200) + display.mediaObject.play() + display.audio.setVolume(vol) + self.Timer.setInterval(200) + + + def play(self, display): + display.mediaObject.play() + display.parent.seekSlider.setMaximum(display.mediaObject.totalTime()) + + def pause(self, display): + display.mediaObject.pause() + self.Timer.stop() + + def stop(self, display): + display.mediaObject.stop() + self.Timer.stop() + + def seek(self, display, seekVal): + print "seek" + display.mediaObject.seek(seekVal) + + def reset(self, display): + display.mediaObject.stop() + display.mediaObject.clearQueue() + display.webView.setVisible(True) + display.phononWidget.setVisible(False) + display.phononActive = False + self.Timer.stop() + + def updatePlayer(self): + for controller in self.parent.curDisplayMediaController: + if controller.getState() == 1: + pass diff --git a/openlp/plugins/media/lib/vlc.py b/openlp/plugins/media/lib/vlc.py new file mode 100644 index 000000000..52526e953 --- /dev/null +++ b/openlp/plugins/media/lib/vlc.py @@ -0,0 +1,6106 @@ +#! /usr/bin/python + +# Python ctypes bindings for VLC +# +# Copyright (C) 2009-2010 the VideoLAN team +# $Id: $ +# +# Authors: Olivier Aubert +# Jean Brouwers +# +# 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. + +"""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.advene.org/download/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 +import os +import sys + +# Used by EventManager in override.py +from inspect import getargspec + +__version__ = "N/A" +build_date = "Tue Mar 29 12:44:43 2011" + + # Used on win32 and MacOS in override.py +plugin_path = None + +if sys.platform.startswith('linux'): + try: + dll = ctypes.CDLL('libvlc.so') + except OSError: # may fail + dll = ctypes.CDLL('libvlc.so.5') + +elif sys.platform.startswith('win'): + import ctypes.util as u + p = u.find_library('libvlc.dll') + if p is None: + try: # some registry settings + import _winreg as w # leaner than win32api, win32con + 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 + del r, w + except ImportError: # no PyWin32 + pass + if plugin_path is None: + # try some standard locations. + for p in ('Program Files\\VideoLan\\', 'VideoLan\\', + 'Program Files\\', ''): + p = 'C:\\' + p + 'VLC\\libvlc.dll' + 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('libvlc.dll') + # restore cwd after dll has been loaded + os.chdir(p) + else: # may fail + dll = ctypes.CDLL('libvlc.dll') + else: + plugin_path = os.path.dirname(p) + dll = ctypes.CDLL(p) + del p, u + +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) + d += 'modules' + if os.path.isdir(d): + plugin_path = d + else: # hope, some PATH is set... + dll = ctypes.CDLL('libvlc.dylib') + del d, p + +else: + raise NotImplementedError('%s: %s not supported' % (sys.argv[0], sys.platform)) + +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) + +_Cfunctions = {} # from LibVLC __version__ + +def _Cfunction(name, flags, *types): + """(INTERNAL) New ctypes function binding. + """ + if hasattr(dll, name): + p = ctypes.CFUNCTYPE(*types) + f = p((name, dll), flags) + _Cfunctions[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) New wrapper from ctypes. + """ + if ptr is None: + raise VLCException('(INTERNAL) ctypes class.') + if ptr == 0: + return None + return _Cobject(cls, ctypes.c_void_p(ptr)) + +class _Ctype(object): + """(INTERNAL) Base class for ctypes. + """ + @staticmethod + def from_param(this): # not self + """(INTERNAL) ctypes parameter conversion method. + """ + 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) + + # Generated enum types # + +class _Enum(ctypes.c_ulong): + '''(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 __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 EventType(_Enum): + '''Event types. + ''' + _enum_names_ = { + 0: 'MediaMetaChanged', + 1: 'MediaSubItemAdded', + 2: 'MediaDurationChanged', + 3: 'MediaParsedChanged', + 4: 'MediaFreed', + 5: 'MediaStateChanged', + 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', + 0x200: 'MediaListItemAdded', + 513: 'MediaListWillAddItem', + 514: 'MediaListItemDeleted', + 515: 'MediaListWillDeleteItem', + 0x300: 'MediaListViewItemAdded', + 769: 'MediaListViewWillAddItem', + 770: 'MediaListViewItemDeleted', + 771: 'MediaListViewWillDeleteItem', + 0x400: 'MediaListPlayerPlayed', + 1025: 'MediaListPlayerNextItemSet', + 1026: 'MediaListPlayerStopped', + 0x500: 'MediaDiscovererStarted', + 1281: 'MediaDiscovererEnded', + 0x600: 'VlmMediaAdded', + 1537: 'VlmMediaRemoved', + 1538: 'VlmMediaChanged', + 1539: 'VlmMediaInstanceStarted', + 1540: 'VlmMediaInstanceStopped', + 1541: 'VlmMediaInstanceStatusInit', + 1542: 'VlmMediaInstanceStatusOpening', + 1543: 'VlmMediaInstanceStatusPlaying', + 1544: 'VlmMediaInstanceStatusPause', + 1545: 'VlmMediaInstanceStatusEnd', + 1546: 'VlmMediaInstanceStatusError', + } +EventType.MediaDiscovererEnded = EventType(1281) +EventType.MediaDiscovererStarted = EventType(0x500) +EventType.MediaDurationChanged = EventType(2) +EventType.MediaFreed = EventType(4) +EventType.MediaListItemAdded = EventType(0x200) +EventType.MediaListItemDeleted = EventType(514) +EventType.MediaListPlayerNextItemSet = EventType(1025) +EventType.MediaListPlayerPlayed = EventType(0x400) +EventType.MediaListPlayerStopped = EventType(1026) +EventType.MediaListViewItemAdded = EventType(0x300) +EventType.MediaListViewItemDeleted = EventType(770) +EventType.MediaListViewWillAddItem = EventType(769) +EventType.MediaListViewWillDeleteItem = EventType(771) +EventType.MediaListWillAddItem = EventType(513) +EventType.MediaListWillDeleteItem = EventType(515) +EventType.MediaMetaChanged = EventType(0) +EventType.MediaParsedChanged = EventType(3) +EventType.MediaPlayerBackward = EventType(264) +EventType.MediaPlayerBuffering = EventType(259) +EventType.MediaPlayerEncounteredError = EventType(266) +EventType.MediaPlayerEndReached = EventType(265) +EventType.MediaPlayerForward = EventType(263) +EventType.MediaPlayerLengthChanged = EventType(273) +EventType.MediaPlayerMediaChanged = EventType(0x100) +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.MediaPlayerSeekableChanged = EventType(269) +EventType.MediaPlayerSnapshotTaken = EventType(272) +EventType.MediaPlayerStopped = EventType(262) +EventType.MediaPlayerTimeChanged = EventType(267) +EventType.MediaPlayerTitleChanged = EventType(271) +EventType.MediaStateChanged = EventType(5) +EventType.MediaSubItemAdded = EventType(1) +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', + } +Meta.Album = Meta(4) +Meta.Artist = Meta(1) +Meta.ArtworkURL = Meta(15) +Meta.Copyright = Meta(3) +Meta.Date = Meta(8) +Meta.Description = Meta(6) +Meta.EncodedBy = Meta(14) +Meta.Genre = Meta(2) +Meta.Language = Meta(11) +Meta.NowPlaying = Meta(12) +Meta.Publisher = Meta(13) +Meta.Rating = Meta(7) +Meta.Setting = Meta(9) +Meta.Title = Meta(0) +Meta.TrackID = Meta(16) +Meta.TrackNumber = Meta(5) +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, buffering=2, playing=3, paused=4, +stopping=5, ended=6, error=7. + ''' + _enum_names_ = { + 0: 'NothingSpecial', + 1: 'Opening', + 2: 'Buffering', + 3: 'Playing', + 4: 'Paused', + 5: 'Stopped', + 6: 'Ended', + 7: 'Error', + } +State.Buffering = State(2) +State.Ended = State(6) +State.Error = State(7) +State.NothingSpecial = State(0) +State.Opening = State(1) +State.Paused = State(4) +State.Playing = State(3) +State.Stopped = State(5) + +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 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 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', + } +NavigateMode.activate = NavigateMode(0) +NavigateMode.down = NavigateMode(2) +NavigateMode.left = NavigateMode(3) +NavigateMode.right = NavigateMode(4) +NavigateMode.up = NavigateMode(1) + +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) + + # End of generated enum types # + + # From libvlc_structures.h + +class AudioOutput(ctypes.Structure): + + def __str__(self): + return '%s(%s:%s)' % (self.__class__.__name__, self.name, self.description) + + def __repr__(self): + return '%s.%s' % (self.__class__.__module__, self.__str__()) + +AudioOutput._fields_ = [ # recursive struct + ('name', ctypes.c_char_p), + ('description', ctypes.c_char_p), + ('next', ctypes.POINTER(AudioOutput)), + ] + +class LogMessage(ctypes.Structure): + _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) + + def __repr__(self): + return '%s.%s' % (self.__class__.__module__, self.__str__()) + +class MediaEvent(ctypes.Structure): + _fields_ = [ + ('media_name', ctypes.c_char_p), + ('instance_name', ctypes.c_char_p), + ] + +class MediaStats(ctypes.Structure): + _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), + ] + + def __str__(self): + l = [' %s:\t%s' % (n, getattr(self, n)) for n, t in self._fields_] + return '\n'.join([self.__class__.__name__] + l) + + def __repr__(self): + return '%s.%s' % (self.__class__.__module__, self.__str__()) + +class MediaTrackInfo(ctypes.Structure): + _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 ), + ] + + def __str__(self): + l = [" %s:\t%s" % (n, getattr(self, n)) for n, t in self._fields_] + return "\n".join([self.__class__.__name__] + l) + + def __repr__(self): + return '%s.%s' % (self.__class__.__module__, self.__str__()) + +class PlaylistItem(ctypes.Structure): + _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) + + def __repr__(self): + return '%s.%s' % (self.__class__.__module__, self.__str__()) + +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(ctypes.Structure): + _fields_ = [ + ('top', ctypes.c_int), + ('left', ctypes.c_int), + ('bottom', ctypes.c_int), + ('right', ctypes.c_int), + ] + +class TrackDescription(ctypes.Structure): + + def __str__(self): + return '%s(%d:%s)' % (self.__class__.__name__, self.id, self.name) + + def __repr__(self): + return '%s.%s' % (self.__class__.__module__, self.__str__()) + +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 + libvlc_track_description_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 ), + # Media instance + ('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), + # FIXME: Skipped MediaList and MediaListView... + ('filename', ctypes.c_char_p ), + ('new_length', ctypes.c_longlong), + ('media_event', MediaEvent ), + ] + +class Event(ctypes.Structure): + _fields_ = [ + ('type', EventType ), + ('object', ctypes.c_void_p), + ('u', EventUnion ), + ] + +class ModuleDescription(ctypes.Structure): + 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 + + # 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=None): + if ptr is None: + raise VLCException("(INTERNAL) ctypes class.") + if ptr == 0: + return None + return _Cobject(cls, ptr) # ctypes.c_void_p(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, eventtype, 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 args: + i = args[0] + if i == 0: + return None + if isinstance(i, _Ints): + return _Cobject(cls, ctypes.c_void_p(i)) + if len(args) == 1: + if isinstance(i, basestring): + args = i.strip().split() + elif isinstance(i, _Seqs): + args = i + else: + raise VLCException('Instance %r' % (args,)) + + if not args and plugin_path is not None: + # no parameters passed, for win32 and MacOS, + # specify the plugin_path if detected earlier + args = ['vlc', '--plugin-path=' + plugin_path] + 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. + + Options can be specified as supplementary string parameters, e.g. + + C{m = i.media_new('foo.avi', 'sub-filter=marq{marquee=Hello}', 'vout-filter=invert')} + + Alternatively, the options can be added to the media using the Media.add_options method: + + C{m.add_options('foo.avi', 'sub-filter=marq@test{marquee=Hello}', 'video-filter=invert')} + + @param options: optional media option=value strings + """ + m = libvlc_media_new_location(self, mrl) + for o in options: + libvlc_media_add_option(m, o) + return m + + 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 module_description_list_get(self, capability ): + """Returns a list of modules matching a capability. + + """ + return module_description_list(libvlc_module_description_list_get(self, capability)) + + def audio_filter_list_get(self): + """Returns a list of audio filters that are available. + + """ + return module_description_list(libvlc_audio_filter_list_get(self)) + + def video_filter_list_get(self): + """Returns a list of video filters that are available. + + """ + 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 NULL for default. + @return: 0 on success, -1 on error. + ''' + return libvlc_add_intf(self, 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 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, name, http) + + def get_log_verbosity(self): + '''Return the VLC messaging verbosity level. + @return: verbosity level for messages. + ''' + return libvlc_get_log_verbosity(self) + + def set_log_verbosity(self, level): + '''Set the VLC messaging verbosity level. + @param level: log level. + ''' + return libvlc_set_log_verbosity(self, level) + + def log_open(self): + '''Open a VLC message log instance. + @return: log message instance or NULL on error. + ''' + return libvlc_log_open(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 NULL on error. + ''' + return libvlc_media_new_location(self, 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 NULL on error. + ''' + return libvlc_media_new_path(self, 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 NULL on error. + @version: LibVLC 1.1.5 and later. + ''' + return libvlc_media_new_fd(self, fd) + + 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 NULL on error. + ''' + return libvlc_media_new_as_node(self, psz_name) + + def media_discoverer_new_from_name(self, psz_name): + '''Discover media service by name. + @param psz_name: service name. + @return: media discover object or NULL in case of error. + ''' + return libvlc_media_discoverer_new_from_name(self, psz_name) + + def media_library_new(self): + '''Create an new Media Library object. + @return: a new object or NULL on error. + ''' + return libvlc_media_library_new(self) + + def media_list_new(self): + '''Create an empty media list. + @return: empty media list, or NULL on error. + ''' + return libvlc_media_list_new(self) + + def audio_output_list_get(self): + '''Get the list of available audio outputs. + @return: list of available audio outputs. It must be freed it with In case of error, NULL is returned. + ''' + return libvlc_audio_output_list_get(self) + + def audio_output_device_count(self, psz_audio_output): + '''Get count of devices for audio output, these devices are hardware oriented + like analor or digital output of sound card. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @return: number of devices. + ''' + return libvlc_audio_output_device_count(self, psz_audio_output) + + def audio_output_device_longname(self, psz_audio_output, i_device): + '''Get long name of device, if not available short name given. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @param i_device: device index. + @return: long name of device. + ''' + return libvlc_audio_output_device_longname(self, psz_audio_output, i_device) + + def audio_output_device_id(self, psz_audio_output, i_device): + '''Get id name of device. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @param i_device: device index. + @return: id name of device, use for setting device, need to be free after use. + ''' + return libvlc_audio_output_device_id(self, psz_audio_output, i_device) + + 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, psz_name, psz_input, 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, psz_name, psz_input, i_options, ppsz_options, b_enabled, 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, 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, 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, psz_name, 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, psz_name, 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, psz_name, 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, 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, psz_name, 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, psz_name, psz_input, 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, 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, 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, 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, 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 NULL on error. + ''' + return libvlc_vlm_show_media(self, 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, 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, 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, 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, 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, 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, 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, psz_name, i_instance) + + 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) + +class Log(_Ctype): + '''Create a new VLC log instance. + + ''' + + def __new__(cls, ptr=None): + '''(INTERNAL) ctypes wrapper constructor. + ''' + return _Constructor(cls, ptr) + + def __iter__(self): + return self.get_iterator() + + def dump(self): + return [ str(m) for m in self ] + + + def close(self): + '''Close a VLC message log instance. + ''' + return libvlc_log_close(self) + + def count(self): + '''Returns the number of messages in a log instance. + @return: number of log messages, 0 if p_log is NULL. + ''' + return libvlc_log_count(self) + + def __len__(self): + return libvlc_log_count(self) + + def clear(self): + '''Clear a log instance. + All messages in the log are removed. The log should be cleared on a + regular basis to avoid clogging. + ''' + return libvlc_log_clear(self) + + def get_iterator(self): + '''Allocate and returns a new iterator to messages in log. + @return: log iterator object or NULL on error. + ''' + return libvlc_log_get_iterator(self) + +class LogIterator(_Ctype): + '''Create a new VLC log iterator. + + ''' + + def __new__(cls, ptr=None): + '''(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 free(self): + '''Release a previoulsy allocated iterator. + ''' + return libvlc_log_iterator_free(self) + + def has_next(self): + '''Return whether log iterator has more messages. + @return: true if iterator has more message objects, else false. + ''' + return libvlc_log_iterator_has_next(self) + +class Media(_Ctype): + '''Create a new Media instance. + + ''' + + def __new__(cls, ptr=None): + '''(INTERNAL) ctypes wrapper constructor. + ''' + return _Constructor(cls, ptr) + + + def add_options(self, *options): + """Add a list of options to the media. + + Options must be written without the double-dash, e.g.: + + C{m.add_options('sub-filter=marq@test{marquee=Hello}', 'video-filter=invert')} + + Alternatively, the options can directly be passed in the Instance.media_new method: + + C{m = instance.media_new('foo.avi', 'sub-filter=marq@test{marquee=Hello}', 'video-filter=invert')} + + @param options: optional media option=value strings + """ + for o in options: + self.add_option(o) + + + def add_option(self, ppsz_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. + The options are detailed in vlc --long-help, for instance "--sout-all". + @param ppsz_options: the options (as a string). + ''' + return libvlc_media_add_option(self, ppsz_options) + + def add_option_flag(self, ppsz_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". + @param ppsz_options: the options (as a string). + @param i_flags: the flags for this option. + ''' + return libvlc_media_add_option_flag(self, ppsz_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 NULL. + This methods automatically calls L{parse_async}(), so after calling + it you may receive a libvlc_MediaMetaChanged event. If you prefer a synchronous + version ensure that you call L{parse}() before get_meta(). + See L{parse} + See L{parse_async} + See libvlc_MediaMetaChanged. + @param e_meta: the meta to read. + @return: the media's meta. + ''' + return libvlc_media_get_meta(self, e_meta) + + 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, psz_value) + + def save_meta(self): + '''Save the meta previously set. + @return: true if the write operation was successfull. + ''' + return libvlc_media_save_meta(self) + + def get_state(self): + '''Get current state of media descriptor object. Possible media states + are defined in libvlc_structures.c ( libvlc_NothingSpecial=0, + libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused, + libvlc_Stopped, libvlc_Ended, + libvlc_Error). + See libvlc_state_t. + @return: state of media descriptor object. + ''' + return libvlc_media_get_state(self) + + 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. + ''' + return libvlc_media_get_stats(self, p_stats) + + 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(self): + '''Parse a media. + This fetches (local) meta data and tracks information. + The method is synchronous. + See L{parse_async} + See L{get_meta} + See L{get_tracks_info}. + ''' + return libvlc_media_parse(self) + + def parse_async(self): + '''Parse a media. + This fetches (local) meta data and tracks information. + The method is the asynchronous of L{parse}(). + To track when this is over you can listen to libvlc_MediaParsedChanged + event. However if the media was already parsed you will not receive this + event. + See L{parse} + See libvlc_MediaParsedChanged + See L{get_meta} + See L{get_tracks_info}. + ''' + return libvlc_media_parse_async(self) + + def is_parsed(self): + '''Get Parsed status for media descriptor object. + See libvlc_MediaParsedChanged. + @return: true if media object has been parsed otherwise it returns false. + ''' + return libvlc_media_is_parsed(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_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. + @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 NULL on error. + ''' + return libvlc_media_player_new_from_media(self) + +class MediaDiscoverer(_Ctype): + '''N/A + ''' + + def __new__(cls, ptr=None): + '''(INTERNAL) ctypes wrapper constructor. + ''' + return _Constructor(cls, ptr) + 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 localized_name(self): + '''Get media service discover object its localized name. + @return: localized name. + ''' + return libvlc_media_discoverer_localized_name(self) + + def media_list(self): + '''Get media service discover media list. + @return: list of media items. + ''' + return libvlc_media_discoverer_media_list(self) + + def event_manager(self): + '''Get event manager from media service discover object. + @return: event manager object. + ''' + return libvlc_media_discoverer_event_manager(self) + + def is_running(self): + '''Query if media service discover object is running. + @return: true if running, false if not. + ''' + return libvlc_media_discoverer_is_running(self) + +class MediaLibrary(_Ctype): + '''N/A + ''' + + def __new__(cls, ptr=None): + '''(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): + '''N/A + ''' + + def __new__(cls, ptr=None): + '''(INTERNAL) ctypes wrapper constructor. + ''' + return _Constructor(cls, ptr) + 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 add_media(self, p_md): + '''Add media instance to media list + The L{lock} should be held upon entering this function. + @param p_md: a media instance. + @return: 0 on success, -1 if the media list is read-only. + ''' + return libvlc_media_list_add_media(self, p_md) + + 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 si 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 NULL 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 list instance. + @return: position of media instance. + ''' + 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: 0 on readonly, 1 on readwrite. + ''' + 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) + + 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, *args): + if len(args) == 1: + i = args[0] + if i == 0: + return None + if isinstance(i, _Ints): + return _Cobject(cls, ctypes.c_void_p(i)) + if isinstance(i, _Seqs): + args = i + + if args and isinstance(args[0], Instance): + i = args[0] + else: + i = Instance() + return i.media_list_player_new() + + def get_instance(self): + """Return the associated Instance. + """ + return self._instance #PYCHOK expected + + + def release(self): + '''Release media_list_player. + ''' + return libvlc_media_list_player_release(self) + + 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 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): + '''Pause media list. + ''' + return libvlc_media_list_player_pause(self) + + def is_playing(self): + '''Is media list playing? + @return: true for playing and false for not playing. + ''' + 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). In this case, a vlc.Instance will be created. + - a vlc.Instance + + ''' + + def __new__(cls, *args): + if args: + i = args[0] + if i == 0: + return None + if isinstance(i, _Ints): + return _Cobject(cls, ctypes.c_void_p(i)) + if isinstance(i, Instance): + return i.media_player_new() + + i = Instance() + o = i.media_player_new() + if args: + o.set_media(i.media_new(*args)) # args[0] + 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. + + @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 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 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 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 NULL if no media is associated. + ''' + return libvlc_media_player_get_media(self) + + 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. + ''' + 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 video_set_format(self, chroma, width, height, pitch): + '''Set decoded video chroma and dimensions. + This only works in combination with libvlc_video_set_callbacks(), + and is mutually exclusive with libvlc_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 libvlc_video_set_format_callbacks() instead. + ''' + return libvlc_video_set_format(self, chroma, width, height, pitch) + + def set_nsobject(self, drawable): + '''Set the NSView handler where the media player should render its video output. + Use the vout called "macosx". + The drawable is an NSObject that follow the VLCOpenGLVideoViewEmbedding + protocol: + @begincode + \@protocol VLCOpenGLVideoViewEmbedding + - (void)addVoutSubview:(NSView *)view; + - (void)removeVoutSubview:(NSView *)view; + \@end + @endcode + Or it can be an NSView object. + If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then + the following code should work: + @begincode + + NSView *video = [[NSView alloc] init]; + QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); + L{set_nsobject}(mp, video); + [video release]; + + @endcode + You can find a live example in VLCVideoView in VLCKit.framework. + @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol. + ''' + return libvlc_media_player_set_nsobject(self, drawable) + + 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_agl(self, drawable): + '''Set the agl handler where the media player should render its video output. + @param drawable: the agl handler. + ''' + return libvlc_media_player_set_agl(self, drawable) + + def get_agl(self): + '''Get the agl handler previously set with L{set_agl}(). + @return: the agl handler or 0 if none where set. + ''' + return libvlc_media_player_get_agl(self) + + def set_xwindow(self, drawable): + '''Set an X Window System drawable where the media player should render its + video output. If LibVLC was built without X11 output support, then this has + no effects. + The specified identifier must correspond to an existing Input/Output class + X11 window. Pixmaps are B{not} supported. The caller shall ensure that + the X11 server is the same as the one the VLC instance has been configured + with. This function must be called before video playback is started; + otherwise it will only take effect after playback stop and restart. + @param drawable: the ID of the X window. + ''' + return libvlc_media_player_set_xwindow(self, drawable) + + 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 set_hwnd(self, drawable): + '''Set a Win32/Win64 API window handle (HWND) where the media player should + render its video output. If LibVLC was built without Win32/Win64 API output + support, then this has no effects. + @param drawable: windows handle of the drawable. + ''' + return libvlc_media_player_set_hwnd(self, drawable) + + 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 NULL if there are none. + ''' + return libvlc_media_player_get_hwnd(self) + + 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. + @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. 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. + ''' + 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 get_fps(self): + '''Get movie fps rate. + @return: frames per second (fps) for this playing movie, or 0 if unspecified. + ''' + return libvlc_media_player_get_fps(self) + + 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. + ''' + 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. + ''' + return libvlc_media_player_can_pause(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 1.2.0 or later. + ''' + return libvlc_media_player_navigate(self, navigate) + + 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). + ''' + 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". + @note: See also 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 NULL 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 NULL to reset to default @note Invalid aspect ratios are ignored. + ''' + return libvlc_video_set_aspect_ratio(self, psz_aspect) + + 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: new video subtitle to select. + @return: 0 on success, -1 if out of range. + ''' + return libvlc_video_set_spu(self, i_spu) + + def video_set_subtitle_file(self, psz_subtitle): + '''Set new video subtitle file. + @param psz_subtitle: new video subtitle file. + @return: the success status (boolean). + ''' + return libvlc_video_set_subtitle_file(self, psz_subtitle) + + def video_get_crop_geometry(self): + '''Get current crop filter geometry. + @return: the crop filter geometry or NULL 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 (NULL to unset). + ''' + return libvlc_video_set_crop_geometry(self, psz_geometry) + + def video_get_teletext(self): + '''Get current teletext page requested. + @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. + @param i_page: teletex page number requested. + ''' + return libvlc_video_set_teletext(self, i_page) + + def toggle_teletext(self): + '''Toggle teletext transparent status on video output. + ''' + return libvlc_toggle_teletext(self) + + 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 (int) or -1 if none. + ''' + return libvlc_video_get_track(self) + + def video_set_track(self, i_track): + '''Set video track. + @param i_track: the track (int). + @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 where to save the screenshot to. + @param i_width: the snapshot's width. + @param i_height: the snapshot's height. + @return: 0 on success, -1 if the video was not found. + ''' + return libvlc_video_take_snapshot(self, num, 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, NULL to disable. + ''' + return libvlc_video_set_deinterlace(self, 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, 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, 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): + '''Set the audio output. + Change will be applied after stop and play. + @param psz_name: name of audio output, use psz_name of See L{AudioOutput}. + @return: true if function succeded. + ''' + return libvlc_audio_output_set(self, psz_name) + + def audio_output_device_set(self, psz_audio_output, psz_device_id): + '''Set audio output device. Changes are only effective after stop and play. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @param psz_device_id: device. + ''' + return libvlc_audio_output_device_set(self, psz_audio_output, psz_device_id) + + def audio_output_get_device_type(self): + '''Get current audio device type. Device type describes something like + character of output sound - stereo sound, 2.1, 5.1 etc. + @return: the audio devices type See libvlc_audio_output_device_types_t. + ''' + return libvlc_audio_output_get_device_type(self) + + def audio_output_set_device_type(self, device_type): + '''Set current audio device type. + @param device_type: the audio device type, + ''' + return libvlc_audio_output_set_device_type(self, device_type) + + 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). + ''' + 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. + ''' + return libvlc_audio_set_mute(self, status) + + def audio_get_volume(self): + '''Get current audio level. + @return: the audio level (int). + ''' + return libvlc_audio_get_volume(self) + + def audio_set_volume(self, i_volume): + '''Set current audio level. + @param i_volume: the volume (int). + @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 (int), or -1 if none. + ''' + return libvlc_audio_get_track(self) + + def audio_set_track(self, i_track): + '''Set current audio track. + @param i_track: the track (int). + @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) + + + # LibVLC __version__ functions # + +def libvlc_errmsg(): + '''A human-readable error message for the last LibVLC error in the calling + thread. The resulting string is valid until another error occurs (at least + until the next LibVLC call). + @warning + This will be NULL if there was no error. + ''' + f = _Cfunctions.get('libvlc_errmsg', None) or \ + _Cfunction('libvlc_errmsg', (), + ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_errmsg + libvlc_errmsg = f + return f() + +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) + if not __debug__: # i.e. python -O or -OO + global libvlc_clearerr + libvlc_clearerr = f + return f() + +def libvlc_new(argc, argv): + '''Create and initialize a libvlc instance. + This functions accept a list of "command line" arguments similar to the + main(). These arguments affect the LibVLC instance default configuration. + @param argc: the number of arguments (should be 0). + @param argv: list of arguments (should be NULL). + @return: the libvlc instance or NULL 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 NULL). 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,),), + Instance, ctypes.c_int, ListPOINTER(ctypes.c_char_p)) + if not __debug__: # i.e. python -O or -OO + global libvlc_new + libvlc_new = f + return f(argc, argv) + +def libvlc_new_with_builtins(argc, argv, builtins): + '''Create and initialize a libvlc instance. + @param argc: the number of arguments. + @param argv: command-line-type arguments. + @param builtins: a NULL terminated array of See vlc_plugin. + @return: the libvlc instance or NULL in case of error @begincode vlc_declare_plugin(mp4); vlc_declare_plugin(dummy); const void **builtins = vlc_plugin(mp4), vlc_plugin(dummy), NULL ; L{Instance} *vlc = L{libvlc_new_with_builtins}(argc, argv, builtins); @endcode. + ''' + f = _Cfunctions.get('libvlc_new_with_builtins', None) or \ + _Cfunction('libvlc_new_with_builtins', ((1,), (1,), (1,),), + Instance, ctypes.c_int, ListPOINTER(ctypes.c_char_p), ListPOINTER(ctypes.c_void_p)) + if not __debug__: # i.e. python -O or -OO + global libvlc_new_with_builtins + libvlc_new_with_builtins = f + return f(argc, argv, builtins) + +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, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_release + libvlc_release = f + 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, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_retain + libvlc_retain = f + 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 NULL for default. + @return: 0 on success, -1 on error. + ''' + f = _Cfunctions.get('libvlc_add_intf', None) or \ + _Cfunction('libvlc_add_intf', ((1,), (1,),), + ctypes.c_int, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_add_intf + libvlc_add_intf = f + return f(p_instance, name) + +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. + ''' + f = _Cfunctions.get('libvlc_wait', None) or \ + _Cfunction('libvlc_wait', ((1,),), + None, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_wait + libvlc_wait = f + return f(p_instance) + +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, Instance, ctypes.c_char_p, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_set_user_agent + libvlc_set_user_agent = f + return f(p_instance, name, http) + +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', (), + ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_get_version + libvlc_get_version = f + 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', (), + ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_get_compiler + libvlc_get_compiler = f + 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', (), + ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_get_changeset + libvlc_get_changeset = f + 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, ctypes.c_void_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_free + libvlc_free = f + 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,),), + ctypes.c_int, EventManager, ctypes.c_uint, ctypes.c_void_p, ctypes.c_void_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_event_attach + libvlc_event_attach = f + 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, EventManager, ctypes.c_uint, ctypes.c_void_p, ctypes.c_void_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_event_detach + libvlc_event_detach = f + 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,),), + ctypes.c_char_p, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_event_type_name + libvlc_event_type_name = f + return f(event_type) + +def libvlc_get_log_verbosity(p_instance): + '''Return the VLC messaging verbosity level. + @param p_instance: libvlc instance. + @return: verbosity level for messages. + ''' + f = _Cfunctions.get('libvlc_get_log_verbosity', None) or \ + _Cfunction('libvlc_get_log_verbosity', ((1,),), + ctypes.c_uint, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_get_log_verbosity + libvlc_get_log_verbosity = f + return f(p_instance) + +def libvlc_set_log_verbosity(p_instance, level): + '''Set the VLC messaging verbosity level. + @param p_instance: libvlc log instance. + @param level: log level. + ''' + f = _Cfunctions.get('libvlc_set_log_verbosity', None) or \ + _Cfunction('libvlc_set_log_verbosity', ((1,), (1,),), + None, Instance, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_set_log_verbosity + libvlc_set_log_verbosity = f + return f(p_instance, level) + +def libvlc_log_open(p_instance): + '''Open a VLC message log instance. + @param p_instance: libvlc instance. + @return: log message instance or NULL on error. + ''' + f = _Cfunctions.get('libvlc_log_open', None) or \ + _Cfunction('libvlc_log_open', ((1,),), + Log, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_open + libvlc_log_open = f + return f(p_instance) + +def libvlc_log_close(p_log): + '''Close a VLC message log instance. + @param p_log: libvlc log instance or NULL. + ''' + f = _Cfunctions.get('libvlc_log_close', None) or \ + _Cfunction('libvlc_log_close', ((1,),), + None, Log) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_close + libvlc_log_close = f + return f(p_log) + +def libvlc_log_count(p_log): + '''Returns the number of messages in a log instance. + @param p_log: libvlc log instance or NULL. + @return: number of log messages, 0 if p_log is NULL. + ''' + f = _Cfunctions.get('libvlc_log_count', None) or \ + _Cfunction('libvlc_log_count', ((1,),), + ctypes.c_uint, Log) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_count + libvlc_log_count = f + return f(p_log) + +def libvlc_log_clear(p_log): + '''Clear a log instance. + All messages in the log are removed. The log should be cleared on a + regular basis to avoid clogging. + @param p_log: libvlc log instance or NULL. + ''' + f = _Cfunctions.get('libvlc_log_clear', None) or \ + _Cfunction('libvlc_log_clear', ((1,),), + None, Log) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_clear + libvlc_log_clear = f + return f(p_log) + +def libvlc_log_get_iterator(p_log): + '''Allocate and returns a new iterator to messages in log. + @param p_log: libvlc log instance. + @return: log iterator object or NULL on error. + ''' + f = _Cfunctions.get('libvlc_log_get_iterator', None) or \ + _Cfunction('libvlc_log_get_iterator', ((1,),), + LogIterator, Log) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_get_iterator + libvlc_log_get_iterator = f + return f(p_log) + +def libvlc_log_iterator_free(p_iter): + '''Release a previoulsy allocated iterator. + @param p_iter: libvlc log iterator or NULL. + ''' + f = _Cfunctions.get('libvlc_log_iterator_free', None) or \ + _Cfunction('libvlc_log_iterator_free', ((1,),), + None, LogIterator) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_iterator_free + libvlc_log_iterator_free = f + return f(p_iter) + +def libvlc_log_iterator_has_next(p_iter): + '''Return whether log iterator has more messages. + @param p_iter: libvlc log iterator or NULL. + @return: true if iterator has more message objects, else false. + ''' + f = _Cfunctions.get('libvlc_log_iterator_has_next', None) or \ + _Cfunction('libvlc_log_iterator_has_next', ((1,),), + ctypes.c_int, LogIterator) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_iterator_has_next + libvlc_log_iterator_has_next = f + return f(p_iter) + +def libvlc_log_iterator_next(p_iter, p_buffer): + '''Return the next log message. + The message contents must not be freed. + @param p_iter: libvlc log iterator or NULL. + @param p_buffer: log buffer. + @return: log message object or NULL if none left. + ''' + f = _Cfunctions.get('libvlc_log_iterator_next', None) or \ + _Cfunction('libvlc_log_iterator_next', ((1,), (1,),), + ctypes.POINTER(LogMessage), LogIterator, ctypes.POINTER(LogMessage)) + if not __debug__: # i.e. python -O or -OO + global libvlc_log_iterator_next + libvlc_log_iterator_next = f + return f(p_iter, p_buffer) + +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, ctypes.POINTER(ModuleDescription)) + if not __debug__: # i.e. python -O or -OO + global libvlc_module_description_list_release + libvlc_module_description_list_release = f + 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, NULL 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,),), + ctypes.POINTER(ModuleDescription), Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_filter_list_get + libvlc_audio_filter_list_get = f + 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, NULL 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,),), + ctypes.POINTER(ModuleDescription), Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_filter_list_get + libvlc_video_filter_list_get = f + 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 NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_new_location', None) or \ + _Cfunction('libvlc_media_new_location', ((1,), (1,),), + Media, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_new_location + libvlc_media_new_location = f + 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 NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_new_path', None) or \ + _Cfunction('libvlc_media_new_path', ((1,), (1,),), + Media, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_new_path + libvlc_media_new_path = f + 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 NULL 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,),), + Media, Instance, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_new_fd + libvlc_media_new_fd = f + return f(p_instance, fd) + +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 NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_new_as_node', None) or \ + _Cfunction('libvlc_media_new_as_node', ((1,), (1,),), + Media, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_new_as_node + libvlc_media_new_as_node = f + return f(p_instance, psz_name) + +def libvlc_media_add_option(p_md, ppsz_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. + The options are detailed in vlc --long-help, for instance "--sout-all". + @param p_md: the media descriptor. + @param ppsz_options: the options (as a string). + ''' + f = _Cfunctions.get('libvlc_media_add_option', None) or \ + _Cfunction('libvlc_media_add_option', ((1,), (1,),), + None, Media, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_add_option + libvlc_media_add_option = f + return f(p_md, ppsz_options) + +def libvlc_media_add_option_flag(p_md, ppsz_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". + @param p_md: the media descriptor. + @param ppsz_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, Media, ctypes.c_char_p, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_add_option_flag + libvlc_media_add_option_flag = f + return f(p_md, ppsz_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, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_retain + libvlc_media_retain = f + 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, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_release + libvlc_media_release = f + 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,),), + ctypes.c_char_p, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_mrl + libvlc_media_get_mrl = f + 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,),), + Media, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_duplicate + libvlc_media_duplicate = f + 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 NULL. + This methods automatically calls L{libvlc_media_parse_async}(), so after calling + it you may receive a libvlc_MediaMetaChanged event. If you prefer a synchronous + version ensure that you call L{libvlc_media_parse}() before get_meta(). + See L{libvlc_media_parse} + See L{libvlc_media_parse_async} + See libvlc_MediaMetaChanged. + @param p_md: the media descriptor. + @param e_meta: the meta to read. + @return: the media's meta. + ''' + f = _Cfunctions.get('libvlc_media_get_meta', None) or \ + _Cfunction('libvlc_media_get_meta', ((1,), (1,),), + ctypes.c_char_p, Media, Meta) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_meta + libvlc_media_get_meta = f + 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, Media, Meta, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_set_meta + libvlc_media_set_meta = f + 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 successfull. + ''' + f = _Cfunctions.get('libvlc_media_save_meta', None) or \ + _Cfunction('libvlc_media_save_meta', ((1,),), + ctypes.c_int, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_save_meta + libvlc_media_save_meta = f + return f(p_md) + +def libvlc_media_get_state(p_md): + '''Get current state of media descriptor object. Possible media states + are defined in libvlc_structures.c ( libvlc_NothingSpecial=0, + libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused, + libvlc_Stopped, libvlc_Ended, + libvlc_Error). + See libvlc_state_t. + @param p_md: a media descriptor object. + @return: state of media descriptor object. + ''' + f = _Cfunctions.get('libvlc_media_get_state', None) or \ + _Cfunction('libvlc_media_get_state', ((1,),), + State, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_state + libvlc_media_get_state = f + 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. + ''' + f = _Cfunctions.get('libvlc_media_get_stats', None) or \ + _Cfunction('libvlc_media_get_stats', ((1,), (1,),), + ctypes.c_int, Media, ctypes.POINTER(MediaStats)) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_stats + libvlc_media_get_stats = f + return f(p_md, p_stats) + +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,),), + EventManager, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_event_manager + libvlc_media_event_manager = f + 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,),), + ctypes.c_longlong, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_duration + libvlc_media_get_duration = f + return f(p_md) + +def libvlc_media_parse(p_md): + '''Parse a media. + This fetches (local) meta data and tracks information. + The method is synchronous. + See L{libvlc_media_parse_async} + See L{libvlc_media_get_meta} + See L{libvlc_media_get_tracks_info}. + @param p_md: media descriptor object. + ''' + f = _Cfunctions.get('libvlc_media_parse', None) or \ + _Cfunction('libvlc_media_parse', ((1,),), + None, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_parse + libvlc_media_parse = f + return f(p_md) + +def libvlc_media_parse_async(p_md): + '''Parse a media. + This fetches (local) meta data and tracks information. + The method is the asynchronous of L{libvlc_media_parse}(). + To track when this is over you can listen to libvlc_MediaParsedChanged + event. However if the media was already parsed you will not receive this + event. + See L{libvlc_media_parse} + See libvlc_MediaParsedChanged + See L{libvlc_media_get_meta} + See L{libvlc_media_get_tracks_info}. + @param p_md: media descriptor object. + ''' + f = _Cfunctions.get('libvlc_media_parse_async', None) or \ + _Cfunction('libvlc_media_parse_async', ((1,),), + None, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_parse_async + libvlc_media_parse_async = f + return f(p_md) + +def libvlc_media_is_parsed(p_md): + '''Get Parsed status for media descriptor object. + See libvlc_MediaParsedChanged. + @param p_md: media descriptor object. + @return: true if media object has been parsed otherwise it returns false. + ''' + f = _Cfunctions.get('libvlc_media_is_parsed', None) or \ + _Cfunction('libvlc_media_is_parsed', ((1,),), + ctypes.c_int, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_is_parsed + libvlc_media_is_parsed = f + 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, Media, ctypes.c_void_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_set_user_data + libvlc_media_set_user_data = f + 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,),), + ctypes.c_void_p, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_user_data + libvlc_media_get_user_data = f + 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. + @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,),), + ctypes.c_int, Media, ctypes.POINTER(ctypes.c_void_p)) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_get_tracks_info + libvlc_media_get_tracks_info = f + return f(p_md) + +def libvlc_media_discoverer_new_from_name(p_inst, psz_name): + '''Discover media service by name. + @param p_inst: libvlc instance. + @param psz_name: service name. + @return: media discover object or NULL in case of error. + ''' + f = _Cfunctions.get('libvlc_media_discoverer_new_from_name', None) or \ + _Cfunction('libvlc_media_discoverer_new_from_name', ((1,), (1,),), + MediaDiscoverer, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_discoverer_new_from_name + libvlc_media_discoverer_new_from_name = f + return f(p_inst, psz_name) + +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, MediaDiscoverer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_discoverer_release + libvlc_media_discoverer_release = f + return f(p_mdis) + +def libvlc_media_discoverer_localized_name(p_mdis): + '''Get media service discover object its localized name. + @param p_mdis: media discover object. + @return: localized name. + ''' + f = _Cfunctions.get('libvlc_media_discoverer_localized_name', None) or \ + _Cfunction('libvlc_media_discoverer_localized_name', ((1,),), + ctypes.c_char_p, MediaDiscoverer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_discoverer_localized_name + libvlc_media_discoverer_localized_name = f + 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,),), + MediaList, MediaDiscoverer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_discoverer_media_list + libvlc_media_discoverer_media_list = f + return f(p_mdis) + +def libvlc_media_discoverer_event_manager(p_mdis): + '''Get event manager from media service discover object. + @param p_mdis: media service discover object. + @return: event manager object. + ''' + f = _Cfunctions.get('libvlc_media_discoverer_event_manager', None) or \ + _Cfunction('libvlc_media_discoverer_event_manager', ((1,),), + EventManager, MediaDiscoverer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_discoverer_event_manager + libvlc_media_discoverer_event_manager = f + 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. + ''' + f = _Cfunctions.get('libvlc_media_discoverer_is_running', None) or \ + _Cfunction('libvlc_media_discoverer_is_running', ((1,),), + ctypes.c_int, MediaDiscoverer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_discoverer_is_running + libvlc_media_discoverer_is_running = f + return f(p_mdis) + +def libvlc_media_library_new(p_instance): + '''Create an new Media Library object. + @param p_instance: the libvlc instance. + @return: a new object or NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_library_new', None) or \ + _Cfunction('libvlc_media_library_new', ((1,),), + MediaLibrary, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_library_new + libvlc_media_library_new = f + 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, MediaLibrary) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_library_release + libvlc_media_library_release = f + 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, MediaLibrary) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_library_retain + libvlc_media_library_retain = f + 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,),), + ctypes.c_int, MediaLibrary) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_library_load + libvlc_media_library_load = f + 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,),), + MediaList, MediaLibrary) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_library_media_list + libvlc_media_library_media_list = f + return f(p_mlib) + +def libvlc_media_list_new(p_instance): + '''Create an empty media list. + @param p_instance: libvlc instance. + @return: empty media list, or NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_list_new', None) or \ + _Cfunction('libvlc_media_list_new', ((1,),), + MediaList, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_new + libvlc_media_list_new = f + 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, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_release + libvlc_media_list_release = f + 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, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_retain + libvlc_media_list_retain = f + 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, MediaList, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_set_media + libvlc_media_list_set_media = f + 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,),), + Media, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_media + libvlc_media_list_media = f + 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,),), + ctypes.c_int, MediaList, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_add_media + libvlc_media_list_add_media = f + 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 si read-only. + ''' + f = _Cfunctions.get('libvlc_media_list_insert_media', None) or \ + _Cfunction('libvlc_media_list_insert_media', ((1,), (1,), (1,),), + ctypes.c_int, MediaList, Media, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_insert_media + libvlc_media_list_insert_media = f + 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,),), + ctypes.c_int, MediaList, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_remove_index + libvlc_media_list_remove_index = f + 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,),), + ctypes.c_int, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_count + libvlc_media_list_count = f + 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 NULL 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,),), + Media, MediaList, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_item_at_index + libvlc_media_list_item_at_index = f + 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 list instance. + @return: position of media instance. + ''' + f = _Cfunctions.get('libvlc_media_list_index_of_item', None) or \ + _Cfunction('libvlc_media_list_index_of_item', ((1,), (1,),), + ctypes.c_int, MediaList, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_index_of_item + libvlc_media_list_index_of_item = f + 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: 0 on readonly, 1 on readwrite. + ''' + f = _Cfunctions.get('libvlc_media_list_is_readonly', None) or \ + _Cfunction('libvlc_media_list_is_readonly', ((1,),), + ctypes.c_int, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_is_readonly + libvlc_media_list_is_readonly = f + 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, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_lock + libvlc_media_list_lock = f + 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, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_unlock + libvlc_media_list_unlock = f + 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,),), + EventManager, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_event_manager + libvlc_media_list_event_manager = f + return f(p_ml) + +def libvlc_media_list_player_new(p_instance): + '''Create new media_list_player. + @param p_instance: libvlc instance. + @return: media list player instance or NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_list_player_new', None) or \ + _Cfunction('libvlc_media_list_player_new', ((1,),), + MediaListPlayer, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_new + libvlc_media_list_player_new = f + return f(p_instance) + +def libvlc_media_list_player_release(p_mlp): + '''Release media_list_player. + @param p_mlp: media list player instance. + ''' + f = _Cfunctions.get('libvlc_media_list_player_release', None) or \ + _Cfunction('libvlc_media_list_player_release', ((1,),), + None, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_release + libvlc_media_list_player_release = f + return f(p_mlp) + +def libvlc_media_list_player_event_manager(p_mlp): + '''Return the event manager of this media_list_player. + @param p_mlp: media list player instance. + @return: the event manager. + ''' + f = _Cfunctions.get('libvlc_media_list_player_event_manager', None) or \ + _Cfunction('libvlc_media_list_player_event_manager', ((1,),), + EventManager, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_event_manager + libvlc_media_list_player_event_manager = f + return f(p_mlp) + +def libvlc_media_list_player_set_media_player(p_mlp, p_mi): + '''Replace media player in media_list_player with this instance. + @param p_mlp: media list player instance. + @param p_mi: media player instance. + ''' + f = _Cfunctions.get('libvlc_media_list_player_set_media_player', None) or \ + _Cfunction('libvlc_media_list_player_set_media_player', ((1,), (1,),), + None, MediaListPlayer, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_set_media_player + libvlc_media_list_player_set_media_player = f + return f(p_mlp, p_mi) + +def libvlc_media_list_player_set_media_list(p_mlp, p_mlist): + '''Set the media list associated with the player. + @param p_mlp: media list player instance. + @param p_mlist: list of media. + ''' + f = _Cfunctions.get('libvlc_media_list_player_set_media_list', None) or \ + _Cfunction('libvlc_media_list_player_set_media_list', ((1,), (1,),), + None, MediaListPlayer, MediaList) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_set_media_list + libvlc_media_list_player_set_media_list = f + return f(p_mlp, p_mlist) + +def libvlc_media_list_player_play(p_mlp): + '''Play media list. + @param p_mlp: media list player instance. + ''' + f = _Cfunctions.get('libvlc_media_list_player_play', None) or \ + _Cfunction('libvlc_media_list_player_play', ((1,),), + None, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_play + libvlc_media_list_player_play = f + return f(p_mlp) + +def libvlc_media_list_player_pause(p_mlp): + '''Pause media list. + @param p_mlp: media list player instance. + ''' + f = _Cfunctions.get('libvlc_media_list_player_pause', None) or \ + _Cfunction('libvlc_media_list_player_pause', ((1,),), + None, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_pause + libvlc_media_list_player_pause = f + return f(p_mlp) + +def libvlc_media_list_player_is_playing(p_mlp): + '''Is media list playing? + @param p_mlp: media list player instance. + @return: true for playing and false for not playing. + ''' + f = _Cfunctions.get('libvlc_media_list_player_is_playing', None) or \ + _Cfunction('libvlc_media_list_player_is_playing', ((1,),), + ctypes.c_int, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_is_playing + libvlc_media_list_player_is_playing = f + return f(p_mlp) + +def libvlc_media_list_player_get_state(p_mlp): + '''Get current libvlc_state of media list player. + @param p_mlp: media list player instance. + @return: libvlc_state_t for media list player. + ''' + f = _Cfunctions.get('libvlc_media_list_player_get_state', None) or \ + _Cfunction('libvlc_media_list_player_get_state', ((1,),), + State, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_get_state + libvlc_media_list_player_get_state = f + return f(p_mlp) + +def libvlc_media_list_player_play_item_at_index(p_mlp, i_index): + '''Play media list item at position index. + @param p_mlp: media list player instance. + @param i_index: index in media list to play. + @return: 0 upon success -1 if the item wasn't found. + ''' + f = _Cfunctions.get('libvlc_media_list_player_play_item_at_index', None) or \ + _Cfunction('libvlc_media_list_player_play_item_at_index', ((1,), (1,),), + ctypes.c_int, MediaListPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_play_item_at_index + libvlc_media_list_player_play_item_at_index = f + return f(p_mlp, i_index) + +def libvlc_media_list_player_play_item(p_mlp, p_md): + '''Play the given media item. + @param p_mlp: media list player instance. + @param p_md: the media instance. + @return: 0 upon success, -1 if the media is not part of the media list. + ''' + f = _Cfunctions.get('libvlc_media_list_player_play_item', None) or \ + _Cfunction('libvlc_media_list_player_play_item', ((1,), (1,),), + ctypes.c_int, MediaListPlayer, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_play_item + libvlc_media_list_player_play_item = f + return f(p_mlp, p_md) + +def libvlc_media_list_player_stop(p_mlp): + '''Stop playing media list. + @param p_mlp: media list player instance. + ''' + f = _Cfunctions.get('libvlc_media_list_player_stop', None) or \ + _Cfunction('libvlc_media_list_player_stop', ((1,),), + None, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_stop + libvlc_media_list_player_stop = f + return f(p_mlp) + +def libvlc_media_list_player_next(p_mlp): + '''Play next item from media list. + @param p_mlp: media list player instance. + @return: 0 upon success -1 if there is no next item. + ''' + f = _Cfunctions.get('libvlc_media_list_player_next', None) or \ + _Cfunction('libvlc_media_list_player_next', ((1,),), + ctypes.c_int, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_next + libvlc_media_list_player_next = f + return f(p_mlp) + +def libvlc_media_list_player_previous(p_mlp): + '''Play previous item from media list. + @param p_mlp: media list player instance. + @return: 0 upon success -1 if there is no previous item. + ''' + f = _Cfunctions.get('libvlc_media_list_player_previous', None) or \ + _Cfunction('libvlc_media_list_player_previous', ((1,),), + ctypes.c_int, MediaListPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_previous + libvlc_media_list_player_previous = f + return f(p_mlp) + +def libvlc_media_list_player_set_playback_mode(p_mlp, e_mode): + '''Sets the playback mode for the playlist. + @param p_mlp: media list player instance. + @param e_mode: playback mode specification. + ''' + f = _Cfunctions.get('libvlc_media_list_player_set_playback_mode', None) or \ + _Cfunction('libvlc_media_list_player_set_playback_mode', ((1,), (1,),), + None, MediaListPlayer, PlaybackMode) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_list_player_set_playback_mode + libvlc_media_list_player_set_playback_mode = f + return f(p_mlp, e_mode) + +def libvlc_media_player_new(p_libvlc_instance): + '''Create an empty Media Player object. + @param p_libvlc_instance: the libvlc instance in which the Media Player should be created. + @return: a new media player object, or NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_player_new', None) or \ + _Cfunction('libvlc_media_player_new', ((1,),), + MediaPlayer, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_new + libvlc_media_player_new = f + return f(p_libvlc_instance) + +def libvlc_media_player_new_from_media(p_md): + '''Create a Media Player object from a Media. + @param p_md: the media. Afterwards the p_md can be safely destroyed. + @return: a new media player object, or NULL on error. + ''' + f = _Cfunctions.get('libvlc_media_player_new_from_media', None) or \ + _Cfunction('libvlc_media_player_new_from_media', ((1,),), + MediaPlayer, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_new_from_media + libvlc_media_player_new_from_media = f + return f(p_md) + +def libvlc_media_player_release(p_mi): + '''Release a media_player after use + Decrement the reference count of a media player object. If the + reference count is 0, then L{libvlc_media_player_release}() will + release the media player object. If the media player object + has been released, then it should not be used again. + @param p_mi: the Media Player to free. + ''' + f = _Cfunctions.get('libvlc_media_player_release', None) or \ + _Cfunction('libvlc_media_player_release', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_release + libvlc_media_player_release = f + return f(p_mi) + +def libvlc_media_player_retain(p_mi): + '''Retain a reference to a media player object. Use + L{libvlc_media_player_release}() to decrement reference count. + @param p_mi: media player object. + ''' + f = _Cfunctions.get('libvlc_media_player_retain', None) or \ + _Cfunction('libvlc_media_player_retain', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_retain + libvlc_media_player_retain = f + return f(p_mi) + +def libvlc_media_player_set_media(p_mi, p_md): + '''Set the media that will be used by the media_player. If any, + previous md will be released. + @param p_mi: the Media Player. + @param p_md: the Media. Afterwards the p_md can be safely destroyed. + ''' + f = _Cfunctions.get('libvlc_media_player_set_media', None) or \ + _Cfunction('libvlc_media_player_set_media', ((1,), (1,),), + None, MediaPlayer, Media) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_media + libvlc_media_player_set_media = f + return f(p_mi, p_md) + +def libvlc_media_player_get_media(p_mi): + '''Get the media used by the media_player. + @param p_mi: the Media Player. + @return: the media associated with p_mi, or NULL if no media is associated. + ''' + f = _Cfunctions.get('libvlc_media_player_get_media', None) or \ + _Cfunction('libvlc_media_player_get_media', ((1,),), + Media, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_media + libvlc_media_player_get_media = f + return f(p_mi) + +def libvlc_media_player_event_manager(p_mi): + '''Get the Event Manager from which the media player send event. + @param p_mi: the Media Player. + @return: the event manager associated with p_mi. + ''' + f = _Cfunctions.get('libvlc_media_player_event_manager', None) or \ + _Cfunction('libvlc_media_player_event_manager', ((1,),), + EventManager, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_event_manager + libvlc_media_player_event_manager = f + return f(p_mi) + +def libvlc_media_player_is_playing(p_mi): + '''is_playing. + @param p_mi: the Media Player. + @return: 1 if the media player is playing, 0 otherwise. + ''' + f = _Cfunctions.get('libvlc_media_player_is_playing', None) or \ + _Cfunction('libvlc_media_player_is_playing', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_is_playing + libvlc_media_player_is_playing = f + return f(p_mi) + +def libvlc_media_player_play(p_mi): + '''Play. + @param p_mi: the Media Player. + @return: 0 if playback started (and was already started), or -1 on error. + ''' + f = _Cfunctions.get('libvlc_media_player_play', None) or \ + _Cfunction('libvlc_media_player_play', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_play + libvlc_media_player_play = f + return f(p_mi) + +def libvlc_media_player_set_pause(mp, do_pause): + '''Pause or resume (no effect if there is no media). + @param mp: the Media Player. + @param do_pause: play/resume if zero, pause if non-zero. + @version: LibVLC 1.1.1 or later. + ''' + f = _Cfunctions.get('libvlc_media_player_set_pause', None) or \ + _Cfunction('libvlc_media_player_set_pause', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_pause + libvlc_media_player_set_pause = f + return f(mp, do_pause) + +def libvlc_media_player_pause(p_mi): + '''Toggle pause (no effect if there is no media). + @param p_mi: the Media Player. + ''' + f = _Cfunctions.get('libvlc_media_player_pause', None) or \ + _Cfunction('libvlc_media_player_pause', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_pause + libvlc_media_player_pause = f + return f(p_mi) + +def libvlc_media_player_stop(p_mi): + '''Stop (no effect if there is no media). + @param p_mi: the Media Player. + ''' + f = _Cfunctions.get('libvlc_media_player_stop', None) or \ + _Cfunction('libvlc_media_player_stop', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_stop + libvlc_media_player_stop = f + return f(p_mi) + +def libvlc_video_set_format(mp, chroma, width, height, pitch): + '''Set decoded video chroma and dimensions. + This only works in combination with libvlc_video_set_callbacks(), + and is mutually exclusive with libvlc_video_set_format_callbacks(). + @param mp: the media player. + @param chroma: a four-characters string identifying the chroma (e.g. "RV32" or "YUYV"). + @param width: pixel width. + @param height: pixel height. + @param pitch: line pitch (in bytes). + @version: LibVLC 1.1.1 or later. + @bug: All pixel planes are expected to have the same pitch. To use the YCbCr color space with chrominance subsampling, consider using libvlc_video_set_format_callbacks() instead. + ''' + f = _Cfunctions.get('libvlc_video_set_format', None) or \ + _Cfunction('libvlc_video_set_format', ((1,), (1,), (1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_format + libvlc_video_set_format = f + return f(mp, chroma, width, height, pitch) + +def libvlc_media_player_set_nsobject(p_mi, drawable): + '''Set the NSView handler where the media player should render its video output. + Use the vout called "macosx". + The drawable is an NSObject that follow the VLCOpenGLVideoViewEmbedding + protocol: + @begincode + \@protocol VLCOpenGLVideoViewEmbedding + - (void)addVoutSubview:(NSView *)view; + - (void)removeVoutSubview:(NSView *)view; + \@end + @endcode + Or it can be an NSView object. + If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then + the following code should work: + @begincode + + NSView *video = [[NSView alloc] init]; + QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); + L{libvlc_media_player_set_nsobject}(mp, video); + [video release]; + + @endcode + You can find a live example in VLCVideoView in VLCKit.framework. + @param p_mi: the Media Player. + @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol. + ''' + f = _Cfunctions.get('libvlc_media_player_set_nsobject', None) or \ + _Cfunction('libvlc_media_player_set_nsobject', ((1,), (1,),), + None, MediaPlayer, ctypes.c_void_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_nsobject + libvlc_media_player_set_nsobject = f + return f(p_mi, drawable) + +def libvlc_media_player_get_nsobject(p_mi): + '''Get the NSView handler previously set with L{libvlc_media_player_set_nsobject}(). + @param p_mi: the Media Player. + @return: the NSView handler or 0 if none where set. + ''' + f = _Cfunctions.get('libvlc_media_player_get_nsobject', None) or \ + _Cfunction('libvlc_media_player_get_nsobject', ((1,),), + ctypes.c_void_p, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_nsobject + libvlc_media_player_get_nsobject = f + return f(p_mi) + +def libvlc_media_player_set_agl(p_mi, drawable): + '''Set the agl handler where the media player should render its video output. + @param p_mi: the Media Player. + @param drawable: the agl handler. + ''' + f = _Cfunctions.get('libvlc_media_player_set_agl', None) or \ + _Cfunction('libvlc_media_player_set_agl', ((1,), (1,),), + None, MediaPlayer, ctypes.c_uint32) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_agl + libvlc_media_player_set_agl = f + return f(p_mi, drawable) + +def libvlc_media_player_get_agl(p_mi): + '''Get the agl handler previously set with L{libvlc_media_player_set_agl}(). + @param p_mi: the Media Player. + @return: the agl handler or 0 if none where set. + ''' + f = _Cfunctions.get('libvlc_media_player_get_agl', None) or \ + _Cfunction('libvlc_media_player_get_agl', ((1,),), + ctypes.c_uint32, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_agl + libvlc_media_player_get_agl = f + return f(p_mi) + +def libvlc_media_player_set_xwindow(p_mi, drawable): + '''Set an X Window System drawable where the media player should render its + video output. If LibVLC was built without X11 output support, then this has + no effects. + The specified identifier must correspond to an existing Input/Output class + X11 window. Pixmaps are B{not} supported. The caller shall ensure that + the X11 server is the same as the one the VLC instance has been configured + with. This function must be called before video playback is started; + otherwise it will only take effect after playback stop and restart. + @param p_mi: the Media Player. + @param drawable: the ID of the X window. + ''' + f = _Cfunctions.get('libvlc_media_player_set_xwindow', None) or \ + _Cfunction('libvlc_media_player_set_xwindow', ((1,), (1,),), + None, MediaPlayer, ctypes.c_uint32) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_xwindow + libvlc_media_player_set_xwindow = f + return f(p_mi, drawable) + +def libvlc_media_player_get_xwindow(p_mi): + '''Get the X Window System window identifier previously set with + L{libvlc_media_player_set_xwindow}(). Note that this will return the identifier + even if VLC is not currently using it (for instance if it is playing an + audio-only input). + @param p_mi: the Media Player. + @return: an X window ID, or 0 if none where set. + ''' + f = _Cfunctions.get('libvlc_media_player_get_xwindow', None) or \ + _Cfunction('libvlc_media_player_get_xwindow', ((1,),), + ctypes.c_uint32, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_xwindow + libvlc_media_player_get_xwindow = f + return f(p_mi) + +def libvlc_media_player_set_hwnd(p_mi, drawable): + '''Set a Win32/Win64 API window handle (HWND) where the media player should + render its video output. If LibVLC was built without Win32/Win64 API output + support, then this has no effects. + @param p_mi: the Media Player. + @param drawable: windows handle of the drawable. + ''' + f = _Cfunctions.get('libvlc_media_player_set_hwnd', None) or \ + _Cfunction('libvlc_media_player_set_hwnd', ((1,), (1,),), + None, MediaPlayer, ctypes.c_void_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_hwnd + libvlc_media_player_set_hwnd = f + return f(p_mi, drawable) + +def libvlc_media_player_get_hwnd(p_mi): + '''Get the Windows API window handle (HWND) previously set with + L{libvlc_media_player_set_hwnd}(). The handle will be returned even if LibVLC + is not currently outputting any video to it. + @param p_mi: the Media Player. + @return: a window handle or NULL if there are none. + ''' + f = _Cfunctions.get('libvlc_media_player_get_hwnd', None) or \ + _Cfunction('libvlc_media_player_get_hwnd', ((1,),), + ctypes.c_void_p, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_hwnd + libvlc_media_player_get_hwnd = f + return f(p_mi) + +def libvlc_media_player_get_length(p_mi): + '''Get the current movie length (in ms). + @param p_mi: the Media Player. + @return: the movie length (in ms), or -1 if there is no media. + ''' + f = _Cfunctions.get('libvlc_media_player_get_length', None) or \ + _Cfunction('libvlc_media_player_get_length', ((1,),), + ctypes.c_longlong, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_length + libvlc_media_player_get_length = f + return f(p_mi) + +def libvlc_media_player_get_time(p_mi): + '''Get the current movie time (in ms). + @param p_mi: the Media Player. + @return: the movie time (in ms), or -1 if there is no media. + ''' + f = _Cfunctions.get('libvlc_media_player_get_time', None) or \ + _Cfunction('libvlc_media_player_get_time', ((1,),), + ctypes.c_longlong, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_time + libvlc_media_player_get_time = f + return f(p_mi) + +def libvlc_media_player_set_time(p_mi, i_time): + '''Set the movie time (in ms). This has no effect if no media is being played. + Not all formats and protocols support this. + @param p_mi: the Media Player. + @param i_time: the movie time (in ms). + ''' + f = _Cfunctions.get('libvlc_media_player_set_time', None) or \ + _Cfunction('libvlc_media_player_set_time', ((1,), (1,),), + None, MediaPlayer, ctypes.c_longlong) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_time + libvlc_media_player_set_time = f + return f(p_mi, i_time) + +def libvlc_media_player_get_position(p_mi): + '''Get movie position. + @param p_mi: the Media Player. + @return: movie position, or -1. in case of error. + ''' + f = _Cfunctions.get('libvlc_media_player_get_position', None) or \ + _Cfunction('libvlc_media_player_get_position', ((1,),), + ctypes.c_float, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_position + libvlc_media_player_get_position = f + return f(p_mi) + +def libvlc_media_player_set_position(p_mi, f_pos): + '''Set movie position. This has no effect if playback is not enabled. + This might not work depending on the underlying input format and protocol. + @param p_mi: the Media Player. + @param f_pos: the position. + ''' + f = _Cfunctions.get('libvlc_media_player_set_position', None) or \ + _Cfunction('libvlc_media_player_set_position', ((1,), (1,),), + None, MediaPlayer, ctypes.c_float) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_position + libvlc_media_player_set_position = f + return f(p_mi, f_pos) + +def libvlc_media_player_set_chapter(p_mi, i_chapter): + '''Set movie chapter (if applicable). + @param p_mi: the Media Player. + @param i_chapter: chapter number to play. + ''' + f = _Cfunctions.get('libvlc_media_player_set_chapter', None) or \ + _Cfunction('libvlc_media_player_set_chapter', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_chapter + libvlc_media_player_set_chapter = f + return f(p_mi, i_chapter) + +def libvlc_media_player_get_chapter(p_mi): + '''Get movie chapter. + @param p_mi: the Media Player. + @return: chapter number currently playing, or -1 if there is no media. + ''' + f = _Cfunctions.get('libvlc_media_player_get_chapter', None) or \ + _Cfunction('libvlc_media_player_get_chapter', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_chapter + libvlc_media_player_get_chapter = f + return f(p_mi) + +def libvlc_media_player_get_chapter_count(p_mi): + '''Get movie chapter count. + @param p_mi: the Media Player. + @return: number of chapters in movie, or -1. + ''' + f = _Cfunctions.get('libvlc_media_player_get_chapter_count', None) or \ + _Cfunction('libvlc_media_player_get_chapter_count', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_chapter_count + libvlc_media_player_get_chapter_count = f + return f(p_mi) + +def libvlc_media_player_will_play(p_mi): + '''Is the player able to play. + @param p_mi: the Media Player. + @return: boolean. + ''' + f = _Cfunctions.get('libvlc_media_player_will_play', None) or \ + _Cfunction('libvlc_media_player_will_play', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_will_play + libvlc_media_player_will_play = f + return f(p_mi) + +def libvlc_media_player_get_chapter_count_for_title(p_mi, i_title): + '''Get title chapter count. + @param p_mi: the Media Player. + @param i_title: title. + @return: number of chapters in title, or -1. + ''' + f = _Cfunctions.get('libvlc_media_player_get_chapter_count_for_title', None) or \ + _Cfunction('libvlc_media_player_get_chapter_count_for_title', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_chapter_count_for_title + libvlc_media_player_get_chapter_count_for_title = f + return f(p_mi, i_title) + +def libvlc_media_player_set_title(p_mi, i_title): + '''Set movie title. + @param p_mi: the Media Player. + @param i_title: title number to play. + ''' + f = _Cfunctions.get('libvlc_media_player_set_title', None) or \ + _Cfunction('libvlc_media_player_set_title', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_title + libvlc_media_player_set_title = f + return f(p_mi, i_title) + +def libvlc_media_player_get_title(p_mi): + '''Get movie title. + @param p_mi: the Media Player. + @return: title number currently playing, or -1. + ''' + f = _Cfunctions.get('libvlc_media_player_get_title', None) or \ + _Cfunction('libvlc_media_player_get_title', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_title + libvlc_media_player_get_title = f + return f(p_mi) + +def libvlc_media_player_get_title_count(p_mi): + '''Get movie title count. + @param p_mi: the Media Player. + @return: title number count, or -1. + ''' + f = _Cfunctions.get('libvlc_media_player_get_title_count', None) or \ + _Cfunction('libvlc_media_player_get_title_count', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_title_count + libvlc_media_player_get_title_count = f + return f(p_mi) + +def libvlc_media_player_previous_chapter(p_mi): + '''Set previous chapter (if applicable). + @param p_mi: the Media Player. + ''' + f = _Cfunctions.get('libvlc_media_player_previous_chapter', None) or \ + _Cfunction('libvlc_media_player_previous_chapter', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_previous_chapter + libvlc_media_player_previous_chapter = f + return f(p_mi) + +def libvlc_media_player_next_chapter(p_mi): + '''Set next chapter (if applicable). + @param p_mi: the Media Player. + ''' + f = _Cfunctions.get('libvlc_media_player_next_chapter', None) or \ + _Cfunction('libvlc_media_player_next_chapter', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_next_chapter + libvlc_media_player_next_chapter = f + return f(p_mi) + +def libvlc_media_player_get_rate(p_mi): + '''Get the requested movie play rate. + @warning: Depending on the underlying media, the requested rate may be + different from the real playback rate. + @param p_mi: the Media Player. + @return: movie play rate. + ''' + f = _Cfunctions.get('libvlc_media_player_get_rate', None) or \ + _Cfunction('libvlc_media_player_get_rate', ((1,),), + ctypes.c_float, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_rate + libvlc_media_player_get_rate = f + return f(p_mi) + +def libvlc_media_player_set_rate(p_mi, rate): + '''Set movie play rate. + @param p_mi: the Media Player. + @param rate: movie play rate to set. + @return: -1 if an error was detected, 0 otherwise (but even then, it might not actually work depending on the underlying media protocol). + ''' + f = _Cfunctions.get('libvlc_media_player_set_rate', None) or \ + _Cfunction('libvlc_media_player_set_rate', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_float) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_set_rate + libvlc_media_player_set_rate = f + return f(p_mi, rate) + +def libvlc_media_player_get_state(p_mi): + '''Get current movie state. + @param p_mi: the Media Player. + @return: the current state of the media player (playing, paused, ...) See libvlc_state_t. + ''' + f = _Cfunctions.get('libvlc_media_player_get_state', None) or \ + _Cfunction('libvlc_media_player_get_state', ((1,),), + State, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_state + libvlc_media_player_get_state = f + return f(p_mi) + +def libvlc_media_player_get_fps(p_mi): + '''Get movie fps rate. + @param p_mi: the Media Player. + @return: frames per second (fps) for this playing movie, or 0 if unspecified. + ''' + f = _Cfunctions.get('libvlc_media_player_get_fps', None) or \ + _Cfunction('libvlc_media_player_get_fps', ((1,),), + ctypes.c_float, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_get_fps + libvlc_media_player_get_fps = f + return f(p_mi) + +def libvlc_media_player_has_vout(p_mi): + '''How many video outputs does this media player have? + @param p_mi: the media player. + @return: the number of video outputs. + ''' + f = _Cfunctions.get('libvlc_media_player_has_vout', None) or \ + _Cfunction('libvlc_media_player_has_vout', ((1,),), + ctypes.c_uint, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_has_vout + libvlc_media_player_has_vout = f + return f(p_mi) + +def libvlc_media_player_is_seekable(p_mi): + '''Is this media player seekable? + @param p_mi: the media player. + @return: true if the media player can seek. + ''' + f = _Cfunctions.get('libvlc_media_player_is_seekable', None) or \ + _Cfunction('libvlc_media_player_is_seekable', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_is_seekable + libvlc_media_player_is_seekable = f + return f(p_mi) + +def libvlc_media_player_can_pause(p_mi): + '''Can this media player be paused? + @param p_mi: the media player. + @return: true if the media player can pause. + ''' + f = _Cfunctions.get('libvlc_media_player_can_pause', None) or \ + _Cfunction('libvlc_media_player_can_pause', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_can_pause + libvlc_media_player_can_pause = f + return f(p_mi) + +def libvlc_media_player_next_frame(p_mi): + '''Display the next frame (if supported). + @param p_mi: the media player. + ''' + f = _Cfunctions.get('libvlc_media_player_next_frame', None) or \ + _Cfunction('libvlc_media_player_next_frame', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_next_frame + libvlc_media_player_next_frame = f + return f(p_mi) + +def libvlc_media_player_navigate(p_mi, navigate): + '''Navigate through DVD Menu. + @param p_mi: the Media Player. + @param navigate: the Navigation mode. + @version: libVLC 1.2.0 or later. + ''' + f = _Cfunctions.get('libvlc_media_player_navigate', None) or \ + _Cfunction('libvlc_media_player_navigate', ((1,), (1,),), + None, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_media_player_navigate + libvlc_media_player_navigate = f + return f(p_mi, navigate) + +def libvlc_track_description_release(p_track_description): + '''Release (free) L{TrackDescription}. + @param p_track_description: the structure to release. + ''' + f = _Cfunctions.get('libvlc_track_description_release', None) or \ + _Cfunction('libvlc_track_description_release', ((1,),), + None, ctypes.POINTER(TrackDescription)) + if not __debug__: # i.e. python -O or -OO + global libvlc_track_description_release + libvlc_track_description_release = f + return f(p_track_description) + +def libvlc_toggle_fullscreen(p_mi): + '''Toggle fullscreen status on non-embedded video outputs. + @warning: The same limitations applies to this function + as to L{libvlc_set_fullscreen}(). + @param p_mi: the media player. + ''' + f = _Cfunctions.get('libvlc_toggle_fullscreen', None) or \ + _Cfunction('libvlc_toggle_fullscreen', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_toggle_fullscreen + libvlc_toggle_fullscreen = f + return f(p_mi) + +def libvlc_set_fullscreen(p_mi, b_fullscreen): + '''Enable or disable fullscreen. + @warning: With most window managers, only a top-level windows can be in + full-screen mode. Hence, this function will not operate properly if + L{libvlc_media_player_set_xwindow}() was used to embed the video in a + non-top-level window. In that case, the embedding window must be reparented + to the root window B{before} fullscreen mode is enabled. You will want + to reparent it back to its normal parent when disabling fullscreen. + @param p_mi: the media player. + @param b_fullscreen: boolean for fullscreen status. + ''' + f = _Cfunctions.get('libvlc_set_fullscreen', None) or \ + _Cfunction('libvlc_set_fullscreen', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_set_fullscreen + libvlc_set_fullscreen = f + return f(p_mi, b_fullscreen) + +def libvlc_get_fullscreen(p_mi): + '''Get current fullscreen status. + @param p_mi: the media player. + @return: the fullscreen status (boolean). + ''' + f = _Cfunctions.get('libvlc_get_fullscreen', None) or \ + _Cfunction('libvlc_get_fullscreen', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_get_fullscreen + libvlc_get_fullscreen = f + return f(p_mi) + +def libvlc_video_set_key_input(p_mi, on): + '''Enable or disable key press events handling, according to the LibVLC hotkeys + configuration. By default and for historical reasons, keyboard events are + handled by the LibVLC video widget. + @note: On X11, there can be only one subscriber for key press and mouse + click events per window. If your application has subscribed to those events + for the X window ID of the video widget, then LibVLC will not be able to + handle key presses and mouse clicks in any case. + @warning: This function is only implemented for X11 and Win32 at the moment. + @param p_mi: the media player. + @param on: true to handle key press events, false to ignore them. + ''' + f = _Cfunctions.get('libvlc_video_set_key_input', None) or \ + _Cfunction('libvlc_video_set_key_input', ((1,), (1,),), + None, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_key_input + libvlc_video_set_key_input = f + return f(p_mi, on) + +def libvlc_video_set_mouse_input(p_mi, on): + '''Enable or disable mouse click events handling. By default, those events are + handled. This is needed for DVD menus to work, as well as a few video + filters such as "puzzle". + @note: See also L{libvlc_video_set_key_input}(). + @warning: This function is only implemented for X11 and Win32 at the moment. + @param p_mi: the media player. + @param on: true to handle mouse click events, false to ignore them. + ''' + f = _Cfunctions.get('libvlc_video_set_mouse_input', None) or \ + _Cfunction('libvlc_video_set_mouse_input', ((1,), (1,),), + None, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_mouse_input + libvlc_video_set_mouse_input = f + return f(p_mi, on) + +def libvlc_video_get_size(p_mi, num): + '''Get the pixel dimensions of a video. + @param p_mi: media player. + @param num: number of the video (starting from, and most commonly 0). + @return: px pixel width, py pixel height. + ''' + f = _Cfunctions.get('libvlc_video_get_size', None) or \ + _Cfunction('libvlc_video_get_size', ((1,), (1,), (2,), (2,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint)) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_size + libvlc_video_get_size = f + return f(p_mi, num) + +def libvlc_video_get_cursor(p_mi, num): + '''Get the mouse pointer coordinates over a video. + Coordinates are expressed in terms of the decoded video resolution, + B{not} in terms of pixels on the screen/viewport (to get the latter, + you can query your windowing system directly). + Either of the coordinates may be negative or larger than the corresponding + dimension of the video, if the cursor is outside the rendering area. + @warning: The coordinates may be out-of-date if the pointer is not located + on the video rendering area. LibVLC does not track the pointer if it is + outside of the video widget. + @note: LibVLC does not support multiple pointers (it does of course support + multiple input devices sharing the same pointer) at the moment. + @param p_mi: media player. + @param num: number of the video (starting from, and most commonly 0). + @return: px abscissa, py ordinate. + ''' + f = _Cfunctions.get('libvlc_video_get_cursor', None) or \ + _Cfunction('libvlc_video_get_cursor', ((1,), (1,), (2,), (2,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_int), ctypes.POINTER(ctypes.c_int)) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_cursor + libvlc_video_get_cursor = f + return f(p_mi, num) + +def libvlc_video_get_scale(p_mi): + '''Get the current video scaling factor. + See also L{libvlc_video_set_scale}(). + @param p_mi: the media player. + @return: the currently configured zoom factor, or 0. if the video is set to fit to the output window/drawable automatically. + ''' + f = _Cfunctions.get('libvlc_video_get_scale', None) or \ + _Cfunction('libvlc_video_get_scale', ((1,),), + ctypes.c_float, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_scale + libvlc_video_get_scale = f + return f(p_mi) + +def libvlc_video_set_scale(p_mi, f_factor): + '''Set the video scaling factor. That is the ratio of the number of pixels on + screen to the number of pixels in the original decoded video in each + dimension. Zero is a special value; it will adjust the video to the output + window/drawable (in windowed mode) or the entire screen. + Note that not all video outputs support scaling. + @param p_mi: the media player. + @param f_factor: the scaling factor, or zero. + ''' + f = _Cfunctions.get('libvlc_video_set_scale', None) or \ + _Cfunction('libvlc_video_set_scale', ((1,), (1,),), + None, MediaPlayer, ctypes.c_float) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_scale + libvlc_video_set_scale = f + return f(p_mi, f_factor) + +def libvlc_video_get_aspect_ratio(p_mi): + '''Get current video aspect ratio. + @param p_mi: the media player. + @return: the video aspect ratio or NULL if unspecified (the result must be released with free() or L{libvlc_free}()). + ''' + f = _Cfunctions.get('libvlc_video_get_aspect_ratio', None) or \ + _Cfunction('libvlc_video_get_aspect_ratio', ((1,),), + ctypes.c_char_p, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_aspect_ratio + libvlc_video_get_aspect_ratio = f + return f(p_mi) + +def libvlc_video_set_aspect_ratio(p_mi, psz_aspect): + '''Set new video aspect ratio. + @param p_mi: the media player. + @param psz_aspect: new video aspect-ratio or NULL to reset to default @note Invalid aspect ratios are ignored. + ''' + f = _Cfunctions.get('libvlc_video_set_aspect_ratio', None) or \ + _Cfunction('libvlc_video_set_aspect_ratio', ((1,), (1,),), + None, MediaPlayer, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_aspect_ratio + libvlc_video_set_aspect_ratio = f + return f(p_mi, psz_aspect) + +def libvlc_video_get_spu(p_mi): + '''Get current video subtitle. + @param p_mi: the media player. + @return: the video subtitle selected, or -1 if none. + ''' + f = _Cfunctions.get('libvlc_video_get_spu', None) or \ + _Cfunction('libvlc_video_get_spu', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_spu + libvlc_video_get_spu = f + return f(p_mi) + +def libvlc_video_get_spu_count(p_mi): + '''Get the number of available video subtitles. + @param p_mi: the media player. + @return: the number of available video subtitles. + ''' + f = _Cfunctions.get('libvlc_video_get_spu_count', None) or \ + _Cfunction('libvlc_video_get_spu_count', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_spu_count + libvlc_video_get_spu_count = f + return f(p_mi) + +def libvlc_video_get_spu_description(p_mi): + '''Get the description of available video subtitles. + @param p_mi: the media player. + @return: list containing description of available video subtitles. + ''' + f = _Cfunctions.get('libvlc_video_get_spu_description', None) or \ + _Cfunction('libvlc_video_get_spu_description', ((1,),), + ctypes.POINTER(TrackDescription), MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_spu_description + libvlc_video_get_spu_description = f + return f(p_mi) + +def libvlc_video_set_spu(p_mi, i_spu): + '''Set new video subtitle. + @param p_mi: the media player. + @param i_spu: new video subtitle to select. + @return: 0 on success, -1 if out of range. + ''' + f = _Cfunctions.get('libvlc_video_set_spu', None) or \ + _Cfunction('libvlc_video_set_spu', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_spu + libvlc_video_set_spu = f + return f(p_mi, i_spu) + +def libvlc_video_set_subtitle_file(p_mi, psz_subtitle): + '''Set new video subtitle file. + @param p_mi: the media player. + @param psz_subtitle: new video subtitle file. + @return: the success status (boolean). + ''' + f = _Cfunctions.get('libvlc_video_set_subtitle_file', None) or \ + _Cfunction('libvlc_video_set_subtitle_file', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_subtitle_file + libvlc_video_set_subtitle_file = f + return f(p_mi, psz_subtitle) + +def libvlc_video_get_title_description(p_mi): + '''Get the description of available titles. + @param p_mi: the media player. + @return: list containing description of available titles. + ''' + f = _Cfunctions.get('libvlc_video_get_title_description', None) or \ + _Cfunction('libvlc_video_get_title_description', ((1,),), + ctypes.POINTER(TrackDescription), MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_title_description + libvlc_video_get_title_description = f + 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. + ''' + f = _Cfunctions.get('libvlc_video_get_chapter_description', None) or \ + _Cfunction('libvlc_video_get_chapter_description', ((1,), (1,),), + ctypes.POINTER(TrackDescription), MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_chapter_description + libvlc_video_get_chapter_description = f + return f(p_mi, i_title) + +def libvlc_video_get_crop_geometry(p_mi): + '''Get current crop filter geometry. + @param p_mi: the media player. + @return: the crop filter geometry or NULL if unset. + ''' + f = _Cfunctions.get('libvlc_video_get_crop_geometry', None) or \ + _Cfunction('libvlc_video_get_crop_geometry', ((1,),), + ctypes.c_char_p, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_crop_geometry + libvlc_video_get_crop_geometry = f + return f(p_mi) + +def libvlc_video_set_crop_geometry(p_mi, psz_geometry): + '''Set new crop filter geometry. + @param p_mi: the media player. + @param psz_geometry: new crop filter geometry (NULL to unset). + ''' + f = _Cfunctions.get('libvlc_video_set_crop_geometry', None) or \ + _Cfunction('libvlc_video_set_crop_geometry', ((1,), (1,),), + None, MediaPlayer, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_crop_geometry + libvlc_video_set_crop_geometry = f + return f(p_mi, psz_geometry) + +def libvlc_video_get_teletext(p_mi): + '''Get current teletext page requested. + @param p_mi: the media player. + @return: the current teletext page requested. + ''' + f = _Cfunctions.get('libvlc_video_get_teletext', None) or \ + _Cfunction('libvlc_video_get_teletext', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_teletext + libvlc_video_get_teletext = f + return f(p_mi) + +def libvlc_video_set_teletext(p_mi, i_page): + '''Set new teletext page to retrieve. + @param p_mi: the media player. + @param i_page: teletex page number requested. + ''' + f = _Cfunctions.get('libvlc_video_set_teletext', None) or \ + _Cfunction('libvlc_video_set_teletext', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_teletext + libvlc_video_set_teletext = f + return f(p_mi, i_page) + +def libvlc_toggle_teletext(p_mi): + '''Toggle teletext transparent status on video output. + @param p_mi: the media player. + ''' + f = _Cfunctions.get('libvlc_toggle_teletext', None) or \ + _Cfunction('libvlc_toggle_teletext', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_toggle_teletext + libvlc_toggle_teletext = f + return f(p_mi) + +def libvlc_video_get_track_count(p_mi): + '''Get number of available video tracks. + @param p_mi: media player. + @return: the number of available video tracks (int). + ''' + f = _Cfunctions.get('libvlc_video_get_track_count', None) or \ + _Cfunction('libvlc_video_get_track_count', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_track_count + libvlc_video_get_track_count = f + return f(p_mi) + +def libvlc_video_get_track_description(p_mi): + '''Get the description of available video tracks. + @param p_mi: media player. + @return: list with description of available video tracks, or NULL on error. + ''' + f = _Cfunctions.get('libvlc_video_get_track_description', None) or \ + _Cfunction('libvlc_video_get_track_description', ((1,),), + ctypes.POINTER(TrackDescription), MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_track_description + libvlc_video_get_track_description = f + return f(p_mi) + +def libvlc_video_get_track(p_mi): + '''Get current video track. + @param p_mi: media player. + @return: the video track (int) or -1 if none. + ''' + f = _Cfunctions.get('libvlc_video_get_track', None) or \ + _Cfunction('libvlc_video_get_track', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_track + libvlc_video_get_track = f + return f(p_mi) + +def libvlc_video_set_track(p_mi, i_track): + '''Set video track. + @param p_mi: media player. + @param i_track: the track (int). + @return: 0 on success, -1 if out of range. + ''' + f = _Cfunctions.get('libvlc_video_set_track', None) or \ + _Cfunction('libvlc_video_set_track', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_track + libvlc_video_set_track = f + return f(p_mi, i_track) + +def libvlc_video_take_snapshot(p_mi, num, psz_filepath, i_width, i_height): + '''Take a snapshot of the current video window. + If i_width AND i_height is 0, original size is used. + If i_width XOR i_height is 0, original aspect-ratio is preserved. + @param p_mi: media player instance. + @param num: number of video output (typically 0 for the first/only one). + @param psz_filepath: the path where to save the screenshot to. + @param i_width: the snapshot's width. + @param i_height: the snapshot's height. + @return: 0 on success, -1 if the video was not found. + ''' + f = _Cfunctions.get('libvlc_video_take_snapshot', None) or \ + _Cfunction('libvlc_video_take_snapshot', ((1,), (1,), (1,), (1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.c_char_p, ctypes.c_int, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_take_snapshot + libvlc_video_take_snapshot = f + return f(p_mi, num, psz_filepath, i_width, i_height) + +def libvlc_video_set_deinterlace(p_mi, psz_mode): + '''Enable or disable deinterlace filter. + @param p_mi: libvlc media player. + @param psz_mode: type of deinterlace filter, NULL to disable. + ''' + f = _Cfunctions.get('libvlc_video_set_deinterlace', None) or \ + _Cfunction('libvlc_video_set_deinterlace', ((1,), (1,),), + None, MediaPlayer, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_deinterlace + libvlc_video_set_deinterlace = f + return f(p_mi, psz_mode) + +def libvlc_video_get_marquee_int(p_mi, option): + '''Get an integer marquee option value. + @param p_mi: libvlc media player. + @param option: marq option to get See libvlc_video_marquee_int_option_t. + ''' + f = _Cfunctions.get('libvlc_video_get_marquee_int', None) or \ + _Cfunction('libvlc_video_get_marquee_int', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_marquee_int + libvlc_video_get_marquee_int = f + return f(p_mi, option) + +def libvlc_video_get_marquee_string(p_mi, option): + '''Get a string marquee option value. + @param p_mi: libvlc media player. + @param option: marq option to get See libvlc_video_marquee_string_option_t. + ''' + f = _Cfunctions.get('libvlc_video_get_marquee_string', None) or \ + _Cfunction('libvlc_video_get_marquee_string', ((1,), (1,),), + ctypes.c_char_p, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_marquee_string + libvlc_video_get_marquee_string = f + return f(p_mi, option) + +def libvlc_video_set_marquee_int(p_mi, option, i_val): + '''Enable, disable or set an integer marquee option + Setting libvlc_marquee_Enable has the side effect of enabling (arg !0) + or disabling (arg 0) the marq filter. + @param p_mi: libvlc media player. + @param option: marq option to set See libvlc_video_marquee_int_option_t. + @param i_val: marq option value. + ''' + f = _Cfunctions.get('libvlc_video_set_marquee_int', None) or \ + _Cfunction('libvlc_video_set_marquee_int', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_uint, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_marquee_int + libvlc_video_set_marquee_int = f + return f(p_mi, option, i_val) + +def libvlc_video_set_marquee_string(p_mi, option, psz_text): + '''Set a marquee string option. + @param p_mi: libvlc media player. + @param option: marq option to set See libvlc_video_marquee_string_option_t. + @param psz_text: marq option value. + ''' + f = _Cfunctions.get('libvlc_video_set_marquee_string', None) or \ + _Cfunction('libvlc_video_set_marquee_string', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_marquee_string + libvlc_video_set_marquee_string = f + return f(p_mi, option, psz_text) + +def libvlc_video_get_logo_int(p_mi, option): + '''Get integer logo option. + @param p_mi: libvlc media player instance. + @param option: logo option to get, values of libvlc_video_logo_option_t. + ''' + f = _Cfunctions.get('libvlc_video_get_logo_int', None) or \ + _Cfunction('libvlc_video_get_logo_int', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_logo_int + libvlc_video_get_logo_int = f + return f(p_mi, option) + +def libvlc_video_set_logo_int(p_mi, option, value): + '''Set logo option as integer. Options that take a different type value + are ignored. + Passing libvlc_logo_enable as option value has the side effect of + starting (arg !0) or stopping (arg 0) the logo filter. + @param p_mi: libvlc media player instance. + @param option: logo option to set, values of libvlc_video_logo_option_t. + @param value: logo option value. + ''' + f = _Cfunctions.get('libvlc_video_set_logo_int', None) or \ + _Cfunction('libvlc_video_set_logo_int', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_uint, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_logo_int + libvlc_video_set_logo_int = f + return f(p_mi, option, value) + +def libvlc_video_set_logo_string(p_mi, option, psz_value): + '''Set logo option as string. Options that take a different type value + are ignored. + @param p_mi: libvlc media player instance. + @param option: logo option to set, values of libvlc_video_logo_option_t. + @param psz_value: logo option value. + ''' + f = _Cfunctions.get('libvlc_video_set_logo_string', None) or \ + _Cfunction('libvlc_video_set_logo_string', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_logo_string + libvlc_video_set_logo_string = f + return f(p_mi, option, psz_value) + +def libvlc_video_get_adjust_int(p_mi, option): + '''Get integer adjust option. + @param p_mi: libvlc media player instance. + @param option: adjust option to get, values of libvlc_video_adjust_option_t. + @version: LibVLC 1.1.1 and later. + ''' + f = _Cfunctions.get('libvlc_video_get_adjust_int', None) or \ + _Cfunction('libvlc_video_get_adjust_int', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_adjust_int + libvlc_video_get_adjust_int = f + return f(p_mi, option) + +def libvlc_video_set_adjust_int(p_mi, option, value): + '''Set adjust option as integer. Options that take a different type value + are ignored. + Passing libvlc_adjust_enable as option value has the side effect of + starting (arg !0) or stopping (arg 0) the adjust filter. + @param p_mi: libvlc media player instance. + @param option: adust option to set, values of libvlc_video_adjust_option_t. + @param value: adjust option value. + @version: LibVLC 1.1.1 and later. + ''' + f = _Cfunctions.get('libvlc_video_set_adjust_int', None) or \ + _Cfunction('libvlc_video_set_adjust_int', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_uint, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_adjust_int + libvlc_video_set_adjust_int = f + return f(p_mi, option, value) + +def libvlc_video_get_adjust_float(p_mi, option): + '''Get float adjust option. + @param p_mi: libvlc media player instance. + @param option: adjust option to get, values of libvlc_video_adjust_option_t. + @version: LibVLC 1.1.1 and later. + ''' + f = _Cfunctions.get('libvlc_video_get_adjust_float', None) or \ + _Cfunction('libvlc_video_get_adjust_float', ((1,), (1,),), + ctypes.c_float, MediaPlayer, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_get_adjust_float + libvlc_video_get_adjust_float = f + return f(p_mi, option) + +def libvlc_video_set_adjust_float(p_mi, option, value): + '''Set adjust option as float. Options that take a different type value + are ignored. + @param p_mi: libvlc media player instance. + @param option: adust option to set, values of libvlc_video_adjust_option_t. + @param value: adjust option value. + @version: LibVLC 1.1.1 and later. + ''' + f = _Cfunctions.get('libvlc_video_set_adjust_float', None) or \ + _Cfunction('libvlc_video_set_adjust_float', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_uint, ctypes.c_float) + if not __debug__: # i.e. python -O or -OO + global libvlc_video_set_adjust_float + libvlc_video_set_adjust_float = f + return f(p_mi, option, value) + +def libvlc_audio_output_list_get(p_instance): + '''Get the list of available audio outputs. + @param p_instance: libvlc instance. + @return: list of available audio outputs. It must be freed it with In case of error, NULL is returned. + ''' + f = _Cfunctions.get('libvlc_audio_output_list_get', None) or \ + _Cfunction('libvlc_audio_output_list_get', ((1,),), + ctypes.POINTER(AudioOutput), Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_list_get + libvlc_audio_output_list_get = f + return f(p_instance) + +def libvlc_audio_output_list_release(p_list): + '''Free the list of available audio outputs. + @param p_list: list with audio outputs for release. + ''' + f = _Cfunctions.get('libvlc_audio_output_list_release', None) or \ + _Cfunction('libvlc_audio_output_list_release', ((1,),), + None, ctypes.POINTER(AudioOutput)) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_list_release + libvlc_audio_output_list_release = f + return f(p_list) + +def libvlc_audio_output_set(p_mi, psz_name): + '''Set the audio output. + Change will be applied after stop and play. + @param p_mi: media player. + @param psz_name: name of audio output, use psz_name of See L{AudioOutput}. + @return: true if function succeded. + ''' + f = _Cfunctions.get('libvlc_audio_output_set', None) or \ + _Cfunction('libvlc_audio_output_set', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_set + libvlc_audio_output_set = f + return f(p_mi, psz_name) + +def libvlc_audio_output_device_count(p_instance, psz_audio_output): + '''Get count of devices for audio output, these devices are hardware oriented + like analor or digital output of sound card. + @param p_instance: libvlc instance. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @return: number of devices. + ''' + f = _Cfunctions.get('libvlc_audio_output_device_count', None) or \ + _Cfunction('libvlc_audio_output_device_count', ((1,), (1,),), + ctypes.c_int, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_device_count + libvlc_audio_output_device_count = f + return f(p_instance, psz_audio_output) + +def libvlc_audio_output_device_longname(p_instance, psz_audio_output, i_device): + '''Get long name of device, if not available short name given. + @param p_instance: libvlc instance. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @param i_device: device index. + @return: long name of device. + ''' + f = _Cfunctions.get('libvlc_audio_output_device_longname', None) or \ + _Cfunction('libvlc_audio_output_device_longname', ((1,), (1,), (1,),), + ctypes.c_char_p, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_device_longname + libvlc_audio_output_device_longname = f + return f(p_instance, psz_audio_output, i_device) + +def libvlc_audio_output_device_id(p_instance, psz_audio_output, i_device): + '''Get id name of device. + @param p_instance: libvlc instance. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @param i_device: device index. + @return: id name of device, use for setting device, need to be free after use. + ''' + f = _Cfunctions.get('libvlc_audio_output_device_id', None) or \ + _Cfunction('libvlc_audio_output_device_id', ((1,), (1,), (1,),), + ctypes.c_char_p, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_device_id + libvlc_audio_output_device_id = f + return f(p_instance, psz_audio_output, i_device) + +def libvlc_audio_output_device_set(p_mi, psz_audio_output, psz_device_id): + '''Set audio output device. Changes are only effective after stop and play. + @param p_mi: media player. + @param psz_audio_output: - name of audio output, See L{AudioOutput}. + @param psz_device_id: device. + ''' + f = _Cfunctions.get('libvlc_audio_output_device_set', None) or \ + _Cfunction('libvlc_audio_output_device_set', ((1,), (1,), (1,),), + None, MediaPlayer, ctypes.c_char_p, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_device_set + libvlc_audio_output_device_set = f + return f(p_mi, psz_audio_output, psz_device_id) + +def libvlc_audio_output_get_device_type(p_mi): + '''Get current audio device type. Device type describes something like + character of output sound - stereo sound, 2.1, 5.1 etc. + @param p_mi: media player. + @return: the audio devices type See libvlc_audio_output_device_types_t. + ''' + f = _Cfunctions.get('libvlc_audio_output_get_device_type', None) or \ + _Cfunction('libvlc_audio_output_get_device_type', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_get_device_type + libvlc_audio_output_get_device_type = f + return f(p_mi) + +def libvlc_audio_output_set_device_type(p_mi, device_type): + '''Set current audio device type. + @param p_mi: vlc instance. + @param device_type: the audio device type, + ''' + f = _Cfunctions.get('libvlc_audio_output_set_device_type', None) or \ + _Cfunction('libvlc_audio_output_set_device_type', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_output_set_device_type + libvlc_audio_output_set_device_type = f + return f(p_mi, device_type) + +def libvlc_audio_toggle_mute(p_mi): + '''Toggle mute status. + @param p_mi: media player. + ''' + f = _Cfunctions.get('libvlc_audio_toggle_mute', None) or \ + _Cfunction('libvlc_audio_toggle_mute', ((1,),), + None, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_toggle_mute + libvlc_audio_toggle_mute = f + return f(p_mi) + +def libvlc_audio_get_mute(p_mi): + '''Get current mute status. + @param p_mi: media player. + @return: the mute status (boolean). + ''' + f = _Cfunctions.get('libvlc_audio_get_mute', None) or \ + _Cfunction('libvlc_audio_get_mute', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_mute + libvlc_audio_get_mute = f + return f(p_mi) + +def libvlc_audio_set_mute(p_mi, status): + '''Set mute status. + @param p_mi: media player. + @param status: If status is true then mute, otherwise unmute. + ''' + f = _Cfunctions.get('libvlc_audio_set_mute', None) or \ + _Cfunction('libvlc_audio_set_mute', ((1,), (1,),), + None, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_set_mute + libvlc_audio_set_mute = f + return f(p_mi, status) + +def libvlc_audio_get_volume(p_mi): + '''Get current audio level. + @param p_mi: media player. + @return: the audio level (int). + ''' + f = _Cfunctions.get('libvlc_audio_get_volume', None) or \ + _Cfunction('libvlc_audio_get_volume', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_volume + libvlc_audio_get_volume = f + return f(p_mi) + +def libvlc_audio_set_volume(p_mi, i_volume): + '''Set current audio level. + @param p_mi: media player. + @param i_volume: the volume (int). + @return: 0 if the volume was set, -1 if it was out of range. + ''' + f = _Cfunctions.get('libvlc_audio_set_volume', None) or \ + _Cfunction('libvlc_audio_set_volume', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_set_volume + libvlc_audio_set_volume = f + return f(p_mi, i_volume) + +def libvlc_audio_get_track_count(p_mi): + '''Get number of available audio tracks. + @param p_mi: media player. + @return: the number of available audio tracks (int), or -1 if unavailable. + ''' + f = _Cfunctions.get('libvlc_audio_get_track_count', None) or \ + _Cfunction('libvlc_audio_get_track_count', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_track_count + libvlc_audio_get_track_count = f + return f(p_mi) + +def libvlc_audio_get_track_description(p_mi): + '''Get the description of available audio tracks. + @param p_mi: media player. + @return: list with description of available audio tracks, or NULL. + ''' + f = _Cfunctions.get('libvlc_audio_get_track_description', None) or \ + _Cfunction('libvlc_audio_get_track_description', ((1,),), + ctypes.POINTER(TrackDescription), MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_track_description + libvlc_audio_get_track_description = f + return f(p_mi) + +def libvlc_audio_get_track(p_mi): + '''Get current audio track. + @param p_mi: media player. + @return: the audio track (int), or -1 if none. + ''' + f = _Cfunctions.get('libvlc_audio_get_track', None) or \ + _Cfunction('libvlc_audio_get_track', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_track + libvlc_audio_get_track = f + return f(p_mi) + +def libvlc_audio_set_track(p_mi, i_track): + '''Set current audio track. + @param p_mi: media player. + @param i_track: the track (int). + @return: 0 on success, -1 on error. + ''' + f = _Cfunctions.get('libvlc_audio_set_track', None) or \ + _Cfunction('libvlc_audio_set_track', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_set_track + libvlc_audio_set_track = f + return f(p_mi, i_track) + +def libvlc_audio_get_channel(p_mi): + '''Get current audio channel. + @param p_mi: media player. + @return: the audio channel See libvlc_audio_output_channel_t. + ''' + f = _Cfunctions.get('libvlc_audio_get_channel', None) or \ + _Cfunction('libvlc_audio_get_channel', ((1,),), + ctypes.c_int, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_channel + libvlc_audio_get_channel = f + return f(p_mi) + +def libvlc_audio_set_channel(p_mi, channel): + '''Set current audio channel. + @param p_mi: media player. + @param channel: the audio channel, See libvlc_audio_output_channel_t. + @return: 0 on success, -1 on error. + ''' + f = _Cfunctions.get('libvlc_audio_set_channel', None) or \ + _Cfunction('libvlc_audio_set_channel', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_set_channel + libvlc_audio_set_channel = f + return f(p_mi, channel) + +def libvlc_audio_get_delay(p_mi): + '''Get current audio delay. + @param p_mi: media player. + @return: the audio delay (microseconds). + @version: LibVLC 1.1.1 or later. + ''' + f = _Cfunctions.get('libvlc_audio_get_delay', None) or \ + _Cfunction('libvlc_audio_get_delay', ((1,),), + ctypes.c_int64, MediaPlayer) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_get_delay + libvlc_audio_get_delay = f + return f(p_mi) + +def libvlc_audio_set_delay(p_mi, i_delay): + '''Set current audio delay. The audio delay will be reset to zero each time the media changes. + @param p_mi: media player. + @param i_delay: the audio delay (microseconds). + @return: 0 on success, -1 on error. + @version: LibVLC 1.1.1 or later. + ''' + f = _Cfunctions.get('libvlc_audio_set_delay', None) or \ + _Cfunction('libvlc_audio_set_delay', ((1,), (1,),), + ctypes.c_int, MediaPlayer, ctypes.c_int64) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_set_delay + libvlc_audio_set_delay = f + return f(p_mi, i_delay) + +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, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_release + libvlc_vlm_release = f + 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,),), + 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) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_add_broadcast + libvlc_vlm_add_broadcast = f + 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,),), + 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) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_add_vod + libvlc_vlm_add_vod = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_del_media + libvlc_vlm_del_media = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_set_enabled + libvlc_vlm_set_enabled = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_set_output + libvlc_vlm_set_output = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_set_input + libvlc_vlm_set_input = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_add_input + libvlc_vlm_add_input = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_set_loop + libvlc_vlm_set_loop = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_set_mux + libvlc_vlm_set_mux = f + 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,),), + 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) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_change_media + libvlc_vlm_change_media = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_play_media + libvlc_vlm_play_media = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_stop_media + libvlc_vlm_stop_media = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_pause_media + libvlc_vlm_pause_media = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_float) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_seek_media + libvlc_vlm_seek_media = f + 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 NULL on error. + ''' + f = _Cfunctions.get('libvlc_vlm_show_media', None) or \ + _Cfunction('libvlc_vlm_show_media', ((1,), (1,),), + ctypes.c_char_p, Instance, ctypes.c_char_p) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_show_media + libvlc_vlm_show_media = f + 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,),), + ctypes.c_float, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_position + libvlc_vlm_get_media_instance_position = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_time + libvlc_vlm_get_media_instance_time = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_length + libvlc_vlm_get_media_instance_length = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_rate + libvlc_vlm_get_media_instance_rate = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_title + libvlc_vlm_get_media_instance_title = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_chapter + libvlc_vlm_get_media_instance_chapter = f + 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,),), + ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_media_instance_seekable + libvlc_vlm_get_media_instance_seekable = f + 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,),), + EventManager, Instance) + if not __debug__: # i.e. python -O or -OO + global libvlc_vlm_get_event_manager + libvlc_vlm_get_event_manager = f + return f(p_instance) + + +# 3 function(s) blacklisted: +# libvlc_set_exit_handler +# libvlc_video_set_callbacks +# libvlc_video_set_format_callbacks + +# 12 function(s) not wrapped as methods: +# libvlc_audio_output_list_release +# libvlc_clearerr +# libvlc_errmsg +# libvlc_event_type_name +# libvlc_free +# libvlc_get_changeset +# libvlc_get_compiler +# libvlc_get_version +# libvlc_module_description_list_release +# libvlc_new +# libvlc_new_with_builtins +# libvlc_track_description_release + +# Start of footer.py # + +# Backward compatibility +def callbackmethod(callback): + """Now obsolete @callbackmethod decorator.""" + return callback + +# Version functions +def _dot2int(v): + '''(INTERNAL) Convert 'i.i.i[.i]' str to int. + ''' + t = [int(i) for i in v.split('.')] + if len(t) == 3: + t.append(0) + elif len(t) != 4: + raise ValueError('"i.i.i[.i]": %r' % (v,)) + if min(t) < 0 or max(t) > 255: + raise ValueError('[0..255]: %r' % (v,)) + i = t.pop(0) + while t: + i = (i << 8) + t.pop(0) + return i + +def hex_version(): + """Return the version of these bindings in hex or 0 if unavailable. + """ + try: + return _dot2int(__version__.split('-')[-1]) + except (NameError, ValueError): + return 0 + +def libvlc_hex_version(): + """Return the libvlc version in hex or 0 if unavailable. + """ + try: + return _dot2int(libvlc_get_version().split()[0]) + except ValueError: + return 0 + + +def debug_callback(event, *args, **kwds): + '''Example callback, useful for debugging. + ''' + l = ['event %s' % (event.type,)] + if args: + l.extend(map(str, args)) + if kwds: + l.extend(sorted('%s=%s' % t for t in kwds.items())) + print('Debug callback (%s)' % ', '.join(l)) + +if __name__ == '__main__': + + try: + from msvcrt import getch + except ImportError: + import termios + import tty + + def getch(): # getchar(), getc(stdin) #PYCHOK flake + fd = sys.stdin.fileno() + old = termios.tcgetattr(fd) + try: + tty.setraw(fd) + ch = sys.stdin.read(1) + finally: + termios.tcsetattr(fd, termios.TCSADRAIN, old) + return ch + + def end_callback(event): + print('End of media stream (event %s)' % event.type) + sys.exit(0) + + echo_position = False + def pos_callback(event, player): + if echo_position: + sys.stdout.write('\r%s to %.2f%% (%.2f%%)' % (event.type, + event.u.new_position * 100, + player.get_position() * 100)) + sys.stdout.flush() + + def print_version(): + """Print libvlc version""" + try: + print('Build date: %s (%#x)' % (build_date, hex_version())) + print('LibVLC version: %s (%#x)' % (libvlc_get_version(), libvlc_hex_version())) + print('LibVLC compiler: %s' % libvlc_get_compiler()) + if plugin_path: + print('Plugin path: %s' % plugin_path) + except: + print('Error: %s' % sys.exc_info()[1]) + + if sys.argv[1:] and sys.argv[1] not in ('-h', '--help'): + + movie = os.path.expanduser(sys.argv[1]) + if not os.access(movie, os.R_OK): + print('Error: %s file not readable' % movie) + sys.exit(1) + + instance = Instance() + try: + media = instance.media_new(movie, 'sub-filter=marq') # load marqee option + except NameError: + print('NameError: %s (%s vs LibVLC %s)' % (sys.exc_info()[1], + __version__, + libvlc_get_version())) + sys.exit(1) + player = instance.media_player_new() + player.set_media(media) + player.play() + + # Some marquee examples. Marquee requires 'sub-filter=marq' in the + # media_new() call above. See also the Media.add_options method + # and + player.video_set_marquee_int(VideoMarqueeOption.Enable, 1) + player.video_set_marquee_int(VideoMarqueeOption.Size, 24) # pixels + player.video_set_marquee_int(VideoMarqueeOption.Position, Position.Bottom) + if True: # only one marquee can be specified + player.video_set_marquee_int(VideoMarqueeOption.Timeout, 5000) # millisec, 0==forever + t = media.get_mrl() # movie + else: # update marquee text periodically + player.video_set_marquee_int(VideoMarqueeOption.Timeout, 0) # millisec, 0==forever + player.video_set_marquee_int(VideoMarqueeOption.Refresh, 1000) # millisec (or sec?) + ##t = '$L / $D or $P at $T' + t = '%Y-%m-%d %H:%M:%S' + player.video_set_marquee_string(VideoMarqueeOption.Text, t) + + # Some event manager examples. Note, the callback can be any Python + # callable and does not need to be decorated. Optionally, specify + # any number of positional and/or keyword arguments to be passed + # to the callback (in addition to the first one, an Event instance). + event_manager = player.event_manager() + event_manager.event_attach(EventType.MediaPlayerEndReached, end_callback) + event_manager.event_attach(EventType.MediaPlayerPositionChanged, pos_callback, player) + + def mspf(): + """Milliseconds per frame.""" + return int(1000 // (player.get_fps() or 25)) + + def print_info(): + """Print information about the media""" + try: + print_version() + media = player.get_media() + print('State: %s' % player.get_state()) + print('Media: %s' % media.get_mrl()) + print('Track: %s/%s' % (player.video_get_track(), player.video_get_track_count())) + print('Current time: %s/%s' % (player.get_time(), media.get_duration())) + print('Position: %s' % player.get_position()) + print('FPS: %s (%d ms)' % (player.get_fps(), mspf())) + print('Rate: %s' % player.get_rate()) + print('Video size: %s' % str(player.video_get_size(0))) # num=0 + print('Scale: %s' % player.video_get_scale()) + print('Aspect ratio: %s' % player.video_get_aspect_ratio()) + #print('Window:' % player.get_hwnd() + except Exception: + print('Error: %s', sys.exc_info()[1]) + + def sec_forward(): + """Go forward one sec""" + player.set_time(player.get_time() + 1000) + + def sec_backward(): + """Go backward one sec""" + player.set_time(player.get_time() - 1000) + + def frame_forward(): + """Go forward one frame""" + player.set_time(player.get_time() + mspf()) + + def frame_backward(): + """Go backward one frame""" + player.set_time(player.get_time() - mspf()) + + def print_help(): + """Print help""" + print('Single-character commands:') + for k, m in sorted(keybindings.items()): + m = (m.__doc__ or m.__name__).splitlines()[0] + print(' %s: %s.' % (k, m.rstrip('.'))) + print('0-9: go to that fraction of the movie') + + def quit_app(): + """Stop and exit""" + sys.exit(0) + + def toggle_echo_position(): + """Toggle echoing of media position""" + global echo_position + echo_position = not echo_position + + keybindings = { + ' ': player.pause, + '+': sec_forward, + '-': sec_backward, + '.': frame_forward, + ',': frame_backward, + 'f': player.toggle_fullscreen, + 'i': print_info, + 'p': toggle_echo_position, + 'q': quit_app, + '?': print_help, + } + + print('Press q to quit, ? to get help.%s' % os.linesep) + while True: + k = getch().decode('utf8') # Python 3+ + print('> %s' % k) + if k in keybindings: + keybindings[k]() + elif k.isdigit(): + # jump to fraction of the movie. + player.set_position(float('0.'+k)) + + else: + print('Usage: %s ' % sys.argv[0]) + print('Once launched, type ? for help.') + print('') + print_version() diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py new file mode 100644 index 000000000..a6c132ebb --- /dev/null +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -0,0 +1,49 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 + +############################################################################### +# OpenLP - Open Source Lyrics Projection # +# --------------------------------------------------------------------------- # +# Copyright (c) 2008-2011 Raoul Snyman # +# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # +# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # +# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # +# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # +# --------------------------------------------------------------------------- # +# 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; version 2 of the License. # +# # +# 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., 59 # +# Temple Place, Suite 330, Boston, MA 02111-1307 USA # +############################################################################### + +from openlp.plugins.media.lib import MediaController + +class WebkitController(MediaController): + """ + """ + def __init__(self): + pass + + def load(self, display, path, volume): + pass + + def play(self, display): + self.display[u'live'] + + def pause(self): + pass + + def stop(self): + pass + + def seek(self): + pass diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py new file mode 100644 index 000000000..b8b7f8e45 --- /dev/null +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -0,0 +1,77 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 + +############################################################################### +# OpenLP - Open Source Lyrics Projection # +# --------------------------------------------------------------------------- # +# Copyright (c) 2008-2011 Raoul Snyman # +# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # +# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # +# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # +# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # +# --------------------------------------------------------------------------- # +# 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; version 2 of the License. # +# # +# 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., 59 # +# Temple Place, Suite 330, Boston, MA 02111-1307 USA # +############################################################################### + +from openlp.plugins.media.lib import MediaController + +class WebkitController(MediaController): + """ + """ + def __init__(self, parent): + self.parent = parent + MediaController.__init__(self, parent) + self.isFlash = False + + def load(self, display, path, volume): + vol = float(volume) / float(10) + display.webView.setVisible(True) + display.phononWidget.setVisible(False) + if path.endswith(u'.swf'): + js = u'show_flash("load","%s");' % \ + (path.replace(u'\\', u'\\\\')) + self.isFlash = True + else: + js = u'show_video("init", "%s", %s, false); show_video("play");' % \ + (path.replace(u'\\', u'\\\\'), str(vol)) + self.isFlash = False + display.frame.evaluateJavaScript(js) + + def play(self, display): + if self.isFlash: + display.frame.evaluateJavaScript(u'show_flash("play","");') +# display.frame.evaluateJavaScript(u'show_video("stop");') + else: +# display.frame.evaluateJavaScript(u'show_flash("stop","");') + display.frame.evaluateJavaScript(u'show_video("play");') + + + def pause(self, display): + if self.isFlash: + display.frame.evaluateJavaScript(u'show_flash("pause","");') + else: + display.frame.evaluateJavaScript(u'show_video("pause");') + + def stop(self, display): + if self.isFlash: + display.frame.evaluateJavaScript(u'show_flash("stop","");') + else: + display.frame.evaluateJavaScript(u'show_video("stop");') + + def seek(self, display): + pass + + def reset(self, display): + display.frame.evaluateJavaScript(u'show_video("close");') diff --git a/openlp/plugins/media/mediaplugin.py b/openlp/plugins/media/mediaplugin.py index e01e6846d..99eb5b94d 100644 --- a/openlp/plugins/media/mediaplugin.py +++ b/openlp/plugins/media/mediaplugin.py @@ -30,7 +30,7 @@ import mimetypes from PyQt4.phonon import Phonon from openlp.core.lib import Plugin, StringContent, build_icon, translate -from openlp.plugins.media.lib import MediaMediaItem, MediaTab +from openlp.plugins.media.lib import MediaMediaItem, MediaTab, MediaManager log = logging.getLogger(__name__) @@ -68,6 +68,7 @@ class MediaPlugin(Plugin): self._addToList(self.audio_extensions_list, mimetype) elif mimetype.startswith(u'video/'): self._addToList(self.video_extensions_list, mimetype) + self.mediaManager = MediaManager(self) def _addToList(self, list, mimetype): # Add all extensions which mimetypes provides us for supported types. From 942fe8a1413c43a1ac79d773bbb73e93fe75880a Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Tue, 19 Apr 2011 14:03:36 +0200 Subject: [PATCH 02/41] further changes --- openlp/core/ui/maindisplay.py | 130 ------------------ openlp/core/ui/slidecontroller.py | 7 - openlp/plugins/media/lib/__init__.py | 26 ++-- openlp/plugins/media/lib/mediacontroller.py | 137 +++++++++++-------- openlp/plugins/media/lib/mediaitem.py | 4 +- openlp/plugins/media/lib/phononcontroller.py | 31 +++-- openlp/plugins/media/lib/vlccontroller.py | 12 +- openlp/plugins/media/lib/webkitcontroller.py | 12 +- 8 files changed, 140 insertions(+), 219 deletions(-) diff --git a/openlp/core/ui/maindisplay.py b/openlp/core/ui/maindisplay.py index 63e1c8282..36372c17c 100644 --- a/openlp/core/ui/maindisplay.py +++ b/openlp/core/ui/maindisplay.py @@ -99,25 +99,6 @@ class MainDisplay(DisplayWidget): self.screen = self.screens.current self.setVisible(False) self.setGeometry(self.screen[u'size']) -# self.videoWidget = Phonon.VideoWidget(self) -# self.videoWidget.setVisible(False) -# self.videoWidget.setGeometry(QtCore.QRect(0, 0, -# self.screen[u'size'].width(), self.screen[u'size'].height())) -# log.debug(u'Setup Phonon for monitor %s' % self.screens.monitor_number) -# self.mediaObject = Phonon.MediaObject(self) -# self.audio = Phonon.AudioOutput(Phonon.VideoCategory, self.mediaObject) -# Phonon.createPath(self.mediaObject, self.videoWidget) -# Phonon.createPath(self.mediaObject, self.audio) -# QtCore.QObject.connect(self.mediaObject, -# QtCore.SIGNAL(u'stateChanged(Phonon::State, Phonon::State)'), -# self.videoState) -# QtCore.QObject.connect(self.mediaObject, -# QtCore.SIGNAL(u'finished()'), -# self.videoFinished) -# QtCore.QObject.connect(self.mediaObject, -# QtCore.SIGNAL(u'tick(qint64)'), -# self.videoTick) - log.debug(u'Setup webView for monitor %s' % self.screens.monitor_number) self.webView = QtWebKit.QWebView(self) self.webView.setGeometry(0, 0, @@ -179,13 +160,6 @@ class MainDisplay(DisplayWidget): log.debug( u'Finished setup for monitor %s' % self.screens.monitor_number) - def videoHelper(self, newState, oldState): - """ - Start the video at a predetermined point. - """ - if type(newState) == Phonon.State: - print "Phonon State alt:%d, neu:%d" % (oldState, newState) - def text(self, slide): """ Add the slide text from slideController @@ -292,107 +266,6 @@ class MainDisplay(DisplayWidget): if self.isLive: Receiver.send_message(u'maindisplay_active') -# def resetVideo(self): -# """ -# Used after Video plugin has changed the background -# """ -# log.debug(u'resetVideo') -# if self.phononActive: -# self.mediaObject.stop() -# self.mediaObject.clearQueue() -# self.webView.setVisible(True) -# self.videoWidget.setVisible(False) -# self.phononActive = False -# else: -# self.frame.evaluateJavaScript(u'show_video("close");') -# self.override = {} -# # Update the preview frame. -# if self.isLive: -# Receiver.send_message(u'maindisplay_active') -# -# def videoPlay(self): -# """ -# Responds to the request to play a loaded video -# """ -# log.debug(u'videoPlay') -# self.frame.evaluateJavaScript(u'show_flash("play","");') -# self.frame.evaluateJavaScript(u'show_video("stop");') -# return -# if self.phononActive: -# self.mediaObject.play() -# else: -# self.frame.evaluateJavaScript(u'show_video("play");') -# # show screen -# if self.isLive: -# self.setVisible(True) -# -# def videoPause(self): -# """ -# Responds to the request to pause a loaded video -# """ -# log.debug(u'videoPause') -# if self.phononActive: -# self.mediaObject.pause() -# else: -# self.frame.evaluateJavaScript(u'show_video("pause");') -# -# def videoStop(self): -# """ -# Responds to the request to stop a loaded video -# """ -# log.debug(u'videoStop') -# if self.phononActive: -# self.mediaObject.stop() -# else: -# self.frame.evaluateJavaScript(u'show_video("stop");') -# -# def videoVolume(self, volume): -# """ -# Changes the volume of a running video -# """ -# log.debug(u'videoVolume %d' % volume) -# vol = float(volume) / float(10) -# if self.phononActive: -# self.audio.setVolume(vol) -# else: -# self.frame.evaluateJavaScript(u'show_video(null, null, %s);' % -# str(vol)) -# -# def video(self, videoPath, volume, isBackground=False): -# """ -# Loads and starts a video to run with the option of sound -# """ -# log.debug(u'video') -# Receiver.send_message(u'media_video', [self, videoPath, volume, isBackground]) -# return self.preview() -# -# def videoState(self, newState, oldState): -# """ -# Start the video at a predetermined point. -# """ -# if newState == Phonon.PlayingState \ -# and oldState != Phonon.PausedState \ -# and self.serviceItem.start_time > 0: -# # set start time in milliseconds -# self.mediaObject.seek(self.serviceItem.start_time * 1000) -# -# def videoFinished(self): -# """ -# Blank the Video when it has finished so the final frame is not left -# hanging -# """ -# self.videoStop() -# self.hideDisplay(HideMode.Blank) -# self.phononActive = False -# self.videoHide = True -# -# def videoTick(self, tick): -# """ -# Triggered on video tick every 200 milli seconds -# """ -# if tick > self.serviceItem.end_time * 1000: -# self.videoFinished() -# def isWebLoaded(self): """ Called by webView event to show display is fully loaded @@ -503,8 +376,6 @@ class MainDisplay(DisplayWidget): Store the images so they can be replaced when required """ log.debug(u'hideDisplay mode = %d', mode) -# if self.phononActive: -# self.videoPause() Receiver.send_message(u'media_pause', self) if mode == HideMode.Screen: self.frame.evaluateJavaScript(u'show_blank("desktop");') @@ -532,7 +403,6 @@ class MainDisplay(DisplayWidget): self.setVisible(True) if self.phononActive: self.webView.setVisible(False) - #self.videoPlay() Receiver.send_message(u'media_play', self) self.hideMode = None # Trigger actions when display is active again diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index 1984cecc9..90f9f07ee 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -1034,7 +1034,6 @@ class SlideController(QtGui.QWidget): log.debug(u'SlideController onMediaStart') file = os.path.join(item.get_frame_path(), item.get_frame_title()) if self.isLive: - #self.display.video(file, self.volume) Receiver.send_message(u'media_video', [self.display, file, self.volume, False]) self.volumeSlider.setValue(self.volume) else: @@ -1051,7 +1050,6 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController mediaSeek') self.seekPos = self.seekSlider.value() - #self.display.videoVolume(self.volume) Receiver.send_message(u'media_seek', [self.display, self.seekPos]) def mediaVolume(self): @@ -1060,7 +1058,6 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController mediaVolume') self.volume = self.volumeSlider.value() - #self.display.videoVolume(self.volume) Receiver.send_message(u'media_volume', [self.display, self.volume]) @@ -1070,7 +1067,6 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaPause') if self.isLive: - #self.display.videoPause() Receiver.send_message(u'media_pause', self.display) else: self.mediaObject.pause() @@ -1082,7 +1078,6 @@ class SlideController(QtGui.QWidget): log.debug(u'SlideController onMediaPlay') if self.isLive: Receiver.send_message(u'media_play', self.display) - #self.display.videoPlay() else: self.slidePreview.hide() self.video.show() @@ -1094,7 +1089,6 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaStop') if self.isLive: - #self.display.videoStop() Receiver.send_message(u'media_stop', self.display) else: self.mediaObject.stop() @@ -1108,7 +1102,6 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaClose') if self.isLive: - #self.display.resetVideo() Receiver.send_message(u'media_reset', self.display) else: self.mediaObject.stop() diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 3a2385ded..5e078763d 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -24,8 +24,6 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -from PyQt4 import QtCore - class MediaBackends(object): """ An enumeration for possible Backends. @@ -34,16 +32,25 @@ class MediaBackends(object): Phonon = 1 Vlc = 2 +class MediaStates(object): + """ + An enumeratioin for possible States of the Media Player + (copied from Phonon::State + """ + LoadingState = 0 + StoppedState = 1 + PlayingState = 2 + PausedState = 4 + OffState = 6 + class MediaController(object): """ + Specialiced MediaController class + to reflect Features of the related backend """ def __init__(self, parent): self.parent = parent - self.state = 0 - self.Timer = QtCore.QTimer() - QtCore.QObject.connect(self.Timer, - QtCore.SIGNAL("timeout()"), self.updatePlayer) - + self.state = MediaStates.OffState def load(self, display, path, volume): pass @@ -63,7 +70,10 @@ class MediaController(object): def reset(self, display): pass - def updatePlayer(self): + def updateUI(self, display): + pass + + def getSupportedFileTypes(self): pass from mediaitem import MediaMediaItem diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 7595a80b3..31d9f37cf 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -35,7 +35,7 @@ from PyQt4 import QtCore, QtGui from PyQt4.phonon import Phonon from openlp.core.lib import Receiver -from openlp.plugins.media.lib import MediaBackends +from openlp.plugins.media.lib import MediaBackends, MediaStates from webkitcontroller import WebkitController from phononcontroller import PhononController @@ -43,6 +43,45 @@ log = logging.getLogger(__name__) class MediaManager(object): """ + The implementation of a Media Manager + The idea is to separate the media related implementation into the plugin files + and unify the access from other parts of code + The media manager adds an own class for every type of backend + Currently these are QtWebkit, Phonon and planed Vlc. + On the other hand currently the previewController display only use phonon for media output. + So I would suggest to rename the maindisplay.py to display.py and modify the code, + so that the display class can be used for the maindisplay as well as for the previewController display. + + Workflow idea: + - OpenLP is starting + - Live display and preview display are call setup + - Live display and preview display send signal with a pointer to their own to the media controller ('media_set_display') + - media controller register all available displays and create for each display all types of media backends (see setDisplay) + - in the OpenLP configuration dialog the user no longe will decide between using Webkit OR Phonon. + - instead of this there is a list widget with all available backends and the user can switch off/on the backends + and change the priority order + (this is necessary, because of not all backends can play all media files and text over video is currently only with QtWebkit possible) + - later on, if the user add a new media service item the signal ('media_video') will be send + - as a result of this the media manager checks which controller is needed for this filetyp + and assign the related backend controller to the right display + - Now all related media stuff (play, pause, ...) will be routed to the related backend controller and there processed + - if one or more medias loaded a generic 200ms Timer will be started peridiodically to refresh the UI + - Signal ('media_reset') will close the related video and disconnect the backend from the display + + Advantages: + - clean and easy interface from other parts of code (slidecontroller and display classes) + - more and better configuration possibilities inside the special backend controllers + - same handling for preview and live display (or later on other additionally displays with their slide controllers) + + Disadvantages: + - because of there will be display widgets created outside of the maindisplay.py file it is more complicate to read the code + - some more signals are send arround the system + + Notices: + - the flash support uses the flash plugin from Mozilla. So there is a js-check that this plugin is installed. + - maybe there would be the installed flashplugin of the IE possible could also used, but I'm not sure about this? + - I would suggest to not hide the main toolbar in case of media, instead of this the media toolbar should be + visible as second toolbar (so the screen can be blanked also during a running video, ...) """ def __init__(self, parent): self.parent = parent @@ -56,6 +95,11 @@ class MediaManager(object): self.displayPhononController = PhononController(self) #self.displayVlcController = VlcController(self) + self.Timer = QtCore.QTimer() + self.Timer.setInterval(200) + + QtCore.QObject.connect(self.Timer, + QtCore.SIGNAL("timeout()"), self.videoState) QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'media_set_display'), self.setDisplay) QtCore.QObject.connect(Receiver.get_receiver(), @@ -73,9 +117,23 @@ class MediaManager(object): QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'media_reset'), self.videoReset) + def videoState(self): + """ + check if there is an assigned media backend and do some + updating stuff (e.g. update the UI) + """ + isAnyonePlaying = False + if len(self.curDisplayMediaController.keys()) == 0: + self.Timer.stop() + else: + for display in self.curDisplayMediaController.keys(): + self.curDisplayMediaController[display].updateUI(display) + if self.curDisplayMediaController[display].state == MediaStates.PlayingState: + isAnyonePlaying = True + if not isAnyonePlaying: + self.Timer.stop() def setDisplay(self, display): - print display #self.setupVlcController(display) self.setupPhononController(display) self.setupWebkitController(display) @@ -95,18 +153,6 @@ class MediaManager(object): Phonon.createPath(display.mediaObject, display.phononWidget) Phonon.createPath(display.mediaObject, display.audio) display.phononWidget.raise_() - QtCore.QObject.connect(display.mediaObject, - QtCore.SIGNAL(u'stateChanged(Phonon::State, Phonon::State)'), - display.videoHelper) -# display.mediaObject.stateChanged.connect(self.videoState) -# QtCore.QObject.connect(display.mediaObject, -# QtCore.SIGNAL(u'finished()'), -# self.videoFinished) -# QtCore.QObject.connect(display.mediaObject, -# QtCore.SIGNAL(u'tick(qint64)'), -# self.videoTick) - - #self.displayPhononController[display] = display.mediaObject def setupVlcController(self, display): display.vlcWidget = QtGui.QWidget(display) @@ -128,7 +174,6 @@ class MediaManager(object): display.vlcWidget.setGeometry(QtCore.QRect(0, 0, display.screen[u'size'].width(), display.screen[u'size'].height())) display.vlcWidget.raise_() - #self.displayVlcController[display] = player def video(self, msg): """ @@ -146,46 +191,30 @@ class MediaManager(object): display.override[u'theme'] = u'' display.override[u'video'] = True vol = float(volume) / float(10) + self.checkFileType(display, videoPath, isBackground) + self.curDisplayMediaController[display].load(display, videoPath, volume) + if display.isLive: + Receiver.send_message(u'maindisplay_active') + + def checkFileType(self, display, videoPath, isBackground): + """ + Used to choose the right media backend type + from the prioritized backend list + """ usePhonon = QtCore.QSettings().value( u'media/use phonon', QtCore.QVariant(True)).toBool() - if usePhonon: + if usePhonon and not isBackground: self.curDisplayMediaController[display] = self.displayPhononController display.phononWidget.setVisible(True) display.webView.setVisible(False) - else: self.curDisplayMediaController[display] = self.displayWebkitController display.phononWidget.setVisible(False) display.webView.setVisible(True) + if len(self.curDisplayMediaController) > 0: + if not self.Timer.isActive(): + self.Timer.start() - self.curDisplayMediaController[display].load(display, videoPath, volume) - if display.isLive: - Receiver.send_message(u'maindisplay_active') - return - if isBackground or not display.usePhonon: - if videoPath.endswith(u'.swf'): - js = u'show_flash("load","%s");' % \ - (videoPath.replace(u'\\', u'\\\\')) - else: - js = u'show_video("init", "%s", %s, true); show_video("play");' % \ - (videoPath.replace(u'\\', u'\\\\'), str(vol)) - display.frame.evaluateJavaScript(js) - else: - display.phononActive = True - display.mediaObject.stop() - display.mediaObject.clearQueue() - display.mediaObject.setCurrentSource(Phonon.MediaSource(videoPath)) - # Need the timer to trigger set the trigger to 200ms - # Value taken from web documentation. - if display.serviceItem.end_time != 0: - display.mediaObject.setTickInterval(200) - display.mediaObject.play() - display.webView.setVisible(False) - display.phononWidget.setVisible(True) - display.audio.setVolume(vol) - # Update the preview frame. - if display.isLive: - Receiver.send_message(u'maindisplay_active') def resetVideo(self): """ @@ -200,6 +229,7 @@ class MediaManager(object): display.phononActive = False else: display.frame.evaluateJavaScript(u'show_video("close");') + display.frame.evaluateJavaScript(u'show_flash("close");') display.override = {} # Update the preview frame. if display.isLive: @@ -213,6 +243,8 @@ class MediaManager(object): self.curDisplayMediaController[display].play(display) # show screen if display.isLive: + if not self.Timer.isActive(): + self.Timer.start() display.setVisible(True) def videoPause(self, display): @@ -229,10 +261,8 @@ class MediaManager(object): Responds to the request to stop a loaded video """ log.debug(u'videoStop') - print type(display) if type(display) is types.ListType: return - print display, self.curDisplayMediaController if display in self.curDisplayMediaController: self.curDisplayMediaController[display].stop(display) if display.isLive: @@ -253,17 +283,6 @@ class MediaManager(object): display.frame.evaluateJavaScript(u'show_video(null, null, %s);' % str(vol)) - def videoState(self, newState, oldState): - """ - Start the video at a predetermined point. - """ - print "display", self.sender() -# if newState == Phonon.PlayingState \ -# and oldState != Phonon.PausedState \ -# and self.serviceItem.start_time > 0: -# # set start time in milliseconds -# self.mediaObject.seek(self.serviceItem.start_time * 1000) - def videoFinished(self): """ Blank the Video when it has finished so the final frame is not left @@ -296,5 +315,7 @@ class MediaManager(object): Responds to the request to reset a loaded video """ log.debug(u'videoReset') + print "videoReset" if display in self.curDisplayMediaController: self.curDisplayMediaController[display].reset(display) + self.curDisplayMediaController[display] diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index f1bd0aea4..46b39ac32 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -89,7 +89,9 @@ class MediaMediaItem(MediaManagerItem): Called to reset the Live backgound with the media selected, """ self.resetAction.setVisible(False) - self.parent.liveController.display.resetVideo() + #self.parent.liveController.display.resetVideo() + Receiver.send_message(u'media_reset', + self.parent.liveController.display) def videobackgroundReplaced(self): """ diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index 40bbb275a..1e78b005f 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -27,10 +27,12 @@ from PyQt4.phonon import Phonon -from openlp.plugins.media.lib import MediaController +from openlp.plugins.media.lib import MediaController, MediaStates class PhononController(MediaController): """ + Specialiced MediaController class + to reflect Features of the Phonon backend """ def __init__(self, parent): self.parent = parent @@ -48,20 +50,20 @@ class PhononController(MediaController): display.mediaObject.setTickInterval(200) display.mediaObject.play() display.audio.setVolume(vol) - self.Timer.setInterval(200) + self.state = MediaStates.PlayingState def play(self, display): display.mediaObject.play() - display.parent.seekSlider.setMaximum(display.mediaObject.totalTime()) + self.state = MediaStates.PlayingState def pause(self, display): display.mediaObject.pause() - self.Timer.stop() + self.state = MediaStates.PausedState def stop(self, display): display.mediaObject.stop() - self.Timer.stop() + self.state = MediaStates.StoppedState def seek(self, display, seekVal): print "seek" @@ -73,9 +75,18 @@ class PhononController(MediaController): display.webView.setVisible(True) display.phononWidget.setVisible(False) display.phononActive = False - self.Timer.stop() - def updatePlayer(self): - for controller in self.parent.curDisplayMediaController: - if controller.getState() == 1: - pass + def updateUI(self, display): + display.parent.seekSlider.setMaximum(display.mediaObject.totalTime()) + if not display.parent.seekSlider.isSliderDown(): + display.parent.seekSlider.setSliderPosition(display.mediaObject.currentTime()) +# if newState == Phonon.PlayingState \ +# and oldState != Phonon.PausedState \ +# and self.serviceItem.start_time > 0: +# # set start time in milliseconds +# self.mediaObject.seek(self.serviceItem.start_time * 1000) + + pass + + def getSupportedFileTypes(self): + pass diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index a6c132ebb..5bbb438d4 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -27,8 +27,10 @@ from openlp.plugins.media.lib import MediaController -class WebkitController(MediaController): +class VlcController(MediaController): """ + Specialiced MediaController class + to reflect Features of the Vlc backend """ def __init__(self): pass @@ -45,5 +47,11 @@ class WebkitController(MediaController): def stop(self): pass - def seek(self): + def seek(self, display, seekVal): + pass + + def updateUI(self): + pass + + def getSupportedFileTypes(self): pass diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index b8b7f8e45..962440a20 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -29,6 +29,8 @@ from openlp.plugins.media.lib import MediaController class WebkitController(MediaController): """ + Specialiced MediaController class + to reflect Features of the QtWebkit backend """ def __init__(self, parent): self.parent = parent @@ -52,9 +54,7 @@ class WebkitController(MediaController): def play(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("play","");') -# display.frame.evaluateJavaScript(u'show_video("stop");') else: -# display.frame.evaluateJavaScript(u'show_flash("stop","");') display.frame.evaluateJavaScript(u'show_video("play");') @@ -70,8 +70,14 @@ class WebkitController(MediaController): else: display.frame.evaluateJavaScript(u'show_video("stop");') - def seek(self, display): + def seek(self, display, seekVal): pass def reset(self, display): display.frame.evaluateJavaScript(u'show_video("close");') + + def updateUI(self, display): + pass + + def getSupportedFileTypes(self): + pass From e730dc366f1d1963f3c9a2403c6c95d354382f1c Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Thu, 21 Apr 2011 15:54:44 +0200 Subject: [PATCH 03/41] add vlc support --- openlp/core/lib/htmlbuilder.py | 9 ++- openlp/plugins/media/lib/mediacontroller.py | 44 ++++++++------- openlp/plugins/media/lib/phononcontroller.py | 1 + openlp/plugins/media/lib/vlccontroller.py | 59 ++++++++++++++++---- openlp/plugins/media/lib/webkitcontroller.py | 20 +++++-- 5 files changed, 97 insertions(+), 36 deletions(-) diff --git a/openlp/core/lib/htmlbuilder.py b/openlp/core/lib/htmlbuilder.py index 1b3464fde..b1511eae6 100644 --- a/openlp/core/lib/htmlbuilder.py +++ b/openlp/core/lib/htmlbuilder.py @@ -178,7 +178,14 @@ sup { vid.src = ''; vid2.src = ''; break; - } + case 'length': + return vid.duration; + case 'currentTime': + return vid.currentTime; + case 'seek': + vid.currentTime = path; + break; + } } function show_image(src){ diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 31d9f37cf..200af77bf 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -38,6 +38,7 @@ from openlp.core.lib import Receiver from openlp.plugins.media.lib import MediaBackends, MediaStates from webkitcontroller import WebkitController from phononcontroller import PhononController +from vlccontroller import VlcController log = logging.getLogger(__name__) @@ -93,7 +94,7 @@ class MediaManager(object): self.curDisplayMediaController = {} self.displayWebkitController = WebkitController(self) self.displayPhononController = PhononController(self) - #self.displayVlcController = VlcController(self) + self.displayVlcController = VlcController(self) self.Timer = QtCore.QTimer() self.Timer.setInterval(200) @@ -134,13 +135,12 @@ class MediaManager(object): self.Timer.stop() def setDisplay(self, display): - #self.setupVlcController(display) + self.setupVlcController(display) self.setupPhononController(display) self.setupWebkitController(display) def setupWebkitController(self, display): - #self.displayWebkitController[display] = display.webView display.webView.raise_() def setupPhononController(self, display): @@ -155,22 +155,11 @@ class MediaManager(object): display.phononWidget.raise_() def setupVlcController(self, display): - display.vlcWidget = QtGui.QWidget(display) - instance=vlc.Instance() - self.movieName = None - player=instance.media_player_new(self.movieName) - # 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 == "linux2": # for Linux using the X Server - player.set_xwindow(self.hwnd) - elif sys.platform == "win32": # for Windows - player.set_hwnd(self.hwnd) - elif sys.platform == "darwin": # for MacOS - player.set_agl(self.hwnd) - + display.vlcWidget = QtGui.QFrame(display) + # creating a basic vlc instance + display.vlcInstance = vlc.Instance() + # creating an empty vlc media player + display.vlcMediaPlayer = display.vlcInstance.media_player_new() display.vlcWidget.setGeometry(QtCore.QRect(0, 0, display.screen[u'size'].width(), display.screen[u'size'].height())) display.vlcWidget.raise_() @@ -203,14 +192,29 @@ class MediaManager(object): """ usePhonon = QtCore.QSettings().value( u'media/use phonon', QtCore.QVariant(True)).toBool() - if usePhonon and not isBackground: + useVlc = True + if videoPath.endswith(u'.swf'): + useVlc = False + usePhonon = False + elif videoPath.endswith(u'.wmv'): + useVlc = False + usePhonon = True + + if useVlc: + self.curDisplayMediaController[display] = self.displayVlcController + display.phononWidget.setVisible(False) + display.webView.setVisible(False) + display.vlcWidget.setVisible(True) + elif usePhonon and not isBackground: self.curDisplayMediaController[display] = self.displayPhononController display.phononWidget.setVisible(True) display.webView.setVisible(False) + display.vlcWidget.setVisible(False) else: self.curDisplayMediaController[display] = self.displayWebkitController display.phononWidget.setVisible(False) display.webView.setVisible(True) + display.vlcWidget.setVisible(False) if len(self.curDisplayMediaController) > 0: if not self.Timer.isActive(): self.Timer.start() diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index 1e78b005f..d8b71d29a 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -39,6 +39,7 @@ class PhononController(MediaController): MediaController.__init__(self, parent) def load(self, display, path, volume): + print "load vid in Phonon Controller" display.phononActive = True display.mediaObject.stop() display.mediaObject.clearQueue() diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index 5bbb438d4..7d36a51a4 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -25,33 +25,70 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -from openlp.plugins.media.lib import MediaController +import sys + +from openlp.plugins.media.lib import MediaController, MediaStates class VlcController(MediaController): """ Specialiced MediaController class to reflect Features of the Vlc backend """ - def __init__(self): - pass + def __init__(self, parent): + self.parent = parent + MediaController.__init__(self, parent) def load(self, display, path, volume): - pass + print "load vid in Vlc Controller" + vol = float(volume) / float(10) + + # create the media + display.vlcMedia = display.vlcInstance.media_new(unicode(path)) + # put the media in the media player + display.vlcMediaPlayer.set_media(display.vlcMedia) + + # parse the metadata of the file + display.vlcMedia.parse() + + # 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 == "linux2": # for Linux using the X Server + display.vlcMediaPlayer.set_xwindow(int(display.vlcWidget.winId())) + elif sys.platform == "win32": # for Windows + display.vlcMediaPlayer.set_hwnd(int(display.vlcWidget.winId())) + elif sys.platform == "darwin": # for MacOS + display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) + # start playing + self.play(display) + self.state = MediaStates.PlayingState def play(self, display): - self.display[u'live'] + display.vlcMediaPlayer.play() + self.state = MediaStates.PlayingState - def pause(self): - pass + def pause(self, display): + display.vlcMediaPlayer.pause() + self.state = MediaStates.PausedState - def stop(self): - pass + def stop(self, display): + display.vlcMediaPlayer.stop() + self.state = MediaStates.StoppedState def seek(self, display, seekVal): + if display.vlcMediaPlayer.is_seekable(): + display.vlcMediaPlayer.set_position(seekVal/1000.0) + + def reset(self, display): pass - def updateUI(self): - pass + def updateUI(self, display): + display.parent.seekSlider.setMaximum(1000) + if not display.parent.seekSlider.isSliderDown(): + currentPos = display.vlcMediaPlayer.get_position() * 1000 + display.parent.seekSlider.setSliderPosition(currentPos) def getSupportedFileTypes(self): pass diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index 962440a20..c021b9e7d 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -25,7 +25,7 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -from openlp.plugins.media.lib import MediaController +from openlp.plugins.media.lib import MediaController, MediaStates class WebkitController(MediaController): """ @@ -38,9 +38,11 @@ class WebkitController(MediaController): self.isFlash = False def load(self, display, path, volume): + print "load vid in Webkit Controller" vol = float(volume) / float(10) display.webView.setVisible(True) display.phononWidget.setVisible(False) + display.vlcWidget.setVisible(False) if path.endswith(u'.swf'): js = u'show_flash("load","%s");' % \ (path.replace(u'\\', u'\\\\')) @@ -50,34 +52,44 @@ class WebkitController(MediaController): (path.replace(u'\\', u'\\\\'), str(vol)) self.isFlash = False display.frame.evaluateJavaScript(js) + self.state = MediaStates.PlayingState def play(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("play","");') else: display.frame.evaluateJavaScript(u'show_video("play");') - + self.state = MediaStates.PlayingState def pause(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("pause","");') else: display.frame.evaluateJavaScript(u'show_video("pause");') + self.state = MediaStates.PausedState def stop(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("stop","");') else: display.frame.evaluateJavaScript(u'show_video("stop");') + self.state = MediaStates.StoppedState def seek(self, display, seekVal): - pass + if not self.isFlash: + print seekVal, float(seekVal)/1000 + display.frame.evaluateJavaScript(u'show_video("seek", "%f");' % (float(seekVal)/1000)) def reset(self, display): display.frame.evaluateJavaScript(u'show_video("close");') def updateUI(self, display): - pass + if not self.isFlash: + length = display.frame.evaluateJavaScript(u'show_video("length");') + display.parent.seekSlider.setMaximum(length.toFloat()[0]*1000) + if not display.parent.seekSlider.isSliderDown(): + currentTime = display.frame.evaluateJavaScript(u'show_video("currentTime");') + display.parent.seekSlider.setSliderPosition(currentTime.toFloat()[0]*1000) def getSupportedFileTypes(self): pass From d4162e814c63be525ce7eb65486058466f7f420c Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Tue, 10 May 2011 22:39:17 +0200 Subject: [PATCH 04/41] next steps --- openlp/core/lib/htmlbuilder.py | 18 +- openlp/core/ui/__init__.py | 2 +- openlp/core/ui/maindisplay.py | 27 +- openlp/core/ui/mainwindow.py | 2 +- openlp/core/ui/slidecontroller.py | 88 ++---- openlp/plugins/media/lib/__init__.py | 26 +- openlp/plugins/media/lib/mediacontroller.py | 268 +++++++++---------- openlp/plugins/media/lib/mediaitem.py | 11 +- openlp/plugins/media/lib/phononcontroller.py | 57 ++-- openlp/plugins/media/lib/vlccontroller.py | 47 +++- openlp/plugins/media/lib/webkitcontroller.py | 43 ++- openlp/plugins/media/mediaplugin.py | 9 + 12 files changed, 311 insertions(+), 287 deletions(-) diff --git a/openlp/core/lib/htmlbuilder.py b/openlp/core/lib/htmlbuilder.py index b1511eae6..5e63c9b2c 100644 --- a/openlp/core/lib/htmlbuilder.py +++ b/openlp/core/lib/htmlbuilder.py @@ -325,22 +325,18 @@ sup { if (document.embeds && document.embeds[movieName]) return document.embeds[movieName]; } - else // if (navigator.appName.indexOf("Microsoft Internet")!=-1) - { - return document.getElementById(movieName); - } } function show_flash(state, path){ var text = document.getElementById('flash'); - var flashMovie=getFlashMovieObject("OpenLPFlashMovie"); + var flashMovie = getFlashMovieObject("OpenLPFlashMovie"); var src = "src = 'file:///" + path + "'"; var view_parm = " wmode='opaque'" + - " width='" + window.innerWidth + "'" + - " height='" + window.innerHeight + "'"; + " width='" + window.innerWidth + "'" + + " height='" + window.innerHeight + "'"; var swf_parm = " autostart='false' loop='false' play='false'" + - " hidden='false' swliveconnect='true'" + - " name='OpenLPFlashMovie'>"; + " hidden='false' swliveconnect='true'" + + " name='OpenLPFlashMovie'>"; switch(state){ case 'load': @@ -349,12 +345,10 @@ sup { text.style.visibility = 'visible'; flashMovie.Play(); break; - case 'play': text.style.visibility = 'visible'; flashMovie.Play(); break; - case 'rewind': ret = 'rewind'; alert(' Wert: ' + flashMovie.TGetProperty("/", 4)); @@ -364,7 +358,7 @@ sup { break; case 'stop': flashMovie.StopPlay(); - text.innerHTML = '' + text.innerHTML = ''; text.style.visibility = 'hidden'; break; } diff --git a/openlp/core/ui/__init__.py b/openlp/core/ui/__init__.py index a2985c0b8..c6ac9d35a 100644 --- a/openlp/core/ui/__init__.py +++ b/openlp/core/ui/__init__.py @@ -56,7 +56,7 @@ from firsttimelanguageform import FirstTimeLanguageForm from themeform import ThemeForm from filerenameform import FileRenameForm from starttimeform import StartTimeForm -from maindisplay import MainDisplay +from maindisplay import MainDisplay, Display from servicenoteform import ServiceNoteForm from serviceitemeditform import ServiceItemEditForm from screen import ScreenList diff --git a/openlp/core/ui/maindisplay.py b/openlp/core/ui/maindisplay.py index 0b87cf67e..ff7ad1808 100644 --- a/openlp/core/ui/maindisplay.py +++ b/openlp/core/ui/maindisplay.py @@ -55,6 +55,30 @@ class DisplayWidget(QtGui.QGraphicsView): self.parent = parent self.live = live +class Display(QtGui.QFrame): + """ + This is the display screen for preview Widgets. + """ + def __init__(self, parent): + QtGui.QFrame.__init__(self, parent) + self.parent = parent + + def setup(self): + """ + Set up and build the preview screen + """ + self.webView = QtWebKit.QWebView(self) + self.webView.setGeometry(0, 0, + self.parent.width(), self.parent.height()) + self.webView.settings().setAttribute(QtWebKit.QWebSettings.PluginsEnabled, True) + self.page = self.webView.page() + self.frame = self.page.mainFrame() + screen = {} + screen[u'size'] = self.size() + serviceItem = ServiceItem() + self.webView.setHtml(build_html(serviceItem, screen, + None, None, None)) + self.webView.hide() class MainDisplay(DisplayWidget): """ @@ -103,7 +127,7 @@ class MainDisplay(DisplayWidget): self.webView = QtWebKit.QWebView(self) self.webView.setGeometry(0, 0, self.screen[u'size'].width(), self.screen[u'size'].height()) - self.webView.settings().setAttribute(QtWebKit.QWebSettings.PluginsEnabled,True) + self.webView.settings().setAttribute(QtWebKit.QWebSettings.PluginsEnabled, True) self.page = self.webView.page() self.frame = self.page.mainFrame() QtCore.QObject.connect(self.webView, @@ -156,7 +180,6 @@ class MainDisplay(DisplayWidget): self.primary = False else: self.primary = True - Receiver.send_message(u'media_set_display', self) log.debug( u'Finished setup for monitor %s' % self.screens.monitor_number) diff --git a/openlp/core/ui/mainwindow.py b/openlp/core/ui/mainwindow.py index 32a28d474..60544ccea 100644 --- a/openlp/core/ui/mainwindow.py +++ b/openlp/core/ui/mainwindow.py @@ -979,7 +979,7 @@ class MainWindow(QtGui.QMainWindow, Ui_MainWindow): for fileId, filename in enumerate(recentFilesToDisplay): log.debug('Recent file name: %s', filename) action = base_action(self, u'') - action.setText(u'&%d %s' % + action.setText(u'&%d %s' % (fileId + 1, QtCore.QFileInfo(filename).fileName())) action.setData(QtCore.QVariant(filename)) self.connect(action, QtCore.SIGNAL(u'triggered()'), diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index 68bd9d5e0..d30e7b144 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -33,7 +33,7 @@ from PyQt4.phonon import Phonon from openlp.core.lib import OpenLPToolbar, Receiver, resize_image, \ ItemCapabilities, translate from openlp.core.lib.ui import UiStrings, shortcut_action -from openlp.core.ui import HideMode, MainDisplay +from openlp.core.ui import HideMode, MainDisplay, Display from openlp.core.utils.actions import ActionList, CategoryOrder log = logging.getLogger(__name__) @@ -234,19 +234,15 @@ class SlideController(QtGui.QWidget): self.songMenu.setMenu(QtGui.QMenu( translate('OpenLP.SlideController', 'Go To'), self.toolbar)) self.toolbar.makeWidgetsInvisible([u'Song Menu']) - # Build the seekSlider. - self.seekSlider = QtGui.QSlider(QtCore.Qt.Horizontal) - self.seekSlider.setMaximum(1000) - # Build the volumeSlider. - self.volumeSlider = QtGui.QSlider(QtCore.Qt.Horizontal) - self.volumeSlider.setTickInterval(1) - self.volumeSlider.setTickPosition(QtGui.QSlider.TicksAbove) - self.volumeSlider.setMinimum(0) - self.volumeSlider.setMaximum(10) - else: - # Build the seekSlider. - self.seekSlider = Phonon.SeekSlider() - self.volumeSlider = Phonon.VolumeSlider() + # Build the seekSlider. + self.seekSlider = QtGui.QSlider(QtCore.Qt.Horizontal) + self.seekSlider.setMaximum(1000) + # Build the volumeSlider. + self.volumeSlider = QtGui.QSlider(QtCore.Qt.Horizontal) + self.volumeSlider.setTickInterval(1) + self.volumeSlider.setTickPosition(QtGui.QSlider.TicksAbove) + self.volumeSlider.setMinimum(0) + self.volumeSlider.setMaximum(10) self.seekSlider.setGeometry(QtCore.QRect(90, 260, 221, 24)) self.seekSlider.setObjectName(u'seekSlider') self.mediabar.addToolbarWidget(u'Seek Slider', self.seekSlider) @@ -271,15 +267,9 @@ class SlideController(QtGui.QWidget): self.slideLayout.setSpacing(0) self.slideLayout.setMargin(0) self.slideLayout.setObjectName(u'SlideLayout') - self.mediaObject = Phonon.MediaObject(self) - self.video = Phonon.VideoWidget() - self.video.setVisible(False) - self.audio = Phonon.AudioOutput(Phonon.VideoCategory, self.mediaObject) - Phonon.createPath(self.mediaObject, self.video) - Phonon.createPath(self.mediaObject, self.audio) - if not self.isLive: - self.video.setGeometry(QtCore.QRect(0, 0, 300, 225)) - self.slideLayout.insertWidget(0, self.video) + self.previewDisplay = Display(self) + self.previewDisplay.setGeometry(QtCore.QRect(0, 0, 300, 300)) + self.slideLayout.insertWidget(0, self.previewDisplay) # Actual preview screen self.slidePreview = QtGui.QLabel(self) sizePolicy = QtGui.QSizePolicy(QtGui.QSizePolicy.Fixed, @@ -402,8 +392,7 @@ class SlideController(QtGui.QWidget): def liveEscape(self): self.display.setVisible(False) - #self.display.videoStop() - Receiver.send_message('media_stop', self.display) + Receiver.send_message('media_stop', self) def servicePrevious(self): Receiver.send_message('servicemanager_previous_item') @@ -427,6 +416,10 @@ class SlideController(QtGui.QWidget): self.ratio = float(self.screens.current[u'size'].width()) / \ float(self.screens.current[u'size'].height()) self.previewSizeChanged() + Receiver.send_message(u'setup_display', self.display) + self.previewDisplay.resize(self.slidePreview.size()) + self.previewDisplay.setup() + Receiver.send_message(u'setup_display', self.previewDisplay) if self.serviceItem: self.refreshServiceItem() @@ -522,7 +515,7 @@ class SlideController(QtGui.QWidget): elif item.is_media(): #self.toolbar.setVisible(False) self.mediabar.setVisible(True) - self.volumeSlider.setAudioOutput(self.audio) +# self.volumeSlider.setAudioOutput(self.audio) def refreshServiceItem(self): """ @@ -1060,16 +1053,9 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaStart') file = os.path.join(item.get_frame_path(), item.get_frame_title()) - if self.isLive: - Receiver.send_message(u'media_video', [self.display, file, self.volume, False]) - self.volumeSlider.setValue(self.volume) - else: - self.mediaObject.stop() - self.mediaObject.clearQueue() - self.mediaObject.setCurrentSource(Phonon.MediaSource(file)) - self.seekSlider.setMediaObject(self.mediaObject) - self.seekSlider.show() - self.onMediaPlay() + Receiver.send_message(u'media_video', [self, file, self.volume, False]) + self.volumeSlider.setValue(self.volume) + self.slidePreview.hide() def mediaSeek(self): """ @@ -1077,7 +1063,7 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController mediaSeek') self.seekPos = self.seekSlider.value() - Receiver.send_message(u'media_seek', [self.display, self.seekPos]) + Receiver.send_message(u'media_seek', [self, self.seekPos]) def mediaVolume(self): """ @@ -1085,7 +1071,7 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController mediaVolume') self.volume = self.volumeSlider.value() - Receiver.send_message(u'media_volume', [self.display, self.volume]) + Receiver.send_message(u'media_volume', [self, self.volume]) def onMediaPause(self): @@ -1093,33 +1079,22 @@ class SlideController(QtGui.QWidget): Respond to the Pause from the media Toolbar """ log.debug(u'SlideController onMediaPause') - if self.isLive: - Receiver.send_message(u'media_pause', self.display) - else: - self.mediaObject.pause() + Receiver.send_message(u'media_pause', self) def onMediaPlay(self): """ Respond to the Play from the media Toolbar """ log.debug(u'SlideController onMediaPlay') - if self.isLive: - Receiver.send_message(u'media_play', self.display) - else: - self.slidePreview.hide() - self.video.show() - self.mediaObject.play() + Receiver.send_message(u'media_play', self) + self.slidePreview.hide() def onMediaStop(self): """ Respond to the Stop from the media Toolbar """ log.debug(u'SlideController onMediaStop') - if self.isLive: - Receiver.send_message(u'media_stop', self.display) - else: - self.mediaObject.stop() - self.video.hide() + Receiver.send_message(u'media_stop', self) self.slidePreview.clear() self.slidePreview.show() @@ -1128,12 +1103,7 @@ class SlideController(QtGui.QWidget): Respond to a request to close the Video """ log.debug(u'SlideController onMediaClose') - if self.isLive: - Receiver.send_message(u'media_reset', self.display) - else: - self.mediaObject.stop() - self.mediaObject.clearQueue() - self.video.hide() + Receiver.send_message(u'media_reset', self) self.slidePreview.clear() self.slidePreview.show() diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 5e078763d..bd69e4716 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -32,16 +32,16 @@ class MediaBackends(object): Phonon = 1 Vlc = 2 -class MediaStates(object): +class MediaState(object): """ - An enumeratioin for possible States of the Media Player + An enumeration for possible States of the Media Player (copied from Phonon::State """ - LoadingState = 0 - StoppedState = 1 - PlayingState = 2 - PausedState = 4 - OffState = 6 + Loading = 0 + Stopped = 1 + Playing = 2 + Paused = 4 + Off = 6 class MediaController(object): """ @@ -50,11 +50,14 @@ class MediaController(object): """ def __init__(self, parent): self.parent = parent - self.state = MediaStates.OffState + self.state = MediaState.Off def load(self, display, path, volume): pass + def resize(self, display, controller): + pass + def play(self, display): pass @@ -64,16 +67,19 @@ class MediaController(object): def stop(self, display): pass + def volume(self, display, vol): + pass + def seek(self, display, seekVal): pass def reset(self, display): pass - def updateUI(self, display): + def update_ui(self, controller, display): pass - def getSupportedFileTypes(self): + def get_supported_file_types(self): pass from mediaitem import MediaMediaItem diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 200af77bf..4bbf144d2 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -31,11 +31,11 @@ import sys, types from PyQt4 import QtCore import vlc -from PyQt4 import QtCore, QtGui +from PyQt4 import QtCore, QtGui, QtWebKit from PyQt4.phonon import Phonon from openlp.core.lib import Receiver -from openlp.plugins.media.lib import MediaBackends, MediaStates +from openlp.plugins.media.lib import MediaBackends, MediaState from webkitcontroller import WebkitController from phononcontroller import PhononController from vlccontroller import VlcController @@ -44,83 +44,53 @@ log = logging.getLogger(__name__) class MediaManager(object): """ - The implementation of a Media Manager - The idea is to separate the media related implementation into the plugin files - and unify the access from other parts of code - The media manager adds an own class for every type of backend - Currently these are QtWebkit, Phonon and planed Vlc. - On the other hand currently the previewController display only use phonon for media output. - So I would suggest to rename the maindisplay.py to display.py and modify the code, - so that the display class can be used for the maindisplay as well as for the previewController display. - - Workflow idea: - - OpenLP is starting - - Live display and preview display are call setup - - Live display and preview display send signal with a pointer to their own to the media controller ('media_set_display') - - media controller register all available displays and create for each display all types of media backends (see setDisplay) - - in the OpenLP configuration dialog the user no longe will decide between using Webkit OR Phonon. - - instead of this there is a list widget with all available backends and the user can switch off/on the backends - and change the priority order - (this is necessary, because of not all backends can play all media files and text over video is currently only with QtWebkit possible) - - later on, if the user add a new media service item the signal ('media_video') will be send - - as a result of this the media manager checks which controller is needed for this filetyp - and assign the related backend controller to the right display - - Now all related media stuff (play, pause, ...) will be routed to the related backend controller and there processed - - if one or more medias loaded a generic 200ms Timer will be started peridiodically to refresh the UI - - Signal ('media_reset') will close the related video and disconnect the backend from the display - - Advantages: - - clean and easy interface from other parts of code (slidecontroller and display classes) - - more and better configuration possibilities inside the special backend controllers - - same handling for preview and live display (or later on other additionally displays with their slide controllers) - - Disadvantages: - - because of there will be display widgets created outside of the maindisplay.py file it is more complicate to read the code - - some more signals are send arround the system - - Notices: - - the flash support uses the flash plugin from Mozilla. So there is a js-check that this plugin is installed. - - maybe there would be the installed flashplugin of the IE possible could also used, but I'm not sure about this? - - I would suggest to not hide the main toolbar in case of media, instead of this the media toolbar should be - visible as second toolbar (so the screen can be blanked also during a running video, ...) + The implementation of a Media Manager + The idea is to separate the media related implementation into the plugin files + and unify the access from other parts of code + The media manager adds an own class for every type of backend + Currently these are QtWebkit, Phonon and planed Vlc. + On the other hand currently the previewController display only use phonon for media output. + So I would suggest to rename the maindisplay.py to display.py and modify the code, + so that the display class can be used for the maindisplay as well as for the previewController display. """ + def __init__(self, parent): self.parent = parent - self.availableBackends = [ MediaBackends.Webkit, MediaBackends.Phonon, MediaBackends.Vlc] self.curDisplayMediaController = {} + #one controller for every backend self.displayWebkitController = WebkitController(self) self.displayPhononController = PhononController(self) self.displayVlcController = VlcController(self) - + #Timer for video state self.Timer = QtCore.QTimer() self.Timer.setInterval(200) - + #signals QtCore.QObject.connect(self.Timer, - QtCore.SIGNAL("timeout()"), self.videoState) + QtCore.SIGNAL("timeout()"), self.video_state) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_set_display'), self.setDisplay) + QtCore.SIGNAL(u'setup_display'), self.setup_display) QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'media_video'), self.video) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_play'), self.videoPlay) + QtCore.SIGNAL(u'media_play'), self.video_play) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_pause'), self.videoPause) + QtCore.SIGNAL(u'media_pause'), self.video_pause) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_stop'), self.videoStop) + QtCore.SIGNAL(u'media_stop'), self.video_stop) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_seek'), self.videoSeek) + QtCore.SIGNAL(u'media_seek'), self.video_seek) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_volume'), self.videoVolume) + QtCore.SIGNAL(u'media_volume'), self.video_volume) QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_reset'), self.videoReset) + QtCore.SIGNAL(u'media_reset'), self.video_reset) - def videoState(self): + def video_state(self): """ - check if there is an assigned media backend and do some + Check if there is an assigned media backend and do some updating stuff (e.g. update the UI) """ isAnyonePlaying = False @@ -128,67 +98,94 @@ class MediaManager(object): self.Timer.stop() else: for display in self.curDisplayMediaController.keys(): - self.curDisplayMediaController[display].updateUI(display) - if self.curDisplayMediaController[display].state == MediaStates.PlayingState: + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.previewController.display: + self.curDisplayMediaController[display].update_ui(self.parent.previewController, display) + else: + self.curDisplayMediaController[display].update_ui(self.parent.liveController, display) + if self.curDisplayMediaController[display].state == MediaState.Playing: isAnyonePlaying = True if not isAnyonePlaying: self.Timer.stop() - def setDisplay(self, display): - self.setupVlcController(display) - self.setupPhononController(display) - self.setupWebkitController(display) + def setup_display(self, display): + # check controller relevant displays + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.liveController.previewDisplay or \ + display == self.parent.liveController.display: + self.setup_vlc_controller(display) + self.setup_phonon_controller(display) + self.setup_webkit_controller(display) - - def setupWebkitController(self, display): + def setup_webkit_controller(self, display): + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.liveController.previewDisplay: + display.webView.resize(display.size()) display.webView.raise_() - def setupPhononController(self, display): + def setup_phonon_controller(self, display): display.phononWidget = Phonon.VideoWidget(display) display.phononWidget.setVisible(False) - display.phononWidget.setGeometry(QtCore.QRect(0, 0, - display.screen[u'size'].width(), display.screen[u'size'].height())) + display.phononWidget.resize(display.size()) display.mediaObject = Phonon.MediaObject(display) display.audio = Phonon.AudioOutput(Phonon.VideoCategory, display.mediaObject) Phonon.createPath(display.mediaObject, display.phononWidget) Phonon.createPath(display.mediaObject, display.audio) display.phononWidget.raise_() - def setupVlcController(self, display): + def setup_vlc_controller(self, display): display.vlcWidget = QtGui.QFrame(display) # creating a basic vlc instance display.vlcInstance = vlc.Instance() # creating an empty vlc media player display.vlcMediaPlayer = display.vlcInstance.media_player_new() - display.vlcWidget.setGeometry(QtCore.QRect(0, 0, - display.screen[u'size'].width(), display.screen[u'size'].height())) + display.vlcWidget.resize(display.size()) display.vlcWidget.raise_() + def resize(self, controller): + for display in self.curDisplayMediaController.keys(): + display.resize(controller.slidePreview.size()) + self.curDisplayMediaController[display].resize(display, controller) + def video(self, msg): """ Loads and starts a video to run with the option of sound """ - display = msg[0] + controller = msg[0] videoPath = msg[1] volume = msg[2] isBackground = msg[3] - log.debug(u'video') - display.webLoaded = True - display.setGeometry(display.screen[u'size']) - # We are running a background theme - display.override[u'theme'] = u'' - display.override[u'video'] = True vol = float(volume) / float(10) - self.checkFileType(display, videoPath, isBackground) - self.curDisplayMediaController[display].load(display, videoPath, volume) - if display.isLive: + #stop running videos + self.video_reset(controller) + if controller.isLive: + # We are running a background theme + controller.display.override[u'theme'] = u'' + controller.display.override[u'video'] = True + display = controller.previewDisplay + self.check_file_type(display, videoPath, False) + self.curDisplayMediaController[display].load(display, videoPath, volume) + display = controller.display + self.check_file_type(display, videoPath, False) + self.curDisplayMediaController[display].load(display, videoPath, volume) + controller.display.webLoaded = True Receiver.send_message(u'maindisplay_active') + else: + display = controller.previewDisplay + self.check_file_type(display, videoPath, False) + self.curDisplayMediaController[display].load(display, videoPath, volume) + #check size of all media_widgets + self.resize(controller) + #now start playing + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + self.curDisplayMediaController[display].pause(display) - def checkFileType(self, display, videoPath, isBackground): + def check_file_type(self, display, videoPath, isBackground): """ - Used to choose the right media backend type - from the prioritized backend list + Used to choose the right media backend type + from the prioritized backend list """ usePhonon = QtCore.QSettings().value( u'media/use phonon', QtCore.QVariant(True)).toBool() @@ -199,127 +196,104 @@ class MediaManager(object): elif videoPath.endswith(u'.wmv'): useVlc = False usePhonon = True - if useVlc: self.curDisplayMediaController[display] = self.displayVlcController display.phononWidget.setVisible(False) - display.webView.setVisible(False) display.vlcWidget.setVisible(True) + display.webView.setVisible(False) elif usePhonon and not isBackground: self.curDisplayMediaController[display] = self.displayPhononController display.phononWidget.setVisible(True) - display.webView.setVisible(False) display.vlcWidget.setVisible(False) + display.webView.setVisible(False) else: self.curDisplayMediaController[display] = self.displayWebkitController display.phononWidget.setVisible(False) - display.webView.setVisible(True) display.vlcWidget.setVisible(False) + display.webView.setVisible(True) if len(self.curDisplayMediaController) > 0: if not self.Timer.isActive(): self.Timer.start() - - def resetVideo(self): - """ - Used after Video plugin has changed the background - """ - log.debug(u'resetVideo') - if display.phononActive: - display.mediaObject.stop() - display.mediaObject.clearQueue() - display.webView.setVisible(True) - display.phononWidget.setVisible(False) - display.phononActive = False - else: - display.frame.evaluateJavaScript(u'show_video("close");') - display.frame.evaluateJavaScript(u'show_flash("close");') - display.override = {} - # Update the preview frame. - if display.isLive: - Receiver.send_message(u'maindisplay_active') - - def videoPlay(self, display): + def video_play(self, controller): """ Responds to the request to play a loaded video """ - log.debug(u'videoPlay') - self.curDisplayMediaController[display].play(display) + log.debug(u'video_play') + for display in self.curDisplayMediaController.keys(): + print display, display.parent, controller + if display.parent == controller: + self.curDisplayMediaController[display].play(display) # show screen - if display.isLive: - if not self.Timer.isActive(): - self.Timer.start() - display.setVisible(True) + if not self.Timer.isActive(): + self.Timer.start() + display.setVisible(True) - def videoPause(self, display): + def video_pause(self, controller): """ Responds to the request to pause a loaded video """ log.debug(u'videoPause') - if display in self.curDisplayMediaController: - self.curDisplayMediaController[display].pause(display) - return + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + self.curDisplayMediaController[display].pause(display) - def videoStop(self, display): + def video_stop(self, controller): """ Responds to the request to stop a loaded video """ - log.debug(u'videoStop') - if type(display) is types.ListType: - return - if display in self.curDisplayMediaController: - self.curDisplayMediaController[display].stop(display) - if display.isLive: - display.setVisible(False) + log.debug(u'video_stop') + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + self.curDisplayMediaController[display].stop(display) - - def videoVolume(self, msg): + def video_volume(self, msg): """ Changes the volume of a running video """ - display = msg[0] + controller = msg[0] volume = msg[1] - log.debug(u'videoVolume %d' % volume) + log.debug(u'video_volume %d' % volume) vol = float(volume) / float(10) - if display.phononActive: - display.audio.setVolume(vol) - else: - display.frame.evaluateJavaScript(u'show_video(null, null, %s);' % - str(vol)) + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + self.curDisplayMediaController[display].volume(display, vol) - def videoFinished(self): + def video_finished(self): """ Blank the Video when it has finished so the final frame is not left hanging """ display.videoStop() display.hideDisplay(HideMode.Blank) - display.phononActive = False display.videoHide = True - def videoTick(self, tick): + def video_tick(self, tick): """ Triggered on video tick every 200 milli seconds """ if tick > display.serviceItem.end_time * 1000: display.videoFinished() - def videoSeek(self, msg): + def video_seek(self, msg): """ Responds to the request to change the seek Slider of a loaded video """ - log.debug(u'videoSeek') - display = msg[0] + log.debug(u'video_seek') + controller = msg[0] seekVal = msg[1] - if display in self.curDisplayMediaController: - self.curDisplayMediaController[display].seek(display, seekVal) + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + self.curDisplayMediaController[display].seek(display, seekVal) - def videoReset(self, display): + def video_reset(self, controller): """ Responds to the request to reset a loaded video """ - log.debug(u'videoReset') - print "videoReset" - if display in self.curDisplayMediaController: - self.curDisplayMediaController[display].reset(display) - self.curDisplayMediaController[display] + log.debug(u'video_reset') + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + self.curDisplayMediaController[display].reset(display) + del self.curDisplayMediaController[display] + if controller.isLive: + Receiver.send_message(u'maindisplay_active') diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index 9cb661a57..abf22c40a 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -91,7 +91,7 @@ class MediaMediaItem(MediaManagerItem): self.resetAction.setVisible(False) #self.parent.liveController.display.resetVideo() Receiver.send_message(u'media_reset', - self.parent.liveController.display) + self.parent.liveController) def videobackgroundReplaced(self): """ @@ -110,9 +110,8 @@ class MediaMediaItem(MediaManagerItem): filename = unicode(item.data(QtCore.Qt.UserRole).toString()) if os.path.exists(filename): (path, name) = os.path.split(filename) - #self.parent.liveController.display.video(filename, 0, True) Receiver.send_message(u'media_video', - [self.parent.liveController.display, filename, 0, True]) + [self.parent.liveController, filename, 0, True]) self.resetAction.setVisible(True) else: critical_error_message_box(UiStrings().LiveBGError, @@ -136,7 +135,7 @@ class MediaMediaItem(MediaManagerItem): # self.mediaObject.stop() # self.mediaObject.clearQueue() # self.mediaObject.setCurrentSource(Phonon.MediaSource(filename)) -# if not self.mediaStateWait(Phonon.StoppedState): +# if not self.mediaStateWait(Phonon.Stopped): # Due to string freeze, borrow a message from presentations # This will be corrected in 1.9.6 # critical_error_message_box( @@ -147,7 +146,7 @@ class MediaMediaItem(MediaManagerItem): # File too big for processing if os.path.getsize(filename) <= 52428800: # 50MiB # self.mediaObject.play() -# if not self.mediaStateWait(Phonon.PlayingState) \ +# if not self.mediaStateWait(Phonon.Playing) \ # or self.mediaObject.currentSource().type() \ # == Phonon.MediaSource.Invalid: # # Due to string freeze, borrow a message from presentations @@ -213,4 +212,4 @@ class MediaMediaItem(MediaManagerItem): img = QtGui.QPixmap(u':/media/media_video.png').toImage() item_name.setIcon(build_icon(img)) item_name.setData(QtCore.Qt.UserRole, QtCore.QVariant(file)) - self.listView.addItem(item_name) \ No newline at end of file + self.listView.addItem(item_name) diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index d8b71d29a..f4fe8056d 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -27,16 +27,32 @@ from PyQt4.phonon import Phonon -from openlp.plugins.media.lib import MediaController, MediaStates +from openlp.plugins.media.lib import MediaController, MediaState class PhononController(MediaController): """ Specialiced MediaController class to reflect Features of the Phonon backend """ + def __init__(self, parent): - self.parent = parent MediaController.__init__(self, parent) + self.parent = parent + self.additional_extensions = { + u'audio/ac3': [u'.ac3'], + u'audio/flac': [u'.flac'], + u'audio/x-m4a': [u'.m4a'], + u'audio/midi': [u'.mid', u'.midi'], + u'audio/x-mp3': [u'.mp3'], + u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], + u'audio/qcelp': [u'.qcp'], + u'audio/x-wma': [u'.wma'], + u'audio/x-ms-wma': [u'.wma'], + u'video/x-flv': [u'.flv'], + u'video/x-matroska': [u'.mpv', u'.mkv'], + u'video/x-wmv': [u'.wmv'], + u'video/x-ms-wmv': [u'.wmv']} + def load(self, display, path, volume): print "load vid in Phonon Controller" @@ -47,47 +63,46 @@ class PhononController(MediaController): # Need the timer to trigger set the trigger to 200ms # Value taken from web documentation. vol = float(volume) / float(10) - if display.serviceItem.end_time != 0: - display.mediaObject.setTickInterval(200) - display.mediaObject.play() display.audio.setVolume(vol) - self.state = MediaStates.PlayingState + def resize(self, display): + display.phononWidget.resize(display.size()) def play(self, display): + vol = float(display.parent.volume) / float(10) + display.audio.setVolume(vol) display.mediaObject.play() - self.state = MediaStates.PlayingState + self.state = MediaState.Playing def pause(self, display): display.mediaObject.pause() - self.state = MediaStates.PausedState + self.state = MediaState.Paused def stop(self, display): display.mediaObject.stop() - self.state = MediaStates.StoppedState + self.state = MediaState.Stopped + + def volume(self, display, vol): + display.audio.setVolume(vol) def seek(self, display, seekVal): - print "seek" display.mediaObject.seek(seekVal) def reset(self, display): display.mediaObject.stop() display.mediaObject.clearQueue() - display.webView.setVisible(True) display.phononWidget.setVisible(False) - display.phononActive = False + #display.webView.setVisible(True) - def updateUI(self, display): - display.parent.seekSlider.setMaximum(display.mediaObject.totalTime()) - if not display.parent.seekSlider.isSliderDown(): - display.parent.seekSlider.setSliderPosition(display.mediaObject.currentTime()) -# if newState == Phonon.PlayingState \ -# and oldState != Phonon.PausedState \ + def update_ui(self, controller, display): + controller.seekSlider.setMaximum(display.mediaObject.totalTime()) + if not controller.seekSlider.isSliderDown(): + controller.seekSlider.setSliderPosition(display.mediaObject.currentTime()) +# if newState == Phonon.Playing \ +# and oldState != Phonon.Paused \ # and self.serviceItem.start_time > 0: # # set start time in milliseconds # self.mediaObject.seek(self.serviceItem.start_time * 1000) - pass - - def getSupportedFileTypes(self): + def get_supported_file_types(self): pass diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index 7d36a51a4..d75dbd4cb 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -27,7 +27,7 @@ import sys -from openlp.plugins.media.lib import MediaController, MediaStates +from openlp.plugins.media.lib import MediaController, MediaState class VlcController(MediaController): """ @@ -35,8 +35,23 @@ class VlcController(MediaController): to reflect Features of the Vlc backend """ def __init__(self, parent): - self.parent = parent MediaController.__init__(self, parent) + self.parent = parent + self.supported_file_types = ['avi'] + self.additional_extensions = { + u'audio/ac3': [u'.ac3'], + u'audio/flac': [u'.flac'], + u'audio/x-m4a': [u'.m4a'], + u'audio/midi': [u'.mid', u'.midi'], + u'audio/x-mp3': [u'.mp3'], + u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], + u'audio/qcelp': [u'.qcp'], + u'audio/x-wma': [u'.wma'], + u'audio/x-ms-wma': [u'.wma'], + u'video/x-flv': [u'.flv'], + u'video/x-matroska': [u'.mpv', u'.mkv'], + u'video/x-wmv': [u'.wmv'], + u'video/x-ms-wmv': [u'.wmv']} def load(self, display, path, volume): print "load vid in Vlc Controller" @@ -61,34 +76,38 @@ class VlcController(MediaController): display.vlcMediaPlayer.set_hwnd(int(display.vlcWidget.winId())) elif sys.platform == "darwin": # for MacOS display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) - # start playing - self.play(display) - self.state = MediaStates.PlayingState + + def resize(self, display): + display.vlcWidget.resize(display.size()) def play(self, display): display.vlcMediaPlayer.play() - self.state = MediaStates.PlayingState + self.state = MediaState.Playing def pause(self, display): display.vlcMediaPlayer.pause() - self.state = MediaStates.PausedState + self.state = MediaState.Paused def stop(self, display): display.vlcMediaPlayer.stop() - self.state = MediaStates.StoppedState + self.state = MediaState.Stopped + + def volume(self, display, vol): + pass def seek(self, display, seekVal): if display.vlcMediaPlayer.is_seekable(): display.vlcMediaPlayer.set_position(seekVal/1000.0) def reset(self, display): - pass + display.vlcWidget.setVisible(False) + #display.webView.setVisible(True) - def updateUI(self, display): - display.parent.seekSlider.setMaximum(1000) - if not display.parent.seekSlider.isSliderDown(): + def update_ui(self, controller, display): + controller.seekSlider.setMaximum(1000) + if not controller.seekSlider.isSliderDown(): currentPos = display.vlcMediaPlayer.get_position() * 1000 - display.parent.seekSlider.setSliderPosition(currentPos) + controller.seekSlider.setSliderPosition(currentPos) - def getSupportedFileTypes(self): + def get_supported_file_types(self): pass diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index c021b9e7d..b8ef4d814 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -25,17 +25,20 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -from openlp.plugins.media.lib import MediaController, MediaStates +from openlp.plugins.media.lib import MediaController, MediaState class WebkitController(MediaController): """ Specialiced MediaController class to reflect Features of the QtWebkit backend """ + def __init__(self, parent): - self.parent = parent MediaController.__init__(self, parent) + self.parent = parent self.isFlash = False + self.additional_extensions = { + u'video/shockwave': [u'.swf']} def load(self, display, path, volume): print "load vid in Webkit Controller" @@ -48,48 +51,60 @@ class WebkitController(MediaController): (path.replace(u'\\', u'\\\\')) self.isFlash = True else: - js = u'show_video("init", "%s", %s, false); show_video("play");' % \ + js = u'show_video("init", "%s", %s, false);' % \ (path.replace(u'\\', u'\\\\'), str(vol)) self.isFlash = False display.frame.evaluateJavaScript(js) - self.state = MediaStates.PlayingState + + def resize(self, display, controller): + if display == controller.previewDisplay: + print display.size() + display.webView.resize(display.size()) def play(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("play","");') else: display.frame.evaluateJavaScript(u'show_video("play");') - self.state = MediaStates.PlayingState + self.state = MediaState.Playing def pause(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("pause","");') else: display.frame.evaluateJavaScript(u'show_video("pause");') - self.state = MediaStates.PausedState + self.state = MediaState.Paused def stop(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("stop","");') else: display.frame.evaluateJavaScript(u'show_video("stop");') - self.state = MediaStates.StoppedState + self.state = MediaState.Stopped + + def volume(self, display, vol): + if not self.isFlash: + display.frame.evaluateJavaScript(u'show_video(null, null, %s);' % + str(vol)) def seek(self, display, seekVal): if not self.isFlash: - print seekVal, float(seekVal)/1000 display.frame.evaluateJavaScript(u'show_video("seek", "%f");' % (float(seekVal)/1000)) def reset(self, display): - display.frame.evaluateJavaScript(u'show_video("close");') + if self.isFlash: + display.frame.evaluateJavaScript(u'show_flash("close","");') + else: + display.frame.evaluateJavaScript(u'show_video("close");') - def updateUI(self, display): + def update_ui(self, controller, display): + return if not self.isFlash: length = display.frame.evaluateJavaScript(u'show_video("length");') - display.parent.seekSlider.setMaximum(length.toFloat()[0]*1000) - if not display.parent.seekSlider.isSliderDown(): + controller.seekSlider.setMaximum(length.toFloat()[0]*1000) + if not controller.seekSlider.isSliderDown(): currentTime = display.frame.evaluateJavaScript(u'show_video("currentTime");') - display.parent.seekSlider.setSliderPosition(currentTime.toFloat()[0]*1000) + controller.seekSlider.setSliderPosition(currentTime.toFloat()[0]*1000) - def getSupportedFileTypes(self): + def get_supported_file_types(self): pass diff --git a/openlp/plugins/media/mediaplugin.py b/openlp/plugins/media/mediaplugin.py index 99eb5b94d..391a66511 100644 --- a/openlp/plugins/media/mediaplugin.py +++ b/openlp/plugins/media/mediaplugin.py @@ -123,3 +123,12 @@ class MediaPlugin(Plugin): 'Add the selected Media to the service') } self.setPluginUiTextStrings(tooltips) + + def finalise(self): + """ + Time to tidy up on exit + """ + log.info(u'Media Finalising') + self.mediaManager.Timer.stop() + self.mediaManager.video_reset(self.previewController) + self.mediaManager.video_reset(self.liveController) From aebc0e240ec298ad229ccdfaac16635e81111f3f Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Tue, 17 May 2011 21:50:00 +0200 Subject: [PATCH 05/41] further progress --- openlp/core/lib/htmlbuilder.py | 18 +- openlp/core/ui/maindisplay.py | 34 +--- openlp/core/ui/slidecontroller.py | 5 +- openlp/plugins/media/lib/__init__.py | 11 ++ openlp/plugins/media/lib/mediacontroller.py | 164 ++++++++++--------- openlp/plugins/media/lib/phononcontroller.py | 45 ++++- openlp/plugins/media/lib/vlccontroller.py | 42 ++++- openlp/plugins/media/lib/webkitcontroller.py | 51 +++++- 8 files changed, 242 insertions(+), 128 deletions(-) diff --git a/openlp/core/lib/htmlbuilder.py b/openlp/core/lib/htmlbuilder.py index 5e63c9b2c..9d35ee9a8 100644 --- a/openlp/core/lib/htmlbuilder.py +++ b/openlp/core/lib/htmlbuilder.py @@ -101,7 +101,7 @@ sup { var current_video = '1'; var transition = %s; - function show_video(state, path, volume, loop){ + function show_video(state, path, volume, loop, seekVal){ // Note, the preferred method for looping would be to use the // video tag loop attribute. // But QtWebKit doesn't support this. Neither does it support the @@ -183,7 +183,7 @@ sup { case 'currentTime': return vid.currentTime; case 'seek': - vid.currentTime = path; + vid.currentTime = seekVal; break; } } @@ -356,11 +356,21 @@ sup { // PercentLoaded() // GotoFrame() break; - case 'stop': + case 'pause': flashMovie.StopPlay(); - text.innerHTML = ''; text.style.visibility = 'hidden'; break; + case 'stop': + flashMovie.StopPlay(); +// flashMovie.GotoFrame(0); + text.style.visibility = 'hidden'; + break; + case 'close': + flashMovie.StopPlay(); + text.style.visibility = 'hidden'; + break; + text.innerHTML = ''; + break; } } diff --git a/openlp/core/ui/maindisplay.py b/openlp/core/ui/maindisplay.py index 0cb127372..1e27cb97d 100644 --- a/openlp/core/ui/maindisplay.py +++ b/openlp/core/ui/maindisplay.py @@ -104,9 +104,6 @@ class MainDisplay(DisplayWidget): QtCore.SIGNAL(u'maindisplay_hide'), self.hideDisplay) QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'maindisplay_show'), self.showDisplay) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'openlp_phonon_creation'), - self.createMediaObject) def retranslateUi(self): """ @@ -120,8 +117,6 @@ class MainDisplay(DisplayWidget): """ log.debug(u'Start setup for monitor %s (live = %s)' % (self.screens.monitor_number, self.isLive)) - self.usePhonon = QtCore.QSettings().value( - u'media/use phonon', QtCore.QVariant(True)).toBool() self.phononActive = False self.screen = self.screens.current self.setVisible(False) @@ -187,24 +182,6 @@ class MainDisplay(DisplayWidget): log.debug( u'Finished setup for monitor %s' % self.screens.monitor_number) - def createMediaObject(self): - self.firstTime = False - log.debug(u'Creating Phonon objects - Start for %s', self.isLive) - self.mediaObject = Phonon.MediaObject(self) - self.audio = Phonon.AudioOutput(Phonon.VideoCategory, self.mediaObject) - Phonon.createPath(self.mediaObject, self.videoWidget) - Phonon.createPath(self.mediaObject, self.audio) - QtCore.QObject.connect(self.mediaObject, - QtCore.SIGNAL(u'stateChanged(Phonon::State, Phonon::State)'), - self.videoState) - QtCore.QObject.connect(self.mediaObject, - QtCore.SIGNAL(u'finished()'), - self.videoFinished) - QtCore.QObject.connect(self.mediaObject, - QtCore.SIGNAL(u'tick(qint64)'), - self.videoTick) - log.debug(u'Creating Phonon objects - Finished for %s', self.isLive) - def text(self, slide): """ Add the slide text from slideController @@ -239,10 +216,7 @@ class MainDisplay(DisplayWidget): u'top' if shrink else u'') height = self.frame.evaluateJavaScript(js) if shrink: - if self.phononActive: - shrinkItem = self.webView - else: - shrinkItem = self + shrinkItem = self if text: alert_height = int(height.toString()) shrinkItem.resize(self.width(), alert_height) @@ -425,7 +399,6 @@ class MainDisplay(DisplayWidget): Store the images so they can be replaced when required """ log.debug(u'hideDisplay mode = %d', mode) - Receiver.send_message(u'media_pause', self) if mode == HideMode.Screen: self.frame.evaluateJavaScript(u'show_blank("desktop");') self.setVisible(False) @@ -436,7 +409,6 @@ class MainDisplay(DisplayWidget): if mode != HideMode.Screen: if self.isHidden(): self.setVisible(True) - if self.phononActive: self.webView.setVisible(True) self.hideMode = mode @@ -448,11 +420,9 @@ class MainDisplay(DisplayWidget): """ log.debug(u'showDisplay') self.frame.evaluateJavaScript('show_blank("show");') + print "showDisplay", self.isHidden() if self.isHidden(): self.setVisible(True) - if self.phononActive: - self.webView.setVisible(False) - Receiver.send_message(u'media_play', self) self.hideMode = None # Trigger actions when display is active again if self.isLive: diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index 94bcb5da2..bed7a7ed2 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -303,9 +303,9 @@ class SlideController(QtGui.QWidget): QtCore.SIGNAL(u'clicked(QModelIndex)'), self.onSlideSelected) if self.isLive: QtCore.QObject.connect(self.seekSlider, - QtCore.SIGNAL(u'sliderReleased()'), self.mediaSeek) + QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaSeek) QtCore.QObject.connect(self.volumeSlider, - QtCore.SIGNAL(u'sliderReleased()'), self.mediaVolume) + QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaVolume) QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'maindisplay_active'), self.updatePreview) QtCore.QObject.connect(Receiver.get_receiver(), @@ -854,6 +854,7 @@ class SlideController(QtGui.QWidget): """ Tell the plugin to hide the display screen. """ + print "hidePlugin", hide log.debug(u'hidePlugin %s ', hide) if self.serviceItem is not None: if hide: diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index bd69e4716..5324f7025 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -51,6 +51,10 @@ class MediaController(object): def __init__(self, parent): self.parent = parent self.state = MediaState.Off + self.hasOwnWidget = False + + def setup(self, display): + pass def load(self, display, path, volume): pass @@ -76,9 +80,16 @@ class MediaController(object): def reset(self, display): pass + def set_visible(self, display, status): + pass + def update_ui(self, controller, display): pass + @staticmethod + def is_available(): + pass + def get_supported_file_types(self): pass diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 4bbf144d2..4e70737fa 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -27,10 +27,12 @@ import logging -import sys, types +import sys, os from PyQt4 import QtCore -import vlc - +#try: +# import vlc +#except: +# pass from PyQt4 import QtCore, QtGui, QtWebKit from PyQt4.phonon import Phonon @@ -56,15 +58,15 @@ class MediaManager(object): def __init__(self, parent): self.parent = parent - self.availableBackends = [ - MediaBackends.Webkit, - MediaBackends.Phonon, - MediaBackends.Vlc] + self.backend = {} self.curDisplayMediaController = {} #one controller for every backend - self.displayWebkitController = WebkitController(self) - self.displayPhononController = PhononController(self) - self.displayVlcController = VlcController(self) + if WebkitController.is_available(): + self.backend['webkit'] = WebkitController(self) + if PhononController.is_available(): + self.backend['phonon'] = PhononController(self) + if VlcController.is_available(): + self.backend['vlc'] = VlcController(self) #Timer for video state self.Timer = QtCore.QTimer() self.Timer.setInterval(200) @@ -87,6 +89,12 @@ class MediaManager(object): QtCore.SIGNAL(u'media_volume'), self.video_volume) QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'media_reset'), self.video_reset) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_hide'), self.video_hide) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_blank'), self.video_blank) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_unblank'), self.video_unblank) def video_state(self): """ @@ -111,48 +119,26 @@ class MediaManager(object): def setup_display(self, display): # check controller relevant displays if display == self.parent.previewController.previewDisplay or \ - display == self.parent.liveController.previewDisplay or \ display == self.parent.liveController.display: - self.setup_vlc_controller(display) - self.setup_phonon_controller(display) - self.setup_webkit_controller(display) - - def setup_webkit_controller(self, display): - if display == self.parent.previewController.previewDisplay or \ - display == self.parent.liveController.previewDisplay: - display.webView.resize(display.size()) - display.webView.raise_() - - def setup_phonon_controller(self, display): - display.phononWidget = Phonon.VideoWidget(display) - display.phononWidget.setVisible(False) - display.phononWidget.resize(display.size()) - display.mediaObject = Phonon.MediaObject(display) - display.audio = Phonon.AudioOutput(Phonon.VideoCategory, display.mediaObject) - Phonon.createPath(display.mediaObject, display.phononWidget) - Phonon.createPath(display.mediaObject, display.audio) - display.phononWidget.raise_() - - def setup_vlc_controller(self, display): - display.vlcWidget = QtGui.QFrame(display) - # creating a basic vlc instance - display.vlcInstance = vlc.Instance() - # creating an empty vlc media player - display.vlcMediaPlayer = display.vlcInstance.media_player_new() - display.vlcWidget.resize(display.size()) - display.vlcWidget.raise_() + for backend_typ in self.backend.values(): + backend_typ.setup(display) def resize(self, controller): - for display in self.curDisplayMediaController.keys(): - display.resize(controller.slidePreview.size()) - self.curDisplayMediaController[display].resize(display, controller) + """ + after Mainwindow changes or Splitter moved all related media + widgets have to be resized + """ + pass + #has to be clarified + #for display in self.curDisplayMediaController.keys(): + # self.curDisplayMediaController[display].resize(display, controller) def video(self, msg): """ Loads and starts a video to run with the option of sound """ controller = msg[0] - videoPath = msg[1] + videoPath = os.path.abspath(msg[1]) volume = msg[2] isBackground = msg[3] log.debug(u'video') @@ -163,14 +149,13 @@ class MediaManager(object): # We are running a background theme controller.display.override[u'theme'] = u'' controller.display.override[u'video'] = True - display = controller.previewDisplay - self.check_file_type(display, videoPath, False) - self.curDisplayMediaController[display].load(display, videoPath, volume) +# display = controller.previewDisplay +# self.check_file_type(display, videoPath, False) +# self.curDisplayMediaController[display].load(display, videoPath, volume) display = controller.display self.check_file_type(display, videoPath, False) self.curDisplayMediaController[display].load(display, videoPath, volume) controller.display.webLoaded = True - Receiver.send_message(u'maindisplay_active') else: display = controller.previewDisplay self.check_file_type(display, videoPath, False) @@ -180,37 +165,24 @@ class MediaManager(object): #now start playing for display in self.curDisplayMediaController.keys(): if display.parent == controller: - self.curDisplayMediaController[display].pause(display) + self.curDisplayMediaController[display].play(display) def check_file_type(self, display, videoPath, isBackground): """ Used to choose the right media backend type from the prioritized backend list """ - usePhonon = QtCore.QSettings().value( - u'media/use phonon', QtCore.QVariant(True)).toBool() - useVlc = True - if videoPath.endswith(u'.swf'): - useVlc = False - usePhonon = False + if videoPath.endswith(u'.swf') or isBackground: + self.curDisplayMediaController[display] = self.backend['webkit'] elif videoPath.endswith(u'.wmv'): - useVlc = False - usePhonon = True - if useVlc: - self.curDisplayMediaController[display] = self.displayVlcController - display.phononWidget.setVisible(False) - display.vlcWidget.setVisible(True) - display.webView.setVisible(False) - elif usePhonon and not isBackground: - self.curDisplayMediaController[display] = self.displayPhononController - display.phononWidget.setVisible(True) - display.vlcWidget.setVisible(False) - display.webView.setVisible(False) + self.curDisplayMediaController[display] = self.backend['phonon'] else: - self.curDisplayMediaController[display] = self.displayWebkitController - display.phononWidget.setVisible(False) - display.vlcWidget.setVisible(False) - display.webView.setVisible(True) + self.curDisplayMediaController[display] = self.backend['vlc'] + for key in self.backend.keys(): + if self.backend[key] == self.curDisplayMediaController[display]: + self.backend[key].set_visible(display, True) +# else: +# self.backend[key].set_visible(display, False) if len(self.curDisplayMediaController) > 0: if not self.Timer.isActive(): self.Timer.start() @@ -221,13 +193,12 @@ class MediaManager(object): """ log.debug(u'video_play') for display in self.curDisplayMediaController.keys(): - print display, display.parent, controller if display.parent == controller: self.curDisplayMediaController[display].play(display) # show screen if not self.Timer.isActive(): self.Timer.start() - display.setVisible(True) + #display.setVisible(True) def video_pause(self, controller): """ @@ -246,6 +217,7 @@ class MediaManager(object): for display in self.curDisplayMediaController.keys(): if display.parent == controller: self.curDisplayMediaController[display].stop(display) + self.curDisplayMediaController[display].set_visible(display, False) def video_volume(self, msg): """ @@ -286,6 +258,7 @@ class MediaManager(object): if display.parent == controller: self.curDisplayMediaController[display].seek(display, seekVal) + def video_reset(self, controller): """ Responds to the request to reset a loaded video @@ -295,5 +268,48 @@ class MediaManager(object): if display.parent == controller: self.curDisplayMediaController[display].reset(display) del self.curDisplayMediaController[display] - if controller.isLive: - Receiver.send_message(u'maindisplay_active') +# if controller.isLive: + #Receiver.send_message(u'maindisplay_active') + + def video_hide(self, msg): + """ + Hide the related video Widget + """ + print "hide" + isLive = msg[1] + if isLive: + controller = self.parent.liveController + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + if self.curDisplayMediaController[display].state == MediaState.Playing: + self.curDisplayMediaController[display].pause(display) + self.curDisplayMediaController[display].set_visible(display, False) + + def video_blank(self, msg): + """ + Blank the related video Widget + """ + print "blank" + isLive = msg[1] + if isLive: + controller = self.parent.liveController + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + if self.curDisplayMediaController[display].state == MediaState.Playing: + self.curDisplayMediaController[display].pause(display) + self.curDisplayMediaController[display].set_visible(display, False) + + def video_unblank(self, msg): + """ + Unblank the related video Widget + """ + print "unblank" + Receiver.send_message(u'maindisplay_show') + isLive = msg[1] + if isLive: + controller = self.parent.liveController + for display in self.curDisplayMediaController.keys(): + if display.parent == controller: + if self.curDisplayMediaController[display].state == MediaState.Paused: + self.curDisplayMediaController[display].play(display) + self.curDisplayMediaController[display].set_visible(display, True) diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index f4fe8056d..d7fa78a81 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -25,6 +25,7 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### +from PyQt4 import QtCore, QtGui from PyQt4.phonon import Phonon from openlp.plugins.media.lib import MediaController, MediaState @@ -53,10 +54,43 @@ class PhononController(MediaController): u'video/x-wmv': [u'.wmv'], u'video/x-ms-wmv': [u'.wmv']} + def setup(self, display): + display.phononWidget = Phonon.VideoWidget(display) + display.phononWidget.setVisible(False) + display.phononWidget.resize(display.size()) + display.mediaObject = Phonon.MediaObject(display) + display.audio = Phonon.AudioOutput(Phonon.VideoCategory, display.mediaObject) + Phonon.createPath(display.mediaObject, display.phononWidget) + Phonon.createPath(display.mediaObject, display.audio) + display.phononWidget.raise_() + display.phononWidget.hide() + self.hasOwnWidget = True + + @staticmethod + def is_available(): +# usePhonon = QtCore.QSettings().value( +# u'media/use phonon', QtCore.QVariant(True)).toBool() + return True + + def get_supported_file_types(self): + self.supported_file_types = ['avi'] + self.additional_extensions = { + u'audio/ac3': [u'.ac3'], + u'audio/flac': [u'.flac'], + u'audio/x-m4a': [u'.m4a'], + u'audio/midi': [u'.mid', u'.midi'], + u'audio/x-mp3': [u'.mp3'], + u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], + u'audio/qcelp': [u'.qcp'], + u'audio/x-wma': [u'.wma'], + u'audio/x-ms-wma': [u'.wma'], + u'video/x-flv': [u'.flv'], + u'video/x-matroska': [u'.mpv', u'.mkv'], + u'video/x-wmv': [u'.wmv'], + u'video/x-ms-wmv': [u'.wmv']} def load(self, display, path, volume): print "load vid in Phonon Controller" - display.phononActive = True display.mediaObject.stop() display.mediaObject.clearQueue() display.mediaObject.setCurrentSource(Phonon.MediaSource(path)) @@ -65,10 +99,11 @@ class PhononController(MediaController): vol = float(volume) / float(10) display.audio.setVolume(vol) - def resize(self, display): + def resize(self, display, controller): display.phononWidget.resize(display.size()) def play(self, display): + self.set_visible(display, True) vol = float(display.parent.volume) / float(10) display.audio.setVolume(vol) display.mediaObject.play() @@ -92,7 +127,11 @@ class PhononController(MediaController): display.mediaObject.stop() display.mediaObject.clearQueue() display.phononWidget.setVisible(False) - #display.webView.setVisible(True) + self.state = MediaState.Off + + def set_visible(self, display, status): + if self.hasOwnWidget: + display.phononWidget.setVisible(status) def update_ui(self, controller, display): controller.seekSlider.setMaximum(display.mediaObject.totalTime()) diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index d75dbd4cb..8c9f44152 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -26,7 +26,11 @@ ############################################################################### import sys - +try: + import vlc +except: + pass +from PyQt4 import QtCore, QtGui from openlp.plugins.media.lib import MediaController, MediaState class VlcController(MediaController): @@ -37,6 +41,28 @@ class VlcController(MediaController): def __init__(self, parent): MediaController.__init__(self, parent) self.parent = parent + + def setup(self, display): + display.vlcWidget = QtGui.QFrame(display) + # creating a basic vlc instance + display.vlcInstance = vlc.Instance() + display.vlcInstance.set_log_verbosity(2) + # creating an empty vlc media player + display.vlcMediaPlayer = display.vlcInstance.media_player_new() + display.vlcWidget.resize(display.size()) + display.vlcWidget.raise_() + display.vlcWidget.hide() + self.hasOwnWidget = True + + @staticmethod + def is_available(): + try: + import vlc + return True + except: + return False + + def get_supported_file_types(self): self.supported_file_types = ['avi'] self.additional_extensions = { u'audio/ac3': [u'.ac3'], @@ -58,7 +84,8 @@ class VlcController(MediaController): vol = float(volume) / float(10) # create the media - display.vlcMedia = display.vlcInstance.media_new(unicode(path)) + #display.vlcMedia = display.vlcInstance.media_new(unicode(path)) + display.vlcMedia = display.vlcInstance.media_new_path(unicode(path)) # put the media in the media player display.vlcMediaPlayer.set_media(display.vlcMedia) @@ -77,10 +104,11 @@ class VlcController(MediaController): elif sys.platform == "darwin": # for MacOS display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) - def resize(self, display): + def resize(self, display, controller): display.vlcWidget.resize(display.size()) def play(self, display): + self.set_visible(display, True) display.vlcMediaPlayer.play() self.state = MediaState.Playing @@ -100,8 +128,14 @@ class VlcController(MediaController): display.vlcMediaPlayer.set_position(seekVal/1000.0) def reset(self, display): + display.vlcMediaPlayer.stop() display.vlcWidget.setVisible(False) - #display.webView.setVisible(True) + self.state = MediaState.Off + + def set_visible(self, display, status): + print display.vlcWidget.isVisible(), status + if self.hasOwnWidget: + display.vlcWidget.setVisible(status) def update_ui(self, controller, display): controller.seekSlider.setMaximum(1000) diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index b8ef4d814..2c658437a 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -25,6 +25,7 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### +from PyQt4 import QtCore, QtGui, QtWebKit from openlp.plugins.media.lib import MediaController, MediaState class WebkitController(MediaController): @@ -40,12 +41,38 @@ class WebkitController(MediaController): self.additional_extensions = { u'video/shockwave': [u'.swf']} + def setup(self, display): +# if display == self.parent.previewController.previewDisplay or \ +# display == self.parent.liveController.previewDisplay: +# display.webView.resize(display.size()) + display.webView.raise_() + self.hasOwnWidget = False + + @staticmethod + def is_available(): + return True + + def get_supported_file_types(self): + self.supported_file_types = ['avi'] + self.additional_extensions = { + u'audio/ac3': [u'.ac3'], + u'audio/flac': [u'.flac'], + u'audio/x-m4a': [u'.m4a'], + u'audio/midi': [u'.mid', u'.midi'], + u'audio/x-mp3': [u'.mp3'], + u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], + u'audio/qcelp': [u'.qcp'], + u'audio/x-wma': [u'.wma'], + u'audio/x-ms-wma': [u'.wma'], + u'video/x-flv': [u'.flv'], + u'video/x-matroska': [u'.mpv', u'.mkv'], + u'video/x-wmv': [u'.wmv'], + u'video/x-ms-wmv': [u'.wmv']} + def load(self, display, path, volume): print "load vid in Webkit Controller" vol = float(volume) / float(10) display.webView.setVisible(True) - display.phononWidget.setVisible(False) - display.vlcWidget.setVisible(False) if path.endswith(u'.swf'): js = u'show_flash("load","%s");' % \ (path.replace(u'\\', u'\\\\')) @@ -58,10 +85,10 @@ class WebkitController(MediaController): def resize(self, display, controller): if display == controller.previewDisplay: - print display.size() display.webView.resize(display.size()) def play(self, display): + self.set_visible(display, True) if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("play","");') else: @@ -89,22 +116,28 @@ class WebkitController(MediaController): def seek(self, display, seekVal): if not self.isFlash: - display.frame.evaluateJavaScript(u'show_video("seek", "%f");' % (float(seekVal)/1000)) + seek = float(seekVal)/1000 + display.frame.evaluateJavaScript(u'show_video("seek", null, null, null, "%f");' % (seek)) def reset(self, display): if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("close","");') else: display.frame.evaluateJavaScript(u'show_video("close");') + self.state = MediaState.Off + + def set_visible(self, display, status): + if self.hasOwnWidget: + display.webView.setVisible(status) def update_ui(self, controller, display): - return if not self.isFlash: + currentTime = display.frame.evaluateJavaScript(u'show_video("currentTime");') length = display.frame.evaluateJavaScript(u'show_video("length");') - controller.seekSlider.setMaximum(length.toFloat()[0]*1000) - if not controller.seekSlider.isSliderDown(): - currentTime = display.frame.evaluateJavaScript(u'show_video("currentTime");') - controller.seekSlider.setSliderPosition(currentTime.toFloat()[0]*1000) + if int(currentTime.toFloat()[0]*1000) > 0: + controller.seekSlider.setMaximum(int(length.toFloat()[0]*1000)) + if not controller.seekSlider.isSliderDown(): + controller.seekSlider.setSliderPosition(int(currentTime.toFloat()[0]*1000)) def get_supported_file_types(self): pass From 578e0fea3f826b10d96b504f4b329b7a26b85258 Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Sat, 21 May 2011 10:18:52 +0200 Subject: [PATCH 06/41] cleanups, add settings dialog --- openlp/core/ui/slidecontroller.py | 8 +- openlp/plugins/media/lib/__init__.py | 54 ++++++- openlp/plugins/media/lib/mediacontroller.py | 137 ++++++++++-------- openlp/plugins/media/lib/mediaitem.py | 27 ---- openlp/plugins/media/lib/mediatab.py | 142 +++++++++++++++++-- openlp/plugins/media/lib/phononcontroller.py | 35 ++++- openlp/plugins/media/lib/vlccontroller.py | 49 ++++--- openlp/plugins/media/lib/webkitcontroller.py | 16 ++- 8 files changed, 326 insertions(+), 142 deletions(-) diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index a4242c0ff..fe1d733c6 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -297,11 +297,11 @@ class SlideController(QtGui.QWidget): # Signals QtCore.QObject.connect(self.previewListWidget, QtCore.SIGNAL(u'clicked(QModelIndex)'), self.onSlideSelected) + QtCore.QObject.connect(self.seekSlider, + QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaSeek) + QtCore.QObject.connect(self.volumeSlider, + QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaVolume) if self.isLive: - QtCore.QObject.connect(self.seekSlider, - QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaSeek) - QtCore.QObject.connect(self.volumeSlider, - QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaVolume) QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'maindisplay_active'), self.updatePreview) QtCore.QObject.connect(Receiver.get_receiver(), diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 5324f7025..396beadac 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -35,7 +35,7 @@ class MediaBackends(object): class MediaState(object): """ An enumeration for possible States of the Media Player - (copied from Phonon::State + (copied partially from Phonon::State) """ Loading = 0 Stopped = 1 @@ -50,54 +50,96 @@ class MediaController(object): """ def __init__(self, parent): self.parent = parent + self.isActive = False self.state = MediaState.Off self.hasOwnWidget = False def setup(self, display): + """ + Create the related widgets for the current display + """ pass def load(self, display, path, volume): - pass + """ + Load a new media file and check if it is valid + """ + return True def resize(self, display, controller): + """ + If the main display size or position is changed, + the media widgets should also resized + """ pass def play(self, display): + """ + Starts playing of current Media File + """ pass def pause(self, display): + """ + Pause of current Media File + """ pass def stop(self, display): + """ + Stop playing of current Media File + """ pass def volume(self, display, vol): + """ + Change volume of current Media File + """ pass def seek(self, display, seekVal): + """ + Change playing position of current Media File + """ pass def reset(self, display): + """ + Remove the current loaded video + """ pass def set_visible(self, display, status): + """ + Show/Hide the media widgets + """ pass def update_ui(self, controller, display): + """ + Do some ui related stuff + (e.g. update the seek slider) + """ pass @staticmethod def is_available(): - pass + """ + Check availability of the related backend + """ + return False def get_supported_file_types(self): + """ + Returns the supported file types for + Audio + Video + Locations + """ pass from mediaitem import MediaMediaItem from mediatab import MediaTab from mediacontroller import MediaManager -from webkitcontroller import WebkitController -#from phononcontroller import PhononController -#from vlccontroller import VlcController __all__ = ['MediaMediaItem'] diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 4e70737fa..0f7421e04 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -28,15 +28,10 @@ import logging import sys, os -from PyQt4 import QtCore -#try: -# import vlc -#except: -# pass from PyQt4 import QtCore, QtGui, QtWebKit -from PyQt4.phonon import Phonon -from openlp.core.lib import Receiver +from openlp.core.lib import Receiver, translate +from openlp.core.lib.ui import UiStrings, critical_error_message_box from openlp.plugins.media.lib import MediaBackends, MediaState from webkitcontroller import WebkitController from phononcontroller import PhononController @@ -47,30 +42,28 @@ log = logging.getLogger(__name__) class MediaManager(object): """ The implementation of a Media Manager - The idea is to separate the media related implementation into the plugin files - and unify the access from other parts of code + The idea is to separate the media related implementation + into the plugin files and unify the access from other parts of code The media manager adds an own class for every type of backend Currently these are QtWebkit, Phonon and planed Vlc. - On the other hand currently the previewController display only use phonon for media output. - So I would suggest to rename the maindisplay.py to display.py and modify the code, - so that the display class can be used for the maindisplay as well as for the previewController display. """ def __init__(self, parent): self.parent = parent - self.backend = {} + self.backends = {} self.curDisplayMediaController = {} - #one controller for every backend + #Create Backend Controllers if WebkitController.is_available(): - self.backend['webkit'] = WebkitController(self) + self.backends['webkit'] = WebkitController(self) if PhononController.is_available(): - self.backend['phonon'] = PhononController(self) + self.backends['phonon'] = PhononController(self) if VlcController.is_available(): - self.backend['vlc'] = VlcController(self) + self.backends['vlc'] = VlcController(self) #Timer for video state self.Timer = QtCore.QTimer() self.Timer.setInterval(200) - #signals + self.withLivePreview = False + #Signals QtCore.QObject.connect(self.Timer, QtCore.SIGNAL("timeout()"), self.video_state) QtCore.QObject.connect(Receiver.get_receiver(), @@ -108,28 +101,35 @@ class MediaManager(object): for display in self.curDisplayMediaController.keys(): if display == self.parent.previewController.previewDisplay or \ display == self.parent.previewController.display: - self.curDisplayMediaController[display].update_ui(self.parent.previewController, display) + self.curDisplayMediaController[display] \ + .update_ui(self.parent.previewController, display) else: - self.curDisplayMediaController[display].update_ui(self.parent.liveController, display) - if self.curDisplayMediaController[display].state == MediaState.Playing: + self.curDisplayMediaController[display] \ + .update_ui(self.parent.liveController, display) + if self.curDisplayMediaController[display] \ + .state == MediaState.Playing: isAnyonePlaying = True if not isAnyonePlaying: self.Timer.stop() def setup_display(self, display): - # check controller relevant displays - if display == self.parent.previewController.previewDisplay or \ - display == self.parent.liveController.display: - for backend_typ in self.backend.values(): - backend_typ.setup(display) + """ + After a new display is configured, all media related widget + will be created too + """ + if not self.withLivePreview and \ + display == self.parent.liveController.previewDisplay: + return + for backend in self.backends.values(): + backend.setup(display) def resize(self, controller): """ - after Mainwindow changes or Splitter moved all related media + After Mainwindow changes or Splitter moved all related media widgets have to be resized """ pass - #has to be clarified + #TODO #for display in self.curDisplayMediaController.keys(): # self.curDisplayMediaController[display].resize(display, controller) @@ -143,29 +143,41 @@ class MediaManager(object): isBackground = msg[3] log.debug(u'video') vol = float(volume) / float(10) + isValid = False #stop running videos self.video_reset(controller) if controller.isLive: +# if isBackground: # We are running a background theme controller.display.override[u'theme'] = u'' controller.display.override[u'video'] = True -# display = controller.previewDisplay -# self.check_file_type(display, videoPath, False) -# self.curDisplayMediaController[display].load(display, videoPath, volume) + if self.withLivePreview: + display = controller.previewDisplay + if self.check_file_type(display, videoPath, False): + self.curDisplayMediaController[display] \ + .load(display, videoPath, volume) display = controller.display - self.check_file_type(display, videoPath, False) - self.curDisplayMediaController[display].load(display, videoPath, volume) + if self.check_file_type(display, videoPath, isBackground): + isValid = self.curDisplayMediaController[display] \ + .load(display, videoPath, volume) controller.display.webLoaded = True else: display = controller.previewDisplay - self.check_file_type(display, videoPath, False) - self.curDisplayMediaController[display].load(display, videoPath, volume) + self.check_file_type(display, videoPath, isBackground) + isValid = self.curDisplayMediaController[display] \ + .load(display, videoPath, volume) + if not isValid: + #Media could not be loaded correctly + critical_error_message_box( + translate('MediaPlugin.MediaItem', 'Unsupported File'), + unicode(translate('MediaPlugin.MediaItem', + 'Unsupported File'))) + return #check size of all media_widgets self.resize(controller) #now start playing - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].play(display) + print self.curDisplayMediaController[display] + self.video_play(controller) def check_file_type(self, display, videoPath, isBackground): """ @@ -173,19 +185,19 @@ class MediaManager(object): from the prioritized backend list """ if videoPath.endswith(u'.swf') or isBackground: - self.curDisplayMediaController[display] = self.backend['webkit'] - elif videoPath.endswith(u'.wmv'): - self.curDisplayMediaController[display] = self.backend['phonon'] + self.curDisplayMediaController[display] = self.backends['webkit'] + elif QtCore.QSettings().value(u'media/use webkit', + QtCore.QVariant(True)).toInt()[0] == 0: + self.curDisplayMediaController[display] = self.backends['webkit'] + elif QtCore.QSettings().value(u'media/use vlc', + QtCore.QVariant(True)).toInt()[0] == 0: + self.curDisplayMediaController[display] = self.backends['vlc'] + elif QtCore.QSettings().value(u'media/use phonon', + QtCore.QVariant(True)).toInt()[0] == 0: + self.curDisplayMediaController[display] = self.backends['phonon'] else: - self.curDisplayMediaController[display] = self.backend['vlc'] - for key in self.backend.keys(): - if self.backend[key] == self.curDisplayMediaController[display]: - self.backend[key].set_visible(display, True) -# else: -# self.backend[key].set_visible(display, False) - if len(self.curDisplayMediaController) > 0: - if not self.Timer.isActive(): - self.Timer.start() + return False + return True def video_play(self, controller): """ @@ -198,7 +210,6 @@ class MediaManager(object): # show screen if not self.Timer.isActive(): self.Timer.start() - #display.setVisible(True) def video_pause(self, controller): """ @@ -258,7 +269,6 @@ class MediaManager(object): if display.parent == controller: self.curDisplayMediaController[display].seek(display, seekVal) - def video_reset(self, controller): """ Responds to the request to reset a loaded video @@ -268,48 +278,49 @@ class MediaManager(object): if display.parent == controller: self.curDisplayMediaController[display].reset(display) del self.curDisplayMediaController[display] -# if controller.isLive: - #Receiver.send_message(u'maindisplay_active') def video_hide(self, msg): """ Hide the related video Widget """ - print "hide" isLive = msg[1] if isLive: controller = self.parent.liveController for display in self.curDisplayMediaController.keys(): if display.parent == controller: - if self.curDisplayMediaController[display].state == MediaState.Playing: + if self.curDisplayMediaController[display] \ + .state == MediaState.Playing: self.curDisplayMediaController[display].pause(display) - self.curDisplayMediaController[display].set_visible(display, False) + self.curDisplayMediaController[display] \ + .set_visible(display, False) def video_blank(self, msg): """ Blank the related video Widget """ - print "blank" isLive = msg[1] if isLive: controller = self.parent.liveController for display in self.curDisplayMediaController.keys(): if display.parent == controller: - if self.curDisplayMediaController[display].state == MediaState.Playing: + if self.curDisplayMediaController[display] \ + .state == MediaState.Playing: self.curDisplayMediaController[display].pause(display) - self.curDisplayMediaController[display].set_visible(display, False) + self.curDisplayMediaController[display] \ + .set_visible(display, False) def video_unblank(self, msg): """ Unblank the related video Widget """ - print "unblank" Receiver.send_message(u'maindisplay_show') isLive = msg[1] if isLive: controller = self.parent.liveController for display in self.curDisplayMediaController.keys(): if display.parent == controller: - if self.curDisplayMediaController[display].state == MediaState.Paused: + if self.curDisplayMediaController[display] \ + .state == MediaState.Paused: self.curDisplayMediaController[display].play(display) - self.curDisplayMediaController[display].set_visible(display, True) + self.curDisplayMediaController[display] \ + .set_visible(display, True) diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index 345db4613..ae46e7b5c 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -24,7 +24,6 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -from datetime import datetime import logging import os @@ -89,7 +88,6 @@ class MediaMediaItem(MediaManagerItem): Called to reset the Live backgound with the media selected, """ self.resetAction.setVisible(False) - #self.parent.liveController.display.resetVideo() Receiver.send_message(u'media_reset', self.parent.liveController) @@ -132,17 +130,6 @@ class MediaMediaItem(MediaManagerItem): unicode(translate('MediaPlugin.MediaItem', 'The file %s no longer exists.')) % filename) return False -# self.mediaObject.stop() -# self.mediaObject.clearQueue() -# self.mediaObject.setCurrentSource(Phonon.MediaSource(filename)) -# if not self.mediaStateWait(Phonon.Stopped): - # Due to string freeze, borrow a message from presentations - # This will be corrected in 1.9.6 -# critical_error_message_box( -# translate('PresentationPlugin.MediaItem', 'Unsupported File'), -# unicode(translate('PresentationPlugin.MediaItem', -# 'Unsupported File'))) - #return False # File too big for processing if os.path.getsize(filename) <= 52428800: # 50MiB # self.mediaObject.play() @@ -172,20 +159,6 @@ class MediaMediaItem(MediaManagerItem): service_item.add_from_command(path, name, frame) return True - def mediaStateWait(self, mediaState): - """ - Wait for the video to change its state - Wait no longer than 5 seconds. - """ - start = datetime.now() - while self.mediaObject.state() != mediaState: - if self.mediaObject.state() == Phonon.ErrorState: - return False - Receiver.send_message(u'openlp_process_events') - if (datetime.now() - start).seconds > 5: - return False - return True - def initialise(self): self.listView.clear() self.listView.setIconSize(QtCore.QSize(88, 50)) diff --git a/openlp/plugins/media/lib/mediatab.py b/openlp/plugins/media/lib/mediatab.py index f54aa02fa..21873f658 100644 --- a/openlp/plugins/media/lib/mediatab.py +++ b/openlp/plugins/media/lib/mediatab.py @@ -38,40 +38,152 @@ class MediaTab(SettingsTab): def setupUi(self): self.setObjectName(u'MediaTab') SettingsTab.setupUi(self) - self.mediaModeGroupBox = QtGui.QGroupBox(self.leftColumn) - self.mediaModeGroupBox.setObjectName(u'mediaModeGroupBox') - self.mediaModeLayout = QtGui.QFormLayout(self.mediaModeGroupBox) - self.mediaModeLayout.setObjectName(u'mediaModeLayout') - self.usePhononCheckBox = QtGui.QCheckBox(self.mediaModeGroupBox) + self.mediaLayoutWidget = QtGui.QWidget(self.leftColumn) + self.mediaBackendLayout = QtGui.QVBoxLayout(self.mediaLayoutWidget) + self.mediaBackendLayout.setObjectName(u'mediaBackendLayout') + self.mediaBackendsGroupBox = QtGui.QGroupBox(self.mediaLayoutWidget) + self.mediaBackendsGroupBox.setObjectName(u'mediaBackendsGroupBox') + self.mediaBackendsGroupLayout = QtGui.QVBoxLayout( \ + self.mediaBackendsGroupBox) + self.mediaBackendsGroupLayout.setObjectName( \ + u'mediaBackendsGroupLayout') + self.usePhononCheckBox = QtGui.QCheckBox(self.mediaBackendsGroupBox) self.usePhononCheckBox.setObjectName(u'usePhononCheckBox') - self.mediaModeLayout.addRow(self.usePhononCheckBox) - self.leftLayout.addWidget(self.mediaModeGroupBox) + self.mediaBackendsGroupLayout.addWidget(self.usePhononCheckBox) + self.useVlcCheckBox = QtGui.QCheckBox(self.mediaBackendsGroupBox) + self.useVlcCheckBox.setObjectName(u'useVlcCheckBox') + self.mediaBackendsGroupLayout.addWidget(self.useVlcCheckBox) + self.mediaBackendLayout.addWidget(self.mediaBackendsGroupBox) + self.backendOrderLabel = QtGui.QLabel(self.mediaLayoutWidget) + self.backendOrderLabel.setObjectName(u'backendOrderLabel') + self.mediaBackendLayout.addWidget(self.backendOrderLabel) + self.backendOrderlistWidget = QtGui.QListWidget(self.mediaLayoutWidget) + self.backendOrderlistWidget.setVerticalScrollBarPolicy( \ + QtCore.Qt.ScrollBarAsNeeded) + self.backendOrderlistWidget.setHorizontalScrollBarPolicy( \ + QtCore.Qt.ScrollBarAlwaysOff) + self.backendOrderlistWidget.setEditTriggers( \ + QtGui.QAbstractItemView.NoEditTriggers) + self.backendOrderlistWidget.setObjectName(u'backendOrderlistWidget') + self.mediaBackendLayout.addWidget(self.backendOrderlistWidget) + self.orderingButtonLayout = QtGui.QHBoxLayout() + self.orderingButtonLayout.setObjectName(u'orderingButtonLayout') + self.orderingDownButton = QtGui.QPushButton(self.mediaLayoutWidget) + self.orderingDownButton.setObjectName(u'orderingDownButton') + self.orderingButtonLayout.addWidget(self.orderingDownButton) + self.orderingUpButton = QtGui.QPushButton(self.mediaLayoutWidget) + self.orderingUpButton.setObjectName(u'orderingUpButton') + self.orderingButtonLayout.addWidget(self.orderingUpButton) + self.mediaBackendLayout.addLayout(self.orderingButtonLayout) + + self.leftLayout.addWidget(self.mediaLayoutWidget) self.leftLayout.addStretch() self.rightLayout.addStretch() QtCore.QObject.connect(self.usePhononCheckBox, QtCore.SIGNAL(u'stateChanged(int)'), self.onUsePhononCheckBoxChanged) + QtCore.QObject.connect(self.useVlcCheckBox, + QtCore.SIGNAL(u'stateChanged(int)'), + self.onUseVlcCheckBoxChanged) + QtCore.QObject.connect(self.orderingUpButton, + QtCore.SIGNAL(u'pressed()'), self.onOrderingUpButtonPressed) + QtCore.QObject.connect(self.orderingDownButton, + QtCore.SIGNAL(u'pressed()'), self.onOrderingDownButtonPressed) def retranslateUi(self): - self.mediaModeGroupBox.setTitle( - translate('MediaPlugin.MediaTab', 'Media Display')) self.usePhononCheckBox.setText( - translate('MediaPlugin.MediaTab', 'Use Phonon for video playback')) + translate('MediaPlugin.MediaTab', 'use Phonon')) + self.useVlcCheckBox.setText( + translate('MediaPlugin.MediaTab', 'use Vlc')) + self.backendOrderLabel.setText( + translate('MediaPlugin.MediaTab', 'Backend Order')) + self.orderingDownButton.setText( + translate('MediaPlugin.MediaTab', 'Down')) + self.orderingUpButton.setText( + translate('MediaPlugin.MediaTab', 'Up')) def onUsePhononCheckBoxChanged(self, check_state): - self.usePhonon = (check_state == QtCore.Qt.Checked) - self.usePhononChanged = True + if check_state == QtCore.Qt.Checked: + self.usePhonon = self.backendOrderlistWidget.count() + else: + self.usePhonon = -1 + self.updateBackendList() + + def onUseVlcCheckBoxChanged(self, check_state): + if check_state == QtCore.Qt.Checked: + self.useVlc = self.backendOrderlistWidget.count() + else: + self.useVlc = -1 + self.updateBackendList() + + def onOrderingUpButtonPressed(self): + currentRow = self.backendOrderlistWidget.currentRow() + if currentRow > 0: + item = self.backendOrderlistWidget.takeItem(currentRow) + self.backendOrderlistWidget.insertItem(currentRow-1, item) + self.backendOrderlistWidget.setCurrentRow(currentRow-1) + self.updateOrdering() + + def onOrderingDownButtonPressed(self): + currentRow = self.backendOrderlistWidget.currentRow() + if currentRow < self.backendOrderlistWidget.count()-1: + item = self.backendOrderlistWidget.takeItem(currentRow) + self.backendOrderlistWidget.insertItem(currentRow+1, item) + self.backendOrderlistWidget.setCurrentRow(currentRow+1) + self.updateOrdering() + + def updateOrdering(self): + for num in range (0, self.backendOrderlistWidget.count()): + item = self.backendOrderlistWidget.item(num) + if item.text == u'Webkit': + self.useWebkit = num + elif item.text == u'Phonon': + self.usePhonon = num + elif item.text == u'Vlc': + self.useVlc = num + + def updateBackendList(self): + self.backendOrderlistWidget.clear() + for num in range(0, 3): + if self.useWebkit == num: + self.backendOrderlistWidget.addItem(u'Webkit') + elif self.usePhonon == num: + self.backendOrderlistWidget.addItem(u'Phonon') + elif self.useVlc == num: + self.backendOrderlistWidget.addItem(u'Vlc') def load(self): + self.useWebkit = QtCore.QSettings().value( + self.settingsSection + u'/use webkit', + QtCore.QVariant(True)).toInt()[0] self.usePhonon = QtCore.QSettings().value( self.settingsSection + u'/use phonon', - QtCore.QVariant(True)).toBool() - self.usePhononCheckBox.setChecked(self.usePhonon) + QtCore.QVariant(True)).toInt()[0] + self.useVlc = QtCore.QSettings().value( + self.settingsSection + u'/use vlc', + QtCore.QVariant(True)).toInt()[0] + self.usePhononCheckBox.setChecked((self.usePhonon != -1)) + self.useVlcCheckBox.setChecked((self.useVlc != -1)) def save(self): + changedValues = False + oldUseWebkit = QtCore.QSettings().value( + u'media/use webkit', QtCore.QVariant(True)).toInt()[0] + if oldUseWebkit != self.useWebkit: + QtCore.QSettings().setValue(self.settingsSection + u'/use webkit', + QtCore.QVariant(self.useWebkit)) + changedValues = True oldUsePhonon = QtCore.QSettings().value( - u'media/use phonon', QtCore.QVariant(True)).toBool() + u'media/use phonon', QtCore.QVariant(True)).toInt()[0] if oldUsePhonon != self.usePhonon: QtCore.QSettings().setValue(self.settingsSection + u'/use phonon', QtCore.QVariant(self.usePhonon)) + changedValues = True + oldUseVlc = QtCore.QSettings().value( + u'media/use vlc', QtCore.QVariant(True)).toInt()[0] + if oldUseVlc != self.useVlc: + QtCore.QSettings().setValue(self.settingsSection + u'/use vlc', + QtCore.QVariant(self.useVlc)) + changedValues = True + if changedValues: Receiver.send_message(u'config_screen_changed') diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index d7fa78a81..9343490e3 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -25,11 +25,17 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### +import logging +from datetime import datetime + from PyQt4 import QtCore, QtGui from PyQt4.phonon import Phonon +from openlp.core.lib import Receiver from openlp.plugins.media.lib import MediaController, MediaState +log = logging.getLogger(__name__) + class PhononController(MediaController): """ Specialiced MediaController class @@ -59,7 +65,8 @@ class PhononController(MediaController): display.phononWidget.setVisible(False) display.phononWidget.resize(display.size()) display.mediaObject = Phonon.MediaObject(display) - display.audio = Phonon.AudioOutput(Phonon.VideoCategory, display.mediaObject) + display.audio = Phonon.AudioOutput( \ + Phonon.VideoCategory, display.mediaObject) Phonon.createPath(display.mediaObject, display.phononWidget) Phonon.createPath(display.mediaObject, display.audio) display.phononWidget.raise_() @@ -90,14 +97,27 @@ class PhononController(MediaController): u'video/x-ms-wmv': [u'.wmv']} def load(self, display, path, volume): - print "load vid in Phonon Controller" - display.mediaObject.stop() - display.mediaObject.clearQueue() + log.debug(u'load vid in Phonon Controller') display.mediaObject.setCurrentSource(Phonon.MediaSource(path)) - # Need the timer to trigger set the trigger to 200ms - # Value taken from web documentation. + if not self.mediaStateWait(display, Phonon.StoppedState): + return False vol = float(volume) / float(10) display.audio.setVolume(vol) + return True + + def mediaStateWait(self, display, mediaState): + """ + Wait for the video to change its state + Wait no longer than 5 seconds. + """ + start = datetime.now() + while display.mediaObject.state() != mediaState: + if display.mediaObject.state() == Phonon.ErrorState: + return False + Receiver.send_message(u'openlp_process_events') + if (datetime.now() - start).seconds > 5: + return False + return True def resize(self, display, controller): display.phononWidget.resize(display.size()) @@ -136,7 +156,8 @@ class PhononController(MediaController): def update_ui(self, controller, display): controller.seekSlider.setMaximum(display.mediaObject.totalTime()) if not controller.seekSlider.isSliderDown(): - controller.seekSlider.setSliderPosition(display.mediaObject.currentTime()) + controller.seekSlider.setSliderPosition( \ + display.mediaObject.currentTime()) # if newState == Phonon.Playing \ # and oldState != Phonon.Paused \ # and self.serviceItem.start_time > 0: diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index 8c9f44152..9b3de6f3c 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -25,14 +25,19 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### +import logging import sys +from datetime import datetime try: import vlc except: pass from PyQt4 import QtCore, QtGui +from openlp.core.lib import Receiver from openlp.plugins.media.lib import MediaController, MediaState +log = logging.getLogger(__name__) + class VlcController(MediaController): """ Specialiced MediaController class @@ -52,6 +57,17 @@ class VlcController(MediaController): display.vlcWidget.resize(display.size()) display.vlcWidget.raise_() display.vlcWidget.hide() + # 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 == "linux2": # for Linux using the X Server + display.vlcMediaPlayer.set_xwindow(int(display.vlcWidget.winId())) + elif sys.platform == "win32": # for Windows + display.vlcMediaPlayer.set_hwnd(int(display.vlcWidget.winId())) + elif sys.platform == "darwin": # for MacOS + display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) self.hasOwnWidget = True @staticmethod @@ -80,29 +96,31 @@ class VlcController(MediaController): u'video/x-ms-wmv': [u'.wmv']} def load(self, display, path, volume): - print "load vid in Vlc Controller" + log.debug(u'load vid in Vlc Controller') vol = float(volume) / float(10) - # create the media - #display.vlcMedia = display.vlcInstance.media_new(unicode(path)) display.vlcMedia = display.vlcInstance.media_new_path(unicode(path)) # put the media in the media player display.vlcMediaPlayer.set_media(display.vlcMedia) - # parse the metadata of the file display.vlcMedia.parse() + if not self.mediaStateWait(display): + return False + return True - # 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 == "linux2": # for Linux using the X Server - display.vlcMediaPlayer.set_xwindow(int(display.vlcWidget.winId())) - elif sys.platform == "win32": # for Windows - display.vlcMediaPlayer.set_hwnd(int(display.vlcWidget.winId())) - elif sys.platform == "darwin": # for MacOS - display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) + def mediaStateWait(self, display): + """ + Wait for the video to change its state + Wait no longer than 5 seconds. + """ + start = datetime.now() + while not display.vlcMedia.is_parsed(): + if display.vlcMedia.get_state() == vlc.State.Error: + return False + Receiver.send_message(u'openlp_process_events') + if (datetime.now() - start).seconds > 5: + return False + return True def resize(self, display, controller): display.vlcWidget.resize(display.size()) @@ -133,7 +151,6 @@ class VlcController(MediaController): self.state = MediaState.Off def set_visible(self, display, status): - print display.vlcWidget.isVisible(), status if self.hasOwnWidget: display.vlcWidget.setVisible(status) diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index 2c658437a..ad5e3ff71 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -25,9 +25,13 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### +import logging + from PyQt4 import QtCore, QtGui, QtWebKit from openlp.plugins.media.lib import MediaController, MediaState +log = logging.getLogger(__name__) + class WebkitController(MediaController): """ Specialiced MediaController class @@ -70,7 +74,7 @@ class WebkitController(MediaController): u'video/x-ms-wmv': [u'.wmv']} def load(self, display, path, volume): - print "load vid in Webkit Controller" + log.debug(u'load vid in Webkit Controller') vol = float(volume) / float(10) display.webView.setVisible(True) if path.endswith(u'.swf'): @@ -82,6 +86,7 @@ class WebkitController(MediaController): (path.replace(u'\\', u'\\\\'), str(vol)) self.isFlash = False display.frame.evaluateJavaScript(js) + return True def resize(self, display, controller): if display == controller.previewDisplay: @@ -117,7 +122,8 @@ class WebkitController(MediaController): def seek(self, display, seekVal): if not self.isFlash: seek = float(seekVal)/1000 - display.frame.evaluateJavaScript(u'show_video("seek", null, null, null, "%f");' % (seek)) + display.frame.evaluateJavaScript( \ + u'show_video("seek", null, null, null, "%f");' % (seek)) def reset(self, display): if self.isFlash: @@ -132,12 +138,14 @@ class WebkitController(MediaController): def update_ui(self, controller, display): if not self.isFlash: - currentTime = display.frame.evaluateJavaScript(u'show_video("currentTime");') + currentTime = display.frame.evaluateJavaScript( \ + u'show_video("currentTime");') length = display.frame.evaluateJavaScript(u'show_video("length");') if int(currentTime.toFloat()[0]*1000) > 0: controller.seekSlider.setMaximum(int(length.toFloat()[0]*1000)) if not controller.seekSlider.isSliderDown(): - controller.seekSlider.setSliderPosition(int(currentTime.toFloat()[0]*1000)) + controller.seekSlider.setSliderPosition( \ + int(currentTime.toFloat()[0]*1000)) def get_supported_file_types(self): pass From d54ef615b4c0f73782e18d32e447539ab9cbd38f Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Mon, 23 May 2011 21:37:44 +0200 Subject: [PATCH 07/41] cleanup, add settings tab --- openlp/plugins/media/lib/__init__.py | 5 +- openlp/plugins/media/lib/mediacontroller.py | 92 ++++++++++++++------ openlp/plugins/media/lib/mediatab.py | 90 +++++++------------ openlp/plugins/media/lib/phononcontroller.py | 32 ++++++- openlp/plugins/media/lib/vlccontroller.py | 30 ++++++- openlp/plugins/media/lib/webkitcontroller.py | 48 +++++----- openlp/plugins/media/mediaplugin.py | 52 +---------- 7 files changed, 190 insertions(+), 159 deletions(-) diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 396beadac..1f1b67f3e 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -51,10 +51,13 @@ class MediaController(object): def __init__(self, parent): self.parent = parent self.isActive = False + self.canBackground = False self.state = MediaState.Off self.hasOwnWidget = False + self.audio_extensions_list = [] + self.video_extensions_list = [] - def setup(self, display): + def setup(self, display, hasAudio): """ Create the related widgets for the current display """ diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 0f7421e04..42c53a10c 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -54,11 +54,11 @@ class MediaManager(object): self.curDisplayMediaController = {} #Create Backend Controllers if WebkitController.is_available(): - self.backends['webkit'] = WebkitController(self) + self.backends[u'Webkit'] = WebkitController(self) if PhononController.is_available(): - self.backends['phonon'] = PhononController(self) + self.backends[u'Phonon'] = PhononController(self) if VlcController.is_available(): - self.backends['vlc'] = VlcController(self) + self.backends[u'Vlc'] = VlcController(self) #Timer for video state self.Timer = QtCore.QTimer() self.Timer.setInterval(200) @@ -117,21 +117,26 @@ class MediaManager(object): After a new display is configured, all media related widget will be created too """ + hasAudio = True if not self.withLivePreview and \ display == self.parent.liveController.previewDisplay: return + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.liveController.previewDisplay: + hasAudio = False for backend in self.backends.values(): - backend.setup(display) + backend.setup(display, hasAudio) def resize(self, controller): """ After Mainwindow changes or Splitter moved all related media widgets have to be resized """ - pass - #TODO - #for display in self.curDisplayMediaController.keys(): - # self.curDisplayMediaController[display].resize(display, controller) + for display in self.curDisplayMediaController.keys(): + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.liveController.previewDisplay: + display.resize(display.parent.slidePreview.size()) + self.curDisplayMediaController[display].resize(display, controller) def video(self, msg): """ @@ -154,18 +159,23 @@ class MediaManager(object): if self.withLivePreview: display = controller.previewDisplay if self.check_file_type(display, videoPath, False): + #check size of all media_widgets + self.resize(controller) self.curDisplayMediaController[display] \ .load(display, videoPath, volume) display = controller.display if self.check_file_type(display, videoPath, isBackground): + #check size of all media_widgets + self.resize(controller) isValid = self.curDisplayMediaController[display] \ .load(display, videoPath, volume) - controller.display.webLoaded = True else: display = controller.previewDisplay - self.check_file_type(display, videoPath, isBackground) - isValid = self.curDisplayMediaController[display] \ - .load(display, videoPath, volume) + if self.check_file_type(display, videoPath, isBackground): + #check size of all media_widgets + self.resize(controller) + isValid = self.curDisplayMediaController[display] \ + .load(display, videoPath, volume) if not isValid: #Media could not be loaded correctly critical_error_message_box( @@ -173,10 +183,8 @@ class MediaManager(object): unicode(translate('MediaPlugin.MediaItem', 'Unsupported File'))) return - #check size of all media_widgets - self.resize(controller) +# controller.display.webLoaded = True #now start playing - print self.curDisplayMediaController[display] self.video_play(controller) def check_file_type(self, display, videoPath, isBackground): @@ -184,20 +192,30 @@ class MediaManager(object): Used to choose the right media backend type from the prioritized backend list """ - if videoPath.endswith(u'.swf') or isBackground: - self.curDisplayMediaController[display] = self.backends['webkit'] - elif QtCore.QSettings().value(u'media/use webkit', - QtCore.QVariant(True)).toInt()[0] == 0: - self.curDisplayMediaController[display] = self.backends['webkit'] - elif QtCore.QSettings().value(u'media/use vlc', - QtCore.QVariant(True)).toInt()[0] == 0: - self.curDisplayMediaController[display] = self.backends['vlc'] - elif QtCore.QSettings().value(u'media/use phonon', - QtCore.QVariant(True)).toInt()[0] == 0: - self.curDisplayMediaController[display] = self.backends['phonon'] - else: - return False - return True + usedBackends = QtCore.QSettings().value(u'media/backends', + QtCore.QVariant(u'Webkit')).toString().split(u',') + media_path = QtCore.QFileInfo(videoPath) + if media_path.isFile(): + suffix = u'*.%s' % media_path.suffix() + for title in usedBackends: + backend = self.backends[str(title)] + if suffix in backend.video_extensions_list: + if isBackground: + if backend.canBackground: + self.curDisplayMediaController[display] = backend + return True + else: + self.curDisplayMediaController[display] = backend + return True + return False +# # Special FileType Check +# if videoPath.endswith(u'.swf') or isBackground: +# self.curDisplayMediaController[display] = self.backends[u'Webkit'] +# else: +# # search extension in available backends +# # currently only use the first available backend +# self.curDisplayMediaController[display] = self.backends[str(usedBackends[0])] +# return True def video_play(self, controller): """ @@ -324,3 +342,19 @@ class MediaManager(object): self.curDisplayMediaController[display].play(display) self.curDisplayMediaController[display] \ .set_visible(display, True) + + def get_audio_extensions_list(self): + audio_list = [] + for backend in self.backends.values(): + for item in backend.audio_extensions_list: + if not item in audio_list: + audio_list.append(item) + return audio_list + + def get_video_extensions_list(self): + video_list = [] + for backend in self.backends.values(): + for item in backend.video_extensions_list: + if not item in video_list: + video_list.append(item) + return video_list diff --git a/openlp/plugins/media/lib/mediatab.py b/openlp/plugins/media/lib/mediatab.py index 21873f658..652720d85 100644 --- a/openlp/plugins/media/lib/mediatab.py +++ b/openlp/plugins/media/lib/mediatab.py @@ -104,25 +104,36 @@ class MediaTab(SettingsTab): def onUsePhononCheckBoxChanged(self, check_state): if check_state == QtCore.Qt.Checked: - self.usePhonon = self.backendOrderlistWidget.count() + self.usePhonon = True + if u'Phonon' not in self.usedBackends: + self.usedBackends.append(u'Phonon') else: - self.usePhonon = -1 + self.usePhonon = False + self.usedBackends.takeAt(self.usedBackends.indexOf(u'Phonon')) self.updateBackendList() def onUseVlcCheckBoxChanged(self, check_state): if check_state == QtCore.Qt.Checked: - self.useVlc = self.backendOrderlistWidget.count() + self.useVlc = True + if u'Vlc' not in self.usedBackends: + self.usedBackends.append(u'Vlc') else: - self.useVlc = -1 + self.useVlc = False + self.usedBackends.takeAt(self.usedBackends.indexOf(u'Vlc')) self.updateBackendList() + def updateBackendList(self): + self.backendOrderlistWidget.clear() + for backend in self.usedBackends: + self.backendOrderlistWidget.addItem(backend) + def onOrderingUpButtonPressed(self): currentRow = self.backendOrderlistWidget.currentRow() if currentRow > 0: item = self.backendOrderlistWidget.takeItem(currentRow) self.backendOrderlistWidget.insertItem(currentRow-1, item) self.backendOrderlistWidget.setCurrentRow(currentRow-1) - self.updateOrdering() + self.usedBackends.move(currentRow, currentRow-1) def onOrderingDownButtonPressed(self): currentRow = self.backendOrderlistWidget.currentRow() @@ -130,60 +141,25 @@ class MediaTab(SettingsTab): item = self.backendOrderlistWidget.takeItem(currentRow) self.backendOrderlistWidget.insertItem(currentRow+1, item) self.backendOrderlistWidget.setCurrentRow(currentRow+1) - self.updateOrdering() - - def updateOrdering(self): - for num in range (0, self.backendOrderlistWidget.count()): - item = self.backendOrderlistWidget.item(num) - if item.text == u'Webkit': - self.useWebkit = num - elif item.text == u'Phonon': - self.usePhonon = num - elif item.text == u'Vlc': - self.useVlc = num - - def updateBackendList(self): - self.backendOrderlistWidget.clear() - for num in range(0, 3): - if self.useWebkit == num: - self.backendOrderlistWidget.addItem(u'Webkit') - elif self.usePhonon == num: - self.backendOrderlistWidget.addItem(u'Phonon') - elif self.useVlc == num: - self.backendOrderlistWidget.addItem(u'Vlc') + self.usedBackends.move(currentRow, currentRow+1) def load(self): - self.useWebkit = QtCore.QSettings().value( - self.settingsSection + u'/use webkit', - QtCore.QVariant(True)).toInt()[0] - self.usePhonon = QtCore.QSettings().value( - self.settingsSection + u'/use phonon', - QtCore.QVariant(True)).toInt()[0] - self.useVlc = QtCore.QSettings().value( - self.settingsSection + u'/use vlc', - QtCore.QVariant(True)).toInt()[0] - self.usePhononCheckBox.setChecked((self.usePhonon != -1)) - self.useVlcCheckBox.setChecked((self.useVlc != -1)) + self.usedBackends = QtCore.QSettings().value( + self.settingsSection + u'/backends', + QtCore.QVariant(u'Webkit')).toString().split(u',') + self.useWebkit = u'Webkit' in self.usedBackends + self.usePhonon = u'Phonon' in self.usedBackends + self.useVlc = u'Vlc' in self.usedBackends + self.usePhononCheckBox.setChecked(self.usePhonon) + self.useVlcCheckBox.setChecked(self.useVlc) + self.updateBackendList() def save(self): - changedValues = False - oldUseWebkit = QtCore.QSettings().value( - u'media/use webkit', QtCore.QVariant(True)).toInt()[0] - if oldUseWebkit != self.useWebkit: - QtCore.QSettings().setValue(self.settingsSection + u'/use webkit', - QtCore.QVariant(self.useWebkit)) - changedValues = True - oldUsePhonon = QtCore.QSettings().value( - u'media/use phonon', QtCore.QVariant(True)).toInt()[0] - if oldUsePhonon != self.usePhonon: - QtCore.QSettings().setValue(self.settingsSection + u'/use phonon', - QtCore.QVariant(self.usePhonon)) - changedValues = True - oldUseVlc = QtCore.QSettings().value( - u'media/use vlc', QtCore.QVariant(True)).toInt()[0] - if oldUseVlc != self.useVlc: - QtCore.QSettings().setValue(self.settingsSection + u'/use vlc', - QtCore.QVariant(self.useVlc)) - changedValues = True - if changedValues: + oldBackendString = QtCore.QSettings().value( + self.settingsSection + u'/backends', + QtCore.QVariant(True)).toString() + newBackendString = self.usedBackends.join(u',') + if oldBackendString != newBackendString: + QtCore.QSettings().setValue(self.settingsSection + u'/backends', + QtCore.QVariant(newBackendString)) Receiver.send_message(u'config_screen_changed') diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index 9343490e3..8a96c4b9d 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -26,6 +26,7 @@ ############################################################################### import logging +import mimetypes from datetime import datetime from PyQt4 import QtCore, QtGui @@ -59,8 +60,37 @@ class PhononController(MediaController): u'video/x-matroska': [u'.mpv', u'.mkv'], u'video/x-wmv': [u'.wmv'], u'video/x-ms-wmv': [u'.wmv']} + mimetypes.init() + for mimetype in Phonon.BackendCapabilities.availableMimeTypes(): + mimetype = unicode(mimetype) + if mimetype.startswith(u'audio/'): + self._addToList(self.audio_extensions_list, mimetype) + elif mimetype.startswith(u'video/'): + self._addToList(self.video_extensions_list, mimetype) - def setup(self, display): + def _addToList(self, list, mimetype): + # Add all extensions which mimetypes provides us for supported types. + extensions = mimetypes.guess_all_extensions(unicode(mimetype)) + for extension in extensions: + ext = u'*%s' % extension + if ext not in list: + list.append(ext) + self.parent.parent.serviceManager.supportedSuffixes(extension[1:]) + log.info(u'MediaPlugin: %s extensions: %s' % (mimetype, + u' '.join(extensions))) + # Add extensions for this mimetype from self.additional_extensions. + # This hack clears mimetypes' and operating system's shortcomings + # by providing possibly missing extensions. + if mimetype in self.additional_extensions.keys(): + for extension in self.additional_extensions[mimetype]: + ext = u'*%s' % extension + if ext not in list: + list.append(ext) + self.parent.parent.serviceManager.supportedSuffixes(extension[1:]) + log.info(u'MediaPlugin: %s additional extensions: %s' % (mimetype, + u' '.join(self.additional_extensions[mimetype]))) + + def setup(self, display, hasAudio): display.phononWidget = Phonon.VideoWidget(display) display.phononWidget.setVisible(False) display.phononWidget.resize(display.size()) diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index 9b3de6f3c..98836ed70 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -46,11 +46,37 @@ class VlcController(MediaController): def __init__(self, parent): MediaController.__init__(self, parent) self.parent = parent + self.video_extensions_list = [ + u'*.3gp' + , u'*.asf', u'*.wmv' + , u'*.au' + , u'*.avi' + , u'*.flv' + , u'*.mov' + , u'*.mp4' + , u'*.ogm', u'*.ogg' + , u'*.mkv', u'*.mka' + , u'*.ts', u'*.mpg' + , u'*.mpg', u'*.mp3', u'*.mp2' + , u'*.nsc' + , u'*.nsv' + , u'*.nut' + , u'*.ra', u'*.ram', u'*.rm', u'*.rv' ,u'*.rmbv' + , u'*.a52', u'*.dts', u'*.aac', u'*.flac' ,u'*.dv', u'*.vid' + , u'*.tta', u'*.tac' + , u'*.ty' + , u'*.wav', u'*.dts' + , u'*.xa' + , u'*.iso' + ] - def setup(self, display): + def setup(self, display, hasAudio): display.vlcWidget = QtGui.QFrame(display) # creating a basic vlc instance - display.vlcInstance = vlc.Instance() + if hasAudio: + display.vlcInstance = vlc.Instance() + else: + display.vlcInstance = vlc.Instance('--no-audio') display.vlcInstance.set_log_verbosity(2) # creating an empty vlc media player display.vlcMediaPlayer = display.vlcInstance.media_player_new() diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index ad5e3ff71..94cba6e46 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -42,13 +42,33 @@ class WebkitController(MediaController): MediaController.__init__(self, parent) self.parent = parent self.isFlash = False - self.additional_extensions = { - u'video/shockwave': [u'.swf']} + self.canBackground = True + self.video_extensions_list = [ + u'*.3gp' + , u'*.3gpp' + , u'*.3g2' + , u'*.3gpp2' + , u'*.aac' + , u'*.flv' + , u'*.f4a' + , u'*.f4b' + , u'*.f4p' + , u'*.f4v' + , u'*.mov' + , u'*.m4a' + , u'*.m4b' + , u'*.m4p' + , u'*.m4v' + , u'*.mkv' + , u'*.mp4' + , u'*.mp3' + , u'*.ogg' + , u'*.ogv' + , u'*.webm' + , u'*.swf', u'*.mpg', u'*.wmv' + ] - def setup(self, display): -# if display == self.parent.previewController.previewDisplay or \ -# display == self.parent.liveController.previewDisplay: -# display.webView.resize(display.size()) + def setup(self, display, hasAudio): display.webView.raise_() self.hasOwnWidget = False @@ -57,21 +77,7 @@ class WebkitController(MediaController): return True def get_supported_file_types(self): - self.supported_file_types = ['avi'] - self.additional_extensions = { - u'audio/ac3': [u'.ac3'], - u'audio/flac': [u'.flac'], - u'audio/x-m4a': [u'.m4a'], - u'audio/midi': [u'.mid', u'.midi'], - u'audio/x-mp3': [u'.mp3'], - u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], - u'audio/qcelp': [u'.qcp'], - u'audio/x-wma': [u'.wma'], - u'audio/x-ms-wma': [u'.wma'], - u'video/x-flv': [u'.flv'], - u'video/x-matroska': [u'.mpv', u'.mkv'], - u'video/x-wmv': [u'.wmv'], - u'video/x-ms-wmv': [u'.wmv']} + pass def load(self, display, path, volume): log.debug(u'load vid in Webkit Controller') diff --git a/openlp/plugins/media/mediaplugin.py b/openlp/plugins/media/mediaplugin.py index d488ae14e..38aaedd70 100644 --- a/openlp/plugins/media/mediaplugin.py +++ b/openlp/plugins/media/mediaplugin.py @@ -25,9 +25,6 @@ ############################################################################### import logging -import mimetypes - -from PyQt4.phonon import Phonon from openlp.core.lib import Plugin, StringContent, build_icon, translate from openlp.plugins.media.lib import MediaMediaItem, MediaTab, MediaManager @@ -45,52 +42,11 @@ class MediaPlugin(Plugin): self.icon = build_icon(self.icon_path) # passed with drag and drop messages self.dnd_id = u'Media' - self.additional_extensions = { - u'audio/ac3': [u'.ac3'], - u'audio/flac': [u'.flac'], - u'audio/x-m4a': [u'.m4a'], - u'audio/midi': [u'.mid', u'.midi'], - u'audio/x-mp3': [u'.mp3'], - u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], - u'audio/qcelp': [u'.qcp'], - u'audio/x-wma': [u'.wma'], - u'audio/x-ms-wma': [u'.wma'], - u'video/x-flv': [u'.flv'], - u'video/x-matroska': [u'.mpv', u'.mkv'], - u'video/x-wmv': [u'.wmv'], - u'video/x-ms-wmv': [u'.wmv']} - self.audio_extensions_list = [] - self.video_extensions_list = [] - mimetypes.init() - for mimetype in Phonon.BackendCapabilities.availableMimeTypes(): - mimetype = unicode(mimetype) - if mimetype.startswith(u'audio/'): - self._addToList(self.audio_extensions_list, mimetype) - elif mimetype.startswith(u'video/'): - self._addToList(self.video_extensions_list, mimetype) self.mediaManager = MediaManager(self) - - def _addToList(self, list, mimetype): - # Add all extensions which mimetypes provides us for supported types. - extensions = mimetypes.guess_all_extensions(unicode(mimetype)) - for extension in extensions: - ext = u'*%s' % extension - if ext not in list: - list.append(ext) - self.serviceManager.supportedSuffixes(extension[1:]) - log.info(u'MediaPlugin: %s extensions: %s' % (mimetype, - u' '.join(extensions))) - # Add extensions for this mimetype from self.additional_extensions. - # This hack clears mimetypes' and operating system's shortcomings - # by providing possibly missing extensions. - if mimetype in self.additional_extensions.keys(): - for extension in self.additional_extensions[mimetype]: - ext = u'*%s' % extension - if ext not in list: - list.append(ext) - self.serviceManager.supportedSuffixes(extension[1:]) - log.info(u'MediaPlugin: %s additional extensions: %s' % (mimetype, - u' '.join(self.additional_extensions[mimetype]))) + self.audio_extensions_list = \ + self.mediaManager.get_audio_extensions_list() + self.video_extensions_list = \ + self.mediaManager.get_video_extensions_list() def about(self): about_text = translate('MediaPlugin', 'Media Plugin' From 82a14745e34ddb6319fb692cb54ae33ca4117752 Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Tue, 24 May 2011 22:03:57 +0200 Subject: [PATCH 08/41] cleanup, correct settings tab --- openlp/core/ui/maindisplay.py | 1 - openlp/core/ui/slidecontroller.py | 1 - openlp/plugins/media/lib/__init__.py | 2 +- openlp/plugins/media/lib/mediacontroller.py | 10 +--- openlp/plugins/media/lib/mediaitem.py | 23 ++------ openlp/plugins/media/lib/mediatab.py | 59 +++++++++++--------- openlp/plugins/media/lib/phononcontroller.py | 15 +++-- openlp/plugins/media/lib/vlccontroller.py | 2 +- openlp/plugins/media/lib/webkitcontroller.py | 15 +++-- 9 files changed, 63 insertions(+), 65 deletions(-) diff --git a/openlp/core/ui/maindisplay.py b/openlp/core/ui/maindisplay.py index 15780b6c5..8d4d50dfb 100644 --- a/openlp/core/ui/maindisplay.py +++ b/openlp/core/ui/maindisplay.py @@ -405,7 +405,6 @@ class MainDisplay(QtGui.QGraphicsView): """ log.debug(u'showDisplay') self.frame.evaluateJavaScript('show_blank("show");') - print "showDisplay", self.isHidden() if self.isHidden(): self.setVisible(True) self.hideMode = None diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index dfdd1c592..7f91c3670 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -849,7 +849,6 @@ class SlideController(QtGui.QWidget): """ Tell the plugin to hide the display screen. """ - print "hidePlugin", hide log.debug(u'hidePlugin %s ', hide) if self.serviceItem is not None: if hide: diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 1f1b67f3e..4469a3be4 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -63,7 +63,7 @@ class MediaController(object): """ pass - def load(self, display, path, volume): + def load(self, display, path, volume, isBackground): """ Load a new media file and check if it is valid """ diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py index 42c53a10c..b84fdc5a9 100644 --- a/openlp/plugins/media/lib/mediacontroller.py +++ b/openlp/plugins/media/lib/mediacontroller.py @@ -152,30 +152,26 @@ class MediaManager(object): #stop running videos self.video_reset(controller) if controller.isLive: -# if isBackground: - # We are running a background theme - controller.display.override[u'theme'] = u'' - controller.display.override[u'video'] = True if self.withLivePreview: display = controller.previewDisplay if self.check_file_type(display, videoPath, False): #check size of all media_widgets self.resize(controller) self.curDisplayMediaController[display] \ - .load(display, videoPath, volume) + .load(display, videoPath, volume, isBackground) display = controller.display if self.check_file_type(display, videoPath, isBackground): #check size of all media_widgets self.resize(controller) isValid = self.curDisplayMediaController[display] \ - .load(display, videoPath, volume) + .load(display, videoPath, volume, isBackground) else: display = controller.previewDisplay if self.check_file_type(display, videoPath, isBackground): #check size of all media_widgets self.resize(controller) isValid = self.curDisplayMediaController[display] \ - .load(display, videoPath, volume) + .load(display, videoPath, volume, isBackground) if not isValid: #Media could not be loaded correctly critical_error_message_box( diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index 6ce461149..3465e570e 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -131,28 +131,13 @@ class MediaMediaItem(MediaManagerItem): unicode(translate('MediaPlugin.MediaItem', 'The file %s no longer exists.')) % filename) return False - # File too big for processing - if os.path.getsize(filename) <= 52428800: # 50MiB -# self.mediaObject.play() -# if not self.mediaStateWait(Phonon.Playing) \ -# or self.mediaObject.currentSource().type() \ -# == Phonon.MediaSource.Invalid: -# # Due to string freeze, borrow a message from presentations -# # This will be corrected in 1.9.6 -# self.mediaObject.stop() -# critical_error_message_box( -# translate('PresentationPlugin.MediaItem', -# 'Unsupported File'), -# unicode(translate('PresentationPlugin.MediaItem', -# 'Unsupported File'))) -# #return False -# self.mediaLength = self.mediaObject.totalTime() / 1000 -# self.mediaObject.stop() -# service_item.media_length = self.mediaLength - service_item.add_capability( + self.mediaLength = 0 + service_item.media_length = self.mediaLength + service_item.add_capability( ItemCapabilities.AllowsVariableStartTime) service_item.title = unicode(self.plugin.nameStrings[u'singular']) service_item.add_capability(ItemCapabilities.RequiresMedia) + #Receiver.send_message(u'media_video', [self.parent.liveController, filename, 0, False]) # force a non-existent theme service_item.theme = -1 frame = u':/media/image_clapperboard.png' diff --git a/openlp/plugins/media/lib/mediatab.py b/openlp/plugins/media/lib/mediatab.py index 652720d85..b54a2df6f 100644 --- a/openlp/plugins/media/lib/mediatab.py +++ b/openlp/plugins/media/lib/mediatab.py @@ -38,26 +38,32 @@ class MediaTab(SettingsTab): def setupUi(self): self.setObjectName(u'MediaTab') SettingsTab.setupUi(self) - self.mediaLayoutWidget = QtGui.QWidget(self.leftColumn) - self.mediaBackendLayout = QtGui.QVBoxLayout(self.mediaLayoutWidget) - self.mediaBackendLayout.setObjectName(u'mediaBackendLayout') - self.mediaBackendsGroupBox = QtGui.QGroupBox(self.mediaLayoutWidget) + self.mediaBackendsGroupBox = QtGui.QGroupBox(self.leftColumn) self.mediaBackendsGroupBox.setObjectName(u'mediaBackendsGroupBox') - self.mediaBackendsGroupLayout = QtGui.QVBoxLayout( \ - self.mediaBackendsGroupBox) - self.mediaBackendsGroupLayout.setObjectName( \ - u'mediaBackendsGroupLayout') + self.mediaBackendLayout = QtGui.QVBoxLayout(self.mediaBackendsGroupBox) + self.mediaBackendLayout.setObjectName(u'mediaBackendLayout') self.usePhononCheckBox = QtGui.QCheckBox(self.mediaBackendsGroupBox) self.usePhononCheckBox.setObjectName(u'usePhononCheckBox') - self.mediaBackendsGroupLayout.addWidget(self.usePhononCheckBox) + self.mediaBackendLayout.addWidget(self.usePhononCheckBox) self.useVlcCheckBox = QtGui.QCheckBox(self.mediaBackendsGroupBox) self.useVlcCheckBox.setObjectName(u'useVlcCheckBox') - self.mediaBackendsGroupLayout.addWidget(self.useVlcCheckBox) - self.mediaBackendLayout.addWidget(self.mediaBackendsGroupBox) - self.backendOrderLabel = QtGui.QLabel(self.mediaLayoutWidget) - self.backendOrderLabel.setObjectName(u'backendOrderLabel') - self.mediaBackendLayout.addWidget(self.backendOrderLabel) - self.backendOrderlistWidget = QtGui.QListWidget(self.mediaLayoutWidget) + self.mediaBackendLayout.addWidget(self.useVlcCheckBox) + self.leftLayout.addWidget(self.mediaBackendsGroupBox) + + self.backendOrderGroupBox = QtGui.QGroupBox(self.leftColumn) + self.backendOrderGroupBox.setObjectName(u'backendOrderGroupBox') + self.backendOrderLayout = QtGui.QVBoxLayout(self.backendOrderGroupBox) + self.backendOrderLayout.setObjectName(u'backendOrderLayout') + self.backendOrderlistWidget = QtGui.QListWidget( \ + self.backendOrderGroupBox) + sizePolicy = QtGui.QSizePolicy(QtGui.QSizePolicy.Minimum, + QtGui.QSizePolicy.Expanding) + sizePolicy.setHorizontalStretch(0) + sizePolicy.setVerticalStretch(0) + sizePolicy.setHeightForWidth(self.backendOrderlistWidget. \ + sizePolicy().hasHeightForWidth()) + self.backendOrderlistWidget.setSizePolicy(sizePolicy) + self.backendOrderlistWidget.setVerticalScrollBarPolicy( \ QtCore.Qt.ScrollBarAsNeeded) self.backendOrderlistWidget.setHorizontalScrollBarPolicy( \ @@ -65,18 +71,19 @@ class MediaTab(SettingsTab): self.backendOrderlistWidget.setEditTriggers( \ QtGui.QAbstractItemView.NoEditTriggers) self.backendOrderlistWidget.setObjectName(u'backendOrderlistWidget') - self.mediaBackendLayout.addWidget(self.backendOrderlistWidget) - self.orderingButtonLayout = QtGui.QHBoxLayout() + self.backendOrderLayout.addWidget(self.backendOrderlistWidget) + self.orderingButtonsWidget = QtGui.QWidget(self.backendOrderGroupBox) + self.orderingButtonsWidget.setObjectName(u'orderingButtonsWidget') + self.orderingButtonLayout = QtGui.QHBoxLayout(self.orderingButtonsWidget) self.orderingButtonLayout.setObjectName(u'orderingButtonLayout') - self.orderingDownButton = QtGui.QPushButton(self.mediaLayoutWidget) + self.orderingDownButton = QtGui.QPushButton(self.orderingButtonsWidget) self.orderingDownButton.setObjectName(u'orderingDownButton') self.orderingButtonLayout.addWidget(self.orderingDownButton) - self.orderingUpButton = QtGui.QPushButton(self.mediaLayoutWidget) + self.orderingUpButton = QtGui.QPushButton(self.backendOrderGroupBox) self.orderingUpButton.setObjectName(u'orderingUpButton') self.orderingButtonLayout.addWidget(self.orderingUpButton) - self.mediaBackendLayout.addLayout(self.orderingButtonLayout) - - self.leftLayout.addWidget(self.mediaLayoutWidget) + self.backendOrderLayout.addWidget(self.orderingButtonsWidget) + self.leftLayout.addWidget(self.backendOrderGroupBox) self.leftLayout.addStretch() self.rightLayout.addStretch() QtCore.QObject.connect(self.usePhononCheckBox, @@ -91,12 +98,14 @@ class MediaTab(SettingsTab): QtCore.SIGNAL(u'pressed()'), self.onOrderingDownButtonPressed) def retranslateUi(self): + self.mediaBackendsGroupBox.setTitle( + translate('MediaPlugin.MediaTab', 'Media Backends')) self.usePhononCheckBox.setText( translate('MediaPlugin.MediaTab', 'use Phonon')) self.useVlcCheckBox.setText( translate('MediaPlugin.MediaTab', 'use Vlc')) - self.backendOrderLabel.setText( - translate('MediaPlugin.MediaTab', 'Backend Order')) + self.backendOrderGroupBox.setTitle( + translate('MediaPlugin.MediaTab', 'Backends Order')) self.orderingDownButton.setText( translate('MediaPlugin.MediaTab', 'Down')) self.orderingUpButton.setText( @@ -157,7 +166,7 @@ class MediaTab(SettingsTab): def save(self): oldBackendString = QtCore.QSettings().value( self.settingsSection + u'/backends', - QtCore.QVariant(True)).toString() + QtCore.QVariant(u'Webkit')).toString() newBackendString = self.usedBackends.join(u',') if oldBackendString != newBackendString: QtCore.QSettings().setValue(self.settingsSection + u'/backends', diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononcontroller.py index 8a96c4b9d..3c0062464 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononcontroller.py @@ -126,7 +126,7 @@ class PhononController(MediaController): u'video/x-wmv': [u'.wmv'], u'video/x-ms-wmv': [u'.wmv']} - def load(self, display, path, volume): + def load(self, display, path, volume, isBackground): log.debug(u'load vid in Phonon Controller') display.mediaObject.setCurrentSource(Phonon.MediaSource(path)) if not self.mediaStateWait(display, Phonon.StoppedState): @@ -185,14 +185,17 @@ class PhononController(MediaController): def update_ui(self, controller, display): controller.seekSlider.setMaximum(display.mediaObject.totalTime()) + if display.serviceItem.end_time > 0: + if display.mediaObject.currentTime() > \ + display.serviceItem.end_time: + self.stop(display) + if display.serviceItem.start_time > 0: + if display.mediaObject.currentTime() < \ + display.serviceItem.start_time: + self.seek(display, self.serviceItem.start_time * 1000) if not controller.seekSlider.isSliderDown(): controller.seekSlider.setSliderPosition( \ display.mediaObject.currentTime()) -# if newState == Phonon.Playing \ -# and oldState != Phonon.Paused \ -# and self.serviceItem.start_time > 0: -# # set start time in milliseconds -# self.mediaObject.seek(self.serviceItem.start_time * 1000) def get_supported_file_types(self): pass diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlccontroller.py index 98836ed70..b1c267858 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlccontroller.py @@ -121,7 +121,7 @@ class VlcController(MediaController): u'video/x-wmv': [u'.wmv'], u'video/x-ms-wmv': [u'.wmv']} - def load(self, display, path, volume): + def load(self, display, path, volume, isBackground): log.debug(u'load vid in Vlc Controller') vol = float(volume) / float(10) # create the media diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitcontroller.py index 94cba6e46..41f94ad36 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitcontroller.py @@ -65,7 +65,7 @@ class WebkitController(MediaController): , u'*.ogg' , u'*.ogv' , u'*.webm' - , u'*.swf', u'*.mpg', u'*.wmv' + , u'*.swf', u'*.mpg', u'*.wmv', u'*.mpeg', u'*.avi' ] def setup(self, display, hasAudio): @@ -79,17 +79,21 @@ class WebkitController(MediaController): def get_supported_file_types(self): pass - def load(self, display, path, volume): + def load(self, display, path, volume, isBackground): log.debug(u'load vid in Webkit Controller') vol = float(volume) / float(10) + if isBackground: + loop = u'true' + else: + loop = u'false' display.webView.setVisible(True) if path.endswith(u'.swf'): js = u'show_flash("load","%s");' % \ (path.replace(u'\\', u'\\\\')) self.isFlash = True else: - js = u'show_video("init", "%s", %s, false);' % \ - (path.replace(u'\\', u'\\\\'), str(vol)) + js = u'show_video("init", "%s", %s, %s);' % \ + (path.replace(u'\\', u'\\\\'), str(vol), loop) self.isFlash = False display.frame.evaluateJavaScript(js) return True @@ -99,6 +103,9 @@ class WebkitController(MediaController): display.webView.resize(display.size()) def play(self, display): + display.override[u'theme'] = u'' + display.override[u'video'] = True + display.webLoaded = True self.set_visible(display, True) if self.isFlash: display.frame.evaluateJavaScript(u'show_flash("play","");') From dbce448da135c803e470363f5ab95de75b7e304f Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Sun, 5 Jun 2011 23:10:49 +0200 Subject: [PATCH 09/41] update --- openlp/core/lib/htmlbuilder.py | 36 +- openlp/core/lib/plugin.py | 6 + openlp/core/lib/pluginmanager.py | 5 + openlp/core/ui/mainwindow.py | 5 + openlp/core/ui/slidecontroller.py | 99 +-- openlp/plugins/media/lib/__init__.py | 44 +- openlp/plugins/media/lib/mediacontroller.py | 356 -------- openlp/plugins/media/lib/mediaitem.py | 2 +- openlp/plugins/media/lib/mediamanager.py | 385 +++++++++ openlp/plugins/media/lib/mediatab.py | 130 +-- .../lib/{phononcontroller.py => phononapi.py} | 54 +- openlp/plugins/media/lib/vlc.py | 811 +++++++++++------- .../media/lib/{vlccontroller.py => vlcapi.py} | 48 +- .../lib/{webkitcontroller.py => webkitapi.py} | 100 ++- openlp/plugins/media/mediaplugin.py | 3 + 15 files changed, 1143 insertions(+), 941 deletions(-) delete mode 100644 openlp/plugins/media/lib/mediacontroller.py create mode 100644 openlp/plugins/media/lib/mediamanager.py rename openlp/plugins/media/lib/{phononcontroller.py => phononapi.py} (85%) rename openlp/plugins/media/lib/{vlccontroller.py => vlcapi.py} (85%) rename openlp/plugins/media/lib/{webkitcontroller.py => webkitapi.py} (66%) diff --git a/openlp/core/lib/htmlbuilder.py b/openlp/core/lib/htmlbuilder.py index 69126163a..a0944054f 100644 --- a/openlp/core/lib/htmlbuilder.py +++ b/openlp/core/lib/htmlbuilder.py @@ -183,7 +183,8 @@ sup { case 'currentTime': return vid.currentTime; case 'seek': - vid.currentTime = seekVal; + // doesnt work curently + //vid.currentTime = seekVal; break; } } @@ -327,20 +328,22 @@ sup { } } - function show_flash(state, path){ +// http://www.adobe.com/support/flash/publishexport/scriptingwithflash/scriptingwithflash_03.html + function show_flash(state, path, volume, seekVal){ var text = document.getElementById('flash'); var flashMovie = getFlashMovieObject("OpenLPFlashMovie"); var src = "src = 'file:///" + path + "'"; var view_parm = " wmode='opaque'" + " width='" + window.innerWidth + "'" + " height='" + window.innerHeight + "'"; - var swf_parm = " autostart='false' loop='false' play='false'" + - " hidden='false' swliveconnect='true'" + - " name='OpenLPFlashMovie'>"; + var swf_parm = " name='OpenLPFlashMovie'" + + " autostart='true' loop='false' play='true'" + + " hidden='false' swliveconnect='true' allowscriptaccess='always'" + + " volume='" + volume + "'"; switch(state){ case 'load': - text.innerHTML = ""; + text.innerHTML = ""; flashMovie = getFlashMovieObject("OpenLPFlashMovie"); text.style.visibility = 'visible'; flashMovie.Play(); @@ -349,28 +352,29 @@ sup { text.style.visibility = 'visible'; flashMovie.Play(); break; - case 'rewind': - ret = 'rewind'; - alert(' Wert: ' + flashMovie.TGetProperty("/", 4)); -// flashMovie.TotalFrames() -// PercentLoaded() -// GotoFrame() - break; case 'pause': flashMovie.StopPlay(); text.style.visibility = 'hidden'; break; case 'stop': flashMovie.StopPlay(); -// flashMovie.GotoFrame(0); text.style.visibility = 'hidden'; + tempHtml = text.innerHTML; + text.innerHTML = ''; + text.innerHTML = tempHtml; break; case 'close': flashMovie.StopPlay(); text.style.visibility = 'hidden'; - break; text.innerHTML = ''; - break; + break; + case 'length': + return flashMovie.TotalFrames(); + case 'currentTime': + return flashMovie.CurrentFrame(); + case 'seek': +// flashMovie.GotoFrame(seekVal); + break; } } diff --git a/openlp/core/lib/plugin.py b/openlp/core/lib/plugin.py index d0d83cd0c..ef02a3a3e 100644 --- a/openlp/core/lib/plugin.py +++ b/openlp/core/lib/plugin.py @@ -244,6 +244,12 @@ class Plugin(QtCore.QObject): """ pass + def addControllerItems(self, controller, control_panel): + """ + Create items for all controller Panes + """ + pass + def getSettingsTab(self, parent): """ Create a tab for the settings window to display the configurable diff --git a/openlp/core/lib/pluginmanager.py b/openlp/core/lib/pluginmanager.py index 682352aa5..885c1c207 100644 --- a/openlp/core/lib/pluginmanager.py +++ b/openlp/core/lib/pluginmanager.py @@ -187,6 +187,11 @@ class PluginManager(object): if plugin.status is not PluginStatus.Disabled: plugin.addToolsMenuItem(tools_menu) + def hook_controller_items(self, controller, control_panel): + for plugin in self.plugins: + if plugin.status is not PluginStatus.Disabled: + plugin.addControllerItems(controller, control_panel) + def initialise_plugins(self): """ Loop through all the plugins and give them an opportunity to diff --git a/openlp/core/ui/mainwindow.py b/openlp/core/ui/mainwindow.py index bf6b7fa98..ff214dbd0 100644 --- a/openlp/core/ui/mainwindow.py +++ b/openlp/core/ui/mainwindow.py @@ -580,6 +580,11 @@ class MainWindow(QtGui.QMainWindow, Ui_MainWindow): self.pluginManager.hook_export_menu(self.FileExportMenu) # Call the hook method to pull in tools menus. self.pluginManager.hook_tools_menu(self.ToolsMenu) + # Call the hook method to pull in plugin Controller items + self.pluginManager.hook_controller_items( + self.previewController, self.previewController.getControlPanel()) + self.pluginManager.hook_controller_items( + self.liveController, self.liveController.getControlPanel()) # Call the initialise method to setup plugins. log.info(u'initialise plugins') self.pluginManager.initialise_plugins() diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index 7f91c3670..93532285a 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -73,7 +73,6 @@ class SlideController(QtGui.QWidget): self.songEditList = [ u'Edit Song', ] - self.volume = 10 self.timer_id = 0 self.songEdit = False self.selectedRow = 0 @@ -224,20 +223,6 @@ class SlideController(QtGui.QWidget): 'Edit and reload song preview'), self.onEditSong) self.controllerLayout.addWidget(self.toolbar) - # Build a Media ToolBar - self.mediabar = OpenLPToolbar(self) - self.mediabar.addToolbarButton( - u'Media Start', u':/slides/media_playback_start.png', - translate('OpenLP.SlideController', 'Start playing media'), - self.onMediaPlay) - self.mediabar.addToolbarButton( - u'Media Pause', u':/slides/media_playback_pause.png', - translate('OpenLP.SlideController', 'Start playing media'), - self.onMediaPause) - self.mediabar.addToolbarButton( - u'Media Stop', u':/slides/media_playback_stop.png', - translate('OpenLP.SlideController', 'Start playing media'), - self.onMediaStop) if self.isLive: # Build the Song Toolbar self.songMenu = QtGui.QToolButton(self.toolbar) @@ -247,22 +232,6 @@ class SlideController(QtGui.QWidget): self.songMenu.setMenu(QtGui.QMenu( translate('OpenLP.SlideController', 'Go To'), self.toolbar)) self.toolbar.makeWidgetsInvisible([u'Song Menu']) - # Build the seekSlider. - self.seekSlider = QtGui.QSlider(QtCore.Qt.Horizontal) - self.seekSlider.setMaximum(1000) - # Build the volumeSlider. - self.volumeSlider = QtGui.QSlider(QtCore.Qt.Horizontal) - self.volumeSlider.setTickInterval(1) - self.volumeSlider.setTickPosition(QtGui.QSlider.TicksAbove) - self.volumeSlider.setMinimum(0) - self.volumeSlider.setMaximum(10) - self.seekSlider.setGeometry(QtCore.QRect(90, 260, 221, 24)) - self.seekSlider.setObjectName(u'seekSlider') - self.mediabar.addToolbarWidget(u'Seek Slider', self.seekSlider) - self.volumeSlider.setGeometry(QtCore.QRect(90, 160, 221, 24)) - self.volumeSlider.setObjectName(u'volumeSlider') - self.mediabar.addToolbarWidget(u'Audio Volume', self.volumeSlider) - self.controllerLayout.addWidget(self.mediabar) # Screen preview area self.previewFrame = QtGui.QFrame(self.splitter) self.previewFrame.setGeometry(QtCore.QRect(0, 0, 300, 300 * self.ratio)) @@ -302,10 +271,6 @@ class SlideController(QtGui.QWidget): # Signals QtCore.QObject.connect(self.previewListWidget, QtCore.SIGNAL(u'clicked(QModelIndex)'), self.onSlideSelected) - QtCore.QObject.connect(self.seekSlider, - QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaSeek) - QtCore.QObject.connect(self.volumeSlider, - QtCore.SIGNAL(u'sliderMoved(int)'), self.mediaVolume) if self.isLive: QtCore.QObject.connect(Receiver.get_receiver(), QtCore.SIGNAL(u'maindisplay_active'), self.updatePreview) @@ -319,7 +284,6 @@ class SlideController(QtGui.QWidget): QtCore.SIGNAL(u'doubleClicked(QModelIndex)'), self.onGoLiveClick) self.toolbar.makeWidgetsInvisible(self.songEditList) - self.mediabar.setVisible(False) if self.isLive: self.setLiveHotkeys(self) self.__addActionsToWidget(self.previewListWidget) @@ -366,6 +330,19 @@ class SlideController(QtGui.QWidget): QtCore.SIGNAL(u'slidecontroller_%s_text_request' % self.typePrefix), self.onTextRequest) + def getControlPanel(self): + return self.controllerLayout + + def sendToPlugins(self, v1=None, v2=None, v3=None, v4=None, v5=None): + """ + This is the generic function to send signal for control widgets, + created from within other plugins + This function is needed to catch the current controller + """ + sender = self.sender().objectName() or self.sender().text() + controller = self + Receiver.send_message('%s' % sender, [controller, v1, v2, v3, v4, v5]) + def setPreviewHotkeys(self, parent=None): self.previousItem.setObjectName(u'previousItemPreview') self.nextItem.setObjectName(u'nextItemPreview') @@ -523,14 +500,9 @@ class SlideController(QtGui.QWidget): Allows the Preview toolbar to be customised """ self.toolbar.setVisible(True) - self.mediabar.setVisible(False) self.toolbar.makeWidgetsInvisible(self.songEditList) if item.is_capable(ItemCapabilities.AllowsEdit) and item.from_plugin: self.toolbar.makeWidgetsVisible(self.songEditList) - elif item.is_media(): - #self.toolbar.setVisible(False) - self.mediabar.setVisible(True) -# self.volumeSlider.setAudioOutput(self.audio) def refreshServiceItem(self): """ @@ -1089,58 +1061,15 @@ class SlideController(QtGui.QWidget): """ log.debug(u'SlideController onMediaStart') file = os.path.join(item.get_frame_path(), item.get_frame_title()) - Receiver.send_message(u'media_video', [self, file, self.volume, False]) - self.volumeSlider.setValue(self.volume) + Receiver.send_message(u'media_video', [self, file, False]) self.slidePreview.hide() - def mediaSeek(self): - """ - Respond to the release of Seek Slider - """ - log.debug(u'SlideController mediaSeek') - self.seekPos = self.seekSlider.value() - Receiver.send_message(u'media_seek', [self, self.seekPos]) - - def mediaVolume(self): - """ - Respond to the release of Volume Slider - """ - log.debug(u'SlideController mediaVolume') - self.volume = self.volumeSlider.value() - Receiver.send_message(u'media_volume', [self, self.volume]) - - - def onMediaPause(self): - """ - Respond to the Pause from the media Toolbar - """ - log.debug(u'SlideController onMediaPause') - Receiver.send_message(u'media_pause', self) - - def onMediaPlay(self): - """ - Respond to the Play from the media Toolbar - """ - log.debug(u'SlideController onMediaPlay') - Receiver.send_message(u'media_play', self) - self.slidePreview.hide() - - def onMediaStop(self): - """ - Respond to the Stop from the media Toolbar - """ - log.debug(u'SlideController onMediaStop') - Receiver.send_message(u'media_stop', self) - self.slidePreview.clear() - self.slidePreview.show() - def onMediaClose(self): """ Respond to a request to close the Video """ log.debug(u'SlideController onMediaClose') Receiver.send_message(u'media_reset', self) - self.slidePreview.clear() self.slidePreview.show() def _resetBlank(self): diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 4469a3be4..79bc09e6c 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -24,9 +24,9 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -class MediaBackends(object): +class MediaAPIs(object): """ - An enumeration for possible Backends. + An enumeration for possible APIs. """ Webkit = 0 Phonon = 1 @@ -43,10 +43,32 @@ class MediaState(object): Paused = 4 Off = 6 -class MediaController(object): +class MediaType(object): """ - Specialiced MediaController class - to reflect Features of the related backend + """ + Audio = 0 + Video = 1 + Cd = 3 + Dvd = 4 + +class MediaInfo(object): + """ + This class hold the media related infos + """ + file_info = None + volume = 100 + isFlash = False + is_background = False + length = 0 + start_time = 0 + end_time = 0 + media_type = MediaType() + + +class MediaAPI(object): + """ + Specialiced Media API class + to reflect Features of the related API """ def __init__(self, parent): self.parent = parent @@ -57,19 +79,19 @@ class MediaController(object): self.audio_extensions_list = [] self.video_extensions_list = [] - def setup(self, display, hasAudio): + def setup(self, display): """ Create the related widgets for the current display """ pass - def load(self, display, path, volume, isBackground): + def load(self, display): """ Load a new media file and check if it is valid """ return True - def resize(self, display, controller): + def resize(self, display): """ If the main display size or position is changed, the media widgets should also resized @@ -118,7 +140,7 @@ class MediaController(object): """ pass - def update_ui(self, controller, display): + def update_ui(self, display): """ Do some ui related stuff (e.g. update the seek slider) @@ -128,7 +150,7 @@ class MediaController(object): @staticmethod def is_available(): """ - Check availability of the related backend + Check availability of the related API """ return False @@ -143,6 +165,6 @@ class MediaController(object): from mediaitem import MediaMediaItem from mediatab import MediaTab -from mediacontroller import MediaManager +from mediamanager import MediaManager __all__ = ['MediaMediaItem'] diff --git a/openlp/plugins/media/lib/mediacontroller.py b/openlp/plugins/media/lib/mediacontroller.py deleted file mode 100644 index b84fdc5a9..000000000 --- a/openlp/plugins/media/lib/mediacontroller.py +++ /dev/null @@ -1,356 +0,0 @@ -#!/usr/bin/env python -# -*- coding: utf-8 -*- -# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 - -############################################################################### -# OpenLP - Open Source Lyrics Projection # -# --------------------------------------------------------------------------- # -# Copyright (c) 2008-2011 Raoul Snyman # -# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # -# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # -# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # -# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # -# --------------------------------------------------------------------------- # -# 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; version 2 of the License. # -# # -# 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., 59 # -# Temple Place, Suite 330, Boston, MA 02111-1307 USA # -############################################################################### - -import logging - -import sys, os -from PyQt4 import QtCore, QtGui, QtWebKit - -from openlp.core.lib import Receiver, translate -from openlp.core.lib.ui import UiStrings, critical_error_message_box -from openlp.plugins.media.lib import MediaBackends, MediaState -from webkitcontroller import WebkitController -from phononcontroller import PhononController -from vlccontroller import VlcController - -log = logging.getLogger(__name__) - -class MediaManager(object): - """ - The implementation of a Media Manager - The idea is to separate the media related implementation - into the plugin files and unify the access from other parts of code - The media manager adds an own class for every type of backend - Currently these are QtWebkit, Phonon and planed Vlc. - """ - - def __init__(self, parent): - self.parent = parent - self.backends = {} - self.curDisplayMediaController = {} - #Create Backend Controllers - if WebkitController.is_available(): - self.backends[u'Webkit'] = WebkitController(self) - if PhononController.is_available(): - self.backends[u'Phonon'] = PhononController(self) - if VlcController.is_available(): - self.backends[u'Vlc'] = VlcController(self) - #Timer for video state - self.Timer = QtCore.QTimer() - self.Timer.setInterval(200) - self.withLivePreview = False - #Signals - QtCore.QObject.connect(self.Timer, - QtCore.SIGNAL("timeout()"), self.video_state) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'setup_display'), self.setup_display) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_video'), self.video) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_play'), self.video_play) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_pause'), self.video_pause) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_stop'), self.video_stop) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_seek'), self.video_seek) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_volume'), self.video_volume) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_reset'), self.video_reset) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_hide'), self.video_hide) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_blank'), self.video_blank) - QtCore.QObject.connect(Receiver.get_receiver(), - QtCore.SIGNAL(u'media_unblank'), self.video_unblank) - - def video_state(self): - """ - Check if there is an assigned media backend and do some - updating stuff (e.g. update the UI) - """ - isAnyonePlaying = False - if len(self.curDisplayMediaController.keys()) == 0: - self.Timer.stop() - else: - for display in self.curDisplayMediaController.keys(): - if display == self.parent.previewController.previewDisplay or \ - display == self.parent.previewController.display: - self.curDisplayMediaController[display] \ - .update_ui(self.parent.previewController, display) - else: - self.curDisplayMediaController[display] \ - .update_ui(self.parent.liveController, display) - if self.curDisplayMediaController[display] \ - .state == MediaState.Playing: - isAnyonePlaying = True - if not isAnyonePlaying: - self.Timer.stop() - - def setup_display(self, display): - """ - After a new display is configured, all media related widget - will be created too - """ - hasAudio = True - if not self.withLivePreview and \ - display == self.parent.liveController.previewDisplay: - return - if display == self.parent.previewController.previewDisplay or \ - display == self.parent.liveController.previewDisplay: - hasAudio = False - for backend in self.backends.values(): - backend.setup(display, hasAudio) - - def resize(self, controller): - """ - After Mainwindow changes or Splitter moved all related media - widgets have to be resized - """ - for display in self.curDisplayMediaController.keys(): - if display == self.parent.previewController.previewDisplay or \ - display == self.parent.liveController.previewDisplay: - display.resize(display.parent.slidePreview.size()) - self.curDisplayMediaController[display].resize(display, controller) - - def video(self, msg): - """ - Loads and starts a video to run with the option of sound - """ - controller = msg[0] - videoPath = os.path.abspath(msg[1]) - volume = msg[2] - isBackground = msg[3] - log.debug(u'video') - vol = float(volume) / float(10) - isValid = False - #stop running videos - self.video_reset(controller) - if controller.isLive: - if self.withLivePreview: - display = controller.previewDisplay - if self.check_file_type(display, videoPath, False): - #check size of all media_widgets - self.resize(controller) - self.curDisplayMediaController[display] \ - .load(display, videoPath, volume, isBackground) - display = controller.display - if self.check_file_type(display, videoPath, isBackground): - #check size of all media_widgets - self.resize(controller) - isValid = self.curDisplayMediaController[display] \ - .load(display, videoPath, volume, isBackground) - else: - display = controller.previewDisplay - if self.check_file_type(display, videoPath, isBackground): - #check size of all media_widgets - self.resize(controller) - isValid = self.curDisplayMediaController[display] \ - .load(display, videoPath, volume, isBackground) - if not isValid: - #Media could not be loaded correctly - critical_error_message_box( - translate('MediaPlugin.MediaItem', 'Unsupported File'), - unicode(translate('MediaPlugin.MediaItem', - 'Unsupported File'))) - return -# controller.display.webLoaded = True - #now start playing - self.video_play(controller) - - def check_file_type(self, display, videoPath, isBackground): - """ - Used to choose the right media backend type - from the prioritized backend list - """ - usedBackends = QtCore.QSettings().value(u'media/backends', - QtCore.QVariant(u'Webkit')).toString().split(u',') - media_path = QtCore.QFileInfo(videoPath) - if media_path.isFile(): - suffix = u'*.%s' % media_path.suffix() - for title in usedBackends: - backend = self.backends[str(title)] - if suffix in backend.video_extensions_list: - if isBackground: - if backend.canBackground: - self.curDisplayMediaController[display] = backend - return True - else: - self.curDisplayMediaController[display] = backend - return True - return False -# # Special FileType Check -# if videoPath.endswith(u'.swf') or isBackground: -# self.curDisplayMediaController[display] = self.backends[u'Webkit'] -# else: -# # search extension in available backends -# # currently only use the first available backend -# self.curDisplayMediaController[display] = self.backends[str(usedBackends[0])] -# return True - - def video_play(self, controller): - """ - Responds to the request to play a loaded video - """ - log.debug(u'video_play') - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].play(display) - # show screen - if not self.Timer.isActive(): - self.Timer.start() - - def video_pause(self, controller): - """ - Responds to the request to pause a loaded video - """ - log.debug(u'videoPause') - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].pause(display) - - def video_stop(self, controller): - """ - Responds to the request to stop a loaded video - """ - log.debug(u'video_stop') - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].stop(display) - self.curDisplayMediaController[display].set_visible(display, False) - - def video_volume(self, msg): - """ - Changes the volume of a running video - """ - controller = msg[0] - volume = msg[1] - log.debug(u'video_volume %d' % volume) - vol = float(volume) / float(10) - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].volume(display, vol) - - def video_finished(self): - """ - Blank the Video when it has finished so the final frame is not left - hanging - """ - display.videoStop() - display.hideDisplay(HideMode.Blank) - display.videoHide = True - - def video_tick(self, tick): - """ - Triggered on video tick every 200 milli seconds - """ - if tick > display.serviceItem.end_time * 1000: - display.videoFinished() - - def video_seek(self, msg): - """ - Responds to the request to change the seek Slider of a loaded video - """ - log.debug(u'video_seek') - controller = msg[0] - seekVal = msg[1] - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].seek(display, seekVal) - - def video_reset(self, controller): - """ - Responds to the request to reset a loaded video - """ - log.debug(u'video_reset') - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - self.curDisplayMediaController[display].reset(display) - del self.curDisplayMediaController[display] - - def video_hide(self, msg): - """ - Hide the related video Widget - """ - isLive = msg[1] - if isLive: - controller = self.parent.liveController - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - if self.curDisplayMediaController[display] \ - .state == MediaState.Playing: - self.curDisplayMediaController[display].pause(display) - self.curDisplayMediaController[display] \ - .set_visible(display, False) - - def video_blank(self, msg): - """ - Blank the related video Widget - """ - isLive = msg[1] - if isLive: - controller = self.parent.liveController - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - if self.curDisplayMediaController[display] \ - .state == MediaState.Playing: - self.curDisplayMediaController[display].pause(display) - self.curDisplayMediaController[display] \ - .set_visible(display, False) - - def video_unblank(self, msg): - """ - Unblank the related video Widget - """ - Receiver.send_message(u'maindisplay_show') - isLive = msg[1] - if isLive: - controller = self.parent.liveController - for display in self.curDisplayMediaController.keys(): - if display.parent == controller: - if self.curDisplayMediaController[display] \ - .state == MediaState.Paused: - self.curDisplayMediaController[display].play(display) - self.curDisplayMediaController[display] \ - .set_visible(display, True) - - def get_audio_extensions_list(self): - audio_list = [] - for backend in self.backends.values(): - for item in backend.audio_extensions_list: - if not item in audio_list: - audio_list.append(item) - return audio_list - - def get_video_extensions_list(self): - video_list = [] - for backend in self.backends.values(): - for item in backend.video_extensions_list: - if not item in video_list: - video_list.append(item) - return video_list diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index 3465e570e..8b48c343c 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -137,7 +137,7 @@ class MediaMediaItem(MediaManagerItem): ItemCapabilities.AllowsVariableStartTime) service_item.title = unicode(self.plugin.nameStrings[u'singular']) service_item.add_capability(ItemCapabilities.RequiresMedia) - #Receiver.send_message(u'media_video', [self.parent.liveController, filename, 0, False]) + #Receiver.send_message(u'media_video', [self.parent.liveController, filename, False]) # force a non-existent theme service_item.theme = -1 frame = u':/media/image_clapperboard.png' diff --git a/openlp/plugins/media/lib/mediamanager.py b/openlp/plugins/media/lib/mediamanager.py new file mode 100644 index 000000000..175eaf6c8 --- /dev/null +++ b/openlp/plugins/media/lib/mediamanager.py @@ -0,0 +1,385 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 + +############################################################################### +# OpenLP - Open Source Lyrics Projection # +# --------------------------------------------------------------------------- # +# Copyright (c) 2008-2011 Raoul Snyman # +# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # +# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # +# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # +# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # +# --------------------------------------------------------------------------- # +# 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; version 2 of the License. # +# # +# 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., 59 # +# Temple Place, Suite 330, Boston, MA 02111-1307 USA # +############################################################################### + +import logging + +import sys, os,time +from PyQt4 import QtCore, QtGui, QtWebKit + +from openlp.core.lib import OpenLPToolbar, Receiver, translate +from openlp.core.lib.ui import UiStrings, critical_error_message_box +from openlp.plugins.media.lib import MediaAPI, MediaState, MediaInfo +from webkitapi import WebkitAPI +from phononapi import PhononAPI +from vlcapi import VlcAPI + +log = logging.getLogger(__name__) + +class MediaManager(object): + """ + The implementation of a Media Manager + The idea is to separate the media related implementation + into the plugin files and unify the access from other parts of code + The media manager adds an own class for every API + Currently these are QtWebkit, Phonon and planed Vlc. + Manager + - different API classes with specialised Access functions + + Controller + - have general and API specific control Elements + - have one or more displays (Preview, Live, ...) with different settings + + Display + - have API-Specific Display Elements + - have media info for current media + """ + + def __init__(self, parent): + self.parent = parent + self.APIs = {} + self.controller = [] + self.curDisplayMediaAPI = {} + #Create API Controllers + if WebkitAPI.is_available(): + self.APIs[u'Webkit'] = WebkitAPI(self) + if PhononAPI.is_available(): + self.APIs[u'Phonon'] = PhononAPI(self) + if VlcAPI.is_available(): + self.APIs[u'Vlc'] = VlcAPI(self) + #Timer for video state + self.Timer = QtCore.QTimer() + self.Timer.setInterval(200) + self.withLivePreview = False + #Signals + QtCore.QObject.connect(self.Timer, + QtCore.SIGNAL("timeout()"), self.video_state) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'setup_display'), self.setup_display) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_video'), self.video) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'Media Start'), self.video_play) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'Media Pause'), self.video_pause) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'Media Stop'), self.video_stop) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'seekSlider'), self.video_seek) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'volumeSlider'), self.video_volume) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_reset'), self.video_reset) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_hide'), self.video_hide) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_blank'), self.video_blank) + QtCore.QObject.connect(Receiver.get_receiver(), + QtCore.SIGNAL(u'media_unblank'), self.video_unblank) + + def video_state(self): + """ + Check if there is an assigned media API and do some + updating stuff (e.g. update the UI) + """ + isAnyonePlaying = False + if len(self.curDisplayMediaAPI.keys()) == 0: + self.Timer.stop() + else: + for display in self.curDisplayMediaAPI.keys(): + self.curDisplayMediaAPI[display].update_ui(display) + if self.curDisplayMediaAPI[display] \ + .state == MediaState.Playing: + isAnyonePlaying = True + if not isAnyonePlaying: + self.Timer.stop() + + def addControllerItems(self, controller, control_panel): + self.controller.append(controller) + self.setup_generic_controls(controller, control_panel) + for api in self.APIs.values(): + api.setup_controls(controller, control_panel) + + def setup_generic_controls(self, controller, control_panel): + controller.media_info = MediaInfo() + # Build a Media ToolBar + controller.mediabar = OpenLPToolbar(controller) + controller.mediabar.addToolbarButton( + u'Media Start', u':/slides/media_playback_start.png', + translate('OpenLP.SlideController', 'Start playing media'), + controller.sendToPlugins) + controller.mediabar.addToolbarButton( + u'Media Pause', u':/slides/media_playback_pause.png', + translate('OpenLP.SlideController', 'Start playing media'), + controller.sendToPlugins) + controller.mediabar.addToolbarButton( + u'Media Stop', u':/slides/media_playback_stop.png', + translate('OpenLP.SlideController', 'Start playing media'), + controller.sendToPlugins) + # Build the seekSlider. + controller.seekSlider = QtGui.QSlider(QtCore.Qt.Horizontal) + controller.seekSlider.setMaximum(1000) + # Build the volumeSlider. + controller.volumeSlider = QtGui.QSlider(QtCore.Qt.Horizontal) + controller.volumeSlider.setTickInterval(10) + controller.volumeSlider.setTickPosition(QtGui.QSlider.TicksAbove) + controller.volumeSlider.setMinimum(0) + controller.volumeSlider.setMaximum(100) + controller.volumeSlider.setValue(controller.media_info.volume) + controller.seekSlider.setGeometry(QtCore.QRect(90, 260, 221, 24)) + controller.seekSlider.setObjectName(u'seekSlider') + controller.mediabar.addToolbarWidget(u'Seek Slider', controller.seekSlider) + controller.volumeSlider.setGeometry(QtCore.QRect(90, 160, 221, 24)) + controller.volumeSlider.setObjectName(u'volumeSlider') + controller.mediabar.addToolbarWidget(u'Audio Volume', controller.volumeSlider) + control_panel.addWidget(controller.mediabar) + controller.mediabar.setVisible(False) + #Signals + QtCore.QObject.connect(controller.seekSlider, + QtCore.SIGNAL(u'sliderMoved(int)'), controller.sendToPlugins) + QtCore.QObject.connect(controller.volumeSlider, + QtCore.SIGNAL(u'sliderMoved(int)'), controller.sendToPlugins) + + def setup_display(self, display): + """ + After a new display is configured, all media related widget + will be created too + """ + display.hasAudio = True + if not self.withLivePreview and \ + display == self.parent.liveController.previewDisplay: + return + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.liveController.previewDisplay: + display.hasAudio = False + for api in self.APIs.values(): + api.setup(display) + + def set_controls_visible(self, controller, value): + # Generic controls + controller.mediabar.setVisible(value) + # Special controls +# for api in self.APIs.values(): +# api.setup_controls(controller, control_panel) + + def resize(self, display, api): + """ + After Mainwindow changes or Splitter moved all related media + widgets have to be resized + """ + if display == self.parent.previewController.previewDisplay or \ + display == self.parent.liveController.previewDisplay: + display.resize(display.parent.slidePreview.size()) + api.resize(display) + + def video(self, msg): + """ + Loads and starts a video to run with the option of sound + """ + log.debug(u'video') + controller = msg[0] + isValid = False + # stop running videos + self.video_reset(controller) + controller.media_info = MediaInfo() + controller.media_info.volume = controller.volumeSlider.value() + controller.media_info.file_info = QtCore.QFileInfo(msg[1]) + controller.media_info.is_background = msg[2] + if controller.isLive: + if self.withLivePreview: + display = controller.previewDisplay + isValid = self.check_file_type(display) + display = controller.display + isValid = self.check_file_type(display) + else: + display = controller.previewDisplay + isValid = self.check_file_type(display) + if not isValid: + #Media could not be loaded correctly + critical_error_message_box( + translate('MediaPlugin.MediaItem', 'Unsupported File'), + unicode(translate('MediaPlugin.MediaItem', + 'Unsupported File'))) + return + #now start playing + self.video_play([controller]) +# self.video_pause([controller]) + # self.video_seek([controller, 0]) + # self.video_play([controller]) + self.set_controls_visible(controller, True) + + def check_file_type(self, display): + """ + Used to choose the right media API type + from the prioritized API list + """ + controller = display.parent + apiSettings = str(QtCore.QSettings().value(u'media/apis', + QtCore.QVariant(u'Webkit')).toString()) + usedAPIs = apiSettings.split(u',') + if controller.media_info.file_info.isFile(): + suffix = u'*.%s' % controller.media_info.file_info.suffix() + for title in usedAPIs: + api = self.APIs[title] + if suffix in api.video_extensions_list: + if not controller.media_info.is_background or \ + controller.media_info.is_background and api.canBackground: + self.resize(display, api) + if api.load(display): + print api + self.curDisplayMediaAPI[display] = api + return True + # no valid api found + return False + + def video_play(self, msg): + """ + Responds to the request to play a loaded video + """ + log.debug(u'video_play') + controller = msg[0] + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + self.curDisplayMediaAPI[display].play(display) + # Start Timer for ui updates + if not self.Timer.isActive(): + self.Timer.start() + + def video_pause(self, msg): + """ + Responds to the request to pause a loaded video + """ + log.debug(u'videoPause') + controller = msg[0] + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + self.curDisplayMediaAPI[display].pause(display) + + def video_stop(self, msg): + """ + Responds to the request to stop a loaded video + """ + log.debug(u'video_stop') + controller = msg[0] + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + self.curDisplayMediaAPI[display].stop(display) + self.curDisplayMediaAPI[display].set_visible(display, False) + + def video_volume(self, msg): + """ + Changes the volume of a running video + """ + controller = msg[0] + vol = msg[1] + log.debug(u'video_volume %d' % vol) + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + self.curDisplayMediaAPI[display].volume(display, vol) + + def video_seek(self, msg): + """ + Responds to the request to change the seek Slider of a loaded video + """ + log.debug(u'video_seek') + controller = msg[0] + seekVal = msg[1] + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + self.curDisplayMediaAPI[display].seek(display, seekVal) + + def video_reset(self, controller): + """ + Responds to the request to reset a loaded video + """ + log.debug(u'video_reset') + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + self.curDisplayMediaAPI[display].reset(display) + del self.curDisplayMediaAPI[display] + self.set_controls_visible(controller, False) + + def video_hide(self, msg): + """ + Hide the related video Widget + """ + isLive = msg[1] + if isLive: + controller = self.parent.liveController + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + if self.curDisplayMediaAPI[display] \ + .state == MediaState.Playing: + self.curDisplayMediaAPI[display].pause(display) + self.curDisplayMediaAPI[display] \ + .set_visible(display, False) + + def video_blank(self, msg): + """ + Blank the related video Widget + """ + isLive = msg[1] + if isLive: + controller = self.parent.liveController + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + if self.curDisplayMediaAPI[display] \ + .state == MediaState.Playing: + self.curDisplayMediaAPI[display].pause(display) + self.curDisplayMediaAPI[display] \ + .set_visible(display, False) + + def video_unblank(self, msg): + """ + Unblank the related video Widget + """ + Receiver.send_message(u'maindisplay_show') + isLive = msg[1] + if isLive: + controller = self.parent.liveController + for display in self.curDisplayMediaAPI.keys(): + if display.parent == controller: + if self.curDisplayMediaAPI[display] \ + .state == MediaState.Paused: + self.curDisplayMediaAPI[display].play(display) + self.curDisplayMediaAPI[display] \ + .set_visible(display, True) + + def get_audio_extensions_list(self): + audio_list = [] + for api in self.APIs.values(): + for item in api.audio_extensions_list: + if not item in audio_list: + audio_list.append(item) + return audio_list + + def get_video_extensions_list(self): + video_list = [] + for api in self.APIs.values(): + for item in api.video_extensions_list: + if not item in video_list: + video_list.append(item) + return video_list diff --git a/openlp/plugins/media/lib/mediatab.py b/openlp/plugins/media/lib/mediatab.py index b54a2df6f..4c0bf4f47 100644 --- a/openlp/plugins/media/lib/mediatab.py +++ b/openlp/plugins/media/lib/mediatab.py @@ -38,52 +38,52 @@ class MediaTab(SettingsTab): def setupUi(self): self.setObjectName(u'MediaTab') SettingsTab.setupUi(self) - self.mediaBackendsGroupBox = QtGui.QGroupBox(self.leftColumn) - self.mediaBackendsGroupBox.setObjectName(u'mediaBackendsGroupBox') - self.mediaBackendLayout = QtGui.QVBoxLayout(self.mediaBackendsGroupBox) - self.mediaBackendLayout.setObjectName(u'mediaBackendLayout') - self.usePhononCheckBox = QtGui.QCheckBox(self.mediaBackendsGroupBox) + self.mediaAPIsGroupBox = QtGui.QGroupBox(self.leftColumn) + self.mediaAPIsGroupBox.setObjectName(u'mediaAPIsGroupBox') + self.mediaApiLayout = QtGui.QVBoxLayout(self.mediaAPIsGroupBox) + self.mediaApiLayout.setObjectName(u'mediaApiLayout') + self.usePhononCheckBox = QtGui.QCheckBox(self.mediaAPIsGroupBox) self.usePhononCheckBox.setObjectName(u'usePhononCheckBox') - self.mediaBackendLayout.addWidget(self.usePhononCheckBox) - self.useVlcCheckBox = QtGui.QCheckBox(self.mediaBackendsGroupBox) + self.mediaApiLayout.addWidget(self.usePhononCheckBox) + self.useVlcCheckBox = QtGui.QCheckBox(self.mediaAPIsGroupBox) self.useVlcCheckBox.setObjectName(u'useVlcCheckBox') - self.mediaBackendLayout.addWidget(self.useVlcCheckBox) - self.leftLayout.addWidget(self.mediaBackendsGroupBox) + self.mediaApiLayout.addWidget(self.useVlcCheckBox) + self.leftLayout.addWidget(self.mediaAPIsGroupBox) - self.backendOrderGroupBox = QtGui.QGroupBox(self.leftColumn) - self.backendOrderGroupBox.setObjectName(u'backendOrderGroupBox') - self.backendOrderLayout = QtGui.QVBoxLayout(self.backendOrderGroupBox) - self.backendOrderLayout.setObjectName(u'backendOrderLayout') - self.backendOrderlistWidget = QtGui.QListWidget( \ - self.backendOrderGroupBox) + self.apiOrderGroupBox = QtGui.QGroupBox(self.leftColumn) + self.apiOrderGroupBox.setObjectName(u'apiOrderGroupBox') + self.apiOrderLayout = QtGui.QVBoxLayout(self.apiOrderGroupBox) + self.apiOrderLayout.setObjectName(u'apiOrderLayout') + self.apiOrderlistWidget = QtGui.QListWidget( \ + self.apiOrderGroupBox) sizePolicy = QtGui.QSizePolicy(QtGui.QSizePolicy.Minimum, QtGui.QSizePolicy.Expanding) sizePolicy.setHorizontalStretch(0) sizePolicy.setVerticalStretch(0) - sizePolicy.setHeightForWidth(self.backendOrderlistWidget. \ + sizePolicy.setHeightForWidth(self.apiOrderlistWidget. \ sizePolicy().hasHeightForWidth()) - self.backendOrderlistWidget.setSizePolicy(sizePolicy) + self.apiOrderlistWidget.setSizePolicy(sizePolicy) - self.backendOrderlistWidget.setVerticalScrollBarPolicy( \ + self.apiOrderlistWidget.setVerticalScrollBarPolicy( \ QtCore.Qt.ScrollBarAsNeeded) - self.backendOrderlistWidget.setHorizontalScrollBarPolicy( \ + self.apiOrderlistWidget.setHorizontalScrollBarPolicy( \ QtCore.Qt.ScrollBarAlwaysOff) - self.backendOrderlistWidget.setEditTriggers( \ + self.apiOrderlistWidget.setEditTriggers( \ QtGui.QAbstractItemView.NoEditTriggers) - self.backendOrderlistWidget.setObjectName(u'backendOrderlistWidget') - self.backendOrderLayout.addWidget(self.backendOrderlistWidget) - self.orderingButtonsWidget = QtGui.QWidget(self.backendOrderGroupBox) + self.apiOrderlistWidget.setObjectName(u'apiOrderlistWidget') + self.apiOrderLayout.addWidget(self.apiOrderlistWidget) + self.orderingButtonsWidget = QtGui.QWidget(self.apiOrderGroupBox) self.orderingButtonsWidget.setObjectName(u'orderingButtonsWidget') self.orderingButtonLayout = QtGui.QHBoxLayout(self.orderingButtonsWidget) self.orderingButtonLayout.setObjectName(u'orderingButtonLayout') self.orderingDownButton = QtGui.QPushButton(self.orderingButtonsWidget) self.orderingDownButton.setObjectName(u'orderingDownButton') self.orderingButtonLayout.addWidget(self.orderingDownButton) - self.orderingUpButton = QtGui.QPushButton(self.backendOrderGroupBox) + self.orderingUpButton = QtGui.QPushButton(self.apiOrderGroupBox) self.orderingUpButton.setObjectName(u'orderingUpButton') self.orderingButtonLayout.addWidget(self.orderingUpButton) - self.backendOrderLayout.addWidget(self.orderingButtonsWidget) - self.leftLayout.addWidget(self.backendOrderGroupBox) + self.apiOrderLayout.addWidget(self.orderingButtonsWidget) + self.leftLayout.addWidget(self.apiOrderGroupBox) self.leftLayout.addStretch() self.rightLayout.addStretch() QtCore.QObject.connect(self.usePhononCheckBox, @@ -98,14 +98,14 @@ class MediaTab(SettingsTab): QtCore.SIGNAL(u'pressed()'), self.onOrderingDownButtonPressed) def retranslateUi(self): - self.mediaBackendsGroupBox.setTitle( - translate('MediaPlugin.MediaTab', 'Media Backends')) + self.mediaAPIsGroupBox.setTitle( + translate('MediaPlugin.MediaTab', 'Media APIs')) self.usePhononCheckBox.setText( translate('MediaPlugin.MediaTab', 'use Phonon')) self.useVlcCheckBox.setText( translate('MediaPlugin.MediaTab', 'use Vlc')) - self.backendOrderGroupBox.setTitle( - translate('MediaPlugin.MediaTab', 'Backends Order')) + self.apiOrderGroupBox.setTitle( + translate('MediaPlugin.MediaTab', 'API Order')) self.orderingDownButton.setText( translate('MediaPlugin.MediaTab', 'Down')) self.orderingUpButton.setText( @@ -114,61 +114,61 @@ class MediaTab(SettingsTab): def onUsePhononCheckBoxChanged(self, check_state): if check_state == QtCore.Qt.Checked: self.usePhonon = True - if u'Phonon' not in self.usedBackends: - self.usedBackends.append(u'Phonon') + if u'Phonon' not in self.usedAPIs: + self.usedAPIs.append(u'Phonon') else: self.usePhonon = False - self.usedBackends.takeAt(self.usedBackends.indexOf(u'Phonon')) - self.updateBackendList() + self.usedAPIs.takeAt(self.usedAPIs.indexOf(u'Phonon')) + self.updateApiList() def onUseVlcCheckBoxChanged(self, check_state): if check_state == QtCore.Qt.Checked: self.useVlc = True - if u'Vlc' not in self.usedBackends: - self.usedBackends.append(u'Vlc') + if u'Vlc' not in self.usedAPIs: + self.usedAPIs.append(u'Vlc') else: self.useVlc = False - self.usedBackends.takeAt(self.usedBackends.indexOf(u'Vlc')) - self.updateBackendList() + self.usedAPIs.takeAt(self.usedAPIs.indexOf(u'Vlc')) + self.updateApiList() - def updateBackendList(self): - self.backendOrderlistWidget.clear() - for backend in self.usedBackends: - self.backendOrderlistWidget.addItem(backend) + def updateApiList(self): + self.apiOrderlistWidget.clear() + for api in self.usedAPIs: + self.apiOrderlistWidget.addItem(api) def onOrderingUpButtonPressed(self): - currentRow = self.backendOrderlistWidget.currentRow() + currentRow = self.apiOrderlistWidget.currentRow() if currentRow > 0: - item = self.backendOrderlistWidget.takeItem(currentRow) - self.backendOrderlistWidget.insertItem(currentRow-1, item) - self.backendOrderlistWidget.setCurrentRow(currentRow-1) - self.usedBackends.move(currentRow, currentRow-1) + item = self.apiOrderlistWidget.takeItem(currentRow) + self.apiOrderlistWidget.insertItem(currentRow-1, item) + self.apiOrderlistWidget.setCurrentRow(currentRow-1) + self.usedAPIs.move(currentRow, currentRow-1) def onOrderingDownButtonPressed(self): - currentRow = self.backendOrderlistWidget.currentRow() - if currentRow < self.backendOrderlistWidget.count()-1: - item = self.backendOrderlistWidget.takeItem(currentRow) - self.backendOrderlistWidget.insertItem(currentRow+1, item) - self.backendOrderlistWidget.setCurrentRow(currentRow+1) - self.usedBackends.move(currentRow, currentRow+1) + currentRow = self.apiOrderlistWidget.currentRow() + if currentRow < self.apiOrderlistWidget.count()-1: + item = self.apiOrderlistWidget.takeItem(currentRow) + self.apiOrderlistWidget.insertItem(currentRow+1, item) + self.apiOrderlistWidget.setCurrentRow(currentRow+1) + self.usedAPIs.move(currentRow, currentRow+1) def load(self): - self.usedBackends = QtCore.QSettings().value( - self.settingsSection + u'/backends', + self.usedAPIs = QtCore.QSettings().value( + self.settingsSection + u'/apis', QtCore.QVariant(u'Webkit')).toString().split(u',') - self.useWebkit = u'Webkit' in self.usedBackends - self.usePhonon = u'Phonon' in self.usedBackends - self.useVlc = u'Vlc' in self.usedBackends + self.useWebkit = u'Webkit' in self.usedAPIs + self.usePhonon = u'Phonon' in self.usedAPIs + self.useVlc = u'Vlc' in self.usedAPIs self.usePhononCheckBox.setChecked(self.usePhonon) self.useVlcCheckBox.setChecked(self.useVlc) - self.updateBackendList() + self.updateApiList() def save(self): - oldBackendString = QtCore.QSettings().value( - self.settingsSection + u'/backends', + oldApiString = QtCore.QSettings().value( + self.settingsSection + u'/apis', QtCore.QVariant(u'Webkit')).toString() - newBackendString = self.usedBackends.join(u',') - if oldBackendString != newBackendString: - QtCore.QSettings().setValue(self.settingsSection + u'/backends', - QtCore.QVariant(newBackendString)) + newApiString = self.usedAPIs.join(u',') + if oldApiString != newApiString: + QtCore.QSettings().setValue(self.settingsSection + u'/apis', + QtCore.QVariant(newApiString)) Receiver.send_message(u'config_screen_changed') diff --git a/openlp/plugins/media/lib/phononcontroller.py b/openlp/plugins/media/lib/phononapi.py similarity index 85% rename from openlp/plugins/media/lib/phononcontroller.py rename to openlp/plugins/media/lib/phononapi.py index 3c0062464..fa7c25714 100644 --- a/openlp/plugins/media/lib/phononcontroller.py +++ b/openlp/plugins/media/lib/phononapi.py @@ -33,18 +33,18 @@ from PyQt4 import QtCore, QtGui from PyQt4.phonon import Phonon from openlp.core.lib import Receiver -from openlp.plugins.media.lib import MediaController, MediaState +from openlp.plugins.media.lib import MediaAPI, MediaState log = logging.getLogger(__name__) -class PhononController(MediaController): +class PhononAPI(MediaAPI): """ - Specialiced MediaController class - to reflect Features of the Phonon backend + Specialiced MediaAPI class + to reflect Features of the Phonon API """ def __init__(self, parent): - MediaController.__init__(self, parent) + MediaAPI.__init__(self, parent) self.parent = parent self.additional_extensions = { u'audio/ac3': [u'.ac3'], @@ -59,6 +59,7 @@ class PhononController(MediaController): u'video/x-flv': [u'.flv'], u'video/x-matroska': [u'.mpv', u'.mkv'], u'video/x-wmv': [u'.wmv'], + u'video/x-mpg': [u'.mpg'], u'video/x-ms-wmv': [u'.wmv']} mimetypes.init() for mimetype in Phonon.BackendCapabilities.availableMimeTypes(): @@ -90,7 +91,10 @@ class PhononController(MediaController): log.info(u'MediaPlugin: %s additional extensions: %s' % (mimetype, u' '.join(self.additional_extensions[mimetype]))) - def setup(self, display, hasAudio): + def setup_controls(self, controller, control_panel): + pass + + def setup(self, display): display.phononWidget = Phonon.VideoWidget(display) display.phononWidget.setVisible(False) display.phononWidget.resize(display.size()) @@ -126,13 +130,18 @@ class PhononController(MediaController): u'video/x-wmv': [u'.wmv'], u'video/x-ms-wmv': [u'.wmv']} - def load(self, display, path, volume, isBackground): + def load(self, display): log.debug(u'load vid in Phonon Controller') + controller = display.parent + volume = controller.media_info.volume + path = controller.media_info.file_info.absoluteFilePath() display.mediaObject.setCurrentSource(Phonon.MediaSource(path)) if not self.mediaStateWait(display, Phonon.StoppedState): return False vol = float(volume) / float(10) display.audio.setVolume(vol) + #self.info.start_time = 10000 + #self.info.end_time = 20000 return True def mediaStateWait(self, display, mediaState): @@ -149,12 +158,13 @@ class PhononController(MediaController): return False return True - def resize(self, display, controller): + def resize(self, display): display.phononWidget.resize(display.size()) def play(self, display): - self.set_visible(display, True) - vol = float(display.parent.volume) / float(10) + #self.set_visible(display, True) + controller = display.parent + vol = float(controller.media_info.volume) / float(10) display.audio.setVolume(vol) display.mediaObject.play() self.state = MediaState.Playing @@ -168,6 +178,8 @@ class PhononController(MediaController): self.state = MediaState.Stopped def volume(self, display, vol): + # 1.0 is the highest value + vol = float(vol) / float(100) display.audio.setVolume(vol) def seek(self, display, seekVal): @@ -183,16 +195,20 @@ class PhononController(MediaController): if self.hasOwnWidget: display.phononWidget.setVisible(status) - def update_ui(self, controller, display): - controller.seekSlider.setMaximum(display.mediaObject.totalTime()) - if display.serviceItem.end_time > 0: - if display.mediaObject.currentTime() > \ - display.serviceItem.end_time: - self.stop(display) - if display.serviceItem.start_time > 0: + def update_ui(self, display): + controller = display.parent + controller.media_info.length = display.mediaObject.totalTime() + controller.seekSlider.setMaximum(controller.media_info.length) + if controller.media_info.start_time > 0: if display.mediaObject.currentTime() < \ - display.serviceItem.start_time: - self.seek(display, self.serviceItem.start_time * 1000) + controller.media_info.start_time: + self.seek(display, controller.media_info.start_time) + self.set_visible(display, True) + if controller.media_info.end_time > 0: + if display.mediaObject.currentTime() > \ + controller.media_info.end_time: + self.stop(display) + self.set_visible(display, False) if not controller.seekSlider.isSliderDown(): controller.seekSlider.setSliderPosition( \ display.mediaObject.currentTime()) diff --git a/openlp/plugins/media/lib/vlc.py b/openlp/plugins/media/lib/vlc.py index 52526e953..1b6510993 100644 --- a/openlp/plugins/media/lib/vlc.py +++ b/openlp/plugins/media/lib/vlc.py @@ -39,6 +39,7 @@ C{get_instance} method of L{MediaPlayer} and L{MediaListPlayer}. """ import ctypes +from ctypes.util import find_library import os import sys @@ -46,20 +47,20 @@ import sys from inspect import getargspec __version__ = "N/A" -build_date = "Tue Mar 29 12:44:43 2011" +build_date = "Wed May 18 15:32:47 2011" # Used on win32 and MacOS in override.py plugin_path = None if sys.platform.startswith('linux'): + p = find_library('vlc') try: - dll = ctypes.CDLL('libvlc.so') + dll = ctypes.CDLL(p) except OSError: # may fail dll = ctypes.CDLL('libvlc.so.5') elif sys.platform.startswith('win'): - import ctypes.util as u - p = u.find_library('libvlc.dll') + p = find_library('libvlc.dll') if p is None: try: # some registry settings import _winreg as w # leaner than win32api, win32con @@ -94,7 +95,7 @@ elif sys.platform.startswith('win'): else: plugin_path = os.path.dirname(p) dll = ctypes.CDLL(p) - del p, u + del p#, u elif sys.platform.startswith('darwin'): # FIXME: should find a means to configure path @@ -122,16 +123,30 @@ try: except NameError: # no long in Python 3+ _Ints = int +# 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 + _Seqs = (list, tuple) _Cfunctions = {} # from LibVLC __version__ -def _Cfunction(name, flags, *types): +def _Cfunction(name, flags, errcheck, *types): """(INTERNAL) New ctypes function binding. """ if hasattr(dll, name): p = ctypes.CFUNCTYPE(*types) f = p((name, dll), flags) + if errcheck is not None: + f.errcheck = errcheck _Cfunctions[name] = f return f raise NameError('no function %r' % (name,)) @@ -143,7 +158,7 @@ def _Cobject(cls, ctype): o._as_parameter_ = ctype return o -def _Constructor(cls, ptr): +def _Constructor(cls, ptr=None): """(INTERNAL) New wrapper from ctypes. """ if ptr is None: @@ -171,6 +186,27 @@ class ListPOINTER(object): if isinstance(param, _Seqs): return (self.etype * len(param))(*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 = 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): + return classname(result) + return wrap_errcheck + # Generated enum types # class _Enum(ctypes.c_ulong): @@ -739,7 +775,7 @@ class EventManager(_Ctype): @note: Only a single notification can be registered for each event type in an EventManager instance. - + ''' _callback_handler = None @@ -750,7 +786,7 @@ class EventManager(_Ctype): raise VLCException("(INTERNAL) ctypes class.") if ptr == 0: return None - return _Cobject(cls, ptr) # ctypes.c_void_p(ptr) + return _Constructor(cls, ptr) def event_attach(self, eventtype, callback, *args, **kwds): """Register an event notification. @@ -809,7 +845,7 @@ class EventManager(_Ctype): k = eventtype.value if k in self._callbacks: del self._callbacks[k] # remove, regardless of libvlc return value - libvlc_event_detach(self, eventtype, self._callback_handler, k) + libvlc_event_detach(self, k, self._callback_handler, k) class Instance(_Ctype): '''Create a new Instance instance. @@ -818,7 +854,7 @@ class Instance(_Ctype): - a string - a list of strings as first parameters - the parameters given as the constructor parameters (must be strings) - + ''' def __new__(cls, *args): @@ -827,7 +863,7 @@ class Instance(_Ctype): if i == 0: return None if isinstance(i, _Ints): - return _Cobject(cls, ctypes.c_void_p(i)) + return _Constructor(cls, i) if len(args) == 1: if isinstance(i, basestring): args = i.strip().split() @@ -876,8 +912,22 @@ class Instance(_Ctype): m = libvlc_media_new_location(self, mrl) for o in options: libvlc_media_add_option(m, 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. @@ -1030,12 +1080,6 @@ class Instance(_Ctype): ''' return libvlc_media_library_new(self) - def media_list_new(self): - '''Create an empty media list. - @return: empty media list, or NULL on error. - ''' - return libvlc_media_list_new(self) - def audio_output_list_get(self): '''Get the list of available audio outputs. @return: list of available audio outputs. It must be freed it with In case of error, NULL is returned. @@ -1277,7 +1321,7 @@ class Instance(_Ctype): class Log(_Ctype): '''Create a new VLC log instance. - + ''' def __new__(cls, ptr=None): @@ -1321,7 +1365,7 @@ class Log(_Ctype): class LogIterator(_Ctype): '''Create a new VLC log iterator. - + ''' def __new__(cls, ptr=None): @@ -1353,14 +1397,28 @@ class LogIterator(_Ctype): class Media(_Ctype): '''Create a new Media instance. - + + Usage: Media(MRL, *options) + + See vlc.Instance.media_new documentation for details. + ''' - def __new__(cls, ptr=None): - '''(INTERNAL) ctypes wrapper constructor. - ''' - return _Constructor(cls, ptr) + def __new__(cls, *args): + if args: + i = args[0] + if i == 0: + return None + 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. @@ -1537,7 +1595,8 @@ class Media(_Ctype): 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. - @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. + @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed by the caller). + @return: the number of Elementary Streams. ''' return libvlc_media_get_tracks_info(self) @@ -1620,13 +1679,48 @@ class MediaLibrary(_Ctype): return libvlc_media_library_media_list(self) class MediaList(_Ctype): - '''N/A + '''Create a new MediaList instance. + + Usage: MediaList(list_of_MRLs) + + See vlc.Instance.media_list_new documentation for details. + ''' - def __new__(cls, ptr=None): - '''(INTERNAL) ctypes wrapper constructor. - ''' - return _Constructor(cls, ptr) + def __new__(cls, *args): + if args: + i = args[0] + if i == 0: + return None + 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 p_md: 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 __len__(self): + return self.count() + + def __getitem__(self, i): + return self.item_at_index(i) + + def release(self): '''Release media list created with L{new}(). ''' @@ -1653,14 +1747,6 @@ class MediaList(_Ctype): ''' return libvlc_media_list_media(self) - def add_media(self, p_md): - '''Add media instance to media list - The L{lock} should be held upon entering this function. - @param p_md: a media instance. - @return: 0 on success, -1 if the media list is read-only. - ''' - return libvlc_media_list_add_media(self, p_md) - 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. @@ -1742,7 +1828,7 @@ class MediaListPlayer(_Ctype): It may take as parameter either: - a vlc.Instance - nothing - + ''' def __new__(cls, *args): @@ -1751,14 +1837,14 @@ class MediaListPlayer(_Ctype): if i == 0: return None if isinstance(i, _Ints): - return _Cobject(cls, ctypes.c_void_p(i)) + return _Constructor(cls, i) if isinstance(i, _Seqs): args = i if args and isinstance(args[0], Instance): i = args[0] else: - i = Instance() + i = get_default_instance() return i.media_list_player_new() def get_instance(self): @@ -1862,7 +1948,7 @@ class MediaPlayer(_Ctype): It may take as parameter either: - a string (media URI). In this case, a vlc.Instance will be created. - a vlc.Instance - + ''' def __new__(cls, *args): @@ -1871,11 +1957,11 @@ class MediaPlayer(_Ctype): if i == 0: return None if isinstance(i, _Ints): - return _Cobject(cls, ctypes.c_void_p(i)) + return _Constructor(cls, i) if isinstance(i, Instance): return i.media_player_new() - i = Instance() + i = get_default_instance() o = i.media_player_new() if args: o.set_media(i.media_new(*args)) # args[0] @@ -1935,6 +2021,19 @@ class MediaPlayer(_Ctype): 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. @@ -2065,12 +2164,12 @@ class MediaPlayer(_Ctype): If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then the following code should work: @begincode - + NSView *video = [[NSView alloc] init]; QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); L{set_nsobject}(mp, video); [video release]; - + @endcode You can find a live example in VLCVideoView in VLCKit.framework. @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol. @@ -2117,14 +2216,6 @@ class MediaPlayer(_Ctype): ''' return libvlc_media_player_get_xwindow(self) - def set_hwnd(self, drawable): - '''Set a Win32/Win64 API window handle (HWND) where the media player should - render its video output. If LibVLC was built without Win32/Win64 API output - support, then this has no effects. - @param drawable: windows handle of the drawable. - ''' - return libvlc_media_player_set_hwnd(self, drawable) - 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 @@ -2133,6 +2224,17 @@ class MediaPlayer(_Ctype): ''' return libvlc_media_player_get_hwnd(self) + def audio_set_format(self, format, rate, channels): + '''Set decoded audio format. + This only works in combination with libvlc_audio_set_callbacks(), + and is mutually exclusive with libvlc_audio_set_format_callbacks(). + @param fourcc: 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 1.2.0 or later. + ''' + return libvlc_audio_set_format(self, 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. @@ -2652,7 +2754,7 @@ def libvlc_errmsg(): This will be NULL if there was no error. ''' f = _Cfunctions.get('libvlc_errmsg', None) or \ - _Cfunction('libvlc_errmsg', (), + _Cfunction('libvlc_errmsg', (), None, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_errmsg @@ -2665,7 +2767,7 @@ def libvlc_clearerr(): occurs, and destroyed when the thread exits. ''' f = _Cfunctions.get('libvlc_clearerr', None) or \ - _Cfunction('libvlc_clearerr', (), + _Cfunction('libvlc_clearerr', (), None, None) if not __debug__: # i.e. python -O or -OO global libvlc_clearerr @@ -2682,35 +2784,20 @@ def libvlc_new(argc, argv): @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 NULL). 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,),), - Instance, ctypes.c_int, ListPOINTER(ctypes.c_char_p)) + _Cfunction('libvlc_new', ((1,), (1,),), class_result(Instance), + ctypes.c_void_p, ctypes.c_int, ListPOINTER(ctypes.c_char_p)) if not __debug__: # i.e. python -O or -OO global libvlc_new libvlc_new = f return f(argc, argv) -def libvlc_new_with_builtins(argc, argv, builtins): - '''Create and initialize a libvlc instance. - @param argc: the number of arguments. - @param argv: command-line-type arguments. - @param builtins: a NULL terminated array of See vlc_plugin. - @return: the libvlc instance or NULL in case of error @begincode vlc_declare_plugin(mp4); vlc_declare_plugin(dummy); const void **builtins = vlc_plugin(mp4), vlc_plugin(dummy), NULL ; L{Instance} *vlc = L{libvlc_new_with_builtins}(argc, argv, builtins); @endcode. - ''' - f = _Cfunctions.get('libvlc_new_with_builtins', None) or \ - _Cfunction('libvlc_new_with_builtins', ((1,), (1,), (1,),), - Instance, ctypes.c_int, ListPOINTER(ctypes.c_char_p), ListPOINTER(ctypes.c_void_p)) - if not __debug__: # i.e. python -O or -OO - global libvlc_new_with_builtins - libvlc_new_with_builtins = f - return f(argc, argv, builtins) - 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,),), + _Cfunction('libvlc_release', ((1,),), None, None, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_release @@ -2723,7 +2810,7 @@ def libvlc_retain(p_instance): @param p_instance: the instance to reference. ''' f = _Cfunctions.get('libvlc_retain', None) or \ - _Cfunction('libvlc_retain', ((1,),), + _Cfunction('libvlc_retain', ((1,),), None, None, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_retain @@ -2737,7 +2824,7 @@ def libvlc_add_intf(p_instance, name): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_add_intf', None) or \ - _Cfunction('libvlc_add_intf', ((1,), (1,),), + _Cfunction('libvlc_add_intf', ((1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_add_intf @@ -2750,7 +2837,7 @@ def libvlc_wait(p_instance): @param p_instance: the instance. ''' f = _Cfunctions.get('libvlc_wait', None) or \ - _Cfunction('libvlc_wait', ((1,),), + _Cfunction('libvlc_wait', ((1,),), None, None, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_wait @@ -2766,7 +2853,7 @@ def libvlc_set_user_agent(p_instance, name, http): @version: LibVLC 1.1.1 or later. ''' f = _Cfunctions.get('libvlc_set_user_agent', None) or \ - _Cfunction('libvlc_set_user_agent', ((1,), (1,), (1,),), + _Cfunction('libvlc_set_user_agent', ((1,), (1,), (1,),), None, None, Instance, ctypes.c_char_p, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_set_user_agent @@ -2779,7 +2866,7 @@ def libvlc_get_version(): @return: a string containing the libvlc version. ''' f = _Cfunctions.get('libvlc_get_version', None) or \ - _Cfunction('libvlc_get_version', (), + _Cfunction('libvlc_get_version', (), None, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_get_version @@ -2792,7 +2879,7 @@ def libvlc_get_compiler(): @return: a string containing the libvlc compiler version. ''' f = _Cfunctions.get('libvlc_get_compiler', None) or \ - _Cfunction('libvlc_get_compiler', (), + _Cfunction('libvlc_get_compiler', (), None, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_get_compiler @@ -2805,7 +2892,7 @@ def libvlc_get_changeset(): @return: a string containing the libvlc changeset. ''' f = _Cfunctions.get('libvlc_get_changeset', None) or \ - _Cfunction('libvlc_get_changeset', (), + _Cfunction('libvlc_get_changeset', (), None, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_get_changeset @@ -2819,7 +2906,7 @@ def libvlc_free(ptr): @param ptr: the pointer. ''' f = _Cfunctions.get('libvlc_free', None) or \ - _Cfunction('libvlc_free', ((1,),), + _Cfunction('libvlc_free', ((1,),), None, None, ctypes.c_void_p) if not __debug__: # i.e. python -O or -OO global libvlc_free @@ -2835,7 +2922,7 @@ def libvlc_event_attach(p_event_manager, i_event_type, f_callback, user_data): @return: 0 on success, ENOMEM on error. ''' f = _Cfunctions.get('libvlc_event_attach', None) or \ - _Cfunction('libvlc_event_attach', ((1,), (1,), (1,), (1,),), + _Cfunction('libvlc_event_attach', ((1,), (1,), (1,), (1,),), None, ctypes.c_int, EventManager, ctypes.c_uint, ctypes.c_void_p, ctypes.c_void_p) if not __debug__: # i.e. python -O or -OO global libvlc_event_attach @@ -2850,7 +2937,7 @@ def libvlc_event_detach(p_event_manager, i_event_type, f_callback, p_user_data): @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,),), + _Cfunction('libvlc_event_detach', ((1,), (1,), (1,), (1,),), None, None, EventManager, ctypes.c_uint, ctypes.c_void_p, ctypes.c_void_p) if not __debug__: # i.e. python -O or -OO global libvlc_event_detach @@ -2862,7 +2949,7 @@ def libvlc_event_type_name(event_type): @param event_type: the desired event. ''' f = _Cfunctions.get('libvlc_event_type_name', None) or \ - _Cfunction('libvlc_event_type_name', ((1,),), + _Cfunction('libvlc_event_type_name', ((1,),), None, ctypes.c_char_p, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_event_type_name @@ -2875,7 +2962,7 @@ def libvlc_get_log_verbosity(p_instance): @return: verbosity level for messages. ''' f = _Cfunctions.get('libvlc_get_log_verbosity', None) or \ - _Cfunction('libvlc_get_log_verbosity', ((1,),), + _Cfunction('libvlc_get_log_verbosity', ((1,),), None, ctypes.c_uint, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_get_log_verbosity @@ -2888,7 +2975,7 @@ def libvlc_set_log_verbosity(p_instance, level): @param level: log level. ''' f = _Cfunctions.get('libvlc_set_log_verbosity', None) or \ - _Cfunction('libvlc_set_log_verbosity', ((1,), (1,),), + _Cfunction('libvlc_set_log_verbosity', ((1,), (1,),), None, None, Instance, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_set_log_verbosity @@ -2901,8 +2988,8 @@ def libvlc_log_open(p_instance): @return: log message instance or NULL on error. ''' f = _Cfunctions.get('libvlc_log_open', None) or \ - _Cfunction('libvlc_log_open', ((1,),), - Log, Instance) + _Cfunction('libvlc_log_open', ((1,),), class_result(Log), + ctypes.c_void_p, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_log_open libvlc_log_open = f @@ -2913,7 +3000,7 @@ def libvlc_log_close(p_log): @param p_log: libvlc log instance or NULL. ''' f = _Cfunctions.get('libvlc_log_close', None) or \ - _Cfunction('libvlc_log_close', ((1,),), + _Cfunction('libvlc_log_close', ((1,),), None, None, Log) if not __debug__: # i.e. python -O or -OO global libvlc_log_close @@ -2926,7 +3013,7 @@ def libvlc_log_count(p_log): @return: number of log messages, 0 if p_log is NULL. ''' f = _Cfunctions.get('libvlc_log_count', None) or \ - _Cfunction('libvlc_log_count', ((1,),), + _Cfunction('libvlc_log_count', ((1,),), None, ctypes.c_uint, Log) if not __debug__: # i.e. python -O or -OO global libvlc_log_count @@ -2940,7 +3027,7 @@ def libvlc_log_clear(p_log): @param p_log: libvlc log instance or NULL. ''' f = _Cfunctions.get('libvlc_log_clear', None) or \ - _Cfunction('libvlc_log_clear', ((1,),), + _Cfunction('libvlc_log_clear', ((1,),), None, None, Log) if not __debug__: # i.e. python -O or -OO global libvlc_log_clear @@ -2953,8 +3040,8 @@ def libvlc_log_get_iterator(p_log): @return: log iterator object or NULL on error. ''' f = _Cfunctions.get('libvlc_log_get_iterator', None) or \ - _Cfunction('libvlc_log_get_iterator', ((1,),), - LogIterator, Log) + _Cfunction('libvlc_log_get_iterator', ((1,),), class_result(LogIterator), + ctypes.c_void_p, Log) if not __debug__: # i.e. python -O or -OO global libvlc_log_get_iterator libvlc_log_get_iterator = f @@ -2965,7 +3052,7 @@ def libvlc_log_iterator_free(p_iter): @param p_iter: libvlc log iterator or NULL. ''' f = _Cfunctions.get('libvlc_log_iterator_free', None) or \ - _Cfunction('libvlc_log_iterator_free', ((1,),), + _Cfunction('libvlc_log_iterator_free', ((1,),), None, None, LogIterator) if not __debug__: # i.e. python -O or -OO global libvlc_log_iterator_free @@ -2978,7 +3065,7 @@ def libvlc_log_iterator_has_next(p_iter): @return: true if iterator has more message objects, else false. ''' f = _Cfunctions.get('libvlc_log_iterator_has_next', None) or \ - _Cfunction('libvlc_log_iterator_has_next', ((1,),), + _Cfunction('libvlc_log_iterator_has_next', ((1,),), None, ctypes.c_int, LogIterator) if not __debug__: # i.e. python -O or -OO global libvlc_log_iterator_has_next @@ -2993,7 +3080,7 @@ def libvlc_log_iterator_next(p_iter, p_buffer): @return: log message object or NULL if none left. ''' f = _Cfunctions.get('libvlc_log_iterator_next', None) or \ - _Cfunction('libvlc_log_iterator_next', ((1,), (1,),), + _Cfunction('libvlc_log_iterator_next', ((1,), (1,),), None, ctypes.POINTER(LogMessage), LogIterator, ctypes.POINTER(LogMessage)) if not __debug__: # i.e. python -O or -OO global libvlc_log_iterator_next @@ -3005,7 +3092,7 @@ def libvlc_module_description_list_release(p_list): @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,),), + _Cfunction('libvlc_module_description_list_release', ((1,),), None, None, ctypes.POINTER(ModuleDescription)) if not __debug__: # i.e. python -O or -OO global libvlc_module_description_list_release @@ -3018,7 +3105,7 @@ def libvlc_audio_filter_list_get(p_instance): @return: a list of module descriptions. It should be freed with L{libvlc_module_description_list_release}(). In case of an error, NULL 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,),), + _Cfunction('libvlc_audio_filter_list_get', ((1,),), None, ctypes.POINTER(ModuleDescription), Instance) if not __debug__: # i.e. python -O or -OO global libvlc_audio_filter_list_get @@ -3031,13 +3118,29 @@ def libvlc_video_filter_list_get(p_instance): @return: a list of module descriptions. It should be freed with L{libvlc_module_description_list_release}(). In case of an error, NULL 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,),), + _Cfunction('libvlc_video_filter_list_get', ((1,),), None, ctypes.POINTER(ModuleDescription), Instance) if not __debug__: # i.e. python -O or -OO global libvlc_video_filter_list_get libvlc_video_filter_list_get = f 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) + if not __debug__: # i.e. python -O or -OO + global libvlc_clock + libvlc_clock = f + return f() + def libvlc_media_new_location(p_instance, psz_mrl): '''Create a media with a certain given media resource location, for instance a valid URL. @@ -3051,8 +3154,8 @@ def libvlc_media_new_location(p_instance, psz_mrl): @return: the newly created media or NULL on error. ''' f = _Cfunctions.get('libvlc_media_new_location', None) or \ - _Cfunction('libvlc_media_new_location', ((1,), (1,),), - Media, Instance, ctypes.c_char_p) + _Cfunction('libvlc_media_new_location', ((1,), (1,),), class_result(Media), + ctypes.c_void_p, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_new_location libvlc_media_new_location = f @@ -3066,8 +3169,8 @@ def libvlc_media_new_path(p_instance, path): @return: the newly created media or NULL on error. ''' f = _Cfunctions.get('libvlc_media_new_path', None) or \ - _Cfunction('libvlc_media_new_path', ((1,), (1,),), - Media, Instance, ctypes.c_char_p) + _Cfunction('libvlc_media_new_path', ((1,), (1,),), class_result(Media), + ctypes.c_void_p, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_new_path libvlc_media_new_path = f @@ -3093,8 +3196,8 @@ def libvlc_media_new_fd(p_instance, fd): @version: LibVLC 1.1.5 and later. ''' f = _Cfunctions.get('libvlc_media_new_fd', None) or \ - _Cfunction('libvlc_media_new_fd', ((1,), (1,),), - Media, Instance, ctypes.c_int) + _Cfunction('libvlc_media_new_fd', ((1,), (1,),), class_result(Media), + ctypes.c_void_p, Instance, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_new_fd libvlc_media_new_fd = f @@ -3108,8 +3211,8 @@ def libvlc_media_new_as_node(p_instance, psz_name): @return: the new empty media or NULL on error. ''' f = _Cfunctions.get('libvlc_media_new_as_node', None) or \ - _Cfunction('libvlc_media_new_as_node', ((1,), (1,),), - Media, Instance, ctypes.c_char_p) + _Cfunction('libvlc_media_new_as_node', ((1,), (1,),), class_result(Media), + ctypes.c_void_p, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_new_as_node libvlc_media_new_as_node = f @@ -3125,7 +3228,7 @@ def libvlc_media_add_option(p_md, ppsz_options): @param ppsz_options: the options (as a string). ''' f = _Cfunctions.get('libvlc_media_add_option', None) or \ - _Cfunction('libvlc_media_add_option', ((1,), (1,),), + _Cfunction('libvlc_media_add_option', ((1,), (1,),), None, None, Media, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_add_option @@ -3143,7 +3246,7 @@ def libvlc_media_add_option_flag(p_md, ppsz_options, i_flags): @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,),), + _Cfunction('libvlc_media_add_option_flag', ((1,), (1,), (1,),), None, None, Media, ctypes.c_char_p, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_media_add_option_flag @@ -3157,7 +3260,7 @@ def libvlc_media_retain(p_md): @param p_md: the media descriptor. ''' f = _Cfunctions.get('libvlc_media_retain', None) or \ - _Cfunction('libvlc_media_retain', ((1,),), + _Cfunction('libvlc_media_retain', ((1,),), None, None, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_retain @@ -3173,7 +3276,7 @@ def libvlc_media_release(p_md): @param p_md: the media descriptor. ''' f = _Cfunctions.get('libvlc_media_release', None) or \ - _Cfunction('libvlc_media_release', ((1,),), + _Cfunction('libvlc_media_release', ((1,),), None, None, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_release @@ -3186,8 +3289,8 @@ def libvlc_media_get_mrl(p_md): @return: string with mrl of media descriptor object. ''' f = _Cfunctions.get('libvlc_media_get_mrl', None) or \ - _Cfunction('libvlc_media_get_mrl', ((1,),), - ctypes.c_char_p, Media) + _Cfunction('libvlc_media_get_mrl', ((1,),), string_result, + ctypes.c_void_p, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_mrl libvlc_media_get_mrl = f @@ -3198,8 +3301,8 @@ def libvlc_media_duplicate(p_md): @param p_md: a media descriptor object. ''' f = _Cfunctions.get('libvlc_media_duplicate', None) or \ - _Cfunction('libvlc_media_duplicate', ((1,),), - Media, Media) + _Cfunction('libvlc_media_duplicate', ((1,),), class_result(Media), + ctypes.c_void_p, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_duplicate libvlc_media_duplicate = f @@ -3219,8 +3322,8 @@ def libvlc_media_get_meta(p_md, e_meta): @return: the media's meta. ''' f = _Cfunctions.get('libvlc_media_get_meta', None) or \ - _Cfunction('libvlc_media_get_meta', ((1,), (1,),), - ctypes.c_char_p, Media, Meta) + _Cfunction('libvlc_media_get_meta', ((1,), (1,),), string_result, + ctypes.c_void_p, Media, Meta) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_meta libvlc_media_get_meta = f @@ -3234,7 +3337,7 @@ def libvlc_media_set_meta(p_md, e_meta, psz_value): @param psz_value: the media's meta. ''' f = _Cfunctions.get('libvlc_media_set_meta', None) or \ - _Cfunction('libvlc_media_set_meta', ((1,), (1,), (1,),), + _Cfunction('libvlc_media_set_meta', ((1,), (1,), (1,),), None, None, Media, Meta, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_set_meta @@ -3247,7 +3350,7 @@ def libvlc_media_save_meta(p_md): @return: true if the write operation was successfull. ''' f = _Cfunctions.get('libvlc_media_save_meta', None) or \ - _Cfunction('libvlc_media_save_meta', ((1,),), + _Cfunction('libvlc_media_save_meta', ((1,),), None, ctypes.c_int, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_save_meta @@ -3265,7 +3368,7 @@ def libvlc_media_get_state(p_md): @return: state of media descriptor object. ''' f = _Cfunctions.get('libvlc_media_get_state', None) or \ - _Cfunction('libvlc_media_get_state', ((1,),), + _Cfunction('libvlc_media_get_state', ((1,),), None, State, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_state @@ -3279,7 +3382,7 @@ def libvlc_media_get_stats(p_md, p_stats): @return: true if the statistics are available, false otherwise. ''' f = _Cfunctions.get('libvlc_media_get_stats', None) or \ - _Cfunction('libvlc_media_get_stats', ((1,), (1,),), + _Cfunction('libvlc_media_get_stats', ((1,), (1,),), None, ctypes.c_int, Media, ctypes.POINTER(MediaStats)) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_stats @@ -3293,8 +3396,8 @@ def libvlc_media_event_manager(p_md): @return: event manager object. ''' f = _Cfunctions.get('libvlc_media_event_manager', None) or \ - _Cfunction('libvlc_media_event_manager', ((1,),), - EventManager, Media) + _Cfunction('libvlc_media_event_manager', ((1,),), class_result(EventManager), + ctypes.c_void_p, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_event_manager libvlc_media_event_manager = f @@ -3306,7 +3409,7 @@ def libvlc_media_get_duration(p_md): @return: duration of media item or -1 on error. ''' f = _Cfunctions.get('libvlc_media_get_duration', None) or \ - _Cfunction('libvlc_media_get_duration', ((1,),), + _Cfunction('libvlc_media_get_duration', ((1,),), None, ctypes.c_longlong, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_duration @@ -3323,7 +3426,7 @@ def libvlc_media_parse(p_md): @param p_md: media descriptor object. ''' f = _Cfunctions.get('libvlc_media_parse', None) or \ - _Cfunction('libvlc_media_parse', ((1,),), + _Cfunction('libvlc_media_parse', ((1,),), None, None, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_parse @@ -3344,7 +3447,7 @@ def libvlc_media_parse_async(p_md): @param p_md: media descriptor object. ''' f = _Cfunctions.get('libvlc_media_parse_async', None) or \ - _Cfunction('libvlc_media_parse_async', ((1,),), + _Cfunction('libvlc_media_parse_async', ((1,),), None, None, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_parse_async @@ -3358,7 +3461,7 @@ def libvlc_media_is_parsed(p_md): @return: true if media object has been parsed otherwise it returns false. ''' f = _Cfunctions.get('libvlc_media_is_parsed', None) or \ - _Cfunction('libvlc_media_is_parsed', ((1,),), + _Cfunction('libvlc_media_is_parsed', ((1,),), None, ctypes.c_int, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_is_parsed @@ -3373,7 +3476,7 @@ def libvlc_media_set_user_data(p_md, p_new_user_data): @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,),), + _Cfunction('libvlc_media_set_user_data', ((1,), (1,),), None, None, Media, ctypes.c_void_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_set_user_data @@ -3387,7 +3490,7 @@ def libvlc_media_get_user_data(p_md): @param p_md: media descriptor object. ''' f = _Cfunctions.get('libvlc_media_get_user_data', None) or \ - _Cfunction('libvlc_media_get_user_data', ((1,),), + _Cfunction('libvlc_media_get_user_data', ((1,),), None, ctypes.c_void_p, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_user_data @@ -3400,10 +3503,11 @@ def libvlc_media_get_tracks_info(p_md): 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 by the caller) [OUT] return the number of Elementary Streams. + @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed by the caller). + @return: the number of Elementary Streams. ''' f = _Cfunctions.get('libvlc_media_get_tracks_info', None) or \ - _Cfunction('libvlc_media_get_tracks_info', ((1,), (2,),), + _Cfunction('libvlc_media_get_tracks_info', ((1,), (2,),), None, ctypes.c_int, Media, ctypes.POINTER(ctypes.c_void_p)) if not __debug__: # i.e. python -O or -OO global libvlc_media_get_tracks_info @@ -3417,8 +3521,8 @@ def libvlc_media_discoverer_new_from_name(p_inst, psz_name): @return: media discover object or NULL in case of error. ''' f = _Cfunctions.get('libvlc_media_discoverer_new_from_name', None) or \ - _Cfunction('libvlc_media_discoverer_new_from_name', ((1,), (1,),), - MediaDiscoverer, Instance, ctypes.c_char_p) + _Cfunction('libvlc_media_discoverer_new_from_name', ((1,), (1,),), class_result(MediaDiscoverer), + ctypes.c_void_p, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_discoverer_new_from_name libvlc_media_discoverer_new_from_name = f @@ -3430,7 +3534,7 @@ def libvlc_media_discoverer_release(p_mdis): @param p_mdis: media service discover object. ''' f = _Cfunctions.get('libvlc_media_discoverer_release', None) or \ - _Cfunction('libvlc_media_discoverer_release', ((1,),), + _Cfunction('libvlc_media_discoverer_release', ((1,),), None, None, MediaDiscoverer) if not __debug__: # i.e. python -O or -OO global libvlc_media_discoverer_release @@ -3443,8 +3547,8 @@ def libvlc_media_discoverer_localized_name(p_mdis): @return: localized name. ''' f = _Cfunctions.get('libvlc_media_discoverer_localized_name', None) or \ - _Cfunction('libvlc_media_discoverer_localized_name', ((1,),), - ctypes.c_char_p, MediaDiscoverer) + _Cfunction('libvlc_media_discoverer_localized_name', ((1,),), string_result, + ctypes.c_void_p, MediaDiscoverer) if not __debug__: # i.e. python -O or -OO global libvlc_media_discoverer_localized_name libvlc_media_discoverer_localized_name = f @@ -3456,8 +3560,8 @@ def libvlc_media_discoverer_media_list(p_mdis): @return: list of media items. ''' f = _Cfunctions.get('libvlc_media_discoverer_media_list', None) or \ - _Cfunction('libvlc_media_discoverer_media_list', ((1,),), - MediaList, MediaDiscoverer) + _Cfunction('libvlc_media_discoverer_media_list', ((1,),), class_result(MediaList), + ctypes.c_void_p, MediaDiscoverer) if not __debug__: # i.e. python -O or -OO global libvlc_media_discoverer_media_list libvlc_media_discoverer_media_list = f @@ -3469,8 +3573,8 @@ def libvlc_media_discoverer_event_manager(p_mdis): @return: event manager object. ''' f = _Cfunctions.get('libvlc_media_discoverer_event_manager', None) or \ - _Cfunction('libvlc_media_discoverer_event_manager', ((1,),), - EventManager, MediaDiscoverer) + _Cfunction('libvlc_media_discoverer_event_manager', ((1,),), class_result(EventManager), + ctypes.c_void_p, MediaDiscoverer) if not __debug__: # i.e. python -O or -OO global libvlc_media_discoverer_event_manager libvlc_media_discoverer_event_manager = f @@ -3482,7 +3586,7 @@ def libvlc_media_discoverer_is_running(p_mdis): @return: true if running, false if not. ''' f = _Cfunctions.get('libvlc_media_discoverer_is_running', None) or \ - _Cfunction('libvlc_media_discoverer_is_running', ((1,),), + _Cfunction('libvlc_media_discoverer_is_running', ((1,),), None, ctypes.c_int, MediaDiscoverer) if not __debug__: # i.e. python -O or -OO global libvlc_media_discoverer_is_running @@ -3495,8 +3599,8 @@ def libvlc_media_library_new(p_instance): @return: a new object or NULL on error. ''' f = _Cfunctions.get('libvlc_media_library_new', None) or \ - _Cfunction('libvlc_media_library_new', ((1,),), - MediaLibrary, Instance) + _Cfunction('libvlc_media_library_new', ((1,),), class_result(MediaLibrary), + ctypes.c_void_p, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_media_library_new libvlc_media_library_new = f @@ -3509,7 +3613,7 @@ def libvlc_media_library_release(p_mlib): @param p_mlib: media library object. ''' f = _Cfunctions.get('libvlc_media_library_release', None) or \ - _Cfunction('libvlc_media_library_release', ((1,),), + _Cfunction('libvlc_media_library_release', ((1,),), None, None, MediaLibrary) if not __debug__: # i.e. python -O or -OO global libvlc_media_library_release @@ -3523,7 +3627,7 @@ def libvlc_media_library_retain(p_mlib): @param p_mlib: media library object. ''' f = _Cfunctions.get('libvlc_media_library_retain', None) or \ - _Cfunction('libvlc_media_library_retain', ((1,),), + _Cfunction('libvlc_media_library_retain', ((1,),), None, None, MediaLibrary) if not __debug__: # i.e. python -O or -OO global libvlc_media_library_retain @@ -3536,7 +3640,7 @@ def libvlc_media_library_load(p_mlib): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_media_library_load', None) or \ - _Cfunction('libvlc_media_library_load', ((1,),), + _Cfunction('libvlc_media_library_load', ((1,),), None, ctypes.c_int, MediaLibrary) if not __debug__: # i.e. python -O or -OO global libvlc_media_library_load @@ -3549,8 +3653,8 @@ def libvlc_media_library_media_list(p_mlib): @return: media list subitems. ''' f = _Cfunctions.get('libvlc_media_library_media_list', None) or \ - _Cfunction('libvlc_media_library_media_list', ((1,),), - MediaList, MediaLibrary) + _Cfunction('libvlc_media_library_media_list', ((1,),), class_result(MediaList), + ctypes.c_void_p, MediaLibrary) if not __debug__: # i.e. python -O or -OO global libvlc_media_library_media_list libvlc_media_library_media_list = f @@ -3562,8 +3666,8 @@ def libvlc_media_list_new(p_instance): @return: empty media list, or NULL on error. ''' f = _Cfunctions.get('libvlc_media_list_new', None) or \ - _Cfunction('libvlc_media_list_new', ((1,),), - MediaList, Instance) + _Cfunction('libvlc_media_list_new', ((1,),), class_result(MediaList), + ctypes.c_void_p, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_new libvlc_media_list_new = f @@ -3574,7 +3678,7 @@ def libvlc_media_list_release(p_ml): @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,),), + _Cfunction('libvlc_media_list_release', ((1,),), None, None, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_release @@ -3586,7 +3690,7 @@ def libvlc_media_list_retain(p_ml): @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,),), + _Cfunction('libvlc_media_list_retain', ((1,),), None, None, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_retain @@ -3601,7 +3705,7 @@ def libvlc_media_list_set_media(p_ml, p_md): @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,),), + _Cfunction('libvlc_media_list_set_media', ((1,), (1,),), None, None, MediaList, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_set_media @@ -3616,8 +3720,8 @@ def libvlc_media_list_media(p_ml): @return: media instance. ''' f = _Cfunctions.get('libvlc_media_list_media', None) or \ - _Cfunction('libvlc_media_list_media', ((1,),), - Media, MediaList) + _Cfunction('libvlc_media_list_media', ((1,),), class_result(Media), + ctypes.c_void_p, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_media libvlc_media_list_media = f @@ -3631,7 +3735,7 @@ def libvlc_media_list_add_media(p_ml, p_md): @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,),), + _Cfunction('libvlc_media_list_add_media', ((1,), (1,),), None, ctypes.c_int, MediaList, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_add_media @@ -3647,7 +3751,7 @@ def libvlc_media_list_insert_media(p_ml, p_md, i_pos): @return: 0 on success, -1 if the media list si read-only. ''' f = _Cfunctions.get('libvlc_media_list_insert_media', None) or \ - _Cfunction('libvlc_media_list_insert_media', ((1,), (1,), (1,),), + _Cfunction('libvlc_media_list_insert_media', ((1,), (1,), (1,),), None, ctypes.c_int, MediaList, Media, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_insert_media @@ -3662,7 +3766,7 @@ def libvlc_media_list_remove_index(p_ml, i_pos): @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,),), + _Cfunction('libvlc_media_list_remove_index', ((1,), (1,),), None, ctypes.c_int, MediaList, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_remove_index @@ -3676,7 +3780,7 @@ def libvlc_media_list_count(p_ml): @return: number of items in media list. ''' f = _Cfunctions.get('libvlc_media_list_count', None) or \ - _Cfunction('libvlc_media_list_count', ((1,),), + _Cfunction('libvlc_media_list_count', ((1,),), None, ctypes.c_int, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_count @@ -3691,8 +3795,8 @@ def libvlc_media_list_item_at_index(p_ml, i_pos): @return: media instance at position i_pos, or NULL 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,),), - Media, MediaList, ctypes.c_int) + _Cfunction('libvlc_media_list_item_at_index', ((1,), (1,),), class_result(Media), + ctypes.c_void_p, MediaList, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_item_at_index libvlc_media_list_item_at_index = f @@ -3707,7 +3811,7 @@ def libvlc_media_list_index_of_item(p_ml, p_md): @return: position of media instance. ''' f = _Cfunctions.get('libvlc_media_list_index_of_item', None) or \ - _Cfunction('libvlc_media_list_index_of_item', ((1,), (1,),), + _Cfunction('libvlc_media_list_index_of_item', ((1,), (1,),), None, ctypes.c_int, MediaList, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_index_of_item @@ -3720,7 +3824,7 @@ def libvlc_media_list_is_readonly(p_ml): @return: 0 on readonly, 1 on readwrite. ''' f = _Cfunctions.get('libvlc_media_list_is_readonly', None) or \ - _Cfunction('libvlc_media_list_is_readonly', ((1,),), + _Cfunction('libvlc_media_list_is_readonly', ((1,),), None, ctypes.c_int, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_is_readonly @@ -3732,7 +3836,7 @@ def libvlc_media_list_lock(p_ml): @param p_ml: a media list instance. ''' f = _Cfunctions.get('libvlc_media_list_lock', None) or \ - _Cfunction('libvlc_media_list_lock', ((1,),), + _Cfunction('libvlc_media_list_lock', ((1,),), None, None, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_lock @@ -3745,7 +3849,7 @@ def libvlc_media_list_unlock(p_ml): @param p_ml: a media list instance. ''' f = _Cfunctions.get('libvlc_media_list_unlock', None) or \ - _Cfunction('libvlc_media_list_unlock', ((1,),), + _Cfunction('libvlc_media_list_unlock', ((1,),), None, None, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_unlock @@ -3759,8 +3863,8 @@ def libvlc_media_list_event_manager(p_ml): @return: libvlc_event_manager. ''' f = _Cfunctions.get('libvlc_media_list_event_manager', None) or \ - _Cfunction('libvlc_media_list_event_manager', ((1,),), - EventManager, MediaList) + _Cfunction('libvlc_media_list_event_manager', ((1,),), class_result(EventManager), + ctypes.c_void_p, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_event_manager libvlc_media_list_event_manager = f @@ -3772,8 +3876,8 @@ def libvlc_media_list_player_new(p_instance): @return: media list player instance or NULL on error. ''' f = _Cfunctions.get('libvlc_media_list_player_new', None) or \ - _Cfunction('libvlc_media_list_player_new', ((1,),), - MediaListPlayer, Instance) + _Cfunction('libvlc_media_list_player_new', ((1,),), class_result(MediaListPlayer), + ctypes.c_void_p, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_new libvlc_media_list_player_new = f @@ -3784,7 +3888,7 @@ def libvlc_media_list_player_release(p_mlp): @param p_mlp: media list player instance. ''' f = _Cfunctions.get('libvlc_media_list_player_release', None) or \ - _Cfunction('libvlc_media_list_player_release', ((1,),), + _Cfunction('libvlc_media_list_player_release', ((1,),), None, None, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_release @@ -3797,8 +3901,8 @@ def libvlc_media_list_player_event_manager(p_mlp): @return: the event manager. ''' f = _Cfunctions.get('libvlc_media_list_player_event_manager', None) or \ - _Cfunction('libvlc_media_list_player_event_manager', ((1,),), - EventManager, MediaListPlayer) + _Cfunction('libvlc_media_list_player_event_manager', ((1,),), class_result(EventManager), + ctypes.c_void_p, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_event_manager libvlc_media_list_player_event_manager = f @@ -3810,7 +3914,7 @@ def libvlc_media_list_player_set_media_player(p_mlp, p_mi): @param p_mi: media player instance. ''' f = _Cfunctions.get('libvlc_media_list_player_set_media_player', None) or \ - _Cfunction('libvlc_media_list_player_set_media_player', ((1,), (1,),), + _Cfunction('libvlc_media_list_player_set_media_player', ((1,), (1,),), None, None, MediaListPlayer, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_set_media_player @@ -3823,7 +3927,7 @@ def libvlc_media_list_player_set_media_list(p_mlp, p_mlist): @param p_mlist: list of media. ''' f = _Cfunctions.get('libvlc_media_list_player_set_media_list', None) or \ - _Cfunction('libvlc_media_list_player_set_media_list', ((1,), (1,),), + _Cfunction('libvlc_media_list_player_set_media_list', ((1,), (1,),), None, None, MediaListPlayer, MediaList) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_set_media_list @@ -3835,7 +3939,7 @@ def libvlc_media_list_player_play(p_mlp): @param p_mlp: media list player instance. ''' f = _Cfunctions.get('libvlc_media_list_player_play', None) or \ - _Cfunction('libvlc_media_list_player_play', ((1,),), + _Cfunction('libvlc_media_list_player_play', ((1,),), None, None, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_play @@ -3847,7 +3951,7 @@ def libvlc_media_list_player_pause(p_mlp): @param p_mlp: media list player instance. ''' f = _Cfunctions.get('libvlc_media_list_player_pause', None) or \ - _Cfunction('libvlc_media_list_player_pause', ((1,),), + _Cfunction('libvlc_media_list_player_pause', ((1,),), None, None, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_pause @@ -3860,7 +3964,7 @@ def libvlc_media_list_player_is_playing(p_mlp): @return: true for playing and false for not playing. ''' f = _Cfunctions.get('libvlc_media_list_player_is_playing', None) or \ - _Cfunction('libvlc_media_list_player_is_playing', ((1,),), + _Cfunction('libvlc_media_list_player_is_playing', ((1,),), None, ctypes.c_int, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_is_playing @@ -3873,7 +3977,7 @@ def libvlc_media_list_player_get_state(p_mlp): @return: libvlc_state_t for media list player. ''' f = _Cfunctions.get('libvlc_media_list_player_get_state', None) or \ - _Cfunction('libvlc_media_list_player_get_state', ((1,),), + _Cfunction('libvlc_media_list_player_get_state', ((1,),), None, State, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_get_state @@ -3887,7 +3991,7 @@ def libvlc_media_list_player_play_item_at_index(p_mlp, i_index): @return: 0 upon success -1 if the item wasn't found. ''' f = _Cfunctions.get('libvlc_media_list_player_play_item_at_index', None) or \ - _Cfunction('libvlc_media_list_player_play_item_at_index', ((1,), (1,),), + _Cfunction('libvlc_media_list_player_play_item_at_index', ((1,), (1,),), None, ctypes.c_int, MediaListPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_play_item_at_index @@ -3901,7 +4005,7 @@ def libvlc_media_list_player_play_item(p_mlp, p_md): @return: 0 upon success, -1 if the media is not part of the media list. ''' f = _Cfunctions.get('libvlc_media_list_player_play_item', None) or \ - _Cfunction('libvlc_media_list_player_play_item', ((1,), (1,),), + _Cfunction('libvlc_media_list_player_play_item', ((1,), (1,),), None, ctypes.c_int, MediaListPlayer, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_play_item @@ -3913,7 +4017,7 @@ def libvlc_media_list_player_stop(p_mlp): @param p_mlp: media list player instance. ''' f = _Cfunctions.get('libvlc_media_list_player_stop', None) or \ - _Cfunction('libvlc_media_list_player_stop', ((1,),), + _Cfunction('libvlc_media_list_player_stop', ((1,),), None, None, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_stop @@ -3926,7 +4030,7 @@ def libvlc_media_list_player_next(p_mlp): @return: 0 upon success -1 if there is no next item. ''' f = _Cfunctions.get('libvlc_media_list_player_next', None) or \ - _Cfunction('libvlc_media_list_player_next', ((1,),), + _Cfunction('libvlc_media_list_player_next', ((1,),), None, ctypes.c_int, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_next @@ -3939,7 +4043,7 @@ def libvlc_media_list_player_previous(p_mlp): @return: 0 upon success -1 if there is no previous item. ''' f = _Cfunctions.get('libvlc_media_list_player_previous', None) or \ - _Cfunction('libvlc_media_list_player_previous', ((1,),), + _Cfunction('libvlc_media_list_player_previous', ((1,),), None, ctypes.c_int, MediaListPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_previous @@ -3952,7 +4056,7 @@ def libvlc_media_list_player_set_playback_mode(p_mlp, e_mode): @param e_mode: playback mode specification. ''' f = _Cfunctions.get('libvlc_media_list_player_set_playback_mode', None) or \ - _Cfunction('libvlc_media_list_player_set_playback_mode', ((1,), (1,),), + _Cfunction('libvlc_media_list_player_set_playback_mode', ((1,), (1,),), None, None, MediaListPlayer, PlaybackMode) if not __debug__: # i.e. python -O or -OO global libvlc_media_list_player_set_playback_mode @@ -3965,8 +4069,8 @@ def libvlc_media_player_new(p_libvlc_instance): @return: a new media player object, or NULL on error. ''' f = _Cfunctions.get('libvlc_media_player_new', None) or \ - _Cfunction('libvlc_media_player_new', ((1,),), - MediaPlayer, Instance) + _Cfunction('libvlc_media_player_new', ((1,),), class_result(MediaPlayer), + ctypes.c_void_p, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_new libvlc_media_player_new = f @@ -3978,8 +4082,8 @@ def libvlc_media_player_new_from_media(p_md): @return: a new media player object, or NULL on error. ''' f = _Cfunctions.get('libvlc_media_player_new_from_media', None) or \ - _Cfunction('libvlc_media_player_new_from_media', ((1,),), - MediaPlayer, Media) + _Cfunction('libvlc_media_player_new_from_media', ((1,),), class_result(MediaPlayer), + ctypes.c_void_p, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_new_from_media libvlc_media_player_new_from_media = f @@ -3994,7 +4098,7 @@ def libvlc_media_player_release(p_mi): @param p_mi: the Media Player to free. ''' f = _Cfunctions.get('libvlc_media_player_release', None) or \ - _Cfunction('libvlc_media_player_release', ((1,),), + _Cfunction('libvlc_media_player_release', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_release @@ -4007,7 +4111,7 @@ def libvlc_media_player_retain(p_mi): @param p_mi: media player object. ''' f = _Cfunctions.get('libvlc_media_player_retain', None) or \ - _Cfunction('libvlc_media_player_retain', ((1,),), + _Cfunction('libvlc_media_player_retain', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_retain @@ -4021,7 +4125,7 @@ def libvlc_media_player_set_media(p_mi, p_md): @param p_md: the Media. Afterwards the p_md can be safely destroyed. ''' f = _Cfunctions.get('libvlc_media_player_set_media', None) or \ - _Cfunction('libvlc_media_player_set_media', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_media', ((1,), (1,),), None, None, MediaPlayer, Media) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_media @@ -4034,8 +4138,8 @@ def libvlc_media_player_get_media(p_mi): @return: the media associated with p_mi, or NULL if no media is associated. ''' f = _Cfunctions.get('libvlc_media_player_get_media', None) or \ - _Cfunction('libvlc_media_player_get_media', ((1,),), - Media, MediaPlayer) + _Cfunction('libvlc_media_player_get_media', ((1,),), class_result(Media), + ctypes.c_void_p, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_media libvlc_media_player_get_media = f @@ -4047,8 +4151,8 @@ def libvlc_media_player_event_manager(p_mi): @return: the event manager associated with p_mi. ''' f = _Cfunctions.get('libvlc_media_player_event_manager', None) or \ - _Cfunction('libvlc_media_player_event_manager', ((1,),), - EventManager, MediaPlayer) + _Cfunction('libvlc_media_player_event_manager', ((1,),), class_result(EventManager), + ctypes.c_void_p, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_event_manager libvlc_media_player_event_manager = f @@ -4060,7 +4164,7 @@ def libvlc_media_player_is_playing(p_mi): @return: 1 if the media player is playing, 0 otherwise. ''' f = _Cfunctions.get('libvlc_media_player_is_playing', None) or \ - _Cfunction('libvlc_media_player_is_playing', ((1,),), + _Cfunction('libvlc_media_player_is_playing', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_is_playing @@ -4073,7 +4177,7 @@ def libvlc_media_player_play(p_mi): @return: 0 if playback started (and was already started), or -1 on error. ''' f = _Cfunctions.get('libvlc_media_player_play', None) or \ - _Cfunction('libvlc_media_player_play', ((1,),), + _Cfunction('libvlc_media_player_play', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_play @@ -4087,7 +4191,7 @@ def libvlc_media_player_set_pause(mp, do_pause): @version: LibVLC 1.1.1 or later. ''' f = _Cfunctions.get('libvlc_media_player_set_pause', None) or \ - _Cfunction('libvlc_media_player_set_pause', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_pause', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_pause @@ -4099,7 +4203,7 @@ def libvlc_media_player_pause(p_mi): @param p_mi: the Media Player. ''' f = _Cfunctions.get('libvlc_media_player_pause', None) or \ - _Cfunction('libvlc_media_player_pause', ((1,),), + _Cfunction('libvlc_media_player_pause', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_pause @@ -4111,7 +4215,7 @@ def libvlc_media_player_stop(p_mi): @param p_mi: the Media Player. ''' f = _Cfunctions.get('libvlc_media_player_stop', None) or \ - _Cfunction('libvlc_media_player_stop', ((1,),), + _Cfunction('libvlc_media_player_stop', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_stop @@ -4131,7 +4235,7 @@ def libvlc_video_set_format(mp, chroma, width, height, pitch): @bug: All pixel planes are expected to have the same pitch. To use the YCbCr color space with chrominance subsampling, consider using libvlc_video_set_format_callbacks() instead. ''' f = _Cfunctions.get('libvlc_video_set_format', None) or \ - _Cfunction('libvlc_video_set_format', ((1,), (1,), (1,), (1,), (1,),), + _Cfunction('libvlc_video_set_format', ((1,), (1,), (1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_format @@ -4153,19 +4257,19 @@ def libvlc_media_player_set_nsobject(p_mi, drawable): If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then the following code should work: @begincode - + NSView *video = [[NSView alloc] init]; QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); L{libvlc_media_player_set_nsobject}(mp, video); [video release]; - + @endcode You can find a live example in VLCVideoView in VLCKit.framework. @param p_mi: the Media Player. @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol. ''' f = _Cfunctions.get('libvlc_media_player_set_nsobject', None) or \ - _Cfunction('libvlc_media_player_set_nsobject', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_nsobject', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_void_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_nsobject @@ -4178,7 +4282,7 @@ def libvlc_media_player_get_nsobject(p_mi): @return: the NSView handler or 0 if none where set. ''' f = _Cfunctions.get('libvlc_media_player_get_nsobject', None) or \ - _Cfunction('libvlc_media_player_get_nsobject', ((1,),), + _Cfunction('libvlc_media_player_get_nsobject', ((1,),), None, ctypes.c_void_p, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_nsobject @@ -4191,7 +4295,7 @@ def libvlc_media_player_set_agl(p_mi, drawable): @param drawable: the agl handler. ''' f = _Cfunctions.get('libvlc_media_player_set_agl', None) or \ - _Cfunction('libvlc_media_player_set_agl', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_agl', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_uint32) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_agl @@ -4204,7 +4308,7 @@ def libvlc_media_player_get_agl(p_mi): @return: the agl handler or 0 if none where set. ''' f = _Cfunctions.get('libvlc_media_player_get_agl', None) or \ - _Cfunction('libvlc_media_player_get_agl', ((1,),), + _Cfunction('libvlc_media_player_get_agl', ((1,),), None, ctypes.c_uint32, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_agl @@ -4224,7 +4328,7 @@ def libvlc_media_player_set_xwindow(p_mi, drawable): @param drawable: the ID of the X window. ''' f = _Cfunctions.get('libvlc_media_player_set_xwindow', None) or \ - _Cfunction('libvlc_media_player_set_xwindow', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_xwindow', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_uint32) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_xwindow @@ -4240,7 +4344,7 @@ def libvlc_media_player_get_xwindow(p_mi): @return: an X window ID, or 0 if none where set. ''' f = _Cfunctions.get('libvlc_media_player_get_xwindow', None) or \ - _Cfunction('libvlc_media_player_get_xwindow', ((1,),), + _Cfunction('libvlc_media_player_get_xwindow', ((1,),), None, ctypes.c_uint32, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_xwindow @@ -4255,7 +4359,7 @@ def libvlc_media_player_set_hwnd(p_mi, drawable): @param drawable: windows handle of the drawable. ''' f = _Cfunctions.get('libvlc_media_player_set_hwnd', None) or \ - _Cfunction('libvlc_media_player_set_hwnd', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_hwnd', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_void_p) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_hwnd @@ -4270,20 +4374,38 @@ def libvlc_media_player_get_hwnd(p_mi): @return: a window handle or NULL if there are none. ''' f = _Cfunctions.get('libvlc_media_player_get_hwnd', None) or \ - _Cfunction('libvlc_media_player_get_hwnd', ((1,),), + _Cfunction('libvlc_media_player_get_hwnd', ((1,),), None, ctypes.c_void_p, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_hwnd libvlc_media_player_get_hwnd = f return f(p_mi) +def libvlc_audio_set_format(mp, format, rate, channels): + '''Set decoded audio format. + This only works in combination with libvlc_audio_set_callbacks(), + and is mutually exclusive with libvlc_audio_set_format_callbacks(). + @param mp: the media player. + @param fourcc: 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 1.2.0 or later. + ''' + f = _Cfunctions.get('libvlc_audio_set_format', None) or \ + _Cfunction('libvlc_audio_set_format', ((1,), (1,), (1,), (1,),), None, + None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint) + if not __debug__: # i.e. python -O or -OO + global libvlc_audio_set_format + libvlc_audio_set_format = f + return f(mp, format, rate, channels) + def libvlc_media_player_get_length(p_mi): '''Get the current movie length (in ms). @param p_mi: the Media Player. @return: the movie length (in ms), or -1 if there is no media. ''' f = _Cfunctions.get('libvlc_media_player_get_length', None) or \ - _Cfunction('libvlc_media_player_get_length', ((1,),), + _Cfunction('libvlc_media_player_get_length', ((1,),), None, ctypes.c_longlong, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_length @@ -4296,7 +4418,7 @@ def libvlc_media_player_get_time(p_mi): @return: the movie time (in ms), or -1 if there is no media. ''' f = _Cfunctions.get('libvlc_media_player_get_time', None) or \ - _Cfunction('libvlc_media_player_get_time', ((1,),), + _Cfunction('libvlc_media_player_get_time', ((1,),), None, ctypes.c_longlong, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_time @@ -4310,7 +4432,7 @@ def libvlc_media_player_set_time(p_mi, i_time): @param i_time: the movie time (in ms). ''' f = _Cfunctions.get('libvlc_media_player_set_time', None) or \ - _Cfunction('libvlc_media_player_set_time', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_time', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_longlong) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_time @@ -4323,7 +4445,7 @@ def libvlc_media_player_get_position(p_mi): @return: movie position, or -1. in case of error. ''' f = _Cfunctions.get('libvlc_media_player_get_position', None) or \ - _Cfunction('libvlc_media_player_get_position', ((1,),), + _Cfunction('libvlc_media_player_get_position', ((1,),), None, ctypes.c_float, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_position @@ -4337,7 +4459,7 @@ def libvlc_media_player_set_position(p_mi, f_pos): @param f_pos: the position. ''' f = _Cfunctions.get('libvlc_media_player_set_position', None) or \ - _Cfunction('libvlc_media_player_set_position', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_position', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_float) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_position @@ -4350,7 +4472,7 @@ def libvlc_media_player_set_chapter(p_mi, i_chapter): @param i_chapter: chapter number to play. ''' f = _Cfunctions.get('libvlc_media_player_set_chapter', None) or \ - _Cfunction('libvlc_media_player_set_chapter', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_chapter', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_chapter @@ -4363,7 +4485,7 @@ def libvlc_media_player_get_chapter(p_mi): @return: chapter number currently playing, or -1 if there is no media. ''' f = _Cfunctions.get('libvlc_media_player_get_chapter', None) or \ - _Cfunction('libvlc_media_player_get_chapter', ((1,),), + _Cfunction('libvlc_media_player_get_chapter', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_chapter @@ -4376,7 +4498,7 @@ def libvlc_media_player_get_chapter_count(p_mi): @return: number of chapters in movie, or -1. ''' f = _Cfunctions.get('libvlc_media_player_get_chapter_count', None) or \ - _Cfunction('libvlc_media_player_get_chapter_count', ((1,),), + _Cfunction('libvlc_media_player_get_chapter_count', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_chapter_count @@ -4389,7 +4511,7 @@ def libvlc_media_player_will_play(p_mi): @return: boolean. ''' f = _Cfunctions.get('libvlc_media_player_will_play', None) or \ - _Cfunction('libvlc_media_player_will_play', ((1,),), + _Cfunction('libvlc_media_player_will_play', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_will_play @@ -4403,7 +4525,7 @@ def libvlc_media_player_get_chapter_count_for_title(p_mi, i_title): @return: number of chapters in title, or -1. ''' f = _Cfunctions.get('libvlc_media_player_get_chapter_count_for_title', None) or \ - _Cfunction('libvlc_media_player_get_chapter_count_for_title', ((1,), (1,),), + _Cfunction('libvlc_media_player_get_chapter_count_for_title', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_chapter_count_for_title @@ -4416,7 +4538,7 @@ def libvlc_media_player_set_title(p_mi, i_title): @param i_title: title number to play. ''' f = _Cfunctions.get('libvlc_media_player_set_title', None) or \ - _Cfunction('libvlc_media_player_set_title', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_title', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_title @@ -4429,7 +4551,7 @@ def libvlc_media_player_get_title(p_mi): @return: title number currently playing, or -1. ''' f = _Cfunctions.get('libvlc_media_player_get_title', None) or \ - _Cfunction('libvlc_media_player_get_title', ((1,),), + _Cfunction('libvlc_media_player_get_title', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_title @@ -4442,7 +4564,7 @@ def libvlc_media_player_get_title_count(p_mi): @return: title number count, or -1. ''' f = _Cfunctions.get('libvlc_media_player_get_title_count', None) or \ - _Cfunction('libvlc_media_player_get_title_count', ((1,),), + _Cfunction('libvlc_media_player_get_title_count', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_title_count @@ -4454,7 +4576,7 @@ def libvlc_media_player_previous_chapter(p_mi): @param p_mi: the Media Player. ''' f = _Cfunctions.get('libvlc_media_player_previous_chapter', None) or \ - _Cfunction('libvlc_media_player_previous_chapter', ((1,),), + _Cfunction('libvlc_media_player_previous_chapter', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_previous_chapter @@ -4466,7 +4588,7 @@ def libvlc_media_player_next_chapter(p_mi): @param p_mi: the Media Player. ''' f = _Cfunctions.get('libvlc_media_player_next_chapter', None) or \ - _Cfunction('libvlc_media_player_next_chapter', ((1,),), + _Cfunction('libvlc_media_player_next_chapter', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_next_chapter @@ -4481,7 +4603,7 @@ def libvlc_media_player_get_rate(p_mi): @return: movie play rate. ''' f = _Cfunctions.get('libvlc_media_player_get_rate', None) or \ - _Cfunction('libvlc_media_player_get_rate', ((1,),), + _Cfunction('libvlc_media_player_get_rate', ((1,),), None, ctypes.c_float, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_rate @@ -4495,7 +4617,7 @@ def libvlc_media_player_set_rate(p_mi, rate): @return: -1 if an error was detected, 0 otherwise (but even then, it might not actually work depending on the underlying media protocol). ''' f = _Cfunctions.get('libvlc_media_player_set_rate', None) or \ - _Cfunction('libvlc_media_player_set_rate', ((1,), (1,),), + _Cfunction('libvlc_media_player_set_rate', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_float) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_set_rate @@ -4508,7 +4630,7 @@ def libvlc_media_player_get_state(p_mi): @return: the current state of the media player (playing, paused, ...) See libvlc_state_t. ''' f = _Cfunctions.get('libvlc_media_player_get_state', None) or \ - _Cfunction('libvlc_media_player_get_state', ((1,),), + _Cfunction('libvlc_media_player_get_state', ((1,),), None, State, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_state @@ -4521,7 +4643,7 @@ def libvlc_media_player_get_fps(p_mi): @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,),), + _Cfunction('libvlc_media_player_get_fps', ((1,),), None, ctypes.c_float, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_get_fps @@ -4534,7 +4656,7 @@ def libvlc_media_player_has_vout(p_mi): @return: the number of video outputs. ''' f = _Cfunctions.get('libvlc_media_player_has_vout', None) or \ - _Cfunction('libvlc_media_player_has_vout', ((1,),), + _Cfunction('libvlc_media_player_has_vout', ((1,),), None, ctypes.c_uint, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_has_vout @@ -4547,7 +4669,7 @@ def libvlc_media_player_is_seekable(p_mi): @return: true if the media player can seek. ''' f = _Cfunctions.get('libvlc_media_player_is_seekable', None) or \ - _Cfunction('libvlc_media_player_is_seekable', ((1,),), + _Cfunction('libvlc_media_player_is_seekable', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_is_seekable @@ -4560,7 +4682,7 @@ def libvlc_media_player_can_pause(p_mi): @return: true if the media player can pause. ''' f = _Cfunctions.get('libvlc_media_player_can_pause', None) or \ - _Cfunction('libvlc_media_player_can_pause', ((1,),), + _Cfunction('libvlc_media_player_can_pause', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_can_pause @@ -4572,7 +4694,7 @@ def libvlc_media_player_next_frame(p_mi): @param p_mi: the media player. ''' f = _Cfunctions.get('libvlc_media_player_next_frame', None) or \ - _Cfunction('libvlc_media_player_next_frame', ((1,),), + _Cfunction('libvlc_media_player_next_frame', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_next_frame @@ -4586,7 +4708,7 @@ def libvlc_media_player_navigate(p_mi, navigate): @version: libVLC 1.2.0 or later. ''' f = _Cfunctions.get('libvlc_media_player_navigate', None) or \ - _Cfunction('libvlc_media_player_navigate', ((1,), (1,),), + _Cfunction('libvlc_media_player_navigate', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_media_player_navigate @@ -4598,7 +4720,7 @@ def libvlc_track_description_release(p_track_description): @param p_track_description: the structure to release. ''' f = _Cfunctions.get('libvlc_track_description_release', None) or \ - _Cfunction('libvlc_track_description_release', ((1,),), + _Cfunction('libvlc_track_description_release', ((1,),), None, None, ctypes.POINTER(TrackDescription)) if not __debug__: # i.e. python -O or -OO global libvlc_track_description_release @@ -4612,7 +4734,7 @@ def libvlc_toggle_fullscreen(p_mi): @param p_mi: the media player. ''' f = _Cfunctions.get('libvlc_toggle_fullscreen', None) or \ - _Cfunction('libvlc_toggle_fullscreen', ((1,),), + _Cfunction('libvlc_toggle_fullscreen', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_toggle_fullscreen @@ -4631,7 +4753,7 @@ def libvlc_set_fullscreen(p_mi, b_fullscreen): @param b_fullscreen: boolean for fullscreen status. ''' f = _Cfunctions.get('libvlc_set_fullscreen', None) or \ - _Cfunction('libvlc_set_fullscreen', ((1,), (1,),), + _Cfunction('libvlc_set_fullscreen', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_set_fullscreen @@ -4644,7 +4766,7 @@ def libvlc_get_fullscreen(p_mi): @return: the fullscreen status (boolean). ''' f = _Cfunctions.get('libvlc_get_fullscreen', None) or \ - _Cfunction('libvlc_get_fullscreen', ((1,),), + _Cfunction('libvlc_get_fullscreen', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_get_fullscreen @@ -4664,7 +4786,7 @@ def libvlc_video_set_key_input(p_mi, on): @param on: true to handle key press events, false to ignore them. ''' f = _Cfunctions.get('libvlc_video_set_key_input', None) or \ - _Cfunction('libvlc_video_set_key_input', ((1,), (1,),), + _Cfunction('libvlc_video_set_key_input', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_key_input @@ -4681,7 +4803,7 @@ def libvlc_video_set_mouse_input(p_mi, on): @param on: true to handle mouse click events, false to ignore them. ''' f = _Cfunctions.get('libvlc_video_set_mouse_input', None) or \ - _Cfunction('libvlc_video_set_mouse_input', ((1,), (1,),), + _Cfunction('libvlc_video_set_mouse_input', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_mouse_input @@ -4695,7 +4817,7 @@ def libvlc_video_get_size(p_mi, num): @return: px pixel width, py pixel height. ''' f = _Cfunctions.get('libvlc_video_get_size', None) or \ - _Cfunction('libvlc_video_get_size', ((1,), (1,), (2,), (2,),), + _Cfunction('libvlc_video_get_size', ((1,), (1,), (2,), (2,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint)) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_size @@ -4719,7 +4841,7 @@ def libvlc_video_get_cursor(p_mi, num): @return: px abscissa, py ordinate. ''' f = _Cfunctions.get('libvlc_video_get_cursor', None) or \ - _Cfunction('libvlc_video_get_cursor', ((1,), (1,), (2,), (2,),), + _Cfunction('libvlc_video_get_cursor', ((1,), (1,), (2,), (2,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_int), ctypes.POINTER(ctypes.c_int)) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_cursor @@ -4733,7 +4855,7 @@ def libvlc_video_get_scale(p_mi): @return: the currently configured zoom factor, or 0. if the video is set to fit to the output window/drawable automatically. ''' f = _Cfunctions.get('libvlc_video_get_scale', None) or \ - _Cfunction('libvlc_video_get_scale', ((1,),), + _Cfunction('libvlc_video_get_scale', ((1,),), None, ctypes.c_float, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_scale @@ -4750,7 +4872,7 @@ def libvlc_video_set_scale(p_mi, f_factor): @param f_factor: the scaling factor, or zero. ''' f = _Cfunctions.get('libvlc_video_set_scale', None) or \ - _Cfunction('libvlc_video_set_scale', ((1,), (1,),), + _Cfunction('libvlc_video_set_scale', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_float) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_scale @@ -4763,8 +4885,8 @@ def libvlc_video_get_aspect_ratio(p_mi): @return: the video aspect ratio or NULL if unspecified (the result must be released with free() or L{libvlc_free}()). ''' f = _Cfunctions.get('libvlc_video_get_aspect_ratio', None) or \ - _Cfunction('libvlc_video_get_aspect_ratio', ((1,),), - ctypes.c_char_p, MediaPlayer) + _Cfunction('libvlc_video_get_aspect_ratio', ((1,),), string_result, + ctypes.c_void_p, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_aspect_ratio libvlc_video_get_aspect_ratio = f @@ -4776,7 +4898,7 @@ def libvlc_video_set_aspect_ratio(p_mi, psz_aspect): @param psz_aspect: new video aspect-ratio or NULL to reset to default @note Invalid aspect ratios are ignored. ''' f = _Cfunctions.get('libvlc_video_set_aspect_ratio', None) or \ - _Cfunction('libvlc_video_set_aspect_ratio', ((1,), (1,),), + _Cfunction('libvlc_video_set_aspect_ratio', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_aspect_ratio @@ -4789,7 +4911,7 @@ def libvlc_video_get_spu(p_mi): @return: the video subtitle selected, or -1 if none. ''' f = _Cfunctions.get('libvlc_video_get_spu', None) or \ - _Cfunction('libvlc_video_get_spu', ((1,),), + _Cfunction('libvlc_video_get_spu', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_spu @@ -4802,7 +4924,7 @@ def libvlc_video_get_spu_count(p_mi): @return: the number of available video subtitles. ''' f = _Cfunctions.get('libvlc_video_get_spu_count', None) or \ - _Cfunction('libvlc_video_get_spu_count', ((1,),), + _Cfunction('libvlc_video_get_spu_count', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_spu_count @@ -4815,7 +4937,7 @@ def libvlc_video_get_spu_description(p_mi): @return: list containing description of available video subtitles. ''' f = _Cfunctions.get('libvlc_video_get_spu_description', None) or \ - _Cfunction('libvlc_video_get_spu_description', ((1,),), + _Cfunction('libvlc_video_get_spu_description', ((1,),), None, ctypes.POINTER(TrackDescription), MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_spu_description @@ -4829,7 +4951,7 @@ def libvlc_video_set_spu(p_mi, i_spu): @return: 0 on success, -1 if out of range. ''' f = _Cfunctions.get('libvlc_video_set_spu', None) or \ - _Cfunction('libvlc_video_set_spu', ((1,), (1,),), + _Cfunction('libvlc_video_set_spu', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_spu @@ -4843,7 +4965,7 @@ def libvlc_video_set_subtitle_file(p_mi, psz_subtitle): @return: the success status (boolean). ''' f = _Cfunctions.get('libvlc_video_set_subtitle_file', None) or \ - _Cfunction('libvlc_video_set_subtitle_file', ((1,), (1,),), + _Cfunction('libvlc_video_set_subtitle_file', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_subtitle_file @@ -4856,7 +4978,7 @@ def libvlc_video_get_title_description(p_mi): @return: list containing description of available titles. ''' f = _Cfunctions.get('libvlc_video_get_title_description', None) or \ - _Cfunction('libvlc_video_get_title_description', ((1,),), + _Cfunction('libvlc_video_get_title_description', ((1,),), None, ctypes.POINTER(TrackDescription), MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_title_description @@ -4870,7 +4992,7 @@ def libvlc_video_get_chapter_description(p_mi, i_title): @return: list containing description of available chapter for title i_title. ''' f = _Cfunctions.get('libvlc_video_get_chapter_description', None) or \ - _Cfunction('libvlc_video_get_chapter_description', ((1,), (1,),), + _Cfunction('libvlc_video_get_chapter_description', ((1,), (1,),), None, ctypes.POINTER(TrackDescription), MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_chapter_description @@ -4883,8 +5005,8 @@ def libvlc_video_get_crop_geometry(p_mi): @return: the crop filter geometry or NULL if unset. ''' f = _Cfunctions.get('libvlc_video_get_crop_geometry', None) or \ - _Cfunction('libvlc_video_get_crop_geometry', ((1,),), - ctypes.c_char_p, MediaPlayer) + _Cfunction('libvlc_video_get_crop_geometry', ((1,),), string_result, + ctypes.c_void_p, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_crop_geometry libvlc_video_get_crop_geometry = f @@ -4896,7 +5018,7 @@ def libvlc_video_set_crop_geometry(p_mi, psz_geometry): @param psz_geometry: new crop filter geometry (NULL to unset). ''' f = _Cfunctions.get('libvlc_video_set_crop_geometry', None) or \ - _Cfunction('libvlc_video_set_crop_geometry', ((1,), (1,),), + _Cfunction('libvlc_video_set_crop_geometry', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_crop_geometry @@ -4909,7 +5031,7 @@ def libvlc_video_get_teletext(p_mi): @return: the current teletext page requested. ''' f = _Cfunctions.get('libvlc_video_get_teletext', None) or \ - _Cfunction('libvlc_video_get_teletext', ((1,),), + _Cfunction('libvlc_video_get_teletext', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_teletext @@ -4922,7 +5044,7 @@ def libvlc_video_set_teletext(p_mi, i_page): @param i_page: teletex page number requested. ''' f = _Cfunctions.get('libvlc_video_set_teletext', None) or \ - _Cfunction('libvlc_video_set_teletext', ((1,), (1,),), + _Cfunction('libvlc_video_set_teletext', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_teletext @@ -4934,7 +5056,7 @@ def libvlc_toggle_teletext(p_mi): @param p_mi: the media player. ''' f = _Cfunctions.get('libvlc_toggle_teletext', None) or \ - _Cfunction('libvlc_toggle_teletext', ((1,),), + _Cfunction('libvlc_toggle_teletext', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_toggle_teletext @@ -4947,7 +5069,7 @@ def libvlc_video_get_track_count(p_mi): @return: the number of available video tracks (int). ''' f = _Cfunctions.get('libvlc_video_get_track_count', None) or \ - _Cfunction('libvlc_video_get_track_count', ((1,),), + _Cfunction('libvlc_video_get_track_count', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_track_count @@ -4960,7 +5082,7 @@ def libvlc_video_get_track_description(p_mi): @return: list with description of available video tracks, or NULL on error. ''' f = _Cfunctions.get('libvlc_video_get_track_description', None) or \ - _Cfunction('libvlc_video_get_track_description', ((1,),), + _Cfunction('libvlc_video_get_track_description', ((1,),), None, ctypes.POINTER(TrackDescription), MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_track_description @@ -4973,7 +5095,7 @@ def libvlc_video_get_track(p_mi): @return: the video track (int) or -1 if none. ''' f = _Cfunctions.get('libvlc_video_get_track', None) or \ - _Cfunction('libvlc_video_get_track', ((1,),), + _Cfunction('libvlc_video_get_track', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_track @@ -4987,7 +5109,7 @@ def libvlc_video_set_track(p_mi, i_track): @return: 0 on success, -1 if out of range. ''' f = _Cfunctions.get('libvlc_video_set_track', None) or \ - _Cfunction('libvlc_video_set_track', ((1,), (1,),), + _Cfunction('libvlc_video_set_track', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_track @@ -5006,7 +5128,7 @@ def libvlc_video_take_snapshot(p_mi, num, psz_filepath, i_width, i_height): @return: 0 on success, -1 if the video was not found. ''' f = _Cfunctions.get('libvlc_video_take_snapshot', None) or \ - _Cfunction('libvlc_video_take_snapshot', ((1,), (1,), (1,), (1,), (1,),), + _Cfunction('libvlc_video_take_snapshot', ((1,), (1,), (1,), (1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.c_char_p, ctypes.c_int, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_take_snapshot @@ -5019,7 +5141,7 @@ def libvlc_video_set_deinterlace(p_mi, psz_mode): @param psz_mode: type of deinterlace filter, NULL to disable. ''' f = _Cfunctions.get('libvlc_video_set_deinterlace', None) or \ - _Cfunction('libvlc_video_set_deinterlace', ((1,), (1,),), + _Cfunction('libvlc_video_set_deinterlace', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_deinterlace @@ -5032,7 +5154,7 @@ def libvlc_video_get_marquee_int(p_mi, option): @param option: marq option to get See libvlc_video_marquee_int_option_t. ''' f = _Cfunctions.get('libvlc_video_get_marquee_int', None) or \ - _Cfunction('libvlc_video_get_marquee_int', ((1,), (1,),), + _Cfunction('libvlc_video_get_marquee_int', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_marquee_int @@ -5045,8 +5167,8 @@ def libvlc_video_get_marquee_string(p_mi, option): @param option: marq option to get See libvlc_video_marquee_string_option_t. ''' f = _Cfunctions.get('libvlc_video_get_marquee_string', None) or \ - _Cfunction('libvlc_video_get_marquee_string', ((1,), (1,),), - ctypes.c_char_p, MediaPlayer, ctypes.c_uint) + _Cfunction('libvlc_video_get_marquee_string', ((1,), (1,),), string_result, + ctypes.c_void_p, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_marquee_string libvlc_video_get_marquee_string = f @@ -5061,7 +5183,7 @@ def libvlc_video_set_marquee_int(p_mi, option, i_val): @param i_val: marq option value. ''' f = _Cfunctions.get('libvlc_video_set_marquee_int', None) or \ - _Cfunction('libvlc_video_set_marquee_int', ((1,), (1,), (1,),), + _Cfunction('libvlc_video_set_marquee_int', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_uint, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_marquee_int @@ -5075,7 +5197,7 @@ def libvlc_video_set_marquee_string(p_mi, option, psz_text): @param psz_text: marq option value. ''' f = _Cfunctions.get('libvlc_video_set_marquee_string', None) or \ - _Cfunction('libvlc_video_set_marquee_string', ((1,), (1,), (1,),), + _Cfunction('libvlc_video_set_marquee_string', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_marquee_string @@ -5088,7 +5210,7 @@ def libvlc_video_get_logo_int(p_mi, option): @param option: logo option to get, values of libvlc_video_logo_option_t. ''' f = _Cfunctions.get('libvlc_video_get_logo_int', None) or \ - _Cfunction('libvlc_video_get_logo_int', ((1,), (1,),), + _Cfunction('libvlc_video_get_logo_int', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_logo_int @@ -5105,7 +5227,7 @@ def libvlc_video_set_logo_int(p_mi, option, value): @param value: logo option value. ''' f = _Cfunctions.get('libvlc_video_set_logo_int', None) or \ - _Cfunction('libvlc_video_set_logo_int', ((1,), (1,), (1,),), + _Cfunction('libvlc_video_set_logo_int', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_uint, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_logo_int @@ -5120,7 +5242,7 @@ def libvlc_video_set_logo_string(p_mi, option, psz_value): @param psz_value: logo option value. ''' f = _Cfunctions.get('libvlc_video_set_logo_string', None) or \ - _Cfunction('libvlc_video_set_logo_string', ((1,), (1,), (1,),), + _Cfunction('libvlc_video_set_logo_string', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_logo_string @@ -5134,7 +5256,7 @@ def libvlc_video_get_adjust_int(p_mi, option): @version: LibVLC 1.1.1 and later. ''' f = _Cfunctions.get('libvlc_video_get_adjust_int', None) or \ - _Cfunction('libvlc_video_get_adjust_int', ((1,), (1,),), + _Cfunction('libvlc_video_get_adjust_int', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_adjust_int @@ -5152,7 +5274,7 @@ def libvlc_video_set_adjust_int(p_mi, option, value): @version: LibVLC 1.1.1 and later. ''' f = _Cfunctions.get('libvlc_video_set_adjust_int', None) or \ - _Cfunction('libvlc_video_set_adjust_int', ((1,), (1,), (1,),), + _Cfunction('libvlc_video_set_adjust_int', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_uint, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_adjust_int @@ -5166,7 +5288,7 @@ def libvlc_video_get_adjust_float(p_mi, option): @version: LibVLC 1.1.1 and later. ''' f = _Cfunctions.get('libvlc_video_get_adjust_float', None) or \ - _Cfunction('libvlc_video_get_adjust_float', ((1,), (1,),), + _Cfunction('libvlc_video_get_adjust_float', ((1,), (1,),), None, ctypes.c_float, MediaPlayer, ctypes.c_uint) if not __debug__: # i.e. python -O or -OO global libvlc_video_get_adjust_float @@ -5182,7 +5304,7 @@ def libvlc_video_set_adjust_float(p_mi, option, value): @version: LibVLC 1.1.1 and later. ''' f = _Cfunctions.get('libvlc_video_set_adjust_float', None) or \ - _Cfunction('libvlc_video_set_adjust_float', ((1,), (1,), (1,),), + _Cfunction('libvlc_video_set_adjust_float', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_uint, ctypes.c_float) if not __debug__: # i.e. python -O or -OO global libvlc_video_set_adjust_float @@ -5195,7 +5317,7 @@ def libvlc_audio_output_list_get(p_instance): @return: list of available audio outputs. It must be freed it with In case of error, NULL is returned. ''' f = _Cfunctions.get('libvlc_audio_output_list_get', None) or \ - _Cfunction('libvlc_audio_output_list_get', ((1,),), + _Cfunction('libvlc_audio_output_list_get', ((1,),), None, ctypes.POINTER(AudioOutput), Instance) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_list_get @@ -5207,7 +5329,7 @@ def libvlc_audio_output_list_release(p_list): @param p_list: list with audio outputs for release. ''' f = _Cfunctions.get('libvlc_audio_output_list_release', None) or \ - _Cfunction('libvlc_audio_output_list_release', ((1,),), + _Cfunction('libvlc_audio_output_list_release', ((1,),), None, None, ctypes.POINTER(AudioOutput)) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_list_release @@ -5222,7 +5344,7 @@ def libvlc_audio_output_set(p_mi, psz_name): @return: true if function succeded. ''' f = _Cfunctions.get('libvlc_audio_output_set', None) or \ - _Cfunction('libvlc_audio_output_set', ((1,), (1,),), + _Cfunction('libvlc_audio_output_set', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_set @@ -5237,7 +5359,7 @@ def libvlc_audio_output_device_count(p_instance, psz_audio_output): @return: number of devices. ''' f = _Cfunctions.get('libvlc_audio_output_device_count', None) or \ - _Cfunction('libvlc_audio_output_device_count', ((1,), (1,),), + _Cfunction('libvlc_audio_output_device_count', ((1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_device_count @@ -5252,8 +5374,8 @@ def libvlc_audio_output_device_longname(p_instance, psz_audio_output, i_device): @return: long name of device. ''' f = _Cfunctions.get('libvlc_audio_output_device_longname', None) or \ - _Cfunction('libvlc_audio_output_device_longname', ((1,), (1,), (1,),), - ctypes.c_char_p, Instance, ctypes.c_char_p, ctypes.c_int) + _Cfunction('libvlc_audio_output_device_longname', ((1,), (1,), (1,),), string_result, + ctypes.c_void_p, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_device_longname libvlc_audio_output_device_longname = f @@ -5267,8 +5389,8 @@ def libvlc_audio_output_device_id(p_instance, psz_audio_output, i_device): @return: id name of device, use for setting device, need to be free after use. ''' f = _Cfunctions.get('libvlc_audio_output_device_id', None) or \ - _Cfunction('libvlc_audio_output_device_id', ((1,), (1,), (1,),), - ctypes.c_char_p, Instance, ctypes.c_char_p, ctypes.c_int) + _Cfunction('libvlc_audio_output_device_id', ((1,), (1,), (1,),), string_result, + ctypes.c_void_p, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_device_id libvlc_audio_output_device_id = f @@ -5281,7 +5403,7 @@ def libvlc_audio_output_device_set(p_mi, psz_audio_output, psz_device_id): @param psz_device_id: device. ''' f = _Cfunctions.get('libvlc_audio_output_device_set', None) or \ - _Cfunction('libvlc_audio_output_device_set', ((1,), (1,), (1,),), + _Cfunction('libvlc_audio_output_device_set', ((1,), (1,), (1,),), None, None, MediaPlayer, ctypes.c_char_p, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_device_set @@ -5295,7 +5417,7 @@ def libvlc_audio_output_get_device_type(p_mi): @return: the audio devices type See libvlc_audio_output_device_types_t. ''' f = _Cfunctions.get('libvlc_audio_output_get_device_type', None) or \ - _Cfunction('libvlc_audio_output_get_device_type', ((1,),), + _Cfunction('libvlc_audio_output_get_device_type', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_get_device_type @@ -5308,7 +5430,7 @@ def libvlc_audio_output_set_device_type(p_mi, device_type): @param device_type: the audio device type, ''' f = _Cfunctions.get('libvlc_audio_output_set_device_type', None) or \ - _Cfunction('libvlc_audio_output_set_device_type', ((1,), (1,),), + _Cfunction('libvlc_audio_output_set_device_type', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_output_set_device_type @@ -5320,7 +5442,7 @@ def libvlc_audio_toggle_mute(p_mi): @param p_mi: media player. ''' f = _Cfunctions.get('libvlc_audio_toggle_mute', None) or \ - _Cfunction('libvlc_audio_toggle_mute', ((1,),), + _Cfunction('libvlc_audio_toggle_mute', ((1,),), None, None, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_toggle_mute @@ -5333,7 +5455,7 @@ def libvlc_audio_get_mute(p_mi): @return: the mute status (boolean). ''' f = _Cfunctions.get('libvlc_audio_get_mute', None) or \ - _Cfunction('libvlc_audio_get_mute', ((1,),), + _Cfunction('libvlc_audio_get_mute', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_mute @@ -5346,7 +5468,7 @@ def libvlc_audio_set_mute(p_mi, status): @param status: If status is true then mute, otherwise unmute. ''' f = _Cfunctions.get('libvlc_audio_set_mute', None) or \ - _Cfunction('libvlc_audio_set_mute', ((1,), (1,),), + _Cfunction('libvlc_audio_set_mute', ((1,), (1,),), None, None, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_set_mute @@ -5359,7 +5481,7 @@ def libvlc_audio_get_volume(p_mi): @return: the audio level (int). ''' f = _Cfunctions.get('libvlc_audio_get_volume', None) or \ - _Cfunction('libvlc_audio_get_volume', ((1,),), + _Cfunction('libvlc_audio_get_volume', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_volume @@ -5373,7 +5495,7 @@ def libvlc_audio_set_volume(p_mi, i_volume): @return: 0 if the volume was set, -1 if it was out of range. ''' f = _Cfunctions.get('libvlc_audio_set_volume', None) or \ - _Cfunction('libvlc_audio_set_volume', ((1,), (1,),), + _Cfunction('libvlc_audio_set_volume', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_set_volume @@ -5386,7 +5508,7 @@ def libvlc_audio_get_track_count(p_mi): @return: the number of available audio tracks (int), or -1 if unavailable. ''' f = _Cfunctions.get('libvlc_audio_get_track_count', None) or \ - _Cfunction('libvlc_audio_get_track_count', ((1,),), + _Cfunction('libvlc_audio_get_track_count', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_track_count @@ -5399,7 +5521,7 @@ def libvlc_audio_get_track_description(p_mi): @return: list with description of available audio tracks, or NULL. ''' f = _Cfunctions.get('libvlc_audio_get_track_description', None) or \ - _Cfunction('libvlc_audio_get_track_description', ((1,),), + _Cfunction('libvlc_audio_get_track_description', ((1,),), None, ctypes.POINTER(TrackDescription), MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_track_description @@ -5412,7 +5534,7 @@ def libvlc_audio_get_track(p_mi): @return: the audio track (int), or -1 if none. ''' f = _Cfunctions.get('libvlc_audio_get_track', None) or \ - _Cfunction('libvlc_audio_get_track', ((1,),), + _Cfunction('libvlc_audio_get_track', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_track @@ -5426,7 +5548,7 @@ def libvlc_audio_set_track(p_mi, i_track): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_audio_set_track', None) or \ - _Cfunction('libvlc_audio_set_track', ((1,), (1,),), + _Cfunction('libvlc_audio_set_track', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_set_track @@ -5439,7 +5561,7 @@ def libvlc_audio_get_channel(p_mi): @return: the audio channel See libvlc_audio_output_channel_t. ''' f = _Cfunctions.get('libvlc_audio_get_channel', None) or \ - _Cfunction('libvlc_audio_get_channel', ((1,),), + _Cfunction('libvlc_audio_get_channel', ((1,),), None, ctypes.c_int, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_channel @@ -5453,7 +5575,7 @@ def libvlc_audio_set_channel(p_mi, channel): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_audio_set_channel', None) or \ - _Cfunction('libvlc_audio_set_channel', ((1,), (1,),), + _Cfunction('libvlc_audio_set_channel', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_audio_set_channel @@ -5467,7 +5589,7 @@ def libvlc_audio_get_delay(p_mi): @version: LibVLC 1.1.1 or later. ''' f = _Cfunctions.get('libvlc_audio_get_delay', None) or \ - _Cfunction('libvlc_audio_get_delay', ((1,),), + _Cfunction('libvlc_audio_get_delay', ((1,),), None, ctypes.c_int64, MediaPlayer) if not __debug__: # i.e. python -O or -OO global libvlc_audio_get_delay @@ -5482,7 +5604,7 @@ def libvlc_audio_set_delay(p_mi, i_delay): @version: LibVLC 1.1.1 or later. ''' f = _Cfunctions.get('libvlc_audio_set_delay', None) or \ - _Cfunction('libvlc_audio_set_delay', ((1,), (1,),), + _Cfunction('libvlc_audio_set_delay', ((1,), (1,),), None, ctypes.c_int, MediaPlayer, ctypes.c_int64) if not __debug__: # i.e. python -O or -OO global libvlc_audio_set_delay @@ -5494,7 +5616,7 @@ def libvlc_vlm_release(p_instance): @param p_instance: the instance. ''' f = _Cfunctions.get('libvlc_vlm_release', None) or \ - _Cfunction('libvlc_vlm_release', ((1,),), + _Cfunction('libvlc_vlm_release', ((1,),), None, None, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_release @@ -5514,7 +5636,7 @@ def libvlc_vlm_add_broadcast(p_instance, psz_name, psz_input, psz_output, i_opti @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,),), + _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) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_add_broadcast @@ -5533,7 +5655,7 @@ def libvlc_vlm_add_vod(p_instance, psz_name, psz_input, i_options, ppsz_options, @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,),), + _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) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_add_vod @@ -5547,7 +5669,7 @@ def libvlc_vlm_del_media(p_instance, psz_name): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_del_media', None) or \ - _Cfunction('libvlc_vlm_del_media', ((1,), (1,),), + _Cfunction('libvlc_vlm_del_media', ((1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_del_media @@ -5562,7 +5684,7 @@ def libvlc_vlm_set_enabled(p_instance, psz_name, b_enabled): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_set_enabled', None) or \ - _Cfunction('libvlc_vlm_set_enabled', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_set_enabled', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_set_enabled @@ -5577,7 +5699,7 @@ def libvlc_vlm_set_output(p_instance, psz_name, psz_output): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_set_output', None) or \ - _Cfunction('libvlc_vlm_set_output', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_set_output', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_set_output @@ -5593,7 +5715,7 @@ def libvlc_vlm_set_input(p_instance, psz_name, psz_input): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_set_input', None) or \ - _Cfunction('libvlc_vlm_set_input', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_set_input', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_set_input @@ -5608,7 +5730,7 @@ def libvlc_vlm_add_input(p_instance, psz_name, psz_input): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_add_input', None) or \ - _Cfunction('libvlc_vlm_add_input', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_add_input', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_add_input @@ -5623,7 +5745,7 @@ def libvlc_vlm_set_loop(p_instance, psz_name, b_loop): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_set_loop', None) or \ - _Cfunction('libvlc_vlm_set_loop', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_set_loop', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_set_loop @@ -5638,7 +5760,7 @@ def libvlc_vlm_set_mux(p_instance, psz_name, psz_mux): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_set_mux', None) or \ - _Cfunction('libvlc_vlm_set_mux', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_set_mux', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_set_mux @@ -5659,7 +5781,7 @@ def libvlc_vlm_change_media(p_instance, psz_name, psz_input, psz_output, i_optio @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,),), + _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) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_change_media @@ -5673,7 +5795,7 @@ def libvlc_vlm_play_media(p_instance, psz_name): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_play_media', None) or \ - _Cfunction('libvlc_vlm_play_media', ((1,), (1,),), + _Cfunction('libvlc_vlm_play_media', ((1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_play_media @@ -5687,7 +5809,7 @@ def libvlc_vlm_stop_media(p_instance, psz_name): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_stop_media', None) or \ - _Cfunction('libvlc_vlm_stop_media', ((1,), (1,),), + _Cfunction('libvlc_vlm_stop_media', ((1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_stop_media @@ -5701,7 +5823,7 @@ def libvlc_vlm_pause_media(p_instance, psz_name): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_pause_media', None) or \ - _Cfunction('libvlc_vlm_pause_media', ((1,), (1,),), + _Cfunction('libvlc_vlm_pause_media', ((1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_pause_media @@ -5716,7 +5838,7 @@ def libvlc_vlm_seek_media(p_instance, psz_name, f_percentage): @return: 0 on success, -1 on error. ''' f = _Cfunctions.get('libvlc_vlm_seek_media', None) or \ - _Cfunction('libvlc_vlm_seek_media', ((1,), (1,), (1,),), + _Cfunction('libvlc_vlm_seek_media', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_float) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_seek_media @@ -5737,8 +5859,8 @@ def libvlc_vlm_show_media(p_instance, psz_name): @return: string with information about named media, or NULL on error. ''' f = _Cfunctions.get('libvlc_vlm_show_media', None) or \ - _Cfunction('libvlc_vlm_show_media', ((1,), (1,),), - ctypes.c_char_p, Instance, ctypes.c_char_p) + _Cfunction('libvlc_vlm_show_media', ((1,), (1,),), string_result, + ctypes.c_void_p, Instance, ctypes.c_char_p) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_show_media libvlc_vlm_show_media = f @@ -5752,7 +5874,7 @@ def libvlc_vlm_get_media_instance_position(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_position', ((1,), (1,), (1,),), None, ctypes.c_float, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_position @@ -5767,7 +5889,7 @@ def libvlc_vlm_get_media_instance_time(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_time', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_time @@ -5782,7 +5904,7 @@ def libvlc_vlm_get_media_instance_length(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_length', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_length @@ -5797,7 +5919,7 @@ def libvlc_vlm_get_media_instance_rate(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_rate', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_rate @@ -5813,7 +5935,7 @@ def libvlc_vlm_get_media_instance_title(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_title', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_title @@ -5829,7 +5951,7 @@ def libvlc_vlm_get_media_instance_chapter(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_chapter', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_chapter @@ -5845,7 +5967,7 @@ def libvlc_vlm_get_media_instance_seekable(p_instance, psz_name, i_instance): @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,),), + _Cfunction('libvlc_vlm_get_media_instance_seekable', ((1,), (1,), (1,),), None, ctypes.c_int, Instance, ctypes.c_char_p, ctypes.c_int) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_media_instance_seekable @@ -5859,15 +5981,17 @@ def libvlc_vlm_get_event_manager(p_instance): @return: libvlc_event_manager. ''' f = _Cfunctions.get('libvlc_vlm_get_event_manager', None) or \ - _Cfunction('libvlc_vlm_get_event_manager', ((1,),), - EventManager, Instance) + _Cfunction('libvlc_vlm_get_event_manager', ((1,),), class_result(EventManager), + ctypes.c_void_p, Instance) if not __debug__: # i.e. python -O or -OO global libvlc_vlm_get_event_manager libvlc_vlm_get_event_manager = f return f(p_instance) -# 3 function(s) blacklisted: +# 5 function(s) blacklisted: +# libvlc_audio_set_callbacks +# libvlc_audio_set_format_callbacks # libvlc_set_exit_handler # libvlc_video_set_callbacks # libvlc_video_set_format_callbacks @@ -5875,6 +5999,7 @@ def libvlc_vlm_get_event_manager(p_instance): # 12 function(s) not wrapped as methods: # libvlc_audio_output_list_release # libvlc_clearerr +# libvlc_clock # libvlc_errmsg # libvlc_event_type_name # libvlc_free @@ -5883,7 +6008,6 @@ def libvlc_vlm_get_event_manager(p_instance): # libvlc_get_version # libvlc_module_description_list_release # libvlc_new -# libvlc_new_with_builtins # libvlc_track_description_release # Start of footer.py # @@ -5893,6 +6017,27 @@ def callbackmethod(callback): """Now obsolete @callbackmethod decorator.""" return callback +# libvlc_free is not present in some versions of libvlc. If it is not +# in the library, then emulate it by calling libc.free +if not hasattr(dll, 'libvlc_free'): + # need to find the free function in the C runtime. This is + # platform specific. + # For Linux and MacOSX + libc_path = find_library('c') + if libc_path: + libc = ctypes.CDLL(libc_path) + libvlc_free = libc.free + else: + # On win32, it is impossible to guess the proper lib to call + # (msvcrt, mingw...). Just ignore the call: it will memleak, + # but not prevent to run the application. + def libvlc_free(p): + pass + + # ensure argtypes is right, because default type of int won't work + # on 64-bit systems + libvlc_free.argtypes = [ ctypes.c_void_p ] + # Version functions def _dot2int(v): '''(INTERNAL) Convert 'i.i.i[.i]' str to int. diff --git a/openlp/plugins/media/lib/vlccontroller.py b/openlp/plugins/media/lib/vlcapi.py similarity index 85% rename from openlp/plugins/media/lib/vlccontroller.py rename to openlp/plugins/media/lib/vlcapi.py index b1c267858..5d1ee272f 100644 --- a/openlp/plugins/media/lib/vlccontroller.py +++ b/openlp/plugins/media/lib/vlcapi.py @@ -26,7 +26,7 @@ ############################################################################### import logging -import sys +import sys, os from datetime import datetime try: import vlc @@ -34,17 +34,17 @@ except: pass from PyQt4 import QtCore, QtGui from openlp.core.lib import Receiver -from openlp.plugins.media.lib import MediaController, MediaState +from openlp.plugins.media.lib import MediaAPI, MediaState log = logging.getLogger(__name__) -class VlcController(MediaController): +class VlcAPI(MediaAPI): """ - Specialiced MediaController class - to reflect Features of the Vlc backend + Specialiced MediaAPI class + to reflect Features of the Vlc API """ def __init__(self, parent): - MediaController.__init__(self, parent) + MediaAPI.__init__(self, parent) self.parent = parent self.video_extensions_list = [ u'*.3gp' @@ -70,10 +70,13 @@ class VlcController(MediaController): , u'*.iso' ] - def setup(self, display, hasAudio): + def setup_controls(self, controller, control_panel): + pass + + def setup(self, display): display.vlcWidget = QtGui.QFrame(display) # creating a basic vlc instance - if hasAudio: + if display.hasAudio: display.vlcInstance = vlc.Instance() else: display.vlcInstance = vlc.Instance('--no-audio') @@ -121,26 +124,28 @@ class VlcController(MediaController): u'video/x-wmv': [u'.wmv'], u'video/x-ms-wmv': [u'.wmv']} - def load(self, display, path, volume, isBackground): + def load(self, display): log.debug(u'load vid in Vlc Controller') - vol = float(volume) / float(10) + controller = display.parent + volume = controller.media_info.volume + file_path = str( + controller.media_info.file_info.absoluteFilePath().toUtf8()) + path = os.path.normcase(file_path) # create the media - display.vlcMedia = display.vlcInstance.media_new_path(unicode(path)) + display.vlcMedia = display.vlcInstance.media_new_path(path) # put the media in the media player display.vlcMediaPlayer.set_media(display.vlcMedia) # parse the metadata of the file display.vlcMedia.parse() - if not self.mediaStateWait(display): - return False return True - def mediaStateWait(self, display): + def mediaStateWait(self, display, mediaState): """ Wait for the video to change its state Wait no longer than 5 seconds. """ start = datetime.now() - while not display.vlcMedia.is_parsed(): + while not mediaState == display.vlcMedia.get_state(): if display.vlcMedia.get_state() == vlc.State.Error: return False Receiver.send_message(u'openlp_process_events') @@ -148,24 +153,26 @@ class VlcController(MediaController): return False return True - def resize(self, display, controller): + def resize(self, display): display.vlcWidget.resize(display.size()) def play(self, display): self.set_visible(display, True) display.vlcMediaPlayer.play() - self.state = MediaState.Playing + if self.mediaStateWait(display, vlc.State.Playing): + self.state = MediaState.Playing def pause(self, display): display.vlcMediaPlayer.pause() - self.state = MediaState.Paused + if self.mediaStateWait(display, vlc.State.Paused): + self.state = MediaState.Paused def stop(self, display): display.vlcMediaPlayer.stop() self.state = MediaState.Stopped def volume(self, display, vol): - pass + display.vlcMediaPlayer.audio_set_volume(vol) def seek(self, display, seekVal): if display.vlcMediaPlayer.is_seekable(): @@ -180,7 +187,8 @@ class VlcController(MediaController): if self.hasOwnWidget: display.vlcWidget.setVisible(status) - def update_ui(self, controller, display): + def update_ui(self, display): + controller = display.parent controller.seekSlider.setMaximum(1000) if not controller.seekSlider.isSliderDown(): currentPos = display.vlcMediaPlayer.get_position() * 1000 diff --git a/openlp/plugins/media/lib/webkitcontroller.py b/openlp/plugins/media/lib/webkitapi.py similarity index 66% rename from openlp/plugins/media/lib/webkitcontroller.py rename to openlp/plugins/media/lib/webkitapi.py index 41f94ad36..f6e429418 100644 --- a/openlp/plugins/media/lib/webkitcontroller.py +++ b/openlp/plugins/media/lib/webkitapi.py @@ -28,20 +28,21 @@ import logging from PyQt4 import QtCore, QtGui, QtWebKit -from openlp.plugins.media.lib import MediaController, MediaState + +from openlp.core.lib import OpenLPToolbar, translate +from openlp.plugins.media.lib import MediaAPI, MediaState log = logging.getLogger(__name__) -class WebkitController(MediaController): +class WebkitAPI(MediaAPI): """ - Specialiced MediaController class - to reflect Features of the QtWebkit backend + Specialiced MediaAPI class + to reflect Features of the QtWebkit API """ def __init__(self, parent): - MediaController.__init__(self, parent) + MediaAPI.__init__(self, parent) self.parent = parent - self.isFlash = False self.canBackground = True self.video_extensions_list = [ u'*.3gp' @@ -68,7 +69,11 @@ class WebkitController(MediaController): , u'*.swf', u'*.mpg', u'*.wmv', u'*.mpeg', u'*.avi' ] - def setup(self, display, hasAudio): + def setup_controls(self, controller, control_panel): + # no special controls + pass + + def setup(self, display): display.webView.raise_() self.hasOwnWidget = False @@ -79,68 +84,83 @@ class WebkitController(MediaController): def get_supported_file_types(self): pass - def load(self, display, path, volume, isBackground): + def load(self, display): log.debug(u'load vid in Webkit Controller') - vol = float(volume) / float(10) - if isBackground: + controller = display.parent + volume = controller.media_info.volume + vol = float(volume) / float(100) + path = controller.media_info.file_info.absoluteFilePath() + if controller.media_info.is_background: loop = u'true' else: loop = u'false' display.webView.setVisible(True) - if path.endswith(u'.swf'): + if controller.media_info.file_info.suffix() == u'swf': + controller.media_info.isFlash = True js = u'show_flash("load","%s");' % \ (path.replace(u'\\', u'\\\\')) - self.isFlash = True else: js = u'show_video("init", "%s", %s, %s);' % \ (path.replace(u'\\', u'\\\\'), str(vol), loop) - self.isFlash = False display.frame.evaluateJavaScript(js) return True - def resize(self, display, controller): + def resize(self, display): + controller = display.parent if display == controller.previewDisplay: display.webView.resize(display.size()) def play(self, display): - display.override[u'theme'] = u'' - display.override[u'video'] = True + controller = display.parent + #display.override[u'theme'] = u'' + #display.override[u'video'] = True display.webLoaded = True self.set_visible(display, True) - if self.isFlash: - display.frame.evaluateJavaScript(u'show_flash("play","");') + if controller.media_info.isFlash: + display.frame.evaluateJavaScript(u'show_flash("play");') else: display.frame.evaluateJavaScript(u'show_video("play");') self.state = MediaState.Playing def pause(self, display): - if self.isFlash: - display.frame.evaluateJavaScript(u'show_flash("pause","");') + controller = display.parent + if controller.media_info.isFlash: + display.frame.evaluateJavaScript(u'show_flash("pause");') else: display.frame.evaluateJavaScript(u'show_video("pause");') self.state = MediaState.Paused def stop(self, display): - if self.isFlash: - display.frame.evaluateJavaScript(u'show_flash("stop","");') + controller = display.parent + if controller.media_info.isFlash: + display.frame.evaluateJavaScript(u'show_flash("stop");') else: display.frame.evaluateJavaScript(u'show_video("stop");') self.state = MediaState.Stopped def volume(self, display, vol): - if not self.isFlash: + controller = display.parent + # 1.0 is the highest value + vol = float(vol) / float(100) + if not controller.media_info.isFlash: display.frame.evaluateJavaScript(u'show_video(null, null, %s);' % str(vol)) def seek(self, display, seekVal): - if not self.isFlash: + controller = display.parent + if controller.media_info.isFlash: + seek = seekVal + display.frame.evaluateJavaScript( \ + u'show_flash("seek", null, null, "%s");' % (seek)) + else: seek = float(seekVal)/1000 display.frame.evaluateJavaScript( \ u'show_video("seek", null, null, null, "%f");' % (seek)) def reset(self, display): - if self.isFlash: - display.frame.evaluateJavaScript(u'show_flash("close","");') + controller = display.parent + if controller.media_info.isFlash: + display.frame.evaluateJavaScript(u'show_flash("close");') else: display.frame.evaluateJavaScript(u'show_video("close");') self.state = MediaState.Off @@ -149,16 +169,26 @@ class WebkitController(MediaController): if self.hasOwnWidget: display.webView.setVisible(status) - def update_ui(self, controller, display): - if not self.isFlash: + def update_ui(self, display): + controller = display.parent + if controller.media_info.isFlash: currentTime = display.frame.evaluateJavaScript( \ - u'show_video("currentTime");') - length = display.frame.evaluateJavaScript(u'show_video("length");') - if int(currentTime.toFloat()[0]*1000) > 0: - controller.seekSlider.setMaximum(int(length.toFloat()[0]*1000)) - if not controller.seekSlider.isSliderDown(): - controller.seekSlider.setSliderPosition( \ - int(currentTime.toFloat()[0]*1000)) + u'show_flash("currentTime");').toInt()[0] + length = display.frame.evaluateJavaScript( \ + u'show_flash("length");').toInt()[0] + else: + (currentTime, ok) = display.frame.evaluateJavaScript( \ + u'show_video("currentTime");').toFloat() + if ok: + currentTime = int(currentTime*1000) + (length, ok) = display.frame.evaluateJavaScript( \ + u'show_video("length");').toFloat() + if ok: + length = int(length*1000) + if currentTime > 0: + controller.seekSlider.setMaximum(length) + if not controller.seekSlider.isSliderDown(): + controller.seekSlider.setSliderPosition(currentTime) def get_supported_file_types(self): pass diff --git a/openlp/plugins/media/mediaplugin.py b/openlp/plugins/media/mediaplugin.py index 38aaedd70..2d495955d 100644 --- a/openlp/plugins/media/mediaplugin.py +++ b/openlp/plugins/media/mediaplugin.py @@ -53,6 +53,9 @@ class MediaPlugin(Plugin): '
The media plugin provides playback of audio and video.') return about_text + def addControllerItems(self, controller, control_panel): + self.mediaManager.addControllerItems(controller, control_panel) + def setPluginTextStrings(self): """ Called to define all translatable texts of the plugin From cd1bf815d1edc63b8c5f1b493f624faccc7daba7 Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Mon, 6 Jun 2011 21:19:35 +0200 Subject: [PATCH 10/41] corrections --- openlp/core/lib/renderer.py | 4 +- openlp/plugins/media/lib/vlcapi.py | 105 ++++++++++++++++++++++++++++- 2 files changed, 106 insertions(+), 3 deletions(-) diff --git a/openlp/core/lib/renderer.py b/openlp/core/lib/renderer.py index c6e729be8..c45671987 100644 --- a/openlp/core/lib/renderer.py +++ b/openlp/core/lib/renderer.py @@ -77,7 +77,7 @@ class Renderer(object): self.theme_data = None self.bg_frame = None self.force_page = False - self.display = MainDisplay(None, self.image_manager, False) + self.display = MainDisplay(None, None, self.image_manager, False) self.display.setup() def update_display(self): @@ -86,7 +86,7 @@ class Renderer(object): """ log.debug(u'Update Display') self._calculate_default(self.screens.current[u'size']) - self.display = MainDisplay(None, self.image_manager, False) + self.display = MainDisplay(None, None, self.image_manager, False) self.display.setup() self.bg_frame = None self.theme_data = None diff --git a/openlp/plugins/media/lib/vlcapi.py b/openlp/plugins/media/lib/vlcapi.py index f6f84fe0d..7531ba394 100644 --- a/openlp/plugins/media/lib/vlcapi.py +++ b/openlp/plugins/media/lib/vlcapi.py @@ -92,4 +92,107 @@ class VlcAPI(MediaAPI): # you have to give the id of the QFrame (or similar object) to # vlc, different platforms have different functions for this if sys.platform == "linux2": # for Linux using the X Server - display.vlcMediaPlayer.ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ \ No newline at end of file + display.vlcMediaPlayer.set_xwindow(int(display.vlcWidget.winId())) + elif sys.platform == "win32": # for Windows + display.vlcMediaPlayer.set_hwnd(int(display.vlcWidget.winId())) + elif sys.platform == "darwin": # for MacOS + display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) + self.hasOwnWidget = True + + @staticmethod + def is_available(): + try: + import vlc + return True + except: + return False + + def get_supported_file_types(self): + self.supported_file_types = ['avi'] + self.additional_extensions = { + u'audio/ac3': [u'.ac3'], + u'audio/flac': [u'.flac'], + u'audio/x-m4a': [u'.m4a'], + u'audio/midi': [u'.mid', u'.midi'], + u'audio/x-mp3': [u'.mp3'], + u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], + u'audio/qcelp': [u'.qcp'], + u'audio/x-wma': [u'.wma'], + u'audio/x-ms-wma': [u'.wma'], + u'video/x-flv': [u'.flv'], + u'video/x-matroska': [u'.mpv', u'.mkv'], + u'video/x-wmv': [u'.wmv'], + u'video/x-ms-wmv': [u'.wmv']} + + def load(self, display): + log.debug(u'load vid in Vlc Controller') + controller = display.controller + volume = controller.media_info.volume + file_path = str( + controller.media_info.file_info.absoluteFilePath().toUtf8()) + path = os.path.normcase(file_path) + # create the media + display.vlcMedia = display.vlcInstance.media_new_path(path) + # put the media in the media player + display.vlcMediaPlayer.set_media(display.vlcMedia) + # parse the metadata of the file + display.vlcMedia.parse() + return True + + def mediaStateWait(self, display, mediaState): + """ + Wait for the video to change its state + Wait no longer than 5 seconds. + """ + start = datetime.now() + while not mediaState == display.vlcMedia.get_state(): + if display.vlcMedia.get_state() == vlc.State.Error: + return False + Receiver.send_message(u'openlp_process_events') + if (datetime.now() - start).seconds > 5: + return False + return True + + def resize(self, display): + display.vlcWidget.resize(display.size()) + + def play(self, display): + self.set_visible(display, True) + display.vlcMediaPlayer.play() + if self.mediaStateWait(display, vlc.State.Playing): + self.state = MediaState.Playing + + def pause(self, display): + display.vlcMediaPlayer.pause() + if self.mediaStateWait(display, vlc.State.Paused): + self.state = MediaState.Paused + + def stop(self, display): + display.vlcMediaPlayer.stop() + self.state = MediaState.Stopped + + def volume(self, display, vol): + display.vlcMediaPlayer.audio_set_volume(vol) + + def seek(self, display, seekVal): + if display.vlcMediaPlayer.is_seekable(): + display.vlcMediaPlayer.set_position(seekVal/1000.0) + + def reset(self, display): + display.vlcMediaPlayer.stop() + display.vlcWidget.setVisible(False) + self.state = MediaState.Off + + def set_visible(self, display, status): + if self.hasOwnWidget: + display.vlcWidget.setVisible(status) + + def update_ui(self, display): + controller = display.controller + controller.seekSlider.setMaximum(1000) + if not controller.seekSlider.isSliderDown(): + currentPos = display.vlcMediaPlayer.get_position() * 1000 + controller.seekSlider.setSliderPosition(currentPos) + + def get_supported_file_types(self): + pass From 805821b13cd913074b0bbfff5313a61ac193d868 Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Mon, 6 Jun 2011 21:39:16 +0200 Subject: [PATCH 11/41] initiation --- openlp/plugins/media/lib/mediamanager.py | 6 +- openlp/plugins/media/lib/vlc.py | 6251 ---------------------- openlp/plugins/media/lib/vlcapi.py | 198 - 3 files changed, 3 insertions(+), 6452 deletions(-) delete mode 100644 openlp/plugins/media/lib/vlc.py delete mode 100644 openlp/plugins/media/lib/vlcapi.py diff --git a/openlp/plugins/media/lib/mediamanager.py b/openlp/plugins/media/lib/mediamanager.py index 1e9a4c123..ab2da24a0 100644 --- a/openlp/plugins/media/lib/mediamanager.py +++ b/openlp/plugins/media/lib/mediamanager.py @@ -35,7 +35,7 @@ from openlp.core.lib.ui import UiStrings, critical_error_message_box from openlp.plugins.media.lib import MediaAPI, MediaState, MediaInfo from webkitapi import WebkitAPI from phononapi import PhononAPI -from vlcapi import VlcAPI +#from vlcapi import VlcAPI log = logging.getLogger(__name__) @@ -68,8 +68,8 @@ class MediaManager(object): self.APIs[u'Webkit'] = WebkitAPI(self) if PhononAPI.is_available(): self.APIs[u'Phonon'] = PhononAPI(self) - if VlcAPI.is_available(): - self.APIs[u'Vlc'] = VlcAPI(self) +# if VlcAPI.is_available(): +# self.APIs[u'Vlc'] = VlcAPI(self) #Timer for video state self.Timer = QtCore.QTimer() self.Timer.setInterval(200) diff --git a/openlp/plugins/media/lib/vlc.py b/openlp/plugins/media/lib/vlc.py deleted file mode 100644 index 1b6510993..000000000 --- a/openlp/plugins/media/lib/vlc.py +++ /dev/null @@ -1,6251 +0,0 @@ -#! /usr/bin/python - -# Python ctypes bindings for VLC -# -# Copyright (C) 2009-2010 the VideoLAN team -# $Id: $ -# -# Authors: Olivier Aubert -# Jean Brouwers -# -# 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. - -"""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.advene.org/download/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 - -# Used by EventManager in override.py -from inspect import getargspec - -__version__ = "N/A" -build_date = "Wed May 18 15:32:47 2011" - - # Used on win32 and MacOS in override.py -plugin_path = None - -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'): - p = find_library('libvlc.dll') - if p is None: - try: # some registry settings - import _winreg as w # leaner than win32api, win32con - 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 - del r, w - except ImportError: # no PyWin32 - pass - if plugin_path is None: - # try some standard locations. - for p in ('Program Files\\VideoLan\\', 'VideoLan\\', - 'Program Files\\', ''): - p = 'C:\\' + p + 'VLC\\libvlc.dll' - 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('libvlc.dll') - # restore cwd after dll has been loaded - os.chdir(p) - else: # may fail - dll = ctypes.CDLL('libvlc.dll') - else: - plugin_path = os.path.dirname(p) - dll = ctypes.CDLL(p) - del p#, u - -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) - d += 'modules' - if os.path.isdir(d): - plugin_path = d - else: # hope, some PATH is set... - dll = ctypes.CDLL('libvlc.dylib') - del d, p - -else: - raise NotImplementedError('%s: %s not supported' % (sys.argv[0], sys.platform)) - -class VLCException(Exception): - """Exception raised by libvlc methods. - """ - pass - -try: - _Ints = (int, long) -except NameError: # no long in Python 3+ - _Ints = int - -# 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 - -_Seqs = (list, tuple) - -_Cfunctions = {} # from LibVLC __version__ - -def _Cfunction(name, flags, errcheck, *types): - """(INTERNAL) New ctypes function binding. - """ - if hasattr(dll, name): - p = ctypes.CFUNCTYPE(*types) - f = p((name, dll), flags) - if errcheck is not None: - f.errcheck = errcheck - _Cfunctions[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=None): - """(INTERNAL) New wrapper from ctypes. - """ - if ptr is None: - raise VLCException('(INTERNAL) ctypes class.') - if ptr == 0: - return None - return _Cobject(cls, ctypes.c_void_p(ptr)) - -class _Ctype(object): - """(INTERNAL) Base class for ctypes. - """ - @staticmethod - def from_param(this): # not self - """(INTERNAL) ctypes parameter conversion method. - """ - 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) - -# 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 = 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): - return classname(result) - return wrap_errcheck - - # Generated enum types # - -class _Enum(ctypes.c_ulong): - '''(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 __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 EventType(_Enum): - '''Event types. - ''' - _enum_names_ = { - 0: 'MediaMetaChanged', - 1: 'MediaSubItemAdded', - 2: 'MediaDurationChanged', - 3: 'MediaParsedChanged', - 4: 'MediaFreed', - 5: 'MediaStateChanged', - 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', - 0x200: 'MediaListItemAdded', - 513: 'MediaListWillAddItem', - 514: 'MediaListItemDeleted', - 515: 'MediaListWillDeleteItem', - 0x300: 'MediaListViewItemAdded', - 769: 'MediaListViewWillAddItem', - 770: 'MediaListViewItemDeleted', - 771: 'MediaListViewWillDeleteItem', - 0x400: 'MediaListPlayerPlayed', - 1025: 'MediaListPlayerNextItemSet', - 1026: 'MediaListPlayerStopped', - 0x500: 'MediaDiscovererStarted', - 1281: 'MediaDiscovererEnded', - 0x600: 'VlmMediaAdded', - 1537: 'VlmMediaRemoved', - 1538: 'VlmMediaChanged', - 1539: 'VlmMediaInstanceStarted', - 1540: 'VlmMediaInstanceStopped', - 1541: 'VlmMediaInstanceStatusInit', - 1542: 'VlmMediaInstanceStatusOpening', - 1543: 'VlmMediaInstanceStatusPlaying', - 1544: 'VlmMediaInstanceStatusPause', - 1545: 'VlmMediaInstanceStatusEnd', - 1546: 'VlmMediaInstanceStatusError', - } -EventType.MediaDiscovererEnded = EventType(1281) -EventType.MediaDiscovererStarted = EventType(0x500) -EventType.MediaDurationChanged = EventType(2) -EventType.MediaFreed = EventType(4) -EventType.MediaListItemAdded = EventType(0x200) -EventType.MediaListItemDeleted = EventType(514) -EventType.MediaListPlayerNextItemSet = EventType(1025) -EventType.MediaListPlayerPlayed = EventType(0x400) -EventType.MediaListPlayerStopped = EventType(1026) -EventType.MediaListViewItemAdded = EventType(0x300) -EventType.MediaListViewItemDeleted = EventType(770) -EventType.MediaListViewWillAddItem = EventType(769) -EventType.MediaListViewWillDeleteItem = EventType(771) -EventType.MediaListWillAddItem = EventType(513) -EventType.MediaListWillDeleteItem = EventType(515) -EventType.MediaMetaChanged = EventType(0) -EventType.MediaParsedChanged = EventType(3) -EventType.MediaPlayerBackward = EventType(264) -EventType.MediaPlayerBuffering = EventType(259) -EventType.MediaPlayerEncounteredError = EventType(266) -EventType.MediaPlayerEndReached = EventType(265) -EventType.MediaPlayerForward = EventType(263) -EventType.MediaPlayerLengthChanged = EventType(273) -EventType.MediaPlayerMediaChanged = EventType(0x100) -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.MediaPlayerSeekableChanged = EventType(269) -EventType.MediaPlayerSnapshotTaken = EventType(272) -EventType.MediaPlayerStopped = EventType(262) -EventType.MediaPlayerTimeChanged = EventType(267) -EventType.MediaPlayerTitleChanged = EventType(271) -EventType.MediaStateChanged = EventType(5) -EventType.MediaSubItemAdded = EventType(1) -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', - } -Meta.Album = Meta(4) -Meta.Artist = Meta(1) -Meta.ArtworkURL = Meta(15) -Meta.Copyright = Meta(3) -Meta.Date = Meta(8) -Meta.Description = Meta(6) -Meta.EncodedBy = Meta(14) -Meta.Genre = Meta(2) -Meta.Language = Meta(11) -Meta.NowPlaying = Meta(12) -Meta.Publisher = Meta(13) -Meta.Rating = Meta(7) -Meta.Setting = Meta(9) -Meta.Title = Meta(0) -Meta.TrackID = Meta(16) -Meta.TrackNumber = Meta(5) -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, buffering=2, playing=3, paused=4, -stopping=5, ended=6, error=7. - ''' - _enum_names_ = { - 0: 'NothingSpecial', - 1: 'Opening', - 2: 'Buffering', - 3: 'Playing', - 4: 'Paused', - 5: 'Stopped', - 6: 'Ended', - 7: 'Error', - } -State.Buffering = State(2) -State.Ended = State(6) -State.Error = State(7) -State.NothingSpecial = State(0) -State.Opening = State(1) -State.Paused = State(4) -State.Playing = State(3) -State.Stopped = State(5) - -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 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 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', - } -NavigateMode.activate = NavigateMode(0) -NavigateMode.down = NavigateMode(2) -NavigateMode.left = NavigateMode(3) -NavigateMode.right = NavigateMode(4) -NavigateMode.up = NavigateMode(1) - -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) - - # End of generated enum types # - - # From libvlc_structures.h - -class AudioOutput(ctypes.Structure): - - def __str__(self): - return '%s(%s:%s)' % (self.__class__.__name__, self.name, self.description) - - def __repr__(self): - return '%s.%s' % (self.__class__.__module__, self.__str__()) - -AudioOutput._fields_ = [ # recursive struct - ('name', ctypes.c_char_p), - ('description', ctypes.c_char_p), - ('next', ctypes.POINTER(AudioOutput)), - ] - -class LogMessage(ctypes.Structure): - _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) - - def __repr__(self): - return '%s.%s' % (self.__class__.__module__, self.__str__()) - -class MediaEvent(ctypes.Structure): - _fields_ = [ - ('media_name', ctypes.c_char_p), - ('instance_name', ctypes.c_char_p), - ] - -class MediaStats(ctypes.Structure): - _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), - ] - - def __str__(self): - l = [' %s:\t%s' % (n, getattr(self, n)) for n, t in self._fields_] - return '\n'.join([self.__class__.__name__] + l) - - def __repr__(self): - return '%s.%s' % (self.__class__.__module__, self.__str__()) - -class MediaTrackInfo(ctypes.Structure): - _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 ), - ] - - def __str__(self): - l = [" %s:\t%s" % (n, getattr(self, n)) for n, t in self._fields_] - return "\n".join([self.__class__.__name__] + l) - - def __repr__(self): - return '%s.%s' % (self.__class__.__module__, self.__str__()) - -class PlaylistItem(ctypes.Structure): - _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) - - def __repr__(self): - return '%s.%s' % (self.__class__.__module__, self.__str__()) - -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(ctypes.Structure): - _fields_ = [ - ('top', ctypes.c_int), - ('left', ctypes.c_int), - ('bottom', ctypes.c_int), - ('right', ctypes.c_int), - ] - -class TrackDescription(ctypes.Structure): - - def __str__(self): - return '%s(%d:%s)' % (self.__class__.__name__, self.id, self.name) - - def __repr__(self): - return '%s.%s' % (self.__class__.__module__, self.__str__()) - -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 - libvlc_track_description_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 ), - # Media instance - ('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), - # FIXME: Skipped MediaList and MediaListView... - ('filename', ctypes.c_char_p ), - ('new_length', ctypes.c_longlong), - ('media_event', MediaEvent ), - ] - -class Event(ctypes.Structure): - _fields_ = [ - ('type', EventType ), - ('object', ctypes.c_void_p), - ('u', EventUnion ), - ] - -class ModuleDescription(ctypes.Structure): - 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 - - # 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=None): - if ptr is None: - raise VLCException("(INTERNAL) ctypes class.") - if ptr == 0: - return None - 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 args: - i = args[0] - if i == 0: - return None - if isinstance(i, _Ints): - return _Constructor(cls, i) - if len(args) == 1: - if isinstance(i, basestring): - args = i.strip().split() - elif isinstance(i, _Seqs): - args = i - else: - raise VLCException('Instance %r' % (args,)) - - if not args and plugin_path is not None: - # no parameters passed, for win32 and MacOS, - # specify the plugin_path if detected earlier - args = ['vlc', '--plugin-path=' + plugin_path] - 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. - - Options can be specified as supplementary string parameters, e.g. - - C{m = i.media_new('foo.avi', 'sub-filter=marq{marquee=Hello}', 'vout-filter=invert')} - - Alternatively, the options can be added to the media using the Media.add_options method: - - C{m.add_options('foo.avi', 'sub-filter=marq@test{marquee=Hello}', 'video-filter=invert')} - - @param options: optional media option=value strings - """ - m = libvlc_media_new_location(self, mrl) - for o in options: - libvlc_media_add_option(m, 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 module_description_list_get(self, capability ): - """Returns a list of modules matching a capability. - - """ - return module_description_list(libvlc_module_description_list_get(self, capability)) - - def audio_filter_list_get(self): - """Returns a list of audio filters that are available. - - """ - return module_description_list(libvlc_audio_filter_list_get(self)) - - def video_filter_list_get(self): - """Returns a list of video filters that are available. - - """ - 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 NULL for default. - @return: 0 on success, -1 on error. - ''' - return libvlc_add_intf(self, 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 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, name, http) - - def get_log_verbosity(self): - '''Return the VLC messaging verbosity level. - @return: verbosity level for messages. - ''' - return libvlc_get_log_verbosity(self) - - def set_log_verbosity(self, level): - '''Set the VLC messaging verbosity level. - @param level: log level. - ''' - return libvlc_set_log_verbosity(self, level) - - def log_open(self): - '''Open a VLC message log instance. - @return: log message instance or NULL on error. - ''' - return libvlc_log_open(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 NULL on error. - ''' - return libvlc_media_new_location(self, 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 NULL on error. - ''' - return libvlc_media_new_path(self, 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 NULL on error. - @version: LibVLC 1.1.5 and later. - ''' - return libvlc_media_new_fd(self, fd) - - 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 NULL on error. - ''' - return libvlc_media_new_as_node(self, psz_name) - - def media_discoverer_new_from_name(self, psz_name): - '''Discover media service by name. - @param psz_name: service name. - @return: media discover object or NULL in case of error. - ''' - return libvlc_media_discoverer_new_from_name(self, psz_name) - - def media_library_new(self): - '''Create an new Media Library object. - @return: a new object or NULL on error. - ''' - return libvlc_media_library_new(self) - - def audio_output_list_get(self): - '''Get the list of available audio outputs. - @return: list of available audio outputs. It must be freed it with In case of error, NULL is returned. - ''' - return libvlc_audio_output_list_get(self) - - def audio_output_device_count(self, psz_audio_output): - '''Get count of devices for audio output, these devices are hardware oriented - like analor or digital output of sound card. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @return: number of devices. - ''' - return libvlc_audio_output_device_count(self, psz_audio_output) - - def audio_output_device_longname(self, psz_audio_output, i_device): - '''Get long name of device, if not available short name given. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @param i_device: device index. - @return: long name of device. - ''' - return libvlc_audio_output_device_longname(self, psz_audio_output, i_device) - - def audio_output_device_id(self, psz_audio_output, i_device): - '''Get id name of device. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @param i_device: device index. - @return: id name of device, use for setting device, need to be free after use. - ''' - return libvlc_audio_output_device_id(self, psz_audio_output, i_device) - - 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, psz_name, psz_input, 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, psz_name, psz_input, i_options, ppsz_options, b_enabled, 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, 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, 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, psz_name, 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, psz_name, 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, psz_name, 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, 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, psz_name, 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, psz_name, psz_input, 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, 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, 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, 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, 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 NULL on error. - ''' - return libvlc_vlm_show_media(self, 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, 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, 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, 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, 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, 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, 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, psz_name, i_instance) - - 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) - -class Log(_Ctype): - '''Create a new VLC log instance. - - ''' - - def __new__(cls, ptr=None): - '''(INTERNAL) ctypes wrapper constructor. - ''' - return _Constructor(cls, ptr) - - def __iter__(self): - return self.get_iterator() - - def dump(self): - return [ str(m) for m in self ] - - - def close(self): - '''Close a VLC message log instance. - ''' - return libvlc_log_close(self) - - def count(self): - '''Returns the number of messages in a log instance. - @return: number of log messages, 0 if p_log is NULL. - ''' - return libvlc_log_count(self) - - def __len__(self): - return libvlc_log_count(self) - - def clear(self): - '''Clear a log instance. - All messages in the log are removed. The log should be cleared on a - regular basis to avoid clogging. - ''' - return libvlc_log_clear(self) - - def get_iterator(self): - '''Allocate and returns a new iterator to messages in log. - @return: log iterator object or NULL on error. - ''' - return libvlc_log_get_iterator(self) - -class LogIterator(_Ctype): - '''Create a new VLC log iterator. - - ''' - - def __new__(cls, ptr=None): - '''(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 free(self): - '''Release a previoulsy allocated iterator. - ''' - return libvlc_log_iterator_free(self) - - def has_next(self): - '''Return whether log iterator has more messages. - @return: true if iterator has more message objects, else false. - ''' - 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 i == 0: - return None - 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, e.g.: - - C{m.add_options('sub-filter=marq@test{marquee=Hello}', 'video-filter=invert')} - - Alternatively, the options can directly be passed in the Instance.media_new method: - - C{m = instance.media_new('foo.avi', 'sub-filter=marq@test{marquee=Hello}', 'video-filter=invert')} - - @param options: optional media option=value strings - """ - for o in options: - self.add_option(o) - - - def add_option(self, ppsz_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. - The options are detailed in vlc --long-help, for instance "--sout-all". - @param ppsz_options: the options (as a string). - ''' - return libvlc_media_add_option(self, ppsz_options) - - def add_option_flag(self, ppsz_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". - @param ppsz_options: the options (as a string). - @param i_flags: the flags for this option. - ''' - return libvlc_media_add_option_flag(self, ppsz_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 NULL. - This methods automatically calls L{parse_async}(), so after calling - it you may receive a libvlc_MediaMetaChanged event. If you prefer a synchronous - version ensure that you call L{parse}() before get_meta(). - See L{parse} - See L{parse_async} - See libvlc_MediaMetaChanged. - @param e_meta: the meta to read. - @return: the media's meta. - ''' - return libvlc_media_get_meta(self, e_meta) - - 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, psz_value) - - def save_meta(self): - '''Save the meta previously set. - @return: true if the write operation was successfull. - ''' - return libvlc_media_save_meta(self) - - def get_state(self): - '''Get current state of media descriptor object. Possible media states - are defined in libvlc_structures.c ( libvlc_NothingSpecial=0, - libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused, - libvlc_Stopped, libvlc_Ended, - libvlc_Error). - See libvlc_state_t. - @return: state of media descriptor object. - ''' - return libvlc_media_get_state(self) - - 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. - ''' - return libvlc_media_get_stats(self, p_stats) - - 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(self): - '''Parse a media. - This fetches (local) meta data and tracks information. - The method is synchronous. - See L{parse_async} - See L{get_meta} - See L{get_tracks_info}. - ''' - return libvlc_media_parse(self) - - def parse_async(self): - '''Parse a media. - This fetches (local) meta data and tracks information. - The method is the asynchronous of L{parse}(). - To track when this is over you can listen to libvlc_MediaParsedChanged - event. However if the media was already parsed you will not receive this - event. - See L{parse} - See libvlc_MediaParsedChanged - See L{get_meta} - See L{get_tracks_info}. - ''' - return libvlc_media_parse_async(self) - - def is_parsed(self): - '''Get Parsed status for media descriptor object. - See libvlc_MediaParsedChanged. - @return: true if media object has been parsed otherwise it returns false. - ''' - return libvlc_media_is_parsed(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_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. - @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed by the caller). - @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 NULL on error. - ''' - return libvlc_media_player_new_from_media(self) - -class MediaDiscoverer(_Ctype): - '''N/A - ''' - - def __new__(cls, ptr=None): - '''(INTERNAL) ctypes wrapper constructor. - ''' - return _Constructor(cls, ptr) - 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 localized_name(self): - '''Get media service discover object its localized name. - @return: localized name. - ''' - return libvlc_media_discoverer_localized_name(self) - - def media_list(self): - '''Get media service discover media list. - @return: list of media items. - ''' - return libvlc_media_discoverer_media_list(self) - - def event_manager(self): - '''Get event manager from media service discover object. - @return: event manager object. - ''' - return libvlc_media_discoverer_event_manager(self) - - def is_running(self): - '''Query if media service discover object is running. - @return: true if running, false if not. - ''' - return libvlc_media_discoverer_is_running(self) - -class MediaLibrary(_Ctype): - '''N/A - ''' - - def __new__(cls, ptr=None): - '''(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 i == 0: - return None - 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 p_md: 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 __len__(self): - return self.count() - - def __getitem__(self, i): - return self.item_at_index(i) - - - 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 si 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 NULL 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 list instance. - @return: position of media instance. - ''' - 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: 0 on readonly, 1 on readwrite. - ''' - 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) - - 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, *args): - if len(args) == 1: - i = args[0] - if i == 0: - return None - if isinstance(i, _Ints): - return _Constructor(cls, i) - if isinstance(i, _Seqs): - args = i - - if args and isinstance(args[0], Instance): - i = args[0] - else: - i = get_default_instance() - return i.media_list_player_new() - - def get_instance(self): - """Return the associated Instance. - """ - return self._instance #PYCHOK expected - - - def release(self): - '''Release media_list_player. - ''' - return libvlc_media_list_player_release(self) - - 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 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): - '''Pause media list. - ''' - return libvlc_media_list_player_pause(self) - - def is_playing(self): - '''Is media list playing? - @return: true for playing and false for not playing. - ''' - 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). In this case, a vlc.Instance will be created. - - a vlc.Instance - - ''' - - def __new__(cls, *args): - if args: - i = args[0] - if i == 0: - return None - if isinstance(i, _Ints): - return _Constructor(cls, i) - if isinstance(i, Instance): - return i.media_player_new() - - i = get_default_instance() - o = i.media_player_new() - if args: - o.set_media(i.media_new(*args)) # args[0] - 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. - - @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 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 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 NULL if no media is associated. - ''' - return libvlc_media_player_get_media(self) - - 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. - ''' - 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 video_set_format(self, chroma, width, height, pitch): - '''Set decoded video chroma and dimensions. - This only works in combination with libvlc_video_set_callbacks(), - and is mutually exclusive with libvlc_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 libvlc_video_set_format_callbacks() instead. - ''' - return libvlc_video_set_format(self, chroma, width, height, pitch) - - def set_nsobject(self, drawable): - '''Set the NSView handler where the media player should render its video output. - Use the vout called "macosx". - The drawable is an NSObject that follow the VLCOpenGLVideoViewEmbedding - protocol: - @begincode - \@protocol VLCOpenGLVideoViewEmbedding - - (void)addVoutSubview:(NSView *)view; - - (void)removeVoutSubview:(NSView *)view; - \@end - @endcode - Or it can be an NSView object. - If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then - the following code should work: - @begincode - - NSView *video = [[NSView alloc] init]; - QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); - L{set_nsobject}(mp, video); - [video release]; - - @endcode - You can find a live example in VLCVideoView in VLCKit.framework. - @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol. - ''' - return libvlc_media_player_set_nsobject(self, drawable) - - 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_agl(self, drawable): - '''Set the agl handler where the media player should render its video output. - @param drawable: the agl handler. - ''' - return libvlc_media_player_set_agl(self, drawable) - - def get_agl(self): - '''Get the agl handler previously set with L{set_agl}(). - @return: the agl handler or 0 if none where set. - ''' - return libvlc_media_player_get_agl(self) - - def set_xwindow(self, drawable): - '''Set an X Window System drawable where the media player should render its - video output. If LibVLC was built without X11 output support, then this has - no effects. - The specified identifier must correspond to an existing Input/Output class - X11 window. Pixmaps are B{not} supported. The caller shall ensure that - the X11 server is the same as the one the VLC instance has been configured - with. This function must be called before video playback is started; - otherwise it will only take effect after playback stop and restart. - @param drawable: the ID of the X window. - ''' - return libvlc_media_player_set_xwindow(self, drawable) - - 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 NULL if there are none. - ''' - return libvlc_media_player_get_hwnd(self) - - def audio_set_format(self, format, rate, channels): - '''Set decoded audio format. - This only works in combination with libvlc_audio_set_callbacks(), - and is mutually exclusive with libvlc_audio_set_format_callbacks(). - @param fourcc: 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 1.2.0 or later. - ''' - return libvlc_audio_set_format(self, 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. - @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. 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. - ''' - 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 get_fps(self): - '''Get movie fps rate. - @return: frames per second (fps) for this playing movie, or 0 if unspecified. - ''' - return libvlc_media_player_get_fps(self) - - 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. - ''' - 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. - ''' - return libvlc_media_player_can_pause(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 1.2.0 or later. - ''' - return libvlc_media_player_navigate(self, navigate) - - 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). - ''' - 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". - @note: See also 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 NULL 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 NULL to reset to default @note Invalid aspect ratios are ignored. - ''' - return libvlc_video_set_aspect_ratio(self, psz_aspect) - - 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: new video subtitle to select. - @return: 0 on success, -1 if out of range. - ''' - return libvlc_video_set_spu(self, i_spu) - - def video_set_subtitle_file(self, psz_subtitle): - '''Set new video subtitle file. - @param psz_subtitle: new video subtitle file. - @return: the success status (boolean). - ''' - return libvlc_video_set_subtitle_file(self, psz_subtitle) - - def video_get_crop_geometry(self): - '''Get current crop filter geometry. - @return: the crop filter geometry or NULL 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 (NULL to unset). - ''' - return libvlc_video_set_crop_geometry(self, psz_geometry) - - def video_get_teletext(self): - '''Get current teletext page requested. - @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. - @param i_page: teletex page number requested. - ''' - return libvlc_video_set_teletext(self, i_page) - - def toggle_teletext(self): - '''Toggle teletext transparent status on video output. - ''' - return libvlc_toggle_teletext(self) - - 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 (int) or -1 if none. - ''' - return libvlc_video_get_track(self) - - def video_set_track(self, i_track): - '''Set video track. - @param i_track: the track (int). - @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 where to save the screenshot to. - @param i_width: the snapshot's width. - @param i_height: the snapshot's height. - @return: 0 on success, -1 if the video was not found. - ''' - return libvlc_video_take_snapshot(self, num, 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, NULL to disable. - ''' - return libvlc_video_set_deinterlace(self, 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, 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, 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): - '''Set the audio output. - Change will be applied after stop and play. - @param psz_name: name of audio output, use psz_name of See L{AudioOutput}. - @return: true if function succeded. - ''' - return libvlc_audio_output_set(self, psz_name) - - def audio_output_device_set(self, psz_audio_output, psz_device_id): - '''Set audio output device. Changes are only effective after stop and play. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @param psz_device_id: device. - ''' - return libvlc_audio_output_device_set(self, psz_audio_output, psz_device_id) - - def audio_output_get_device_type(self): - '''Get current audio device type. Device type describes something like - character of output sound - stereo sound, 2.1, 5.1 etc. - @return: the audio devices type See libvlc_audio_output_device_types_t. - ''' - return libvlc_audio_output_get_device_type(self) - - def audio_output_set_device_type(self, device_type): - '''Set current audio device type. - @param device_type: the audio device type, - ''' - return libvlc_audio_output_set_device_type(self, device_type) - - 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). - ''' - 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. - ''' - return libvlc_audio_set_mute(self, status) - - def audio_get_volume(self): - '''Get current audio level. - @return: the audio level (int). - ''' - return libvlc_audio_get_volume(self) - - def audio_set_volume(self, i_volume): - '''Set current audio level. - @param i_volume: the volume (int). - @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 (int), or -1 if none. - ''' - return libvlc_audio_get_track(self) - - def audio_set_track(self, i_track): - '''Set current audio track. - @param i_track: the track (int). - @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) - - - # LibVLC __version__ functions # - -def libvlc_errmsg(): - '''A human-readable error message for the last LibVLC error in the calling - thread. The resulting string is valid until another error occurs (at least - until the next LibVLC call). - @warning - This will be NULL if there was no error. - ''' - f = _Cfunctions.get('libvlc_errmsg', None) or \ - _Cfunction('libvlc_errmsg', (), None, - ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_errmsg - libvlc_errmsg = f - return f() - -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) - if not __debug__: # i.e. python -O or -OO - global libvlc_clearerr - libvlc_clearerr = f - return f() - -def libvlc_new(argc, argv): - '''Create and initialize a libvlc instance. - This functions accept a list of "command line" arguments similar to the - main(). These arguments affect the LibVLC instance default configuration. - @param argc: the number of arguments (should be 0). - @param argv: list of arguments (should be NULL). - @return: the libvlc instance or NULL 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 NULL). 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)) - if not __debug__: # i.e. python -O or -OO - global libvlc_new - libvlc_new = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_release - libvlc_release = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_retain - libvlc_retain = f - 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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_add_intf - libvlc_add_intf = f - return f(p_instance, name) - -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. - ''' - f = _Cfunctions.get('libvlc_wait', None) or \ - _Cfunction('libvlc_wait', ((1,),), None, - None, Instance) - if not __debug__: # i.e. python -O or -OO - global libvlc_wait - libvlc_wait = f - return f(p_instance) - -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) - if not __debug__: # i.e. python -O or -OO - global libvlc_set_user_agent - libvlc_set_user_agent = f - return f(p_instance, name, http) - -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) - if not __debug__: # i.e. python -O or -OO - global libvlc_get_version - libvlc_get_version = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_get_compiler - libvlc_get_compiler = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_get_changeset - libvlc_get_changeset = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_free - libvlc_free = f - 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, ctypes.c_void_p, ctypes.c_void_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_event_attach - libvlc_event_attach = f - 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, ctypes.c_void_p, ctypes.c_void_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_event_detach - libvlc_event_detach = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_event_type_name - libvlc_event_type_name = f - return f(event_type) - -def libvlc_get_log_verbosity(p_instance): - '''Return the VLC messaging verbosity level. - @param p_instance: libvlc instance. - @return: verbosity level for messages. - ''' - f = _Cfunctions.get('libvlc_get_log_verbosity', None) or \ - _Cfunction('libvlc_get_log_verbosity', ((1,),), None, - ctypes.c_uint, Instance) - if not __debug__: # i.e. python -O or -OO - global libvlc_get_log_verbosity - libvlc_get_log_verbosity = f - return f(p_instance) - -def libvlc_set_log_verbosity(p_instance, level): - '''Set the VLC messaging verbosity level. - @param p_instance: libvlc log instance. - @param level: log level. - ''' - f = _Cfunctions.get('libvlc_set_log_verbosity', None) or \ - _Cfunction('libvlc_set_log_verbosity', ((1,), (1,),), None, - None, Instance, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_set_log_verbosity - libvlc_set_log_verbosity = f - return f(p_instance, level) - -def libvlc_log_open(p_instance): - '''Open a VLC message log instance. - @param p_instance: libvlc instance. - @return: log message instance or NULL on error. - ''' - f = _Cfunctions.get('libvlc_log_open', None) or \ - _Cfunction('libvlc_log_open', ((1,),), class_result(Log), - ctypes.c_void_p, Instance) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_open - libvlc_log_open = f - return f(p_instance) - -def libvlc_log_close(p_log): - '''Close a VLC message log instance. - @param p_log: libvlc log instance or NULL. - ''' - f = _Cfunctions.get('libvlc_log_close', None) or \ - _Cfunction('libvlc_log_close', ((1,),), None, - None, Log) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_close - libvlc_log_close = f - return f(p_log) - -def libvlc_log_count(p_log): - '''Returns the number of messages in a log instance. - @param p_log: libvlc log instance or NULL. - @return: number of log messages, 0 if p_log is NULL. - ''' - f = _Cfunctions.get('libvlc_log_count', None) or \ - _Cfunction('libvlc_log_count', ((1,),), None, - ctypes.c_uint, Log) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_count - libvlc_log_count = f - return f(p_log) - -def libvlc_log_clear(p_log): - '''Clear a log instance. - All messages in the log are removed. The log should be cleared on a - regular basis to avoid clogging. - @param p_log: libvlc log instance or NULL. - ''' - f = _Cfunctions.get('libvlc_log_clear', None) or \ - _Cfunction('libvlc_log_clear', ((1,),), None, - None, Log) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_clear - libvlc_log_clear = f - return f(p_log) - -def libvlc_log_get_iterator(p_log): - '''Allocate and returns a new iterator to messages in log. - @param p_log: libvlc log instance. - @return: log iterator object or NULL on error. - ''' - f = _Cfunctions.get('libvlc_log_get_iterator', None) or \ - _Cfunction('libvlc_log_get_iterator', ((1,),), class_result(LogIterator), - ctypes.c_void_p, Log) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_get_iterator - libvlc_log_get_iterator = f - return f(p_log) - -def libvlc_log_iterator_free(p_iter): - '''Release a previoulsy allocated iterator. - @param p_iter: libvlc log iterator or NULL. - ''' - f = _Cfunctions.get('libvlc_log_iterator_free', None) or \ - _Cfunction('libvlc_log_iterator_free', ((1,),), None, - None, LogIterator) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_iterator_free - libvlc_log_iterator_free = f - return f(p_iter) - -def libvlc_log_iterator_has_next(p_iter): - '''Return whether log iterator has more messages. - @param p_iter: libvlc log iterator or NULL. - @return: true if iterator has more message objects, else false. - ''' - f = _Cfunctions.get('libvlc_log_iterator_has_next', None) or \ - _Cfunction('libvlc_log_iterator_has_next', ((1,),), None, - ctypes.c_int, LogIterator) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_iterator_has_next - libvlc_log_iterator_has_next = f - return f(p_iter) - -def libvlc_log_iterator_next(p_iter, p_buffer): - '''Return the next log message. - The message contents must not be freed. - @param p_iter: libvlc log iterator or NULL. - @param p_buffer: log buffer. - @return: log message object or NULL if none left. - ''' - f = _Cfunctions.get('libvlc_log_iterator_next', None) or \ - _Cfunction('libvlc_log_iterator_next', ((1,), (1,),), None, - ctypes.POINTER(LogMessage), LogIterator, ctypes.POINTER(LogMessage)) - if not __debug__: # i.e. python -O or -OO - global libvlc_log_iterator_next - libvlc_log_iterator_next = f - return f(p_iter, p_buffer) - -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)) - if not __debug__: # i.e. python -O or -OO - global libvlc_module_description_list_release - libvlc_module_description_list_release = f - 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, NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_filter_list_get - libvlc_audio_filter_list_get = f - 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, NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_filter_list_get - libvlc_video_filter_list_get = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_clock - libvlc_clock = f - return f() - -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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_new_location - libvlc_media_new_location = f - 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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_new_path - libvlc_media_new_path = f - 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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_new_fd - libvlc_media_new_fd = f - return f(p_instance, fd) - -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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_new_as_node - libvlc_media_new_as_node = f - return f(p_instance, psz_name) - -def libvlc_media_add_option(p_md, ppsz_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. - The options are detailed in vlc --long-help, for instance "--sout-all". - @param p_md: the media descriptor. - @param ppsz_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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_add_option - libvlc_media_add_option = f - return f(p_md, ppsz_options) - -def libvlc_media_add_option_flag(p_md, ppsz_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". - @param p_md: the media descriptor. - @param ppsz_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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_add_option_flag - libvlc_media_add_option_flag = f - return f(p_md, ppsz_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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_retain - libvlc_media_retain = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_release - libvlc_media_release = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_mrl - libvlc_media_get_mrl = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_duplicate - libvlc_media_duplicate = f - 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 NULL. - This methods automatically calls L{libvlc_media_parse_async}(), so after calling - it you may receive a libvlc_MediaMetaChanged event. If you prefer a synchronous - version ensure that you call L{libvlc_media_parse}() before get_meta(). - See L{libvlc_media_parse} - See L{libvlc_media_parse_async} - See libvlc_MediaMetaChanged. - @param p_md: the media descriptor. - @param e_meta: the meta to read. - @return: the media's meta. - ''' - f = _Cfunctions.get('libvlc_media_get_meta', None) or \ - _Cfunction('libvlc_media_get_meta', ((1,), (1,),), string_result, - ctypes.c_void_p, Media, Meta) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_meta - libvlc_media_get_meta = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_set_meta - libvlc_media_set_meta = f - 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 successfull. - ''' - f = _Cfunctions.get('libvlc_media_save_meta', None) or \ - _Cfunction('libvlc_media_save_meta', ((1,),), None, - ctypes.c_int, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_save_meta - libvlc_media_save_meta = f - return f(p_md) - -def libvlc_media_get_state(p_md): - '''Get current state of media descriptor object. Possible media states - are defined in libvlc_structures.c ( libvlc_NothingSpecial=0, - libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused, - libvlc_Stopped, libvlc_Ended, - libvlc_Error). - See libvlc_state_t. - @param p_md: a media descriptor object. - @return: state of media descriptor object. - ''' - f = _Cfunctions.get('libvlc_media_get_state', None) or \ - _Cfunction('libvlc_media_get_state', ((1,),), None, - State, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_state - libvlc_media_get_state = f - 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. - ''' - f = _Cfunctions.get('libvlc_media_get_stats', None) or \ - _Cfunction('libvlc_media_get_stats', ((1,), (1,),), None, - ctypes.c_int, Media, ctypes.POINTER(MediaStats)) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_stats - libvlc_media_get_stats = f - return f(p_md, p_stats) - -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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_event_manager - libvlc_media_event_manager = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_duration - libvlc_media_get_duration = f - return f(p_md) - -def libvlc_media_parse(p_md): - '''Parse a media. - This fetches (local) meta data and tracks information. - The method is synchronous. - See L{libvlc_media_parse_async} - See L{libvlc_media_get_meta} - See L{libvlc_media_get_tracks_info}. - @param p_md: media descriptor object. - ''' - f = _Cfunctions.get('libvlc_media_parse', None) or \ - _Cfunction('libvlc_media_parse', ((1,),), None, - None, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_parse - libvlc_media_parse = f - return f(p_md) - -def libvlc_media_parse_async(p_md): - '''Parse a media. - This fetches (local) meta data and tracks information. - The method is the asynchronous of L{libvlc_media_parse}(). - To track when this is over you can listen to libvlc_MediaParsedChanged - event. However if the media was already parsed you will not receive this - event. - See L{libvlc_media_parse} - See libvlc_MediaParsedChanged - See L{libvlc_media_get_meta} - See L{libvlc_media_get_tracks_info}. - @param p_md: media descriptor object. - ''' - f = _Cfunctions.get('libvlc_media_parse_async', None) or \ - _Cfunction('libvlc_media_parse_async', ((1,),), None, - None, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_parse_async - libvlc_media_parse_async = f - return f(p_md) - -def libvlc_media_is_parsed(p_md): - '''Get Parsed status for media descriptor object. - See libvlc_MediaParsedChanged. - @param p_md: media descriptor object. - @return: true if media object has been parsed otherwise it returns false. - ''' - f = _Cfunctions.get('libvlc_media_is_parsed', None) or \ - _Cfunction('libvlc_media_is_parsed', ((1,),), None, - ctypes.c_int, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_is_parsed - libvlc_media_is_parsed = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_set_user_data - libvlc_media_set_user_data = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_user_data - libvlc_media_get_user_data = f - 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. - @param p_md: media descriptor object. - @param tracks: address to store an allocated array of Elementary Streams descriptions (must be freed by the caller). - @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)) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_get_tracks_info - libvlc_media_get_tracks_info = f - return f(p_md) - -def libvlc_media_discoverer_new_from_name(p_inst, psz_name): - '''Discover media service by name. - @param p_inst: libvlc instance. - @param psz_name: service name. - @return: media discover object or NULL in case of error. - ''' - f = _Cfunctions.get('libvlc_media_discoverer_new_from_name', None) or \ - _Cfunction('libvlc_media_discoverer_new_from_name', ((1,), (1,),), class_result(MediaDiscoverer), - ctypes.c_void_p, Instance, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_discoverer_new_from_name - libvlc_media_discoverer_new_from_name = f - return f(p_inst, psz_name) - -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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_discoverer_release - libvlc_media_discoverer_release = f - return f(p_mdis) - -def libvlc_media_discoverer_localized_name(p_mdis): - '''Get media service discover object its localized name. - @param p_mdis: media discover object. - @return: localized name. - ''' - f = _Cfunctions.get('libvlc_media_discoverer_localized_name', None) or \ - _Cfunction('libvlc_media_discoverer_localized_name', ((1,),), string_result, - ctypes.c_void_p, MediaDiscoverer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_discoverer_localized_name - libvlc_media_discoverer_localized_name = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_discoverer_media_list - libvlc_media_discoverer_media_list = f - return f(p_mdis) - -def libvlc_media_discoverer_event_manager(p_mdis): - '''Get event manager from media service discover object. - @param p_mdis: media service discover object. - @return: event manager object. - ''' - f = _Cfunctions.get('libvlc_media_discoverer_event_manager', None) or \ - _Cfunction('libvlc_media_discoverer_event_manager', ((1,),), class_result(EventManager), - ctypes.c_void_p, MediaDiscoverer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_discoverer_event_manager - libvlc_media_discoverer_event_manager = f - 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. - ''' - f = _Cfunctions.get('libvlc_media_discoverer_is_running', None) or \ - _Cfunction('libvlc_media_discoverer_is_running', ((1,),), None, - ctypes.c_int, MediaDiscoverer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_discoverer_is_running - libvlc_media_discoverer_is_running = f - return f(p_mdis) - -def libvlc_media_library_new(p_instance): - '''Create an new Media Library object. - @param p_instance: the libvlc instance. - @return: a new object or NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_library_new - libvlc_media_library_new = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_library_release - libvlc_media_library_release = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_library_retain - libvlc_media_library_retain = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_library_load - libvlc_media_library_load = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_library_media_list - libvlc_media_library_media_list = f - return f(p_mlib) - -def libvlc_media_list_new(p_instance): - '''Create an empty media list. - @param p_instance: libvlc instance. - @return: empty media list, or NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_new - libvlc_media_list_new = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_release - libvlc_media_list_release = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_retain - libvlc_media_list_retain = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_set_media - libvlc_media_list_set_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_media - libvlc_media_list_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_add_media - libvlc_media_list_add_media = f - 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 si 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_insert_media - libvlc_media_list_insert_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_remove_index - libvlc_media_list_remove_index = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_count - libvlc_media_list_count = f - 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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_item_at_index - libvlc_media_list_item_at_index = f - 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 list instance. - @return: position of media instance. - ''' - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_index_of_item - libvlc_media_list_index_of_item = f - 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: 0 on readonly, 1 on readwrite. - ''' - f = _Cfunctions.get('libvlc_media_list_is_readonly', None) or \ - _Cfunction('libvlc_media_list_is_readonly', ((1,),), None, - ctypes.c_int, MediaList) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_is_readonly - libvlc_media_list_is_readonly = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_lock - libvlc_media_list_lock = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_unlock - libvlc_media_list_unlock = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_event_manager - libvlc_media_list_event_manager = f - return f(p_ml) - -def libvlc_media_list_player_new(p_instance): - '''Create new media_list_player. - @param p_instance: libvlc instance. - @return: media list player instance or NULL on error. - ''' - f = _Cfunctions.get('libvlc_media_list_player_new', None) or \ - _Cfunction('libvlc_media_list_player_new', ((1,),), class_result(MediaListPlayer), - ctypes.c_void_p, Instance) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_new - libvlc_media_list_player_new = f - return f(p_instance) - -def libvlc_media_list_player_release(p_mlp): - '''Release media_list_player. - @param p_mlp: media list player instance. - ''' - f = _Cfunctions.get('libvlc_media_list_player_release', None) or \ - _Cfunction('libvlc_media_list_player_release', ((1,),), None, - None, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_release - libvlc_media_list_player_release = f - return f(p_mlp) - -def libvlc_media_list_player_event_manager(p_mlp): - '''Return the event manager of this media_list_player. - @param p_mlp: media list player instance. - @return: the event manager. - ''' - f = _Cfunctions.get('libvlc_media_list_player_event_manager', None) or \ - _Cfunction('libvlc_media_list_player_event_manager', ((1,),), class_result(EventManager), - ctypes.c_void_p, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_event_manager - libvlc_media_list_player_event_manager = f - return f(p_mlp) - -def libvlc_media_list_player_set_media_player(p_mlp, p_mi): - '''Replace media player in media_list_player with this instance. - @param p_mlp: media list player instance. - @param p_mi: media player instance. - ''' - f = _Cfunctions.get('libvlc_media_list_player_set_media_player', None) or \ - _Cfunction('libvlc_media_list_player_set_media_player', ((1,), (1,),), None, - None, MediaListPlayer, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_set_media_player - libvlc_media_list_player_set_media_player = f - return f(p_mlp, p_mi) - -def libvlc_media_list_player_set_media_list(p_mlp, p_mlist): - '''Set the media list associated with the player. - @param p_mlp: media list player instance. - @param p_mlist: list of media. - ''' - f = _Cfunctions.get('libvlc_media_list_player_set_media_list', None) or \ - _Cfunction('libvlc_media_list_player_set_media_list', ((1,), (1,),), None, - None, MediaListPlayer, MediaList) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_set_media_list - libvlc_media_list_player_set_media_list = f - return f(p_mlp, p_mlist) - -def libvlc_media_list_player_play(p_mlp): - '''Play media list. - @param p_mlp: media list player instance. - ''' - f = _Cfunctions.get('libvlc_media_list_player_play', None) or \ - _Cfunction('libvlc_media_list_player_play', ((1,),), None, - None, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_play - libvlc_media_list_player_play = f - return f(p_mlp) - -def libvlc_media_list_player_pause(p_mlp): - '''Pause media list. - @param p_mlp: media list player instance. - ''' - f = _Cfunctions.get('libvlc_media_list_player_pause', None) or \ - _Cfunction('libvlc_media_list_player_pause', ((1,),), None, - None, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_pause - libvlc_media_list_player_pause = f - return f(p_mlp) - -def libvlc_media_list_player_is_playing(p_mlp): - '''Is media list playing? - @param p_mlp: media list player instance. - @return: true for playing and false for not playing. - ''' - f = _Cfunctions.get('libvlc_media_list_player_is_playing', None) or \ - _Cfunction('libvlc_media_list_player_is_playing', ((1,),), None, - ctypes.c_int, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_is_playing - libvlc_media_list_player_is_playing = f - return f(p_mlp) - -def libvlc_media_list_player_get_state(p_mlp): - '''Get current libvlc_state of media list player. - @param p_mlp: media list player instance. - @return: libvlc_state_t for media list player. - ''' - f = _Cfunctions.get('libvlc_media_list_player_get_state', None) or \ - _Cfunction('libvlc_media_list_player_get_state', ((1,),), None, - State, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_get_state - libvlc_media_list_player_get_state = f - return f(p_mlp) - -def libvlc_media_list_player_play_item_at_index(p_mlp, i_index): - '''Play media list item at position index. - @param p_mlp: media list player instance. - @param i_index: index in media list to play. - @return: 0 upon success -1 if the item wasn't found. - ''' - f = _Cfunctions.get('libvlc_media_list_player_play_item_at_index', None) or \ - _Cfunction('libvlc_media_list_player_play_item_at_index', ((1,), (1,),), None, - ctypes.c_int, MediaListPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_play_item_at_index - libvlc_media_list_player_play_item_at_index = f - return f(p_mlp, i_index) - -def libvlc_media_list_player_play_item(p_mlp, p_md): - '''Play the given media item. - @param p_mlp: media list player instance. - @param p_md: the media instance. - @return: 0 upon success, -1 if the media is not part of the media list. - ''' - f = _Cfunctions.get('libvlc_media_list_player_play_item', None) or \ - _Cfunction('libvlc_media_list_player_play_item', ((1,), (1,),), None, - ctypes.c_int, MediaListPlayer, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_play_item - libvlc_media_list_player_play_item = f - return f(p_mlp, p_md) - -def libvlc_media_list_player_stop(p_mlp): - '''Stop playing media list. - @param p_mlp: media list player instance. - ''' - f = _Cfunctions.get('libvlc_media_list_player_stop', None) or \ - _Cfunction('libvlc_media_list_player_stop', ((1,),), None, - None, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_stop - libvlc_media_list_player_stop = f - return f(p_mlp) - -def libvlc_media_list_player_next(p_mlp): - '''Play next item from media list. - @param p_mlp: media list player instance. - @return: 0 upon success -1 if there is no next item. - ''' - f = _Cfunctions.get('libvlc_media_list_player_next', None) or \ - _Cfunction('libvlc_media_list_player_next', ((1,),), None, - ctypes.c_int, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_next - libvlc_media_list_player_next = f - return f(p_mlp) - -def libvlc_media_list_player_previous(p_mlp): - '''Play previous item from media list. - @param p_mlp: media list player instance. - @return: 0 upon success -1 if there is no previous item. - ''' - f = _Cfunctions.get('libvlc_media_list_player_previous', None) or \ - _Cfunction('libvlc_media_list_player_previous', ((1,),), None, - ctypes.c_int, MediaListPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_previous - libvlc_media_list_player_previous = f - return f(p_mlp) - -def libvlc_media_list_player_set_playback_mode(p_mlp, e_mode): - '''Sets the playback mode for the playlist. - @param p_mlp: media list player instance. - @param e_mode: playback mode specification. - ''' - f = _Cfunctions.get('libvlc_media_list_player_set_playback_mode', None) or \ - _Cfunction('libvlc_media_list_player_set_playback_mode', ((1,), (1,),), None, - None, MediaListPlayer, PlaybackMode) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_list_player_set_playback_mode - libvlc_media_list_player_set_playback_mode = f - return f(p_mlp, e_mode) - -def libvlc_media_player_new(p_libvlc_instance): - '''Create an empty Media Player object. - @param p_libvlc_instance: the libvlc instance in which the Media Player should be created. - @return: a new media player object, or NULL on error. - ''' - f = _Cfunctions.get('libvlc_media_player_new', None) or \ - _Cfunction('libvlc_media_player_new', ((1,),), class_result(MediaPlayer), - ctypes.c_void_p, Instance) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_new - libvlc_media_player_new = f - return f(p_libvlc_instance) - -def libvlc_media_player_new_from_media(p_md): - '''Create a Media Player object from a Media. - @param p_md: the media. Afterwards the p_md can be safely destroyed. - @return: a new media player object, or NULL on error. - ''' - f = _Cfunctions.get('libvlc_media_player_new_from_media', None) or \ - _Cfunction('libvlc_media_player_new_from_media', ((1,),), class_result(MediaPlayer), - ctypes.c_void_p, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_new_from_media - libvlc_media_player_new_from_media = f - return f(p_md) - -def libvlc_media_player_release(p_mi): - '''Release a media_player after use - Decrement the reference count of a media player object. If the - reference count is 0, then L{libvlc_media_player_release}() will - release the media player object. If the media player object - has been released, then it should not be used again. - @param p_mi: the Media Player to free. - ''' - f = _Cfunctions.get('libvlc_media_player_release', None) or \ - _Cfunction('libvlc_media_player_release', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_release - libvlc_media_player_release = f - return f(p_mi) - -def libvlc_media_player_retain(p_mi): - '''Retain a reference to a media player object. Use - L{libvlc_media_player_release}() to decrement reference count. - @param p_mi: media player object. - ''' - f = _Cfunctions.get('libvlc_media_player_retain', None) or \ - _Cfunction('libvlc_media_player_retain', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_retain - libvlc_media_player_retain = f - return f(p_mi) - -def libvlc_media_player_set_media(p_mi, p_md): - '''Set the media that will be used by the media_player. If any, - previous md will be released. - @param p_mi: the Media Player. - @param p_md: the Media. Afterwards the p_md can be safely destroyed. - ''' - f = _Cfunctions.get('libvlc_media_player_set_media', None) or \ - _Cfunction('libvlc_media_player_set_media', ((1,), (1,),), None, - None, MediaPlayer, Media) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_media - libvlc_media_player_set_media = f - return f(p_mi, p_md) - -def libvlc_media_player_get_media(p_mi): - '''Get the media used by the media_player. - @param p_mi: the Media Player. - @return: the media associated with p_mi, or NULL if no media is associated. - ''' - f = _Cfunctions.get('libvlc_media_player_get_media', None) or \ - _Cfunction('libvlc_media_player_get_media', ((1,),), class_result(Media), - ctypes.c_void_p, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_media - libvlc_media_player_get_media = f - return f(p_mi) - -def libvlc_media_player_event_manager(p_mi): - '''Get the Event Manager from which the media player send event. - @param p_mi: the Media Player. - @return: the event manager associated with p_mi. - ''' - f = _Cfunctions.get('libvlc_media_player_event_manager', None) or \ - _Cfunction('libvlc_media_player_event_manager', ((1,),), class_result(EventManager), - ctypes.c_void_p, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_event_manager - libvlc_media_player_event_manager = f - return f(p_mi) - -def libvlc_media_player_is_playing(p_mi): - '''is_playing. - @param p_mi: the Media Player. - @return: 1 if the media player is playing, 0 otherwise. - ''' - f = _Cfunctions.get('libvlc_media_player_is_playing', None) or \ - _Cfunction('libvlc_media_player_is_playing', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_is_playing - libvlc_media_player_is_playing = f - return f(p_mi) - -def libvlc_media_player_play(p_mi): - '''Play. - @param p_mi: the Media Player. - @return: 0 if playback started (and was already started), or -1 on error. - ''' - f = _Cfunctions.get('libvlc_media_player_play', None) or \ - _Cfunction('libvlc_media_player_play', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_play - libvlc_media_player_play = f - return f(p_mi) - -def libvlc_media_player_set_pause(mp, do_pause): - '''Pause or resume (no effect if there is no media). - @param mp: the Media Player. - @param do_pause: play/resume if zero, pause if non-zero. - @version: LibVLC 1.1.1 or later. - ''' - f = _Cfunctions.get('libvlc_media_player_set_pause', None) or \ - _Cfunction('libvlc_media_player_set_pause', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_pause - libvlc_media_player_set_pause = f - return f(mp, do_pause) - -def libvlc_media_player_pause(p_mi): - '''Toggle pause (no effect if there is no media). - @param p_mi: the Media Player. - ''' - f = _Cfunctions.get('libvlc_media_player_pause', None) or \ - _Cfunction('libvlc_media_player_pause', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_pause - libvlc_media_player_pause = f - return f(p_mi) - -def libvlc_media_player_stop(p_mi): - '''Stop (no effect if there is no media). - @param p_mi: the Media Player. - ''' - f = _Cfunctions.get('libvlc_media_player_stop', None) or \ - _Cfunction('libvlc_media_player_stop', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_stop - libvlc_media_player_stop = f - return f(p_mi) - -def libvlc_video_set_format(mp, chroma, width, height, pitch): - '''Set decoded video chroma and dimensions. - This only works in combination with libvlc_video_set_callbacks(), - and is mutually exclusive with libvlc_video_set_format_callbacks(). - @param mp: the media player. - @param chroma: a four-characters string identifying the chroma (e.g. "RV32" or "YUYV"). - @param width: pixel width. - @param height: pixel height. - @param pitch: line pitch (in bytes). - @version: LibVLC 1.1.1 or later. - @bug: All pixel planes are expected to have the same pitch. To use the YCbCr color space with chrominance subsampling, consider using libvlc_video_set_format_callbacks() instead. - ''' - f = _Cfunctions.get('libvlc_video_set_format', None) or \ - _Cfunction('libvlc_video_set_format', ((1,), (1,), (1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_format - libvlc_video_set_format = f - return f(mp, chroma, width, height, pitch) - -def libvlc_media_player_set_nsobject(p_mi, drawable): - '''Set the NSView handler where the media player should render its video output. - Use the vout called "macosx". - The drawable is an NSObject that follow the VLCOpenGLVideoViewEmbedding - protocol: - @begincode - \@protocol VLCOpenGLVideoViewEmbedding - - (void)addVoutSubview:(NSView *)view; - - (void)removeVoutSubview:(NSView *)view; - \@end - @endcode - Or it can be an NSView object. - If you want to use it along with Qt4 see the QMacCocoaViewContainer. Then - the following code should work: - @begincode - - NSView *video = [[NSView alloc] init]; - QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); - L{libvlc_media_player_set_nsobject}(mp, video); - [video release]; - - @endcode - You can find a live example in VLCVideoView in VLCKit.framework. - @param p_mi: the Media Player. - @param drawable: the drawable that is either an NSView or an object following the VLCOpenGLVideoViewEmbedding protocol. - ''' - f = _Cfunctions.get('libvlc_media_player_set_nsobject', None) or \ - _Cfunction('libvlc_media_player_set_nsobject', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_void_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_nsobject - libvlc_media_player_set_nsobject = f - return f(p_mi, drawable) - -def libvlc_media_player_get_nsobject(p_mi): - '''Get the NSView handler previously set with L{libvlc_media_player_set_nsobject}(). - @param p_mi: the Media Player. - @return: the NSView handler or 0 if none where set. - ''' - f = _Cfunctions.get('libvlc_media_player_get_nsobject', None) or \ - _Cfunction('libvlc_media_player_get_nsobject', ((1,),), None, - ctypes.c_void_p, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_nsobject - libvlc_media_player_get_nsobject = f - return f(p_mi) - -def libvlc_media_player_set_agl(p_mi, drawable): - '''Set the agl handler where the media player should render its video output. - @param p_mi: the Media Player. - @param drawable: the agl handler. - ''' - f = _Cfunctions.get('libvlc_media_player_set_agl', None) or \ - _Cfunction('libvlc_media_player_set_agl', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint32) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_agl - libvlc_media_player_set_agl = f - return f(p_mi, drawable) - -def libvlc_media_player_get_agl(p_mi): - '''Get the agl handler previously set with L{libvlc_media_player_set_agl}(). - @param p_mi: the Media Player. - @return: the agl handler or 0 if none where set. - ''' - f = _Cfunctions.get('libvlc_media_player_get_agl', None) or \ - _Cfunction('libvlc_media_player_get_agl', ((1,),), None, - ctypes.c_uint32, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_agl - libvlc_media_player_get_agl = f - return f(p_mi) - -def libvlc_media_player_set_xwindow(p_mi, drawable): - '''Set an X Window System drawable where the media player should render its - video output. If LibVLC was built without X11 output support, then this has - no effects. - The specified identifier must correspond to an existing Input/Output class - X11 window. Pixmaps are B{not} supported. The caller shall ensure that - the X11 server is the same as the one the VLC instance has been configured - with. This function must be called before video playback is started; - otherwise it will only take effect after playback stop and restart. - @param p_mi: the Media Player. - @param drawable: the ID of the X window. - ''' - f = _Cfunctions.get('libvlc_media_player_set_xwindow', None) or \ - _Cfunction('libvlc_media_player_set_xwindow', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint32) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_xwindow - libvlc_media_player_set_xwindow = f - return f(p_mi, drawable) - -def libvlc_media_player_get_xwindow(p_mi): - '''Get the X Window System window identifier previously set with - L{libvlc_media_player_set_xwindow}(). Note that this will return the identifier - even if VLC is not currently using it (for instance if it is playing an - audio-only input). - @param p_mi: the Media Player. - @return: an X window ID, or 0 if none where set. - ''' - f = _Cfunctions.get('libvlc_media_player_get_xwindow', None) or \ - _Cfunction('libvlc_media_player_get_xwindow', ((1,),), None, - ctypes.c_uint32, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_xwindow - libvlc_media_player_get_xwindow = f - return f(p_mi) - -def libvlc_media_player_set_hwnd(p_mi, drawable): - '''Set a Win32/Win64 API window handle (HWND) where the media player should - render its video output. If LibVLC was built without Win32/Win64 API output - support, then this has no effects. - @param p_mi: the Media Player. - @param drawable: windows handle of the drawable. - ''' - f = _Cfunctions.get('libvlc_media_player_set_hwnd', None) or \ - _Cfunction('libvlc_media_player_set_hwnd', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_void_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_hwnd - libvlc_media_player_set_hwnd = f - return f(p_mi, drawable) - -def libvlc_media_player_get_hwnd(p_mi): - '''Get the Windows API window handle (HWND) previously set with - L{libvlc_media_player_set_hwnd}(). The handle will be returned even if LibVLC - is not currently outputting any video to it. - @param p_mi: the Media Player. - @return: a window handle or NULL if there are none. - ''' - f = _Cfunctions.get('libvlc_media_player_get_hwnd', None) or \ - _Cfunction('libvlc_media_player_get_hwnd', ((1,),), None, - ctypes.c_void_p, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_hwnd - libvlc_media_player_get_hwnd = f - return f(p_mi) - -def libvlc_audio_set_format(mp, format, rate, channels): - '''Set decoded audio format. - This only works in combination with libvlc_audio_set_callbacks(), - and is mutually exclusive with libvlc_audio_set_format_callbacks(). - @param mp: the media player. - @param fourcc: 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 1.2.0 or later. - ''' - f = _Cfunctions.get('libvlc_audio_set_format', None) or \ - _Cfunction('libvlc_audio_set_format', ((1,), (1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_char_p, ctypes.c_uint, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_set_format - libvlc_audio_set_format = f - return f(mp, format, rate, channels) - -def libvlc_media_player_get_length(p_mi): - '''Get the current movie length (in ms). - @param p_mi: the Media Player. - @return: the movie length (in ms), or -1 if there is no media. - ''' - f = _Cfunctions.get('libvlc_media_player_get_length', None) or \ - _Cfunction('libvlc_media_player_get_length', ((1,),), None, - ctypes.c_longlong, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_length - libvlc_media_player_get_length = f - return f(p_mi) - -def libvlc_media_player_get_time(p_mi): - '''Get the current movie time (in ms). - @param p_mi: the Media Player. - @return: the movie time (in ms), or -1 if there is no media. - ''' - f = _Cfunctions.get('libvlc_media_player_get_time', None) or \ - _Cfunction('libvlc_media_player_get_time', ((1,),), None, - ctypes.c_longlong, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_time - libvlc_media_player_get_time = f - return f(p_mi) - -def libvlc_media_player_set_time(p_mi, i_time): - '''Set the movie time (in ms). This has no effect if no media is being played. - Not all formats and protocols support this. - @param p_mi: the Media Player. - @param i_time: the movie time (in ms). - ''' - f = _Cfunctions.get('libvlc_media_player_set_time', None) or \ - _Cfunction('libvlc_media_player_set_time', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_longlong) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_time - libvlc_media_player_set_time = f - return f(p_mi, i_time) - -def libvlc_media_player_get_position(p_mi): - '''Get movie position. - @param p_mi: the Media Player. - @return: movie position, or -1. in case of error. - ''' - f = _Cfunctions.get('libvlc_media_player_get_position', None) or \ - _Cfunction('libvlc_media_player_get_position', ((1,),), None, - ctypes.c_float, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_position - libvlc_media_player_get_position = f - return f(p_mi) - -def libvlc_media_player_set_position(p_mi, f_pos): - '''Set movie position. This has no effect if playback is not enabled. - This might not work depending on the underlying input format and protocol. - @param p_mi: the Media Player. - @param f_pos: the position. - ''' - f = _Cfunctions.get('libvlc_media_player_set_position', None) or \ - _Cfunction('libvlc_media_player_set_position', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_float) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_position - libvlc_media_player_set_position = f - return f(p_mi, f_pos) - -def libvlc_media_player_set_chapter(p_mi, i_chapter): - '''Set movie chapter (if applicable). - @param p_mi: the Media Player. - @param i_chapter: chapter number to play. - ''' - f = _Cfunctions.get('libvlc_media_player_set_chapter', None) or \ - _Cfunction('libvlc_media_player_set_chapter', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_chapter - libvlc_media_player_set_chapter = f - return f(p_mi, i_chapter) - -def libvlc_media_player_get_chapter(p_mi): - '''Get movie chapter. - @param p_mi: the Media Player. - @return: chapter number currently playing, or -1 if there is no media. - ''' - f = _Cfunctions.get('libvlc_media_player_get_chapter', None) or \ - _Cfunction('libvlc_media_player_get_chapter', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_chapter - libvlc_media_player_get_chapter = f - return f(p_mi) - -def libvlc_media_player_get_chapter_count(p_mi): - '''Get movie chapter count. - @param p_mi: the Media Player. - @return: number of chapters in movie, or -1. - ''' - f = _Cfunctions.get('libvlc_media_player_get_chapter_count', None) or \ - _Cfunction('libvlc_media_player_get_chapter_count', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_chapter_count - libvlc_media_player_get_chapter_count = f - return f(p_mi) - -def libvlc_media_player_will_play(p_mi): - '''Is the player able to play. - @param p_mi: the Media Player. - @return: boolean. - ''' - f = _Cfunctions.get('libvlc_media_player_will_play', None) or \ - _Cfunction('libvlc_media_player_will_play', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_will_play - libvlc_media_player_will_play = f - return f(p_mi) - -def libvlc_media_player_get_chapter_count_for_title(p_mi, i_title): - '''Get title chapter count. - @param p_mi: the Media Player. - @param i_title: title. - @return: number of chapters in title, or -1. - ''' - f = _Cfunctions.get('libvlc_media_player_get_chapter_count_for_title', None) or \ - _Cfunction('libvlc_media_player_get_chapter_count_for_title', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_chapter_count_for_title - libvlc_media_player_get_chapter_count_for_title = f - return f(p_mi, i_title) - -def libvlc_media_player_set_title(p_mi, i_title): - '''Set movie title. - @param p_mi: the Media Player. - @param i_title: title number to play. - ''' - f = _Cfunctions.get('libvlc_media_player_set_title', None) or \ - _Cfunction('libvlc_media_player_set_title', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_title - libvlc_media_player_set_title = f - return f(p_mi, i_title) - -def libvlc_media_player_get_title(p_mi): - '''Get movie title. - @param p_mi: the Media Player. - @return: title number currently playing, or -1. - ''' - f = _Cfunctions.get('libvlc_media_player_get_title', None) or \ - _Cfunction('libvlc_media_player_get_title', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_title - libvlc_media_player_get_title = f - return f(p_mi) - -def libvlc_media_player_get_title_count(p_mi): - '''Get movie title count. - @param p_mi: the Media Player. - @return: title number count, or -1. - ''' - f = _Cfunctions.get('libvlc_media_player_get_title_count', None) or \ - _Cfunction('libvlc_media_player_get_title_count', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_title_count - libvlc_media_player_get_title_count = f - return f(p_mi) - -def libvlc_media_player_previous_chapter(p_mi): - '''Set previous chapter (if applicable). - @param p_mi: the Media Player. - ''' - f = _Cfunctions.get('libvlc_media_player_previous_chapter', None) or \ - _Cfunction('libvlc_media_player_previous_chapter', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_previous_chapter - libvlc_media_player_previous_chapter = f - return f(p_mi) - -def libvlc_media_player_next_chapter(p_mi): - '''Set next chapter (if applicable). - @param p_mi: the Media Player. - ''' - f = _Cfunctions.get('libvlc_media_player_next_chapter', None) or \ - _Cfunction('libvlc_media_player_next_chapter', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_next_chapter - libvlc_media_player_next_chapter = f - return f(p_mi) - -def libvlc_media_player_get_rate(p_mi): - '''Get the requested movie play rate. - @warning: Depending on the underlying media, the requested rate may be - different from the real playback rate. - @param p_mi: the Media Player. - @return: movie play rate. - ''' - f = _Cfunctions.get('libvlc_media_player_get_rate', None) or \ - _Cfunction('libvlc_media_player_get_rate', ((1,),), None, - ctypes.c_float, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_rate - libvlc_media_player_get_rate = f - return f(p_mi) - -def libvlc_media_player_set_rate(p_mi, rate): - '''Set movie play rate. - @param p_mi: the Media Player. - @param rate: movie play rate to set. - @return: -1 if an error was detected, 0 otherwise (but even then, it might not actually work depending on the underlying media protocol). - ''' - f = _Cfunctions.get('libvlc_media_player_set_rate', None) or \ - _Cfunction('libvlc_media_player_set_rate', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_float) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_set_rate - libvlc_media_player_set_rate = f - return f(p_mi, rate) - -def libvlc_media_player_get_state(p_mi): - '''Get current movie state. - @param p_mi: the Media Player. - @return: the current state of the media player (playing, paused, ...) See libvlc_state_t. - ''' - f = _Cfunctions.get('libvlc_media_player_get_state', None) or \ - _Cfunction('libvlc_media_player_get_state', ((1,),), None, - State, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_state - libvlc_media_player_get_state = f - return f(p_mi) - -def libvlc_media_player_get_fps(p_mi): - '''Get movie fps rate. - @param p_mi: the Media Player. - @return: frames per second (fps) for this playing movie, or 0 if unspecified. - ''' - f = _Cfunctions.get('libvlc_media_player_get_fps', None) or \ - _Cfunction('libvlc_media_player_get_fps', ((1,),), None, - ctypes.c_float, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_get_fps - libvlc_media_player_get_fps = f - return f(p_mi) - -def libvlc_media_player_has_vout(p_mi): - '''How many video outputs does this media player have? - @param p_mi: the media player. - @return: the number of video outputs. - ''' - f = _Cfunctions.get('libvlc_media_player_has_vout', None) or \ - _Cfunction('libvlc_media_player_has_vout', ((1,),), None, - ctypes.c_uint, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_has_vout - libvlc_media_player_has_vout = f - return f(p_mi) - -def libvlc_media_player_is_seekable(p_mi): - '''Is this media player seekable? - @param p_mi: the media player. - @return: true if the media player can seek. - ''' - f = _Cfunctions.get('libvlc_media_player_is_seekable', None) or \ - _Cfunction('libvlc_media_player_is_seekable', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_is_seekable - libvlc_media_player_is_seekable = f - return f(p_mi) - -def libvlc_media_player_can_pause(p_mi): - '''Can this media player be paused? - @param p_mi: the media player. - @return: true if the media player can pause. - ''' - f = _Cfunctions.get('libvlc_media_player_can_pause', None) or \ - _Cfunction('libvlc_media_player_can_pause', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_can_pause - libvlc_media_player_can_pause = f - return f(p_mi) - -def libvlc_media_player_next_frame(p_mi): - '''Display the next frame (if supported). - @param p_mi: the media player. - ''' - f = _Cfunctions.get('libvlc_media_player_next_frame', None) or \ - _Cfunction('libvlc_media_player_next_frame', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_next_frame - libvlc_media_player_next_frame = f - return f(p_mi) - -def libvlc_media_player_navigate(p_mi, navigate): - '''Navigate through DVD Menu. - @param p_mi: the Media Player. - @param navigate: the Navigation mode. - @version: libVLC 1.2.0 or later. - ''' - f = _Cfunctions.get('libvlc_media_player_navigate', None) or \ - _Cfunction('libvlc_media_player_navigate', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_media_player_navigate - libvlc_media_player_navigate = f - return f(p_mi, navigate) - -def libvlc_track_description_release(p_track_description): - '''Release (free) L{TrackDescription}. - @param p_track_description: the structure to release. - ''' - f = _Cfunctions.get('libvlc_track_description_release', None) or \ - _Cfunction('libvlc_track_description_release', ((1,),), None, - None, ctypes.POINTER(TrackDescription)) - if not __debug__: # i.e. python -O or -OO - global libvlc_track_description_release - libvlc_track_description_release = f - return f(p_track_description) - -def libvlc_toggle_fullscreen(p_mi): - '''Toggle fullscreen status on non-embedded video outputs. - @warning: The same limitations applies to this function - as to L{libvlc_set_fullscreen}(). - @param p_mi: the media player. - ''' - f = _Cfunctions.get('libvlc_toggle_fullscreen', None) or \ - _Cfunction('libvlc_toggle_fullscreen', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_toggle_fullscreen - libvlc_toggle_fullscreen = f - return f(p_mi) - -def libvlc_set_fullscreen(p_mi, b_fullscreen): - '''Enable or disable fullscreen. - @warning: With most window managers, only a top-level windows can be in - full-screen mode. Hence, this function will not operate properly if - L{libvlc_media_player_set_xwindow}() was used to embed the video in a - non-top-level window. In that case, the embedding window must be reparented - to the root window B{before} fullscreen mode is enabled. You will want - to reparent it back to its normal parent when disabling fullscreen. - @param p_mi: the media player. - @param b_fullscreen: boolean for fullscreen status. - ''' - f = _Cfunctions.get('libvlc_set_fullscreen', None) or \ - _Cfunction('libvlc_set_fullscreen', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_set_fullscreen - libvlc_set_fullscreen = f - return f(p_mi, b_fullscreen) - -def libvlc_get_fullscreen(p_mi): - '''Get current fullscreen status. - @param p_mi: the media player. - @return: the fullscreen status (boolean). - ''' - f = _Cfunctions.get('libvlc_get_fullscreen', None) or \ - _Cfunction('libvlc_get_fullscreen', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_get_fullscreen - libvlc_get_fullscreen = f - return f(p_mi) - -def libvlc_video_set_key_input(p_mi, on): - '''Enable or disable key press events handling, according to the LibVLC hotkeys - configuration. By default and for historical reasons, keyboard events are - handled by the LibVLC video widget. - @note: On X11, there can be only one subscriber for key press and mouse - click events per window. If your application has subscribed to those events - for the X window ID of the video widget, then LibVLC will not be able to - handle key presses and mouse clicks in any case. - @warning: This function is only implemented for X11 and Win32 at the moment. - @param p_mi: the media player. - @param on: true to handle key press events, false to ignore them. - ''' - f = _Cfunctions.get('libvlc_video_set_key_input', None) or \ - _Cfunction('libvlc_video_set_key_input', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_key_input - libvlc_video_set_key_input = f - return f(p_mi, on) - -def libvlc_video_set_mouse_input(p_mi, on): - '''Enable or disable mouse click events handling. By default, those events are - handled. This is needed for DVD menus to work, as well as a few video - filters such as "puzzle". - @note: See also L{libvlc_video_set_key_input}(). - @warning: This function is only implemented for X11 and Win32 at the moment. - @param p_mi: the media player. - @param on: true to handle mouse click events, false to ignore them. - ''' - f = _Cfunctions.get('libvlc_video_set_mouse_input', None) or \ - _Cfunction('libvlc_video_set_mouse_input', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_mouse_input - libvlc_video_set_mouse_input = f - return f(p_mi, on) - -def libvlc_video_get_size(p_mi, num): - '''Get the pixel dimensions of a video. - @param p_mi: media player. - @param num: number of the video (starting from, and most commonly 0). - @return: px pixel width, py pixel height. - ''' - f = _Cfunctions.get('libvlc_video_get_size', None) or \ - _Cfunction('libvlc_video_get_size', ((1,), (1,), (2,), (2,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint)) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_size - libvlc_video_get_size = f - return f(p_mi, num) - -def libvlc_video_get_cursor(p_mi, num): - '''Get the mouse pointer coordinates over a video. - Coordinates are expressed in terms of the decoded video resolution, - B{not} in terms of pixels on the screen/viewport (to get the latter, - you can query your windowing system directly). - Either of the coordinates may be negative or larger than the corresponding - dimension of the video, if the cursor is outside the rendering area. - @warning: The coordinates may be out-of-date if the pointer is not located - on the video rendering area. LibVLC does not track the pointer if it is - outside of the video widget. - @note: LibVLC does not support multiple pointers (it does of course support - multiple input devices sharing the same pointer) at the moment. - @param p_mi: media player. - @param num: number of the video (starting from, and most commonly 0). - @return: px abscissa, py ordinate. - ''' - f = _Cfunctions.get('libvlc_video_get_cursor', None) or \ - _Cfunction('libvlc_video_get_cursor', ((1,), (1,), (2,), (2,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.POINTER(ctypes.c_int), ctypes.POINTER(ctypes.c_int)) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_cursor - libvlc_video_get_cursor = f - return f(p_mi, num) - -def libvlc_video_get_scale(p_mi): - '''Get the current video scaling factor. - See also L{libvlc_video_set_scale}(). - @param p_mi: the media player. - @return: the currently configured zoom factor, or 0. if the video is set to fit to the output window/drawable automatically. - ''' - f = _Cfunctions.get('libvlc_video_get_scale', None) or \ - _Cfunction('libvlc_video_get_scale', ((1,),), None, - ctypes.c_float, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_scale - libvlc_video_get_scale = f - return f(p_mi) - -def libvlc_video_set_scale(p_mi, f_factor): - '''Set the video scaling factor. That is the ratio of the number of pixels on - screen to the number of pixels in the original decoded video in each - dimension. Zero is a special value; it will adjust the video to the output - window/drawable (in windowed mode) or the entire screen. - Note that not all video outputs support scaling. - @param p_mi: the media player. - @param f_factor: the scaling factor, or zero. - ''' - f = _Cfunctions.get('libvlc_video_set_scale', None) or \ - _Cfunction('libvlc_video_set_scale', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_float) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_scale - libvlc_video_set_scale = f - return f(p_mi, f_factor) - -def libvlc_video_get_aspect_ratio(p_mi): - '''Get current video aspect ratio. - @param p_mi: the media player. - @return: the video aspect ratio or NULL if unspecified (the result must be released with free() or L{libvlc_free}()). - ''' - f = _Cfunctions.get('libvlc_video_get_aspect_ratio', None) or \ - _Cfunction('libvlc_video_get_aspect_ratio', ((1,),), string_result, - ctypes.c_void_p, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_aspect_ratio - libvlc_video_get_aspect_ratio = f - return f(p_mi) - -def libvlc_video_set_aspect_ratio(p_mi, psz_aspect): - '''Set new video aspect ratio. - @param p_mi: the media player. - @param psz_aspect: new video aspect-ratio or NULL to reset to default @note Invalid aspect ratios are ignored. - ''' - f = _Cfunctions.get('libvlc_video_set_aspect_ratio', None) or \ - _Cfunction('libvlc_video_set_aspect_ratio', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_aspect_ratio - libvlc_video_set_aspect_ratio = f - return f(p_mi, psz_aspect) - -def libvlc_video_get_spu(p_mi): - '''Get current video subtitle. - @param p_mi: the media player. - @return: the video subtitle selected, or -1 if none. - ''' - f = _Cfunctions.get('libvlc_video_get_spu', None) or \ - _Cfunction('libvlc_video_get_spu', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_spu - libvlc_video_get_spu = f - return f(p_mi) - -def libvlc_video_get_spu_count(p_mi): - '''Get the number of available video subtitles. - @param p_mi: the media player. - @return: the number of available video subtitles. - ''' - f = _Cfunctions.get('libvlc_video_get_spu_count', None) or \ - _Cfunction('libvlc_video_get_spu_count', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_spu_count - libvlc_video_get_spu_count = f - return f(p_mi) - -def libvlc_video_get_spu_description(p_mi): - '''Get the description of available video subtitles. - @param p_mi: the media player. - @return: list containing description of available video subtitles. - ''' - f = _Cfunctions.get('libvlc_video_get_spu_description', None) or \ - _Cfunction('libvlc_video_get_spu_description', ((1,),), None, - ctypes.POINTER(TrackDescription), MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_spu_description - libvlc_video_get_spu_description = f - return f(p_mi) - -def libvlc_video_set_spu(p_mi, i_spu): - '''Set new video subtitle. - @param p_mi: the media player. - @param i_spu: new video subtitle to select. - @return: 0 on success, -1 if out of range. - ''' - f = _Cfunctions.get('libvlc_video_set_spu', None) or \ - _Cfunction('libvlc_video_set_spu', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_spu - libvlc_video_set_spu = f - return f(p_mi, i_spu) - -def libvlc_video_set_subtitle_file(p_mi, psz_subtitle): - '''Set new video subtitle file. - @param p_mi: the media player. - @param psz_subtitle: new video subtitle file. - @return: the success status (boolean). - ''' - f = _Cfunctions.get('libvlc_video_set_subtitle_file', None) or \ - _Cfunction('libvlc_video_set_subtitle_file', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_subtitle_file - libvlc_video_set_subtitle_file = f - return f(p_mi, psz_subtitle) - -def libvlc_video_get_title_description(p_mi): - '''Get the description of available titles. - @param p_mi: the media player. - @return: list containing description of available titles. - ''' - f = _Cfunctions.get('libvlc_video_get_title_description', None) or \ - _Cfunction('libvlc_video_get_title_description', ((1,),), None, - ctypes.POINTER(TrackDescription), MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_title_description - libvlc_video_get_title_description = f - 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. - ''' - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_chapter_description - libvlc_video_get_chapter_description = f - return f(p_mi, i_title) - -def libvlc_video_get_crop_geometry(p_mi): - '''Get current crop filter geometry. - @param p_mi: the media player. - @return: the crop filter geometry or NULL if unset. - ''' - f = _Cfunctions.get('libvlc_video_get_crop_geometry', None) or \ - _Cfunction('libvlc_video_get_crop_geometry', ((1,),), string_result, - ctypes.c_void_p, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_crop_geometry - libvlc_video_get_crop_geometry = f - return f(p_mi) - -def libvlc_video_set_crop_geometry(p_mi, psz_geometry): - '''Set new crop filter geometry. - @param p_mi: the media player. - @param psz_geometry: new crop filter geometry (NULL to unset). - ''' - f = _Cfunctions.get('libvlc_video_set_crop_geometry', None) or \ - _Cfunction('libvlc_video_set_crop_geometry', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_crop_geometry - libvlc_video_set_crop_geometry = f - return f(p_mi, psz_geometry) - -def libvlc_video_get_teletext(p_mi): - '''Get current teletext page requested. - @param p_mi: the media player. - @return: the current teletext page requested. - ''' - f = _Cfunctions.get('libvlc_video_get_teletext', None) or \ - _Cfunction('libvlc_video_get_teletext', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_teletext - libvlc_video_get_teletext = f - return f(p_mi) - -def libvlc_video_set_teletext(p_mi, i_page): - '''Set new teletext page to retrieve. - @param p_mi: the media player. - @param i_page: teletex page number requested. - ''' - f = _Cfunctions.get('libvlc_video_set_teletext', None) or \ - _Cfunction('libvlc_video_set_teletext', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_teletext - libvlc_video_set_teletext = f - return f(p_mi, i_page) - -def libvlc_toggle_teletext(p_mi): - '''Toggle teletext transparent status on video output. - @param p_mi: the media player. - ''' - f = _Cfunctions.get('libvlc_toggle_teletext', None) or \ - _Cfunction('libvlc_toggle_teletext', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_toggle_teletext - libvlc_toggle_teletext = f - return f(p_mi) - -def libvlc_video_get_track_count(p_mi): - '''Get number of available video tracks. - @param p_mi: media player. - @return: the number of available video tracks (int). - ''' - f = _Cfunctions.get('libvlc_video_get_track_count', None) or \ - _Cfunction('libvlc_video_get_track_count', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_track_count - libvlc_video_get_track_count = f - return f(p_mi) - -def libvlc_video_get_track_description(p_mi): - '''Get the description of available video tracks. - @param p_mi: media player. - @return: list with description of available video tracks, or NULL on error. - ''' - f = _Cfunctions.get('libvlc_video_get_track_description', None) or \ - _Cfunction('libvlc_video_get_track_description', ((1,),), None, - ctypes.POINTER(TrackDescription), MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_track_description - libvlc_video_get_track_description = f - return f(p_mi) - -def libvlc_video_get_track(p_mi): - '''Get current video track. - @param p_mi: media player. - @return: the video track (int) or -1 if none. - ''' - f = _Cfunctions.get('libvlc_video_get_track', None) or \ - _Cfunction('libvlc_video_get_track', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_track - libvlc_video_get_track = f - return f(p_mi) - -def libvlc_video_set_track(p_mi, i_track): - '''Set video track. - @param p_mi: media player. - @param i_track: the track (int). - @return: 0 on success, -1 if out of range. - ''' - f = _Cfunctions.get('libvlc_video_set_track', None) or \ - _Cfunction('libvlc_video_set_track', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_track - libvlc_video_set_track = f - return f(p_mi, i_track) - -def libvlc_video_take_snapshot(p_mi, num, psz_filepath, i_width, i_height): - '''Take a snapshot of the current video window. - If i_width AND i_height is 0, original size is used. - If i_width XOR i_height is 0, original aspect-ratio is preserved. - @param p_mi: media player instance. - @param num: number of video output (typically 0 for the first/only one). - @param psz_filepath: the path where to save the screenshot to. - @param i_width: the snapshot's width. - @param i_height: the snapshot's height. - @return: 0 on success, -1 if the video was not found. - ''' - f = _Cfunctions.get('libvlc_video_take_snapshot', None) or \ - _Cfunction('libvlc_video_take_snapshot', ((1,), (1,), (1,), (1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint, ctypes.c_char_p, ctypes.c_int, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_take_snapshot - libvlc_video_take_snapshot = f - return f(p_mi, num, psz_filepath, i_width, i_height) - -def libvlc_video_set_deinterlace(p_mi, psz_mode): - '''Enable or disable deinterlace filter. - @param p_mi: libvlc media player. - @param psz_mode: type of deinterlace filter, NULL to disable. - ''' - f = _Cfunctions.get('libvlc_video_set_deinterlace', None) or \ - _Cfunction('libvlc_video_set_deinterlace', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_deinterlace - libvlc_video_set_deinterlace = f - return f(p_mi, psz_mode) - -def libvlc_video_get_marquee_int(p_mi, option): - '''Get an integer marquee option value. - @param p_mi: libvlc media player. - @param option: marq option to get See libvlc_video_marquee_int_option_t. - ''' - f = _Cfunctions.get('libvlc_video_get_marquee_int', None) or \ - _Cfunction('libvlc_video_get_marquee_int', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_marquee_int - libvlc_video_get_marquee_int = f - return f(p_mi, option) - -def libvlc_video_get_marquee_string(p_mi, option): - '''Get a string marquee option value. - @param p_mi: libvlc media player. - @param option: marq option to get See libvlc_video_marquee_string_option_t. - ''' - f = _Cfunctions.get('libvlc_video_get_marquee_string', None) or \ - _Cfunction('libvlc_video_get_marquee_string', ((1,), (1,),), string_result, - ctypes.c_void_p, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_marquee_string - libvlc_video_get_marquee_string = f - return f(p_mi, option) - -def libvlc_video_set_marquee_int(p_mi, option, i_val): - '''Enable, disable or set an integer marquee option - Setting libvlc_marquee_Enable has the side effect of enabling (arg !0) - or disabling (arg 0) the marq filter. - @param p_mi: libvlc media player. - @param option: marq option to set See libvlc_video_marquee_int_option_t. - @param i_val: marq option value. - ''' - f = _Cfunctions.get('libvlc_video_set_marquee_int', None) or \ - _Cfunction('libvlc_video_set_marquee_int', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_marquee_int - libvlc_video_set_marquee_int = f - return f(p_mi, option, i_val) - -def libvlc_video_set_marquee_string(p_mi, option, psz_text): - '''Set a marquee string option. - @param p_mi: libvlc media player. - @param option: marq option to set See libvlc_video_marquee_string_option_t. - @param psz_text: marq option value. - ''' - f = _Cfunctions.get('libvlc_video_set_marquee_string', None) or \ - _Cfunction('libvlc_video_set_marquee_string', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_marquee_string - libvlc_video_set_marquee_string = f - return f(p_mi, option, psz_text) - -def libvlc_video_get_logo_int(p_mi, option): - '''Get integer logo option. - @param p_mi: libvlc media player instance. - @param option: logo option to get, values of libvlc_video_logo_option_t. - ''' - f = _Cfunctions.get('libvlc_video_get_logo_int', None) or \ - _Cfunction('libvlc_video_get_logo_int', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_logo_int - libvlc_video_get_logo_int = f - return f(p_mi, option) - -def libvlc_video_set_logo_int(p_mi, option, value): - '''Set logo option as integer. Options that take a different type value - are ignored. - Passing libvlc_logo_enable as option value has the side effect of - starting (arg !0) or stopping (arg 0) the logo filter. - @param p_mi: libvlc media player instance. - @param option: logo option to set, values of libvlc_video_logo_option_t. - @param value: logo option value. - ''' - f = _Cfunctions.get('libvlc_video_set_logo_int', None) or \ - _Cfunction('libvlc_video_set_logo_int', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_logo_int - libvlc_video_set_logo_int = f - return f(p_mi, option, value) - -def libvlc_video_set_logo_string(p_mi, option, psz_value): - '''Set logo option as string. Options that take a different type value - are ignored. - @param p_mi: libvlc media player instance. - @param option: logo option to set, values of libvlc_video_logo_option_t. - @param psz_value: logo option value. - ''' - f = _Cfunctions.get('libvlc_video_set_logo_string', None) or \ - _Cfunction('libvlc_video_set_logo_string', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_logo_string - libvlc_video_set_logo_string = f - return f(p_mi, option, psz_value) - -def libvlc_video_get_adjust_int(p_mi, option): - '''Get integer adjust option. - @param p_mi: libvlc media player instance. - @param option: adjust option to get, values of libvlc_video_adjust_option_t. - @version: LibVLC 1.1.1 and later. - ''' - f = _Cfunctions.get('libvlc_video_get_adjust_int', None) or \ - _Cfunction('libvlc_video_get_adjust_int', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_adjust_int - libvlc_video_get_adjust_int = f - return f(p_mi, option) - -def libvlc_video_set_adjust_int(p_mi, option, value): - '''Set adjust option as integer. Options that take a different type value - are ignored. - Passing libvlc_adjust_enable as option value has the side effect of - starting (arg !0) or stopping (arg 0) the adjust filter. - @param p_mi: libvlc media player instance. - @param option: adust option to set, values of libvlc_video_adjust_option_t. - @param value: adjust option value. - @version: LibVLC 1.1.1 and later. - ''' - f = _Cfunctions.get('libvlc_video_set_adjust_int', None) or \ - _Cfunction('libvlc_video_set_adjust_int', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_adjust_int - libvlc_video_set_adjust_int = f - return f(p_mi, option, value) - -def libvlc_video_get_adjust_float(p_mi, option): - '''Get float adjust option. - @param p_mi: libvlc media player instance. - @param option: adjust option to get, values of libvlc_video_adjust_option_t. - @version: LibVLC 1.1.1 and later. - ''' - f = _Cfunctions.get('libvlc_video_get_adjust_float', None) or \ - _Cfunction('libvlc_video_get_adjust_float', ((1,), (1,),), None, - ctypes.c_float, MediaPlayer, ctypes.c_uint) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_get_adjust_float - libvlc_video_get_adjust_float = f - return f(p_mi, option) - -def libvlc_video_set_adjust_float(p_mi, option, value): - '''Set adjust option as float. Options that take a different type value - are ignored. - @param p_mi: libvlc media player instance. - @param option: adust option to set, values of libvlc_video_adjust_option_t. - @param value: adjust option value. - @version: LibVLC 1.1.1 and later. - ''' - f = _Cfunctions.get('libvlc_video_set_adjust_float', None) or \ - _Cfunction('libvlc_video_set_adjust_float', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_uint, ctypes.c_float) - if not __debug__: # i.e. python -O or -OO - global libvlc_video_set_adjust_float - libvlc_video_set_adjust_float = f - return f(p_mi, option, value) - -def libvlc_audio_output_list_get(p_instance): - '''Get the list of available audio outputs. - @param p_instance: libvlc instance. - @return: list of available audio outputs. It must be freed it with In case of error, NULL is returned. - ''' - f = _Cfunctions.get('libvlc_audio_output_list_get', None) or \ - _Cfunction('libvlc_audio_output_list_get', ((1,),), None, - ctypes.POINTER(AudioOutput), Instance) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_list_get - libvlc_audio_output_list_get = f - return f(p_instance) - -def libvlc_audio_output_list_release(p_list): - '''Free the list of available audio outputs. - @param p_list: list with audio outputs for release. - ''' - f = _Cfunctions.get('libvlc_audio_output_list_release', None) or \ - _Cfunction('libvlc_audio_output_list_release', ((1,),), None, - None, ctypes.POINTER(AudioOutput)) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_list_release - libvlc_audio_output_list_release = f - return f(p_list) - -def libvlc_audio_output_set(p_mi, psz_name): - '''Set the audio output. - Change will be applied after stop and play. - @param p_mi: media player. - @param psz_name: name of audio output, use psz_name of See L{AudioOutput}. - @return: true if function succeded. - ''' - f = _Cfunctions.get('libvlc_audio_output_set', None) or \ - _Cfunction('libvlc_audio_output_set', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_set - libvlc_audio_output_set = f - return f(p_mi, psz_name) - -def libvlc_audio_output_device_count(p_instance, psz_audio_output): - '''Get count of devices for audio output, these devices are hardware oriented - like analor or digital output of sound card. - @param p_instance: libvlc instance. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @return: number of devices. - ''' - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_device_count - libvlc_audio_output_device_count = f - return f(p_instance, psz_audio_output) - -def libvlc_audio_output_device_longname(p_instance, psz_audio_output, i_device): - '''Get long name of device, if not available short name given. - @param p_instance: libvlc instance. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @param i_device: device index. - @return: long name of device. - ''' - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_device_longname - libvlc_audio_output_device_longname = f - return f(p_instance, psz_audio_output, i_device) - -def libvlc_audio_output_device_id(p_instance, psz_audio_output, i_device): - '''Get id name of device. - @param p_instance: libvlc instance. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @param i_device: device index. - @return: id name of device, use for setting device, need to be free after use. - ''' - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_device_id - libvlc_audio_output_device_id = f - return f(p_instance, psz_audio_output, i_device) - -def libvlc_audio_output_device_set(p_mi, psz_audio_output, psz_device_id): - '''Set audio output device. Changes are only effective after stop and play. - @param p_mi: media player. - @param psz_audio_output: - name of audio output, See L{AudioOutput}. - @param psz_device_id: device. - ''' - f = _Cfunctions.get('libvlc_audio_output_device_set', None) or \ - _Cfunction('libvlc_audio_output_device_set', ((1,), (1,), (1,),), None, - None, MediaPlayer, ctypes.c_char_p, ctypes.c_char_p) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_device_set - libvlc_audio_output_device_set = f - return f(p_mi, psz_audio_output, psz_device_id) - -def libvlc_audio_output_get_device_type(p_mi): - '''Get current audio device type. Device type describes something like - character of output sound - stereo sound, 2.1, 5.1 etc. - @param p_mi: media player. - @return: the audio devices type See libvlc_audio_output_device_types_t. - ''' - f = _Cfunctions.get('libvlc_audio_output_get_device_type', None) or \ - _Cfunction('libvlc_audio_output_get_device_type', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_get_device_type - libvlc_audio_output_get_device_type = f - return f(p_mi) - -def libvlc_audio_output_set_device_type(p_mi, device_type): - '''Set current audio device type. - @param p_mi: vlc instance. - @param device_type: the audio device type, - ''' - f = _Cfunctions.get('libvlc_audio_output_set_device_type', None) or \ - _Cfunction('libvlc_audio_output_set_device_type', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_output_set_device_type - libvlc_audio_output_set_device_type = f - return f(p_mi, device_type) - -def libvlc_audio_toggle_mute(p_mi): - '''Toggle mute status. - @param p_mi: media player. - ''' - f = _Cfunctions.get('libvlc_audio_toggle_mute', None) or \ - _Cfunction('libvlc_audio_toggle_mute', ((1,),), None, - None, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_toggle_mute - libvlc_audio_toggle_mute = f - return f(p_mi) - -def libvlc_audio_get_mute(p_mi): - '''Get current mute status. - @param p_mi: media player. - @return: the mute status (boolean). - ''' - f = _Cfunctions.get('libvlc_audio_get_mute', None) or \ - _Cfunction('libvlc_audio_get_mute', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_mute - libvlc_audio_get_mute = f - return f(p_mi) - -def libvlc_audio_set_mute(p_mi, status): - '''Set mute status. - @param p_mi: media player. - @param status: If status is true then mute, otherwise unmute. - ''' - f = _Cfunctions.get('libvlc_audio_set_mute', None) or \ - _Cfunction('libvlc_audio_set_mute', ((1,), (1,),), None, - None, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_set_mute - libvlc_audio_set_mute = f - return f(p_mi, status) - -def libvlc_audio_get_volume(p_mi): - '''Get current audio level. - @param p_mi: media player. - @return: the audio level (int). - ''' - f = _Cfunctions.get('libvlc_audio_get_volume', None) or \ - _Cfunction('libvlc_audio_get_volume', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_volume - libvlc_audio_get_volume = f - return f(p_mi) - -def libvlc_audio_set_volume(p_mi, i_volume): - '''Set current audio level. - @param p_mi: media player. - @param i_volume: the volume (int). - @return: 0 if the volume was set, -1 if it was out of range. - ''' - f = _Cfunctions.get('libvlc_audio_set_volume', None) or \ - _Cfunction('libvlc_audio_set_volume', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_set_volume - libvlc_audio_set_volume = f - return f(p_mi, i_volume) - -def libvlc_audio_get_track_count(p_mi): - '''Get number of available audio tracks. - @param p_mi: media player. - @return: the number of available audio tracks (int), or -1 if unavailable. - ''' - f = _Cfunctions.get('libvlc_audio_get_track_count', None) or \ - _Cfunction('libvlc_audio_get_track_count', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_track_count - libvlc_audio_get_track_count = f - return f(p_mi) - -def libvlc_audio_get_track_description(p_mi): - '''Get the description of available audio tracks. - @param p_mi: media player. - @return: list with description of available audio tracks, or NULL. - ''' - f = _Cfunctions.get('libvlc_audio_get_track_description', None) or \ - _Cfunction('libvlc_audio_get_track_description', ((1,),), None, - ctypes.POINTER(TrackDescription), MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_track_description - libvlc_audio_get_track_description = f - return f(p_mi) - -def libvlc_audio_get_track(p_mi): - '''Get current audio track. - @param p_mi: media player. - @return: the audio track (int), or -1 if none. - ''' - f = _Cfunctions.get('libvlc_audio_get_track', None) or \ - _Cfunction('libvlc_audio_get_track', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_track - libvlc_audio_get_track = f - return f(p_mi) - -def libvlc_audio_set_track(p_mi, i_track): - '''Set current audio track. - @param p_mi: media player. - @param i_track: the track (int). - @return: 0 on success, -1 on error. - ''' - f = _Cfunctions.get('libvlc_audio_set_track', None) or \ - _Cfunction('libvlc_audio_set_track', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_set_track - libvlc_audio_set_track = f - return f(p_mi, i_track) - -def libvlc_audio_get_channel(p_mi): - '''Get current audio channel. - @param p_mi: media player. - @return: the audio channel See libvlc_audio_output_channel_t. - ''' - f = _Cfunctions.get('libvlc_audio_get_channel', None) or \ - _Cfunction('libvlc_audio_get_channel', ((1,),), None, - ctypes.c_int, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_channel - libvlc_audio_get_channel = f - return f(p_mi) - -def libvlc_audio_set_channel(p_mi, channel): - '''Set current audio channel. - @param p_mi: media player. - @param channel: the audio channel, See libvlc_audio_output_channel_t. - @return: 0 on success, -1 on error. - ''' - f = _Cfunctions.get('libvlc_audio_set_channel', None) or \ - _Cfunction('libvlc_audio_set_channel', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_int) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_set_channel - libvlc_audio_set_channel = f - return f(p_mi, channel) - -def libvlc_audio_get_delay(p_mi): - '''Get current audio delay. - @param p_mi: media player. - @return: the audio delay (microseconds). - @version: LibVLC 1.1.1 or later. - ''' - f = _Cfunctions.get('libvlc_audio_get_delay', None) or \ - _Cfunction('libvlc_audio_get_delay', ((1,),), None, - ctypes.c_int64, MediaPlayer) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_get_delay - libvlc_audio_get_delay = f - return f(p_mi) - -def libvlc_audio_set_delay(p_mi, i_delay): - '''Set current audio delay. The audio delay will be reset to zero each time the media changes. - @param p_mi: media player. - @param i_delay: the audio delay (microseconds). - @return: 0 on success, -1 on error. - @version: LibVLC 1.1.1 or later. - ''' - f = _Cfunctions.get('libvlc_audio_set_delay', None) or \ - _Cfunction('libvlc_audio_set_delay', ((1,), (1,),), None, - ctypes.c_int, MediaPlayer, ctypes.c_int64) - if not __debug__: # i.e. python -O or -OO - global libvlc_audio_set_delay - libvlc_audio_set_delay = f - return f(p_mi, i_delay) - -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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_release - libvlc_vlm_release = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_add_broadcast - libvlc_vlm_add_broadcast = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_add_vod - libvlc_vlm_add_vod = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_del_media - libvlc_vlm_del_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_set_enabled - libvlc_vlm_set_enabled = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_set_output - libvlc_vlm_set_output = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_set_input - libvlc_vlm_set_input = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_add_input - libvlc_vlm_add_input = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_set_loop - libvlc_vlm_set_loop = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_set_mux - libvlc_vlm_set_mux = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_change_media - libvlc_vlm_change_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_play_media - libvlc_vlm_play_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_stop_media - libvlc_vlm_stop_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_pause_media - libvlc_vlm_pause_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_seek_media - libvlc_vlm_seek_media = f - 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 NULL 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_show_media - libvlc_vlm_show_media = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_position - libvlc_vlm_get_media_instance_position = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_time - libvlc_vlm_get_media_instance_time = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_length - libvlc_vlm_get_media_instance_length = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_rate - libvlc_vlm_get_media_instance_rate = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_title - libvlc_vlm_get_media_instance_title = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_chapter - libvlc_vlm_get_media_instance_chapter = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_media_instance_seekable - libvlc_vlm_get_media_instance_seekable = f - 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) - if not __debug__: # i.e. python -O or -OO - global libvlc_vlm_get_event_manager - libvlc_vlm_get_event_manager = f - return f(p_instance) - - -# 5 function(s) blacklisted: -# libvlc_audio_set_callbacks -# libvlc_audio_set_format_callbacks -# libvlc_set_exit_handler -# libvlc_video_set_callbacks -# libvlc_video_set_format_callbacks - -# 12 function(s) not wrapped as methods: -# libvlc_audio_output_list_release -# libvlc_clearerr -# libvlc_clock -# libvlc_errmsg -# libvlc_event_type_name -# libvlc_free -# libvlc_get_changeset -# libvlc_get_compiler -# libvlc_get_version -# libvlc_module_description_list_release -# libvlc_new -# libvlc_track_description_release - -# Start of footer.py # - -# Backward compatibility -def callbackmethod(callback): - """Now obsolete @callbackmethod decorator.""" - return callback - -# libvlc_free is not present in some versions of libvlc. If it is not -# in the library, then emulate it by calling libc.free -if not hasattr(dll, 'libvlc_free'): - # need to find the free function in the C runtime. This is - # platform specific. - # For Linux and MacOSX - libc_path = find_library('c') - if libc_path: - libc = ctypes.CDLL(libc_path) - libvlc_free = libc.free - else: - # On win32, it is impossible to guess the proper lib to call - # (msvcrt, mingw...). Just ignore the call: it will memleak, - # but not prevent to run the application. - def libvlc_free(p): - pass - - # ensure argtypes is right, because default type of int won't work - # on 64-bit systems - libvlc_free.argtypes = [ ctypes.c_void_p ] - -# Version functions -def _dot2int(v): - '''(INTERNAL) Convert 'i.i.i[.i]' str to int. - ''' - t = [int(i) for i in v.split('.')] - if len(t) == 3: - t.append(0) - elif len(t) != 4: - raise ValueError('"i.i.i[.i]": %r' % (v,)) - if min(t) < 0 or max(t) > 255: - raise ValueError('[0..255]: %r' % (v,)) - i = t.pop(0) - while t: - i = (i << 8) + t.pop(0) - return i - -def hex_version(): - """Return the version of these bindings in hex or 0 if unavailable. - """ - try: - return _dot2int(__version__.split('-')[-1]) - except (NameError, ValueError): - return 0 - -def libvlc_hex_version(): - """Return the libvlc version in hex or 0 if unavailable. - """ - try: - return _dot2int(libvlc_get_version().split()[0]) - except ValueError: - return 0 - - -def debug_callback(event, *args, **kwds): - '''Example callback, useful for debugging. - ''' - l = ['event %s' % (event.type,)] - if args: - l.extend(map(str, args)) - if kwds: - l.extend(sorted('%s=%s' % t for t in kwds.items())) - print('Debug callback (%s)' % ', '.join(l)) - -if __name__ == '__main__': - - try: - from msvcrt import getch - except ImportError: - import termios - import tty - - def getch(): # getchar(), getc(stdin) #PYCHOK flake - fd = sys.stdin.fileno() - old = termios.tcgetattr(fd) - try: - tty.setraw(fd) - ch = sys.stdin.read(1) - finally: - termios.tcsetattr(fd, termios.TCSADRAIN, old) - return ch - - def end_callback(event): - print('End of media stream (event %s)' % event.type) - sys.exit(0) - - echo_position = False - def pos_callback(event, player): - if echo_position: - sys.stdout.write('\r%s to %.2f%% (%.2f%%)' % (event.type, - event.u.new_position * 100, - player.get_position() * 100)) - sys.stdout.flush() - - def print_version(): - """Print libvlc version""" - try: - print('Build date: %s (%#x)' % (build_date, hex_version())) - print('LibVLC version: %s (%#x)' % (libvlc_get_version(), libvlc_hex_version())) - print('LibVLC compiler: %s' % libvlc_get_compiler()) - if plugin_path: - print('Plugin path: %s' % plugin_path) - except: - print('Error: %s' % sys.exc_info()[1]) - - if sys.argv[1:] and sys.argv[1] not in ('-h', '--help'): - - movie = os.path.expanduser(sys.argv[1]) - if not os.access(movie, os.R_OK): - print('Error: %s file not readable' % movie) - sys.exit(1) - - instance = Instance() - try: - media = instance.media_new(movie, 'sub-filter=marq') # load marqee option - except NameError: - print('NameError: %s (%s vs LibVLC %s)' % (sys.exc_info()[1], - __version__, - libvlc_get_version())) - sys.exit(1) - player = instance.media_player_new() - player.set_media(media) - player.play() - - # Some marquee examples. Marquee requires 'sub-filter=marq' in the - # media_new() call above. See also the Media.add_options method - # and - player.video_set_marquee_int(VideoMarqueeOption.Enable, 1) - player.video_set_marquee_int(VideoMarqueeOption.Size, 24) # pixels - player.video_set_marquee_int(VideoMarqueeOption.Position, Position.Bottom) - if True: # only one marquee can be specified - player.video_set_marquee_int(VideoMarqueeOption.Timeout, 5000) # millisec, 0==forever - t = media.get_mrl() # movie - else: # update marquee text periodically - player.video_set_marquee_int(VideoMarqueeOption.Timeout, 0) # millisec, 0==forever - player.video_set_marquee_int(VideoMarqueeOption.Refresh, 1000) # millisec (or sec?) - ##t = '$L / $D or $P at $T' - t = '%Y-%m-%d %H:%M:%S' - player.video_set_marquee_string(VideoMarqueeOption.Text, t) - - # Some event manager examples. Note, the callback can be any Python - # callable and does not need to be decorated. Optionally, specify - # any number of positional and/or keyword arguments to be passed - # to the callback (in addition to the first one, an Event instance). - event_manager = player.event_manager() - event_manager.event_attach(EventType.MediaPlayerEndReached, end_callback) - event_manager.event_attach(EventType.MediaPlayerPositionChanged, pos_callback, player) - - def mspf(): - """Milliseconds per frame.""" - return int(1000 // (player.get_fps() or 25)) - - def print_info(): - """Print information about the media""" - try: - print_version() - media = player.get_media() - print('State: %s' % player.get_state()) - print('Media: %s' % media.get_mrl()) - print('Track: %s/%s' % (player.video_get_track(), player.video_get_track_count())) - print('Current time: %s/%s' % (player.get_time(), media.get_duration())) - print('Position: %s' % player.get_position()) - print('FPS: %s (%d ms)' % (player.get_fps(), mspf())) - print('Rate: %s' % player.get_rate()) - print('Video size: %s' % str(player.video_get_size(0))) # num=0 - print('Scale: %s' % player.video_get_scale()) - print('Aspect ratio: %s' % player.video_get_aspect_ratio()) - #print('Window:' % player.get_hwnd() - except Exception: - print('Error: %s', sys.exc_info()[1]) - - def sec_forward(): - """Go forward one sec""" - player.set_time(player.get_time() + 1000) - - def sec_backward(): - """Go backward one sec""" - player.set_time(player.get_time() - 1000) - - def frame_forward(): - """Go forward one frame""" - player.set_time(player.get_time() + mspf()) - - def frame_backward(): - """Go backward one frame""" - player.set_time(player.get_time() - mspf()) - - def print_help(): - """Print help""" - print('Single-character commands:') - for k, m in sorted(keybindings.items()): - m = (m.__doc__ or m.__name__).splitlines()[0] - print(' %s: %s.' % (k, m.rstrip('.'))) - print('0-9: go to that fraction of the movie') - - def quit_app(): - """Stop and exit""" - sys.exit(0) - - def toggle_echo_position(): - """Toggle echoing of media position""" - global echo_position - echo_position = not echo_position - - keybindings = { - ' ': player.pause, - '+': sec_forward, - '-': sec_backward, - '.': frame_forward, - ',': frame_backward, - 'f': player.toggle_fullscreen, - 'i': print_info, - 'p': toggle_echo_position, - 'q': quit_app, - '?': print_help, - } - - print('Press q to quit, ? to get help.%s' % os.linesep) - while True: - k = getch().decode('utf8') # Python 3+ - print('> %s' % k) - if k in keybindings: - keybindings[k]() - elif k.isdigit(): - # jump to fraction of the movie. - player.set_position(float('0.'+k)) - - else: - print('Usage: %s ' % sys.argv[0]) - print('Once launched, type ? for help.') - print('') - print_version() diff --git a/openlp/plugins/media/lib/vlcapi.py b/openlp/plugins/media/lib/vlcapi.py deleted file mode 100644 index 7531ba394..000000000 --- a/openlp/plugins/media/lib/vlcapi.py +++ /dev/null @@ -1,198 +0,0 @@ -#!/usr/bin/env python -# -*- coding: utf-8 -*- -# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4 - -############################################################################### -# OpenLP - Open Source Lyrics Projection # -# --------------------------------------------------------------------------- # -# Copyright (c) 2008-2011 Raoul Snyman # -# Portions copyright (c) 2008-2011 Tim Bentley, Jonathan Corwin, Michael # -# Gorven, Scott Guerrieri, Matthias Hub, Meinert Jordan, Armin Köhler, # -# Andreas Preikschat, Mattias Põldaru, Christian Richter, Philip Ridout, # -# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Frode Woldsund # -# --------------------------------------------------------------------------- # -# 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; version 2 of the License. # -# # -# 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., 59 # -# Temple Place, Suite 330, Boston, MA 02111-1307 USA # -############################################################################### - -import logging -import sys, os -from datetime import datetime -try: - import vlc -except: - pass -from PyQt4 import QtCore, QtGui -from openlp.core.lib import Receiver -from openlp.plugins.media.lib import MediaAPI, MediaState - -log = logging.getLogger(__name__) - -class VlcAPI(MediaAPI): - """ - Specialiced MediaAPI class - to reflect Features of the Vlc API - """ - def __init__(self, parent): - MediaAPI.__init__(self, parent) - self.parent = parent - self.video_extensions_list = [ - u'*.3gp' - , u'*.asf', u'*.wmv' - , u'*.au' - , u'*.avi' - , u'*.flv' - , u'*.mov' - , u'*.mp4' - , u'*.ogm', u'*.ogg' - , u'*.mkv', u'*.mka' - , u'*.ts', u'*.mpg' - , u'*.mpg', u'*.mp3', u'*.mp2' - , u'*.nsc' - , u'*.nsv' - , u'*.nut' - , u'*.ra', u'*.ram', u'*.rm', u'*.rv' ,u'*.rmbv' - , u'*.a52', u'*.dts', u'*.aac', u'*.flac' ,u'*.dv', u'*.vid' - , u'*.tta', u'*.tac' - , u'*.ty' - , u'*.wav', u'*.dts' - , u'*.xa' - , u'*.iso' - ] - - def setup_controls(self, controller, control_panel): - pass - - def setup(self, display): - display.vlcWidget = QtGui.QFrame(display) - # creating a basic vlc instance - if display.hasAudio: - display.vlcInstance = vlc.Instance() - else: - display.vlcInstance = vlc.Instance('--no-audio') - display.vlcInstance.set_log_verbosity(2) - # creating an empty vlc media player - display.vlcMediaPlayer = display.vlcInstance.media_player_new() - display.vlcWidget.resize(display.size()) - display.vlcWidget.raise_() - display.vlcWidget.hide() - # 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 == "linux2": # for Linux using the X Server - display.vlcMediaPlayer.set_xwindow(int(display.vlcWidget.winId())) - elif sys.platform == "win32": # for Windows - display.vlcMediaPlayer.set_hwnd(int(display.vlcWidget.winId())) - elif sys.platform == "darwin": # for MacOS - display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) - self.hasOwnWidget = True - - @staticmethod - def is_available(): - try: - import vlc - return True - except: - return False - - def get_supported_file_types(self): - self.supported_file_types = ['avi'] - self.additional_extensions = { - u'audio/ac3': [u'.ac3'], - u'audio/flac': [u'.flac'], - u'audio/x-m4a': [u'.m4a'], - u'audio/midi': [u'.mid', u'.midi'], - u'audio/x-mp3': [u'.mp3'], - u'audio/mpeg': [u'.mp3', u'.mp2', u'.mpga', u'.mpega', u'.m4a'], - u'audio/qcelp': [u'.qcp'], - u'audio/x-wma': [u'.wma'], - u'audio/x-ms-wma': [u'.wma'], - u'video/x-flv': [u'.flv'], - u'video/x-matroska': [u'.mpv', u'.mkv'], - u'video/x-wmv': [u'.wmv'], - u'video/x-ms-wmv': [u'.wmv']} - - def load(self, display): - log.debug(u'load vid in Vlc Controller') - controller = display.controller - volume = controller.media_info.volume - file_path = str( - controller.media_info.file_info.absoluteFilePath().toUtf8()) - path = os.path.normcase(file_path) - # create the media - display.vlcMedia = display.vlcInstance.media_new_path(path) - # put the media in the media player - display.vlcMediaPlayer.set_media(display.vlcMedia) - # parse the metadata of the file - display.vlcMedia.parse() - return True - - def mediaStateWait(self, display, mediaState): - """ - Wait for the video to change its state - Wait no longer than 5 seconds. - """ - start = datetime.now() - while not mediaState == display.vlcMedia.get_state(): - if display.vlcMedia.get_state() == vlc.State.Error: - return False - Receiver.send_message(u'openlp_process_events') - if (datetime.now() - start).seconds > 5: - return False - return True - - def resize(self, display): - display.vlcWidget.resize(display.size()) - - def play(self, display): - self.set_visible(display, True) - display.vlcMediaPlayer.play() - if self.mediaStateWait(display, vlc.State.Playing): - self.state = MediaState.Playing - - def pause(self, display): - display.vlcMediaPlayer.pause() - if self.mediaStateWait(display, vlc.State.Paused): - self.state = MediaState.Paused - - def stop(self, display): - display.vlcMediaPlayer.stop() - self.state = MediaState.Stopped - - def volume(self, display, vol): - display.vlcMediaPlayer.audio_set_volume(vol) - - def seek(self, display, seekVal): - if display.vlcMediaPlayer.is_seekable(): - display.vlcMediaPlayer.set_position(seekVal/1000.0) - - def reset(self, display): - display.vlcMediaPlayer.stop() - display.vlcWidget.setVisible(False) - self.state = MediaState.Off - - def set_visible(self, display, status): - if self.hasOwnWidget: - display.vlcWidget.setVisible(status) - - def update_ui(self, display): - controller = display.controller - controller.seekSlider.setMaximum(1000) - if not controller.seekSlider.isSliderDown(): - currentPos = display.vlcMediaPlayer.get_position() * 1000 - controller.seekSlider.setSliderPosition(currentPos) - - def get_supported_file_types(self): - pass From 592af0e181cf945092826002ccffd0fc8bc30bcc Mon Sep 17 00:00:00 2001 From: "rimach crichter@web.de" Date: Wed, 8 Jun 2011 15:18:05 +0200 Subject: [PATCH 12/41] bugfixing --- openlp/core/lib/htmlbuilder.py | 177 +++------------------ openlp/core/lib/plugin.py | 18 +++ openlp/core/ui/maindisplay.py | 13 +- openlp/core/ui/slidecontroller.py | 5 +- openlp/plugins/media/lib/__init__.py | 33 +++- openlp/plugins/media/lib/mediaitem.py | 6 +- openlp/plugins/media/lib/mediamanager.py | 38 +++-- openlp/plugins/media/lib/mediatab.py | 84 +++++----- openlp/plugins/media/lib/phononapi.py | 11 +- openlp/plugins/media/lib/vlcapi.py | 17 +- openlp/plugins/media/lib/webkitapi.py | 188 ++++++++++++++++++++++- openlp/plugins/media/mediaplugin.py | 72 ++++++++- 12 files changed, 417 insertions(+), 245 deletions(-) diff --git a/openlp/core/lib/htmlbuilder.py b/openlp/core/lib/htmlbuilder.py index e7c6c7ddd..62395b4ab 100644 --- a/openlp/core/lib/htmlbuilder.py +++ b/openlp/core/lib/htmlbuilder.py @@ -66,6 +66,7 @@ body { #image { z-index:2; } +%s #video1 { z-index:3; } @@ -98,97 +99,8 @@ sup { - - - +%s %s
@@ -397,7 +242,7 @@ sup { """ -def build_html(item, screen, alert, islive, background, image=None): +def build_html(item, screen, alert, islive, background, plugins=None, image=None): """ Build the full web paged structure for display @@ -416,6 +261,9 @@ def build_html(item, screen, alert, islive, background, image=None): ``background`` Theme background image - bytes + ``plugins`` + access to the plugins + ``image`` Image media item - bytes """ @@ -434,14 +282,25 @@ def build_html(item, screen, alert, islive, background, image=None): image_src = u'src="data:image/png;base64,%s"' % image else: image_src = u'style="display:none;"' + plugin_css = u'' + plugin_js = u'' + plugin_html = u'' + if plugins: + for plugin in plugins: + plugin_css += plugin.display_css() + plugin_js += plugin.display_javascript() + plugin_html += plugin.display_html() html = HTMLSRC % (build_background_css(item, width, height), width, height, + plugin_css, build_alert_css(alert, width), build_footer_css(item, height), build_lyrics_css(item, webkitvers), u'true' if theme and theme.display_slide_transition and islive \ else u'false', + plugin_js, bgimage_src, image_src, + plugin_html, build_lyrics_html(item, webkitvers)) return html diff --git a/openlp/core/lib/plugin.py b/openlp/core/lib/plugin.py index d92464cdc..e81aae46d 100644 --- a/openlp/core/lib/plugin.py +++ b/openlp/core/lib/plugin.py @@ -374,3 +374,21 @@ class Plugin(QtCore.QObject): after this has been set. """ self.textStrings[name] = {u'title': title, u'tooltip': tooltip} + + def display_css(self): + """ + Add css style sheets to htmlbuilder + """ + return u'' + + def display_javascript(self): + """ + Add javascript functions to htmlbuilder + """ + return u'' + + def display_html(self): + """ + Add html code to htmlbuilder + """ + return u'' diff --git a/openlp/core/ui/maindisplay.py b/openlp/core/ui/maindisplay.py index 5987764b6..d054f78bd 100644 --- a/openlp/core/ui/maindisplay.py +++ b/openlp/core/ui/maindisplay.py @@ -56,18 +56,22 @@ class Display(QtGui.QGraphicsView): """ Set up and build the preview screen """ +# self.setGeometry(0, 0, +# self.parent().width(), self.parent().height()) self.webView = QtWebKit.QWebView(self) self.webView.setGeometry(0, 0, self.parent().width(), self.parent().height()) - self.webView.settings().setAttribute(QtWebKit.QWebSettings.PluginsEnabled, True) + self.webView.settings().setAttribute( + QtWebKit.QWebSettings.PluginsEnabled, True) self.page = self.webView.page() self.frame = self.page.mainFrame() screen = {} screen[u'size'] = self.size() serviceItem = ServiceItem() self.webView.setHtml(build_html(serviceItem, screen, - None, None, None)) + None, None, None, self.controller.parent().pluginManager.plugins)) self.webView.hide() + #self.hide() class MainDisplay(QtGui.QGraphicsView): """ @@ -158,7 +162,8 @@ class MainDisplay(QtGui.QGraphicsView): serviceItem = ServiceItem() serviceItem.bg_image_bytes = image_to_byte(self.initialFrame) self.webView.setHtml(build_html(serviceItem, self.screen, - self.alertTab, self.isLive, None)) + self.alertTab, self.isLive, None, + self.controller.parent().pluginManager.plugins)) self.__hideMouse() # To display or not to display? if not self.screen[u'primary']: @@ -350,7 +355,7 @@ class MainDisplay(QtGui.QGraphicsView): else: image_bytes = None html = build_html(self.serviceItem, self.screen, self.alertTab, - self.isLive, background, image_bytes) + self.isLive, background, self.controller.parent().pluginManager.plugins, image_bytes) log.debug(u'buildHtml - pre setHtml') self.webView.setHtml(html) log.debug(u'buildHtml - post setHtml') diff --git a/openlp/core/ui/slidecontroller.py b/openlp/core/ui/slidecontroller.py index 678f16cf7..e5420f0fe 100644 --- a/openlp/core/ui/slidecontroller.py +++ b/openlp/core/ui/slidecontroller.py @@ -62,7 +62,6 @@ class SlideController(QtGui.QWidget): self.screens = ScreenList.get_instance() self.ratio = float(self.screens.current[u'size'].width()) / \ float(self.screens.current[u'size'].height()) - #self.display = None#MainDisplay(self, self, self.screens, isLive) self.image_manager = self.parent().image_manager self.loopList = [ u'Play Slides Menu', @@ -334,7 +333,7 @@ class SlideController(QtGui.QWidget): def getControlPanel(self): return self.controllerLayout - def sendToPlugins(self, v1=None, v2=None, v3=None, v4=None, v5=None): + def sendToPlugins(self, **kwargs): """ This is the generic function to send signal for control widgets, created from within other plugins @@ -342,7 +341,7 @@ class SlideController(QtGui.QWidget): """ sender = self.sender().objectName() or self.sender().text() controller = self - Receiver.send_message('%s' % sender, [controller, v1, v2, v3, v4, v5]) + Receiver.send_message('%s' % sender, [controller, kwargs]) def setPreviewHotkeys(self, parent=None): self.previousItem.setObjectName(u'previousItemPreview') diff --git a/openlp/plugins/media/lib/__init__.py b/openlp/plugins/media/lib/__init__.py index 8b56a6bc9..1855e4c08 100644 --- a/openlp/plugins/media/lib/__init__.py +++ b/openlp/plugins/media/lib/__init__.py @@ -25,7 +25,7 @@ # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### -class MediaAPIs(object): +class MediaAPI(object): """ An enumeration for possible APIs. """ @@ -71,8 +71,10 @@ class MediaAPI(object): Specialiced Media API class to reflect Features of the related API """ - def __init__(self, parent): + def __init__(self, parent, name=u'MediaApi'): self.parent = parent + self.name = name + self.available = self.check_available() self.isActive = False self.canBackground = False self.state = MediaState.Off @@ -80,6 +82,13 @@ class MediaAPI(object): self.audio_extensions_list = [] self.video_extensions_list = [] + def check_available(self): + """ + API is available on this machine + """ + return False + + def setup(self, display): """ Create the related widgets for the current display @@ -164,6 +173,26 @@ class MediaAPI(object): """ pass + def display_css(self): + """ + Add css style sheets to htmlbuilder + """ + return u'' + + + def display_javascript(self): + """ + Add javascript functions to htmlbuilder + """ + return u'' + + + def display_html(self): + """ + Add html code to htmlbuilder + """ + return u'' + from mediaitem import MediaMediaItem from mediatab import MediaTab from mediamanager import MediaManager diff --git a/openlp/plugins/media/lib/mediaitem.py b/openlp/plugins/media/lib/mediaitem.py index 5aeca1e92..ba6d0b9c6 100644 --- a/openlp/plugins/media/lib/mediaitem.py +++ b/openlp/plugins/media/lib/mediaitem.py @@ -92,7 +92,7 @@ class MediaMediaItem(MediaManagerItem): """ self.resetAction.setVisible(False) Receiver.send_message(u'media_reset', - self.parent.liveController) + self.plugin.liveController) def videobackgroundReplaced(self): """ @@ -112,7 +112,7 @@ class MediaMediaItem(MediaManagerItem): if os.path.exists(filename): (path, name) = os.path.split(filename) Receiver.send_message(u'media_video', - [self.parent.liveController, filename, 0, True]) + [self.plugin.liveController, filename, 0, True]) self.resetAction.setVisible(True) else: critical_error_message_box(UiStrings().LiveBGError, @@ -139,7 +139,7 @@ class MediaMediaItem(MediaManagerItem): ItemCapabilities.AllowsVariableStartTime) service_item.title = unicode(self.plugin.nameStrings[u'singular']) service_item.add_capability(ItemCapabilities.RequiresMedia) - #Receiver.send_message(u'media_video', [self.parent.liveController, filename, False]) + #Receiver.send_message(u'media_video', [self.plugin.liveController, filename, False]) # force a non-existent theme service_item.theme = -1 frame = u':/media/image_clapperboard.png' diff --git a/openlp/plugins/media/lib/mediamanager.py b/openlp/plugins/media/lib/mediamanager.py index 1e9a4c123..3bf4355ae 100644 --- a/openlp/plugins/media/lib/mediamanager.py +++ b/openlp/plugins/media/lib/mediamanager.py @@ -63,13 +63,6 @@ class MediaManager(object): self.APIs = {} self.controller = [] self.curDisplayMediaAPI = {} - #Create API Controllers - if WebkitAPI.is_available(): - self.APIs[u'Webkit'] = WebkitAPI(self) - if PhononAPI.is_available(): - self.APIs[u'Phonon'] = PhononAPI(self) - if VlcAPI.is_available(): - self.APIs[u'Vlc'] = VlcAPI(self) #Timer for video state self.Timer = QtCore.QTimer() self.Timer.setInterval(200) @@ -117,6 +110,33 @@ class MediaManager(object): if not isAnyonePlaying: self.Timer.stop() + def display_css(self): + """ + Add css style sheets to htmlbuilder + """ + css = u''; + for api in self.APIs.values(): + css+= api.display_css() + return css + + def display_javascript(self): + """ + Add javascript functions to htmlbuilder + """ + js = u'' + for api in self.APIs.values(): + js+= api.display_javascript() + return js + + def display_html(self): + """ + Add html code to htmlbuilder + """ + html = u'' + for api in self.APIs.values(): + html+= api.display_html() + return html + def addControllerItems(self, controller, control_panel): self.controller.append(controller) self.setup_generic_controls(controller, control_panel) @@ -133,11 +153,11 @@ class MediaManager(object): controller.sendToPlugins) controller.mediabar.addToolbarButton( u'Media Pause', u':/slides/media_playback_pause.png', - translate('OpenLP.SlideController', 'Start playing media'), + translate('OpenLP.SlideController', 'Pause playing media'), controller.sendToPlugins) controller.mediabar.addToolbarButton( u'Media Stop', u':/slides/media_playback_stop.png', - translate('OpenLP.SlideController', 'Start playing media'), + translate('OpenLP.SlideController', 'Stop playing media'), controller.sendToPlugins) # Build the seekSlider. controller.seekSlider = QtGui.QSlider(QtCore.Qt.Horizontal) diff --git a/openlp/plugins/media/lib/mediatab.py b/openlp/plugins/media/lib/mediatab.py index f0a33130b..97e9c6250 100644 --- a/openlp/plugins/media/lib/mediatab.py +++ b/openlp/plugins/media/lib/mediatab.py @@ -33,23 +33,26 @@ class MediaTab(SettingsTab): """ MediaTab is the Media settings tab in the settings dialog. """ - def __init__(self, parent, title, visible_title, icon_path): + def __init__(self, parent, title, visible_title, apis, icon_path): + self.apis = apis SettingsTab.__init__(self, parent, title, visible_title, icon_path) def setupUi(self): self.setObjectName(u'MediaTab') SettingsTab.setupUi(self) - self.mediaAPIsGroupBox = QtGui.QGroupBox(self.leftColumn) - self.mediaAPIsGroupBox.setObjectName(u'mediaAPIsGroupBox') - self.mediaApiLayout = QtGui.QVBoxLayout(self.mediaAPIsGroupBox) + self.mediaAPIGroupBox = QtGui.QGroupBox(self.leftColumn) + self.mediaAPIGroupBox.setObjectName(u'mediaAPIGroupBox') + self.mediaApiLayout = QtGui.QVBoxLayout(self.mediaAPIGroupBox) self.mediaApiLayout.setObjectName(u'mediaApiLayout') - self.usePhononCheckBox = QtGui.QCheckBox(self.mediaAPIsGroupBox) - self.usePhononCheckBox.setObjectName(u'usePhononCheckBox') - self.mediaApiLayout.addWidget(self.usePhononCheckBox) - self.useVlcCheckBox = QtGui.QCheckBox(self.mediaAPIsGroupBox) - self.useVlcCheckBox.setObjectName(u'useVlcCheckBox') - self.mediaApiLayout.addWidget(self.useVlcCheckBox) - self.leftLayout.addWidget(self.mediaAPIsGroupBox) + self.ApiCheckBoxes = {} + for key in self.apis: + api = self.apis[key] + checkbox = QtGui.QCheckBox(self.mediaAPIGroupBox) + checkbox.setEnabled(api.available) + checkbox.setObjectName(api.name + u'CheckBox') + self.ApiCheckBoxes[api.name] = checkbox + self.mediaApiLayout.addWidget(checkbox) + self.leftLayout.addWidget(self.mediaAPIGroupBox) self.apiOrderGroupBox = QtGui.QGroupBox(self.leftColumn) self.apiOrderGroupBox.setObjectName(u'apiOrderGroupBox') @@ -87,24 +90,30 @@ class MediaTab(SettingsTab): self.leftLayout.addWidget(self.apiOrderGroupBox) self.leftLayout.addStretch() self.rightLayout.addStretch() - QtCore.QObject.connect(self.usePhononCheckBox, - QtCore.SIGNAL(u'stateChanged(int)'), - self.onUsePhononCheckBoxChanged) - QtCore.QObject.connect(self.useVlcCheckBox, - QtCore.SIGNAL(u'stateChanged(int)'), - self.onUseVlcCheckBoxChanged) + for key in self.apis: + api = self.apis[key] + checkbox = self.ApiCheckBoxes[api.name] + QtCore.QObject.connect(checkbox, + QtCore.SIGNAL(u'stateChanged(int)'), + self.onApiCheckBoxChanged) + QtCore.QObject.connect(self.orderingUpButton, QtCore.SIGNAL(u'pressed()'), self.onOrderingUpButtonPressed) QtCore.QObject.connect(self.orderingDownButton, QtCore.SIGNAL(u'pressed()'), self.onOrderingDownButtonPressed) def retranslateUi(self): - self.mediaAPIsGroupBox.setTitle( + self.mediaAPIGroupBox.setTitle( translate('MediaPlugin.MediaTab', 'Media APIs')) - self.usePhononCheckBox.setText( - translate('MediaPlugin.MediaTab', 'use Phonon')) - self.useVlcCheckBox.setText( - translate('MediaPlugin.MediaTab', 'use Vlc')) + for key in self.apis: + api = self.apis[key] + checkbox = self.ApiCheckBoxes[api.name] + if api.available: + checkbox.setText(api.name) + else: + checkbox.setText( + unicode(translate('MediaPlugin.MediaTab', + '%s (unavailable)')) % api.name) self.apiOrderGroupBox.setTitle( translate('MediaPlugin.MediaTab', 'API Order')) self.orderingDownButton.setText( @@ -112,24 +121,13 @@ class MediaTab(SettingsTab): self.orderingUpButton.setText( translate('MediaPlugin.MediaTab', 'Up')) - def onUsePhononCheckBoxChanged(self, check_state): + def onApiCheckBoxChanged(self, check_state): + api = self.sender().text() if check_state == QtCore.Qt.Checked: - self.usePhonon = True - if u'Phonon' not in self.usedAPIs: - self.usedAPIs.append(u'Phonon') + if api not in self.usedAPIs: + self.usedAPIs.append(api) else: - self.usePhonon = False - self.usedAPIs.takeAt(self.usedAPIs.indexOf(u'Phonon')) - self.updateApiList() - - def onUseVlcCheckBoxChanged(self, check_state): - if check_state == QtCore.Qt.Checked: - self.useVlc = True - if u'Vlc' not in self.usedAPIs: - self.usedAPIs.append(u'Vlc') - else: - self.useVlc = False - self.usedAPIs.takeAt(self.usedAPIs.indexOf(u'Vlc')) + self.usedAPIs.takeAt(self.usedAPIs.indexOf(api)) self.updateApiList() def updateApiList(self): @@ -157,11 +155,11 @@ class MediaTab(SettingsTab): self.usedAPIs = QtCore.QSettings().value( self.settingsSection + u'/apis', QtCore.QVariant(u'Webkit')).toString().split(u',') - self.useWebkit = u'Webkit' in self.usedAPIs - self.usePhonon = u'Phonon' in self.usedAPIs - self.useVlc = u'Vlc' in self.usedAPIs - self.usePhononCheckBox.setChecked(self.usePhonon) - self.useVlcCheckBox.setChecked(self.useVlc) + for key in self.apis: + api = self.apis[key] + checkbox = self.ApiCheckBoxes[api.name] + if api.available and api.name in self.usedAPIs: + checkbox.setChecked(True) self.updateApiList() def save(self): diff --git a/openlp/plugins/media/lib/phononapi.py b/openlp/plugins/media/lib/phononapi.py index 8f1fc8c8c..cc8c70ea3 100644 --- a/openlp/plugins/media/lib/phononapi.py +++ b/openlp/plugins/media/lib/phononapi.py @@ -44,7 +44,7 @@ class PhononAPI(MediaAPI): """ def __init__(self, parent): - MediaAPI.__init__(self, parent) + MediaAPI.__init__(self, parent, u'Phonon') self.parent = parent self.additional_extensions = { u'audio/ac3': [u'.ac3'], @@ -76,7 +76,7 @@ class PhononAPI(MediaAPI): ext = u'*%s' % extension if ext not in list: list.append(ext) - self.parent.parent.serviceManager.supportedSuffixes(extension[1:]) + self.parent.serviceManager.supportedSuffixes(extension[1:]) log.info(u'MediaPlugin: %s extensions: %s' % (mimetype, u' '.join(extensions))) # Add extensions for this mimetype from self.additional_extensions. @@ -87,7 +87,7 @@ class PhononAPI(MediaAPI): ext = u'*%s' % extension if ext not in list: list.append(ext) - self.parent.parent.serviceManager.supportedSuffixes(extension[1:]) + self.parent.serviceManager.supportedSuffixes(extension[1:]) log.info(u'MediaPlugin: %s additional extensions: %s' % (mimetype, u' '.join(self.additional_extensions[mimetype]))) @@ -107,10 +107,7 @@ class PhononAPI(MediaAPI): display.phononWidget.hide() self.hasOwnWidget = True - @staticmethod - def is_available(): -# usePhonon = QtCore.QSettings().value( -# u'media/use phonon', QtCore.QVariant(True)).toBool() + def check_available(self): return True def get_supported_file_types(self): diff --git a/openlp/plugins/media/lib/vlcapi.py b/openlp/plugins/media/lib/vlcapi.py index 7531ba394..94cd067fa 100644 --- a/openlp/plugins/media/lib/vlcapi.py +++ b/openlp/plugins/media/lib/vlcapi.py @@ -30,8 +30,10 @@ import sys, os from datetime import datetime try: import vlc -except: - pass + vlc_available = True +except ImportError: + vlc_available = False + from PyQt4 import QtCore, QtGui from openlp.core.lib import Receiver from openlp.plugins.media.lib import MediaAPI, MediaState @@ -44,7 +46,7 @@ class VlcAPI(MediaAPI): to reflect Features of the Vlc API """ def __init__(self, parent): - MediaAPI.__init__(self, parent) + MediaAPI.__init__(self, parent, u'Vlc') self.parent = parent self.video_extensions_list = [ u'*.3gp' @@ -99,13 +101,8 @@ class VlcAPI(MediaAPI): display.vlcMediaPlayer.set_agl(int(display.vlcWidget.winId())) self.hasOwnWidget = True - @staticmethod - def is_available(): - try: - import vlc - return True - except: - return False + def check_available(self): + return vlc_available def get_supported_file_types(self): self.supported_file_types = ['avi'] diff --git a/openlp/plugins/media/lib/webkitapi.py b/openlp/plugins/media/lib/webkitapi.py index 7c2108ea7..ca8d4d1a1 100644 --- a/openlp/plugins/media/lib/webkitapi.py +++ b/openlp/plugins/media/lib/webkitapi.py @@ -41,7 +41,7 @@ class WebkitAPI(MediaAPI): """ def __init__(self, parent): - MediaAPI.__init__(self, parent) + MediaAPI.__init__(self, parent, u'Webkit') self.parent = parent self.canBackground = True self.video_extensions_list = [ @@ -73,12 +73,194 @@ class WebkitAPI(MediaAPI): # no special controls pass + def display_css(self): + """ + Add css style sheets to htmlbuilder + """ + css = u''' + ''' + return css + + + def display_javascript(self): + """ + Add javascript functions to htmlbuilder + """ + js = u''' + var video_timer = null; + var current_video = '1'; + + function show_video(state, path, volume, loop, seekVal){ + // Note, the preferred method for looping would be to use the + // video tag loop attribute. + // But QtWebKit doesn't support this. Neither does it support the + // onended event, hence the setInterval() + // In addition, setting the currentTime attribute to zero to restart + // the video raises an INDEX_SIZE_ERROR: DOM Exception 1 + // To complicate it further, sometimes vid.currentTime stops + // slightly short of vid.duration and vid.ended is intermittent! + // + // Note, currently the background may go black between loops. Not + // desirable. Need to investigate using two