Domain and grey-value access procedures. More...

Files
file	WlzGreyValue.c
	Provides functions for random access to the grey values of 2D and 3D domain objects.

file	WlzInsideDomain.c
	Functions which check whether a given vertex lies within an object's domain.

Data Structures
struct	_WlzIntervalWSpace
	The standard workspace structure for interval objects. Typedef: WlzIntervalWSpace. More...

struct	_WlzGreyWSpace
	The standard workspace for grey value table manipulations. Typedef: WlzGreyWSpace. More...

struct	_WlzIterateWSpace
	A workspace structure for interval objects which allows iteration through an object's pixels/voxels. Typedef: WlzIterateWSpace. More...

struct	_WlzGreyValueWSpace
	Workspace for random access grey value manipulations. Typedef: WlzGreyValueWSpace. More...

Enumerations
enum	_WlzRasterDir { WLZ_RASTERDIR_DC = (1), WLZ_RASTERDIR_DL = (1 << 1), WLZ_RASTERDIR_DP = (1 << 2), WLZ_RASTERDIR_ILIC = (0), WLZ_RASTERDIR_ILDC = WLZ_RASTERDIR_DC, WLZ_RASTERDIR_DLIC = WLZ_RASTERDIR_DL, WLZ_RASTERDIR_DLDC = (WLZ_RASTERDIR_DL \| WLZ_RASTERDIR_DC), WLZ_RASTERDIR_IPILIC = WLZ_RASTERDIR_ILIC, WLZ_RASTERDIR_IPILDC = WLZ_RASTERDIR_ILDC, WLZ_RASTERDIR_IPDLIC = WLZ_RASTERDIR_DLIC, WLZ_RASTERDIR_IPDLDC = WLZ_RASTERDIR_DLDC, WLZ_RASTERDIR_DPILIC = (WLZ_RASTERDIR_DP \| WLZ_RASTERDIR_ILIC), WLZ_RASTERDIR_DPILDC = (WLZ_RASTERDIR_DP \| WLZ_RASTERDIR_ILDC), WLZ_RASTERDIR_DPDLIC = (WLZ_RASTERDIR_DP \| WLZ_RASTERDIR_DLIC), WLZ_RASTERDIR_DPDLDC = (WLZ_RASTERDIR_DP \| WLZ_RASTERDIR_DLDC) }
	Raster scan directions as used by WlzIntervalWSpace and WlzIterateWSpace. These are built using bit masks with bits set for decreasing in each of the directions. Typedef: WlzRasterDir. More...

Functions
WlzGreyValueWSpace *	WlzGreyValueMakeWSp (WlzObject obj, WlzErrorNum dstErrNum)
	Creates a grey value work space from the given object. The resulting grey value work space should be freed using WlzGreyValueFreeWSp(). More...

void	WlzGreyValueFreeWSp (WlzGreyValueWSpace *gVWSp)
	Free's the given grey value work space created by WlzGreyValueMakeWSp(). More...

void	WlzGreyValueGet (WlzGreyValueWSpace *gVWSp, double plane, double line, double kol)
	Gets a single grey value/pointer for the given point from the object with which the given work space was initialised. When the object has a non-scalar value table then only the first value will be returned, however when the value is not background all values can be accessed via the grey pointer. More...

void	WlzGreyValueGetCon (WlzGreyValueWSpace *gVWSp, double plane, double line, double kol)
	Gets the four/eight connected grey values/pointers for the given point which lie at: More...

WlzGreyType	WlzGreyValueGetGreyType (WlzGreyValueWSpace gVWSp, WlzErrorNum dstErr)
	Access function to get the object's grey type. More...

int	WlzGreyValueGetI (WlzGreyValueWSpace *gVWSp, double plane, double line, double kol)
	Gets a single grey value for the given point from the object with which the given work space was initialised. More...

double	WlzGreyValueGetD (WlzGreyValueWSpace *gVWSp, double plane, double line, double kol)
	Gets a single grey value for the given point from the object with which the given work space was initialised. More...

int	WlzInsideDomain2D (WlzIntervalDomain iDom, int line, int kol, WlzErrorNum dstErr)
	Looks to see if the given point is within the given interval domain. More...

int	WlzInsideDomain3D (WlzPlaneDomain pDom, int plane, int line, int kol, WlzErrorNum dstErr)
	Looks to see if the given point is within the given 3D domain. More...

int	WlzInsideDomain (WlzObject obj, double plane, double line, double kol, WlzErrorNum dstErr)
	Looks to see if the given point is within the objects domain. More...

Detailed Description

Domain and grey-value access procedures.

Enumeration Type Documentation

enum _WlzRasterDir

