About Record KeysCognex VisionPro

Record keys provide access to the data stored in VisionPro tool records.

Cog2DSymbolTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 1. Cog2DSymbolTool Current Record Keys
Record KeyContentTypeCog2DSymbolCurrentRecordConstants
InputImage ImageInputImage
    SearchRegion Graphic

SearchRegion

An interactive shape that depicts the SearchRegion of the image.

TrainImage ImageTrainImage
    TrainRegion Graphic

TrainRegion

An interactive shape that depicts the TrainRegion of the training image.

    NominalGrid Graphic

NominalGrid

An interactive CogRectangleAffine that depicts the NominalGrid of the training image.

    TrainResultGrid Graphic

TrainResultGrid

A noninteractive CogRectangleAffine that depicts the ResultGrid of the training image.

    TrainedLocatedCenter Graphic

TrainedLocatedCenter

A noninteractive CogPointMarker that depicts the center of the located symbol in the training image.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 2. Cog2DSymbolTool Last Run Record Keys
Record KeyContentTypeCog2DSymbolLastRunRecordConstants and Cog2DSymbolLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    SearchRegion Graphic

SearchRegion

A shape that depicts the SearchRegion of the image.

    ResultGrid Graphic

ResultGrid

A noninteractive CogRectangleAffine that depicts the ResultGrid of the input image.

    LocatedCenter Graphic

LocatedCenter

A CogPointMarker that depicts the center of the located symbol in the input image.

TrainImage Image

TrainImageDeepCopy

A copy of the TrainImage.

    TrainRegion Graphic

TrainRegion

A shape that depicts the TrainRegion of the training image.

    TrainResultGrid Graphic

TrainResultGrid

A noninteractive CogRectangleAffine that depicts the ResultGrid of the training image.

    TrainedLocatedCenter Graphic

TrainedLocatedCenter

A CogPointMarker that depicts the center of the located symbol in the training image.

TransformedTrainRegionImage Image

TransformedTrainRegionImage

Training image after an affine transform if TrainRegionMode is CogRegionModeConstants.

    TrainResultGrid Graphic

TransformedTrainResultGrid

A noninteractive CogRectangleAffine that depicts the ResultGrid of the transformed training image.

    TrainedLocatedCenter Graphic

TransformedTrainedLocatedCenter

A CogPointMarker that depicts the center of the located symbol in the transformed training image.

Cog2DSymbolVerifyTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Table 3. Cog2DSymbolVerifyTool Current Record Keys
Record KeyContentTypeCog2DSymbolVerifyCurrentRecordConstants
InputImage ImageInputImage
    Region Graphic

Region

An interactive shape that depicts the Region of the image.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Table 4. Cog2DSymbolVerifyTool Last Run Record Keys
Record KeyContentTypeCog2DSymbolVerifyLastRunRecordConstants and Cog2DSymbolVerifyLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region Graphic

SearchRegion

A shape that depicts the Region of the image.

    IAQGDotLocationMap Graphic

IAQGDotLocationMap

Generate a CreateResultMaskGraphic of the per-dot location grades.

    IAQGDotSizeMap Graphic

IAQGDotSizeMap

Generate a CreateResultMaskGraphic of the per-dot dot size grades.

    IAQGDotShapeMap Graphic

IAQGDotShapeMap

Generate a CreateResultMaskGraphic of the per-dot shape grades.

    IAQGDotCombinedMap Graphic

IAQGDotCombinedMap

Generate a CreateResultMaskGraphic of the per-dot combined grades.

    IAQGDotLocationContour Graphic

IAQGDotLocationContour

Generate a CreateResultContourGraphic of the per-dot location grades.

    IAQGDotSizeContour Graphic

IAQGDotSizeContour

Generate a CreateResultContourGraphic of the per-dot dot size grades.

    IAQGDotShapeContour Graphic

IAQGDotShapeContour

Generate a CreateResultContourGraphic of the per-dot shape grades.

    IAQGDotCombinedContour Graphic

IAQGDotCombinedContour

Generate a CreateResultContourGraphic of the per-dot combined grades.

CogAffineTransformTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 5. CogAffineTransformTool Current Record Keys
Record KeyContentTypeCogAffineTransformCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 6. CogAffineTransformTool Last Run Record Keys
Record KeyContentTypeCogAffineTransformLastRunRecordConstants and CogAffineTransformLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
OutputImage ImageOutputImage

CogBarcodeTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

Table 7. CogBarcodeTool Current Record Keys
Record KeyContentTypeCogBarcodeCurrentRecordConstants
InputImage ImageInputImage
    Region Graphic

Region

An interactive shape that depicts the Region of the image.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

Table 8. CogBarcodeTool Last Run Record Keys
Record KeyContentTypeCogBarcodeLastRunRecordConstants and CogBarcodeLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region Graphic

CogBarcodeLastRunRecordDiagRegion

A shape that depicts the Region of the image.

    CompositeResultGraphics Graphics Collection

ResultsBounds

ResultsCenters

Include CogPolygon that represent the bounds of each found symbol and the CogPointMarker of each symbol found.

TransformedRegionPixels Image

TransformedRegionPixels

The transformed image.

    CompositeResultGraphics Graphics Collection

ResultsBounds

ResultsCenters

Include CogPolygon that represent the bounds of each found symbol and the CogPointMarker of each symbol found.

CogBlobTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Current Record are references to the actual masks and regions used in the tool.

Table 9. CogBlobTool Current Record Keys
Record KeyContentTypeCogBlobCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion
    InputImageMask GraphicInputImageMask
SubtractionImage Image

SubtractionImage

Available only if the Mode is CogBlobSegmentationModeConstants.

Histogram Image

Histogram

Histogram records are delay constructed and are not mutable. If the state of the tool would require the histogram to change, the affected records are destroyed and new content is created.

    AddHistogramSpaceCmd Display MethodDisplay command record that adds a coordinate space.
    ChangeHistogramSpaceNameCmd Display MethodDisplay command record that sets the coordinate space name.
    HistogramGraphics Graphics CollectionCogGraphicCollection that contains the histogram graphics..

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

The CompositeResultGraphic and CompositeResultGraphic2 subrecords are delay constructed and are created by CreateResultGraphics. The GraphicOptions parameter is specified by ORing the constants in CogBlobLastRunRecordConstants.

The CompositeResultGraphics2 subrecord is present if the selected space of the InputImage is # or if the InputImage record is not enabled. Otherwise, the same CompositeResultGraphics record used for the InputImage record is used for the Blob and Segmented images as well. If the selected space of the InputImage was #, the selected space name of the graphics in CompositeResultGraphics2 is "_InputImage#".

Table 10. CogBlobTool Last Run Record Keys
Record KeyContentTypeCogBlobLastRunRecordConstants and CogBlobLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region ImageRegion
    CompositeResultGraphics Graphics CollectionResultsBoundingBoxPixelAligned

ResultsBoundingBoxPrincipalAxis

ResultsBoundingBoxExtremaAngle

ResultsBoundingBoxSelectedSpace

ResultsMedianPixelAligned

ResultsMedianPrincipalAxis

ResultsMedianExtremaAngle

ResultsMedianSelectedSpace

ResultsBoundary

ResultsCenterOfMass

ResultsUnfiltered
    InputImageMask GraphicInputImageMask
    BlobImageAsGraphic Graphic

BlobImageAsGraphic

ResultsUnfiltered

