Class: View

Constructor

new View(image)

Parameters:

Name	Type	Description
`image`	Image	The associated image.

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

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 828

addWindowPresets(presets)

Add window presets to the existing ones.

Parameters:

Name	Type	Description
`presets`	object	The window presets.

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

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 890

getAlphaFunction() → {alphaFn}

Get the alpha function.

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

Returns:

The function.

Type:: alphaFn

getColourMap() → {string}

Get the colour map of the image.

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

Returns:

The colour map name.

Type:: string

getCurrentIndex() → {Index}

Get the current index.

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

Returns:

The current index.

Type:: Index

getCurrentPosition() → {Point}

Get the current position.

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

Returns:

The current position.

Type:: Point

getCurrentWindowPresetName() → {string}

Get the current window level preset name.

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

Returns:

The preset name.

Type:: string

getImage() → {Image}

Get the associated image.

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

Returns:

The associated image.

Type:: Image

getOrientation() → {Matrix33}

Get the view orientation.

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

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 552

Returns:

The origin.

Type:: Point3D

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 250

Returns:

The milliseconds per frame.

Type:: number

getScrollIndex() → {number}

Get the scroll dimension index.

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

Returns:

The index.

Type:: number

getWindowLevel() → {WindowLevel}

Get the window/level.

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

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 858

Returns:

A min/max window level.

Type:: WindowLevel

getWindowPresets() → {object}

Get the window presets.

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

Returns:

The window presets.

Type:: object

getWindowPresetsNames() → {Array.<string>}

Get the window presets names.

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

Returns:

The list of window presets names.

Type:: Array.<string>

init()

Initialise the view: set initial index.

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

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 533

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 839

setAlphaFunction(func)

Set alpha function.

Parameters:

Name	Type	Description
`func`	alphaFn	The function.

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

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 482

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 605

Fires:

View#event:positionchange

Returns:

False if not in bounds.

Type:: boolean

setCurrentPosition(position, silent) → {boolean}

Set the current position.

Parameters:

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

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

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 200

setInitialIndex()

Set the initial index to the middle position.

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

setOrientation(mat33)

Set the view orientation.

Parameters:

Name	Type	Description
`mat33`	Matrix33	The orientation matrix.

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

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 713

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 876

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 789

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 816

setWindowPresets(presets)

Set the window presets.

Parameters:

Name	Type	Description
`presets`	object	The window presets.

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

Events

alphafuncchange

Alpha func change event.

Type:

object

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

colourmapchange

Color change event.

Type:

object

Properties

Name	Type	Description
`value`	Array	The changed value.

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

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 670

wlchange

Window/level change event.

Type:

object

Properties

Name	Type	Description
`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 752

wlpresetadd

Window/level add preset event.

Type:

object

Properties

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

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