', u'end tag': u'{/p}', u'end html': u'
', u'protected': True}) html_expands.append({u'desc': u'Bold', u'start tag': u'{st}', u'start html': u'', u'end tag': u'{/st}', u'end html': u'', u'protected': True}) html_expands.append({u'desc': u'Italics', u'start tag': u'{it}', u'start html': u'', u'end tag': u'{/it}', u'end html': u'', u'protected': True}) html_expands.append({u'desc': u'Underline', u'start tag': u'{u}', u'start html': u'', u'end tag': u'{/u}', u'end html': u'', u'protected': True}) 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. ``comment`` An identifying string for when the same text is used in different roles within the same context. """ return QtCore.QCoreApplication.translate(context, text, comment) def get_text_file_string(text_file): """ Open a file and return its content as unicode string. If the supplied file name is not a file then the function returns False. If there is an error loading the file or the content can't be decoded 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 = file_handle.read() content_string = content.decode(u'utf-8') except (IOError, UnicodeError): 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 = QtGui.QIcon() if isinstance(icon, QtGui.QIcon): button_icon = icon elif isinstance(icon, basestring): 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.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 ``base`` The parent menu to add this menu item to ``icon`` An icon for this action ``text`` The text to display for this action ``slot`` The code to run when this action is triggered """ 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 ``base`` The parent object to add this menu to ``icon`` An icon for this menu ``text`` The text to display for this menu """ action = QtGui.QMenu(text, base) action.setIcon(build_icon(icon)) return action def context_menu_separator(base): """ Add a separator to a context menu ``base`` The menu object to add the separator to """ action = QtGui.QAction(u'', base) action.setSeparator(True) return action def image_to_byte(image): """ Resize an image to fit on the current screen for the web and returns it as a byte stream. ``image`` The image to converted. """ log.debug(u'image_to_byte - start') byte_array = QtCore.QByteArray() # use buffer to store pixmap into byteArray buffie = QtCore.QBuffer(byte_array) buffie.open(QtCore.QIODevice.WriteOnly) image.save(buffie, "PNG") log.debug(u'image_to_byte - end') # convert to base64 encoding so does not get missed! return byte_array.toBase64() def resize_image(image, width, height, background=QtCore.Qt.black): """ Resize an image to fit on the current screen. ``image`` The image to resize. ``width`` The new image width. ``height`` The new image height. ``background`` The background colour defaults to black. """ log.debug(u'resize_image - start') if isinstance(image, QtGui.QImage): preview = image else: preview = QtGui.QImage(image) if not preview.isNull(): # Only resize if different size if preview.width() == width and preview.height == height: return preview 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) painter = QtGui.QPainter(new_image) painter.fillRect(new_image.rect(), background) painter.drawImage((width - realw) / 2, (height - realh) / 2, preview) return new_image def check_item_selected(list_widget, message): """ Check if a list item is selected so an action may be performed on it ``list_widget`` The list to check for selected items ``message`` The message to give the user if no item is selected """ if not list_widget.selectedIndexes(): QtGui.QMessageBox.information(list_widget.parent(), translate('OpenLP.MediaManagerItem', 'No Items Selected'), message) return False return True def clean_tags(text): """ Remove Tags from text for display """ text = text.replace(u'