A CogMaskGraphic with an image created by CreateBlobImage. The Filtered parameter is controlled by the ResultsUnfiltered bit.

For grey scale ConnectivityMode , holes are drawn in magenta and blobs are drawn in cyan. For labeled connectivity, labeled blobs are drawn in either magenta, cyan, orange, purple, yellow, or blue. If there are more than six labels, a color may be used for more than one label.

BlobImage ImageBlobImage
    CompositeResultGraphics or

    CompositeResultGraphics2
Graphics CollectionResultsBoundingBoxPixelAligned

ResultsBoundingBoxPrincipalAxis

ResultsBoundingBoxExtremaAngle

ResultsBoundingBoxSelectedSpace

ResultsMedianPixelAligned

ResultsMedianPrincipalAxis

ResultsMedianExtremaAngle

ResultsMedianSelectedSpace

ResultsBoundary

ResultsCenterOfMass

ResultsUnfiltered
BlobImageUnfiltered ImageBlobImageUnfiltered
    CompositeResultGraphics or

    CompositeResultGraphics2
Graphics CollectionResultsBoundingBoxPixelAligned

ResultsBoundingBoxPrincipalAxis

ResultsBoundingBoxExtremaAngle

ResultsBoundingBoxSelectedSpace

ResultsMedianPixelAligned

ResultsMedianPrincipalAxis

ResultsMedianExtremaAngle

ResultsMedianSelectedSpace

ResultsBoundary

ResultsCenterOfMass

ResultsUnfiltered
SegmentedImage ImageSegmentedImage
    CompositeResultGraphics or

    CompositeResultGraphics2
Graphics CollectionResultsBoundingBoxPixelAligned

ResultsBoundingBoxPrincipalAxis

ResultsBoundingBoxExtremaAngle

ResultsBoundingBoxSelectedSpace

ResultsMedianPixelAligned

ResultsMedianPrincipalAxis

ResultsMedianExtremaAngle

ResultsMedianSelectedSpace

ResultsBoundary

ResultsCenterOfMass

ResultsUnfiltered
SegmentedImageBeforeMasking ImageSegmentedImageBeforeMasking
    CompositeResultGraphics or

    CompositeResultGraphics2
Graphics CollectionResultsBoundingBoxPixelAligned

ResultsBoundingBoxPrincipalAxis

ResultsBoundingBoxExtremaAngle

ResultsBoundingBoxSelectedSpace

ResultsMedianPixelAligned

ResultsMedianPrincipalAxis

ResultsMedianExtremaAngle

ResultsMedianSelectedSpace

ResultsBoundary

ResultsCenterOfMass

ResultsUnfiltered
SegmentedImageBeforeMorphology ImageSegmentedImageBeforeMorphology
    CompositeResultGraphics or

    CompositeResultGraphics2
Graphics CollectionResultsBoundingBoxPixelAligned

ResultsBoundingBoxPrincipalAxis

ResultsBoundingBoxExtremaAngle

ResultsBoundingBoxSelectedSpace

ResultsMedianPixelAligned

ResultsMedianPrincipalAxis

ResultsMedianExtremaAngle

ResultsMedianSelectedSpace

ResultsBoundary

ResultsCenterOfMass

ResultsUnfiltered
SubtractionImage Image

SubtractionImageByReference

The record contains a reference to the actual SubtractionImage.

Histogram Image

Histogram

The graphics record contains a reference to the same histogram data as for the Current Record.

    AddHistogramSpaceCmd Display MethodDisplay command record that adds a coordinate space.
    ChangeHistogramSpaceNameCmd Display MethodDisplay command record that sets the coordinate space name.
    HistogramGraphics Graphics CollectionCogGraphicCollection that contains the histogram graphics..

CogCNLSearchTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Current Record are references to the actual masks and regions used in the tool.

Table 11. CogCNLSearchTool Current Record Keys
Record KeyContentTypeCogCNLSearchCurrentRecordConstants
InputImage ImageInputImage
    SearchRegion Graphic

SearchRegion

A graphic that contains a reference to the current SearchRegion.

This record is available only if SearchPointEnabled is False.

    SearchPoint Graphic

SearchPoint

A CogPointMarker that indicates the current SearchPointX.

This record is available only if SearchPointEnabled is True.

TrainImage ImageTrainImage
    TrainRegion Graphic

TrainRegion

Contains a reference to the actual TrainRegion.

    PatternOrigin Graphic

PatternOrigin

An interactive CogPointMarker that contains a reference to the pattern's actual OriginX.

    TrainImageMask Graphic

TrainImageMask

A CogMaskGraphic that contains a reference to the actual TrainImageMask. Available only when the pattern training Algorithms includes CogCNLSearchAlgorithmConstants.

    TrainedEdges Graphic

TrainedEdges

A CogMaskGraphic that represents the TrainedEdgeImage.

This record is available only when the pattern training Algorithms includes CogCNLSearchAlgorithmConstants. It is not available when the TrainRegionMode is CogRegionModeConstants.

TrainedPatternImage Image

TrainedPatternImage

This record is delay constructed by calling GetTrainedPatternImage.

    TrainedPatternRegion Graphic

TrainedPatternRegion

Contains a noninteractive deep copy of the TrainRegion.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A noninteractive CogPointMarker that represents the pattern's OriginX.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the TrainedPatternImageMask. This graphic is obtained by calling GetTrainedPatternImageMask.

Available only when the pattern training Algorithms includes CogCNLSearchAlgorithmConstants.

    TrainedPatternEdges Graphic

TrainedPatternEdges

A CogMaskGraphic that represents the TrainedEdgeImage.

This record is available only when the pattern training Algorithms includes CogCNLSearchAlgorithmConstants.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

The CompositeResultGraphic subrecord is delay constructed and are created by CreateResultGraphics. The GraphicOptions parameter is specified by ORing the constants that begin with CogCNLSearchLastRunRecordConstants.

Table 12. CogCNLSearchTool Last Run Record Keys
Record KeyContentTypeCogCNLSearchLastRunRecordConstants and CogCNLSearchLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    SearchRegion Graphic

SearchRegion

A graphic that contains a copy of SearchRegion.

This record is available only if SearchPointEnabled is False.

    SearchPoint Graphic

SearchPoint

A CogPointMarker that indicates the SearchPointX.

This record is available only if SearchPointEnabled is True.

    CompositeResultGraphics Graphics CollectionResultsOrigin

ResultsBoundingBox

ResultsMatchRegion
TransformedRegionImage Image

TransformedRegionImage

The SearchRegion after it has been transformed. This record is available only if the SearchRegionMode is CogRegionModeConstants and the search region is a CogRectangleAffine.

This record is not available if SearchPointEnabled is True and Algorithm is CogCNLSearchAlgorithmConstants.

    CompositeResultGraphics

or

    CompositeResultGraphics2
Graphics Collection

ResultsOrigin

ResultsBoundingBox

ResultsMatchRegion

If the selected space name of InputImage is #, the selected space name of the graphics in CompositeResultGraphics2 subrecord is "_InputImage#". If both the InputImage and TransformedRegionImage records are enabled along with the composite graphics subrecords, and the selected space name of InputImage is not   #, then both image records have the same CompositeResultGraphics subrecords; otherwise the TransformedRegionImage record has a CompositeResultGraphics2 subrecord.

TrainImage Image

TrainImageDeepCopy

Contains a deep copy of the TrainImage.

    TrainRegion Graphic

TrainRegion

