Transform2DComposed Canonize Method Cognex VisionPro 9.20

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.Vision
Assembly: Cognex.Vision.Core.Net (in Cognex.Vision.Core.Net.dll) Version: 9.10.0.0
Syntax

public ITransform2D Canonize(
	bool typeSimplify
)

Parameters

typeSimplify
Type: System Boolean
Specify False to force this function to return a transformation of type Transform2DComposed. If you specify True, then the returned transformation may be of a simpler type.

Return Value

Type: ITransform2D
Remarks

This is the mathematically equivalent form that has the fewest number of transforms. Canonization may include each of the following operations:

  • If this Transform2DComposed contains other Transform2DComposed 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 Transform2DLinear 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 Transform2DLinear ). You can prevent this conversion by specifying False for the typeSimplify argument.

See Also