You are here: Start » Function Reference » Document

Surface Basics

Icon Name Description / Applications Modules
AlignRegionToSurfaceCoordinatesFormat AlignRegionToSurfaceCoordinatesFormat

Returns region covering the same area for the surface with another coordinates format.


Transformation of regions defined on the image associated with the surface to image associated with another surface.

Vision3DStandard
AlignRegionToSurfaceFormat AlignRegionToSurfaceFormat

Returns region covering the same area for the surface with another format.


Transformation of regions defined on the image associated with the surface to image associated with another surface.

Vision3DStandard
ArrangePoint3DArray ArrangePoint3DArray

Creates a surface structure from Point3D array taking into account X and Y coordinates.

Vision3DStandard
ArrangePoint3DGrid ArrangePoint3DGrid

Creates a surface structure from Point3DGrid taking into account X and Y coordinates.

Vision3DStandard
ConvertCoordinateSystem2DTo3D ConvertCoordinateSystem2DTo3D

Converts a coordinate system connected with the surface image to a coordinate system connected with the surface.

Vision3DStandard
ConvertSurfaceType ConvertSurfaceType

Changes the point Z coordinate type.

Vision3DStandard
CreateFlatSurface CreateFlatSurface

Creates a uniform surface.

Vision3DStandard
CreateSurfaceFromImage CreateSurfaceFromImage

Creates a Surface structure from coordinates encoded in pixels of an image.


Creating a Surface structure out of an image obtained from a 3D camera or other external sources that encodes 3D surface as pixel components of 2D image.

Vision3DStandard
GetSurfaceElement_Interpolated GetSurfaceElement_Interpolated

Returns an interpolated single point of a surface given its surface grid coordinates.

Vision3DStandard
GetSurfacePath GetSurfacePath

Returns a path consisting of interpolated single points of a surface given their surface grid coordinates.

Vision3DStandard
ImageBoxToSurfaceCoordinates ImageBoxToSurfaceCoordinates

Finds the surface coordinates of image box.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImageCircleToSurfaceCoordinates ImageCircleToSurfaceCoordinates

Finds the surface coordinates of image circle.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImageCoordinateSystemToSurfaceCoordinates ImageCoordinateSystemToSurfaceCoordinates

Finds the surface coordinates of image coordinate system.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImageLineToSurfaceCoordinates ImageLineToSurfaceCoordinates

Finds the surface coordinates of image line.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImagePathsToSurfaceCoordinates ImagePathsToSurfaceCoordinates

Finds the surface coordinates of image paths.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImagePathToSurfaceCoordinates ImagePathToSurfaceCoordinates

Finds the surface coordinates of image path.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImagePointsToSurfaceCoordinates ImagePointsToSurfaceCoordinates

Finds the surface coordinates of image points.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImagePointToSurfaceCoordinates ImagePointToSurfaceCoordinates

Finds the surface coordinates of image point.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImageSegmentsToSurfaceCoordinates ImageSegmentsToSurfaceCoordinates

Finds the surface coordinates of image segments.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImageSegmentToSurfaceCoordinates ImageSegmentToSurfaceCoordinates

Finds the surface coordinates of image segment.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ImageVectorToSurfaceCoordinates ImageVectorToSurfaceCoordinates

Finds the surface coordinates of image vector.


Transformation of results found on the image associated with the surface to the surface coordinates.

Vision3DStandard
ProjectPathOntoSurface ProjectPathOntoSurface

Returns a path consisting of interpolated single points of a surface given their coordinates in surface coordinate system.

Vision3DStandard
ProjectPointOntoSurface ProjectPointOntoSurface

Returns an interpolated single point of a surface given its coordinates in surface coordinate system.

Vision3DStandard
ProjectSurfaceOntoAxesPlane ProjectSurfaceOntoAxesPlane

Projects a surface onto one of three axes planes.

Vision3DStandard
ResamplePoint3DGrid ResamplePoint3DGrid

Creates a surface structure from Point3DGrid taking into account X and Y coordinates and trying to preserve continuity of the surface.

Vision3DStandard
SkipEmptySurface SkipEmptySurface

If the input Surface has at least one point defined, then it is copied to the output; otherwise Nil is returned.


Secures against domain errors caused by empty surfaces, e.g. just before the FitPlaneToSurface filter is to be invoked.

Vision3DStandard
SkipEmptySurfaceRegion SkipEmptySurfaceRegion

If the input surface contains at least one valid point in a given region, then the region is copied to the output; otherwise Nil is returned.


Secures against domain errors caused by regions with no valid point, e.g. just before the SurfaceMassCenter filter is to be invoked.

Vision3DStandard
SurfaceBoxToImageCoordinates SurfaceBoxToImageCoordinates

Finds the associated image coordinates of surface box.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfaceBoxToRegion SurfaceBoxToRegion

Finds the surface region covered by surface box.


Transformation of objects defined in the surface coordinate system to the associated surface region.