Contains a deep copy of the TrainRegion.

    PatternOrigin Graphic

PatternOrigin

A noninteractive CogPointMarker that represents the pattern's OriginX.

    TrainImageMask Graphic

TrainImageMask

A CogMaskGraphic that contains a copy of the TrainImageMask.

This record is available only when the pattern training Algorithm includes CogCNLSearchAlgorithmConstants.

    TrainedEdges Graphic

TrainedEdges

A CogMaskGraphic that represents the TrainedEdgeImage.

This record is available only when the pattern training Algorithm includes CogCNLSearchAlgorithmConstants. It is not available when the TrainRegionMode is CogRegionModeConstants.

TrainedPatternImage Image

TrainedPatternImage

This record is created by calling GetTrainedPatternImage.

    TrainedPatternRegion Graphic

TrainedPatternRegion

Contains a deep copy of the TrainRegion.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A noninteractive CogPointMarker that represents the pattern's OriginX.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the TrainedPatternImageMask. This graphic is obtained by calling GetTrainedPatternImageMask.

This record is available only when the pattern training Algorithm includes CogCNLSearchAlgorithmConstants.

    TrainedPatternEdges Graphic

TrainedPatternEdges

A CogMaskGraphic that represents the TrainedEdgeImage.

This record is available only when the pattern training Algorithm includes CogCNLSearchAlgorithmConstants.

CogCalibCheckerboardTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Current Record are references to the actual masks and regions used in the tool.

Table 13. CogCalibCheckerboardTool Current Record Keys
Record KeyContentTypeCogCalibCheckerboardCurrentRecordConstants
InputImage ImageInputImage
    UncalibratedAxes Graphic

UncalibratedAxes

A noninteractive CogCoordinateAxes that indicates the uncalibrated coordinate space.

    CalibratedAxes Graphic

CalibratedAxes

A noninteractive CogCoordinateAxes that indicates the calibrated coordinate space.

This record is available only if the calibration has been computed to step 2.

CalibrationImage ImageCalibrationImage
    UncalibratedAxes Graphic

CalUncalibratedAxes

A noninteractive CogCoordinateAxes that indicates the uncalibrated coordinate space of the calibration image.

    UncalibratedPoints Graphics Collection

CalUncalibratedPoints

CogCompositeShapes that represent the uncalibrated points.

    CalibratedAxes Graphic

CalCalibratedAxes

An interactive CogCompositeShape that represents and allows adjustment of the axes of the calibrated coordinate space.

This record is available only if the calibration has been computed to step 2.

    RawCalibratedAxes Graphic

CalRawCalibratedAxes

A noninteractive CogCoordinateAxes that represent the raw calibrated coordinate space.

This record is available only if the calibration has been computed to step 2.

    RawCalibratedPoints Graphics Collection

CalRawCalibratedPoints

Noninteractive CogCompositeShapes that represent the raw calibrated points.

This record is available only if the calibration has been computed to step 2.

UndistortedCalibrationImage ImageUndistortedCalibrationImage
    UncalibratedAxes Graphic

CalUncalibratedAxes

A noninteractive CogCoordinateAxes that indicates the uncalibrated coordinate space of the calibration image.

    UncalibratedPoints Graphics Collection

CalUncalibratedPoints

CogCompositeShapes that represent the uncalibrated points.

    CalibratedAxes Graphic

CalCalibratedAxes

An interactive CogCompositeShape that represents and allows adjustment of the axes of the calibrated coordinate space.

This record is available only if the calibration has been computed to step 2.

    RawCalibratedAxes Graphic

CalRawCalibratedAxes

A noninteractive CogCoordinateAxes that represent the raw calibrated coordinate space.

This record is available only if the calibration has been computed to step 2.

    RawCalibratedPoints Graphics Collection

CalRawCalibratedPoints

Noninteractive CogCompositeShapes that represent the raw calibrated points.

This record is available only if the calibration has been computed to step 2.

    DestinationRectangle Graphic

CalDestinationRectangle

This record is available if the calibration has been computed to step 3.

    UndistortedImageMask Graphic

CalUndistortedImageMask

This record is available if the calibration has been computed to step 3.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

Table 14. CogCalibCheckerboardTool Last Run Record Keys
Record KeyContentTypeCogCalibCheckerboardLastRunRecordConstants and CogCalibCheckerboardLastRunRecordDiagConstants
OutputImage ImageOutputImage
    CalibratedAxes Graphic

CalibratedAxes

A CogCoordinateAxes that represents the calibrated coordinate space.

    UncalibratedAxes Graphic

UncalibratedAxes

A CogCoordinateAxes that represents the uncalibrated coordinate space.

    OutputImageMask GraphicOutputImageMask
InputImage ImageInputImageByReference
    CalibratedAxes Graphic

CalibratedAxes

A CogCoordinateAxes that represents the calibrated coordinate space.

    UncalibratedAxes Graphic

UncalibratedAxes

A CogCoordinateAxes that represents the uncalibrated coordinate space.

CogCalibNPointToNPointTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 15. CogCalibNPointToNPointTool Current Record Keys
Record KeyContentTypeCogCalibNPointToNPointCurrentRecordConstants
InputImage ImageInputImage
    UncalibratedAxes Graphic

UncalibratedAxes

A noninteractive CogCoordinateAxes that indicates the uncalibrated coordinate space.

    CalibratedAxes Graphic

CalibratedAxes

A noninteractive CogCoordinateAxes that indicates the calibrated coordinate space.

This record is available only if the calibration has been computed.

CalibrationImage ImageCalibrationImage
    UncalibratedAxes Graphic

CalUncalibratedAxes

A noninteractive CogCoordinateAxes that indicates the uncalibrated coordinate space of the calibration image.

    UncalibratedPoints Graphics Collection

CalUncalibratedPoints

Interactive CogCompositeShapes that represent the uncalibrated points.

    CalibratedAxes Graphic

CalCalibratedAxes

An interactive CogCompositeShape that represents and allows adjustment of the axes of the calibrated coordinate space.

This record is available only if the calibration has been computed.

    RawCalibratedAxes Graphic

CalRawCalibratedAxes

A noninteractive CogCoordinateAxes that represent the raw calibrated coordinate space.

This record is available only if the calibration has been computed.

    RawCalibratedPoints Graphics Collection

CalRawCalibratedPoints

Noninteractive CogCompositeShapes that represent the raw calibrated points.

This record is available only if the calibration has been computed.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 16. CogCalibNPointToNPointTool Last Run Record Keys
Record KeyContentTypeCogCalibNPointToNPointLastRunRecordConstants and CogCalibNPointToNPointLastRunRecordDiagConstants
OutputImage ImageOutputImage
    CalibratedAxes Graphic

CalibratedAxes

A CogCoordinateAxes that represents the calibrated coordinate space.

    UncalibratedAxes Graphic

UncalibratedAxes

A CogCoordinateAxes that represents the uncalibrated coordinate space.

InputImage ImageInputImageByReference
    CalibratedAxes Graphic

CalibratedAxes

A CogCoordinateAxes that represents the calibrated coordinate space.

    UncalibratedAxes Graphic

UncalibratedAxes

A CogCoordinateAxes that represents the uncalibrated coordinate space.

CogCaliperTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are references to the actual regions used in the tool.

Table 17. CogCaliperTool Current Record Keys
Record KeyContentTypeCogCaliperCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 18. CogCaliperTool Last Run Record Keys
Record KeyContentTypeCogCaliperLastRunRecordConstants and CogCaliperLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
    FoundEdges Graphics CollectionEdges
