latest version v1.9 - last update 24 Nov 2005

lti::areaPoints Class Reference
[Aggregate Data Types, Shape Analysis]

Contour classes: Area-Points. More...

#include <ltiContour.h>

Inheritance diagram for lti::areaPoints:

[legend]Collaboration diagram for lti::areaPoints:

[legend]List of all members.

Public Member Functions
	areaPoints ()
	areaPoints (const areaPoints &other)
virtual	~areaPoints ()
const char *	getTypeName () const
areaPoints &	castFrom (const borderPoints &theBorderPoints)
areaPoints &	castFrom (const ioPoints &theIOPoints)
areaPoints &	castFrom (const polygonPoints &theIOPoints)
areaPoints &	operator= (const areaPoints &other)
bool	getFromMask (const channel8 &mask)
bool	generateMask (channel8 &mask, const bool computeBoundary=true, const bool exactBoundaryDimensions=false, const bool keepMaskData=false) const
void	sort ()
int	intersectionArea (const rectangle &rect) const

---

Detailed Description

Contour classes: Area-Points.

For the explanation of the contour description in this class, see following image:

   -- 00000000001111111111222222222233
   -- 01234567890123456789012345678901
   00 --------------------------------
   01 --------------------------------
   02 --------------------------------
   03 --------BBBB------BBBB----------
   04 -------B****BBB----B**B---------
   05 -------B*******B---B***B--------
   06 ------B*******B-----B*B---------
   07 -------B*******BBBBB**B---------
   08 ---------B*************B--------
   09 --------B**----*********B-------
   10 --------B**-----********B-------
   11 -------B**-----*******BB--------
   12 ------B**-----*******B----------
   13 ------B**-------******BB--------
   14 -----B**---------*******B-------
   15 -----B**--------*********B------
   16 ----B**-------**********BB------
   17 ---B***----*******----BB--------
   18 ----BBBBBBBBB***  --*B----------
   19 -------------BBBBBBBB-----------
   20 --------------------------------
   21 --------------------------------
   22 --------------------------------
   23 --------------------------------

  "-" means background and the rest is part of the object.
  "B" indicates a borderpoint.

This contour class allows three representations of a contour:

• IO-Points. It contains all input and output points for each line. For example, for the previous image: (8,3)(11,3)(18,3)(21,3)(7,4)(14,4)(19,4)(22,4)... Note that every IO-point is a border point, but not all border points are IO-points.
• Border Boints. It contains a list of the points at the border. Beginning with the point at (8,3) the chain code for our example image is: (8,3)(9,3)(10,3)(11,3)(12,4)(13,4)(14,4)(15,5)(14,6)...
• Area-Points. It contains all points in the object.

See also:

lti::ioPoints, lti::borderPoints

---

Constructor & Destructor Documentation

lti::areaPoints::areaPoints (   )

default constructor creates an empty area-point-list

lti::areaPoints::areaPoints (  const areaPoints &  other  )

create this pointList as a copy of another pointList Parameters: other  the pointList to be copied.

virtual lti::areaPoints::~areaPoints (   )  [virtual]

destructor

---

Member Function Documentation

areaPoints& lti::areaPoints::castFrom (  const polygonPoints &  theIOPoints  )

creates this io-list from the given io-point-list

areaPoints& lti::areaPoints::castFrom (  const ioPoints &  theIOPoints  )

creates this io-list from the given io-point-list

areaPoints& lti::areaPoints::castFrom (  const borderPoints &  theBorderPoints  )

creates this area-point-list from the given border-point-list

bool lti::areaPoints::generateMask (  channel8 &  mask, const bool  computeBoundary = true, const bool  exactBoundaryDimensions = false, const bool  keepMaskData = false )  const

generate mask from area-points. The dimensions of the resulting mask are the smallest rectangle to contain the point (0,0) (optional) and all points in this list, plus 1 pixel in both width and heigth. If the given mask is bigger than this size, its dimensions will be kept. If the boundary of the point list is not up to date, it can be calculated if specified in the parameters: Parameters: mask  The calculated mask will be stored here computeBoundary  If false, the internal boundary of the point list will be used, otherwise the boundary will be calculated (but NOT updated!!!). exactBoundaryDimensions  If true, the dimensions of the resulting mask will be the smallest rectangle to contain only the points in this list. The origin (0,0) may not be included, therefore a 1:1 correspondence of coordinates will generally not be given. keepMaskData  if false, the mask will be initialized with zero before getting the area mask. If true, the previous mask data is not deleted, but the mask will be resized if necessary. Returns: true if successful, false otherwise.

bool lti::areaPoints::getFromMask (  const channel8 &  mask  )

generate a area-point-list from the given mask image. This function assumes that the mask contains JUST ONE connected object. To get the biggest object on the mask see the lti::objectsFromMask functor.

const char* lti::areaPoints::getTypeName (  void   )  const [inline, virtual]

returns the name of this class: "areaPoints" Reimplemented from lti::tpointList< T >.

int lti::areaPoints::intersectionArea (  const rectangle &  rect  )  const

Compute intersection area with a rectangle.

areaPoints& lti::areaPoints::operator= (  const areaPoints &  other  )  [inline]

assigment operator (alias for copy(other)). Parameters: other  the pointList to be copied Returns: a reference to the actual pointList

void lti::areaPoints::sort (   )

sort the points of this in ascending order first of y, and than of x.

---

The documentation for this class was generated from the following file:

• ltiContour.h

---