added comments to sample code + added hover sample

Author: ritamerkl

Assets/Samples/MouseEvents/OnMouseEventSample.cs renamed to Assets/Samples/MouseEvents/OnMouseEventDragSample.cs

@@ -4,11 +4,16 @@
 using UnityEngine.InputSystem.EnhancedTouch;
 using Touch = UnityEngine.InputSystem.EnhancedTouch.Touch;
 
-public class OnMouseEventSample : MonoBehaviour
+public class OnMouseEventDragSample : MonoBehaviour
 {
     private Vector3 screenPoint;
     private Vector3 offset;
 
+    private Vector3 startPosition;
+    private bool wasDragging => Vector3.Distance(startPosition, transform.position) > 0.01f;
+    private bool selected;
+
+    // This logic starts the drag operation and safes the offset of the object position to the cursor position, to preserve the relative position.
     void OnMouseDown()
     {
         if (Pointer.current == null)
@@ -18,8 +23,10 @@ void OnMouseDown()
         float x = Pointer.current.position.x.value;
         float y = Pointer.current.position.y.value;
         offset = gameObject.transform.position - Camera.main.ScreenToWorldPoint(new Vector3(x, y, screenPoint.z));
+        startPosition = transform.position;
     }
 
+    // This logic allows dragging the object.
     void OnMouseDrag()
     {
         if (Pointer.current == null)
@@ -29,4 +36,14 @@ void OnMouseDrag()
         Vector3 curPosition = Camera.main.ScreenToWorldPoint(curScreenPoint) + offset;
         transform.position = curPosition;
     }
+
+    // This can be used to select objects. This logic allows dragging without selection.
+    private void OnMouseUp()
+    {
+        if (wasDragging)
+            return;
+
+        selected = !selected;
+        gameObject.GetComponent<Renderer>().material.SetColor("_Color", !selected ? Color.blue : Color.white);
+    }
 }

Assets/Samples/MouseEvents/OnMouseEventSample.cs.meta renamed to Assets/Samples/MouseEvents/OnMouseEventDragSample.cs.meta

@@ -216,6 +216,131 @@ Transform:
   m_Children: []
   m_Father: {fileID: 0}
   m_LocalEulerAnglesHint: {x: 50, y: -30, z: 0}
