Differences

This shows you the differences between two versions of the page.

--- viewport [2022/02/07 17:45]
yves [Color control]
+++ viewport [2022/02/07 19:51]
yves [Z-stacked content]
@@ Line 29: / Line 29: @@
 {{ ::viewport_panning4.png?direct&400 |}}
 ==== Zooming in ====
+PMA.UI's viewport offers different ways to zoom in on a slide.
+The simplest way is to use the scrollwheel on your mouse: pushing the scrollwheel forward (away from you) lets your zoom in; bringing it toward you (or scrolling //backwards//) zoom out again. Furthermore, we've optimized the speed of interaction so that you can go from the highest level of viewing to the deepest level in one smooth sweeping motion.
+If you don't have a mouse, or want precision control, you can use the zoom controls in the top-left corner of the screen, too. There are plus and minus button to zoom in (increase magnification) or zoom out (reduce magnification).
+{{ ::viewport_zooming1.png?direct&200 |}}
+There is also the zoombar. You interact with that one by moving the slider up and down to control your magnification.
+{{ ::viewport_zooming2.png?direct&200 |}}
+The zoombar is useful even if you don't use it to control your magnification: it also indicates whether you are looking at content through optimal magnification or digital pmagnificaion.  The number of articifically added zoomlevels for digital zoom can be controlled in PMA.UI, or even disabled altogether.
+{{ ::viewport_zooming3.png?direct&200 |}}
+On mobile devices, //pinching// also works (use the pinch manoever to rotate your content, too!).
 ==== Keeping track ====
-==== Color control ====
+The thumbnail widget has a special button that allows you to track your progress throughout a slide:
+{{ ::viewport_tracking.png?direct&200 |}}
+Once enabled, a gray overlay covers your slide's thumbnail, with pieces of it gradually disappearing, as you start navigating your side. The zoomlevel at which you inspect a specific region of interest, influences the outline color in the tracking screen.
+{{ :viewport_tracking2.png?direct&400 |}}
+This kind of tracking is instantaneous and ad-hoc. When you close the viewport, it disappears, and its history is not logged. If you're interested in tracking viewing operations over time and across your use population, you should have a look at the [[heatmap]] functionality instead.
+==== Color correction ====
 The default PMA.UI representation in PMA.core shows a color correction widget in the top-right corner of the viewport.
@@ Line 40: / Line 67: @@
 Use it to control brightness, contrast, and gamma correction.
 ==== Fluorescent content ====
+When your slide contains one or more fluorescent color channels, a separate widget appears in the left-hand side of the viewport to allow controls over there.
+{{ ::fluo1.png?direct&400 |}}
+Names of channels are copied from the original file format, where possible.
+You can control the visibility range of each channel individually through the scrollbar underneath each channel.
+{{ ::fluo2.png?direct&400 |}}
+Color ranges are supported both in 8 bit and 16 bit. Version 2.0.0 only supports 8 bit channels, which sometimes lead to color bleading. This was resolved in [[what_s_new_in_version_2.0.1|version 2.0.1]] and higher.
 ==== Z-stacked content ====
+Similar to fluorescent slides; when a slide turns out to contain mutliple planes / stacks, a new widget appears automatically in the left-hand side of the viewport, allowing the end-user to navigate through the various layers.
+{{ ::viewport_zstack.png?direct&200 |}}
+We have a [[https://realdata.pathomation.com/blur-detection-in-z-stacks/|blog article on how you can analyze a z-stack]] to artifically compose a new slide that contains the sharpest tile at each position from the slide.

PMA.core 3.0.1

User Tools

Site Tools

Differences

Page Tools