PointType Property

Applies To
Vision Object: Point

Description
Sets / returns the type of a point.

Usage

VGet  Sequence.Object.PointType, var
VSet  Sequence.Object.PointType, 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

Integer variable that will contain the value of the property.

value

Integer value or expression for the new value of the property.

Values

• 0 - Screen
  • Vision constant: VISION_POINTTYPE_SCREEN
  • Sets the Point object's position to be based upon the position on the screen
• 1 - MidPoint
  • Vision constant: VISION_POINTTYPE_MIDPOINT
  • Sets the Point object's position to be based upon the Midpoint of the Line object selected as LineObject1 for this Point.
• 2 - Intersection
  • Vision constant: VISION_POINTTYPE_INTERSECTION
  • Sets the Point objects position to be based upon the point were 2 lines intersect as defined by LineObject1 and LineObject2 for this point.

Default: 0 - Screen

Remarks
Point objects are useful to define the midpoint or intersection point of a line or lines. This is their primary purpose. The PointType property is used to define the what the position for a Point object will be based upon. As mentioned before there are 3 choices.

• 0 - Screen: This is the default value for a Point object when it is first created. This type is useful when you want to specify a static point in the image or in a frame.
• 1 - MidPoint: A point position can be set to coincide with the midpoint of the line defined by the LineObject1 property. If the LineObject1 property does not specify a line, then an error will occur if you try to set the PointType to 1-MidPoint informing you that LineObject1 does not exist. (i.e. you cannot define a point as the midpoint of a non-existent line.)
• 2 - Intersection: A point position can be set to coincide with the intersection of 2 lines defined by the LineObject1 and LineObject2 Properties. If the either the LineObject1 or LineObject2 property does not specify a Line then an error dialog will appear if you try to set the PointType to 2-Intersection informing you that one of the 2 lines required to form an intersection does not exist.
  The intersection of 2 lines does not have to appear directly between the starting and ending points for the lines. The intersection could occur somewhere along the imaginary extension of either or both lines.

See Also
LineObject1 Property, LineObject2 Property, Point Object