World Locking Tools for Unity

Incremental release of World Locking Tools for Unity

Includes fixes related to:

• Scaling a transform hierarchy containing SpacePins.
• Workaround for ASA startup race condition.
• Update samples to MRTK 2.7.3.
• Improved vehicle sample.

World Locking Tools for Unity

The main feature on this incremental release is better support for putting the camera in a moving frame of reference.

An additional feature is the ability to dynamically name the FrozenWorldEngine state file during a session.

Also included are changes related to the migration of the World Locking Tools documentation to docs.microsoft.com.

Finally, it also includes miscellaneous minor bug fixes related to rare conditions.

World Locking Tools for Unity

Increased anchor stability

Moving the creation point for anchors to the camera position allows higher fidelity and reduces impact of tracking errors.

To help avoid the inconvenience of anchor display (for diagnostics/debugging) at eye level, which can be disconcerting, an option has been added to the AnchorGraphVisual to displace anchor visuals vertically. Positive displacement raises them, negative lowers them. The default value of -1 (meter) puts the anchor visuals at the same height as previously, even though the anchors are now at eye level. A displacement of zero shows actual anchor positions.

Option to preserve gravity vector

Noisy tracking can cause the FrozenWorldEngine to introduce non-zero pitch and roll to the camera, causing a misalignment of the Y-axis to the physical gravity vector. The World Locking Context has a new option, under Camera Transform Links, of "No Pitch And Roll". This will zero out any such spurious pitch and roll introduced, limiting the camera correction to translation and yaw rotation about the horizontal plane.

Fix compatibility issue with ASA v2.11

A workaround for an issue with earlier versions of ASA is not needed with ASA v2.11, and in fact causes incorrect behavior. This has been fixed.

World Locking Tools for Unity

Update the ASA samples to be compatible with latest release of ASA SDK v2.11.0.

Backward compatibility remains for older versions of ASA, but some customers have reported problems with the previous versions.

See #240

World Locking Tools for Unity

Patch release

Compatibility fix for .NET backend (rather than IL2CPP).

Add one frame delay to workaround issue with ASA anchors not being ready when expected.

World Locking Tools for Unity

Patch release

Remove dependency on tuple

Unnecessary dependency on tuple, which can cause version collisions with other libraries, has been removed. No functional change.

Change MR Feature Tool dependency from Unity 2019.4 to Unity 2018.4.

No functional change, the 2019.4 dependency was accidental and artificial.

World Locking Tools for Unity

Patch release

Issues addressed:

• Delay anchor subsystem startup when necessary to give Holographic Remoting a chance to startup.

• Fix issue with Local World Locking feature when using AR Foundation in Unity 2019.

• Fix #define collision in PublisherASA (DebugString undefined).

World Locking Tools for Unity

Patch release

Quiet mode

New ability to globally disable all WLT logging with a single define, WLT_DISABLE_LOGGING. This is best used by setting it globally in Unity's Player Settings / Other Settings / Scripting Define Symbols.

Fixed issues related to new Local World Locking

Problem with anchor creation under AR Foundation.
Problem with anchor visualizations when scene main camera has no parent.

World Locking Tools for Unity

Local only world locking

A new feature is introduced, which allows World Locking Tools to operate solely on one or more subtrees in the Unity scene hierarchy.

While the preferred and recommended configuration is still to apply world locking to the camera, via the AdjustmentFrame node in the camera's parent chain, this new feature allows World Locking Tools to be used in existing applications which, for whatever reason, can't attach the camera to an adjustment node.

All previous World Locking Tools features remain as before.

World Locking Tools for Unity

Minor release adding persistence capability on HoloLens when using AR Foundation

Note that persistence is only implemented via the MR OpenXR Plugin, as the Windows MR XR Plugin seems to be getting phased out. If there is demand, then it should be doable (Unity 2020+ only).