RegionData Image

If you specify TransformedRegionPixels the record contains an image that depicts the transformed affine region or the entire region if no region was specified.

If you also specify Edges2, the edges appear on the transformed image.

    ProjectionGraph Graphic

ProjectionGraph

A CogCompositeShape that represents the projection graph.

If you also specify Edges2, the edges appear on the graph.

    FilteredProjectionGraph Graphic

FilteredProjectionGraph

A CogCompositeShape that represents the filtered projection graph.

If you also specify Edges2, the edges appear on the graph.

    FoundEdges Graphics CollectionEdges

CogCopyRegionTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 19. CogCopyRegionTool Current Record Keys
Record KeyContentTypeCogCopyRegionCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion
DestinationImage GraphicDestinationImage

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 20. CogCopyRegionTool Last Run Record Keys
Record KeyContentTypeCogCopyRegionLastRunRecordConstants and CogCopyRegionLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
    AlignmentPoint GraphicAlignmentPoints
OutputImage ImageOutputImage
    DestinationRegion GraphicDestinationRegion
    AlignmentPoint GraphicAlignmentPoints

CogFindCircleTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and shapes in the Current Record are references to the actual masks and shapes used in the tool.

Table 21. CogFindCircleTool Current Record Keys
Record KeyContentTypeCogFindCircleCurrentRecordConstants
InputImage ImageInputImage
    ExpectedShapeSegment Graphic

ExpectedCircularArc

An interactive CogCircularArc that denotes the ExpectedCircularArc.

    CaliperRegions Graphics Collection

CaliperRegions

InteractiveCaliperSize

If CaliperRegions is set, the record contains a CogGraphicCollection that includes the CogRectangleAffine that depict the calipers and a line segment that indicates the CaliperSearchDirection.

If InteractiveCaliperSize is set, the collection includes a CogPointMarker used to resize the calipers. If only InteractiveCaliperSize is set, the collection contains only the center caliper.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

Table 22. CogFindCircleTool Last Run Record Keys
Record KeyContentTypeCogFindCircleLastRunRecordConstants and CogFindCircleLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    BestFitShape Graphics Collection

BestFitCircle

A CogGraphicCollection that contains the best fit CogCircle and a CogPointMarker that indicates the center of the circle.

    BestFitShapeSegment Graphic

BestFitCircularArc

A CogCircularArc that represents the best fit arc.

    CompositeResultGraphics Graphics CollectionResultsUsedPoints

ResultsIgnoredPoints

ResultsCaliperEdges

ResultsCaliperRegions
    ExpectedShapeSegment GraphicExpectedCircularArc
RegionData_CaliperN Image

The tool generates a record for each caliper with N ranging from 0 to one less than the number of calipers.

If TransformedRegionPixels is selected, this record contains the transformed image of each caliper.

    ProjectionGraph GraphicProjectionGraph
    FilteredProjectionGraph GraphicFilteredProjectionGraph
    FoundEdges Graphic

FoundEdges

A CogCompositeShape that represents the found edge on the projection graphs and the transformed image. This record is generated only when at least one of TransformedRegionPixels , ProjectionGraph, or FilteredProjectionGraph is set.

    InputImage Tool DefinedThe tool uses this record for delayed construction of the transformed image.
    NoCaliperResults Graphic

ProjectionGraph

FilteredProjectionGraph

TransformedRegionPixels

The content of this record is a CogGraphicLabel that contains the text "No Caliper results available". This may occur when some, but not all, of the caliper regions fall completely off the image. In this case, the RegionData_CaliperN records will contain this subrecord instead of the other subrecords.

CogFindLineTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and shapes in the Current Record are references to the actual masks and shapes used in the tool.

Table 23. CogFindLineTool Current Record Keys
Record KeyContentTypeCogFindLineCurrentRecordConstants
InputImage ImageInputImage
    ExpectedShapeSegment Graphic

ExpectedLineSegment

An interactive CogLineSegment that denotes the ExpectedLineSegment.

    CaliperRegions Graphics Collection

CaliperRegions

InteractiveCaliperSize

InteractiveCaliperSearchDirection

If CaliperRegions is set, the record contains a CogGraphicCollection that includes the CogRectangleAffine that depict the calipers and a line segment that indicates the CaliperSearchDirection.

If InteractiveCaliperSize is set, the collection includes a CogPointMarker used to resize the calipers. If only InteractiveCaliperSize is set, the collection contains only the center caliper.

If InteractiveCaliperSearchDirection is set the line segment that depicts the search direction is interactive.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

Table 24. CogFindLineTool Last Run Record Keys
Record KeyContentTypeCogFindLineLastRunRecordConstants and CogFindLineLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    BestFitShape Graphics Collection

BestFitLine

A CogGraphicCollection that contains the best fit CogLine.

    BestFitShapeSegment Graphic

BestFitLineSegment

A CogLineSegment that represents the best fit segment.

    CompositeResultGraphics Graphics CollectionResultsUsedPoints

ResultsIgnoredPoints

ResultsCaliperEdges

ResultsCaliperRegions
    ExpectedShapeSegment GraphicExpectedLineSegment
RegionData_CaliperN Image

The tool generates a record for each caliper with N ranging from 0 to one less than the number of calipers.

If TransformedRegionPixels is selected, this record contains the transformed image of each caliper.

    ProjectionGraph GraphicProjectionGraph
    FilteredProjectionGraph GraphicFilteredProjectionGraph
    FoundEdges Graphic

FoundEdges

A CogCompositeShape that represents the found edge on the projection graphs and the transformed image. This record is generated only when at least one of TransformedRegionPixels , ProjectionGraph, or FilteredProjectionGraph is set.

    InputImage Tool DefinedThe tool uses this record for delayed construction of the transformed image.
    NoCaliperResults Graphic

ProjectionGraph

FilteredProjectionGraph

TransformedRegionPixels

The content of this record is a CogGraphicLabel that contains the text "No Caliper results available". This may occur when some, but not all, of the caliper regions fall completely off the image. In this case, the RegionData_CaliperN records will contain this subrecord instead of the other subrecords.

CogFitCircleTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 25. CogFitCircleTool Current Record Keys
Record KeyContentTypeCogFitCircleCurrentRecordConstants
InputImage ImageInputImage
    InputPoints Graphics Collection

InputPoints

A CogGraphicCollection that contains each of the input points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are interactive.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 26. CogFitCircleTool Last Run Record Keys
Record KeyContentTypeCogFitCircleLastRunRecordConstants and CogFitCircleLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    UsedPoints Graphics Collection

UsedPoints

A CogGraphicCollection that contains each of the used points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are not interactive.

    IgnoredPoints Graphics Collection

IgnoredPoints

A CogGraphicCollection that contains each of the ignored points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are not interactive.

    Shape Graphics Collection

Circle

A CogGraphicCollection that contains the fitted CogCircle and a CogPointMarker that indicates its center.

CogFitEllipseTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 27. CogFitEllipseTool Current Record Keys
Record KeyContentTypeCogFitEllipseCurrentRecordConstants
InputImage ImageInputImage
    InputPoints Graphics Collection

InputPoints

A CogGraphicCollection that contains each of the input points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are interactive.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 28. CogFitEllipseTool Last Run Record Keys
Record KeyContentTypeCogFitEllipseLastRunRecordConstants and CogFitEllipseLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    UsedPoints Graphics Collection

