com.openinventor.imageviz.engines.geometryandmatching.geometrictransforms

Class SoResampleImageProcessing3d

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.engines.SoEngine

com.openinventor.imageviz.engines.SoImageVizEngine

com.openinventor.imageviz.engines.geometryandmatching.geometrictransforms.SoResampleImageProcessing3d

All Implemented Interfaces:

SafeDisposable

public class SoResampleImageProcessing3d
extends SoImageVizEngine

SoResampleImageProcessing3d filter The SoResampleImageProcessing3d engine allows to resample an input image into a new coordinate system applying a transform on it.

For instance it can be used to :

• apply the transform computed by an automatic registration in order to process the registered image.
• extract a "rotated ROI" (not aligned with the input bounding box).

The resampled sub-volume is defined by an SbBox3f (axis aligned box) in 3D space and a SbMatrix that transforms the axis aligned box. The output voxel values are computed by interpolating the input image.

The SbMatrix that transforms the axis aligned box must only contain translation, rotation and scale (no shearing), otherwise an error is raised.

An additional transformation can be applied to each output voxel position before the interpolation. This is useful for re-sampling an image after a registration.

File format/default:

ResampleImageProcessing3d {

inImage	NULL
subVolume	0, 0, 0, 1, 1, 1
subVolumeTransform	1 0 0 0
	0 1 0 0
	0 0 1 0
	0 0 0 1
samplingMode	AUTOMATIC
subVolumeDimension	1 1 1
interpolationType	LINEAR
paddingValue	0.0
transform	1 0 0 0
	0 1 0 0
	0 0 1 0
	0 0 0 1

}

See also:

SoSampleImageProcessing, SoProxyDataAdapter

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoResampleImageProcessing3d.InterpolationTypes This enum defines the type of interpolation used.
static class	SoResampleImageProcessing3d.SamplingModes This enum defines how the voxel size of the output image is computed.

Nested classes/interfaces inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

SoImageVizEngine.ComputeModes, SoImageVizEngine.EventArg, SoImageVizEngine.Neighborhood3ds

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	AUTOMATIC Deprecated. Use SoResampleImageProcessing3d.SamplingModes.AUTOMATIC instead.
SoSFImageDataAdapter	inImage The input image.
SoSFEnum<SoResampleImageProcessing3d.InterpolationTypes>	interpolationType The type of interpolation used for the re-sampling.
static int	LINEAR Deprecated. Use SoResampleImageProcessing3d.InterpolationTypes.LINEAR instead.
static int	MANUAL Deprecated. Use SoResampleImageProcessing3d.SamplingModes.MANUAL instead.
static int	NEAREST Deprecated. Use SoResampleImageProcessing3d.InterpolationTypes.NEAREST instead.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage The output image.
SoSFDouble	paddingValue The output value if an output voxel position is outside the bounding box of the input image.
SoSFEnum<SoResampleImageProcessing3d.SamplingModes>	samplingMode Specifies how the voxel size is computed.
SoSFBox3f	subVolume Specifies the input subvolume as an axis aligned box in 3D space.
SoSFVec3i32	subVolumeDimension The dimensions of the output sub volume.
SoSFMatrix	subVolumeTransform Specifies a transformation of the axis aligned box subVolume.
SoSFMatrix	transform This transformation is applied to all output voxel positions before the interpolation.

Fields inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

CONNECTIVITY_18, CONNECTIVITY_26, CONNECTIVITY_6, MODE_2D, MODE_3D, MODE_AUTO, onBegin, onEnd, onProgress

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoResampleImageProcessing3d() Constructor.

Method Summary

Methods inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

abortEvaluate, isEvaluating, startEvaluate, waitEvaluate

Methods inherited from class com.openinventor.inventor.engines.SoEngine

copy, getByName, getOutput, getOutputName

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

AUTOMATIC

@Deprecated
public static final int AUTOMATIC

Deprecated. Use SoResampleImageProcessing3d.SamplingModes.AUTOMATIC instead.

MANUAL

@Deprecated
public static final int MANUAL

Deprecated. Use SoResampleImageProcessing3d.SamplingModes.MANUAL instead.

NEAREST

@Deprecated
public static final int NEAREST

Deprecated. Use SoResampleImageProcessing3d.InterpolationTypes.NEAREST instead.

LINEAR

@Deprecated
public static final int LINEAR

Deprecated. Use SoResampleImageProcessing3d.InterpolationTypes.LINEAR instead.

inImage

public final SoSFImageDataAdapter inImage

The input image. Default value is NULL. Supported types include: grayscale binary label.

subVolume

public final SoSFBox3f subVolume

Specifies the input subvolume as an axis aligned box in 3D space. Default is (0,0,0, 1,1,1). This box is (optionally) transformed by the subVolumeTransform to define the final input subvolume.

subVolumeTransform

public final SoSFMatrix subVolumeTransform

Specifies a transformation of the axis aligned box subVolume. Default is identity.

samplingMode

public final SoSFEnum<SoResampleImageProcessing3d.SamplingModes> samplingMode

Specifies how the voxel size is computed. Default value is AUTOMATIC.

subVolumeDimension

public final SoSFVec3i32 subVolumeDimension

The dimensions of the output sub volume. If the parameter SoResampleImageProcessing3d.samplingMode is not set to MANUAL this parameter is ignored. Default value is (1,1,1).

interpolationType

public final SoSFEnum<SoResampleImageProcessing3d.InterpolationTypes> interpolationType

The type of interpolation used for the re-sampling. Default value is LINEAR.

paddingValue

public final SoSFDouble paddingValue

The output value if an output voxel position is outside the bounding box of the input image. Default value is 0.

transform

public final SoSFMatrix transform

This transformation is applied to all output voxel positions before the interpolation. The default value is the identity.

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

The output image.

Constructor Detail

SoResampleImageProcessing3d

public SoResampleImageProcessing3d()

Constructor.