Raster scan directions as used by WlzIntervalWSpace and WlzIterateWSpace. These are built using bit masks with bits set for decreasing in each of the directions. Typedef: WlzRasterDir.

Enumerator
WLZ_RASTERDIR_DC	Used to build directions .
WLZ_RASTERDIR_DL	Used to build directions.
WLZ_RASTERDIR_DP	Used to build directions.
WLZ_RASTERDIR_ILIC	Increasing lines, increasing columns.
WLZ_RASTERDIR_ILDC	Increasing lines, decreasing columns.
WLZ_RASTERDIR_DLIC	Decreasing lines, increasing columns.
WLZ_RASTERDIR_DLDC	Decreasing lines, decreasing columns.
WLZ_RASTERDIR_IPILIC	Increasing planes, increasing lines, increasing columns.
WLZ_RASTERDIR_IPILDC	Increasing planes, increasing lines, decreasing columns.
WLZ_RASTERDIR_IPDLIC	Increasing planes, decreasing lines, increasing columns.
WLZ_RASTERDIR_IPDLDC	Increasing planes, decreasing lines, decreasing columns.
WLZ_RASTERDIR_DPILIC	Decreasing planes, increasing lines, increasing columns.
WLZ_RASTERDIR_DPILDC	Decreasing planes, increasing lines, decreasing columns.
WLZ_RASTERDIR_DPDLIC	Decreasing planes, decreasing lines, increasing columns.
WLZ_RASTERDIR_DPDLDC	Decreasing planes, decreasing lines, decreasing columns.

Function Documentation

WlzGreyValueWSpace* WlzGreyValueMakeWSp	(	WlzObject *	obj,
		WlzErrorNum *	dstErrNum
	)

Creates a grey value work space from the given object. The resulting grey value work space should be freed using WlzGreyValueFreeWSp().

Returns: Grey value work space or NULL on error.

Parameters

obj	Given object.
dstErrNum	Destination error pointer, may be NULL.

Referenced by Wlz3DViewTransformObj(), WlzAffineTransformGMShell(), WlzCCorS2D(), WlzClassValCon4(), WlzCMeshFromBalLBTDom2D(), WlzCMeshFromBalLBTDom3D(), WlzCMeshIntersectDom2D5(), WlzCMeshSetDispFromField(), WlzCMeshStrainTensorAtPts(), WlzCMeshToDomObjValues(), WlzCMeshTransformManyObjAsIdx(), WlzCMeshValueTransfer(), WlzCompoundToRGBA(), WlzConComThreshold(), WlzCopyObjectGreyValues(), WlzDGTensorPDFeature(), WlzDGTensorSDFeature(), WlzDomainFill3D(), WlzFilterNObjValues(), WlzGetMaskedSectionFromObject(), WlzGetProjectionFromObject(), WlzGreyValueMixing_s(), WlzIntRescaleObj(), WlzLBTBalanceDomain2D(), WlzLBTBalanceDomain3D(), WlzLBTIndexObjSetAllNodes2D(), WlzLBTIndexObjSetAllNodes3D(), WlzLBTMakeNodeIndexObj2D(), WlzLBTMakeNodeIndexObj3D(), WlzPointsFromDomObj(), WlzPointValuesFromDomObj(), WlzPolarSample(), WlzProjectObjToPlane(), WlzRankFilter(), WlzSepFilter(), and WlzTransposeObj().

void WlzGreyValueFreeWSp ( WlzGreyValueWSpace * gVWSp )

Free's the given grey value work space created by WlzGreyValueMakeWSp().

Returns: void

Parameters

gVWSp Given grey value work space.

References AlcFree(), _WlzGreyValueWSpace::gTabTypes3D, _WlzGreyValueWSpace::invTrans, WLZ_DBG, WLZ_DBG_LVL_1, WLZ_DBG_LVL_FN, and WlzFreeAffineTransform().

Referenced by Wlz3DViewTransformObj(), WlzAffineTransformGMShell(), WlzCCorS2D(), WlzClassValCon4(), WlzCMeshFromBalLBTDom2D(), WlzCMeshFromBalLBTDom3D(), WlzCMeshSetDispFromField(), WlzCMeshStrainTensorAtPts(), WlzCMeshToDomObjValues(), WlzCMeshTransformManyObjAsIdx(), WlzCMeshValueTransfer(), WlzCompoundToRGBA(), WlzConComThreshold(), WlzCopyObjectGreyValues(), WlzDGTensorPDFeature(), WlzDGTensorSDFeature(), WlzDomainFill3D(), WlzFilterNObjValues(), WlzGetMaskedSectionFromObject(), WlzGreyValueMakeWSp(), WlzGreyValueMixing_s(), WlzIntRescaleObj(), WlzLBTBalanceDomain2D(), WlzLBTBalanceDomain3D(), WlzLBTIndexObjSetAllNodes2D(), WlzLBTIndexObjSetAllNodes3D(), WlzLBTMakeNodeIndexObj2D(), WlzLBTMakeNodeIndexObj3D(), WlzPointsFromDomObj(), WlzPointValuesFromDomObj(), WlzPolarSample(), WlzProjectObjToPlane(), WlzRankFilter(), WlzSepFilter(), and WlzTransposeObj().

