Merge pull request #1 from Microsoft/mrtk_development

getting in latest changes from main branch

Author: thalbern

Assets/MixedRealityToolkit.Examples/Demos/SpatialAwareness/Scripts/DemoSpatialMeshHandler.cs

@@ -12,7 +12,7 @@
 namespace Microsoft.MixedReality.Toolkit.Examples.Demos
 {
     /// <summary>
-    /// This class is an example of the <see cref="IMixedRealitySpatialAwarenessMeshHandler"/> interface. It keeps track
+    /// This class is an example of the <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.SpatialAwarenessSystem.Handlers.IMixedRealitySpatialAwarenessObservationHandler{T}"/> interface. It keeps track
     /// of the IDs of each mesh and tracks the number of updates they have received.
     /// </summary>
     public class DemoSpatialMeshHandler : MonoBehaviour, IMixedRealitySpatialAwarenessObservationHandler<SpatialAwarenessMeshObject>

Assets/MixedRealityToolkit.Examples/toc.yml

@@ -0,0 +1,12 @@
+- name: Demos
+  href: Demos/README.md
+  items:
+  - name: Standard Shader
+    href: Demos/StandardShader/README.md
+- name: SDK
+  href: SDK/README.md
+  items:
+  - name: Basic Introduction
+    href: SDK/Example01-BasicIntroduction/README.md
+- name: Standard Assets
+  href: StandardAssets/README.md

Assets/MixedRealityToolkit.Providers/WindowsMixedReality/WindowsMixedRealitySpatialMeshObserver.cs

@@ -124,15 +124,14 @@ public override void Destroy()
         private GameObject observedObjectParent = null;
 
         /// <summary>
-        /// The <see cref="GameObject"/> to which observed objects are parented.
+        /// The <see cref="UnityEngine.GameObject"/> to which observed objects are parented.
         /// </summary>
-        private GameObject ObservedObjectParent => observedObjectParent ?? (observedObjectParent = SpatialAwarenessSystem?.CreateSpatialAwarenessObjectParent("WindowsMixedRealitySpatialMeshObserver"));
-
+        private GameObject ObservedObjectParent => observedObjectParent != null ? observedObjectParent : (observedObjectParent = SpatialAwarenessSystem?.CreateSpatialAwarenessObjectParent("WindowsMixedRealitySpatialMeshObserver"));
 
         private IMixedRealitySpatialAwarenessSystem spatialAwarenessSystem = null;
 
         /// <summary>
-        /// The currently active instance of <see cref="IMixedRealitySpatialAwarenessSystem"/>.
+        /// The currently active instance of <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.SpatialAwarenessSystem.IMixedRealitySpatialAwarenessSystem"/>.
         /// </summary>
         private IMixedRealitySpatialAwarenessSystem SpatialAwarenessSystem => spatialAwarenessSystem ?? (spatialAwarenessSystem = MixedRealityToolkit.SpatialAwarenessSystem);
 
@@ -248,7 +247,7 @@ public SpatialAwarenessMeshLevelOfDetail LevelOfDetail
 
         /// <inheritdoc />
         public Material VisibleMaterial { get; set; } = null;
-        
+
         /// <inheritdoc/>
         public override void Resume()
         {

Assets/MixedRealityToolkit.SDK/Features/Audio/Influencers/AudioInfluencerController.cs

@@ -10,10 +10,10 @@
 namespace Microsoft.MixedReality.Toolkit.SDK.Audio.Influencers
 {
     /// <summary>
-    /// Class which supports components implementing <see cref="IAudioInfluencer"/> being used with audio sources.
+    /// Class which supports components implementing <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.Audio.IAudioInfluencer"/> being used with audio sources.
     /// </summary>
     /// <remarks>
-    /// AudioInfluencerController requires an <see cref="AudioSource"/> component. If one is not attached, it will be added automatically.
+    /// AudioInfluencerController requires an <see cref="UnityEngine.AudioSource"/> component. If one is not attached, it will be added automatically.
     /// Each sound playing game object needs to have an AudioInfluencerController attached in order to have it's audio influenced.
     /// </remarks>
     [RequireComponent(typeof(AudioSource))]

Assets/MixedRealityToolkit.SDK/Features/Audio/Influencers/AudioOccluder.cs

@@ -8,7 +8,7 @@
 namespace Microsoft.MixedReality.Toolkit.SDK.Audio.Influencers
 {
     /// <summary>
-    /// Class that implements <see cref="IAudioInfluencer"/> to provide an audio occlusion effect, similar
+    /// Class that implements <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.Audio.IAudioInfluencer"/> to provide an audio occlusion effect, similar
     /// to listening to sound from outside of an enclosed space.
     /// </summary>
     /// <remarks>

Assets/MixedRealityToolkit.SDK/Features/Input/Handlers/BaseFocusHandler.cs

@@ -10,7 +10,7 @@
 namespace Microsoft.MixedReality.Toolkit.SDK.Input.Handlers
 {
     /// <summary>
-    /// Base Component for handling Focus on <see cref="GameObject"/>s.
+    /// Base Component for handling Focus on <see cref="UnityEngine.GameObject"/>s.
     /// </summary>
     [RequireComponent(typeof(Collider))]
     public abstract class BaseFocusHandler : MonoBehaviour, IMixedRealityFocusHandler
@@ -20,7 +20,7 @@ public abstract class BaseFocusHandler : MonoBehaviour, IMixedRealityFocusHandle
         private bool focusEnabled = true;
 
         /// <summary>
-        /// Is focus enabled for this <see cref="Component"/>?
+        /// Is focus enabled for this <see cref="UnityEngine.Component"/>?
         /// </summary>
         public virtual bool FocusEnabled
         {
@@ -29,12 +29,12 @@ public virtual bool FocusEnabled
         }
 
         /// <summary>
-        /// Does this object currently have focus by any <see cref="IMixedRealityPointer"/>?
+        /// Does this object currently have focus by any <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.InputSystem.IMixedRealityPointer"/>?
         /// </summary>
         public virtual bool HasFocus => FocusEnabled && Focusers.Count > 0;
 
         /// <summary>
-        /// The list of <see cref="IMixedRealityPointer"/>s that are currently focused on this <see cref="GameObject"/>
+        /// The list of <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.InputSystem.IMixedRealityPointer"/>s that are currently focused on this <see cref="UnityEngine.GameObject"/>
         /// </summary>
         public List<IMixedRealityPointer> Focusers { get; } = new List<IMixedRealityPointer>(0);
 

Assets/MixedRealityToolkit.SDK/Features/Input/Handlers/ControllerPoseSynchronizer.cs

@@ -47,7 +47,7 @@ public bool DestroyOnSourceLost
         public bool IsTracked { get; protected set; } = false;
 
         /// <summary>
-        /// The current tracking state of the assigned <see cref="IMixedRealityController"/>
+        /// The current tracking state of the assigned <see cref="Microsoft.MixedReality.Toolkit.Core.Interfaces.Devices.IMixedRealityController"/>
         /// </summary>
         protected TrackingState TrackingState = TrackingState.NotTracked;
 

Assets/MixedRealityToolkit.SDK/Features/Input/Handlers/DragAndDropHandler.cs

@@ -14,7 +14,7 @@
 namespace Microsoft.MixedReality.Toolkit.SDK.Input.Handlers
 {
     /// <summary>
-    /// Component that allows dragging a <see cref="GameObject"/>.
+    /// Component that allows dragging a <see cref="UnityEngine.GameObject"/>.
     /// Dragging is done by calculating the angular delta and z-delta between the current and previous hand positions,
     /// and then repositioning the object based on that.
     /// </summary>

Assets/MixedRealityToolkit.SDK/Features/Input/Handlers/ManipulationHandler.cs

@@ -2,7 +2,6 @@
 // Licensed under the MIT License. See LICENSE in the project root for license information.
 
 using UnityEngine;
-using System.Linq;
 using UnityEngine.Assertions;
 using Microsoft.MixedReality.Toolkit.SDK.Input.Handlers;
 using Microsoft.MixedReality.Toolkit.Core.EventDatum.Input;
@@ -24,7 +23,7 @@ namespace Microsoft.MixedReality.Toolkit.SDK.UX.Utilities
     /// 
     public class ManipulationHandler : BaseFocusHandler,
         IMixedRealityInputHandler,
-        IMixedRealityInputHandler<MixedRealityPose>, 
+        IMixedRealityInputHandler<MixedRealityPose>,
         IMixedRealitySourceStateHandler
     {
         #region Private Enums
@@ -236,40 +235,32 @@ private void InvokeStateUpdateFunctions(State oldState, State newState)
         #endregion Private Methods
 
         #region Event Handlers From Interfaces
-        /// <summary>
-        /// /// Event Handler receives input from inputSource
-        /// </summary>
+
+        /// <inheritdoc />
         public void OnInputDown(InputEventData eventData)
         {
             gazeHandHelper.AddSource(eventData);
             UpdateStateMachine();
             eventData.Use();
         }
 
-        /// <summary>
-        /// Event Handler receives input from inputSource
-        /// </summary>
+        /// <inheritdoc />
         public void OnInputUp(InputEventData eventData)
         {
             gazeHandHelper.RemoveSource(eventData);
             UpdateStateMachine();
             eventData.Use();
         }
 
-        /// <summary>
-        /// Event Handler receives input from IMixedRealityInputHandler<MixedRealityPose>
-        /// </summary>
-        /// <param name="eventData"></param>
+        /// <inheritdoc />
         public void OnInputChanged(InputEventData<MixedRealityPose> eventData)
         {
             gazeHandHelper.UpdateSource(eventData);
             UpdateStateMachine();
             eventData.Use();
         }
 
-        /// <summary>
-        /// Event Handler when a InputSource is lost- part of IMixedRealitySourceStateHander interface
-        /// </summary>
+        /// <inheritdoc />
         public void OnSourceLost(SourceStateEventData eventData)
         {
             gazeHandHelper.RemoveSource(eventData);

Assets/MixedRealityToolkit.SDK/Features/Input/Handlers/TeleportHotSpot.cs

@@ -11,7 +11,7 @@ namespace Microsoft.MixedReality.Toolkit.SDK.Input.Handlers
 {
     /// <summary>
     /// SDK component handling teleportation to a specific position &amp; orientation when a user focuses
-    /// this <see cref="GameObject"/> and triggers the teleport action.
+    /// this <see cref="UnityEngine.GameObject"/> and triggers the teleport action.
     /// </summary>
     public class TeleportHotSpot : BaseFocusHandler, IMixedRealityTeleportHotSpot
     {