__header__
Description
This tool is useful if the parts being inspected come in at different angles
or in a different location in relation to the camera. The
Locate tool will define a calibration (angle and location) for part that is being viewed.

Inputs
Viewer
Optional: the viewer to which to attach the calibration
CalibrationCollection
Optional: the calibration collecion in the Running Object table.
This acts as a global store for the calibration, so accessable from
other tools/seqeunces
Origon
The input geoemetry (usually a point) that acts as the 0,0,0 points
InputRoll
A point: defines the roll to the orgin point
A line: the angel of the line defines the part angle
Numeric: the angle defines in radians
Parameters
Name
The name of the calibation as placed in the calibration colection
ResetViewerCalibration
If set assigns this calibration to the input viewer
TranslationX
TranslationY
Roll
Ouput: returns the current tranlation and roll (in degrees)
RenderStylePoint
defines how the origin is displayed
Calibration
Output: the calibration matrix defined.
RefreshViewer
Example: Setting the angle using two known points
One way to use the locate tool is to find the angle of the part using
two known points on that part. For this example we will use
the correlation tool to find the points.(There are several tools that can
be used to gain these points.)
- Grab the image.
- Use two Correlation tools to locate two different points on the part.
- On the Locate Tool's inputs page if any tools are already listed
right-click and clear them, i.e. if a correlation tool exists in the
inputs page clear it before adding anything to the page.
- On the Locate Tool's inputs page drag the first Correlation tool onto
the Origin , set it to "Points" and set the Index to 1.
Drag the second Correlation tool onto the Geometry, set it to "Points" and
set the Index to 1.
__Footer__