Back to FabImage Library website

You are here: Start » Function Reference » Point3DGrid » Point3DGrid Spatial Transforms » JoinPoint3DGrids

JoinPoint3DGrids


Header: FIL.h
Namespace: fil
Module: Vision3DLite

Combines two point grids into one.

Syntax

C++
C#
 
void fil::JoinPoint3DGrids
(
	const fil::Point3DGrid& inPoint3DGrid1,
	const fil::Point3DGrid& inPoint3DGrid2,
	ftl::Optional<int> inDeltaX,
	ftl::Optional<int> inDeltaY,
	fil::Point3DGrid& outPoint3DGrid
)

Parameters

Name Type Range Default Description
Input value
 inPoint3DGrid1 const Point3DGrid&
Input value
 inPoint3DGrid2 const Point3DGrid&
Input value
 inDeltaX Optional<int> 0 - NIL First index offset for second grid; if set to Nil, first grid's width is chosen
Input value
 inDeltaY Optional<int> 0 - 0 Second index offset for second grid; if set to Nil, first grid's height is chosen
Output value
 outPoint3DGrid Point3DGrid&

Description

The operation adds points from the second input grid to the first one, increasing the grid's dimensions if necessary. The inDeltaX and inDeltaY parameters determine the offsets added to indices of the second grid. The second grid's points will never overwrite points from the first grid, so if both grids have same dimensions and both inDeltaX and inDeltaY equal 0, no point from the second grid will be added. If inDeltaX is set to Nil, the width of the first input grid is chosen. Similarly, if inDeltaY is set to Nil, the height of the first input grid is chosen as the offset.

If the intention is to keep all points from both input grids, one of the offsets should be set to Nil.