Class: Image

Constructor

new Image(geometry, buffer, imageUidsopt)

Parameters:

Name	Type	Attributes	Description
`geometry`	Geometry		The geometry of the image.
`buffer`	TypedArray		The image data as a one dimensional buffer.
`imageUids`	Array	<optional>	An array of Uids indexed to slice number.

Source: src/image/image.js, line 109

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());
  // result div
  const div = document.getElementById('dwv');
  // display the image size
  const size = image.getGeometry().getSize();
  div.appendChild(document.createTextNode(
    'Size: ' + size.toString() +
    ' (should be 256,256,1)'));
  // break line
  div.appendChild(document.createElement('br'));
  // display a pixel value
  div.appendChild(document.createTextNode(
    'Pixel @ [128,40,0]: ' +
    image.getRescaledValue(128,40,0) +
    ' (should be 101)'));
};
// 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

Image

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/image.js, line 892

appendFrame(time, origin)

Append a frame to the image.

Parameters:

Name	Type	Description
`time`	number	The frame time value.
`origin`	Point3D	The origin of the frame.

Source: src/image/image.js, line 840

appendFrameBuffer(frameBuffer, frameIndex)

Append a frame buffer to the image.

Parameters:

Name	Type	Description
`frameBuffer`	object	The frame buffer to append.
`frameIndex`	number	The frame index.

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

appendSlice(rhs)

Append a slice to the image.

Parameters:

Name	Type	Description
`rhs`	Image	The slice to append.

Source: src/image/image.js, line 662

calculateDataRange() → {object}

Calculate the data range of the image. WARNING: for speed reasons, only calculated on the first frame...

Source: src/image/image.js, line 1134

Returns:

The range {min, max}.

Type:: object

calculateHistogram() → {object}

Calculate the histogram of the image.

Source: src/image/image.js, line 1203

Returns:

The histogram, data range and rescaled data range.

Type:: object

calculateRescaledDataRange() → {object}

Calculate the rescaled data range of the image. WARNING: for speed reasons, only calculated on the first frame...

Source: src/image/image.js, line 1163

Returns:

The range {min, max}.

Type:: object

canQuantify() → {boolean}

Can the image values be quantified?

Source: src/image/image.js, line 279

Returns:

True if only one component.

Type:: boolean

canScroll(viewOrientation) → {boolean}

Can the data be scrolled?

Parameters:

Name	Type	Description
`viewOrientation`	Matrix33	The view orientation.

Source: src/image/image.js, line 300

Returns:

True if the data has a third dimension greater than one after applying the view orientation.

Type:: boolean

canWindowLevel() → {boolean}

Can window and level be applied to the data?

Source: src/image/image.js, line 288

Returns:

True if the data is monochrome.

Type:: boolean

clone() → {Image}

Clone the image.

Source: src/image/image.js, line 613

Returns:

A clone of this image.

Type:: Image

compose(rhs, operator) → {Image}

Compose this image with another one and using a specific operator. WARNING: no size check!

Parameters:

Name	Type	Description
`rhs`	Image	The image to compose with.
`operator`	function	The operator to use when composing.

Source: src/image/image.js, line 1433

Returns:

The composed image. Note: Uses the raw buffer values.

Type:: Image

convolute2D(weights) → {Image}

Convolute the image with a given 2D kernel.

Note: Uses raw buffer values.

Parameters:

Name	Type	Description
`weights`	Array	The weights of the 2D kernel as a 3x3 matrix.

Source: src/image/image.js, line 1253

Returns:

The convoluted image.

Type:: Image

convoluteBuffer(weights, buffer, startOffset)

Convolute an image buffer with a given 2D kernel.

Note: Uses raw buffer values.

Parameters:

Name	Type	Description
`weights`	Array	The weights of the 2D kernel as a 3x3 matrix.
`buffer`	TypedArray	The buffer to convolute.
`startOffset`	number	The index to start at.

Source: src/image/image.js, line 1281

getBuffer() → {TypedArray}

Get the data buffer of the image.

Source: src/image/image.js, line 270
To Do: dangerous...

Returns:

The data buffer of the image.

Type:: TypedArray

getDataRange() → {object}

Get the data range.

Source: src/image/image.js, line 851

Returns:

The data range.

Type:: object

getGeometry() → {Geometry}

Get the geometry of the image.

Source: src/image/image.js, line 260

Returns:

The geometry.

Type:: Geometry

getHistogram() → {Array}

Get the histogram.

Source: src/image/image.js, line 875

Returns:

The histogram.

Type:: Array

getImageUid(indexopt) → {string}

Get the image UID at a given index.

Parameters:

Name	Type	Attributes	Description
`index`	Index	<optional>	The index at which to get the id.

Source: src/image/image.js, line 247

Returns:

The UID.

Type:: string

getMeta() → {object}

Get the meta information of the image.

Source: src/image/image.js, line 468

Returns:

The meta information of the image.

Type:: object

getNumberOfComponents() → {number}

Get the numberOfComponents of the image.

Source: src/image/image.js, line 459

Returns:

The numberOfComponents of the image.

Type:: number

getOffsets(value) → {Array}

Get the offsets where the buffer equals the input value. Loops through the whole volume, can get long for big data...

Parameters:

Name	Type	Description
`value`	number \| object	The value to check.

Source: src/image/image.js, line 498

Returns:

The list of offsets.

Type:: Array

getPhotometricInterpretation() → {string}

Get the photometricInterpretation of the image.

Source: src/image/image.js, line 423

Returns:

The photometricInterpretation of the image.

Type:: string

getPlanarConfiguration() → {number}

