# -*- coding: utf-8 -*-
#
# ui.py
#
# Copyright 2010 Thomas Jost <thomas.jost@gmail.com>
# Copyright 2015 Cimbali <me@cimba.li>
#
# 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.
"""
:mod:`pympress.ui` -- GUI management
------------------------------------
This module contains the whole graphical user interface of pympress, which is
made of two separate windows: the Content window, which displays only the
current page in full size, and the Presenter window, which displays both the
current and the next page, as well as a time counter and a clock.
Both windows are managed by the :class:`~pympress.ui.UI` class.
"""
import logging
logger = logging.getLogger(__name__)
import pathlib
import math
import sys
import gc
from urllib.request import url2pathname
from urllib.parse import urlsplit
import gi
import cairo
gi.require_version('Gtk', '3.0')
from gi.repository import GObject, Gtk, Gdk, GLib, GdkPixbuf, Gio
from pympress import (
document, surfacecache, util, pointer, scribble, deck, builder, talk_time, dialog, extras, editable_label
)
[docs]
class UI(builder.Builder):
""" Pympress GUI management.
"""
#: The :class:`~pympress.app.Pympress` instance
app = None
#: Content window, as a :class:`~Gtk.Window` instance.
c_win = None
#: :class:`~Gtk.AspectFrame` for the Content window.
c_frame = None
#: :class:`~Gtk.DrawingArea` for the Content window.
c_da = None
#: Presenter window, as a :class:`~Gtk.Window` instance.
p_win = None
#: :class:`~Gtk.Box` for the Presenter window.
p_central = None
#: :class:`~Gtk.AspectFrame` for the current slide in the Presenter window.
p_frame_notes = None
#: :class:`~Gtk.DrawingArea` for the current slide in the Presenter window.
p_da_notes = None
#: :class:`~Gtk.Grid` for the next slide(s) in the Presenter window.
grid_next = None
#: `list` of :class:`~Gtk.AspectFrame` for the next slide in the Presenter window.
p_frames_next = None
#: :class:`~Gtk.DrawingArea` for the next slide in the Presenter window.
p_das_next = None
#: `int` the number of next slides currently on display in the “Next slides” pane, initialized to the maximal number
next_frames_count = 16
#: `list` of :class:`~Gtk.AspectFrame` for the current slide copy in the Presenter window.
p_frame_cur = None
#: :class:`~Gtk.DrawingArea` for the current slide copy in the Presenter window.
p_da_cur = None
#: :class:`~Gtk.Frame` for the annotations in the Presenter window.
p_frame_annot = None
#: Indicates whether we should delay redraws on some drawing areas to fluidify resizing gtk.paned
resize_panes = False
#: Tracks return values of GLib.timeout_add to cancel gtk.paned's redraw callbacks
redraw_timeout = 0
#: Whether to use notes mode or not
notes_mode = document.PdfPage.NONE
#: Current choice of mode to toggle notes
chosen_notes_mode = document.PdfPage.RIGHT
#: Whether to display annotations or not
show_annotations = True
#: Whether to display big buttons or not
show_bigbuttons = True
#: :class:`~Gtk.ToolButton` big button for touch screens, go to previous slide
prev_button = None
#: :class:`~Gtk.ToolButton` big button for touch screens, go to next slide
next_button = None
#: :class:`~Gtk.ToolButton` big button for touch screens, go toggle the pointer
laser_button = None
#: :class:`~Gtk.ToolButton` big button for touch screens, go to scribble on screen
highlight_button = None
#: number of page currently displayed in Content window's miniatures
current_page = -1
#: number of page currently displayed in Presenter window's miniatures
preview_page = -1
#: track whether we blank the screen
blanked = False
#: Dictionary of :class:`~Gtk.Widget` from the presenter window that can be dynamically rearranged
placeable_widgets = {}
#: Map of :class:`~Gtk.Paned` to the relative position (`float` between 0 and 1) of its handle
pane_handle_pos = {}
#: :class:`~pympress.config.Config` to remember preferences
config = None
#: :class:`~pympress.surfacecache.SurfaceCache` instance.
cache = None
#: Current :class:`~pympress.document.Document` instance.
doc = document.EmptyDocument()
#: Class :class:`~pympress.scribble.Scribble` managing drawing by the user on top of the current slide.
scribbler = None
#: Class :class:`~pympress.deck.Overview` displaying a view of all slides
deck = None
#: Class :class:`~pympress.extras.Annotations` managing the display of annotations
annotations = None
#: Class :class:`~pympress.extras.Media` managing keeping track of and callbacks on media overlays
medias = None
#: Class :class:`~pympress.extras.Zoom` managing the zoom level of the current slide.
zoom = None
#: Software-implemented laser pointer, :class:`~pympress.pointer.Pointer`
laser = None
#: :class:`~pympress.editable_label.PageNumber` displaying and setting current page numbers
page_number = None
#: :class:`~pympress.editable_label.EstimatedTalkTime` to set estimated/remaining talk time
est_time = None
#: :class:`~pympress.dialog.TimingReport` popup to show how much time was spent on which part
timing = None
#: :class:`~pympress.talk_time.TimeCounter` clock tracking talk time (elapsed, and remaining)
talk_time = None
#: A :class:`~Gtk.ShortcutsWindow` to show the shortcuts
shortcuts_window = None
#: :class:`~pympress.dialog.LayoutEditor` popup to configure the layouts of the presenter window
layout_editor = None
#: :class:`~pympress.dialog.AutoPlay` popup to configure automatic playing
autoplay = None
#: A :class:`~Gtk.AccelGroup` to store the shortcuts
accel_group = None
#: A :class:`~Gio.Menu` to display the recent files to open
recent_menu = None
#: A :class:`~pympress.extras.FileWatcher` object to reload modified files
file_watcher = None
#: `int` or `None`, may keep track of the Gtk.Application inhibit request
inhibit_cookie = None
##############################################################################
############################# UI setup #############################
##############################################################################
def __init__(self, app, config):
super(UI, self).__init__()
self.app = app
self.config = config
self.blanked = self.config.getboolean('content', 'start_blanked')
Gtk.StyleContext.add_provider_for_screen(
Gdk.Screen.get_default(),
util.load_style_provider(Gtk.CssProvider()),
Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION
)
# We may want some additional CSS changes
self.css_provider = Gtk.CssProvider()
Gtk.StyleContext.add_provider_for_screen(
Gdk.Screen.get_default(),
self.css_provider,
Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION
)
self.show_annotations = self.config.getboolean('presenter', 'show_annotations')
self.chosen_notes_mode = document.PdfPage[self.config.get('notes position', 'horizontal').upper()]
self.show_bigbuttons = self.config.getboolean('presenter', 'show_bigbuttons')
# Surface cache
self.cache = surfacecache.SurfaceCache(self.doc, self.config.getint('cache', 'maxpages'))
# Make and populate windows
self.load_ui('presenter')
self.load_ui('content')
self.app.add_window(self.p_win)
self.app.add_window(self.c_win)
self.load_ui('menu_bar', ext='.xml')
self.app.set_menubar(self.get_object('menu_bar'))
self.recent_menu = self.get_object('recent_menu')
c_full = self.config.getboolean('content', 'start_fullscreen')
p_full = self.config.getboolean('presenter', 'start_fullscreen')
self.setup_actions({
'quit': dict(activate=self.app.quit),
'about': dict(activate=self.menu_about),
'big-buttons': dict(activate=self.switch_bigbuttons, state=self.show_bigbuttons),
'show-shortcuts': dict(activate=self.show_shortcuts),
'content-fullscreen': dict(activate=self.switch_fullscreen, state=c_full),
'presenter-fullscreen': dict(activate=self.switch_fullscreen, state=p_full),
'swap-screens': dict(activate=self.swap_screens),
'blank-screen': dict(activate=self.switch_blanked, state=self.blanked),
'notes-mode': dict(activate=self.switch_mode, state=False),
'notes-pos': dict(activate=self.change_notes_pos, parameter_type=str,
state=self.chosen_notes_mode.name.lower()),
'annotations': dict(activate=self.switch_annotations, state=self.show_annotations),
'validate-input': dict(activate=self.validate_current_input),
'cancel-input': dict(activate=self.cancel_current_input),
'align-content': dict(activate=self.adjust_frame_position),
'next-frames': dict(activate=self.reconfigure_next_frames, parameter_type=int,
state=self.next_frames_count),
})
self.setup_actions({
'open-file': dict(activate=self.open_file, parameter_type=str),
'close-file': dict(activate=self.close_file),
'save-file': dict(activate=self.save_file),
'save-file-as': dict(activate=self.save_file_as),
'pick-file': dict(activate=self.pick_file),
'list-recent-files': dict(change_state=self.populate_recent_menu, state=False),
'page': dict(activate=lambda gaction, param: self.goto_page(param.get_int64()),
parameter_type=int, state=self.current_page),
'next-page': dict(activate=self.doc_goto_next),
'next-label': dict(activate=self.doc_label_next),
'prev-page': dict(activate=self.doc_goto_prev),
'prev-label': dict(activate=self.doc_label_prev),
'hist-back': dict(activate=self.doc_hist_prev),
'hist-forward': dict(activate=self.doc_hist_next),
'first-page': dict(activate=self.doc_goto_home),
'last-page': dict(activate=self.doc_goto_end),
})
self.zoom = extras.Zoom(self)
self.scribbler = scribble.Scribbler(self.config, self, self.notes_mode)
self.deck = deck.Overview(self.config, self)
self.annotations = extras.Annotations(self)
self.medias = extras.Media(self, self.config)
self.laser = pointer.Pointer(self.config, self)
self.est_time = editable_label.EstimatedTalkTime(self)
self.page_number = editable_label.PageNumber(self, self.config.getboolean('presenter', 'scroll_number'))
self.timing = dialog.TimingReport(self)
self.autoplay = dialog.AutoPlay(self)
self.talk_time = talk_time.TimeCounter(self, self.est_time, self.timing, self.autoplay)
self.layout_editor = dialog.LayoutEditor(self, self.config)
self.file_watcher = extras.FileWatcher()
self.config.register_actions(self)
# Get placeable widgets. NB, get the highlight one manually from the scribbler class
self.placeable_widgets = {
name: self.get_object(widget_name) for name, widget_name in self.config.placeable_widgets.items()
}
self.placeable_widgets['highlight'] = self.scribbler.scribble_overlay
self.placeable_widgets['deck'] = self.deck.deck_viewport
# Initialize windows
self.make_cwin()
self.make_pwin()
self.connect_signals(self)
for action, shortcut_list in self.config.shortcuts.items():
if action == 'highlight-hold-to-erase':
continue # Not really an action but we define a shortcut for it
self.app.set_accels_for_action('app.' + action, shortcut_list)
# Common to both windows
self.load_icons()
# Adjust default visibility of items
self.prev_button.set_no_show_all(True)
self.next_button.set_no_show_all(True)
self.laser_button.set_no_show_all(True)
self.highlight_button.set_no_show_all(True)
self.p_frame_annot.set_no_show_all(True)
self.prev_button.set_visible(self.show_bigbuttons)
self.next_button.set_visible(self.show_bigbuttons)
self.laser_button.set_visible(self.show_bigbuttons)
self.highlight_button.set_visible(self.show_bigbuttons)
self.p_frame_annot.set_visible(self.show_annotations)
self.laser.activate_pointermode()
# Setup screens and show all windows
self.p_win.parse_geometry(self.config.get('presenter', 'geometry'))
self.c_win.parse_geometry(self.config.get('content', 'geometry'))
screen = self.p_win.get_screen()
if type(screen).__name__ != 'GdkWaylandScreen':
self.setup_screens(screen, 'at startup')
else:
self.app.lookup_action('swap-screens').set_enabled(False)
screen.connect('monitors-changed', self.screens_changed)
self.c_win.show_all()
self.p_win.show_all()
# Queue some redraws
self.c_da.queue_draw()
self.redraw_panes()
self.do_page_change(unpause=False)
if type(screen).__name__ == 'GdkWaylandScreen':
GLib.timeout_add(100, self.setup_screens, screen, 'delayed startup')
[docs]
def load_icons(self):
""" Set the icon list for both windows.
"""
try:
icon_list = [GdkPixbuf.Pixbuf.new_from_file(i) for i in util.list_icons()]
except Exception:
logger.exception('Error loading icons')
return
self.c_win.set_icon_list(icon_list)
self.p_win.set_icon_list(icon_list)
[docs]
def make_cwin(self):
""" Initializes the content window.
"""
self.c_frame.set_property('yalign', self.config.getfloat('content', 'yalign'))
self.c_frame.set_property('xalign', self.config.getfloat('content', 'xalign'))
page_type = self.notes_mode.complement()
self.cache.add_widget(self.c_da, page_type)
self.cache.add_widget(self.c_da, page_type, zoomed = True)
self.c_frame.set_property("ratio", self.doc.page(self.current_page).get_aspect_ratio(page_type))
colourclass = 'white' if self.config.getboolean('content', 'white_blanking') else 'black'
self.c_da.get_style_context().add_class(colourclass)
self.c_win.get_style_context().add_class(colourclass)
self.c_win.insert_action_group('content', self.c_win.get_action_group('win'))
self.c_win.insert_action_group('win', None)
[docs]
def make_pwin(self):
""" Initializes the presenter window.
"""
layout = self.config.get_layout('notes' if self.notes_mode else 'plain')
pane_handles = self.replace_layout(layout, self.p_central, self.placeable_widgets, self.on_pane_event)
self.pane_handle_pos.update(pane_handles)
self.p_frames_next = [self.get_object('p_frame_next{}'.format(n)) for n in range(16)]
self.p_das_next = [self.get_object('p_da_next{}'.format(n)) for n in range(16)]
self.reconfigure_next_frames(None, GLib.Variant.new_int64(self.config.getint('presenter', 'next_slide_count')))
slide_type = self.notes_mode.complement()
self.cache.add_widget(self.p_da_cur, slide_type)
self.cache.add_widget(self.p_da_cur, slide_type, zoomed = True)
# A single cache for all next slides
self.cache.add_widget(self.p_das_next[0], slide_type)
self.cache.add_widget(self.p_da_notes, self.notes_mode, prerender_enabled = bool(self.notes_mode))
self.cache.add_widget(self.scribbler.scribble_p_da, slide_type, prerender_enabled = False)
self.cache.add_widget(self.scribbler.scribble_p_da, slide_type, zoomed = True)
self.cache.add_widget(self.deck.deck0, slide_type, prerender_enabled = False, ignore_max = True)
# set default value
self.page_number.set_last(self.doc.pages_number())
# Enable dropping files onto the window
self.p_win.drag_dest_set(Gtk.DestDefaults.ALL, [], Gdk.DragAction.COPY)
self.p_win.drag_dest_add_text_targets()
self.p_win.insert_action_group('presenter', self.c_win.get_action_group('win'))
self.p_win.insert_action_group('win', None)
[docs]
def reflow_next_frames(self, n_frames=None):
""" Set the number of next frames to preview the the “next slides” panel
Args:
n_frames (`int`): the number of frames
"""
for n in range(self.next_frames_count):
self.grid_next.remove(self.p_frames_next[n])
for n in range(4):
self.grid_next.remove_row(n)
self.grid_next.remove_column(n)
if n_frames is None:
n_frames = self.next_frames_count
ww, wh = self.grid_next.get_allocated_width(), self.grid_next.get_allocated_height()
rows, cols = self.compute_frame_grid(ww / wh, n_frames)
for n in range(n_frames):
self.grid_next.attach(self.p_frames_next[n], n % cols, n // cols, 1, 1)
[docs]
def compute_frame_grid(self, grid_ar, n_frames):
""" Determine the arrangement of frames in a grid to maximise their size given respective aspect ratios
Args:
grid_ar (`float`): aspect ratio of grid containing the slides
n_frames (`int`): the number of frames
"""
if not n_frames:
return 0, 0
page_ratio = self.doc.page(self.preview_page).get_aspect_ratio(self.notes_mode.complement())
grid_ar /= page_ratio
# works best when n_frames = rows * cols * grid_ar
rows = math.sqrt(n_frames / grid_ar)
# If rows < 1 always ceil
if rows < 1:
return 1, n_frames
# Check which of ceiling or flooring rows is better
rows = math.floor(rows)
f_cols, c_cols = (n_frames + rows - 1) // rows, (n_frames + rows) // (rows + 1)
if min(f_cols, grid_ar * rows) > min(c_cols, grid_ar * (rows + 1)):
return rows, f_cols
else:
return rows + 1, c_cols
[docs]
def screens_changed(self, screen):
""" Handle ::monitors-changed events
Args:
screen (:class:`~Gdk.Screen`): the screen
"""
self.setup_screens(screen, 'at monitors-changed event')
GLib.timeout_add(1000, self.setup_screens, screen, 'delayed after monitors-changed event')
[docs]
def setup_screens(self, screen, event_name=''):
""" If multiple monitors, fullscreen windows on monitors according to config.
Args:
screen (:class:`~Gdk.Screen`): the screen
event_name (`str`): a description of what caused the screen setup event, for debugging
"""
display = Gdk.Display.get_default()
try:
c_monitor, p_monitor, primary, non_primary = util.Monitor.lookup_monitors(display, self.c_win, self.p_win)
except util.NoMonitorPositions:
return
# Noisy, but just for debug level
logger.debug('Detecting monitor layout ' + event_name + ': ' + ', '.join([
'Content window is at monitor ' + c_monitor.name,
'Presenter window is at monitor ' + p_monitor.name,
'Primary monitor is (or overlapped with) ' + primary.name,
'No non-primary monitor available' if primary.equal(non_primary)
else 'A non-primary monitor is (or overlapped with) ' + non_primary.name
]))
c_full = self.config.getboolean('content', 'start_fullscreen')
p_full = self.config.getboolean('presenter', 'start_fullscreen')
wayland = type(display).__name__ == 'GdkWaylandDisplay'
if not c_full and not p_full or c_monitor is None or p_monitor is None:
return
if primary.equal(non_primary):
logger.warning(_('Not starting content or presenter window full screen ' +
'because there is only one monitor'))
c_full, p_full = False, False
else:
# To start fullscreen, we need to ensure windows are on individual monitors
if not c_monitor.equal(p_monitor):
pass
elif wayland:
# On Wayland, we can’t move windows, and they happen to be on the same monitor.
# So if we are to fullscreen one, just do it on another monitor
if c_full:
c_monitor = p_monitor.least_intersection([primary, non_primary])
elif p_full:
p_monitor = c_monitor.least_intersection([primary, non_primary])
elif c_monitor.equal(primary):
self.move_window(self.c_win, c_monitor, non_primary)
c_monitor = non_primary
else: # not p_monitor.equal(primary)
self.move_window(self.p_win, p_monitor, primary)
p_monitor = primary
if p_full:
self.p_win.fullscreen_on_monitor(self.p_win.get_screen(), p_monitor.monitor_number)
elif not wayland:
self.p_win.unfullscreen()
if c_full:
self.c_win.fullscreen_on_monitor(self.c_win.get_screen(), c_monitor.monitor_number)
self.set_screensaver(True)
else:
# Let Wayland do its own un-fullscreening as we can’t move the windows afterwards and messing with it
# results in a non-fullscreen window that is out of bounds of the remaining monitors.
if not wayland:
self.c_win.unfullscreen()
self.set_screensaver(False)
self.app.set_action_state('content-fullscreen', c_full)
self.app.set_action_state('presenter-fullscreen', p_full)
[docs]
def move_window(self, win, from_bounds, to_bounds):
""" Move window from monitor number from_monitor to monitor to_monitor.
"""
x, y, w, h = win.get_position() + win.get_size()
win_state = win.get_window().get_state() if win.get_window() is not None else 0
logger.debug('Moving {} window from screen {} to screen {}'.format(
'Content' if win is self.c_win else 'Presenter', from_bounds.name, to_bounds.name
))
if (win_state & Gdk.WindowState.FULLSCREEN) != 0:
win.unfullscreen()
if (win_state & Gdk.WindowState.MAXIMIZED) != 0:
win.unmaximize()
to_w = min(w, to_bounds.width)
to_h = min(h, to_bounds.height)
# Get fraction of free space that is left or top of window
x = (max(0, x - from_bounds.x) / (from_bounds.width - w)) if w < from_bounds.width else 0
y = (max(0, y - from_bounds.y) / (from_bounds.height - h)) if h < from_bounds.height else 0
win.resize(to_w, to_h)
win.move(to_bounds.x + x * (to_bounds.width - to_w), to_bounds.y + y * (to_bounds.height - to_h))
if (win_state & Gdk.WindowState.MAXIMIZED) != 0:
win.maximize()
if (win_state & Gdk.WindowState.FULLSCREEN) != 0:
win.fullscreen()
[docs]
def show_shortcuts(self, *args):
""" Display the shortcuts window.
"""
# Use a different builder to load and be able to release the shortcuts window
shortcuts_builder = builder.Builder()
shortcuts_builder.load_ui('shortcuts')
self.shortcuts_window = shortcuts_builder.get_object('shortcuts_window')
for command, shortcut_list in self.config.items('shortcuts'):
display_shortcut = shortcuts_builder.get_object('shortcut_' + command.replace('-', '_').replace('::', '_'))
if display_shortcut is not None:
display_shortcut.props.accelerator = shortcut_list
self.shortcuts_window.set_transient_for(self.p_win)
self.shortcuts_window.show_all()
self.shortcuts_window.present()
[docs]
def close_shortcuts(self, *args):
""" Destroy the shortcuts window once it is hidden.
"""
self.shortcuts_window.destroy()
self.shortcuts_window = None
##############################################################################
############################ Dynamic resize ##############################
##############################################################################
[docs]
def adjust_bottom_bar_font(self):
""" Scale baseline font size of bottom bar, clipped to 6px..13px. Fonts are then scaled by CSS em indications.
"""
ww, wh = self.p_win.get_size()
font_size = max(6, min(13, ww / 120 if self.show_bigbuttons else ww / 75))
self.css_provider.load_from_data('#bottom {{ font-size: {:.1f}px; }}'.format(font_size).encode())
[docs]
def redraw_panes(self):
""" Handler for :class:`~Gtk.Paned`'s resizing signal.
Used for delayed drawing events of drawing areas inside the panes.
This is very useful on windows where resizing gets sluggish if we try to redraw while resizing.
"""
self.resize_panes = False
self.reflow_next_frames()
self.p_da_cur.queue_draw()
for da in self.p_das_next:
da.queue_draw()
if self.notes_mode:
self.p_da_notes.queue_draw()
if self.redraw_timeout:
self.redraw_timeout = 0
if self.show_annotations:
self.annotations.rewrap_annotations()
self.config.update_layout_from_widgets(self.layout_name(self.notes_mode), self.p_central.get_children()[0],
self.pane_handle_pos)
[docs]
def on_pane_event(self, widget, evt):
""" Signal handler for gtk.paned events.
This function allows one to delay drawing events when resizing, and to speed up redrawing when
moving the middle pane is done (which happens at the end of a mouse resize)
Args:
widget (:class:`~Gtk.Widget`): the widget in which the event occurred (ignored)
evt (:class:`~Gdk.Event`): the event that occurred
"""
if isinstance(evt, Gdk.EventButton) and evt.type == Gdk.EventType.BUTTON_RELEASE:
self.redraw_panes()
elif isinstance(evt, GObject.GParamSpec) and evt.name == "position":
self.resize_panes = True
if self.redraw_timeout:
GLib.Source.remove(self.redraw_timeout)
self.redraw_timeout = GLib.timeout_add(200, self.redraw_panes)
############################################################################
############################ Program lifetime ############################
############################################################################
[docs]
def cleanup(self, *args):
""" Save configuration and exit the main loop.
"""
self.scribbler.disable_scribbling()
self.medias.hide_all()
self.doc.cleanup_media_files()
if self.app.get_action_state('content-fullscreen'):
# In case we used hard-disabling
self.set_screensaver(disabled=False)
##############################################################################
############################ Document management #############################
##############################################################################
[docs]
def swap_document(self, doc_uri, page=0, reloading=False):
""" Replace the currently open document with a new one.
The new document is possibly and EmptyDocument if doc_uri is None.
The state of the ui and cache are updated accordingly.
Args:
doc_uri (`str`): the URI to the new document
page (`int`): the page at which to start the presentation
reloading (`bool`): whether we are reloading or detecting stuff from the document
"""
if self.unsaved_changes(reloading):
# If we keep the unsaved changes and were prompted by automatic file change,
# stop watching for file changes in the future.
if reloading:
self.file_watcher.stop_watching()
return
run_gc = self.doc.doc is not None
try:
self.doc = document.Document.create(self, doc_uri)
if not reloading and doc_uri:
Gtk.RecentManager.get_default().add_item(doc_uri)
self.file_watcher.watch_file(doc_uri, self.reload_document)
elif not reloading:
self.file_watcher.stop_watching()
except GLib.Error:
if reloading:
return
self.doc = document.Document.create(self, None)
self.error_opening_file(doc_uri)
self.file_watcher.stop_watching()
self.current_page = self.preview_page = self.doc.goto(page)
# Guess notes mode by default if the document has notes
if not reloading:
hpref = self.config.get('notes position', 'horizontal')
vpref = self.config.get('notes position', 'vertical')
target_mode = self.doc.guess_notes(hpref, vpref, self.current_page)
if self.notes_mode != target_mode:
self.switch_mode('notes-mode', target_mode=target_mode)
# don't toggle from NONE to NONE
if target_mode:
self.app.activate_action('notes-pos', target_mode.name.lower())
else:
self.doc.set_notes_pos(self.notes_mode.direction())
# Some things that need updating
self.cache.swap_document(self.doc)
self.page_number.set_last(self.doc.pages_number())
self.page_number.enable_labels(self.doc.has_labels())
self.autoplay.set_doc_pages(self.doc.pages_number())
self.medias.purge_media_overlays()
self.timing.set_document_metadata(self.doc.get_structure().copy(), self.doc.page_labels[:])
# A new document, restart at time 0, paused
if not reloading:
self.talk_time.pause()
self.talk_time.reset_timer()
self.page_number.setup_doc_callbacks(self.doc)
self.deck.setup_doc_callbacks(self.doc)
self.do_page_change(unpause=False)
# Now that all references to the old document have been replaced or removed, manually
# collect garbage to delete objects and release file handles / close file descriptors
if run_gc:
gc.collect(1)
[docs]
def reload_document(self):
""" Reload the current document.
"""
self.swap_document(self.doc.get_uri(), page=self.current_page, reloading=True)
[docs]
def on_drag_drop(self, widget, drag_context, x, y, data, info, time):
""" Receive the drag-drops (as text only). If a file is dropped, open it.
Args:
widget (:class:`~Gtk.Widget`): The widget on which the dragged item was dropped
drag_context (:class:`~Gdk.DragContext`): Context object of the dragging
x (`float`): position of the drop
y (`float`): position of the drop
data (:class:`~Gtk.SelectionData`): container for the dropped data
info (`int`): info on the target
time (`int`): time of the drop
"""
uri_parts = urlsplit(data.get_text())
path = pathlib.Path(url2pathname(uri_parts.path) if uri_parts.scheme else uri_parts.path)
if path.is_file() and path.suffix.lower() == '.pdf':
self.swap_document(path.as_uri())
[docs]
def unsaved_changes(self, reload=False):
""" Prompt the user about what to do with changes in the document: save, discard, or cancel action
Args:
reload (`bool`): The unsaved changes is prompted by reloading the file
Returns:
`bool`: `True` iff we need to cancel the current action
"""
if not self.doc.has_changes():
return False
dialog = Gtk.MessageDialog(title=_('Unsaved changes'), transient_for=self.p_win, type=Gtk.MessageType.WARNING)
dialog.set_position(Gtk.WindowPosition.CENTER)
if not reload:
dialog.set_markup(_('Save changes before closing?'))
dialog.format_secondary_markup(_('Unsaved changes will be lost'))
dialog.add_button(Gtk.STOCK_SAVE, Gtk.ResponseType.YES)
dialog.add_button(_('_Discard'), Gtk.ResponseType.NO).set_image(
Gtk.Button.new_from_icon_name('edit-delete', Gtk.IconSize.BUTTON).get_image()
)
dialog.add_button(Gtk.STOCK_CANCEL, Gtk.ResponseType.CANCEL)
dialog.set_default_response(Gtk.ResponseType.YES)
else:
dialog.set_markup(_('The open file was modified outside of pympress but you have made unsaved changes.') +
'\n<b>' + _('Overwrite changes instead of reloading?') + '</b>')
dialog.format_secondary_markup(_('Saving changes will overwrite the changed file!') + '\n' +
_('Unsaved changes will be lost.'))
dialog.add_button(_('Overwrite'), Gtk.ResponseType.YES).set_image(
Gtk.Button.new_from_icon_name('document-save', Gtk.IconSize.BUTTON).get_image()
)
dialog.add_button(_('Reload'), Gtk.ResponseType.NO).set_image(
Gtk.Button.new_from_icon_name('view-refresh', Gtk.IconSize.BUTTON).get_image()
)
dialog.add_button(Gtk.STOCK_CANCEL, Gtk.ResponseType.CANCEL)
dialog.set_default_response(Gtk.ResponseType.YES)
response = dialog.run()
dialog.destroy()
if response == Gtk.ResponseType.YES:
self.doc.save_changes()
return response == Gtk.ResponseType.CANCEL or (reload and Gtk.ResponseType == Gtk.ResponseType.YES)
[docs]
def save_file_as(self, *args):
""" Remove the current document.
"""
# Use a GTK file dialog to choose file
dialog = Gtk.FileChooserDialog(title = _('Save as...'), transient_for = self.p_win,
action = Gtk.FileChooserAction.SAVE)
dialog.add_buttons(Gtk.STOCK_SAVE_AS, Gtk.ResponseType.OK)
dialog.set_default_response(Gtk.ResponseType.OK)
dialog.set_position(Gtk.WindowPosition.CENTER)
file_filter = Gtk.FileFilter()
file_filter.set_name(_('PDF files'))
file_filter.add_mime_type('application/pdf')
file_filter.add_pattern('*.pdf')
dialog.add_filter(file_filter)
file_filter = Gtk.FileFilter()
file_filter.set_name(_('All files'))
file_filter.add_pattern('*')
dialog.add_filter(file_filter)
response = dialog.run()
if response == Gtk.ResponseType.OK:
self.doc.save_changes(dialog.get_uri())
dialog.destroy()
[docs]
def pick_file(self, *args):
""" Ask the user which file he means to open.
"""
# Use a GTK file dialog to choose file
dialog = Gtk.FileChooserDialog(title = _('Open...'), transient_for = self.p_win,
action = Gtk.FileChooserAction.OPEN)
dialog.add_buttons(Gtk.STOCK_OPEN, Gtk.ResponseType.OK)
dialog.set_default_response(Gtk.ResponseType.OK)
dialog.set_position(Gtk.WindowPosition.CENTER)
file_filter = Gtk.FileFilter()
file_filter.set_name(_('PDF files'))
file_filter.add_mime_type('application/pdf')
file_filter.add_pattern('*.pdf')
dialog.add_filter(file_filter)
file_filter = Gtk.FileFilter()
file_filter.set_name(_('All files'))
file_filter.add_pattern('*')
dialog.add_filter(file_filter)
response = dialog.run()
if response == Gtk.ResponseType.OK:
self.swap_document(dialog.get_uri())
dialog.destroy()
[docs]
def error_opening_file(self, uri):
""" Remove the current document.
Args:
uri (`str`): the URI of the document
"""
# Check if the path is valid
uri_parts = urlsplit(uri)
filename = pathlib.Path(url2pathname(uri_parts.path))
if uri_parts.scheme == 'file' and not filename.exists():
msg = _('Could not find the file "{}"').format(filename)
else:
msg = _('Error opening the file "{}"').format(uri)
dialog = Gtk.MessageDialog(transient_for=self.p_win, flags=Gtk.DialogFlags.MODAL,
message_type=Gtk.MessageType.ERROR, message_format=msg)
dialog.add_button(Gtk.STOCK_CLOSE, Gtk.ResponseType.CLOSE)
dialog.set_position(Gtk.WindowPosition.CENTER)
dialog.run()
dialog.destroy()
[docs]
def close_file(self, *args):
""" Remove the current document.
"""
self.swap_document(None)
[docs]
def save_file(self, *args):
""" Remove the current document.
"""
self.doc.save_changes()
[docs]
def open_file(self, gaction, target):
""" Open a document.
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
target (:class:`~GLib.Variant`): the file to open as a string variant
"""
self.swap_document(target.get_string())
[docs]
def get_notes_mode(self):
""" Simple getter.
Returns:
:class:`~pympress.document.PdfPage`: Truthy when we split slides in content + notes
"""
return self.notes_mode
##############################################################################
############################ Displaying content ############################
##############################################################################
[docs]
def on_page_change(self, widget, event=None):
""" Signal handler for current page editing.
Args:
widget (:class:`~Gtk.Widget`): the editable widget which has received the event.
event (:class:`~Gdk.Event`): the GTK event.
"""
widget_text = widget.get_buffer().get_text()
try:
display_page_num = int(widget_text)
except ValueError:
return
else:
self.goto_page(display_page_num - 1)
[docs]
def goto_page(self, page, autoplay=False):
""" Handle going to the page passed as argument
Args:
page (`int`): the page to which to go. Will be clipped to document pages.
autoplay (`bool`): whether this page change was triggered automatically
"""
self.preview_page = self.doc.goto(page)
if not self.page_number.editing:
self.current_page = self.preview_page
self.do_page_change(autoplay=autoplay)
[docs]
def doc_goto_prev(self, gaction=None, param=None):
""" Handle going to the next page.
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
self.goto_page(self.preview_page - 1)
[docs]
def doc_goto_next(self, gaction=None, param=None):
""" Handle going to the previous page.
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
if not self.page_number.editing and self.talk_time.paused:
self.talk_time.unpause()
else:
self.goto_page(self.preview_page + 1)
[docs]
def doc_label_next(self, gaction=None, param=None):
""" Handle going to the next page with a different label.
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
self.goto_page(self.doc.label_after(self.preview_page))
[docs]
def doc_label_prev(self, gaction=None, param=None):
""" Handle going to the previous page with a different label.
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
self.goto_page(self.doc.label_before(self.preview_page))
[docs]
def doc_hist_prev(self, gaction=None, param=None):
""" Handle going to the previous page in the history of visited pages
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
dest = self.doc.hist_prev()
if dest is not None:
self.goto_page(dest)
[docs]
def doc_hist_next(self, gaction=None, param=None):
""" Handle going to the next page in the history of visited pages
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
dest = self.doc.hist_next()
if dest is not None:
self.goto_page(dest)
[docs]
def doc_goto_home(self, gaction=None, param=None):
""" Handle going to the start of the document
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
self.goto_page(0)
[docs]
def doc_goto_end(self, gaction=None, param=None):
""" Handle going to the end of the document
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
"""
self.goto_page(self.doc.pages_number())
[docs]
def do_page_change(self, unpause=True, autoplay=False):
""" Switch to another page and display it.
This is a kind of event which is supposed to be called only from the
:class:`~pympress.document.Document` class.
Args:
is_preview (`bool`): `True` if the page change should not update the content
unpause (`bool`): `True` if the page change should unpause the timer, `False` otherwise
autoplay (`bool`): `True` if the page change is triggered automatically, otherwise cancel auto play
"""
is_preview = self.page_number.editing
if not is_preview:
self.preview_page = self.current_page
self.app.set_action_state('page', self.current_page + 1)
draw_notes = self.notes_mode
draw_page = draw_notes.complement()
page_content = self.doc.page(self.current_page)
page_preview = self.doc.page(self.preview_page)
pages_next = [self.doc.page(self.preview_page + n + 1) for n in range(self.next_frames_count)]
page_notes = self.doc.notes_page(self.preview_page)
# Aspect ratios and queue redraws
if draw_notes and page_notes is not None:
note_pr = page_notes.get_aspect_ratio(draw_notes)
self.p_frame_notes.set_property('ratio', note_pr)
self.p_da_notes.queue_draw()
preview_pr = page_preview.get_aspect_ratio(draw_page)
self.p_frame_cur.set_property('ratio', preview_pr)
self.p_da_cur.queue_draw()
if not is_preview:
content_pr = page_content.get_aspect_ratio(draw_page)
self.c_frame.set_property('ratio', content_pr)
self.c_da.queue_draw()
self.scribbler.scribble_p_frame.set_property('ratio', content_pr)
self.scribbler.scribble_p_frame.queue_draw()
next_pr = preview_pr # A default page ratio
for page, frame, da in zip(pages_next, self.p_frames_next, self.p_das_next):
if page is not None:
next_pr = page.get_aspect_ratio(draw_page)
frame.set_property('ratio', next_pr)
da.queue_draw()
self.annotations.load_annotations(page_preview)
# Update display -- needs to be different ?
self.page_number.update_page_numbers(self.preview_page, page_preview.label())
# Prerender the 4 next pages and the 2 previous ones
page_max = min(self.doc.pages_number(), self.preview_page + self.next_frames_count + 4)
page_min = max(0, self.preview_page - 2)
for p in list(range(self.preview_page + 1, page_max)) + list(range(self.preview_page, page_min, -1)):
self.cache.prerender(p)
if is_preview:
return
# Remove scribbles and scribbling/zooming modes
if self.scribbler.page_change_exits:
self.scribbler.disable_scribbling()
self.scribbler.page_change(self.preview_page, page_preview.label())
self.zoom.stop_zooming()
# Update medias
self.medias.replace_media_overlays(self.doc.page(self.current_page), draw_page)
# Start counter if needed
if unpause:
self.talk_time.unpause()
if not autoplay:
self.autoplay.stop_looping()
self.timing.transition(self.preview_page, self.talk_time.current_time())
[docs]
def on_draw(self, widget, cairo_context):
""" Manage draw events for both windows.
This callback may be called either directly on a page change or as an
event handler by GTK. In both cases, it determines which widget needs to
be updated, and updates it, using the
:class:`~pympress.surfacecache.SurfaceCache` if possible.
Args:
widget (:class:`~Gtk.Widget`): the widget to update
cairo_context (:class:`~cairo.Context`): the Cairo context (or `None` if called directly)
"""
if widget is self.c_da:
# Current page
if self.blanked:
return
page = self.doc.page(self.current_page)
elif widget is self.p_da_cur or widget is self.scribbler.scribble_p_da:
# Current page 'preview'
page = self.doc.page(self.preview_page)
elif widget is self.p_da_notes:
# Notes page, aligned with preview
page = self.doc.notes_page(self.preview_page)
elif widget in self.p_das_next:
offset = 1 + int(widget.get_name()[len('p_da_next'):])
page = self.doc.page(self.preview_page + offset)
# No next page: just return so we won't draw anything
if page is None:
return
else:
logger.warning(_('Unknown widget "{}" to draw'.format(widget.get_name())))
if page is None:
if widget is not self.p_da_notes or self.notes_mode.direction() != 'page mapping':
logger.warning(_('Unexpected missing page to draw for widget "{}"'.format(widget.get_name())))
return
if not page.can_render():
return
name = widget.get_name().rstrip('0123456789')
nb = page.number() # Use PDF page numbering for the cache
wtype = self.cache.get_widget_type(name)
ww, wh = widget.get_allocated_width(), widget.get_allocated_height()
window = widget.get_window()
scale = window.get_scale_factor()
if self.zoom.scale != 1. and (widget is self.p_da_cur or widget is self.c_da or
widget is self.scribbler.scribble_p_da):
zoom_matrix = self.zoom.get_matrix(ww, wh)
name += '_zoomed'
else:
zoom_matrix = cairo.Matrix()
pb = self.cache.get(name, nb)
if pb is None:
if self.resize_panes and widget in self.p_das_next + [self.p_da_cur, self.p_da_notes]:
# too slow to render here when resize_panes things
return
# Cache miss: render the page, and save it to the cache
try:
pb = window.create_similar_image_surface(cairo.Format.RGB24, ww * scale, wh * scale, scale)
except cairo.Error:
logger.warning('Failed creating an RGB24 surface sized {}x{} scale {} for widget {}'
.format(ww * scale, wh * scale, scale, name), exc_info=True)
if widget is self.c_da:
cairo_context.save()
cairo_context.set_source_rgb(0, 0, 0)
cairo_context.fill()
cairo_context.paint()
cairo_context.restore()
return
cairo_prerender = cairo.Context(pb)
cairo_prerender.transform(zoom_matrix)
page.render_cairo(cairo_prerender, ww, wh, wtype)
self.cache.put(name, nb, pb)
cairo_context.set_source_surface(pb, 0, 0)
cairo_context.paint()
else:
# Cache hit: draw the surface from the cache to the widget
cairo_context.set_source_surface(pb, 0, 0)
cairo_context.paint()
if widget is self.c_da or widget is self.p_da_cur or widget is self.scribbler.scribble_p_da:
cairo_context.save()
cairo_context.transform(zoom_matrix)
self.scribbler.draw_scribble(widget, cairo_context)
self.zoom.draw_zoom_target(widget, cairo_context)
cairo_context.restore()
if widget is self.c_da or widget is self.p_da_cur or widget is self.scribbler.scribble_p_da:
# do not use the zoom matrix for the pointer, it is relative to the screen not the slide
self.laser.render_pointer(cairo_context, ww, wh)
[docs]
def clear_zoom_cache(self):
""" Callback to clear the cache of zoomed widgets.
"""
self.cache.clear_cache(self.c_da.get_name() + '_zoomed')
self.cache.clear_cache(self.p_da_cur.get_name() + '_zoomed')
self.cache.clear_cache(self.scribbler.scribble_p_da.get_name() + '_zoomed')
[docs]
def redraw_current_slide(self):
""" Callback to queue a redraw of the current slides (in both winows).
"""
self.c_da.queue_draw()
self.p_da_cur.queue_draw()
self.scribbler.scribble_p_da.queue_draw()
##############################################################################
############################ User inputs ############################
##############################################################################
[docs]
def track_motions(self, widget, event):
""" Track mouse motion events.
Handles mouse motions on the "about" menu.
Args:
widget (:class:`~Gtk.Widget`): the widget that received the mouse motion
event (:class:`~Gdk.Event`): the GTK event containing the mouse position
Returns:
`bool`: whether the event was consumed
"""
if self.zoom.track_zoom_target(widget, event):
return True
elif self.scribbler.track_scribble(widget, event):
return True
elif self.laser.track_pointer(widget, event):
return True
else:
return self.hover_link(widget, event)
[docs]
def track_clicks(self, widget, event):
""" Track mouse press and release events.
Handles clicks on the slides.
Args:
widget (:class:`~Gtk.Widget`): the widget that received the click
event (:class:`~Gdk.Event`): the GTK event containing the click position
Returns:
`bool`: whether the event was consumed
"""
if self.zoom.toggle_zoom_target(widget, event):
return True
elif self.scribbler.toggle_scribble(widget, event):
return True
elif self.laser.toggle_pointer(widget, event):
return True
else:
return self.click_link(widget, event)
[docs]
def click_link(self, widget, event):
""" Check whether a link was clicked and follow it.
Handles a click on a slide.
Args:
widget (:class:`~Gtk.Widget`): the widget in which the event occurred
event (:class:`~Gdk.Event`): the event that occurred
Returns:
`bool`: whether the event was consumed
"""
if event.type == Gdk.EventType.BUTTON_RELEASE:
return False
# Where did the event occur?
if widget in self.p_das_next:
offset = 1 + int(widget.get_name()[len('p_da_next'):])
page = self.doc.page(self.preview_page + offset)
elif widget is self.p_da_notes:
page = self.doc.notes_page(self.preview_page)
elif widget is self.p_da_cur:
page = self.doc.page(self.preview_page)
else:
page = self.doc.page(self.current_page)
if page is None:
return False
x, y = self.zoom.get_slide_point(widget, event)
page_mode = self.notes_mode if widget is self.p_da_notes else self.notes_mode.complement()
link = page.get_link_at(x, y, page_mode)
if event.type == Gdk.EventType.BUTTON_PRESS and link is not None:
link.follow()
return True
else:
return False
[docs]
def hover_link(self, widget, event):
""" Manage events related to hyperlinks, setting the cursor to a pointer if the hovered region is clickable.
Args:
widget (:class:`~Gtk.Widget`): the widget in which the event occurred
event (:class:`~Gdk.Event`): the event that occurred
Returns:
`bool`: whether the event was consumed
"""
if event.type != Gdk.EventType.MOTION_NOTIFY:
return False
# Where did the event occur?
if widget in self.p_das_next:
offset = 1 + int(widget.get_name()[len('p_da_next'):])
page = self.doc.page(self.preview_page + offset)
elif widget is self.p_da_notes:
page = self.doc.notes_page(self.preview_page)
elif widget is self.p_da_cur:
page = self.doc.page(self.preview_page)
else:
page = self.doc.page(self.current_page)
if page is None:
return False
x, y = self.zoom.get_slide_point(widget, event)
page_mode = self.notes_mode if widget is self.p_da_notes else self.notes_mode.complement()
if page.get_link_at(x, y, page_mode):
extras.Cursor.set_cursor(widget, 'pointer')
return False
else:
extras.Cursor.set_cursor(widget, 'parent')
return True
[docs]
def switch_fullscreen(self, gaction, target):
""" Switch the Content window to fullscreen (if in normal mode) or to normal mode (if fullscreen).
Screensaver will be disabled when entering fullscreen mode, and enabled
when leaving fullscreen mode.
Args:
widget (:class:`~Gtk.Widget`): the widget in which the event occurred
Returns:
`bool`: whether some window's full screen status got toggled
"""
if gaction.get_name() == 'content-fullscreen':
widget = self.c_win
elif gaction.get_name() == 'presenter-fullscreen':
widget = self.p_win
else:
raise ValueError('Do not know which widget to put full screen')
if widget != self.c_win and widget != self.p_win:
logger.error(_("Unknow widget {} to be fullscreened, aborting.").format(widget))
return False
toggle_to = not gaction.get_state().get_boolean()
window = widget.get_window()
cur_state = (window.get_state() & Gdk.WindowState.FULLSCREEN) if window is not None else False
if cur_state:
widget.unfullscreen()
else:
widget.fullscreen()
if gaction.get_name() == 'content-fullscreen':
self.set_screensaver(disabled=toggle_to)
gaction.change_state(GLib.Variant.new_boolean(toggle_to))
return True
[docs]
def set_screensaver(self, disabled):
""" Disable or re-enable the screensaver.
Args:
disabled (`bool`): `True` iff the screensaver should be disabled, otherwise enabled.
"""
if not disabled:
if self.inhibit_cookie:
self.app.uninhibit(self.inhibit_cookie)
elif self.inhibit_cookie is not None:
util.hard_set_screensaver(disabled=False)
self.inhibit_cookie = None
else:
flags = (Gtk.ApplicationInhibitFlags.LOGOUT | Gtk.ApplicationInhibitFlags.SWITCH |
Gtk.ApplicationInhibitFlags.SUSPEND | Gtk.ApplicationInhibitFlags.IDLE)
self.inhibit_cookie = self.app.inhibit(self.c_win, flags, _("Fullscreen Presentation running"))
if not self.inhibit_cookie:
logger.warning(_('Gtk.Application.inhibit failed preventing screensaver, trying hard disabling'))
util.hard_set_screensaver(disabled=True)
[docs]
def update_frame_position(self, widget, user_data):
""" Callback to preview the frame alignment, called from the Gtk.SpinButton.
Args:
widget (:class:`~Gtk.SpinButton`): The button updating the slide alignment in the drawing area widget
user_data (`str`): The property being set, either the x or y alignment (resp. xalign and yalign).
"""
self.c_frame.set_property(user_data, widget.get_value())
[docs]
def adjust_frame_position(self, *args):
""" Select how to align the frame on screen.
"""
win_aspect_ratio = float(self.c_win.get_allocated_width()) / self.c_win.get_allocated_height()
if win_aspect_ratio <= float(self.c_frame.get_property("ratio")):
prop = "yalign"
else:
prop = "xalign"
val = self.c_frame.get_property(prop)
button = Gtk.SpinButton()
button.set_adjustment(Gtk.Adjustment(lower=0.0, upper=1.0, step_increment=0.01))
button.set_digits(2)
button.set_value(val)
button.connect("value-changed", self.update_frame_position, prop)
popup = Gtk.Dialog(title = _("Adjust alignment of slides in projector screen"), transient_for = self.p_win)
popup.add_buttons(Gtk.STOCK_CANCEL, Gtk.ResponseType.CANCEL, Gtk.STOCK_OK, Gtk.ResponseType.OK)
box = popup.get_content_area()
box.add(button)
popup.show_all()
response = popup.run()
popup.destroy()
# revert if we cancelled
if response == Gtk.ResponseType.CANCEL:
self.c_frame.set_property(prop, val)
else:
self.config.set('content', prop, str(button.get_value()))
##############################################################################
############################ Option toggles ############################
##############################################################################
[docs]
def swap_screens(self, *args):
""" Swap the monitors on which each window is displayed (if there are 2 monitors at least).
"""
display = Gdk.Display.get_default()
try:
c_monitor, p_monitor, primary, non_primary = util.Monitor.lookup_monitors(display, self.c_win, self.p_win)
except util.NoMonitorPositions:
return
if primary.equal(non_primary) == 1 or p_monitor.equal(c_monitor):
return
logger.debug('Swapping screens:')
self.move_window(self.c_win, c_monitor, p_monitor)
self.move_window(self.p_win, p_monitor, c_monitor)
[docs]
def switch_blanked(self, gaction, param):
""" Switch the blanked mode of the content screen.
Args:
gaction (:class:`~Gio.Action`): the action triggering the call
param (:class:`~GLib.Variant`): the parameter as a variant, or None
Returns:
`bool`: whether the notes blanking has been toggled.
"""
self.blanked = not self.blanked
self.c_da.queue_draw()
gaction.change_state(GLib.Variant.new_boolean(self.blanked))
return True
[docs]
def layout_name(self, notes_mode):
""" Return the layout made for the selected notes_mode
Args:
notes_mode (:class:`~pympress.document.PdfPage`): the mode/positioning of notes
Returns:
`str`: a string representing the appropriate layout
"""
if self.scribbler.scribbling_mode:
return 'highlight'
elif self.deck.deck_mode:
return 'deck'
elif notes_mode.direction() == 'page number':
return 'note_pages'
elif notes_mode:
return 'notes'
else:
return 'plain'
[docs]
def load_layout(self, new):
""" Replace the current layout
Args:
new (`str`): the name of the layout to load, `None` to use current layout automatically
"""
if new is None:
new = self.layout_name(self.notes_mode)
else:
self.layout_editor.set_current_layout(new)
pane_handles = self.replace_layout(self.config.get_layout(new), self.p_central,
self.placeable_widgets, self.on_pane_event)
self.scribbler.adjust_tools_orientation()
self.pane_handle_pos.update(pane_handles)
# queue visibility of all newly added widgets, make sure visibility is right
self.p_central.show_all()
self.p_frame_annot.set_visible(self.show_annotations)
[docs]
def change_notes_pos(self, gaction, target, force=False):
""" Switch the position of the nodes in the slide.
Returns:
gaction (:class:`~Gio.Action`): the action triggering the call
target (:class:`~GLib.Variant`): the notes position as a string variant
force (`bool`): Whether to force the notes switch even if it’s already enabled
Returns:
`bool`: whether the notes position has been toggled
"""
target_mode = document.PdfPage[target.get_string().upper()]
# Redundant toggle, do nothing
if target_mode == self.chosen_notes_mode:
return False
# Update the choice, except for NONE or BEFORE/AFTER or EVEN/ODD
if target_mode:
self.chosen_notes_mode = target_mode
gaction.change_state(target)
self.config.set('notes position', target_mode.direction(), target_mode.name.lower())
# Change the notes arrangement if they are enabled or if we are forced to
if self.notes_mode or force:
self.switch_mode(self.app.lookup_action('notes-mode'), target_mode=target_mode, force=True)
return True
[docs]
def switch_mode(self, gaction, target_mode=None, force=False):
""" Switch the display mode to "Notes mode" or "Normal mode" (without notes).
Returns:
gaction (:class:`~Gio.Action`): the action triggering the call
target_mode (:class:`~pympress.document.PdfPage`): the mode to which we should switch
force (`bool`): Whether to force the mode switch even if it’s already enabled
Returns:
`bool`: whether the notes mode has been toggled
"""
if target_mode is None:
target_mode = document.PdfPage.NONE if self.notes_mode else self.chosen_notes_mode
if target_mode == self.notes_mode and not force:
return False
self.scribbler.disable_scribbling()
self.doc.set_notes_pos(target_mode.direction())
self.load_layout(self.layout_name(target_mode))
# Transform or clip page number appropriately
renumber_page = (target_mode.direction() == 'page parity') - (self.notes_mode.direction() == 'page parity')
if renumber_page < 0:
self.preview_page *= 2
self.current_page *= 2
elif renumber_page > 0:
self.preview_page //= 2
self.current_page //= 2
elif target_mode.direction() == 'page number':
self.preview_page = min(self.preview_page, self.doc.pages_number())
self.current_page = min(self.current_page, self.doc.pages_number())
self.notes_mode = target_mode
page_type = self.notes_mode.complement()
self.cache.set_widget_type('c_da', page_type)
self.cache.set_widget_type('c_da_zoomed', page_type)
self.cache.set_widget_type('p_da_next', page_type)
self.cache.set_widget_type('p_da_cur', page_type)
self.cache.set_widget_type('p_da_cur_zoomed', page_type)
self.cache.set_widget_type('scribble_p_da', page_type)
self.cache.set_widget_type('p_da_notes', self.notes_mode)
self.cache.set_widget_type('deck', page_type)
if self.notes_mode:
self.cache.enable_prerender('p_da_notes')
self.cache.disable_prerender('p_da_cur')
else:
self.cache.disable_prerender('p_da_notes')
self.cache.enable_prerender('p_da_cur')
self.medias.adjust_margins_for_mode(page_type)
self.do_page_change(unpause=False)
self.page_number.set_last(self.doc.pages_number())
self.app.set_action_state('notes-mode', bool(self.notes_mode))
return True
[docs]
def switch_annotations(self, gaction, target):
""" Switch the display to show annotations or to hide them.
Returns:
gaction (:class:`~Gio.Action`): the action triggering the call
target (:class:`~GLib.Variant`): the parameter as a variant, or None
Returns:
`bool`: whether the mode has been toggled.
"""
self.show_annotations = not self.show_annotations
self.p_frame_annot.set_visible(self.show_annotations)
self.config.set('presenter', 'show_annotations', 'on' if self.show_annotations else 'off')
if self.show_annotations:
parent = self.p_frame_annot.get_parent()
if issubclass(type(parent), Gtk.Paned):
if parent.get_orientation() == Gtk.Orientation.HORIZONTAL:
size = parent.get_allocated_width()
else:
size = parent.get_allocated_height()
parent.set_position(self.pane_handle_pos[parent] * size)
self.annotations.rewrap_annotations()
GLib.idle_add(self.redraw_panes)
self.annotations.load_annotations(self.doc.page(self.preview_page))
gaction.change_state(GLib.Variant.new_boolean(self.show_annotations))
return True
##
# Local Variables:
# mode: python
# indent-tabs-mode: nil
# py-indent-offset: 4
# fill-column: 80
# end: