Location.Here3 Method

location_object.Here3 Method

Defines the "total position" of a Location Object based upon the XYZ coordinates of three specified Locations.

location_object.Here3(location_0, location_x, location_y)

Prerequisites

location_0, location_x and location_y must be Cartesian Location Objects.

Parameters

location_0

A required Cartesian Location Object or a method or property that returns a Cartesian Location Object value.

location_x

A required Cartesian Location Object or a method or property that returns a Cartesian Location Object value.

location_y

A required Cartesian Location Object or a method or property that returns a Cartesian Location Object value.

Remarks

This method is utilized for setting the "total position" of location_object based upon the XYZ position coordinates of three Locations. This is convenient if you wish to define the orientation and position of a Location or reference frame by teaching three Locations.

The total position of the location_object is computed as follows:

The XYZ coordinates of the location_object are set equal to the XYZ coordinates of the total position of location_0. That is, the XYZ coordinates of location_0 define the 0,0,0 position of the coordinate system defined by the new value of location_object.
The direction of the x-axis of location_object is defined to be parallel to the vector from the XYZ coordinate of location_0 to the XYZ coordinate of location_x. That is, if the XYZ position of location_0 is equivalent to the 0,0,0 position of the coordinate frame defined by the new value of location_object, then the XYZ position of location_x will be a point on the x-axis of the coordinate system defined by the new value of location_object.
The XY plane of the new location_object value is defined by the XYZ coordinates of location_0, location_x, and location_y. Normally, location_y is defined such that its XYZ position will be a point on the y-axis of the coordinate system defined by the new value of location_object.

At the completion of this method, the PosWrtRef value of the location_object will be set such that the total position of location_object corresponds to the position and orientation defined by three points represented by the three Location arguments. Also, as a convenience, the Type of the location_object is always set to indicate it is a Cartesian Location Object.

Examples

Dim loc1 As New Location    ' Define position of this Location
Dim loc0 As New Location
Dim locx As New Location
Dim locy As New Location
loc0.XYZ(10,20,30)          ' Define 0,0,0
locx.XYZ(10,25,30)          ' Define point on X-axis
locy.XYZ(5,20,30)           ' Define point on Y-axis
loc1.Here3(loc0,locx,locy)  ' Will define loc1 to same as
                            ' loc1.XYZ(10,20,30,0,0,90)