forked from openlp/openlp
330 lines
13 KiB
Python
330 lines
13 KiB
Python
# -*- coding: utf-8 -*-
|
|
# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4
|
|
"""
|
|
OpenLP - Open Source Lyrics Projection
|
|
Copyright (c) 2008-2009 Raoul Snyman
|
|
Portions copyright (c) 2008-2009 Martin Thompson, Tim Bentley
|
|
|
|
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 types
|
|
import os
|
|
|
|
from PyQt4 import QtCore, QtGui
|
|
|
|
from openlp.core.lib.toolbar import *
|
|
from openlp.core.lib import translate, contextMenuAction, contextMenuSeparator
|
|
from serviceitem import ServiceItem
|
|
|
|
class MediaManagerItem(QtGui.QWidget):
|
|
"""
|
|
MediaManagerItem is a helper widget for plugins.
|
|
|
|
None of the following *need* to be used, feel free to override
|
|
them cmopletely in your plugin's implementation. Alternatively,
|
|
call them from your plugin before or after you've done extra
|
|
things that you need to.
|
|
|
|
**Constructor Parameters**
|
|
|
|
``parent``
|
|
The parent widget. Usually this will be the *Media Manager*
|
|
itself. This needs to be a class descended from ``QWidget``.
|
|
|
|
``icon``
|
|
Either a ``QIcon``, a resource path, or a file name. This is
|
|
the icon which is displayed in the *Media Manager*.
|
|
|
|
``title``
|
|
The title visible on the item in the *Media Manager*.
|
|
|
|
**Member Variables**
|
|
|
|
When creating a descendant class from this class for your plugin,
|
|
the following member variables should be set.
|
|
|
|
``self.TranslationContext``
|
|
This sets the translation context of all the text in the
|
|
Media Manager item.
|
|
|
|
``self.PluginTextShort``
|
|
The shortened name for the plugin, e.g. *'Image'* for the
|
|
image plugin.
|
|
|
|
``self.ConfigSection``
|
|
The section in the configuration where the items in the media
|
|
manager are stored. This could potentially be
|
|
``self.PluginTextShort.lower()``.
|
|
|
|
``self.OnNewPrompt``
|
|
Defaults to *'Select Image(s)'*.
|
|
|
|
``self.OnNewFileMasks``
|
|
Defaults to *'Images (*.jpg *jpeg *.gif *.png *.bmp)'*. This
|
|
assumes that the new action is to load a file. If not, you
|
|
need to override the ``OnNew`` method.
|
|
|
|
``self.ListViewWithDnD_class``
|
|
This must be a **class**, not an object, descended from
|
|
``openlp.core.lib.BaseListWithDnD`` that is not used in any
|
|
other part of OpenLP.
|
|
|
|
``self.PreviewFunction``
|
|
This must be a method which returns a QImage to represent the
|
|
item (usually a preview). No scaling is required, that is
|
|
performed automatically by OpenLP when necessary. If this
|
|
method is not defined, a default will be used (treat the
|
|
filename as an image).
|
|
"""
|
|
|
|
global log
|
|
log = logging.getLogger(u'MediaManagerItem')
|
|
log.info(u'Media Item loaded')
|
|
|
|
def __init__(self, parent=None, icon=None, title=None):
|
|
"""
|
|
Constructor to create the media manager item.
|
|
"""
|
|
QtGui.QWidget.__init__(self)
|
|
self.parent = parent
|
|
if type(icon) is QtGui.QIcon:
|
|
self.icon = icon
|
|
elif type(icon) is types.StringType:
|
|
self.icon.addPixmap(QtGui.QPixmap.fromImage(QtGui.QImage(icon)),
|
|
QtGui.QIcon.Normal, QtGui.QIcon.Off)
|
|
else:
|
|
self.icon = None
|
|
if title is not None:
|
|
self.title = title
|
|
self.Toolbar = None
|
|
self.PageLayout = QtGui.QVBoxLayout(self)
|
|
self.PageLayout.setSpacing(0)
|
|
self.PageLayout.setMargin(0)
|
|
self.setupUi()
|
|
self.retranslateUi()
|
|
self.initialise()
|
|
|
|
def retranslateUi(self):
|
|
"""
|
|
This method is called automatically to provide OpenLP with the
|
|
opportunity to translate the ``MediaManagerItem`` to another
|
|
language.
|
|
"""
|
|
pass
|
|
|
|
def addToolbar(self):
|
|
"""
|
|
A method to help developers easily add a toolbar to the media
|
|
manager item.
|
|
"""
|
|
if self.Toolbar is None:
|
|
self.Toolbar = OpenLPToolbar(self)
|
|
self.PageLayout.addWidget(self.Toolbar)
|
|
|
|
def addToolbarButton(self, title, tooltip, icon, slot=None, objectname=None):
|
|
"""
|
|
A method to help developers easily add a button to the toolbar.
|
|
|
|
``title``
|
|
The title of the button.
|
|
|
|
``tooltip``
|
|
The tooltip to be displayed when the mouse hovers over the
|
|
button.
|
|
|
|
``icon``
|
|
The icon of the button. This can be an instance of QIcon, or a
|
|
string cotaining either the absolute path to the image, or an
|
|
internal resource path starting with ':/'.
|
|
|
|
``slot``
|
|
The method to call when the button is clicked.
|
|
|
|
``objectname``
|
|
The name of the button.
|
|
"""
|
|
# NB different order (when I broke this out, I didn't want to
|
|
# break compatability), but it makes sense for the icon to
|
|
# come before the tooltip (as you have to have an icon, but
|
|
# not neccesarily a tooltip)
|
|
self.Toolbar.addToolbarButton(title, icon, tooltip, slot, objectname)
|
|
|
|
def addToolbarSeparator(self):
|
|
"""
|
|
A very simple method to add a separator to the toolbar.
|
|
"""
|
|
self.Toolbar.addSeparator()
|
|
|
|
def setupUi(self):
|
|
"""
|
|
This method sets up the interface on the button. Plugin
|
|
developers use this to add and create toolbars, and the rest
|
|
of the interface of the media manager item.
|
|
"""
|
|
# Add a toolbar
|
|
self.addToolbar()
|
|
# Create buttons for the toolbar
|
|
## File Button ##
|
|
if self.hasFileIcon:
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'Load '+self.PluginTextShort),
|
|
translate(self.TranslationContext, u'Load a new '+self.PluginTextShort),
|
|
u':'+self.IconPath+ u'_load.png', self.onFileClick, self.PluginTextShort+u'FileItem')
|
|
## New Button ##
|
|
if self.hasNewIcon:
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'New '+self.PluginTextShort),
|
|
translate(self.TranslationContext, u'Add a new '+self.PluginTextShort),
|
|
u':'+self.IconPath+ u'_load.png', self.onNewClick, self.PluginTextShort+u'NewItem')
|
|
## Edit Button ##
|
|
if self.hasEditIcon:
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'Edit '+self.PluginTextShort),
|
|
translate(self.TranslationContext, u'Edit the selected '+self.PluginTextShort),
|
|
u':'+self.IconPath+ u'_load.png', self.onEditClick, self.PluginTextShort+u'EditItem')
|
|
## Delete Button ##
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'Delete '+self.PluginTextShort),
|
|
translate(self.TranslationContext, u'Delete the selected item'),
|
|
u':'+self.IconPath+ u'_delete.png', self.onDeleteClick, self.PluginTextShort+u'DeleteItem')
|
|
## Separator Line ##
|
|
self.addToolbarSeparator()
|
|
## Preview ##
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'Preview '+self.PluginTextShort),
|
|
translate(self.TranslationContext, u'Preview the selected item'),
|
|
u':/system/system_preview.png', self.onPreviewClick, u'PreviewItem')
|
|
## Live Button ##
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'Go Live'),
|
|
translate(self.TranslationContext, u'Send the selected item live'),
|
|
u':/system/system_live.png', self.onLiveClick, u'LiveItem')
|
|
## Add to service Button ##
|
|
self.addToolbarButton(
|
|
translate(self.TranslationContext, u'Add '+self.PluginTextShort+u' To Service'),
|
|
translate(self.TranslationContext, u'Add the selected item(s) to the service'),
|
|
u':/system/system_add.png', self.onAddClick, self.PluginTextShort+u'AddItem')
|
|
#Allow the plugin to define it's own header
|
|
self.addHeaderBar()
|
|
#Add the List widget
|
|
self.ListView = self.ListViewWithDnD_class()
|
|
self.ListView.uniformItemSizes = True
|
|
self.ListView.setGeometry(QtCore.QRect(10, 100, 256, 591))
|
|
self.ListView.setSpacing(1)
|
|
self.ListView.setSelectionMode(QtGui.QAbstractItemView.ExtendedSelection)
|
|
self.ListView.setAlternatingRowColors(True)
|
|
self.ListView.setDragEnabled(True)
|
|
self.ListView.setObjectName(self.PluginTextShort+u'ListView')
|
|
#Add tp PageLayout
|
|
self.PageLayout.addWidget(self.ListView)
|
|
#define and add the context menu
|
|
self.ListView.setContextMenuPolicy(QtCore.Qt.ActionsContextMenu)
|
|
if self.hasEditIcon:
|
|
self.ListView.addAction(contextMenuAction(self.ListView,
|
|
':' +self.IconPath+u'_new.png',
|
|
translate(self.TranslationContext, u'&Edit '+self.PluginTextShort),
|
|
self.onEditClick))
|
|
self.ListView.addAction(self.contextMenuSeparator(self.SongListWidget))
|
|
self.ListView.addAction(contextMenuAction(
|
|
self.ListView, ':/system/system_preview.png',
|
|
translate(self.TranslationContext, u'&Preview '+self.PluginTextShort),
|
|
self.onPreviewClick))
|
|
self.ListView.addAction(contextMenuAction(
|
|
self.ListView, ':/system/system_live.png',
|
|
translate(self.TranslationContext, u'&Show Live'),
|
|
self.onLiveClick))
|
|
self.ListView.addAction(contextMenuAction(
|
|
self.ListView, ':/system/system_add.png',
|
|
translate(self.TranslationContext, u'&Add to Service'),
|
|
self.onAddClick))
|
|
QtCore.QObject.connect(self.ListView,
|
|
QtCore.SIGNAL(u'doubleClicked(QModelIndex)'), self.onPreviewClick)
|
|
|
|
def initialise(self):
|
|
"""
|
|
Implement this method in your descendent media manager item to
|
|
do any UI or other initialisation. This method is called
|
|
automatically.
|
|
"""
|
|
pass
|
|
|
|
def addHeaderBar(self):
|
|
pass
|
|
|
|
def onFileClick(self):
|
|
files = QtGui.QFileDialog.getOpenFileNames(None,
|
|
translate(self.TranslationContext, self.OnNewPrompt),
|
|
self.parent.config.get_last_dir(),
|
|
self.OnNewFileMasks)
|
|
log.info(u'New files(s)%s', unicode(files))
|
|
if len(files) > 0:
|
|
self.loadList(files)
|
|
dir, filename = os.path.split(unicode(files[0]))
|
|
self.parent.config.set_last_dir(dir)
|
|
self.parent.config.set_list(self.ConfigSection, self.getFileList())
|
|
|
|
def getFileList(self):
|
|
count = 0
|
|
filelist = []
|
|
while count < self.ListView.count():
|
|
bitem = self.ListView.item(count)
|
|
filename = unicode((bitem.data(QtCore.Qt.UserRole)).toString())
|
|
filelist.append(filename)
|
|
count += 1
|
|
return filelist
|
|
|
|
def loadList(self, list):
|
|
raise NotImplementedError(u'MediaManagerItem.loadList needs to be defined by the plugin')
|
|
|
|
def onNewClick(self):
|
|
raise NotImplementedError(u'MediaManagerItem.onNewClick needs to be defined by the plugin')
|
|
|
|
def onEditClick(self):
|
|
raise NotImplementedError(u'MediaManagerItem.onEditClick needs to be defined by the plugin')
|
|
|
|
def onDeleteClick(self):
|
|
raise NotImplementedError(u'MediaManagerItem.onDeleteClick needs to be defined by the plugin')
|
|
|
|
def generateSlideData(self, item):
|
|
raise NotImplementedError(u'MediaManagerItem.generateSlideData needs to be defined by the plugin')
|
|
|
|
def onPreviewClick(self):
|
|
log.debug(self.PluginTextShort+u' Preview Requested')
|
|
service_item = self.buildServiceItem()
|
|
if service_item is not None:
|
|
self.parent.preview_controller.addServiceItem(service_item)
|
|
|
|
def onLiveClick(self):
|
|
log.debug(self.PluginTextShort + u' Live Requested')
|
|
service_item = self.buildServiceItem()
|
|
if service_item is not None:
|
|
self.parent.live_controller.addServiceItem(service_item)
|
|
|
|
def onAddClick(self):
|
|
log.debug(self.PluginTextShort+u' Add Requested')
|
|
service_item = self.buildServiceItem()
|
|
if service_item is not None:
|
|
self.parent.service_manager.addServiceItem(service_item)
|
|
|
|
def buildServiceItem(self):
|
|
"""
|
|
Common method for generating a service item
|
|
"""
|
|
service_item = ServiceItem(self.parent)
|
|
service_item.addIcon(u':/media/media_'+self.PluginTextShort.lower()+u'.png')
|
|
if self.generateSlideData(service_item):
|
|
self.ListView.clearSelection()
|
|
return service_item
|
|
else:
|
|
return None
|