Back to Aurora Vision Library website
You are here: Start » Function Reference » Surface » Surface Basics » CreateSurfaceFromImage
CreateSurfaceFromImage
Header: | AVL.h |
---|---|
Namespace: | avl |
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 avl::CreateSurfaceFromImage ( const avl::Image& inImage, atl::Optional<const avl::Region&> inRoi, const avl::PointCloudCoordinateTransform& inXCoordinateTransform, const avl::PointCloudCoordinateTransform& inYCoordinateTransform, const avl::PointCloudCoordinateTransform& inZCoordinateTransform, const avl::OutputSurfaceFormat& inCreatedSurfaceFormat, avl::Surface& outSurface, avl::Region& diagSurfaceValidPointsRegion, avl::Point3DGrid& diagPoint3DGrid )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
inImage | const Image& | Source image with per pixel encoded XYZ coordinates | ||
inRoi | Optional<const Region&> | NIL | Region determining valid points in resulting point grid | |
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 | |
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 | |
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 | |
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 | |
outSurface | Surface& | |||
diagSurfaceValidPointsRegion | Region& | Region of locations where the surface points are valid | ||
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.
- CreatePoint3DGridFromImage – Creates a Point3DGrid structure from coordinates encoded in pixels of image.