ModelOrgX Property

Applies To
Vision Objects: Correlation, Geometric

Description
A model has a fixed reference point by which a location of the model in the image is indicated. This point is referred to as the model origin. The ModelOrgX property contains the X coordinate value of the model origin.

Usage

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

Real variable that will contain the value of the property.

value

Real number or expression for the new value of the property.

Values
The ModelOrgX property can be set from 0 to "search window width - 1." It should be noted that the ModelOrgX defines the X coordinate of the model origin with respect to the model's upper left corner.

Default: The model origin is set in the center of the model window when a new object is created.

Remarks
The model origin can be set anywhere within the model window Region. The origin's coordinates define the model origin relative to the model's upper left corner, that is, relative to the location of element [0][0] of the image that defines the model.

When a new Correlation is created, the model origin is set to the center of the model window. However, the user may modify this position by entering new X and Y positions to the ModelOrgX and ModelOrgY properties or by simply clicking on the model origin (the crosshair shown in the middle of the model window) and moving it to the desired position.

The model origin also can be automatically changed by setting the ModelOrgAutoCenter property to “True”. If the ModelOrgAutoCenter property is set to “True” then the model origin is automatically set to the center of the model window.

If the ModelOrgAutoCenter property is set to “True”, the ModelOrgX property cannot be used to reposition the model origin.

See Also
Anatomy of a Vision Object, Correlation Object, Geometric Object, ModelOrgAutoCenter Property, ModelOrgFindCenter Property, ModelOrgY Property