CameraX2 Result

Applies To
Vision Objects: BoxFinder, Line, LineFinder

Description
Line, LineFinder: Returns the end point position (X2) of a Line object in Camera coordinates.

BoxFinder: Returns the X coordinate position (X2) for corner points of rectangles detected in a camera coordinate system.

Usage

VGet  Sequence.Object.CameraX2[(result)], var

Sequence

Name of a sequence or string variable containing a sequence name.

Object

Name of an object or string variable containing an object name. The object must exist in the specified sequence.

var

Real variable that will contain the value of the result.

result

Optional result number. If omitted, the result number is the CurrentResult. Used for objects that return multiple results.

Values
The value returned for the CameraX2 result depends upon the calibration used for the camera. Values are always returned in millimeters.

Remarks
For Line, LineFinder

Every line must have a starting point and ending point. The CameraX1 and CameraX2 results represent the X coordinate position starting (X1,Y1) and endpoints (X2,Y2) of the specified Line object. Since Line object starting and endpoints can be assigned to other vision objects, the (CameraX1, CameraY1) and (CameraX2, CameraY2) coordinate pairs can actually be Camera coordinate positions which match the CameraX and CameraY results for other vision objects. (In other words if a Line object's starting point is defined by a Correlation object, then the (CameraX, CameraY) results from the Correlation object will match the (CameraX1, CameraY1) results for the Line object.)

For BoxFinder

The camera coordinates for the four corners of a rectangle can be retrieved as Camera X1, 2, 3, 4 results and Camera Y1, 2, 3, 4 results. CameraX2 is used to retrieve the X coordinate for the Corner2 point shown in the diagram below.

The CameraX2 result can be calculated only when valid calibration data is set to the Calibration property of the vision sequence. If the calibration has not been completed or the Calibration property has not been set, the CameraX2 result will be an error.

See Also
Angle Result, CameraX1 Result, CameraY1 Result, CameraY2 Result, CameraX3 Result, CameraY3 Result, CameraX4 Result, CameraY4 Result, Line Object, LineFinder Object, PixelX Result, PixelX2 Result, RobotX Result, RobotXYU Result, X1 Property, X2 Property, Y1 Property, Y2 Property, BoxFinder Object