Class: View

Constructor

new View(image)

Parameters:

Name	Type	Description
`image`	Image	The associated image.

Source: src/image/view.js, line 93

Example

// XMLHttpRequest onload callback
const onload = function (event) {
  // parse the dicom buffer
  const dicomParser = new dwv.DicomParser();
  dicomParser.parse(event.target.response);
  // create the image object
  const image = dwv.createImage(dicomParser.getDicomElements());
  // create the view
  const view = dwv.createView(dicomParser.getDicomElements(), image);
  // setup canvas
  const canvas = document.createElement('canvas');
  canvas.width = 256;
  canvas.height = 256;
  const ctx = canvas.getContext("2d");
  // update the image data
  const imageData = ctx.createImageData(256, 256);
  view.generateImageData(imageData);
  ctx.putImageData(imageData, 0, 0);
  // update html
  const div = document.getElementById('dwv');
  div.appendChild(canvas);;
};
// DICOM file request
const request = new XMLHttpRequest();
const url = 'https://raw.githubusercontent.com/ivmartel/dwv/master/tests/data/bbmri-53323851.dcm';
request.open('GET', url);
request.responseType = 'arraybuffer';
request.onload = onload;
request.send();

Classes

View

Methods

addEventListener(type, callback)

Add an event listener to this class.

Parameters:

Name	Type	Description
`type`	string	The event type.
`callback`	function	The function associated with the provided event type, will be called with the fired event.

Source: src/image/view.js, line 862

addWindowPresets(presets)

Add window presets to the existing ones.

Parameters:

Name	Type	Description
`presets`	object	The window presets.

Source: src/image/view.js, line 419

generateImageData(data, index)

Generate display image data to be given to a canvas.

Parameters:

Name	Type	Description
`data`	ImageData	The iamge data to fill in.
`index`	Index	Optional index at which to generate, otherwise generates at current index.

Source: src/image/view.js, line 924

getAlphaFunction() → {alphaFn}

Get the alpha function.

Source: src/image/view.js, line 285

Returns:

The function.

Type:: alphaFn

getColourMap() → {string}

Get the colour map of the image.

Source: src/image/view.js, line 466

Returns:

The colour map name.

Type:: string

getCurrentImageUid() → {string}

Get the SOP image UID of the current image.

Source: src/image/view.js, line 535

Returns:

The UID.

Type:: string

getCurrentIndex() → {Index}

Get the current index.

Source: src/image/view.js, line 521

Returns:

The current index.

Type:: Index

getCurrentPosition() → {Point}

Get the current position.

Source: src/image/view.js, line 512

Returns:

The current position.

Type:: Point

getCurrentWindowPresetName() → {string}

Get the current window level preset name.

Source: src/image/view.js, line 457

Returns:

The preset name.

Type:: string

getImage() → {Image}

Get the associated image.

Source: src/image/view.js, line 192

Returns:

The associated image.

Type:: Image

getOrientation() → {Matrix33}

Get the view orientation.

Source: src/image/view.js, line 210

Returns:

The orientation matrix.

Type:: Matrix33

getOrigin(positionopt) → {Point3D}

Get the first origin or at a given position.

Parameters:

Name	Type	Attributes	Description
`position`	Point	<optional>	Optional position.

Source: src/image/view.js, line 585

Returns:

The origin.

Type:: Point3D

getOriginForImageUid(uid) → {Point3D|undefined}

Get the image origin for a image UID.

Parameters:

Name	Type	Description
`uid`	string	The UID.

Source: src/image/view.js, line 545

Returns:

The origin.

Type:: Point3D | undefined

getPlaybackMilliseconds(recommendedDisplayFrameRate) → {number}

Get the milliseconds per frame from frame rate.

Parameters:

Name	Type	Description
`recommendedDisplayFrameRate`	number	Recommended Display Frame Rate.

Source: src/image/view.js, line 251

Returns:

The milliseconds per frame.

Type:: number

getScrollIndex() → {number}

Get the scroll dimension index.

Source: src/image/view.js, line 988

Returns:

The index.

Type:: number

getWindowLevel() → {WindowLevel}

Get the window/level.

Source: src/image/view.js, line 811

Returns:

The window and level.

Type:: WindowLevel

getWindowLevelMinMax() → {WindowLevel}

Get the image window/level that covers the full data range. Warning: uses the latest set rescale LUT or the default linear one.

Source: src/image/view.js, line 892

Returns:

A min/max window level.

Type:: WindowLevel

getWindowPresets() → {object}

Get the window presets.

Source: src/image/view.js, line 392

Returns:

The window presets.

Type:: object

getWindowPresetsNames() → {Array.<string>}

Get the window presets names.

Source: src/image/view.js, line 401

Returns:

The list of window presets names.

Type:: Array.<string>

includesImageUid(uid) → {boolean}

Check if the image includes an UID.

Parameters:

