jessupjs / lensing

2 stars 1 forks source link

Lensing

Note

This plugin introduces a lens to the OpenSeadragon viewer with several characteristic features, including hi-res magnification, physical measurements, exportable snapshots, customized overlays, and localized filtering. The overlays and filters in particular can be extended to support application-specific tasks.

Refs.

Use

  1. Install w NPM

  2. Import at top of .js:

    import * as osd from 'openseadragon';
    import * as l from 'lensing';
  3. After original OSD viewer is instantiated, construct the lensing hidden viewer:

    // Instantiate viewer
    const viewer = osd(viewer_config);
    
    // Compile dataLoad, i.e. custom filters (empty by default)
    const dataLoad = []
    
    // Instantiate Lensing
    viewer.lensing = l.construct(osd, viewer, viewer_config, dataLoad);
  4. Refer to the following examples if useful:

    1. Lensing Demo - a small application that demonstrates the lensing tool's core functionalities.
    2. Scope2Screen - a domain-specific application (digital histopathology) that presents examples for extending functionality with custom filters and annotations.