Align my coordinates

A brief summary of World Locking Tools capabilities presented so far is in order.

  1. With drag and drop ease, WLT will provide a coordinate space which is stationary relative to the physical world.
  2. That space can be made optionally persistent, so that physical features around a point in space in this session are the same as the physical features around the point in previous sessions.
  3. The application can opt in to callbacks allowing it to adjust to larger scale tracking corrections. The Adjuster scripts can be used as is or as examples for this.

Having gotten all of those benefits, your application might have a further requirement, to align the coordinate system with physical space at a small number of discrete points.

The usual reason for this is that there is a large virtual feature (or system of objects) in your application which needs to match up at physical features. Because of distortions in tracker space caused by tracker error, this is actually impossible. But an approximation can be made by matching virtual to physical points on a perceptually driven priority. In essence, the pin closest to you matches corresponding point in the physical world best.

In order to do that, the system needs more information from your application. The SpacePin component is the managing object for AlignmentAnchors. The correspondences are made in the form of pairs of virtual and physical poses.

Motivation for SpacePins and their usage are detailed elsewhere in this documentation. There are also samples of their usage both in this repo and in the sibling Samples repo.

See also