Name	Type	Description
`uid`	string	The UID.

Source: src/image/view.js, line 555

Returns:

True if present.

Type:: boolean

init()

Initialise the view: set initial index.

Source: src/image/view.js, line 226

isAquisitionOrientation() → {boolean}

Is this view in the same orientation as the image aquisition.

Source: src/image/view.js, line 1004

Returns:

True if in aquisition plane.

Type:: boolean

isPositionInBounds(positionopt) → {boolean}

Check if the current position (default) or the provided position is in bounds.

Parameters:

Name	Type	Attributes	Description
`position`	Point	<optional>	Optional position.

Source: src/image/view.js, line 566

Returns:

True is the position is in bounds.

Type:: boolean

removeEventListener(type, callback)

Remove an event listener from this class.

Parameters:

Name	Type	Description
`type`	string	The event type.
`callback`	function	The function associated with the provided event type.

Source: src/image/view.js, line 873

setAlphaFunction(func)

Set alpha function.

Parameters:

Name	Type	Description
`func`	alphaFn	The function.

Source: src/image/view.js, line 295

Fires:

View#event:alphafuncchange

setColourMap(name)

Set the colour map of the image.

Parameters:

Name	Type	Description
`name`	string	The colour map name.

Source: src/image/view.js, line 485

Fires:

View#event:colourmapchange

setCurrentIndex(index, silentopt) → {boolean}

Set the current index.

Parameters:

Name	Type	Attributes	Description
`index`	Index		The new index.
`silent`	boolean	<optional>	Flag to fire event or not.

Source: src/image/view.js, line 638

Fires:

View#event:positionchange

Returns:

False if not in bounds.

Type:: boolean

setCurrentPosition(position, silentopt) → {boolean}

Set the current position.

Parameters:

Name	Type	Attributes	Description
`position`	Point		The new position.
`silent`	boolean	<optional>	Flag to fire event or not.

Source: src/image/view.js, line 604

Fires:

View#event:positionchange

Returns:

False if not in bounds.

Type:: boolean

setImage(inImage)

Set the associated image.

Parameters:

Name	Type	Description
`inImage`	Image	The associated image.

Source: src/image/view.js, line 201

setInitialIndex()

Set the initial index to the middle position.

Source: src/image/view.js, line 233

setOrientation(mat33)

Set the view orientation.

Parameters:

Name	Type	Description
`mat33`	Matrix33	The orientation matrix.

Source: src/image/view.js, line 219

setWindowLevel(wl, nameopt, silentopt)

Set the view window/level.

Parameters:

Name	Type	Attributes	Description
`wl`	WindowLevel		The window and level.
`name`	string	<optional>	Associated preset name, defaults to 'manual'. Warning: uses the latest set rescale LUT or the default linear one.
`silent`	boolean	<optional>	Flag to launch events with skipGenerate.

Source: src/image/view.js, line 746

Fires:

View#event:wlchange

setWindowLevelMinMax()

Set the image window/level to cover the full data range. Warning: uses the latest set rescale LUT or the default linear one.

Source: src/image/view.js, line 910

setWindowLevelPreset(name, silentopt)

Set the window level to the preset with the input name.

Parameters:

Name	Type	Attributes	Description
`name`	string		The name of the preset to activate.
`silent`	boolean	<optional>	Flag to launch events with skipGenerate.

Source: src/image/view.js, line 823

setWindowLevelPresetById(id, silentopt)

Set the window level to the preset with the input id.

Parameters:

Name	Type	Attributes	Description
`id`	number		The id of the preset to activate.
`silent`	boolean	<optional>	Flag to launch events with skipGenerate.

Source: src/image/view.js, line 850

setWindowPresets(presets)

Set the window presets.

Parameters:

Name	Type	Description
`presets`	object	The window presets.

Source: src/image/view.js, line 410

Events

alphafuncchange

Alpha func change event.

Type:

object

Properties

Name	Type	Description
`type`	string	The event type.

Source: src/image/view.js, line 297

colourmapchange

Color change event.

Type:

object

Properties

Name	Type	Description
`type`	string	The event type.
`value`	Array	The changed value.

Source: src/image/view.js, line 493

positionchange

Position change event.

Type:

object

Properties

Name	Type	Description
`value`	Array	The changed value as [index, pixelValue].
`diffDims`	Array.<number>	An array of modified indices.

Source: src/image/view.js, line 703

wlchange

Window/level change event.

Type:

object

Properties

Name	Type	Description
`type`	string	The event type.
`value`	Array	The changed value.
`wc`	number	The new window center value.
`ww`	number	The new window wdth value.
`skipGenerate`	boolean	Flag to skip view generation.

Source: src/image/view.js, line 785

wlpresetadd

Window/level add preset event.

Type:

object

Properties

Name	Type	Description
`type`	string	The event type.
`name`	string	The name of the preset.

Source: src/image/view.js, line 436