void WlzGreyValueGet	(	WlzGreyValueWSpace *	gVWSp,
		double	plane,
		double	line,
		double	kol
	)

Gets a single grey value/pointer for the given point from the object with which the given work space was initialised. When the object has a non-scalar value table then only the first value will be returned, however when the value is not background all values can be accessed via the grey pointer.

Returns: void

Parameters

gVWSp	Grey value work space.
plane	Plane (z) coordinate of point.
line	Line (y) coordinate of point.
kol	Column (x) coordinate of point.

References _WlzGreyValueWSpace::gTabType, _WlzGreyValueWSpace::invTrans, _WlzGreyValueWSpace::objType, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_GREY_TAB_TILED, WLZ_NINT, WlzAffineTransformVertexD2(), and WlzAffineTransformVertexD3().

Referenced by Wlz3DViewTransformObj(), WlzAffineTransformGMShell(), WlzCCorS2D(), WlzClassValCon4(), WlzCMeshIntersectDom2D5(), WlzCMeshSetDispFromField(), WlzCMeshStrainTensorAtPts(), WlzCMeshToDomObjValues(), WlzCMeshTransformManyObjAsIdx(), WlzCMeshValueTransfer(), WlzCompoundToRGBA(), WlzConComThreshold(), WlzCopyObjectGreyValues(), WlzDGTensorPDFeature(), WlzDomainFill3D(), WlzFilterNObjValues(), WlzGetMaskedSectionFromObject(), WlzGetProjectionFromObject(), WlzGreyValueGetD(), WlzGreyValueGetDir(), WlzGreyValueGetI(), WlzIntRescaleObj(), WlzLBTClassifyNode2D(), WlzLBTClassifyNodeFace3D(), WlzLBTCountNodNbrDir2D(), WlzPointsFromDomObj(), WlzPointValuesFromDomObj(), WlzPolarSample(), WlzProjectObjToPlane(), WlzRankFilter(), WlzSepFilter(), and WlzTransposeObj().

void WlzGreyValueGetCon	(	WlzGreyValueWSpace *	gVWSp,
		double	plane,
		double	line,
		double	kol
	)

Gets the four/eight connected grey values/pointers for the given point which lie at:

Returns: void

                  (p, k, l),          (p, k + 1, l),
                  (p, k, l + 1),      (p, k + 1, l + 1),
                  (p + 1, k, l),      (p + 1, k + 1, l),
                  (p + 1, k, l + 1),  (p + 1, k + 1, l + 1).
*

When the object has a non-scalar value table then only the first value will be returned, however when the value is not background all values can be accessed via the grey pointer.

Parameters

gVWSp	Grey value work space.
plane	Plane (z) coordinate of point.
line	Line (y) coordinate of point.
kol	Column (x) coordinate of point.

References _WlzGreyValueWSpace::gTabType, _WlzGreyValueWSpace::invTrans, _WlzGreyValueWSpace::objType, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, and WLZ_GREY_TAB_TILED.

Referenced by WlzAffineTransformGMShell(), WlzClassValCon4(), WlzCMeshSetDispFromField(), WlzCMeshToDomObjValues(), WlzCMeshTransformManyObjAsIdx(), WlzCMeshValueTransfer(), and WlzGetMaskedSectionFromObject().

WlzGreyType WlzGreyValueGetGreyType	(	WlzGreyValueWSpace *	gVWSp,
		WlzErrorNum *	dstErr
	)

Access function to get the object's grey type.

Returns: The workspace's object's grey type.

Parameters

gVWSp	Grey value work space.
dstErr	Destination error pointer, may be NULL.

References _WlzGreyValueWSpace::gType, WLZ_ERR_NONE, WLZ_ERR_PARAM_NULL, and WLZ_GREY_ERROR.

int WlzGreyValueGetI	(	WlzGreyValueWSpace *	gVWSp,
		double	plane,
		double	line,
		double	kol
	)

Gets a single grey value for the given point from the object with which the given work space was initialised.

Returns: The grey value as an int.

Parameters

gVWSp	Grey value work space.
plane	Plane (z) coordinate of point.
line	Line (y) coordinate of point.
kol	Column (x) coordinate of point.

