Returns the canonical form of this composed transform. This is the mathematically equivalent form that has the fewest number of transforms. If TypeSimplify is True, the returned type may be reduced to a type simpler than this.
Namespace: Cognex.VisionProAssembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 73.0.0.0
Syntax
Parameters
- typeSimplify
- Type: System Boolean
Specify False to force this function to return a transformation of type CogTransform2DComposed. If you specify True, then the returned transformation may be of a simpler type.
Return Value
Type: ICogTransform2DThe returned canonical transformation.
Events
| Event Type | Reason |
|---|---|
| CogTransform2DComposed Changed | Fires when the transformation is canonized. The following state flags may be affected: |
Remarks
Returns the canonical form of this composed transform. This is the mathematically equivalent form that has the fewest number of transforms.
Canonization may include each of the following operations:
If this CogTransform2DComposed contains other CogTransform2DComposed transformations (effectively a tree of transformations where the non-leaf nodes are composed transformations), the Canonical form will flatten this tree by arranging all the leaf nodes linearly within the canonical form of the composed transformation. Any adjacent transformations that are mathematically composable (such as CogTransform2DLinear objects) are composed. If the effect of applying the preceding two operations is to produce a composed transformation that contains a single transformation, the Canonical form will be of that type (typically CogTransform2DLinear). You can prevent this conversion by specifying False for the typeSimplify argument.Note: This function returns a new transformation which is the canonical form of this object. It does not change the current object in any way.
See Also