Get the planarConfiguration of the image.

Source: src/image/image.js, line 441

Returns:

The planarConfiguration of the image.

Type:: number

getRescaleSlopeAndIntercept(indexopt) → {object}

Get the rescale slope and intercept.

Parameters:

Name	Type	Attributes	Description
`index`	Index	<optional>	The index (only needed for non constant rsi).

Source: src/image/image.js, line 336

Returns:

The rescale slope and intercept.

Type:: object

getRescaledDataRange() → {object}

Get the rescaled data range.

Source: src/image/image.js, line 863

Returns:

The rescaled data range.

Type:: object

getRescaledValue(i, j, k, f) → {number}

Get the rescaled value of the image at a specific position.

Parameters:

Name	Type	Description
`i`	number	The X index.
`j`	number	The Y index.
`k`	number	The Z index.
`f`	number	The frame number.

Source: src/image/image.js, line 1078

Returns:

The rescaled value at the desired position. Warning: No size check...

Type:: number

getRescaledValueAtIndex(index) → {number}

Get the rescaled value of the image at a specific index.

Parameters:

Name	Type	Description
`index`	Index	The index.

Source: src/image/image.js, line 1102

Returns:

The rescaled value at the desired position. Warning: No size check...

Type:: number

getRescaledValueAtOffset(offset) → {number}

Get the rescaled value of the image at a specific offset.

Parameters:

Name	Type	Description
`offset`	number	The desired offset.

Source: src/image/image.js, line 1115

Returns:

The rescaled value at the desired offset. Warning: No size check...

Type:: number

getSecondaryOffset(index) → {number}

Get the secondary offset: an offset that takes into account the slice and above dimension numbers.

Parameters:

Name	Type	Description
`index`	Index	The index.

Source: src/image/image.js, line 326

Returns:

The offset.

Type:: number

getValue(i, j, k, f) → {number}

Get the value of the image at a specific coordinate.

Parameters:

Name	Type	Description
`i`	number	The X index.
`j`	number	The Y index.
`k`	number	The Z index.
`f`	number	The frame number.

Source: src/image/image.js, line 1049

Returns:

The value at the desired position. Warning: No size check...

Type:: number

getValueAtIndex(index) → {number}

Get the value of the image at a specific index.

Parameters:

Name	Type	Description
`index`	Index	The index.

Source: src/image/image.js, line 1063

Returns:

The value at the desired position. Warning: No size check...

Type:: number

getValueAtOffset(offset) → {number}

Get value at offset. Warning: No size check...

Parameters:

Name	Type	Description
`offset`	number	The desired offset.

Source: src/image/image.js, line 487

Returns:

The value at offset.

Type:: number

hasValues(values) → {Array}

Check if the input values are in the buffer. Could loop through the whole volume, can get long for big data...

Parameters:

Name	Type	Description
`values`	Array	The values to check.

Source: src/image/image.js, line 532

Returns:

A list of booleans for each input value, set to true if the value is present in the buffer.

Type:: Array

isConstantRSI() → {boolean}

Are all the RSIs equal.

Source: src/image/image.js, line 414

Returns:

True if they are.

Type:: boolean

isIdentityRSI() → {boolean}

Are all the RSIs identity (1,0).

Source: src/image/image.js, line 405

Returns:

True if they are.

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/image.js, line 903

setAtOffsets(offsets, value)

Set the inner buffer values at given offsets.

Parameters:

Name	Type	Description
`offsets`	Array	List of offsets where to set the data.
`value`	object	The value to set at the given offsets.

Source: src/image/image.js, line 927

Fires:

Image#event:imagechange

setAtOffsetsAndGetOriginals(offsetsLists, value) → {Array}

Set the inner buffer values at given offsets.

Parameters:

Name	Type	Description
`offsetsLists`	Array	List of offset lists where to set the data.
`value`	object	The value to set at the given offsets.

Source: src/image/image.js, line 948

Fires:

Image#event:imagechange

Returns:

A list of objects representing the original values before replacing them.

Type:: Array

setAtOffsetsWithIterator(offsetsLists, value)

Set the inner buffer values at given offsets.

Parameters:

Name	Type	Description
`offsetsLists`	Array	List of offset lists where to set the data.
`value`	object \| Array	The value to set at the given offsets.

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

Fires:

Image#event:imagechange

setMeta(rhs)

Set the meta information of the image.

Parameters:

Name	Type	Description
`rhs`	object	The meta information of the image.

Source: src/image/image.js, line 477

setPhotometricInterpretation(interp)

Set the photometricInterpretation of the image.

Parameters:

Name	Type	Description
`interp`	string	The photometricInterpretation of the image.

Source: src/image/image.js, line 432

setPlanarConfiguration(config)

Set the planarConfiguration of the image.

Parameters:

Name	Type	Description
`config`	number	The planarConfiguration of the image.

Source: src/image/image.js, line 450

setRescaleSlopeAndIntercept(inRsi, offsetopt)

Set the rescale slope and intercept.

Parameters:

Name	Type	Attributes	Description
`inRsi`	object		The input rescale slope and intercept.
`offset`	number	<optional>	The rsi offset (only needed for non constant rsi).

Source: src/image/image.js, line 368

transform(operator) → {Image}

Transform an image using a specific operator. WARNING: no size check!

Parameters:

Name	Type	Description
`operator`	function	The operator to use when transforming.

Source: src/image/image.js, line 1415

Returns:

The transformed image. Note: Uses the raw buffer values.

Type:: Image

Events

imagechange

Image change event.

Type:

object

Source: src/image/image.js, line 1030