Back to Adaptive Vision Library website

You are here: Start » Function Reference » Point3DGrid Basics » MakePoint3DGridFromImage


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.


void avl::MakePoint3DGridFromImage
	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


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


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.


List of possible exceptions:

Error type Description
DomainError Not a 3 channel image on input in MakePoint3DGridFromImage.
DomainError Not supported inImage pixel format in MakePoint3DGridFromImage.