openlp/openlp/core/lib/screen.py

261 lines
9.8 KiB
Python
Raw Normal View History

# -*- coding: utf-8 -*-
2012-12-29 13:35:16 +00:00
# vim: autoindent shiftwidth=4 expandtab textwidth=120 tabstop=4 softtabstop=4
###############################################################################
# OpenLP - Open Source Lyrics Projection #
# --------------------------------------------------------------------------- #
2015-01-18 13:39:21 +00:00
# Copyright (c) 2008-2015 OpenLP Developers #
# --------------------------------------------------------------------------- #
# 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 #
###############################################################################
2010-06-10 21:30:50 +00:00
"""
The :mod:`screen` module provides management functionality for a machines'
2011-02-26 21:43:41 +00:00
displays.
2010-06-10 21:30:50 +00:00
"""
2013-08-31 18:17:38 +00:00
import logging
2010-04-24 19:57:29 +00:00
import copy
2011-03-01 17:16:59 +00:00
from PyQt4 import QtCore
2013-12-13 17:44:05 +00:00
from openlp.core.common import Registry, Settings, translate
2011-03-01 17:16:59 +00:00
2010-02-27 15:31:23 +00:00
log = logging.getLogger(__name__)
2013-01-11 19:36:28 +00:00
2010-01-22 18:59:36 +00:00
class ScreenList(object):
"""
Wrapper to handle the parameters of the display screen.
To get access to the screen list call ``ScreenList()``.
"""
2013-08-31 18:17:38 +00:00
log.info('Screen loaded')
__instance__ = None
def __new__(cls):
2013-02-01 19:58:18 +00:00
"""
Re-implement __new__ to create a true singleton.
"""
if not cls.__instance__:
cls.__instance__ = object.__new__(cls)
return cls.__instance__
@classmethod
def create(cls, desktop):
2011-03-01 17:16:59 +00:00
"""
2011-03-02 17:56:06 +00:00
Initialise the screen list.
:param desktop: A QDesktopWidget object.
2011-03-01 17:16:59 +00:00
"""
screen_list = cls()
screen_list.desktop = desktop
screen_list.preview = None
screen_list.current = None
screen_list.override = None
screen_list.screen_list = []
screen_list.display_count = 0
screen_list.screen_count_changed()
screen_list.load_screen_settings()
2013-03-07 12:34:35 +00:00
desktop.resized.connect(screen_list.screen_resolution_changed)
desktop.screenCountChanged.connect(screen_list.screen_count_changed)
return screen_list
def screen_resolution_changed(self, number):
2010-06-10 21:30:50 +00:00
"""
2011-03-01 17:16:59 +00:00
Called when the resolution of a screen has changed.
2011-02-26 21:43:41 +00:00
2011-03-01 17:16:59 +00:00
``number``
The number of the screen, which size has changed.
"""
2013-08-31 18:17:38 +00:00
log.info('screen_resolution_changed %d' % number)
2011-03-01 17:16:59 +00:00
for screen in self.screen_list:
2013-08-31 18:17:38 +00:00
if number == screen['number']:
2013-12-24 08:56:50 +00:00
new_screen = {
2013-08-31 18:17:38 +00:00
'number': number,
'size': self.desktop.screenGeometry(number),
'primary': self.desktop.primaryScreen() == number
2011-03-01 17:16:59 +00:00
}
self.remove_screen(number)
2013-12-24 08:56:50 +00:00
self.add_screen(new_screen)
2011-03-01 17:16:59 +00:00
# The screen's default size is used, that is why we have to
# update the override screen.
if screen == self.override:
2013-12-24 08:56:50 +00:00
self.override = copy.deepcopy(new_screen)
2011-03-01 17:16:59 +00:00
self.set_override_display()
2013-08-31 18:17:38 +00:00
Registry().execute('config_screen_changed')
2011-03-01 17:16:59 +00:00
break
2011-02-26 21:43:41 +00:00
def screen_count_changed(self, changed_screen=-1):
2010-06-10 21:30:50 +00:00
"""
2011-03-01 17:16:59 +00:00
Called when a screen has been added or removed.
``changed_screen``
2011-03-01 17:16:59 +00:00
The screen's number which has been (un)plugged.
"""
2011-06-01 06:31:22 +00:00
# Do not log at start up.
if changed_screen != -1:
2013-08-31 18:17:38 +00:00
log.info('screen_count_changed %d' % self.desktop.screenCount())
2011-03-01 17:16:59 +00:00
# Remove unplugged screens.
for screen in copy.deepcopy(self.screen_list):
2013-08-31 18:17:38 +00:00
if screen['number'] == self.desktop.screenCount():
self.remove_screen(screen['number'])
2011-03-01 17:16:59 +00:00
# Add new screens.
2013-08-31 18:17:38 +00:00
for number in range(self.desktop.screenCount()):
2011-03-01 17:16:59 +00:00
if not self.screen_exists(number):
self.add_screen({
2013-08-31 18:17:38 +00:00
'number': number,
'size': self.desktop.screenGeometry(number),
'primary': (self.desktop.primaryScreen() == number)
2011-03-01 17:16:59 +00:00
})
2011-06-01 06:31:22 +00:00
# We do not want to send this message at start up.
if changed_screen != -1:
2011-03-01 17:16:59 +00:00
# Reload setting tabs to apply possible changes.
2013-08-31 18:17:38 +00:00
Registry().execute('config_screen_changed')
def get_screen_list(self):
"""
Returns a list with the screens. This should only be used to display
available screens to the user::
2014-05-02 06:42:17 +00:00
['Screen 1 (primary)', 'Screen 2']
"""
2011-03-04 14:44:21 +00:00
screen_list = []
for screen in self.screen_list:
2013-08-31 18:17:38 +00:00
screen_name = '%s %d' % (translate('OpenLP.ScreenList', 'Screen'), screen['number'] + 1)
if screen['primary']:
screen_name = '%s (%s)' % (screen_name, translate('OpenLP.ScreenList', 'primary'))
screen_list.append(screen_name)
return screen_list
2011-03-01 17:16:59 +00:00
def add_screen(self, screen):
"""
Add a screen to the list of known screens.
2015-09-08 19:13:59 +00:00
:param screen: A dict with the screen properties:
::
2011-02-27 16:27:45 +00:00
{
'primary': True,
'number': 0,
'size': PyQt4.QtCore.QRect(0, 0, 1024, 768)
2011-02-27 16:27:45 +00:00
}
"""
2013-12-24 08:56:50 +00:00
log.info('Screen %d found with resolution %s' % (screen['number'], screen['size']))
2013-08-31 18:17:38 +00:00
if screen['primary']:
2011-03-01 17:16:59 +00:00
self.current = screen
self.override = copy.deepcopy(self.current)
2011-03-01 17:16:59 +00:00
self.screen_list.append(screen)
self.display_count += 1
2011-02-26 21:43:41 +00:00
def remove_screen(self, number):
"""
Remove a screen from the list of known screens.
2014-03-17 19:05:55 +00:00
:param number: The screen number (int).
2011-02-26 21:43:41 +00:00
"""
2013-08-31 18:17:38 +00:00
log.info('remove_screen %d' % number)
2011-02-26 21:43:41 +00:00
for screen in self.screen_list:
2013-08-31 18:17:38 +00:00
if screen['number'] == number:
2011-02-26 21:43:41 +00:00
self.screen_list.remove(screen)
self.display_count -= 1
break
def screen_exists(self, number):
2010-06-10 21:30:50 +00:00
"""
2011-02-26 21:43:41 +00:00
Confirms a screen is known.
2014-03-17 19:05:55 +00:00
:param number: The screen number (int).
2010-06-10 21:30:50 +00:00
"""
for screen in self.screen_list:
2013-08-31 18:17:38 +00:00
if screen['number'] == number:
return True
return False
def set_current_display(self, number):
2010-04-02 18:12:54 +00:00
"""
2011-02-26 21:43:41 +00:00
Set up the current screen dimensions.
2014-03-17 19:05:55 +00:00
:param number: The screen number (int).
2010-04-02 18:12:54 +00:00
"""
2013-12-24 08:56:50 +00:00
log.debug('set_current_display %s' % number)
2010-04-02 18:12:54 +00:00
if number + 1 > self.display_count:
self.current = self.screen_list[0]
else:
self.current = self.screen_list[number]
2010-04-24 19:57:29 +00:00
self.preview = copy.deepcopy(self.current)
self.override = copy.deepcopy(self.current)
2010-04-02 18:12:54 +00:00
if self.display_count == 1:
self.preview = self.screen_list[0]
def set_override_display(self):
"""
2014-03-17 19:05:55 +00:00
Replace the current size with the override values, as the user wants to have their own screen attributes.
"""
2013-08-31 18:17:38 +00:00
log.debug('set_override_display')
2010-04-24 19:57:29 +00:00
self.current = copy.deepcopy(self.override)
self.preview = copy.deepcopy(self.current)
2010-04-24 19:57:29 +00:00
def reset_current_display(self):
"""
2014-03-17 19:05:55 +00:00
Replace the current values with the correct values, as the user wants to use the correct screen attributes.
"""
2013-08-31 18:17:38 +00:00
log.debug('reset_current_display')
self.set_current_display(self.current['number'])
def which_screen(self, window):
"""
2011-12-23 21:52:54 +00:00
Return the screen number that the centre of the passed window is in.
2014-03-17 19:05:55 +00:00
:param window: A QWidget we are finding the location of.
"""
2013-04-24 19:05:34 +00:00
x = window.x() + (window.width() // 2)
y = window.y() + (window.height() // 2)
for screen in self.screen_list:
2013-08-31 18:17:38 +00:00
size = screen['size']
2013-02-04 21:39:44 +00:00
if x >= size.x() and x <= (size.x() + size.width()) and y >= size.y() and y <= (size.y() + size.height()):
2013-08-31 18:17:38 +00:00
return screen['number']
def load_screen_settings(self):
"""
Loads the screen size and the monitor number from the settings.
"""
2013-02-10 16:05:52 +00:00
# Add the screen settings to the settings dict. This has to be done here due to cyclic dependency.
2013-01-20 11:46:19 +00:00
# Do not do this anywhere else.
screen_settings = {
2013-08-31 18:17:38 +00:00
'core/x position': self.current['size'].x(),
'core/y position': self.current['size'].y(),
'core/monitor': self.display_count - 1,
'core/height': self.current['size'].height(),
'core/width': self.current['size'].width()
2013-01-20 11:46:19 +00:00
}
Settings.extend_default_settings(screen_settings)
2012-05-17 15:13:09 +00:00
settings = Settings()
2013-08-31 18:17:38 +00:00
settings.beginGroup('core')
monitor = settings.value('monitor')
2013-01-16 12:09:39 +00:00
self.set_current_display(monitor)
2013-08-31 18:17:38 +00:00
self.display = settings.value('display on monitor')
override_display = settings.value('override position')
x = settings.value('x position')
y = settings.value('y position')
width = settings.value('width')
height = settings.value('height')
self.override['size'] = QtCore.QRect(x, y, width, height)
self.override['primary'] = False
settings.endGroup()
if override_display:
self.set_override_display()
else:
self.reset_current_display()