Page View¶

This document describes features of the pageview plugin and how to test them.

Some of the sample URLs rely on the Kitodo.Presentation DDEV system.

Image Sources¶

The viewer supports various image formats. Each of them should work in single page and double page mode.

For Zoomify and IIPImage, the sample METS files may be used via a local file server (e.g., by copying them to the public/ folder of the DDEV system).

Features¶

Basic Features¶

Zoom and rotate
- Buttons from Digital Collections template
- Stepless: Drag the image while pressing Shift.
- Zoom via mouse wheel
- Zoom via + and - keys
Pan the image
- Pan by mouse dragging
- Pan via arrow keys

Image Manipulation¶

In the Digital Collections template, activate the tool by clicking the slider button.

Full Text¶

In the Digital Collections template, the following full text features are available:

Click the reading-glass icon on the left to toggle the fulltext overlay. When hovering a text line on the image, the corresponding part should be highlighted in the overlay.
When showing an indexed document, click the search icon on the right to toggle in-document search. Search results should be highlighted on the page.
In single page mode, click the download link and select “Fulltext page (TXT)” to download the raw text.

Overview Map and Zoom Buttons¶

Additional OpenLayers controls may be configured in TypoScript:

plugin.tx_dlf_pageview {
  settings {
    features = OverviewMap,ZoomPanel
  }
}

These are created in dlfViewer::createControls_().

Tools for Basket Plugin¶

There are additional tools for the basket plugin:

Magnifier: Show zoomed page at mouse location in a separate panel.
Cropping Tool: Select a region that should be added to the baseket.

To insert links for activating these tools into the default PageView template, the following settings may be used:

plugin.tx_dlf_pageview {
  settings {
    basket {
      magnifier = 1
      crop = 1
    }

    // The basket must be configured for these settings to take effect
    basketButton = 1
    targetBasket = 123
  }
}

Magnifier¶

To use the magnifier, the page must contain an element with the id ov_map. It is included in the default PageView template.
```
<div id="ov_map" style="height: 200px;"></div>
```
The magnifier can be activated manually via JavaScript:
```
tx_dlf_viewer.activateMagnifier();
```

Cropping Tool¶

Activate and reset manually:

tx_dlf_viewer.activateSelection();
tx_dlf_viewer.resetCropSelection();