Loads a VisionPro persistence (.vpp) file, which contains a set of saved properties for this vision tool object type. Loading a persistence file for another object type throws an error and the load is unsuccessful.

For more information about VisionPro persistence features, see the topic Persistence in VisionPro.

Resets the underlying tool to a default state.

This tool gives you a choice between resetting to the default-constructed state, which is appropriate when you are using it in a Visual Studio.NET application, and its template-initialized state, which is appropriate for QuickBuild applications.

Fixturing Method

Specifies the method used to perform the fixturing operation.

• Reference Fixturing indicates that you want to fixture using the reference fixturing method. This option sets the ReferenceImageEnabled property to True. If the tool's ReferenceImage property has a value and the CurrentRecord's CogFixtureNPointToNPointCurrentRecordConstants is set, the Current.ReferenceImage buffer displays the reference image.
• Geometric Fixturing indicates that you want to fixture using the geometric fixturing method.

Allows you to add, delete, or modify the x- and y-coordinates for the set of N points in unfixtured space and corresponding set of N points in raw fixtured space. In both reference fixturing and geometric fixturing, you typically obtain the coordinates for the set of unfixtured points by running a pattern-matching or feature-locating vision tool, such as CogPMAlignTool or CogBlobTool.

In reference fixturing, you obtain the unfixtured points by clicking the Grab reference image & points button. The N-point fixturing tool sets its reference image from the current input image, and also sets the raw fixtured points from the current unfixtured points defined by the reference image. You should not have to modify these values. In geometric fixturing, you get the coordinates of the raw fixtured points from a schematic (CAD) drawing or from measurements taken of the object being imaged. That is, these real-world values are already known; you simply enter them.

Note that the Point Pairs grid reflects the points available for the tool's next run. Using the Point Pairs grid is equivalent to the following tool methods:

• AddPointPair
• DeletePointPair
• SetUnfixturedPointX, SetUnfixturedPointY, SetRawFixturedPointX, SetRawFixturedPointY

Grab reference image & points

If you have chosen the Reference Fixturing option, this button sets the reference image from the current input image and sets the raw fixtured points from the current unfixtured points defined by the reference image. The Current.ReferenceImage can display the graphics that represent the raw fixtured points, in addition to the unfixtured and raw fixtured coordinate space axes.

At run-time, the fixturing tool extracts the physical object features (unfixtured points) from an input image that correspond to those specified by the raw fixtured points in the reference image, and then determines how these points have moved between images. It computes a final fixtured space that takes into account this movement.

Equivalent to setting the tool's ReferenceImage from the InputImage data; and the SetRawFixturedPoint from the current GetUnfixturedPoint.

Enable Origin Transform

Allows you to provide an optional 2D transformation that adjusts the final fixtured coordinate space relative to the raw fixtured space. Typically, you use the adjustment to set an origin for the fixture that is more convenient in your application. For example, suppose you have an image of a circuit board and want to place the final fixtured space in the center of the board, rather than at its corner. You can change the values of the translation, scaling, aspect, rotation, and skew components of the adjustment transform before run-time to achieve this centering.

Equivalent to setting the RawFixturedFromFixturedTransformEnabled property to true and altering the components of the transform given by the RawFixturedFromFixturedTransform property.

Note that you can specify the rotation and skew components in either degrees or radians, although the underlying tool maintains these values in radians.

Reference

You can display the following graphics on the reference image contained in the Current.ReferenceImage buffer:

• Show Raw Fixtured Axes displays noninteractive coordinate axes that represent the raw fixtured space. Equivalent to setting the CogFixtureNPointToNPointCurrentRecordConstants bit of the tool's CurrentRecord.
• Show Fixtured Axes displays interactive coordinate axes that represent the final fixtured space. If you move these axes, you change the component values of the origin adjustment transform, shown on the Settings tab. This option is enabled by default. Equivalent to setting the CogFixtureNPointToNPointLastRunRecordDiagConstants bit of the tool's CurrentRecord.
• Show Raw Fixtured Points displays interactive graphics that represent the raw fixtured points. This option is enabled by default. Although you can manipulate the raw fixtured points, the default locations should normally be appropriate. Equivalent to enabling the CogFixtureNPointToNPointCurrentRecordConstants bit of the tool's CurrentRecord.

Inputs

You can display the following graphics on the input image contained in the Current.InputImage buffer:

• Show Unfixtured Axes displays noninteractive coordinate axes that represent unfixtured space. The unfixtured space is the selected space of the input image. Equivalent to enabling the CogFixtureNPointToNPointCurrentRecordConstants bit of the tool's CurrentRecord.
• Show Unfixtured Points displays interactive graphics that represent points in unfixtured space. Moving a point graphic changes the RawFixturedX and RawFixturedY coordinates for the point, as shown on the Points tab. This option is enabled by default. Equivalent to enabling the CogFixtureNPointToNPointCurrentRecordConstants bit of the tool's CurrentRecord.

Diagnostics

You can display the following noninteractive, diagnostic result graphics on the output image contained in the LastRun.OutputImage buffer:

• Show Raw Fixtured Axes displays noninteractive coordinate axes that represent the raw fixtured space. Equivalent to enabling the CogFixtureNPointToNPointLastRunRecordDiagConstants bit of the tool's LastRunRecord.
• Show Fixtured Axes displays noninteractive coordinate axes that represent the final fixtured space. The final fixtured space includes the optional origin adjustment transform. This option is enabled by default and is equivalent to enabling the CogFixtureNPointToNPointLastRunRecordDiagConstants bit of the tool's LastRunRecord.
• Show Unfixtured Axes displays noninteractive coordinate axes that represent the unfixtured space. The unfixtured space is the selected space of the input image. Equivalent to enabling the CogFixtureNPointToNPointLastRunRecordDiagConstants bit of the tool's LastRunRecord.
• Show Raw Fixtured Points displays noninteractive graphics that represent points in unfixtured space. Equivalent to enabling the CogFixtureNPointToNPointLastRunRecordDiagConstants bit of the tool's LastRunRecord.
• Show Unfixtured Points displays noninteractive graphics that represent points in raw fixtured space. Equivalent to enabling the CogFixtureNPointToNPointLastRunRecordDiagConstants bit of the tool's LastRunRecord.