forked from openlp/openlp
189 lines
6.8 KiB
Python
189 lines
6.8 KiB
Python
# -*- coding: utf-8 -*-
|
|
# vim: autoindent shiftwidth=4 expandtab textwidth=80 tabstop=4 softtabstop=4
|
|
|
|
###############################################################################
|
|
# OpenLP - Open Source Lyrics Projection #
|
|
# --------------------------------------------------------------------------- #
|
|
# Copyright (c) 2008-2010 Raoul Snyman #
|
|
# Portions copyright (c) 2008-2010 Tim Bentley, Jonathan Corwin, Michael #
|
|
# Gorven, Scott Guerrieri, Christian Richter, Maikel Stuivenberg, Martin #
|
|
# Thompson, Jon Tibble, Carsten Tinggaard #
|
|
# --------------------------------------------------------------------------- #
|
|
# 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 #
|
|
###############################################################################
|
|
|
|
"""
|
|
The :mod:`lib` module contains most of the components and libraries that make
|
|
OpenLP work.
|
|
"""
|
|
import logging
|
|
import os.path
|
|
import types
|
|
|
|
from PyQt4 import QtCore, QtGui
|
|
|
|
log = logging.getLogger(__name__)
|
|
|
|
def translate(context, text, comment=None):
|
|
"""
|
|
A special shortcut method to wrap around the Qt4 translation functions.
|
|
This abstracts the translation procedure so that we can change it if at a
|
|
later date if necessary, without having to redo the whole of OpenLP.
|
|
|
|
``context``
|
|
The translation context, used to give each string a context or a
|
|
namespace.
|
|
|
|
``text``
|
|
The text to put into the translation tables for translation.
|
|
"""
|
|
return QtCore.QCoreApplication.translate(context, text, comment)
|
|
|
|
def get_text_file_string(text_file):
|
|
"""
|
|
Open a file and return the contents of the file. If the supplied file name
|
|
is not a file then the function returns False. If there is an error
|
|
loading the file then the function will return None.
|
|
|
|
``textfile``
|
|
The name of the file.
|
|
"""
|
|
if not os.path.isfile(text_file):
|
|
return False
|
|
file_handle = None
|
|
content_string = None
|
|
try:
|
|
file_handle = open(text_file, u'r')
|
|
content_string = file_handle.read()
|
|
except IOError:
|
|
log.exception(u'Failed to open text file %s' % text_file)
|
|
finally:
|
|
if file_handle:
|
|
file_handle.close()
|
|
return content_string
|
|
|
|
def str_to_bool(stringvalue):
|
|
"""
|
|
Convert a string version of a boolean into a real boolean.
|
|
|
|
``stringvalue``
|
|
The string value to examine and convert to a boolean type.
|
|
"""
|
|
if isinstance(stringvalue, bool):
|
|
return stringvalue
|
|
return unicode(stringvalue).strip().lower() in (u'true', u'yes', u'y')
|
|
|
|
def build_icon(icon):
|
|
"""
|
|
Build a QIcon instance from an existing QIcon, a resource location, or a
|
|
physical file location. If the icon is a QIcon instance, that icon is
|
|
simply returned. If not, it builds a QIcon instance from the resource or
|
|
file name.
|
|
|
|
``icon``
|
|
The icon to build. This can be a QIcon, a resource string in the form
|
|
``:/resource/file.png``, or a file location like ``/path/to/file.png``.
|
|
"""
|
|
button_icon = None
|
|
if isinstance(icon, QtGui.QIcon):
|
|
button_icon = icon
|
|
elif isinstance(icon, basestring):
|
|
button_icon = QtGui.QIcon()
|
|
if icon.startswith(u':/'):
|
|
button_icon.addPixmap(QtGui.QPixmap(icon), QtGui.QIcon.Normal,
|
|
QtGui.QIcon.Off)
|
|
else:
|
|
button_icon.addPixmap(QtGui.QPixmap.fromImage(QtGui.QImage(icon)),
|
|
QtGui.QIcon.Normal, QtGui.QIcon.Off)
|
|
elif isinstance(icon, QtGui.QImage):
|
|
button_icon = QtGui.QIcon()
|
|
button_icon.addPixmap(QtGui.QPixmap.fromImage(icon),
|
|
QtGui.QIcon.Normal, QtGui.QIcon.Off)
|
|
return button_icon
|
|
|
|
def context_menu_action(base, icon, text, slot):
|
|
"""
|
|
Utility method to help build context menus for plugins
|
|
"""
|
|
action = QtGui.QAction(text, base)
|
|
if icon:
|
|
action.setIcon(build_icon(icon))
|
|
QtCore.QObject.connect(action, QtCore.SIGNAL(u'triggered()'), slot)
|
|
return action
|
|
|
|
def context_menu(base, icon, text):
|
|
"""
|
|
Utility method to help build context menus for plugins
|
|
"""
|
|
action = QtGui.QMenu(text, base)
|
|
action.setIcon(build_icon(icon))
|
|
return action
|
|
|
|
def context_menu_separator(base):
|
|
"""
|
|
Add a separator to a context menu
|
|
"""
|
|
action = QtGui.QAction(u'', base)
|
|
action.setSeparator(True)
|
|
return action
|
|
|
|
def resize_image(image, width, height):
|
|
"""
|
|
Resize an image to fit on the current screen.
|
|
|
|
``image``
|
|
The image to resize.
|
|
"""
|
|
preview = QtGui.QImage(image)
|
|
if not preview.isNull():
|
|
preview = preview.scaled(width, height, QtCore.Qt.KeepAspectRatio,
|
|
QtCore.Qt.SmoothTransformation)
|
|
realw = preview.width()
|
|
realh = preview.height()
|
|
# and move it to the centre of the preview space
|
|
new_image = QtGui.QImage(width, height,
|
|
QtGui.QImage.Format_ARGB32_Premultiplied)
|
|
new_image.fill(QtCore.Qt.black)
|
|
painter = QtGui.QPainter(new_image)
|
|
painter.drawImage((width - realw) / 2, (height - realh) / 2, preview)
|
|
return new_image
|
|
|
|
|
|
class ThemeLevel(object):
|
|
"""
|
|
Provides an enumeration for the level a theme applies to
|
|
"""
|
|
Global = 1
|
|
Service = 2
|
|
Song = 3
|
|
|
|
from eventreceiver import Receiver
|
|
from settingsmanager import SettingsManager
|
|
from plugin import PluginStatus, Plugin
|
|
from pluginmanager import PluginManager
|
|
from settingstab import SettingsTab
|
|
from xmlrootclass import XmlRootClass
|
|
from serviceitem import ServiceItem
|
|
from serviceitem import ServiceItemType
|
|
from serviceitem import ItemCapabilities
|
|
from toolbar import OpenLPToolbar
|
|
from dockwidget import OpenLPDockWidget
|
|
from songxmlhandler import SongXMLBuilder, SongXMLParser
|
|
from themexmlhandler import ThemeXML
|
|
from renderer import Renderer
|
|
from rendermanager import RenderManager
|
|
from mediamanageritem import MediaManagerItem
|
|
from basemodel import BaseModel
|
|
from baselistwithdnd import BaseListWithDnD
|