ImageResliceMapper

Introduction

vtkImageResliceMapper provides hardware accelerated slicing of 3D image data / volumes.
It can be associated with a vtkImageSlice prop and placed within a Renderer.

This class resolves coincident topology with the same methods as vtkMapper.

Methods

extend

Method use to decorate a given object (publicAPI+model) with vtkImageResliceMapper characteristics.

Argument	Type	Required	Description
publicAPI		Yes	object on which methods will be bounds (public)
model		Yes	object on which data structure will be bounds (protected)
initialValues	IImageResliceMapperInitialValues	No	(default: {})

getBounds

Get the bounds for this mapper as [xmin, xmax, ymin, ymax,zmin, zmax].

getIsOpaque

getResolveCoincidentTopology

getResolveCoincidentTopologyAsString

getResolveCoincidentTopologyLineOffsetParameters

getResolveCoincidentTopologyPointOffsetParameters

getResolveCoincidentTopologyPolygonOffsetFaces

getResolveCoincidentTopologyPolygonOffsetParameters

getSlabThickness

Get the slab thickness in world space (mm).

getSlabTrapezoidIntegration

Get whether slab trapezoid integration is enabled.

getSlabType

Get the slab composite function.

getSlicePlane

Get the implicit plane used to slice the volume with.

getSlicePolyData

Get the custom polydata used to slice the volume with.

newInstance

Method use to create a new instance of vtkImageResliceMapper

Argument	Type	Required	Description
initialValues	IImageResliceMapperInitialValues	No	for pre-setting some of its content

setRelativeCoincidentTopologyLineOffsetParameters

Argument	Type	Required	Description
factor	Number	Yes
offset	Number	Yes

setRelativeCoincidentTopologyPointOffsetParameters

Argument	Type	Required	Description
factor	Number	Yes
offset	Number	Yes

setRelativeCoincidentTopologyPolygonOffsetParameters

Argument	Type	Required	Description
factor	Number	Yes
offset	Number	Yes

setResolveCoincidentTopology

Argument	Type	Required	Description
resolveCoincidentTopology		Yes

setResolveCoincidentTopologyLineOffsetParameters

Argument	Type	Required	Description
factor	Number	Yes
offset	Number	Yes

setResolveCoincidentTopologyPointOffsetParameters

Argument	Type	Required	Description
factor	Number	Yes
offset	Number	Yes

setResolveCoincidentTopologyPolygonOffsetFaces

Argument	Type	Required	Description
value		Yes

setResolveCoincidentTopologyPolygonOffsetParameters

Argument	Type	Required	Description
factor	Number	Yes
offset	Number	Yes

setResolveCoincidentTopologyToDefault

setResolveCoincidentTopologyToOff

setResolveCoincidentTopologyToPolygonOffset

setSlabThickness

Enable slab slicing mode and set the slab thickness in world space (mm).

Argument	Type	Required	Description
slabThickness	Number	Yes	The slab thickness in world space (mm). Default: 0.

setSlabTrapezoidIntegration

When a slab thickness larger than 0 is provided, the mapper will composite multile slices
together using different composite functions based on the slabType. When
slabTrapezoidIntegration is enabled, the first and the last slices in the slab are weighted at
half their original intensity for sum and mean slab types.

Argument	Type	Required	Description
slabTrapezoidIntegration	Number	Yes	Enable/disable trapezoid integration for slab slicing. Default: 0

setSlabType

When a slab thickness larger than 0 is provided, the mapper will composite multile slices
together using different composite functions based on the slabType. Available options are max,
min, mean and sum.

Argument	Type	Required	Description
slabType	SlabTypes	Yes	The blend function used to composite slab slices. Default: SlabTypes.MEAN

setSlicePlane

The vtkImageResliceMapper provides flexibility in how the reslice source is provided. The user
can either provide an implicit vtkPlane (defined with its origin and normal), or a custom
vtkPolyData. When both sources are provided, the mapper chooses the custom polydata over the
implicit plane. When providing custom polydata as the source, it is required that the polydata
has point normals for slab slicing. When neither sources are provided, the mapper creates a
default implicit plane with normal (0, 0, 1) and origin at the mid-point of the volume’s Z
bounds.

