Object implementing the non linear polynomially approximated transform implemented in the CVB Foundation Package.
More...
|
static NonLinearTransformation | FromCalibrationPattern (ImagePlane plane, CalibrationPatternStyle style, CalibrationPatternContrast contrast, int gridSpacing, int minContrast, double maxRatio, int order, out double quality) |
| Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
|
|
static NonLinearTransformation | FromCalibrationPattern (ImagePlane plane, Area2D aoi, CalibrationPatternStyle style, CalibrationPatternContrast contrast, int gridSpacing, int minContrast, double maxRatio, int order, out double quality) |
| Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
|
|
static NonLinearTransformation | FromCalibrationPattern (ImagePlane plane, CalibrationPatternStyle style, CalibrationPatternContrast contrast, int gridSpacing, int minContrast, double maxRatio, int order, CreationProgress progressDelegate, out double quality) |
| Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
|
|
static NonLinearTransformation | FromCalibrationPattern (ImagePlane plane, Area2D aoi, CalibrationPatternStyle style, CalibrationPatternContrast contrast, int gridSpacing, int minContrast, double maxRatio, int order, CreationProgress progressDelegate, out double quality) |
| Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
|
|
static NonLinearTransformation | FromPositionLists< T > (ICollection< T > originalPixels, ICollection< T > transformedPixels, int order, out double quality) |
| Create a non linear transformation that - approximately - matches the set of originalPixels to the set of transformedPixels .
|
|
static NonLinearTransformation | FromPositionLists< T > (ICollection< T > originalPixels, ICollection< T > transformedPixels, int order, CreationProgress progressDelegate, out double quality) |
| Create a non linear transformation that - approximately - matches the set of originalPixels to the set of transformedPixels .
|
|
|
IntPtr | Handle [get] |
| Native non linear transformation handle.
|
|
bool | IsDisposed [get] |
| Tests if the native handle has already been disposed.
|
|
int | Order [get] |
| Transformation order.
|
|
ReadOnlyCollection< double > | CoefficientsX [get] |
| Return a read only array of the coefficients used for the transformation of x-coordinates.
|
|
ReadOnlyCollection< double > | CoefficientsY [get] |
| Return a read only array of the coefficients used for the transformation of y-coordinates.
|
|
ReadOnlyCollection< double > | CoefficientsXInverse [get] |
| Return a read only array of the coefficients used for the inverse transformation of x-coordinates.
|
|
ReadOnlyCollection< double > | CoefficientsYInverse [get] |
| Return a read only array of the coefficients used for the inverse transformation of y-coordinates.
|
|
Object implementing the non linear polynomially approximated transform implemented in the CVB Foundation Package.
Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
The image plane given to this method needs to contain a calibration pattern as generated by the method CalibrationPattern.Create(CalibrationPatternStyle, CalibrationPatternContrast, int, int, int, int): A regularly spaced matrix of dots, the distance between the dots in x- and y-direction should be 2.5 times the diameter of the dots, if an asymmetric pattern was used, the bigger dots should have 2.5 times the area of the smaller dots (meaning that their radius is sqrt(2.5) times the radius of the small dots).
Note that, although the area of interest is given as a Area2D here (and in the processing of the Area2D
the image's coordinate system will be respected), the actual output of this method uses CoordinateSystemType.PixelCoordinates! This seemingly inconsistent mix in this case is in fact useful, because a Area2D
will better capture the actual location of a calibration pattern, especially if the image has been rotated, than a Rect style area of interest. But the calibration functions working on the output of ExtractCalibrationLists
usually assume that the pixel lists are given in pixel coordinates.
To avoid misunderstandings and complications in the interpretation of the image content, it is recommended to use a default coordinate system on the input image.
- Parameters
-
plane | Image plane to work on. |
aoi | Area of interest in which to look for the calibration pattern's dots. |
style | Calibration pattern style visible in the image. (see CalibrationPatternStyle) |
contrast | Selects whether the image shows CalibrationPatternContrast.BlackOnWhite or CalibrationPatternContrast.WhiteOnBlack dots. |
gridSpacing | Spacing of the calibration dot grid in the target image.Defines the distance of the points that will end up in the transformed pixels. |
minContrast | Minimum gray value contrast between the object and the background of the calibration target pattern. Value to be set depends on the quality of the image taken from the pattern, but in a typical situation this contrast should not drop below 64 gray values, otherwise it might become difficult to extract the calibration points. |
maxRatio | Maximum ratio between the biggest and the smallest calibration dot.This value will be used to identify outliers when looking for calibration dots. It should be set high enough to allow for the area variations to be expected due to perspective distortions and small enough to eliminate the candidates that are either too big or too small to be valid calibration pattern dots. Typically, values of about 3.0 to 5.0 are big enough - even if there is notable perspective distortion visible in the images. If an asymmetric calibration pattern has been selected, the ratio used for calculation will be adapted accordingly. |
order | Polynomial order of the transformation to be generated. |
progressDelegate | delegate to be used for passing progress information back to the caller |
quality | Quality feedback.Derived by correlating the application of the resulting transformation to the set of the calibration pattern. |
- Returns
- Newly created calibration object.
Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
The image plane given to this method needs to contain a calibration pattern as generated by the method CalibrationPattern.Create(CalibrationPatternStyle, CalibrationPatternContrast, int, int, int, int): A regularly spaced matrix of dots, the distance between the dots in x- and y-direction should be 2.5 times the diameter of the dots, if an asymmetric pattern was used, the bigger dots should have 2.5 times the area of the smaller dots (meaning that their radius is sqrt(2.5) times the radius of the small dots).
Note that, although the area of interest is given as a Area2D here (and in the processing of the Area2D
the image's coordinate system will be respected), the actual output of this method uses CoordinateSystemType.PixelCoordinates! This seemingly inconsistent mix in this case is in fact useful, because a Area2D
will better capture the actual location of a calibration pattern, especially if the image has been rotated, than a Rect style area of interest. But the calibration functions working on the output of ExtractCalibrationLists
usually assume that the pixel lists are given in pixel coordinates.
To avoid misunderstandings and complications in the interpretation of the image content, it is recommended to use a default coordinate system on the input image.
- Parameters
-
plane | Image plane to work on. |
aoi | Area of interest in which to look for the calibration pattern's dots. |
style | Calibration pattern style visible in the image. (see CalibrationPatternStyle) |
contrast | Selects whether the image shows CalibrationPatternContrast.BlackOnWhite or CalibrationPatternContrast.WhiteOnBlack dots. |
gridSpacing | Spacing of the calibration dot grid in the target image.Defines the distance of the points that will end up in the transformed pixels. |
minContrast | Minimum gray value contrast between the object and the background of the calibration target pattern. Value to be set depends on the quality of the image taken from the pattern, but in a typical situation this contrast should not drop below 64 gray values, otherwise it might become difficult to extract the calibration points. |
maxRatio | Maximum ratio between the biggest and the smallest calibration dot.This value will be used to identify outliers when looking for calibration dots. It should be set high enough to allow for the area variations to be expected due to perspective distortions and small enough to eliminate the candidates that are either too big or too small to be valid calibration pattern dots. Typically, values of about 3.0 to 5.0 are big enough - even if there is notable perspective distortion visible in the images. If an asymmetric calibration pattern has been selected, the ratio used for calculation will be adapted accordingly. |
order | Polynomial order of the transformation to be generated. |
quality | Quality feedback.Derived by correlating the application of the resulting transformation to the set of the calibration pattern. |
- Returns
- Newly created calibration object.
Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
The image plane given to this method needs to contain a calibration pattern as generated by the method CalibrationPattern.Create(CalibrationPatternStyle, CalibrationPatternContrast, int, int, int, int): A regularly spaced matrix of dots, the distance between the dots in x- and y-direction should be 2.5 times the diameter of the dots, if an asymmetric pattern was used, the bigger dots should have 2.5 times the area of the smaller dots (meaning that their radius is sqrt(2.5) times the radius of the small dots).
Note that, although the area of interest is given as a Area2D here (and in the processing of the Area2D
the image's coordinate system will be respected), the actual output of this method uses CoordinateSystemType.PixelCoordinates! This seemingly inconsistent mix in this case is in fact useful, because a Area2D
will better capture the actual location of a calibration pattern, especially if the image has been rotated, than a Rect style area of interest. But the calibration functions working on the output of ExtractCalibrationLists
usually assume that the pixel lists are given in pixel coordinates.
To avoid misunderstandings and complications in the interpretation of the image content, it is recommended to use a default coordinate system on the input image.
- Parameters
-
plane | Image plane to work on. |
style | Calibration pattern style visible in the image. (see CalibrationPatternStyle) |
contrast | Selects whether the image shows CalibrationPatternContrast.BlackOnWhite or CalibrationPatternContrast.WhiteOnBlack dots. |
gridSpacing | Spacing of the calibration dot grid in the target image.Defines the distance of the points that will end up in the transformed pixels. |
minContrast | Minimum gray value contrast between the object and the background of the calibration target pattern. Value to be set depends on the quality of the image taken from the pattern, but in a typical situation this contrast should not drop below 64 gray values, otherwise it might become difficult to extract the calibration points. |
maxRatio | Maximum ratio between the biggest and the smallest calibration dot.This value will be used to identify outliers when looking for calibration dots. It should be set high enough to allow for the area variations to be expected due to perspective distortions and small enough to eliminate the candidates that are either too big or too small to be valid calibration pattern dots. Typically, values of about 3.0 to 5.0 are big enough - even if there is notable perspective distortion visible in the images. If an asymmetric calibration pattern has been selected, the ratio used for calculation will be adapted accordingly. |
order | Polynomial order of the transformation to be generated. |
progressDelegate | delegate to be used for passing progress information back to the caller |
quality | Quality feedback.Derived by correlating the application of the resulting transformation to the set of the calibration pattern. |
- Returns
- Newly created calibration object.
Create a new transformation object by automatically extracting the pixel lists required for creating a NonLinearTransformation object.
The image plane given to this method needs to contain a calibration pattern as generated by the method CalibrationPattern.Create(CalibrationPatternStyle, CalibrationPatternContrast, int, int, int, int): A regularly spaced matrix of dots, the distance between the dots in x- and y-direction should be 2.5 times the diameter of the dots, if an asymmetric pattern was used, the bigger dots should have 2.5 times the area of the smaller dots (meaning that their radius is sqrt(2.5) times the radius of the small dots).
To avoid misunderstandings and complications in the interpretation of the image content, it is recommended to use a default coordinate system on the input image.
- Parameters
-
plane | Image plane to work on. |
style | Calibration pattern style visible in the image. (see CalibrationPatternStyle) |
contrast | Selects whether the image shows CalibrationPatternContrast.BlackOnWhite or CalibrationPatternContrast.WhiteOnBlack dots. |
gridSpacing | Spacing of the calibration dot grid in the target image.Defines the distance of the points that will end up in the transformed pixels. |
minContrast | Minimum gray value contrast between the object and the background of the calibration target pattern. Value to be set depends on the quality of the image taken from the pattern, but in a typical situation this contrast should not drop below 64 gray values, otherwise it might become difficult to extract the calibration points. |
maxRatio | Maximum ratio between the biggest and the smallest calibration dot.This value will be used to identify outliers when looking for calibration dots. It should be set high enough to allow for the area variations to be expected due to perspective distortions and small enough to eliminate the candidates that are either too big or too small to be valid calibration pattern dots. Typically, values of about 3.0 to 5.0 are big enough - even if there is notable perspective distortion visible in the images. If an asymmetric calibration pattern has been selected, the ratio used for calculation will be adapted accordingly. |
order | Polynomial order of the transformation to be generated. |
quality | Quality feedback.Derived by correlating the application of the resulting transformation to the set of the calibration pattern. |
- Returns
- Newly created calibration object.