YAxisPoint Property

Applies To
Vision Objects: Frame

Description
Defines the vision object to be used as the Y axis point for a Frame object.

Usage

VGet  Sequence.Object.YAxisPoint, var
VSet  Sequence.Object.YAxisPoint, value
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
String variable that will contain the value of the property.
value
Integer value or expression for the new value of the property. Valid vision objects for the YAxisPoint property are: Blob, Correlation and Edge objects. The YAxisPoint may also be based on the Screen position of the Frame.

Values
Screen or any object that runs prior to the frame and returns PixelX and PixelY results.

Default: Screen

Remarks
When a Frame object is first drag-and-dropped onto the Image display area of the Vision Guide Window, the default YAxisPoint property is set to Screen. Frame objects are normally attached to other Vision objects. This is the purpose of the OriginPoint and YAxisPoint. Through these 2 properties the user can define a frame of reference for other objects to have their position based upon. This capability is useful when specific features can be used to find reference points on a part and then other vision objects can be located on the image with respect to the frame position defined.

The OriginPoint and YAxisPoint properties are used together to define a vision frame which has an origin at the OriginPoint and a Y axis direction defined by the YAxisPoint property.

It is important to note that for each specific vision sequence, only those vision objects which are executed prior to the Frame object in the vision sequence steps will be available to use as an OriginPoint. (The order of the vision object execution can be adjusted from the flow chart.)

When you access from the object window, click the YAxisPoint property Value Field. Then click the arrow and a drop down list will appear showing a list of available vision objects (along with the default value Screen) which can be used to define the Y Axis direction of the Frame. Click one of the choices and the value field will be set accordingly.

When using the property list to set the YAxisPoint property it is important to note that only those objects which are defined prior to the Frame object are displayed in the drop down list. This helps reduce the chances of the user defining an OriginPoint which isn't defined prior to the Frame object.

Vision Guide automatically checks which vision objects can be used as the YAxisPoint and displays only those object names in the drop down list.

See Also
Frame Object, Frame Property, OriginPoint Property