XMarkerListConvert

MLModule

genre	Marker
authors	Tobias Boehler, Jan-Martin Kuhnigk
package	FMEstable/ReleaseMeVis
dll	MLXMarkerListConvert
definition	XMarkerListConvert.def
see also	WorldVoxelConvert
keywords	XMarkerList, XMarker, convert, voxel, world, coord, transform, marker, list

Purpose

Converts the position and optional the vector component coordinates of items of a XMarkerList either from world to (integer or floating point) voxel coordinates or vice versa.

Details

For information on world, (floating point) voxel and integer voxel (aka index) coordinates, see

See documentation of Conversion Mode items for details on how the conversion between the modes is performed.

Windows

Default Panel

Input Fields

input0

name: input0, type: Image

The world-voxel-matrix of this input image is used for conversion.

inputXMarkerList

name: inputXMarkerList, type: MLBase

Items of this input list will be converted.

Output Fields

outputXMarkerList

name: outputXMarkerList, type: MLBase

Contains converted markers.

Parameter Fields

Visible Fields

Conversion Mode

name: conversionMode, type: Enum, default: WorldToIntegerVoxel, deprecated name: conversionModeField

Select mode to convert between the three different coordinate systems. See item documentation for details.

Values:

Title	Name	Deprecated Name	Description
​Floating-Point Voxel to Integer Voxel Coordinates	​FloatVoxelToIntegerVoxel	​FloatingPointToIntegerVoxelCoords	​Converts a marker list from floating point (=continuous) voxel coordinates to integer (=index) voxel coordinates. The position is converted by mere flooring the components to integer. If Convert direction vectors as well is True, then the vector parts of a marker will also be transformed. This is done by first computing the target point based on the floating point position and vector, then converting that point to voxel coords, and finally computing the vector by subtracting the integer position from that integer target position.
​World to Floating-Point Voxel Coordinates	​WorldToFloatVoxel	​World to voxel coords,WorldToFloatingPointVoxelCoords	​Converts a marker list from world coordinates to floating point (=continuous) voxel coordinates using the image from input0. If Convert direction vectors as well is True, then the vector parts of a marker will also be transformed.
​Integer Voxel to World Coordinates	​IntegerVoxelToWorld	​IntegerVoxelToWorldCoords	​Converts the marker list from integer (=index) voxel coordinates to world coordinates using the image from input0. If Convert direction vectors as well is True, then the vector parts of a marker will also be transformed. Note: If Convert direction vectors as well is true, any non-integer coordinate in x-, y- or z-dimension for marker.pos or marker.vec will be rounded to the closest integer before the conversion (e.g. 0.5 is rounded to 1, so don’t provide floating point voxel coordinates!).
​World to Integer Voxel Coordinates	​WorldToIntegerVoxel	​WorldToIntegerVoxelCoords	​Converts a marker list from world coordinates to integer (=index) voxel coordinates using using the image from input0. If Convert direction vectors as well is True, then the vector parts of a marker will also be transformed. This is done by first computing the floating point target position based on the floating point position and vector, then converting that point to voxel coords, and finally computing the integer vector by subtracting the integer position from that integer target position.
​Integer Voxel to Floating-Point Voxel Coordinates	​IntegerVoxelToFloatVoxel	​IntegerToFloatingPointVoxelCoords	​Converts a marker list from integer (=index) voxel coordinates to floating point (=continuous) voxel coordinates. The resulting positions will point to voxel centers (i.e. will all end with .5). If Convert direction vectors as well is False, then the vector parts of each marker will not be touched. Note: If Convert direction vectors as well is true, any non-integer coordinate in x-, y- or z-dimension for marker.pos or marker.vec will be rounded to the closest integer before the conversion (e.g. 0.5 is rounded to 1, so don’t provide floating point voxel coordinates!).
​Floating-Point Voxel To World Coordinates	​FloatVoxelToWorld	​FloatingPointVoxelToWorldCoords,Voxel to world coords	​Converts a marker list from floating point (=continuous) voxel coordinates to world coordinates using the image from input0. If Convert direction vectors as well is True, then the vector parts of a marker will also be transformed.

Convert direction vectors as well

name: enableDirectionVectorConversion, type: Bool, default: TRUE, deprecated name: isConvertVectorComponents

If TRUE the vector component of each marker will also be converted. Only makes sense if the vector component actually represents a direction vector in the input marker’s coordinate system!

See documentation of Conversion Mode items for details on how the vector is translated in each mode.