Back to Adaptive Vision Library website
You are here: Start » Function Reference » Region Spatial Transforms » AlignRegion
![](../../img/icon/TransformRegion.png)
AlignRegion
Aligns a region to a coordinate system.
Syntax
C++
C#
void avl::AlignRegion ( const avl::Region& inRegion, const avl::CoordinateSystem2D& inAlignment, bool inInverse, atl::Optional<int> inFrameWidth, atl::Optional<int> inFrameHeight, avl::Region& outAlignedRegion )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() |
inRegion | const Region& | Input region | ||
![]() |
inAlignment | const CoordinateSystem2D& | Coordinate system to align to | ||
![]() |
inInverse | bool | Switches to the inverse transform | ||
![]() |
inFrameWidth | Optional<int> | 0 - ![]() |
NIL | Output region's frame width |
![]() |
inFrameHeight | Optional<int> | 0 - ![]() |
NIL | Output region's frame height |
![]() |
outAlignedRegion | Region& |
Description
AlignRegion applies inAlignment transform to an input region.
Examples
![]() |
![]() |
AlignRegion performed on the sample region, inAlignment.Origin = (280, -120), inAlignment.Angle = 45, inAlignment.Scale = 1.0 and inInverse = False. The inAlignment.Origin is drawn on the first image in blue.
Remarks
Region is a pixel-precise object, so geometrical transform may cause its deformation. Consider using a closed Path instead, which can be converted to a region in the last step.
In-place Processing
This function supports in-place data processing - you can pass the same reference to inRegion and outAlignedRegion