CreateSurfaceFromImage


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

Applications: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.

Syntax

C++
C#
Python
 
def CreateSurfaceFromImage(
	inImage: Image,
	inXCoordinateTransform: PointCloudCoordinateTransform,
	inYCoordinateTransform: PointCloudCoordinateTransform,
	inZCoordinateTransform: PointCloudCoordinateTransform,
	outSurface: Surface,
	/,
	*,
	inRoi: Region | None = None,
	inCreatedSurfaceFormat: OutputSurfaceFormat = OutputSurfaceFormat(1.000000, 1.000000, 1.000000, 0.000000, PlainType.UInt16, SurfaceMultipointHeight.Mean),
	diagSurfaceValidPointsRegion: Region | None = None,
	diagPoint3DGrid: Point3DGrid | None = None
)
-> None

Parameters

Name Type Default Description
Input value inImage Image Source image with per pixel encoded XYZ coordinates
Input value inRoi Region | None None Region determining valid points in resulting point grid
Input value inXCoordinateTransform PointCloudCoordinateTransform Description of the creation of the X coordinate
Input value inYCoordinateTransform PointCloudCoordinateTransform Description of the creation of the Y coordinate
Input value inZCoordinateTransform PointCloudCoordinateTransform Description of the creation of the Z coordinate
Input value inCreatedSurfaceFormat OutputSurfaceFormat OutputSurfaceFormat(1.000000, 1.000000, 1.000000, 0.000000, PlainType.UInt16, SurfaceMultipointHeight.Mean) Parameters for arranging points into Surface
Output value outSurface Surface
Diagnostic input diagSurfaceValidPointsRegion Region | None None Region of locations where the surface points are valid
Diagnostic input diagPoint3DGrid Point3DGrid | None None Points decoded before arranging them into Surface