Argument	Type	Required	Description
slicePlane	vtkPlane	Yes	The implicit plane to slice the volume with. Default: null

setSlicePolyData

The vtkImageResliceMapper provides flexibility in how the reslice source is provided. The user
can either provide an implicit vtkPlane (defined with its origin and normal), or a custom
vtkPolyData. When both sources are provided, the mapper chooses the custom polydata over the
implicit plane. When providing custom polydata as the source, it is required that the polydata
has point normals for slab slicing. When neither sources are provided, the mapper creates a
default implicit plane with normal (0, 0, 1) and origin at the mid-point of the volume’s Z
bounds.

Argument	Type	Required	Description
slicePolyData	vtkPolyData	Yes	The polydata to slice the volume with. Default: null

Source

Constants.d.ts

export declare enum SlabTypes {
	MIN = 0,
	MAX = 1,
	MEAN = 2,
	SUM = 3,
}

declare const _default: {
	SlabTypes: typeof SlabTypes;
};
export default _default;

Constants.js

export const SlabTypes = {
  MIN: 0,
  MAX: 1,
  MEAN: 2,
  SUM: 3,
};

export default {
  SlabTypes,
};

index.d.ts

import vtkAbstractImageMapper, { IAbstractImageMapperInitialValues } from "../AbstractImageMapper";
import vtkImageData from "../../../Common/DataModel/ImageData";
import vtkPlane from "../../../Common/DataModel/Plane";
import vtkPolyData from "../../../Common/DataModel/PolyData";
import { Bounds, Nullable, Vector3 } from "../../../types";
import { SlabTypes } from "./Constants";


interface ICoincidentTopology {
	factor: number;
	offset: number;
}

export interface IImageResliceMapperInitialValues extends IAbstractImageMapperInitialValues {
	slabThickness?: number;
	slabTrapezoidIntegration?: number;
	slabType?: SlabTypes;
	slicePlane?: vtkPlane;
	slicePolyData?: vtkPolyData;
}

export interface vtkImageResliceMapper extends vtkAbstractImageMapper {

	/**
     * Get the bounds for this mapper as [xmin, xmax, ymin, ymax,zmin, zmax].
	 * @return {Bounds} The bounds for the mapper.
	 */
	getBounds(): Bounds;

	/**
	 *
	 */
	getIsOpaque(): boolean;

	/**
	 *
	 */
	getResolveCoincidentTopology(): ICoincidentTopology

	/**
	 *
	 */
	getResolveCoincidentTopologyAsString(): ICoincidentTopology

	/**
	 *
	 */
	getResolveCoincidentTopologyLineOffsetParameters(): ICoincidentTopology

	/**
	 *
	 */
	getResolveCoincidentTopologyPointOffsetParameters(): ICoincidentTopology

	/**
	 *
	 */
	getResolveCoincidentTopologyPolygonOffsetFaces(): ICoincidentTopology

	/**
	 *
	 */
	getResolveCoincidentTopologyPolygonOffsetParameters(): ICoincidentTopology;

	/**
	 *
	 * Get the slab thickness in world space (mm).
	 */
	getSlabThickness(): number;

	/**
	 *
	 * Get whether slab trapezoid integration is enabled.
	 */
	getSlabTrapezoidIntegration(): number;

	/**
	 *
	 * Get the slab composite function.
	 */
	getSlabType(): SlabTypes;

	/**
	 *
	 * Get the implicit plane used to slice the volume with.
	 */
	getSlicePlane(): vtkPlane;

	/**
	 *
	 * Get the custom polydata used to slice the volume with.
	 */
	getSlicePolyData(): vtkPolyData;

	/**
	 *
	 * @param {Number} factor 
	 * @param {Number} offset 
	 */
	setRelativeCoincidentTopologyLineOffsetParameters(factor: number, offset: number): boolean;