UsedPoints

A CogGraphicCollection that contains each of the used points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are not interactive.

    IgnoredPoints Graphics Collection

IgnoredPoints

A CogGraphicCollection that contains each of the ignored points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are not interactive.

    Shape Graphics Collection

Ellipse

A CogGraphicCollection that contains the fitted CogEllipse and a CogPointMarker that indicates its center.

CogFitLineTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 29. CogFitLineTool Current Record Keys
Record KeyContentTypeCogFitLineCurrentRecordConstants
InputImage ImageInputImage
    InputPoints Graphics Collection

InputPoints

A CogGraphicCollection that contains each of the input points. Each of the points is aCogPointMarker enclosed in a CogCompositeShape. The points are interactive.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 30. CogFitLineTool Last Run Record Keys
Record KeyContentTypeCogFitLineLastRunRecordConstants and CogFitLineLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    UsedPoints Graphics Collection

UsedPoints

A CogGraphicCollection that contains each of the used points. Each of the points is aCogPointMarker enclosed in a CogCompositeShape. The points are not interactive.

    IgnoredPoints Graphics Collection

IgnoredPoints

A CogGraphicCollection that contains each of the ignored points. Each of the points is a CogPointMarker enclosed in a CogCompositeShape. The points are not interactive.

    Shape Graphics Collection

Line

A CogGraphicCollection that contains the fitted CogLine.

CogFixtureNPointToNPointTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 31. CogFixtureNPointToNPointTool Current Record Keys
Record KeyContentTypeCogFixtureNPointToNPointCurrentRecordConstants
InputImage ImageInputImage
    UnfixturedAxes Graphic

UnfixturedAxes

A CogCoordinateAxes that represents the unfixtured coordinate space.

    UnfixturedPoints Graphics Collection

UnfixturedPoints

A collection of CogCompositeShapes that indicate the unfixtured points.

ReferenceImage Image

RefImage

To generate this record ReferenceImageEnabled must be True.

    RawFixturedAxes Graphic

RawFixturedAxes

A CogCoordinateAxes that represents the raw fixtured coordinate space.

    RawFixturedPoints Graphics CollectionRawFixturedPoints

A collection of CogCompositeShapes that indicate the raw fixtured points.

    FixturedAxes Graphic

FixturedAxes

An interactive CogCoordinateAxes that represents and allows you to adjust the fixtured coordinate space. Manipulating these axes changes the RawFixturedFromFixturedTransform property.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 32. CogFixtureNPointToNPointTool Last Run Record Keys
Record KeyContentTypeCogFixtureNPointToNPointLastRunRecordConstants and CogFixtureNPointToNPointLastRunRecordDiagConstants
OutputImage ImageOutputImage
    UnfixturedAxes Graphic

UnfixturedAxes

A CogCoordinateAxes that represents the unfixtured coordinate space.

    FixturedAxes Graphic

FixturedAxes

A CogCoordinateAxes that represents the fixtured coordinate space.

    UnfixturedPoints Graphics Collection

UnfixturedPoints

A collection of CogCompositeShapes that indicate the unfixtured points.

    RawFixturedPoints Graphics Collection

RawFixturedPoints

A collection of CogCompositeShapes that indicate the raw fixtured points.

    RawFixturedAxes Graphic

RawFixturedAxes

A CogCoordinateAxes that represents the raw fixtured coordinate space.

InputImage ImageInputImageByReference
    UnfixturedAxes Graphic

UnfixturedAxes

A CogCoordinateAxes that represents the unfixtured coordinate space.

    FixturedAxes Graphic

FixturedAxes

A CogCoordinateAxes that represents the fixtured coordinate space.

    UnfixturedPoints Graphics Collection

UnfixturedPoints

A collection of CogCompositeShapes that indicate the unfixtured points.

    RawFixturedPoints Graphics Collection

RawFixturedPoints

A collection of CogCompositeShapes that indicate the raw fixtured points.

    RawFixturedAxes Graphic

RawFixturedAxes

A CogCoordinateAxes that represents the raw fixtured coordinate space.

CogFixtureTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 33. CogFixtureTool Current Record Keys
Record KeyContentTypeCogFixtureCurrentRecordConstants
InputImage ImageInputImage
    FixturedAxes Graphic

FixturedAxes

An interactive CogCoordinateAxes that represents and allows you to adjust the fixtured coordinate space. Manipulating these axes changes the UnfixturedFromFixturedTransform property.

    UnfixturedAxes Graphic

UnfixturedAxes

A CogCoordinateAxes that represents the unfixtured coordinate space.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 34. CogFixtureTool Last Run Record Keys
Record KeyContentTypeCogFixtureLastRunRecordConstants and CogFixtureLastRunRecordDiagConstants
OutputImage ImageOutputImage
    FixturedAxes Graphic

FixturedAxes

A CogCoordinateAxes that represents the fixtured coordinate space.

    UnfixturedAxes Graphic

UnfixturedAxes

A CogCoordinateAxes that represents the unfixtured coordinate space.

InputImage ImageInputImageByReference
    FixturedAxes Graphic

FixturedAxes

A CogCoordinateAxes that represents the fixtured coordinate space.

    UnfixturedAxes Graphic

UnfixturedAxes

A CogCoordinateAxes that represents the unfixtured coordinate space.

CogHistogramTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 35. CogHistogramTool Current Record Keys
Record KeyContentTypeCogHistogramCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion
    InputImageMask Graphic

InputImageMask

A mask that refers to the actual InputImageMask if one is provided.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 36. CogHistogramTool Last Run Record Keys
Record KeyContentTypeCogHistogramLastRunRecordConstants and CogHistogramLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
    InputImageMask Graphic

InputImageMask

A mask that is a copy of the actual InputImageMask if one is provided.

Histogram Image

Histogram

Mean

CumulativeHistogram

Median

The mean, if enabled, is added as a white line. The median, if enabled, is added as a yellow line. The cumulative histogram graph, if enabled, is added to the histogram.

    AddHistogramSpaceCmd Display MethodDisplay command record that adds a coordinate space.
    ChangeHistogramSpaceNameCmd Display MethodDisplay command record that sets the coordinate space name.
    HistogramGraphics Graphics CollectionCogGraphicCollection that contains the histogram graphics..

CogIPOneImageTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 37. CogIPOneImageTool Current Record Keys
Record KeyContentTypeCogIPOneImageCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 38. CogIPOneImageTool Last Run Record Keys
Record KeyContentTypeCogIPOneImageLastRunRecordConstants and CogIPOneImageLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
TransformedRegionImage Image

TransformedRegionImage

InputImage after an affine transform if RegionMode is CogRegionModeConstants.

    IntermediateImage - n Image

IntermediateImages

The tool creates one intermediate record for each operator except the last one.

OutputImage ImageOutputImage

CogIPTwoImageAddTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 39. CogIPTwoImageAddTool Current Record Keys
Record KeyContentTypeCogIPTwoImageAddCurrentRecordConstants
InputImageA ImageInputImages
    RegionA GraphicRegions
    AlignmentPointA Graphic

AlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageA if ImageAlignmentEnabled are enabled.

InputImageB ImageInputImages
    RegionB GraphicRegions
    AlignmentPointB Graphic

AlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageB if ImageAlignmentEnabled are enabled.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 40. CogIPTwoImageAddTool Last Run Diagnostic Record Keys
Record KeyContentTypeCogIPTwoImageAddLastRunRecordConstants and CogIPTwoImageAddLastRunRecordDiagConstants
InputImageA ImageInputImagesByReference or

