 |
Image Component Library (ICL)
|
|
Image Component Library (ICL)
|
Utility class for markers of type "icl1". More...
#include <MarkerCodeICL1.h>
Public Member Functions | |
| MarkerCodeICL1 () | |
| create instance with optionally given root color | |
| MarkerCodeICL1 (int id) | |
| create instance from given ID | |
| MarkerCodeICL1 (const int ns[4], bool rootRegionColorIsBlack=true) | |
| create instance from given set of child-child regions counts | |
| int & | operator[] (int idx) |
| get child-child region count of child-region idx | |
| int | operator[] (int idx) const |
| get child-child region count of child-region idx (const) | |
| bool | operator< (const MarkerCodeICL1 &t) const |
| compares the internal id | |
| int | operator- (const MarkerCodeICL1 &p) const |
| computes the hamming distance of two codes | |
Static Public Member Functions | |
| static const std::vector < MarkerCodeICL1 > & | generate () |
| generates a set of 60 instances that have minimum hamming distance of 2 | |
Public Attributes | |
| int | id |
| computed or given marker ID | |
| int | n [4] |
| computed or given set of child-child-regions | |
Static Public Attributes | |
| static const int | P = 5 |
| maximum amount of child-child-regions | |
| static const int | P1 = P+1 |
| related to maximum child-child-region count base for ID computation | |
Utility class for markers of type "icl1".
"icl1" markers have 4 section each containing 1 to 5 child-regions. Therefore, each marker is completely defined by the numbers 
of child regions. In order to avoid disambiguities, the sub-region counts are sorted in ascending order (e.g. 
. To avoid the degenerate case, that all become equal, an extra rule 
is evaluated. A list of all valid codes (60) is generated by the static MarkerCodeICL1::genrate function.
The extra property rootColor can be used to store the information about the root regions color. This can be used to create an extra set of makers of identical type (one with root color 0, and one with root color 255).
The marker ID is directly computed from the set of the . Since the maximum number of child child regions is 5, the base for ID computation is 6. We use negative marker ID's to indicate, that the marker structure is inverse: i.e. the markers root region is white
![\[ id(n_1,n_2,n_3,n_4) = (+1 or -1)(n_1 + 6 n_2 + 36 n_3 + 216 n_4) \]](form_207.png)
The inverse calculation is implemented iteratively (note: the operator "/" uses integer division here)
![\[ compute\_ni(id) = \]](form_208.png)
![\[ id = abs(id) \]](form_209.png)
![\[ n_4 = min(5,id/216) \]](form_210.png)
![\[ id -= n_4*216 \]](form_211.png)
![\[ n_3 = min(5,id/36) \]](form_212.png)
![\[ id -= n_3*36; \]](form_213.png)
![\[ n_2 = min(5,id/6) \]](form_214.png)
![\[ id -= n_2*6 \]](form_215.png)
![\[ n_1 = id; \]](form_216.png)
create instance with optionally given root color
create instance from given ID
| icl::markers::MarkerCodeICL1::MarkerCodeICL1 | ( | const int | ns[4], |
| bool | rootRegionColorIsBlack = true |
||
| ) |
create instance from given set of child-child regions counts
| static const std::vector<MarkerCodeICL1>& icl::markers::MarkerCodeICL1::generate | ( | ) | [static] |
generates a set of 60 instances that have minimum hamming distance of 2
| int icl::markers::MarkerCodeICL1::operator- | ( | const MarkerCodeICL1 & | p | ) | const |
computes the hamming distance of two codes
Note if you only use the codes that are returned by the generate-function, the minimal hamming distance between any two markers is 2
| bool icl::markers::MarkerCodeICL1::operator< | ( | const MarkerCodeICL1 & | t | ) | const [inline] |
compares the internal id
| int& icl::markers::MarkerCodeICL1::operator[] | ( | int | idx | ) | [inline] |
get child-child region count of child-region idx
| int icl::markers::MarkerCodeICL1::operator[] | ( | int | idx | ) | const [inline] |
get child-child region count of child-region idx (const)
computed or given marker ID
computed or given set of child-child-regions
const int icl::markers::MarkerCodeICL1::P = 5 [static] |
maximum amount of child-child-regions
const int icl::markers::MarkerCodeICL1::P1 = P+1 [static] |
related to maximum child-child-region count base for ID computation
1.7.6.1