References _WlzGreyV::dbv, _WlzGreyV::flv, _WlzGreyValueWSpace::gType, _WlzGreyValueWSpace::gVal, _WlzGreyV::inv, _WlzGreyV::lnv, _WlzGreyV::rgbv, _WlzGreyV::shv, _WlzGreyV::ubv, WLZ_CLAMP, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_LONG, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_NINT, and WlzGreyValueGet().

double WlzGreyValueGetD	(	WlzGreyValueWSpace *	gVWSp,
		double	plane,
		double	line,
		double	kol
	)

Gets a single grey value for the given point from the object with which the given work space was initialised.

Returns: The grey value as a double.

Parameters

gVWSp	Grey value work space.
plane	Plane (z) coordinate of point.
line	Line (y) coordinate of point.
kol	Column (x) coordinate of point.

References _WlzGreyV::dbv, _WlzGreyV::flv, _WlzGreyValueWSpace::gType, _WlzGreyValueWSpace::gVal, _WlzGreyV::inv, _WlzGreyV::lnv, _WlzGreyV::rgbv, _WlzGreyV::shv, _WlzGreyV::ubv, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_LONG, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, and WlzGreyValueGet().

int WlzInsideDomain2D	(	WlzIntervalDomain *	iDom,
		int	line,
		int	kol,
		WlzErrorNum *	dstErr
	)

Looks to see if the given point is within the given interval domain.

Returns: Non zero if point is inside.

Parameters

iDom	Given interval domain.
line	Line (y) position.
kol	Column (x) position.
dstErr	Destination error pointer, may be NOT NULL.

References _WlzIntervalDomain::intvlines, _WlzIntervalLine::intvs, _WlzIntervalDomain::kol1, _WlzIntervalDomain::line1, _WlzIntervalLine::nintvs, _WlzIntervalDomain::type, WLZ_ERR_DOMAIN_TYPE, WLZ_INTERVALDOMAIN_INTVL, and WLZ_INTERVALDOMAIN_RECT.

Referenced by WlzDomainFill3D(), WlzDomainNearby(), WlzInsideDomain(), WlzInsideDomain3D(), and WlzLBTKeyToBox2I().

int WlzInsideDomain3D	(	WlzPlaneDomain *	pDom,
		int	plane,
		int	line,
		int	kol,
		WlzErrorNum *	dstErr
	)

Looks to see if the given point is within the given 3D domain.

Returns: Non zero if point is inside.

Parameters

pDom	Given plane domain.
plane	Plane (z) position.
line	Line (y) position.
kol	Column (x) position.
dstErr	Destination error pointer, may be NOT NULL.

References _WlzPlaneDomain::domains, _WlzDomain::i, _WlzPlaneDomain::plane1, and WlzInsideDomain2D().

Referenced by WlzDomainNearby(), WlzGMModelCutDom(), WlzInsideDomain(), and WlzLBTKeyToBox2I().

int WlzInsideDomain	(	WlzObject *	obj,
		double	plane,
		double	line,
		double	kol,
		WlzErrorNum *	dstErr
	)

Looks to see if the given point is within the objects domain.

Returns: Non zero if point is inside.

Parameters

obj	Given object.
plane	Plane (z) position, only used if the object has a 3D domain.
line	Line (y) position.
kol	Column (x) position.
dstErr	Destination error pointer, may be NULL.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzDomain::i, _WlzValues::obj, _WlzDomain::p, _WlzDomain::t, _WlzObject::type, _WlzCoreDomain::type, _WlzObject::values, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_DBG, WLZ_DBG_LVL_1, WLZ_DBG_LVL_FN, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PLANEDOMAIN_TYPE, WLZ_ERR_TRANSFORM_TYPE, WLZ_ERR_VALUES_NULL, WLZ_NINT, WLZ_PLANEDOMAIN_DOMAIN, WLZ_TRANS_OBJ, WlzAffineTransformDimension(), WlzAffineTransformInverse(), WlzAffineTransformVertexD2(), WlzAffineTransformVertexD3(), WlzFreeAffineTransform(), WlzInsideDomain2D(), and WlzInsideDomain3D().

Referenced by Wlz2DContains(), WlzAffineTransformGMShell(), WlzCMeshBoundConform2D(), WlzCMeshBoundConform3D(), WlzCMeshIntersectDom2D5(), WlzCMeshTransformManyObjAsIdx(), WlzConComThreshold(), WlzFilterNObjValues(), WlzGeomObjLineSegIntersect2D(), WlzGeomObjLineSegIntersect3D(), WlzGetMaskedSectionFromObject(), WlzGetProjectionFromObject(), WlzLBTDomain2DFromIDomain(), WlzLBTDomain3DFromPDomain(), and WlzPointsDither().

Files

Data Structures

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

Function Documentation