Vision3DStandard
SurfaceCircleToImageCoordinates SurfaceCircleToImageCoordinates

Finds the associated image coordinates of surface circle.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfaceCircleToRegion SurfaceCircleToRegion

Finds the surface region covered by surface circle.


Transformation of objects defined in the surface coordinate system to the associated surface region.

Vision3DStandard
SurfaceCoordinateSystemToImageCoordinates SurfaceCoordinateSystemToImageCoordinates

Finds the associated image coordinates of surface coordinate system.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfaceLineToImageCoordinates SurfaceLineToImageCoordinates

Finds the associated image coordinates of surface line.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfacePathsToImageCoordinates SurfacePathsToImageCoordinates

Finds the associated image coordinates of surface paths.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfacePathToImageCoordinates SurfacePathToImageCoordinates

Finds the associated image coordinates of surface path.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfacePathToRegion SurfacePathToRegion

Finds the surface region covered by surface path.


Transformation of objects defined in the surface coordinate system to the associated surface region.

Vision3DStandard
SurfacePointsToImageCoordinates SurfacePointsToImageCoordinates

Finds the associated image coordinates of surface points.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfacePointToImageCoordinates SurfacePointToImageCoordinates

Finds the associated image coordinates of surface point.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfaceSegmentsToImageCoordinates SurfaceSegmentsToImageCoordinates

Finds the associated image coordinates of surface segments.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfaceSegmentToImageCoordinates SurfaceSegmentToImageCoordinates

Finds the associated image coordinates of surface segment.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
SurfaceVectorToImageCoordinates SurfaceVectorToImageCoordinates

Finds the associated image coordinates of surface vector.


Transformation of objects defined in the surface coordinate system to the associated image coordinate system.

Vision3DStandard
TestSurface TestSurface

Returns a sample 3D surface.

Vision3DStandard

Surface Features

Icon Name Description / Applications Modules
ReplaceInvalidSurfacePoints ReplaceInvalidSurfacePoints

Replaces all invalid points with a given Z value.

Vision3DStandard
SurfaceArea SurfaceArea

Computes the surface area of given surface.

Vision3DStandard
SurfaceBoundingBox SurfaceBoundingBox

Computes the bounding box 3D of given surface.

Vision3DStandard
SurfaceBoundingBox_OrNil SurfaceBoundingBox_OrNil

Computes the bounding box 3D of given surface; returns NIL if no valid point is present.

Vision3DStandard
SurfaceFlatness SurfaceFlatness

Computes the surface flatness i.e. how thick the surface is according to the input plane.

Vision3DStandard
SurfaceLocalMaxima SurfaceLocalMaxima

Finds surface locations characterized by locally maximal heights.


Detection of characteristic points, usually after some surface transformations.

Vision3DStandard
SurfaceLocalMinima SurfaceLocalMinima

Finds surface locations characterized by locally minimal heights.


Detection of characteristic points, usually after some surface transformations.

Vision3DStandard
SurfaceMassCenter SurfaceMassCenter

Computes the mass center of surface points.

Vision3DStandard
SurfaceMassCenter_OrNil SurfaceMassCenter_OrNil

Computes the mass center of surface points; returns NIL if the surface is empty in the given region.

Vision3DStandard
SurfaceMaximalPoint SurfaceMaximalPoint

Finds the surface point with maximal Z coordinate.

Vision3DStandard
SurfaceMedian SurfaceMedian

Finds the median Z coordinate of the surface points.

Vision3DStandard
SurfaceMedian_OrNil SurfaceMedian_OrNil

Finds the median Z coordinate of the surface points; returns NIL if the surface is empty in the given region.

Vision3DStandard
SurfaceMinimalPoint SurfaceMinimalPoint

Finds the surface point with minimal Z coordinate.

Vision3DStandard
SurfaceMultiplePointsAlongAxis SurfaceMultiplePointsAlongAxis

Returns multiple arrays of surface points along X or Y axis.

Vision3DStandard
SurfaceMultipleProfilesAlongAxis SurfaceMultipleProfilesAlongAxis

Creates the profiles of point Z values along X or Y axis.

Vision3DStandard
SurfaceNormalsImage

Computes a normals image for a surface

Vision3DStandard
SurfaceProfileAlongPath SurfaceProfileAlongPath

Creates a series of segments across the input path, measures the average surface height on each of the segments, and creates the final profile from those values.


This is the first step of all 1D Edge Detection 3D operations. Here available for direct use by the user.

Vision3DStandard
SurfaceSinglePointsAlongAxis SurfaceSinglePointsAlongAxis

Returns single array of surface points along X or Y axis.

Vision3DStandard
SurfaceSingleProfileAlongAxis SurfaceSingleProfileAlongAxis

Creates the profile of point Z values along X or Y axis.

Vision3DStandard
SurfaceToPlaneDistanceImage SurfaceToPlaneDistanceImage

Computes the image of the distances of the input surface points from a given plane.