	/**
	 *
	 * @param {Number} factor 
	 * @param {Number} offset 
	 */
	setRelativeCoincidentTopologyPointOffsetParameters(factor: number, offset: number): boolean;

	/**
	 *
	 * @param {Number} factor 
	 * @param {Number} offset 
	 */
	setRelativeCoincidentTopologyPolygonOffsetParameters(factor: number, offset: number): boolean;

	/**
	 *
	 * @param resolveCoincidentTopology
	 * @default false
	 */
	setResolveCoincidentTopology(resolveCoincidentTopology: boolean): boolean;

	/**
	 *
	 * @param {Number} factor 
	 * @param {Number} offset 
	 */
	setResolveCoincidentTopologyLineOffsetParameters(factor: number, offset: number): boolean;

	/**
	 *
	 * @param {Number} factor 
	 * @param {Number} offset 
	 */
	setResolveCoincidentTopologyPointOffsetParameters(factor: number, offset: number): boolean;

	/**
	 *
	 * @param value
	 */
	setResolveCoincidentTopologyPolygonOffsetFaces(value: number): boolean;

	/**
	 *
	 * @param {Number} factor 
	 * @param {Number} offset 
	 */
	setResolveCoincidentTopologyPolygonOffsetParameters(factor: number, offset: number): boolean;

	/**
	 *
	 */
	setResolveCoincidentTopologyToDefault(): boolean;

	/**
	 *
	 */
	setResolveCoincidentTopologyToOff(): boolean;

	/**
	 *
	 */
	setResolveCoincidentTopologyToPolygonOffset(): boolean;

	/**
	 *
	 * Enable slab slicing mode and set the slab thickness in world space (mm).
	 * @param {Number} slabThickness The slab thickness in world space (mm). Default: 0.
	 */
	setSlabThickness(slabThickness: number): boolean;

	/**
	 *
	 * When a slab thickness larger than 0 is provided, the mapper will composite multile slices
	 * together using different composite functions based on the slabType. When
	 * slabTrapezoidIntegration is enabled, the first and the last slices in the slab are weighted at
	 * half their original intensity for sum and mean slab types.
	 * @param {Number} slabTrapezoidIntegration Enable/disable trapezoid integration for slab slicing.
	 * Default: 0
	 */
	setSlabTrapezoidIntegration(slabTrapezoidIntegration: number): boolean;

	/**
	 *
	 * When a slab thickness larger than 0 is provided, the mapper will composite multile slices
	 * together using different composite functions based on the slabType. Available options are max,
	 * min, mean and sum.
	 * @param {SlabTypes} slabType The blend function used to composite slab slices.
	 * Default: SlabTypes.MEAN
	 */
	setSlabType(slabType: SlabTypes): boolean;

	/**
	 *
	 * The vtkImageResliceMapper provides flexibility in how the reslice source is provided. The user
	 * can either provide an implicit vtkPlane (defined with its origin and normal), or a custom
	 * vtkPolyData. When both sources are provided, the mapper chooses the custom polydata over the
	 * implicit plane. When providing custom polydata as the source, it is required that the polydata
	 * has point normals for slab slicing. When neither sources are provided, the mapper creates a
	 * default implicit plane with normal (0, 0, 1) and origin at the mid-point of the volume's Z
	 * bounds.
	 * @param {vtkPlane} slicePlane The implicit plane to slice the volume with. Default: null
	 */
	setSlicePlane(slicePlane: vtkPlane): boolean;

	/**
	 *
	 * The vtkImageResliceMapper provides flexibility in how the reslice source is provided. The user
	 * can either provide an implicit vtkPlane (defined with its origin and normal), or a custom
	 * vtkPolyData. When both sources are provided, the mapper chooses the custom polydata over the
	 * implicit plane. When providing custom polydata as the source, it is required that the polydata
	 * has point normals for slab slicing. When neither sources are provided, the mapper creates a
	 * default implicit plane with normal (0, 0, 1) and origin at the mid-point of the volume's Z
	 * bounds.
	 * @param {vtkPolyData} slicePolyData The polydata to slice the volume with. Default: null
	 */
	setSlicePolyData(slicePolyData: vtkPolyData): boolean;
}

