Basic Controls
Panning
The Viewer supports multiple ways for navigating images in the Viewer using the mouse and keyboard.
To pan an image with the mouse from within the Viewer
Press and hold the left mouse button anywhere on the image
Drag with the mouse to navigate the image
To pan an image with the keyboard from within the Viewer
Click anywhere on the image (to set focus)
Use the arrow keys (up, down, left, right) to navigate the image
To show the current position of the cursor
Click on the
button in the Viewer top barHover over the image to display a tooltip with the cursor's x and y position. It also includes the red (R), green (G), and blue (B) values for brightfield images
(Optional) Click on the
button to turn off the tooltip.
Magnification
Magnification controls are automatically provided for images that define an objective magnification and for images that are heuristically determined to be whole slide images (e.g., a TIFF file containing a description from a known WSI scanner manufacturer that also has a well-defined pixel size).
The Viewer will provide preset magnification buttons that are appropriate for the current image, if this information is provided by the image or can be determined heuristically. The preset buttons are accessible from the bottom left side of the image viewport, above the current magnification. For any image where magnification cannot be determined, the magnification controls are replaced with scaling controls (e.g., 50%, 100%).
To change magnification (or scale factor) using the mouse from within the Viewer
Click anywhere on the image (to set focus)
Use the wheel on the mouse to change magnification fluidly
To change magnification using the keyboard from within the Viewer
Click anywhere on the image (to set focus)
Use the +/- buttons to change magnification in small increments
Heuristically Determined Magnification
Image pixel size is loosely related to the scanned magnification. WSI scanner manufacturers typically define a conversion between pixel size and magnification. Where magnification is not explicitly defined in an image, the pixel size will be used to infer the equivalent objective magnification of the image. In many cases, scanned magnification of 20x is approximately equal to 0.5μm per pixel.
Digital Zoom
You can zoom an image beyond its native resolution up to 400%. For example, if an image has a maximum magnification of 20x, it can be scaled up to 80x.
The current magnification is always visible in the bottom left corner of an image. When digital zoom is enabled for an image, the current magnification is shown with a blue border and an adjacent "Digital Zoom" indicator.
Focal Planes
Focal planes are automatically detected when present in supported images. If the image has multiple sub-images, the focal plane for each sub-image can be independently configured by selecting the appropriate sub-image from the dropdown menu.
The focal plane controls are visible in the bottom left bottom of the image viewport only when focal planes are detected in an image.
To see available focal planes for an image
Click on the current focal plane indicator* to reveal the focal plane dialog
Click into the Focal Plane dropdown menu to view available planes
Click on the x button to close the focal plane dialog
* The focal plane controls consist of 
and 
arrows and a numeric indicator displaying the current focal plane offset (e.g., “0 μm”). If available for the current image, these controls are located on the bottom left-hand side of the image viewport immediately above the magnification controls.
To change the focal plane using the mouse
- Click on the or buttons on the focal plane controls*
* The focal plane controls consist of and arrows and a numeric indicator displaying the current focal plane offset (e.g., “0 μm”). If available for the current image, these controls are located on the bottom left-hand side of the image viewport immediately above the magnification controls.
To change the focal plane using the mouse wheel
Click on the image
Hold down the Shift key on the keyboard and simultaneously use the mouse wheel to fly through the available focal planes
Rotation Controls
The rotation tool is located on the bottom left corner of the image viewport. The rotation value is always saved for each user and will be preserved the next time you view the image.
To enable the rotation tool
Hover or click on the image to reveal the toolbar at the top left of the panel
Click on the
button to expand the toolbar if necessaryClick on the
button in the toolbar to show or hide the rotation tool
To rotate using the mouse
Click and drag the ball around the outside of the rotation tool to the desired value
Click in the middle of the rotation tool (where the rotation value is displayed) and type a value between (-360) to +360 degrees
To reset rotation to 0°, click in the middle of the rotation tool and type 0
To rotate using the keyboard
Hold the Alt key and press the up arrow or down arrow key to rotate by 1° clockwise or counter-clockwise, respectively
Hold the Alt key and press the PageUp or PageDown key to rotate by 10° clockwise or counter-clockwise, respectively
Color Management
The color management tools can be used to apply an ICC color profile within the Viewer. The application of ICC profiles ensures a high degree of color reproducibility across different monitors and can be used to overcome/reduce color variability across multiple devices.
To change the color management profile
Hover or click on the image to reveal the toolbar at the top left of the panel
Click on the
button to expand the toolbar if necessaryClick on the
button dropdown menu in the toolbar to reveal the color management dialogSelect one of the available ICC color profiles
Full Screen Mode
To enlarge the image viewport, so that it fills your screen, click on the 
button in the Viewer top bar. When done, press the Escape key on your keyboard to exit full screen mode.
Keyboard Shortcuts
The following keyboard shortcuts are available when using the keyboard:
| Shortcut | Action |
|---|---|
| A | Draw an arrow annotation |
| B | Draw a bookmark annotation |
| C | Draw an ellipse annotation |
| P | Draw a polygon annotation |
| F | Draw a freehand annotation |
| R | Draw a rectangle annotation |
| U | Draw a ruler annotation |
| S | Create a snapshot |
| Alt + ↑ | Rotate clockwise 1° |
| Alt + ↓ | Rotate counter-clockwise 1° |
| Alt + PageUp | Rotate clockwise 10° |
| Alt + PageDown | Rotate counter-clockwise 10° |
| Ctrl + → | Next Image |
| Ctrl + ← | Previous Image |