Back to FabImage Library website

You are here: Start » Function Reference » Surface » Surface Basics » CreateSurfaceFromImage

CreateSurfaceFromImage


Header: FIL.h
Namespace: fil
Module: Vision3DStandard

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#
 
void fil::CreateSurfaceFromImage
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	const fil::PointCloudCoordinateTransform& inXCoordinateTransform,
	const fil::PointCloudCoordinateTransform& inYCoordinateTransform,
	const fil::PointCloudCoordinateTransform& inZCoordinateTransform,
	const fil::OutputSurfaceFormat& inCreatedSurfaceFormat,
	fil::Surface& outSurface,
	fil::Region& diagSurfaceValidPointsRegion,
	fil::Point3DGrid& diagPoint3DGrid
)

Parameters

Name Type Default Description
Input value inImage const Image& Source image with per pixel encoded XYZ coordinates
Input value inRoi Optional<const Region&> NIL Region determining valid points in resulting point grid
Input value inXCoordinateTransform const PointCloudCoordinateTransform& PointCloudCoordinateTransform ( Offset: 0.000000D ValueCoordinateTransform: ImageValueCoordinateTransform( ChannelIndex: 0 Scale: 1.0D InvalidValues: Nil ) LocationCoordinateTransform: Nil Limits: ValueLimits_f64( MinValue: Nil, MaxValue: Nil ) ) Description of the creation of the X coordinate
Input value inYCoordinateTransform const PointCloudCoordinateTransform& PointCloudCoordinateTransform ( Offset: 0.000000D ValueCoordinateTransform: ImageValueCoordinateTransform( ChannelIndex: 1 Scale: 1.0D InvalidValues: Nil ) LocationCoordinateTransform: Nil Limits: ValueLimits_f64( MinValue: Nil, MaxValue: Nil ) ) Description of the creation of the Y coordinate
Input value inZCoordinateTransform const PointCloudCoordinateTransform& PointCloudCoordinateTransform ( Offset: 0.000000D ValueCoordinateTransform: ImageValueCoordinateTransform( ChannelIndex: 2 Scale: 1.0D InvalidValues: Nil ) LocationCoordinateTransform: Nil Limits: ValueLimits_f64( MinValue: Nil, MaxValue: Nil ) ) Description of the creation of the Z coordinate
Input value inCreatedSurfaceFormat const OutputSurfaceFormat& OutputSurfaceFormat ( XScale: 1.000000D YScale: 1.000000D ZScale: 1.000000D ZOffset: 0.000000D PointType: UInt16 MultipointHeight: Mean ) Parameters for arranging points into Surface
Output value outSurface Surface&
Diagnostic input diagSurfaceValidPointsRegion Region& Region of locations where the surface points are valid
Diagnostic input diagPoint3DGrid Point3DGrid& Points decoded before arranging them into Surface

Description

The operation creates a point cloud object based on the input point image. It can be thought of as a combination of two operations: CreatePoint3DGridFromImage and ArrangePoint3DArray.

See Also

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