The context2d drawing operations in core OpenSeadragon have been consolidated from the

TiledImage

and

Tile

classes into the

Drawer

class, which inherits from a new

DrawerBase

base class. The

TiledImage

and

Tile

classes now handle the logic of managing tile positioning and image data, with cleaner separation from details of the rendering process.

DrawerBase

defines a public API that core OpenSeadragon code uses to interact with the drawer implementation. To use a custom drawer/render, define a new class that inherits from

DrawerBase

and implements the public API. The constructor of this class can be passed in during construction of the viewer using the new

customDrawer

option.

    import { ThreeJSDrawer } from './threejsdrawer.js';

    let viewer = OpenSeadragon({
        ...
        customDrawer: ThreeJSDrawer,
        ...
    });
                

HTML-based rendering can be selected in two different ways:

    // via the useCanvas option:
    let viewer = OpenSeadragon({
        ...
        useCanvas: false,
        ...
    });

    // or by passing the HTMLDrawer constructor
    let viewer = OpenSeadragon({
        ...
        customDrawer:OpenSeadragon.HTMLDrawer,
        ...
    });