Computes an EZMap from an EMesh. The value of the pixels of the ZMap are the distance between the 3D points and the reference plane. All 3D points under the reference plane are discarded. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.SetFillMode, EMeshToZMapConverter.SetMapXYResolution, EMeshToZMapConverter.MapZResolution, EMeshToZMapConverter.OrientationVector... When the conversion is called without defining specific parameters, the algorithm uses the following options: More...


Public Member Functions | |
| EMeshToZMapConverter () | |
| Creates an EMeshToZMapConverter object. | |
| EMeshToZMapConverter (eVision.Easy3D.EMeshToZMapConverter other) | |
| Creates an EMeshToZMapConverter object. | |
| void | Convert (eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap8 zmap) |
| Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ... | |
| void | Convert (eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap16 zmap) |
| Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ... | |
| void | Convert (eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap32f zmap) |
| Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ... | |
| void | Convert (eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap zmap) |
| Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ... | |
| void | UnsetWorldToZMapTransform () |
| Disables the explicit world to ZMap transformation, set with EMeshToZMapConverter.WorldToZMapTransform. | |
| void | UnsetOrigin () |
| Lets the conversion process decides for the EZMap origin position (based on projected point cloud on the reference plane). | |
| bool | IsOriginSet () |
| Gets whether the Origin of the ZMap is set or not. Use EMeshToZMapConverter.Origin to enable and choose the ZMap origin. | |
| void | EnableFillMode (bool state) |
| Enables or disables fill mode. Fill mode parameters are defined by method EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian. | |
| void | EnableFillMode () |
| Enables or disables fill mode. Fill mode parameters are defined by method EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian. | |
| bool | IsFillModeEnabled () |
| Tells if the fill mode is enabled or not. | |
| bool | IsFillModeMedian () |
| Tells if the fill mode is in median mode or not, this value is not affected by EMeshToZMapConverter.EnableFillMode. Use EMeshToZMapConverter.EnableFillMode to toggle the fill mode and EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian to set the filling parameters. | |
| void | SetFillMode (eVision.Easy3D.EFillUndefinedPixelsDirection direction, eVision.Easy3D.EFillUndefinedPixelsMethod method) |
| Inpainting options used to fill the "holes" in the EZMap. A hole exists when no 3D point is projected at that pixel position in the ZMap. | |
| void | SetFillModeMedian (uint halfOfKernelWidth, uint halfOfKernelHeight) |
| Inpainting options used to fill the "holes" in the EZMap using a median rectangular kernel of odd size. A hole exists when no 3D point is projected at that pixel position in the ZMap. | |
| void | SetFillModeMedian (uint halfOfKernelWidth) |
| Inpainting options used to fill the "holes" in the EZMap using a median rectangular kernel of odd size. A hole exists when no 3D point is projected at that pixel position in the ZMap. | |
| void | SetFillModeMedian () |
| Inpainting options used to fill the "holes" in the EZMap using a median rectangular kernel of odd size. A hole exists when no 3D point is projected at that pixel position in the ZMap. | |
| void | SetMapSize (int width, int height) |
| Sets the required size of the generated EZMap; expressed in number of pixels for width and height dimensions. | |
| void | UnsetMapSize () |
| Unsets the resolution. Lets the conversion decides for the optimum resolution, depending on the projected point cloud and pixel scale. | |
| void | SetMapXYResolution (float resolution) |
| Sets the resolution (possibly anisotropic) of the EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel). | |
| void | SetMapXYResolution (float resolutionX, float resolutionY) |
| Sets the resolution (possibly anisotropic) of the EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel). | |
| void | UnsetMapXYResolution () |
| Unsets the X and Y resolutions. Lets the conversion decide the optimal resolution, depending on the projected point cloud and EZMap size. | |
| void | UnsetMapZResolution () |
| Unsets the EMeshToZMapConverter.MapZResolution (as well as the EMeshToZMapConverter.MapZResolutionFailureHandler). Lets the conversion decide the optimal Z resolution. | |
| void | Load (string path) |
| Loads the converter configuration. The given ESerializer must have been created for reading. | |
| void | Load (eVision.ESerializer serializer) |
| Loads the converter configuration. The given ESerializer must have been created for reading. | |
| void | Save (string path) |
| Saves the converter configuration. The given ESerializer must have been created for writing. | |
| void | Save (eVision.ESerializer serializer) |
| Saves the converter configuration. The given ESerializer must have been created for writing. | |
Properties | |
| eVision.Easy3D.E3DTransformMatrix | WorldToZMapTransform [get, set] |
| Explicitly sets the world to ZMap transformation. | |
| eVision.Easy3D.E3DTransformMatrix | ZMaptoWorldTransform [get, set] |
| Explicitly sets the ZMap to World transformation. | |
| eVision.Easy3D.E3DPlane | ReferencePlane [get, set] |
| Gets the E3DPlane reference plane. | |
| eVision.Easy3D.EZMapReferencePlaneMode | ReferencePlaneMode [get, set] |
| Sets an axis aligned reference plane. | |
| eVision.Easy3D.E3DPoint | OrientationVector [get, set] |
| Sets an explicit orientation for the EZMap. | |
| eVision.Easy3D.EZMapOrientationVectorMode | OrientationVectorMode [get, set] |
| Chooses the EZMap orientation from a list of predefined axis, automatic mode or user defined vector. | |
| eVision.Easy3D.E3DPoint | Origin [get, set] |
| Chooses the EZMap origin. It is the 3D world position used as origin of the ZMap upper left pixel (0,0). | |
| uint | FillModeMedianHalfKernelX [get] |
| Returns the last halfKernelX set by EMeshToZMapConverter.SetFillModeMedian. | |
| uint | FillModeMedianHalfKernelY [get] |
| Returns the last halfKernelX set by EMeshToZMapConverter.SetFillModeMedian. | |
| eVision.Easy3D.EFillUndefinedPixelsDirection | FillUndefinedPixelsDirection [get] |
| Gets the undefined pixel fill direction (see EFillUndefinedPixelsDirection). | |
| eVision.Easy3D.EFillUndefinedPixelsMethod | FillUndefinedPixelsMethod [get] |
| Gets the undefined pixel fill method (see EFillUndefinedPixelsMethod). | |
| int | MapWidth [get] |
| Gets the required width (number of pixels) of the generated EZMap. | |
| int | MapHeight [get] |
| Gets the required height (number of pixels) of the generated EZMap. | |
| float | MapXResolution [get] |
| Gets the resolution of the EZMap pixels along the X axis. | |
| float | MapYResolution [get] |
| Gets the resolution of the EZMap pixels along the Y axis. | |
| float | MapZResolution [get, set] |
| Gets/Sets the EZMap Z resolution, in world space units per gray value. | |
| eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler | MapZResolutionFailureHandler [get, set] |
| Gets/Sets the method to handle failures in EMeshToZMapConverter.Convert when the EZMap Z resolution is set explicitly (EMeshToZMapConverter.MapZResolution). | |
| float | Extension [get, set] |
| Gets the 3D point cloud extension. | |
Computes an EZMap from an EMesh. The value of the pixels of the ZMap are the distance between the 3D points and the reference plane. All 3D points under the reference plane are discarded. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.SetFillMode, EMeshToZMapConverter.SetMapXYResolution, EMeshToZMapConverter.MapZResolution, EMeshToZMapConverter.OrientationVector... When the conversion is called without defining specific parameters, the algorithm uses the following options:
License(s): Easy3D
| eVision.Easy3D.EMeshToZMapConverter.EMeshToZMapConverter | ( | ) |
Creates an EMeshToZMapConverter object.
| eVision.Easy3D.EMeshToZMapConverter.EMeshToZMapConverter | ( | eVision.Easy3D.EMeshToZMapConverter | other | ) |
Creates an EMeshToZMapConverter object.
| other | Reference to the EMeshToZMapConverter object used for the initialization. |
| void eVision.Easy3D.EMeshToZMapConverter.Convert | ( | eVision.Easy3D.EMesh | obj, |
| eVision.Easy3D.EZMap | zmap ) |
Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ...
| obj | The input 3D mesh. |
| zmap | The generated ZMap in 8, 16 or 32 bits format. |
| void eVision.Easy3D.EMeshToZMapConverter.Convert | ( | eVision.Easy3D.EMesh | obj, |
| eVision.Easy3D.EZMap16 | zmap ) |
Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ...
| obj | The input 3D mesh. |
| zmap | The generated ZMap in 8, 16 or 32 bits format. |
| void eVision.Easy3D.EMeshToZMapConverter.Convert | ( | eVision.Easy3D.EMesh | obj, |
| eVision.Easy3D.EZMap32f | zmap ) |
Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ...
| obj | The input 3D mesh. |
| zmap | The generated ZMap in 8, 16 or 32 bits format. |
| void eVision.Easy3D.EMeshToZMapConverter.Convert | ( | eVision.Easy3D.EMesh | obj, |
| eVision.Easy3D.EZMap8 | zmap ) |
Computes an EZMap from a world space EMesh. The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector, EMeshToZMapConverter.SetMapSize, ...
| obj | The input 3D mesh. |
| zmap | The generated ZMap in 8, 16 or 32 bits format. |
| void eVision.Easy3D.EMeshToZMapConverter.EnableFillMode | ( | ) |
Enables or disables fill mode. Fill mode parameters are defined by method EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian.
Fill mode is enabled by default. If fill mode is disabled, undefined pixels may remain in the EZMap.
| void eVision.Easy3D.EMeshToZMapConverter.EnableFillMode | ( | bool | state | ) |
Enables or disables fill mode. Fill mode parameters are defined by method EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian.
Fill mode is enabled by default. If fill mode is disabled, undefined pixels may remain in the EZMap.
| state | Set to true to enable fill mode. |
| bool eVision.Easy3D.EMeshToZMapConverter.IsFillModeEnabled | ( | ) |
Tells if the fill mode is enabled or not.
Use EMeshToZMapConverter.EnableFillMode to toggle the fill mode and EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian to set the filling parameters.
| bool eVision.Easy3D.EMeshToZMapConverter.IsFillModeMedian | ( | ) |
Tells if the fill mode is in median mode or not, this value is not affected by EMeshToZMapConverter.EnableFillMode. Use EMeshToZMapConverter.EnableFillMode to toggle the fill mode and EMeshToZMapConverter.SetFillMode or EMeshToZMapConverter.SetFillModeMedian to set the filling parameters.
| bool eVision.Easy3D.EMeshToZMapConverter.IsOriginSet | ( | ) |
Gets whether the Origin of the ZMap is set or not. Use EMeshToZMapConverter.Origin to enable and choose the ZMap origin.
| void eVision.Easy3D.EMeshToZMapConverter.Load | ( | eVision.ESerializer | serializer | ) |
Loads the converter configuration. The given ESerializer must have been created for reading.
| serializer | The serializer. |
| void eVision.Easy3D.EMeshToZMapConverter.Load | ( | string | path | ) |
Loads the converter configuration. The given ESerializer must have been created for reading.
| path | The file path. |
| void eVision.Easy3D.EMeshToZMapConverter.Save | ( | eVision.ESerializer | serializer | ) |
Saves the converter configuration. The given ESerializer must have been created for writing.
| serializer | Pointer to the ESerializer created for writing. |
| void eVision.Easy3D.EMeshToZMapConverter.Save | ( | string | path | ) |
Saves the converter configuration. The given ESerializer must have been created for writing.
| path | The file path. |
| void eVision.Easy3D.EMeshToZMapConverter.SetFillMode | ( | eVision.Easy3D.EFillUndefinedPixelsDirection | direction, |
| eVision.Easy3D.EFillUndefinedPixelsMethod | method ) |
Inpainting options used to fill the "holes" in the EZMap. A hole exists when no 3D point is projected at that pixel position in the ZMap.
| direction | Direction in which the undefined pixels are filled in a depthmap from EFillUndefinedPixelsDirection |
| method | Which values used to fill the undefined pixels in a depthmap from EFillUndefinedPixelsMethod |
| void eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian | ( | ) |
Inpainting options used to fill the "holes" in the EZMap using a median rectangular kernel of odd size. A hole exists when no 3D point is projected at that pixel position in the ZMap.
| void eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian | ( | uint | halfOfKernelWidth | ) |
Inpainting options used to fill the "holes" in the EZMap using a median rectangular kernel of odd size. A hole exists when no 3D point is projected at that pixel position in the ZMap.
| halfOfKernelWidth | Half of the box width minus one (by default, halfOfKernelWidth = 2). |
| void eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian | ( | uint | halfOfKernelWidth, |
| uint | halfOfKernelHeight ) |
Inpainting options used to fill the "holes" in the EZMap using a median rectangular kernel of odd size. A hole exists when no 3D point is projected at that pixel position in the ZMap.
| halfOfKernelWidth | Half of the box width minus one (by default, halfOfKernelWidth = 2). |
| halfOfKernelHeight | Half of the box height minus one (by default, same as halfOfKernelWidth). |
| void eVision.Easy3D.EMeshToZMapConverter.SetMapSize | ( | int | width, |
| int | height ) |
Sets the required size of the generated EZMap; expressed in number of pixels for width and height dimensions.
By default, the required size is not set.
| width | The required width for the Generated ZMap. |
| height | The required height for the Generated ZMap. |
| void eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution | ( | float | resolution | ) |
Sets the resolution (possibly anisotropic) of the EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel).
The resolution is used to compute the ZMap size (width and height), depending on the projected point cloud on the reference plane.
| resolution | The resolution for the isotropic case. |
The isotropic scale, for X and Y axis is in metric world units.
| void eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution | ( | float | resolutionX, |
| float | resolutionY ) |
Sets the resolution (possibly anisotropic) of the EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel).
The resolution is used to compute the ZMap size (width and height), depending on the projected point cloud on the reference plane.
| resolutionX | The resolution for the X axis. |
| resolutionY | The resolution for the Y axis. |
The isotropic scale, for X and Y axis is in metric world units.
| void eVision.Easy3D.EMeshToZMapConverter.UnsetMapSize | ( | ) |
Unsets the resolution. Lets the conversion decides for the optimum resolution, depending on the projected point cloud and pixel scale.
| void eVision.Easy3D.EMeshToZMapConverter.UnsetMapXYResolution | ( | ) |
Unsets the X and Y resolutions. Lets the conversion decide the optimal resolution, depending on the projected point cloud and EZMap size.
| void eVision.Easy3D.EMeshToZMapConverter.UnsetMapZResolution | ( | ) |
Unsets the EMeshToZMapConverter.MapZResolution (as well as the EMeshToZMapConverter.MapZResolutionFailureHandler). Lets the conversion decide the optimal Z resolution.
| void eVision.Easy3D.EMeshToZMapConverter.UnsetOrigin | ( | ) |
Lets the conversion process decides for the EZMap origin position (based on projected point cloud on the reference plane).
Use EMeshToZMapConverter.Origin to enable and choose the ZMap origin.
| void eVision.Easy3D.EMeshToZMapConverter.UnsetWorldToZMapTransform | ( | ) |
Disables the explicit world to ZMap transformation, set with EMeshToZMapConverter.WorldToZMapTransform.
|
getset |
Gets the 3D point cloud extension.
|
get |
Returns the last halfKernelX set by EMeshToZMapConverter.SetFillModeMedian.
|
get |
Returns the last halfKernelX set by EMeshToZMapConverter.SetFillModeMedian.
|
get |
Gets the undefined pixel fill direction (see EFillUndefinedPixelsDirection).
|
get |
Gets the undefined pixel fill method (see EFillUndefinedPixelsMethod).
|
get |
Gets the required height (number of pixels) of the generated EZMap.
By default, the required size is not set.
|
get |
Gets the required width (number of pixels) of the generated EZMap.
By default, the required size is not set.
|
get |
Gets the resolution of the EZMap pixels along the X axis.
|
get |
Gets the resolution of the EZMap pixels along the Y axis.
|
getset |
Gets/Sets the EZMap Z resolution, in world space units per gray value.
The resolution is used to compute the transformation of the world Z position to an integer 8, 16 or 32 bits pixel value.
If the resolution set is too small to represent the whole 3D data, it will have to be cropped, saturated or an exception will be thrown. By default, the data is cropped. To specify another behavior, use EMeshToZMapConverter.MapZResolutionFailureHandler.
|
getset |
Gets/Sets the method to handle failures in EMeshToZMapConverter.Convert when the EZMap Z resolution is set explicitly (EMeshToZMapConverter.MapZResolution).
If the resolution set by EMeshToZMapConverter.MapZResolution is too small to represent the whole 3D data, it may be cropped, saturated or an exception may be thrown. By default, data is cropped.
|
getset |
Sets an explicit orientation for the EZMap.
Overrides the orientation mode given by the method EMeshToZMapConverter.OrientationVectorMode.
The direction should be an E3DPoint representing the expected direction of the X (width) axis of the ZMap. That direction will be used after projection on the reference plane normal. That direction must NOT be aligned with the reference plane normal.
|
getset |
Chooses the EZMap orientation from a list of predefined axis, automatic mode or user defined vector.
Use EMeshToZMapConverter.OrientationVector to set an explicit orientation vector for the ZMap.
Choose between Automatic mode (default), world space axis or explicit user defined vector (see EZMapOrientationVectorMode).
|
getset |
Chooses the EZMap origin. It is the 3D world position used as origin of the ZMap upper left pixel (0,0).
That position will be projected on the reference plane.
To let the conversion choose for the origin, call EMeshToZMapConverter.UnsetOrigin.
|
getset |
Gets the E3DPlane reference plane.
Use EMeshToZMapConverter.ReferencePlane to set an explicit reference plane.
|
getset |
Sets an axis aligned reference plane.
Overrides the explicit reference plane given by the method EMeshToZMapConverter.ReferencePlane.
Choose between X, Y or Z reference plane (see EZMapReferencePlaneMode).
The plane offset is set automatically on the point cloud lowest 3D point.
|
getset |
Explicitly sets the world to ZMap transformation.
EMeshToZMapConverter.WorldToZMapTransform overrides the settings done by EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector and EMeshToZMapConverter.Origin. That E3DTransformMatrix transform expresses how the world positions are transformed to the EZMap space. The matrix must be a rigid transformation (translation and rotation only). The resolution of the ZMap are defined by the EMeshToZMapConverter.SetMapXYResolution and EMeshToZMapConverter.MapZResolution methods.
|
getset |
Explicitly sets the ZMap to World transformation.
"SetZMaptoWorldTransform" overrides the settings done by EMeshToZMapConverter.ReferencePlane, EMeshToZMapConverter.OrientationVector and EMeshToZMapConverter.Origin. That E3DTransformMatrix transform expresses how the EZMap positions are transformed to the World space. The matrix must be a rigid transformation (translation and rotation only).
The resolutions of the World are defined by the EMeshToZMapConverter.SetMapXYResolution and EMeshToZMapConverter.MapZResolution methods.