Skip to main content

Class: ProgressiveRetrieveImages

A progressive loader is given some number of images to load, and calls a success or failure callback some number of times in some ordering, possibly calling back multiple times. This allows the progressive loader to be configured for different setups and to return render results for various images.

When used by the a stack viewport, the progressive loader can return multiple representations to the viewport, replacing earlier/more lossy versions with better ones.

When used by a streaming loader, the progressive loader can change the ordering of the rendering to retrieve high priority images first, and the lower priority images later to provide a complete final rendering.

Requests are held in a queue, such that subsequent requests for a given image can be cancelled or ensured to be not initiated until the higher priority image sets have been completed.

This loader is also used for the base streamimg image volume, configured with a minimal interleaved load order, combined with filling nearby volume slices on load, resulting in much faster initial apparent display.

The loader will load images from existing cached images, cached volumes, and from other nearby images or one or more calls to back end services.

Param​

the set of images to load. For a volume, these should be ordered from top to bottom.

Param​

has success and failure callbacks to listen for image deliver events, and may have a getTargetOptions to get information on the retrieve

Param​

is a set of retrieve options to use

Implements​

Constructors​

new ProgressiveRetrieveImages()​

new ProgressiveRetrieveImages(imageRetrieveConfiguration): ProgressiveRetrieveImages

Parameters​

• imageRetrieveConfiguration: IRetrieveConfiguration

Returns​

ProgressiveRetrieveImages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:120

Properties​

retrieveOptions​

retrieveOptions: Record<string, RetrieveOptions>

Implementation of​

IRetrieveConfiguration.retrieveOptions

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:118

stages​

stages: RetrieveStage[]

Implementation of​

IRetrieveConfiguration.stages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:117

createProgressive()​

static createProgressive: (configuration) => ProgressiveRetrieveImages

Parameters​

• configuration: IRetrieveConfiguration

Returns​

ProgressiveRetrieveImages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:103

interleavedRetrieveStages​

static interleavedRetrieveStages: object

stages​

stages: RetrieveStage[] = interleavedRetrieveStages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:105

sequentialRetrieveStages​

static sequentialRetrieveStages: object

stages​

stages: RetrieveStage[] = sequentialRetrieveStages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:113

singleRetrieveStages​

static singleRetrieveStages: object

stages​

stages: RetrieveStage[] = singleRetrieveStages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:109

Methods​

loadImages()​

loadImages(imageIds, listener): Promise<any>

Parameters​

• imageIds: string[]

• listener: ImageLoadListener

Returns​

Promise<any>

Implementation of​

IImagesLoader.loadImages

Defined in​

packages/core/src/loaders/ProgressiveRetrieveImages.ts:125