Neighborhood extraction
[Core]

---

Detailed Description

Functions to manipulate and extract neighborhood in images The extraction of a neighborhood is done for each FLGR_Data2D source pixels. A computation is done and the corresponding pixels in the destination is replace2dd by the result.

See also:

Sliding Window

Data Structures
struct	FLGR_NhbBox1D
struct	FLGR_NhbBox2D
Functions
FLGR_NhbBox1D *	flgr1d_create_neighbor_box (FLGR_Data1D *data)
void	flgr1d_destroy_neighbor_box (FLGR_NhbBox1D *extr)
FLGR_Ret	flgr1d_get_neighborhood (FLGR_NhbBox1D *extr, FLGR_Data1D *dat, FLGR_Data1D *nhb, int pos)
FLGR_Ret	flgr1d_get_neighborhood_unfolded (FLGR_NhbBox1D *extr, FLGR_Data1D *dat, FLGR_Data1D *nhb, int pos)
FLGR_MorphoOptim	flgr1d_get_optimization_available (FLGR_Data1D *datdest, FLGR_Data1D *datsrc, FLGR_Data1D *nhb)
FLGR_NhbBox2D *	flgr2d_create_neighbor_box (FLGR_Data2D *data)
void	flgr2d_destroy_neighbor_box (FLGR_NhbBox2D *extr)
FLGR_Ret	flgr2d_get_neighborhood (FLGR_NhbBox2D *extr, FLGR_Data2D *dat, FLGR_Data2D *nhb, int row, int col)
FLGR_Ret	flgr2d_get_neighborhood_unfolded (FLGR_NhbBox2D *extr, FLGR_Data2D *dat, FLGR_Data2D *nhb, int row, int col)
FLGR_MorphoOptim	flgr2d_get_optimization_available (FLGR_Data2D *datdest, FLGR_Data2D *datsrc, FLGR_Data2D *nhb)

---

Function Documentation

FLGR_NhbBox1D* flgr1d_create_neighbor_box

(

FLGR_Data1D *

data

)

Allocate a 1D neighborhood box

Warning:

A special issue is made for fgBIT type. A fgBIT type could embedded 32 or 64 pixels but when pixels are extracted from the image only one pixel is store in a fgBIT element of the extr array to simplify processing

Parameters:

data

: a pointer to a FLGR_Data1D

Returns:

a pointer to a FLGR_NhbBox1D

Definition at line 63 of file flgrCoreNhbManage.c.

void flgr1d_destroy_neighbor_box

(

FLGR_NhbBox1D *

extr

)

Destroy a neighborhood box

Parameters:

extr

: a pointer to a FLGR_NhbBox1D

Returns:

nothing

Definition at line 116 of file flgrCoreNhbManage.c.

FLGR_Ret flgr1d_get_neighborhood	(	FLGR_NhbBox1D *	extr,
		FLGR_Data1D *	dat,
		FLGR_Data1D *	nhb,
		int	pos
	)

Extract a neighborhood in an image and copy to a neighborhood box Only relevant pixels are copied to neighborhood box. So the user must take car to extr->size to do computation

Parameters:

	extr	: a pointer to a FLGR_NhbBox1D
	dat	: a pointer to a FLGR_Data1D considered as an image
	nhb	: a pointer to a FLGR_Data1D considered as a neighborhood definition
	pos	: index

Returns:

FLGR_NhbBox1D

Definition at line 268 of file flgrCoreNhbManage.c.

FLGR_Ret flgr1d_get_neighborhood_unfolded	(	FLGR_NhbBox1D *	extr,
		FLGR_Data1D *	dat,
		FLGR_Data1D *	nhb,
		int	pos
	)

Extract a neighborhood in an image and copy to a neighborhood box Only relevant pixels are copied to neighborhood box. So the user must take car to extr->size to do computation

Parameters:

	extr	: a pointer to a FLGR_NhbBox1D
	dat	: a pointer to a FLGR_Data1D considered as an image
	nhb	: a pointer to a FLGR_Data1D considered as a neighborhood definition
	pos	: index

Returns:

FLGR_NhbBox1D

Definition at line 432 of file flgrCoreNhbManage.c.

FLGR_MorphoOptim flgr1d_get_optimization_available	(	FLGR_Data1D *	datdest,
		FLGR_Data1D *	datsrc,
		FLGR_Data1D *	nhb
	)

Return optimization flag for a neighborhood operation on a 1D signal

Parameters:

	datdest	: a pointer to a FLGR_Data1D
	datsrc	: a pointer to a FLGR_Data1D
	nhb	: a pointer to a FLGR_Data1D

Returns:

optimization flag

Definition at line 47 of file flgrCoreNhbManage.c.

FLGR_NhbBox2D* flgr2d_create_neighbor_box

(

FLGR_Data2D *

data

)

Allocate a 2D neighborhood box

Warning:

A special issue is made for fgBIT type. A fgBIT type could embedded 32 or 64 pixels but when pixels are extracted from the image only one pixel is store in a fgBIT element of the extr array to simplify processing

Parameters:

data

: a pointer to a FLGR_Data2D

Returns:

a pointer to a FLGR_NhbBox2D

Definition at line 559 of file flgrCoreNhbManage.c.

void flgr2d_destroy_neighbor_box

(

FLGR_NhbBox2D *

extr

)

Destroy a neighborhood box

Parameters:

extr

: a pointer to a FLGR_NhbBox2D

Returns:

nothing

Definition at line 618 of file flgrCoreNhbManage.c.

FLGR_Ret flgr2d_get_neighborhood	(	FLGR_NhbBox2D *	extr,
		FLGR_Data2D *	dat,
		FLGR_Data2D *	nhb,
		int	row,
		int	col
	)

Extract a neighborhood in an image and copy to a neighborhood box Only relevant pixels are copied to neighborhood box. So the user must take car to extr->size to do computation

Parameters:

	extr	: a pointer to a FLGR_NhbBox2D
	dat	: a pointer to a FLGR_Data2D considered as an image
	nhb	: a pointer to a FLGR_Data2D considered as a neighborhood definition
	row	: row index
	col	: col index

Returns:

FLGR_NhbBox2D

Definition at line 792 of file flgrCoreNhbManage.c.

FLGR_Ret flgr2d_get_neighborhood_unfolded	(	FLGR_NhbBox2D *	extr,
		FLGR_Data2D *	dat,
		FLGR_Data2D *	nhb,
		int	row,
		int	col
	)

Extract a neighborhood_unfolded in an image and copy to a neighborhood_unfolded box Only relevant pixels are copied to neighborhood_unfolded box. So the user must take car to extr->size to do computation

Parameters:

	extr	: a pointer to a FLGR_NhbBox2D
	dat	: a pointer to a FLGR_Data2D considered as an image
	nhb	: a pointer to a FLGR_Data2D considered as a neighborhood_unfolded definition
	row	: row index
	col	: col index

Returns:

FLGR_NhbBox2D

Definition at line 970 of file flgrCoreNhbManage.c.

FLGR_MorphoOptim flgr2d_get_optimization_available	(	FLGR_Data2D *	datdest,
		FLGR_Data2D *	datsrc,
		FLGR_Data2D *	nhb
	)

Return optimization flag for a neighborhood operation on a 2D image

Parameters:

	datdest	: a pointer to a FLGR_Data2D
	datsrc	: a pointer to a FLGR_Data2D
	nhb	: a pointer to a FLGR_Data2D

Returns:

optimization flag

Definition at line 491 of file flgrCoreNhbManage.c.