/**
 * Method use to decorate a given object (publicAPI+model) with vtkImageResliceMapper characteristics.
 *
 * @param publicAPI object on which methods will be bounds (public)
 * @param model object on which data structure will be bounds (protected)
 * @param {IImageResliceMapperInitialValues} [initialValues] (default: {})
 */
export function extend(publicAPI: object, model: object, initialValues?: IImageResliceMapperInitialValues): void;

/**
 * Method use to create a new instance of vtkImageResliceMapper
 * @param {IImageResliceMapperInitialValues} [initialValues] for pre-setting some of its content
 */
export function newInstance(initialValues?: IImageResliceMapperInitialValues): vtkImageResliceMapper;

/**
 * vtkImageResliceMapper provides hardware accelerated slicing of 3D image data / volumes.
 * It can be associated with a vtkImageSlice prop and placed within a Renderer.
 *
 * This class resolves coincident topology with the same methods as vtkMapper.
 */
export declare const vtkImageResliceMapper: {
	newInstance: typeof newInstance;
	extend: typeof extend;
}
export default vtkImageResliceMapper;

index.js

import CoincidentTopologyHelper from 'vtk.js/Sources/Rendering/Core/Mapper/CoincidentTopologyHelper';
import Constants from 'vtk.js/Sources/Rendering/Core/ImageResliceMapper/Constants';
import macro from 'vtk.js/Sources/macros';
import vtkAbstractImageMapper from 'vtk.js/Sources/Rendering/Core/AbstractImageMapper';
import vtkBoundingBox from 'vtk.js/Sources/Common/DataModel/BoundingBox';

const { SlabTypes } = Constants;

const { staticOffsetAPI, otherStaticMethods } = CoincidentTopologyHelper;

// ----------------------------------------------------------------------------
// vtkImageResliceMapper methods
// ----------------------------------------------------------------------------

function vtkImageResliceMapper(publicAPI, model) {
  // Set our className
  model.classHierarchy.push('vtkImageResliceMapper');

  publicAPI.getBounds = () => {
    let bds = [...vtkBoundingBox.INIT_BOUNDS];
    const image = publicAPI.getInputData();
    if (publicAPI.getSlicePolyData()) {
      bds = publicAPI.getSlicePolyData().getBounds();
    } else if (image) {
      bds = image.getBounds();
      if (publicAPI.getSlicePlane()) {
        vtkBoundingBox.cutWithPlane(
          bds,
          publicAPI.getSlicePlane().getOrigin(),
          publicAPI.getSlicePlane().getNormal()
        );
      }
    }
    return bds;
  };
}

// ----------------------------------------------------------------------------
// Object factory
// ----------------------------------------------------------------------------

const DEFAULT_VALUES = {
  slabThickness: 0.0,
  slabTrapezoidIntegration: 0,
  slabType: SlabTypes.MEAN,
  slicePlane: null,
  slicePolyData: null,
};

// ----------------------------------------------------------------------------

export function extend(publicAPI, model, initialValues = {}) {
  Object.assign(model, DEFAULT_VALUES, initialValues);

  // Build VTK API
  vtkAbstractImageMapper.extend(publicAPI, model, initialValues);

  macro.setGet(publicAPI, model, [
    'slabThickness',
    'slabTrapezoidIntegration',
    'slabType',
    'slicePlane',
    'slicePolyData',
  ]);
  CoincidentTopologyHelper.implementCoincidentTopologyMethods(publicAPI, model);

  // Object methods
  vtkImageResliceMapper(publicAPI, model);
}

// ----------------------------------------------------------------------------

export const newInstance = macro.newInstance(extend, 'vtkImageResliceMapper');

// ----------------------------------------------------------------------------

export default {
  newInstance,
  extend,
  ...staticOffsetAPI,
  ...otherStaticMethods,
};