CameraY2 Result

Applies To
Vision Objects: BoxFinder, Line, LineFinder

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

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

Usage

VGet  Sequence.Object.CameraY2[(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 CameraY2 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 CameraY1 and CameraY2 results represent the Y 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. CameraY2 is used to retrieve the Y coordinate for the Corner2 point shown in the diagram below.

The CameraY2 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 CameraY2 result will be an error.

See Also
Angle Result, CameraX1 Result, CameraX2 Result, CameraY1 Result, CameraX3 Result, CameraY3 Result, CameraX4 Result, CameraY4 Result, Line Object, LineFinder Object, PixelX Result, PixelY2 Result, RobotY Result, RobotXYU Result, X1 Property, X2 Property, Y1 Property, Y2 Property, BoxFinder Object