Back to Aurora Vision Library website

You are here: Start » Function Reference » All Functions » Point3DGrid Basics » MakePoint3DGridFromImage_Deprecated

MakePoint3DGridFromImage_Deprecated


This is Filter Equivalent. This function may be present in generated code, but should not be used in hand-written code.

Header: AVL.h
Namespace: avl
Module: FoundationBasic

Creates a Point3DGrid structure from coordinates encoded in pixels of a 3 channel image.

Applications: Creating a Point3DGrid structure out of an image obtained from a 3D camera or other external sources that encodes point cloud XYZ coordinates as pixel components of 2D image.

Syntax

void avl::MakePoint3DGridFromImage_Deprecated
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	double inXOffset,
	double inXScale,
	double inYOffset,
	double inYScale,
	double inZOffset,
	double inZScale,
	const avl::ValueLimits& inXLimits,
	const avl::ValueLimits& inYLimits,
	const avl::ValueLimits& inZLimits,
	avl::Point3DGrid& outPoint3DGrid
)

Parameters

Name Type Range Default Description
Input value inImage const Image& Source 3 channel image with per pixel encoded XYZ coordinates
Input value inRoi Optional<const Region&> NIL Region determining valid points in resulting point grid
Input value inXOffset double 0.0D
Input value inXScale double - - + 1.0D
Input value inYOffset double 0.0D
Input value inYScale double - - + 1.0D
Input value inZOffset double 0.0D
Input value inZScale double - - + 1.0D
Input value inXLimits const ValueLimits&
Input value inYLimits const ValueLimits&
Input value inZLimits const ValueLimits&
Output value outPoint3DGrid Point3DGrid&

Requirements

For input inImage only pixel formats are supported: 3⨯uint8, 3⨯int8, 3⨯uint16, 3⨯int16, 3⨯int32, 3⨯real.

Read more about pixel formats in Image documentation.

Errors

List of possible exceptions:

Error type Description
DomainError Not a 3 channel image on input in MakePoint3DGridFromImage_Deprecated.
DomainError Not supported inImage pixel format in MakePoint3DGridFromImage_Deprecated. Supported formats: 3xUInt8, 3xInt8, 3xUInt16, 3xInt16, 3xInt32, 3xReal.