TArea Struct Reference

Describes an area of interest that is using three points (**P0**, **P1** and **P2**).
More...

## Related Functions | |

(Note that these are not member functions.) | |

void | BoundingRectangle (TArea Area, TCoordinateMap CS, TDRect &BoundingBox) |

Calculates the smallest bounding rectangle for the given Area. More... | |

cvbbool_t | CoordinateMapInverseTransformArea (TArea AreaIn, TCoordinateMap CS, TArea &AreaOut) |

Transforms the AreaIn using the inverse of the coordinate system CS. More... | |

void | CoordinateMapTransformArea (TArea AreaIn, TCoordinateMap CS, TArea &AreaOut) |

Transforms the AreaIn using the given coordinate system CS. More... | |

void | MatrixTransformArea (TArea AreaIn, TMatrix A, TArea &AreaOut) |

Performs a matrix transformation on a given area. More... | |

void | SetArea (double X0, double Y0, double X1, double Y1, double X2, double Y2, TArea &Area) |

Sets the coordinates to the given Area. More... | |

void | SetRectArea (double Left, double Top, double Right, double Bottom, TArea &Area) |

Sets the Area points P0, P1, and P2 based on the given rectangle borders. More... | |

Describes an area of interest that is using three points (**P0**, **P1** and **P2**).

These three points define a parallelogram:

Normally the three points are given in image coordinates which are defined by the TCoordinateMap of the image (GetImageCoordinates). By default this is identical to the pixel coordinate system. Thus most of the functions using a TArea also take the image's coordinate system into account which means that the area is transformed accordingly prior the calculation of the actual pixel coordinates (see CoordinateMapInverseTransformArea).

As shown in the parallelogram image, the TArea defines a scanline which is a directed line segment:

This means functions using a TArea potentially treat pixels on this vector being in one line. Rows in the processing are defined by this directed line segment:

- Note
- The line segments [
**P0****P1**] and [**P0****P2**] are inclusive. This means that the points**P0**and**P1**are considered to be inside the area. Thus

- Attention
- Some tools swap the line segments for the scanline and rows and the scan line becomes:

- See also
- TCoordinateMap for information on the coordinate systems; TDRect