CogPolarUnwrap GetInputPointFromOutputPoint Method Cognex VisionPro 9.23
Maps a point in the root space of the output image to the corresponding point in the selected space of the input image.

Namespace: Cognex.VisionPro.ImageProcessing
Assembly: Cognex.VisionPro.ImageProcessing (in Cognex.VisionPro.ImageProcessing.dll) Version: 91.0.0.0
Syntax

public void GetInputPointFromOutputPoint(
	ICogImage inputImage,
	ICogRegion annularRegion,
	double outputPointX,
	double outputPointY,
	out double inputPointX,
	out double inputPointY
)

Parameters

inputImage
Type: Cognex.VisionPro ICogImage

The input image. Corresponds to the InputImage property.

annularRegion
Type: Cognex.VisionPro ICogRegion

The input region. Corresponds to the Region property.

outputPointX
Type: System Double

The x-coordinate of the mapped point.

outputPointY
Type: System Double

The y-coordinate of the mapped point.

inputPointX
Type: System Double 

The x-coordinate of the point to map.

inputPointY
Type: System Double 

The y-coordinate of the point to map.

Exceptions

ExceptionCondition
NullReferenceException

inputPointX or inputPointY is NULL. (C++ only)

CogOperatorNoInputImageException

inputImage is NULL.

CogImageBadTypeException

inputImage is not an 8-bit image.

CogImageNoPixelsException

inputImage is not allocated.

CogIPPolarUnwrapNullRegionException

annularRegion is NULL.

CogIPPolarUnwrapInvalidRegionException

annularRegion is neither a CogCircularAnnulusSection nor a CogEllipticalAnnulusSection.

CogTransformNotLinearException

The transform from the selected space of the annularRegion to the pixel space of inputImage is not linear.

CogIPPolarUnwrapRegionClippedException

Some of the sampling points require data that is outside the inputImage.

CogImageBadSelectedSpaceNameException

The selected space name of inputImage is not a valid name.

CogImageBadSelectedSpaceNameException

The selected space name of inputImage does not exist within inputImage's space tree.

CogImageBadSelectedSpaceNameException

The selected space name of inputImage is not unique within inputImage's space tree.

CogOperatorInvalidRegionException

The selected space name of annularRegion is not a valid name.

CogOperatorInvalidRegionException

The selected space name of annularRegion does not exist within inputImage's space tree.

CogOperatorInvalidRegionException

The selected space name of annularRegion is not unique within inputImage's space tree.

CogIPPolarUnwrapSamplingXOverflowException

The resulting number of samples in the x-direction is greater than 32767.

CogIPPolarUnwrapSamplingYOverflowException

The resulting number of samples in the y-direction is greater than 32767.

Remarks

Maps a point in the root space of the output image to the corresponding point in the selected space of the input image.

This function maps the points based on the input parameters you supply to the function, not the parameters that you used to configure the object. You can perform a mapping that corresponds to the current state of the object by supplying the object properties as parameters to this function, as shown in the example.

Examples

Imports Cognex.VisionPro
Imports Cognex.VisionPro.ImageProcessing

Dim UnwrapTool As New CogPolarUnwrapTool

Dim xIn As Integer
Dim yIn As Integer
Dim xOut As Integer
Dim yOut As Integer

UnwrapTool.RunParams.GetInputPointFromOutputPoint (_
    UnwrapTool.InputImage, _
    UnwrapTool.Region, _
    xOut, yOut, _
    xIn, yIn)
using Cognex.VisionPro;
using Cognex.VisionPro.ImageProcessing;

CogPolarUnwrapTool UnwrapTool = new CogPolarUnwrapTool();
int xIn, yIn, xOut, yOut;

UnwrapTool.RunParams.GetInputPointFromOutputPoint (UnwrapTool.InputImage,
    UnwrapTool.Region,
    xOut, yOut,
    out xIn, out yIn);
See Also