Vision3DStandard
SurfaceValidPointsRegion SurfaceValidPointsRegion

Computes region of locations where points are valid in a surface and where they are invalid.

Vision3DStandard
SurfaceVolume_Double SurfaceVolume_Double

Computes the volume of a surface with respect to another surface.

Vision3DStandard
SurfaceVolume_Single SurfaceVolume_Single

Computes the volume of a surface with respect to a plane.

Vision3DStandard

Surface Fitting

Icon Name Description / Applications Modules
FitCircleToSurfaceHole FitCircleToSurfaceHole

Fits a circle to a hole in a surface plane.

Vision3DStandard
FitPlaneToSurface FitPlaneToSurface

Approximates points of the input surface with a plane using the Least Squares method.

Vision3DStandard
FitPlaneToSurface_M FitPlaneToSurface_M

Approximates points of the input surface with a plane using selected M-estimator for outlier suppression.


Finding a locally optimal plane. Good enough when the number of outliers is small.

Vision3DStandard

Surface Interpolations

Icon Name Description / Applications Modules
ResampleSurface ResampleSurface

Equalizes the scales format of the input surface.

Vision3DStandard
ResampleSurface_AnyScales ResampleSurface_AnyScales

Changes the coordinates format of the input surface.

Vision3DStandard
SmoothSurface_Gauss SmoothSurface_Gauss

Smooths a surface using a gaussian kernel.


Removal of gaussian noise from surfaces.

Vision3DStandard
SmoothSurface_Mean SmoothSurface_Mean

Smooths a surface by averaging heights within a rectangular kernel.


Usually used for computing features related to local surface "windows". Can be also used for noise removal, but Gauss is superior here.

Vision3DStandard

Surface IO

Icon Name Description / Applications Modules
LoadSurface LoadSurface

Deserializes a surface from an FIDATA file.

Vision3DStandard
SaveSurface SaveSurface

Serializes a surface to an FIDATA file.

Vision3DStandard

Surface Spatial Transforms

Icon Name Description / Applications Modules
AbsoluteSurface AbsoluteSurface

Transforms Z coordinate of each surface point to its absolute value.

Vision3DStandard
CloseSurfacePoints CloseSurfacePoints

Reconstructs missing points of the input surface by interpolating neighboring points.

Vision3DStandard
CropSurface CropSurface

Removes from the surface points that are not contained in a given rectangular box.

Vision3DStandard
CropSurfaceByNeighborsProximity CropSurfaceByNeighborsProximity

Removes from the surface points that are too distant from their neighbor points.

Vision3DStandard
CropSurfaceByPlaneProximity CropSurfaceByPlaneProximity

Removes from the surface points that are too distant from a given plane.

Vision3DStandard
CropSurfaceToBox3D CropSurfaceToBox3D

Removes from the surface points that are not contained in a given box in 3D.

Vision3DStandard
CropSurfaceToRegion CropSurfaceToRegion

Removes points that are not present in a given region.

Vision3DStandard
CropSurface_Dynamic CropSurface_Dynamic

Removes from the surface points that are relatively too distant from their average neighbor points in a local rectangular neighborhood.

Vision3DStandard
CropSurface_Relative CropSurface_Relative

Removes from the surface points that are relatively too distant from their average neighbor points in a local rectangular neighborhood.

Vision3DStandard
DilateSurfacePoints DilateSurfacePoints

Reconstructs missing points of the input surface by interpolating neighboring points.

Vision3DStandard
ErodeSurfacePoints ErodeSurfacePoints

Removes some existing points from the input surface when some points in their vicinity are missing.

Vision3DStandard
FlattenSurface FlattenSurface

Flattens a curved surface.

Vision3DStandard
FlattenSurface_WithScalePreserving FlattenSurface_WithScalePreserving

Flattens a curved surface preserving the scale on the axes.

Vision3DStandard
JoinSurfaces JoinSurfaces

Combines two surfaces into one.

Vision3DStandard
MirrorSurface MirrorSurface

Transforms Z coordinate of each surface point to its opposite value.

Vision3DStandard
OpenSurfacePoints OpenSurfacePoints

Removes some existing points from the input surface when some points in their vicinity are missing.

Vision3DStandard
ProjectSurfaceOntoPlane ProjectSurfaceOntoPlane

Projects a surface on another plane, replacing Z coordinate of a point with its distance from a given plane.

Vision3DStandard
ReduceSurface ReduceSurface

Reduces surface dimensions as much as possible.

Vision3DStandard
RescaleSurface RescaleSurface

Changes the distances of surface points to a reference point.

Vision3DStandard
SplitSurfaceByPlane SplitSurfaceByPlane

Separates the surface points being on one side of the input plane from the others.

Vision3DStandard
SubtractSurfaces SubtractSurfaces

Subtracts two surfaces point by point.

Vision3DStandard
TranslateSurface TranslateSurface

Translates a surface by a vector.

Vision3DStandard