InputImagesDeepCopy
    RegionA GraphicRegions
    AlignmentPointA Graphic

ImageAlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageA if ImageAlignmentEnabled are enabled.

    OverlapMaskA Graphic

OverlapMasks

A CogMaskGraphic that indicates how InputImageB overlaps on InputImageA. Available only if you do not specify a region for InputImageA.

TransformedRegionImageA Image

TransformedRegionImages

InputImageA after an affine transform if RegionModeA is CogRegionModeConstants.

    OverlapMaskA Graphic

OverlapMasks

A CogMaskGraphic that indicates how the transformed InputImageB overlaps on InputImageA.

InputImageB ImageInputImagesByReference or

InputImagesDeepCopy
    RegionB GraphicRegions
    AlignmentPointB Graphic

ImageAlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageB if ImageAlignmentEnabled are enabled.

    OverlapMaskB Graphic

OverlapMasks

A CogMaskGraphic that indicates how InputImageA overlaps on InputImageB. Available only if you do not specify a region for InputImageA.

TransformedRegionImageB Image

TransformedRegionImages

InputImageB after an affine transform if RegionModeB is CogRegionModeConstants.

    OverlapMaskB Graphic

OverlapMasks

A CogMaskGraphic that indicates how the transformed InputImageA overlaps on InputImageB.

OutputImage ImageOutputImage

CogIPTwoImageMinMaxTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 41. CogIPTwoImageMinMaxTool Current Record Keys
Record KeyContentTypeCogIPTwoImageMinMaxCurrentRecordConstants
InputImageA ImageInputImages
    RegionA GraphicRegions
    AlignmentPointA Graphic

AlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageA if ImageAlignmentEnabled are enabled.

InputImageB ImageInputImages
    RegionB GraphicRegions
    AlignmentPointB Graphic

AlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageB if ImageAlignmentEnabled are enabled.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 42. CogIPTwoImageMinMaxTool Last Run Record Keys
Record KeyContentTypeCogIPTwoImageMinMaxLastRunRecordConstants and CogIPTwoImageMinMaxLastRunRecordDiagConstants
InputImageA ImageInputImagesByReference or

InputImagesDeepCopy
    RegionA GraphicRegions
    AlignmentPointA Graphic

ImageAlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageA if ImageAlignmentEnabled are enabled.

    OverlapMaskA Graphic

OverlapMasks

A CogMaskGraphic that indicates how InputImageB overlaps on InputImageA. Available only if you do not specify a region for InputImageA.

TransformedRegionImageA Image

TransformedRegionImages

InputImageA after an affine transform if RegionModeA is CogRegionModeConstants.

    OverlapMaskA Graphic

OverlapMasks

A CogMaskGraphic that indicates how the transformed InputImageB overlaps on InputImageA.

InputImageB ImageInputImagesByReference or

InputImagesDeepCopy
    RegionB GraphicRegions
    AlignmentPointB Graphic

ImageAlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageB if ImageAlignmentEnabled are enabled.

     OverlapMaskB Graphic

OverlapMasks

A CogMaskGraphic that indicates how InputImageA overlaps on InputImageB. Available only if you do not specify a region for InputImageA.

TransformedRegionImageB Image

TransformedRegionImages

InputImageB after an affine transform if RegionModeB is CogRegionModeConstants.

    OverlapMaskB Graphic

OverlapMasks

A CogMaskGraphic that indicates how the transformed InputImageA overlaps on InputImageB.

OutputImage ImageOutputImage

CogIPTwoImageSubtractTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 43. CogIPTwoImageSubtractTool Current Record Keys
Record KeyContentTypeCogIPTwoImageSubtractCurrentRecordConstants
InputImageA ImageInputImages
    RegionA GraphicRegions
    AlignmentPointA Graphic

AlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageA if ImageAlignmentEnabled are enabled.

InputImageB ImageInputImages
    RegionB GraphicRegions
    AlignmentPointB Graphic

AlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageB if ImageAlignmentEnabled are enabled.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 44. CogIPTwoImageSubtractTool Last Run Record Keys
Record KeyContentTypeCogIPTwoImageSubtractLastRunRecordConstants and CogIPTwoImageSubtractLastRunRecordDiagConstants
InputImageA ImageInputImagesByReference or

InputImagesDeepCopy
    RegionA GraphicRegions
    AlignmentPointA Graphic

ImageAlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageA if ImageAlignmentEnabled are enabled.

    OverlapMaskA Graphic

OverlapMasks

A CogMaskGraphic that indicates how InputImageB overlaps on InputImageA. Available only if you do not specify a region for InputImageA.

TransformedRegionImageA Image

TransformedRegionImages

InputImageA after an affine transform if RegionModeA is CogRegionModeConstants.

    OverlapMaskA Graphic

OverlapMasks

A CogMaskGraphic that indicates how the transformed InputImageB overlaps on InputImageA.

InputImageB ImageInputImagesByReference or

InputImagesDeepCopy
    RegionB GraphicRegions
    AlignmentPointB Graphic

ImageAlignmentPoints

A CogCoordinateAxes graphic that represents the alignment point for InputImageB if ImageAlignmentEnabled are enabled.

    OverlapMaskB Graphic

OverlapMasks

A CogMaskGraphic that indicates how InputImageA overlaps on InputImageB. Available only if you do not specify a region for InputImageA.

TransformedRegionImageB Image

TransformedRegionImages

InputImageB after an affine transform if RegionModeB is CogRegionModeConstants.

    OverlapMaskB Graphic

OverlapMasks

A CogMaskGraphic that indicates how the transformed InputImageA overlaps on InputImageB.

OutputImage ImageOutputImage

CogImageAverageTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 45. CogImageAverageTool Current Record Keys
Record KeyContentTypeCogImageAverageCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 46. CogImageAverageTool Last Run Record Keys
Record KeyContentTypeCogImageAverageLastRunRecordConstants and CogImageAverageLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
TransformedRegionPixels Image

TransformedRegionPixels

InputImage after an affine transform if RegionMode is CogRegionModeConstants.

StandardDeviationImage ImageStandardDeviationImage
AverageImage ImageAverageImage

CogImageSharpnessTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 47. CogImageSharpnessTool Current Record Keys
Record KeyContentTypeCogImageSharpnessCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 48. CogImageSharpnessTool Last Run Record Keys
Record KeyContentTypeCogImageSharpnessLastRunRecordConstants and CogImageSharpnessLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion

CogOCVTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 49. CogOCVTool Current Record Keys
Record KeyContentTypeCogOCVCurrentRecordConstants
InputImage ImageInputImage
    PatternPosition Graphic

PatternPositionCoordinateAxes

PatternPositionCharacterOrigins

PatternPositionCharacterCoordinateAxes

PatternPositionCharacterRegions

PatternPositionCharacterLabels

A CogCompositeShape that contains interactive shapes for the pattern's coordinate axes, the characters' origins, the characters' coordinate axes, the characters' regions, and the characters' labels.

PatternReferenceImage ImagePatternReferenceImage
    PatternOrigin Graphic

PatternOriginUniform or

PatternOriginFree

An interactive CogCoordinateAxes that indicates the pattern origin. If PatternOriginUniform is set, the character positions move with the origin. If PatternOriginFree is set, the origin moves independently of the character positions.

    CharacterPositions Graphics Collection

