4.2  mdiimageviewer – Synchable image viewers using MDI style interface

4.2.1  Inheritance Diagram

4.2.2  Description

This module implements the MDIImageViewerWindow class which allows optionally synchronized panning and zooming of multiple QPixmaps.

It contains the following classes:

• MdiChild – ImageViewer implements mouse drag panning that is activated by pressing the <Space> key.

• MDIImageViewerWindow – Views multiple images (QPixmaps) with optionally synchonized zooming & panning.

4.2.3  Reference

4.2.3.1  MdiChild

class mdiimageviewer.MdiChild(pixmap, filename, name)

Bases: imageviewer.ImageViewer

ImageViewer that implements <Space> key pressed panning.

Parameters:

• pixmap (QPixmap or None) – QPixmap to display

• filename (str or None) – QPixmap filename

• name (str or None) – name associated with this ImageViewer

currentFile

Current filename (str).

userFriendlyCurrentFile

Get current filename without path (str).

keyPressEvent(keyEvent)

Overrides to enable panning while dragging.

Parameters:

• keyEvent (QKeyEvent) – instance of QKeyEvent

keyReleaseEvent(keyEvent)

Overrides to disable panning while dragging.

Parameters:

• keyEvent (QKeyEvent) – instance of QKeyEvent

4.2.3.2  MDIImageViewerWindow

class mdiimageviewer.MDIImageViewerWindow

Bases: PyQt4.QtGui.QMainWindow

Views multiple images with optionally synchonized zooming & panning.

createMappedAction(icon, text, parent, shortcut, methodName)

Create QAction that is mapped via methodName to call.

Parameters:

• icon (QIcon or None) – icon associated with QAction

• text (str) – the QAction descriptive text

• parent (QObject) – the parent QObject

• shortcut (QKeySequence) – the shortcut QKeySequence

• methodName (str) – name of method to call when QAction is triggered

Return type:

QAction

createActions()

Create actions used in menus.

createMenus()

Create menus.

updateMenus()

Update menus.

updateRecentFileActions()

Update recent file menu items.

updateWindowMenu()

Update the Window menu.

createStatusBarLabel(stretch=0)

Create status bar label.

Parameters:

• stretch (int) – stretch factor

Return type:

QLabel

createStatusBar()

Create status bar.

activeMdiChild

Get active MDI child (MdiChild or None).

closeEvent(event)

Overrides close event to save application settings.

Parameters:

• event (QEvent) – instance of QEvent

mappedImageViewerAction(methodName)

Perform action mapped to imageviewer.ImageViewer methodName.

Parameters:

• methodName (str) – method to call

toggleSynchPan()

Toggle synchronized subwindow panning.

panChanged()

Synchronize subwindow pans.

toggleSynchZoom()

Toggle synchronized subwindow zooming.

zoomChanged()

Synchronize subwindow zooms.

activateSubwindowSystemMenu()

Activate current subwindow’s System Menu.

openRecentFile(filename)

Open a recent file.

Parameters:

• filename (str) – filename to view

open()

Handle the open action.

toggleScrollbars()

Toggle subwindow scrollbar visibility.

toggleStatusbar()

Toggle status bar visibility.

about()

Display About dialog box.

subWindowActivated(window)

Handle QMdiSubWindow activated signal.

Parameters:

• window (QMdiSubWindow) – QMdiSubWindow that was just activated

setActiveSubWindow(window)

Set active QMdiSubWindow.

Parameters:

• window (QMdiSubWindow) – QMdiSubWindow to activate

loadFile(filename)

Load filename into new MdiChild window.

Parameters:

• filename (str) – filename to load

updateStatusBar()

Update status bar.

createMdiChild(pixmap, filename)

Create new MdiChild for pixmap.

Parameters:

• pixmap (QPixmap or None) – QPixmap to display in MdiChild

• filename (str or None) – QPixmap filename

Return type:

MdiChild

switchLayoutDirection()

Switch MDI subwindow layout direction.

synchPan(fromViewer)

Synch panning of all subwindowws to the same as fromViewer.

Parameters:

• fromViewer – MdiChild that initiated synching

synchZoom(fromViewer)

Synch zoom of all subwindowws to the same as fromViewer.

Parameters:

• fromViewer – MdiChild that initiated synching

saveDialogState(dialog, groupName)

Save dialog state, position & size.

Parameters:

• dialog (QDialog) – dialog to save state of

• groupName (str) – QSettings group name

restoreDialogState(dialog, groupName)

Restore dialog state, position & size.

Parameters:

• groupName (str) – QSettings group name

writeSettings()

Write application settings.

readSettings()

Read application settings.

updateRecentFileSettings(filename, delete=False)

Update recent file list setting.

Parameters:

• filename (str) – filename to add or remove from recent file list

• delete (bool) – if True then filename removed, otherwise added