VoxelizeInventorSceneGPU¶

MLModule¶

author	`MeVis Medical Solutions AG`
package	`MeVisLab/Standard`
dll	`MLVoxelizeInventorSceneGPU`
definition	MLVoxelizeInventorSceneGPU.def
see also	`VoxelizeInventorScene`
keywords	`rasterize`, `scan`, `volume`

Purpose¶

The VoxelizeInventorSceneGPU module offers GPU-based voxelization of meshes. It requires a minimum of OpenGL 4.2. This module supports both color and gray value voxelization of surfaces and the filling of solid surfaces’ interiors. Compared to VoxelizeInventorScene, this module is 100 to 500 times faster.

Currently, there is no software or fallback implementation for lower OpenGL versions. You can use the VoxelizeInventorScene module as a fallback; however, it has different parameters (e.g., surface thickness) and output data types.

Usage¶

The module requires an Open Inventor input scene and a reference coordinate system. The reference coordinate system is provided via an ML image input. From this input, only the image properties are utilized; the image data itself is never requested.

The output image is either 8-bit gray-scale data ranging from 0 (outside) to 255 (255 = on surface/inside) or an 8-bit RGBA image if Colored is enabled.

Input Fields¶

input0¶

name: input0, type: Image¶: The reference image.

inputScene¶

name: inputScene, type: SoNode¶: The input scene.

Output Fields¶

output0¶

name: output0, type: Image¶: The output image.

Parameter Fields¶

Field Index¶

`Antialiasing`: `Bool`	`Use Fill Color`: `Bool`
`Apply`: `Trigger`
`Colored`: `Bool`
`Fill Alpha`: `Float`
`Fill Color`: `Color`
`Fill Inside`: `Bool`
`Fill Mode`: `Enum`
`Supported on this machine`: `Bool`

Visible Fields¶

Apply¶

name: apply, type: Trigger¶: When pressed, the voxelization is started.

Supported on this machine¶

name: supported, type: Bool, persistent: no¶: Shows if the module is supported.

Antialiasing¶

name: antialiasing, type: Bool, default: FALSE¶: If checked, anti-aliasing is enabled by rasterizing a volume that is twice as large and then downsampling to the output volume. This approach has a significant performance impact.

Fill Inside¶

name: fillInside, type: Bool, default: TRUE¶: If checked, the interiors of the meshes are filled. Note: The meshes must be water-tight to ensure proper filling.

Colored¶

name: colored, type: Bool, default: FALSE¶: If checked, colored filling is enabled.

Use Fill Color¶

name: useFillColor, type: Bool, default: TRUE¶: If checked, a global fill color instead of the surface color is used.

Fill Color¶

name: fillColor, type: Color, default: 1 1 1¶: Sets the fill color.

Fill Alpha¶

name: fillAlpha, type: Float, default: 1, minimum: 0, maximum: 1¶: Sets the fill color’s alpha.

Fill Mode¶

name: fillMode, type: Enum, default: Add¶: Defines the fill mode.

Values:

Title	Name	Description
Xor	Xor	The interior is filled where the number of overlapping meshes is odd. This allows, for example, having a large sphere with a smaller sphere inside, which is subtracted from the larger sphere using this fill mode.
Add	Add	The interiors of meshes are always filled, and in colored mode, overlapping meshes accumulate their colors.