CharacterPositionsCoordinateAxes

CharacterPositionsOrigin

CharacterPositionsLabel

CharacterPositionsRegion

A CogGraphicCollection that contains interactive CogCompositeShapes for each of the characters. The constituent subshapes depend on the bits enabled.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record.

Table 50. CogOCVTool Last Run Record Keys
Record KeyContentTypeCogOCVLastRunRecordConstants and CogOCVLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    PatternPosition Graphic

PatternPosition

A CogCoordinateAxes that indicates the found pattern origin.

    CompositeResultGraphics Graphics Collection

ResultsOrigin

ResultsMatchRegion

ResultsCoordinateAxes

ResultsLabel

A CogGraphicCollection that contains CogCompositeShapes for each of the found characters. The constituent subshapes depend on the bits enabled.

CogPDF417Tool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 51. CogPDF417Tool Current Record Keys
Record KeyContentTypeCogPDF417CurrentRecordConstants
InputImage ImageInputImage
    Region Graphic

Region

An interactive shape that depicts the Region of the image.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 52. CogPDF417Tool Last Run Record Keys
Record KeyContentTypeCogPDF417LastRunRecordConstants and CogPDF417LastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
TransformedRegionImage Image

TransformedRegionImage

InputImage after an affine transform if RegionMode is CogRegionModeConstants.

CogPMAlignTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Current Record are references to the actual masks and regions used in the tool.

Table 53. CogPMAlignTool Current Record Keys
Record KeyContentTypeCogPMAlignCurrentRecordConstants
InputImage ImageInputImage
    SearchRegion GraphicSearchRegion
    SearchImageMask Graphic

SearchImageMask

A CogMaskGraphic that contains a reference to the actual SearchImageMask.

TrainImage ImageTrainImage
    TrainRegion Graphic

TrainRegion

Contains a reference to the actual TrainRegion.

    PatternOrigin Graphic

PatternOrigin

An interactive CogCoordinateAxes that contains a reference to the pattern's actual Origin.

    FeaturesCoarse Graphics Collection

PatternFeaturesCoarse

This record is delay constructed and created by calling CreateGraphicsCoarse.

    FeaturesFine Graphics Collection

PatternFeaturesFine

This record is delay constructed and created by calling CreateGraphicsFine.

    TrainImageMask Graphic

TrainImageMask

A CogMaskGraphic that contains a reference to the actual TrainImageMask.

    TrainShapeModels Graphics Collection

TrainShapeModels

A CogGraphicCollection of CogShapeModels used to train the pattern.

TrainedPatternImage Image

TrainedPatternImage

This record and its subrecord are delay constructed by calling GetTrainedPatternImage.

If the selected space of the TrainImage is #, the selected space of all of the graphics in the subrecords of TrainedPatternImage is "_TrainImage#"

    TrainedPatternRegion Graphic

TrainedPatternRegion

Contains a noninteractive deep copy of the TrainRegion.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A noninteractive CogCoordinateAxes that represents the pattern's Origin.

    FeaturesCoarse or

    TrainedPatternFeaturesCoarse
Graphics Collection

TrainedPatternFeaturesCoarse

If the selected space of the TrainImage is #, the tool creates the TrainedPatternFeaturesCoarse subrecord. Otherwise it creates the FeaturesCoarse subrecord which is identical to the subrecord of the TrainImage record.

    FeaturesFine or

    TrainedPatternFeaturesFine
Graphics Collection

TrainedPatternFeaturesFine

If the selected space of the TrainImage is #, the tool creates the TrainedPatternFeaturesFine subrecord. Otherwise it creates the FeaturesFine subrecord which is identical to the subrecord of the TrainImage record.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A noninteractive deep copy of the TrainImageMask.

    TrainedPatternShapeModels Graphics Collection

TrainedPatternShapeModels

A CogGraphicCollection of CogShapeModels that are within the pixel aligned bounding box of the train region used to train the pattern.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

The CompositeResultGraphic subrecord is delay constructed and are created by CreateResultGraphics. The GraphicOptions parameter is specified by ORing the constants that begin with CogPMAlignLastRunRecordConstants.

Table 54. CogPMAlignTool Last Run Record Keys
Record KeyContentTypeCogPMAlignLastRunRecordConstants and CogPMAlignLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    SearchRegion GraphicSearchRegion
    CompositeResultGraphics Graphics CollectionResultsOrigin

ResultsBoundingBox

ResultsMatchRegion

ResultsCoordinateAxes

ResultsMatchShapeModels
    SearchImageMask Graphic

SearchImageMask

A CogMaskGraphic that contains a reference to a deep copy of the actual SearchImageMask.

TrainImage Image

TrainImageDeepCopy

Contains a deep copy of the TrainImage.

    TrainRegion Graphic

TrainRegion

Contains a deep copy of the TrainRegion.

    PatternOrigin Graphic

PatternOrigin

A noninteractive CogCoordinateAxes that represents the pattern's Origin.

    FeaturesCoarse Graphics Collection

PatternFeaturesCoarse

This records is delay constructed and created by calling CreateGraphicsCoarse.

    FeaturesFine Graphics Collection

PatternFeaturesFine

This records is delay constructed and created by calling CreateGraphicsFine.

    TrainImageMask Graphic

TrainImageMask

A CogMaskGraphic that contains a reference to a copy of the TrainImageMask.

    TrainShapeModels Graphics Collection

TrainShapeModels

A CogGraphicCollection of CogShapeModels used to train the pattern.

TrainedPatternImage Image

TrainedPatternImage

This record and its subrecord are delay constructed by calling GetTrainedPatternImage.

If the selected space of the TrainImage is #, the selected space of all of the graphics in the subrecords of TrainedPatternImage is "_TrainImage#"

    TrainedPatternRegion Graphic

TrainedPatternRegion

Contains a noninteractive deep copy of the TrainRegion.

If the selected space of the TrainImage is not #, the TrainedPatternRegion and TrainRegion records are identical.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A noninteractive CogCoordinateAxes that represents the pattern's Origin.

If the selected space of the TrainImage is not #, the TrainedPatternOrigin and PatternOrigin records are identical.

    TrainedPatternFeaturesCoarse Graphics Collection

TrainedPatternFeaturesCoarse

If the selected space of the TrainImage is not #, the TrainedPatternFeaturesCoarse and FeaturesCoarse records are identical.

    TrainedPatternFeaturesFine Graphics Collection

TrainedPatternFeaturesFine

If the selected space of the TrainImage is not #, the TrainedPatternFeaturesFine and FeaturesFine records are identical.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the TrainedPatternImageMask. This graphic is obtained by calling GetTrainedPatternImageMask.

    TrainedPatternShapeModels Graphics Collection

TrainedPatternShapeModels

A CogGraphicCollection of CogShapeModels that are within the pixel aligned bounding box of the train region used to train the pattern.

CogPatInspectTool Record Keys

This section contains the following subsections.

CurrentRecord Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The masks and regions in the Current Record are references to the actual masks and regions used in the tool.

Table 55. CogPatInspectTool Current Record Keys
Record KeyContentTypeCogPatInspectCurrentRecordConstants
InputImage ImageInputImage
    Pose Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Region Graphic

Region

A shape that represents the TrainRegion.

TrainImage ImageTrainImage
    PatternOrigin Graphic

PatternOrigin

A noninteractive CogCoordinateAxes that represents the pattern's Origin.

    TrainRegion Graphic

TrainRegion

