QgarLib API: qgar::Component Class Reference

  +---+---+---+
  |   | 1 | 2 |
  +---+---+---+
  | 7 | *-->3 |
  +---+---+---+
  | 6 | 5 | 4 |
  +---+---+---+

The outside of the component is always on the left when moving along the contour direction. The figure above gives an example: when following a contour in the EAST direction, the first new possible contour point (1) is at NORTH of the current point (*), the second (2) at NORTH-EAST, and so on.

             new contour directions (see table _s_new_dir)
             W   NW  N   NE  E   SE  S   SW  W   NW  N   NE  E   SE
 
  indexes    0   1   2   3   4   5   6   7   8   9   10  11  12  13
           +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
_s_incr_x  | -1| -1| 0 | 1 | 1 | 1 | 0 | -1| -1| -1| 0 | 1 | 1 | 1 |
           +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
           +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
_s_incr_y  | 0 | -1| -1| -1| 0 | 1 | 1 | 1 | 0 | -1| -1| -1| 0 | 1 |
           +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             N   NE  E   SE  S   SW  W   NW
             entries corresponding to current contour directions

The _s_incr_x (resp. y) table (see figure above) contains the X (resp. Y) increment to get the X (resp. Y) coordinates of the 7 possible next contour points (points 1 to 7 on 1st figure) from the X (resp. Y) coordinate of the current point (*). The current contour direction (EAST on 1st figure) determines the first index to enter the tables.

             new contour directions
             W   NW  N   NE  E   SE  S   SW  W   NW  N   NE  E   SE
           +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
_s_new_dir | 6 | 7 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 0 | 1 | 2 | 3 |
           +---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Once a new contour point is found, table _s_new_dir gives the corresponding new contour direction, using the index corresponding to the new contour point in table _s_incr_x or _s_incr_y.


Labels
label_type	label () const
	Get component label.
label_type	inLabel () const
	Get label of comprising component.
static const label_type	_MAX_LABEL = std::numeric_limits<Component::label_type>::max()
	Maximum label.
static const label_type	_NO_LABEL = -1
	Label to express that an object is not yet labelled.
Public Types
Types related to a component
typedef short	label_type
	Type of a component label.
Public Member Functions
Constructors
	Component ()
	Default constructor.
	Component (GenImage< label_type > *aPCompImg, int aLabel, int anInLabel, QGEbw aBW, int aXTopLeftPix, int aYTopLeftPix, int aXTopLeft, int aYTopLeft, int aXBottomRight, int aYBottomRight, int anAreaPixels)
	Create from full data.
	Component (const Component &aCComp)
	Copy constructor.
Destructor
virtual	~Component ()
	Virtual destructor.
Color
QGEbw	color () const
	Get color.
Coordinates
int	xTopLeftPix () const
	Get X coordinate of the top left pixel of the component.
int	yTopLeftPix () const
	Get Y coordinate of the top left pixel of the component.
const BoundingBox &	accessBoundingBox () const
	Get bounding box.
BoundingBox	boundingBox () const
	Get a copy of the bounding box.
double	densityBox () const
	Get density with regard to the bounding box.
Area
int	areaPixels () const
	Get component area (in pixels).
Access to the MAER (Minimum-Area Encasing Rectangle)
const Maer &	accessMaer ()
	Get the MAER.
Maer	maer ()
	Get a copy of the MAER.
int	maerAreaPixels ()
	Get MAER area in pixels.
double	densityMaer ()
	Get density with regard to the MAER.
Contour
const std::list< DPoint > &	accessContour ()
	Get a pointer to the component contour.
std::list< DPoint >	contour ()
	Get a copy of the component contour.
Operators
Component &	operator= (const Component &aCComp)
	Assignment.
Protected Attributes
Pixel map of the corresponding component image
GenImage< label_type > *	_pCompImg
	Pointer to the corresponding component image.
Labels
label_type	_label
	Label of the component.
label_type	_inLabel
	Label of the comprising component.
Color
QGEbw	_color
	Color.
Coordinates
int	_xTopLeftPix
	X coordinate of the top left pixel of the component.
int	_yTopLeftPix
	Y coordinate of the top left pixel of the component.
BoundingBox	_boundingBox
	Bounding box.
Area
int	_areaPixels
	Component effective area (in pixels).
MAER (Minimum-Area Encasing Rectangle)
Maer *	_maer
	Minimum-Area Enclosing Rectangle (MAER).
int	_maerAreaPixels
	Minimum-Area Enclosing Rectangle (MAER).
Contour
std::list< DPoint >	_contour
	List of the points of the contour component.
Private Member Functions
Auxiliary functions
void	PRIVATEcomputeContour ()
	Compute the external contour (hull) of the component.
void	PRIVATEcomputeMaer ()
	Compute the MAER (Minimum-Area Encasing Rectangle).
Static Private Attributes
Tables to compute coordinates during contour following
+---+---+---+ \| \| 1 \| 2 \| +---+---+---+ \| 7 \| -->3 \| +---+---+---+ \| 6 \| 5 \| 4 \| +---+---+---+ The outside of the component is always on the left when moving along the contour direction. The figure above gives an example: when following a contour in the EAST direction, the first new possible contour point (1) is at NORTH of the current point (), the second (2) at NORTH-EAST, and so on. new contour directions (see table _s_new_dir) W NW N NE E SE S SW W NW N NE E SE indexes 0 1 2 3 4 5 6 7 8 9 10 11 12 13 +---+---+---+---+---+---+---+---+---+---+---+---+---+---+ _s_incr_x \| -1\| -1\| 0 \| 1 \| 1 \| 1 \| 0 \| -1\| -1\| -1\| 0 \| 1 \| 1 \| 1 \| +---+---+---+---+---+---+---+---+---+---+---+---+---+---+ +---+---+---+---+---+---+---+---+---+---+---+---+---+---+ _s_incr_y \| 0 \| -1\| -1\| -1\| 0 \| 1 \| 1 \| 1 \| 0 \| -1\| -1\| -1\| 0 \| 1 \| +---+---+---+---+---+---+---+---+---+---+---+---+---+---+ N NE E SE S SW W NW entries corresponding to current contour directions The _s_incr_x (resp. y) table (see figure above) contains the X (resp. Y) increment to get the X (resp. Y) coordinates of the 7 possible next contour points (points 1 to 7 on 1st figure) from the X (resp. Y) coordinate of the current point (*). The current contour direction (EAST on 1st figure) determines the first index to enter the tables. new contour directions W NW N NE E SE S SW W NW N NE E SE +---+---+---+---+---+---+---+---+---+---+---+---+---+---+ _s_new_dir \| 6 \| 7 \| 0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7 \| 0 \| 1 \| 2 \| 3 \| +---+---+---+---+---+---+---+---+---+---+---+---+---+---+ Once a new contour point is found, table _s_new_dir gives the corresponding new contour direction, using the index corresponding to the new contour point in table _s_incr_x or _s_incr_y.
static const int	_s_incr_x [14]
	Table for X coordinates increments.
static const int	_s_incr_y [14]
	Table for Y coordinates increments.
static const int	_s_new_dir [14]
	Table for new contour directions.

qgar::Component Class Reference
[Connected components]

Detailed Description

Labels

Public Types

Public Member Functions

Protected Attributes

Private Member Functions

Static Private Attributes

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

qgar::Component Class Reference [Connected components]