+--- !u!1 &755211103
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 755211108}
+  - component: {fileID: 755211107}
+  - component: {fileID: 755211106}
+  - component: {fileID: 755211105}
+  - component: {fileID: 755211104}
+  m_Layer: 0
+  m_Name: HoverObject
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!114 &755211104
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 755211103}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: dfa3000288be14ff2b00dd409f1298c7, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::OnMouseHoverSample
+--- !u!65 &755211105
+BoxCollider:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 755211103}
+  m_Material: {fileID: 0}
+  m_IncludeLayers:
+    serializedVersion: 2
+    m_Bits: 0
+  m_ExcludeLayers:
+    serializedVersion: 2
+    m_Bits: 0
+  m_LayerOverridePriority: 0
+  m_IsTrigger: 0
+  m_ProvidesContacts: 0
+  m_Enabled: 1
+  serializedVersion: 3
+  m_Size: {x: 1, y: 1, z: 1}
+  m_Center: {x: 0, y: 0, z: 0}
+--- !u!23 &755211106
+MeshRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 755211103}
+  m_Enabled: 1
+  m_CastShadows: 1
+  m_ReceiveShadows: 1
+  m_DynamicOccludee: 1
+  m_StaticShadowCaster: 0
+  m_MotionVectors: 1
+  m_LightProbeUsage: 1
+  m_ReflectionProbeUsage: 1
+  m_RayTracingMode: 2
+  m_RayTraceProcedural: 0
+  m_RayTracingAccelStructBuildFlagsOverride: 0
+  m_RayTracingAccelStructBuildFlags: 1
+  m_SmallMeshCulling: 1
+  m_ForceMeshLod: -1
+  m_MeshLodSelectionBias: 0
+  m_RenderingLayerMask: 1
+  m_RendererPriority: 0
+  m_Materials:
+  - {fileID: 10303, guid: 0000000000000000f000000000000000, type: 0}
+  m_StaticBatchInfo:
+    firstSubMesh: 0
+    subMeshCount: 0
+  m_StaticBatchRoot: {fileID: 0}
+  m_ProbeAnchor: {fileID: 0}
+  m_LightProbeVolumeOverride: {fileID: 0}
+  m_ScaleInLightmap: 1
+  m_ReceiveGI: 1
+  m_PreserveUVs: 0
+  m_IgnoreNormalsForChartDetection: 0
+  m_ImportantGI: 0
+  m_StitchLightmapSeams: 1
+  m_SelectedEditorRenderState: 3
+  m_MinimumChartSize: 4
+  m_AutoUVMaxDistance: 0.5
+  m_AutoUVMaxAngle: 89
+  m_LightmapParameters: {fileID: 0}
+  m_GlobalIlluminationMeshLod: 0
+  m_SortingLayerID: 0
+  m_SortingLayer: 0
+  m_SortingOrder: 0
+  m_MaskInteraction: 0
+  m_AdditionalVertexStreams: {fileID: 0}
+--- !u!33 &755211107
+MeshFilter:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 755211103}
+  m_Mesh: {fileID: 10202, guid: 0000000000000000e000000000000000, type: 0}
+--- !u!4 &755211108
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 755211103}
+  serializedVersion: 2
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 577.55, y: 14, z: 2876.7}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
 --- !u!1 &1370017262
 GameObject:
   m_ObjectHideFlags: 0
@@ -316,6 +441,7 @@ MeshRenderer:
   m_SortingLayerID: 0
   m_SortingLayer: 0
   m_SortingOrder: 0
+  m_MaskInteraction: 0
   m_AdditionalVertexStreams: {fileID: 0}
 --- !u!33 &1370017266
 MeshFilter:
@@ -334,7 +460,7 @@ Transform:
   m_GameObject: {fileID: 1370017262}
   serializedVersion: 2
   m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
-  m_LocalPosition: {x: 574.96, y: 14, z: 2876.7}
+  m_LocalPosition: {x: 571.24, y: 14, z: 2876.7}
   m_LocalScale: {x: 1, y: 1, z: 1}
   m_ConstrainProportionsScale: 0
   m_Children: []
@@ -439,3 +565,4 @@ SceneRoots:
   - {fileID: 696383077}
   - {fileID: 2103964653}
   - {fileID: 1370017267}
+  - {fileID: 755211108}

Assets/Samples/MouseEvents/OnMouseEventsTestScene.unity

@@ -0,0 +1,38 @@
+using System;
+using UnityEngine;
+
+public class OnMouseHoverSample : MonoBehaviour
+{
+    private bool selected;
+
+    // This can be used to select objects.
+    private void OnMouseUpAsButton()
+    {
+        selected = !selected;
+        gameObject.GetComponent<Renderer>().material.SetColor("_Color", selected ? Color.blue : Color.white);
+    }
+
+    // Highlight the object when the cursor is over it.
+    private void OnMouseEnter()
+    {
+        if (selected)
+            return;
+        gameObject.GetComponent<Renderer>().material.SetColor("_Color", Color.green);
+    }
+
+    // Set back to a normal state.
+    private void OnMouseExit()
+    {
+        if (selected)
+            return;
+        gameObject.GetComponent<Renderer>().material.SetColor("_Color", Color.white);
+    }
+
+    // This allows highlighting the object right after deselection, where the cursor is over the object.
+    private void OnMouseOver()
+    {
+        if (selected)
+            return;
+        gameObject.GetComponent<Renderer>().material.SetColor("_Color", Color.green);
+    }
+}