Contains a reference to the actual TrainRegion.

    TrainImageMask Graphic

TrainImageMask

A CogMaskGraphic that contains a reference to the actual TrainImageMask.

TrainedPatternImage Image

TrainedPatternImage

This record is delay constructed by calling GetTrainedPatternImage.

    TrainedPatternRegion Graphic

TrainedPatternRegion

A shape that represents the TrainRegion on the GetTrainedPatternImage.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A CogCoordinateAxes that represents the pattern's Origin on the GetTrainedPatternImage.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the GetTrainedPatternImageMask on the GetTrainedPatternImage.

TrainedThresholdImage Image

TrainedThresholdImage

This record is delay constructed by calling GetTrainedThresholdImage.

    TrainedPatternRegion Graphic

TrainedPatternRegion

A shape that represents the TrainRegion on the GetTrainedThresholdImage.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A CogCoordinateAxes that represents the pattern's Origin on the GetTrainedThresholdImage.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the GetTrainedPatternImageMask on the GetTrainedThresholdImage.

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

If the selected space name of the InputImage is #, the Region and Pose subrecords of the DifferenceImage... and MatchImage... records are named Region# and Pose#.

The masks and regions in the Last Run Record are deep copies of the masks and regions used in the tool.

Table 56. CogPatInspectTool Last Run Record Keys
Record KeyContentTypeCogPatInspectLastRunRecordConstants and CogPatInspectLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region Graphic

Region

A shape that represents the TrainRegion.

    Pose Graphic

Pose

A CogCoordinateAxes that represents the Pose.

DifferenceImageAbsolute Image

DifferenceImages

This record is created only if DifferenceImages property includes CogPatInspectDifferenceImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

DifferenceImageBrighter Image

DifferenceImages

This record is created only if DifferenceImages property includes CogPatInspectDifferenceImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

DifferenceImageDarker Image

DifferenceImages

This record is created only if DifferenceImages property includes CogPatInspectDifferenceImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

DifferenceImageRawAbsolute Image

DifferenceImagesRaw

This record is created only if DifferenceImagesRaw property includes CogPatInspectDifferenceImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

DifferenceImageRawBrighter Image

DifferenceImagesRaw

This record is created only if DifferenceImagesRaw property includes CogPatInspectDifferenceImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

DifferenceImageRawDarker Image

DifferenceImagesRaw

This record is created only if DifferenceImagesRaw property includes CogPatInspectDifferenceImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

MatchImage Image

MatchImages

This record is created only if MatchImages property includes CogPatInspectMatchImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    DifferenceImagesAsGraphic Graphic

DifferenceImagesAsGraphic

A CogMaskGraphic that represents the thresholded difference images over the match images. The color of each pixel indicates the magnitude of the grey scale difference: cyan (magnitude = 1) to red (magnitude >= 20).

    DifferenceImagesRawAsGraphic Graphic

DifferenceImagesRawAsGraphic

A CogMaskGraphic that represents the raw (unthresholded) difference images over the match images. The color of each pixel indicates the magnitude of the grey scale difference: cyan (magnitude = 1) to red (magnitude >= 20).

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

MatchImageNormalized Image

MatchImages

This record is created only if MatchImages property includes CogPatInspectMatchImageConstants

    Region or

    Region#

Graphic

Region

A shape that represents the TrainRegion.

    Pose or

    Pose#

Graphic

Pose

A CogCoordinateAxes that represents the Pose.

    DifferenceImagesAsGraphic Graphic

DifferenceImagesAsGraphic

A CogMaskGraphic that represents the thresholded difference images over the match images. The color of each pixel indicates the magnitude of the grey scale difference: cyan (magnitude = 1) to red (magnitude >= 20).

    DifferenceImagesRawAsGraphic Graphic

DifferenceImagesRawAsGraphic

A CogMaskGraphic that represents the raw (unthresholded) difference images over the match images. The color of each pixel indicates the magnitude of the grey scale difference: cyan (magnitude = 1) to red (magnitude >= 20).

    Mask Graphic

Mask

A CogMaskGraphic that represents the pattern's mask.

    ClippedMask Graphic

ClippedMask

A CogMaskGraphic that represents the clipped mask.

TrainImage Image

TrainImageDeepCopy

Contains a deep copy of the TrainImage.

    PatternOrigin Graphic

PatternOrigin

An CogCoordinateAxes that represents the pattern's Origin.

    TrainRegion Graphic

TrainRegion

A deep copy of the TrainRegion.

    TrainImageMask Graphic

TrainImageMask

A CogMaskGraphic that is a deep copy of the TrainImageMask.

TrainedPatternImage Image

TrainedPatternImage

This record is delay constructed by calling GetTrainedPatternImage.

If the selected space of the TrainImage is #, the selected space of TrainedPatternRegion and TrainedPatternOrigin is "_TrainImage#".

    TrainedPatternRegion Graphic

TrainedPatternRegion

Contains a noninteractive deep copy of the TrainRegion.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A noninteractive CogCoordinateAxes that represents the pattern's Origin.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the TrainedPatternImageMask. This graphic is obtained by calling GetTrainedPatternImageMask.

TrainedThresholdImage Image

TrainedThresholdImage

This record is delay constructed by calling GetTrainedThresholdImage.

    TrainedPatternRegion Graphic

TrainedPatternRegion

A shape that represents the TrainRegion on the GetTrainedThresholdImage.

    TrainedPatternOrigin Graphic

TrainedPatternOrigin

A CogCoordinateAxes that represents the pattern's Origin on the GetTrainedThresholdImage.

    TrainedPatternImageMask Graphic

TrainedPatternImageMask

A CogMaskGraphic that represents the GetTrainedPatternImageMask on the GetTrainedThresholdImage.

CogPolarUnwrapTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 57. CogPolarUnwrapTool Current Record Keys
Record KeyContentTypeCogPolarUnwrapCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 58. CogPolarUnwrapTool Last Run Record Keys
Record KeyContentTypeCogPolarUnwrapLastRunRecordConstants and CogPolarUnwrapLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
OutputImage ImageOutputImage

CogSobelEdgeTool Record Keys

This section contains the following subsections.

Current Record Keys

Use CurrentRecordEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateCurrentRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Current Record are the interactive regions used in the tool.

Table 59. CogSobelEdgeTool Current Record Keys
Record KeyContentTypeCogSobelEdgeCurrentRecordConstants
InputImage ImageInputImage
    Region GraphicRegion

Last Run Record Keys

Use LastRunRecordEnable and LastRunRecordDiagEnable to specify which records the tool generates. The default settings appear in bold in the following table. Use CreateLastRunRecord to create the records.

Note: You cannot obtain a subrecord unless you enable its parent record. For example, you cannot get a region record without enabling its parent image record.

The regions in the Last Run Record are deep copies of the regions used in the tool.

Table 60. CogSobelEdgeTool Last Run Record Keys
Record KeyContentTypeCogSobelEdgeLastRunRecordConstants and CogSobelEdgeLastRunRecordDiagConstants
InputImage ImageInputImageByReference or

InputImageDeepCopy
    Region GraphicRegion
EdgeAngleImage ImageEdgeAngleImage
EdgeMagnitudeImage ImageEdgeMagnitudeImage
FinalMagnitudeImage ImageFinalMagnitudeImage
TransformedRegionPixels Image

TransformedRegionPixels

InputImage after an affine transform if RegionMode is CogRegionModeConstants.