location_object.Inverse Method

Returns the inverse of the “total position” of the Cartesian location_object.

...location_object.Inverse

Prerequisites

The location_object must be a Cartesian Location Object.

Parameters

None

Remarks

This method evaluates the “total position” of the location_object and then inverts the value. As defined in the description of GPL, the “total position” is the combination of the location_object’sPosWrtRef with the “total position” of any reference frame(s) associated with the location_object.

As an example, if the “total position” of the location_object represents the position and orientation of part B with respect to part A, then the Inverse will give the position and orientation of A with respect to B. As another way to think about this operation, if the location_object defines how to get from A to B then the Inverse will define how to get from B to A.

Assuming that the location_object is a Cartesian type, the Inverse method returns a Location Object with the properties in .

 
Property Returned Location Object Value

Type

Cartesian Location

PosWrtRef

Inverse of the “total position” of the location_object

RefFrame

Null

All other properties

Same as location_object

 

Examples

Dim loc1 As New Location          ' Create new Location set to defaults
Dim loc2, loc3 As Location
Dim dy As Double
loc1.XYZ(11, -23, 45, 0, 180, 42) ' Define "position" of loc1
loc2 = loc1.Inverse
loc3 = loc2.Inverse ' loc3 will have same "position" as loc1
dy = loc3.Y ' dy will be equal to -23

See Also

Location Class|location_object.Pos |location_object.Mul |location_object.PosWrtRef