PointCloudComponentTypeCoercer

All input features must have point cloud geometry.

The updated features are output through this port.

The components which should have their type converted.

The desired type of the components.

The method with which to perform the conversion.

• Cast - Uses C-style casts.
• Bounded cast - Uses C-style casts, but also validates that the source values fit into the destination type, effectively preventing underflow and overflow. If a source value does not fit, the corresponding destination value will either be set to its type's minimum or maximum value.
• Scale by data type - Scales the source values while preserving all proportions in regard to the source and destination types' range. This is typically used when converting color components, e.g. from UInt8 to UInt16.
• Scale by data values - Finds the minimum and maximum values of the source values and uses them to scale the values to the full range of the destination type.
• Scale by data values, preserve values - Similar to Scale by data values, but also sets a scale and offset on the destination component so that the original values are preserved. This may be useful when you have floating point values but need to convert them to an integer type, while still preserving the original values. For example, this could be used when reading Real64 coordinates (e.g. from the POINTCLOUDXYZ reader) and writing to a format that only supports integer coordinates (e.g. the LAS writer).

Note that all conversion types except Scale by data values, preserve values are applied to the raw data values, before any transformation is applied. For example, if you have a component with an offset of 0.5, converting the type to an integer type will not remove the fractional part – the scale/offset will be preserved. To convert the final value after the scale/offset has been applied, the transformation should be applied first using a PointCloudTransformationApplier.

Specifies the action to perform when converting from a floating-point value to an integer.

• Round - Rounds the floating-point value to the nearest integer.
• Ceiling - Gets the next integer which is greater than or equal to the floating-point value.
• Floor - Gets the next integer which is less than or equal to the floating-point value.