Add Rumble Manager and Demo

.gitignore

@@ -10,3 +10,4 @@
 logs
 Thumbs.db
 android/
+.venv/

addons/godot-xr-tools/editor/icons/rumble.svg.import

@@ -0,0 +1,37 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://dsexrsb8t0vi2"
+path="res://.godot/imported/rumble.svg-104961f6551a931675972887ab17d2bc.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/godot-xr-tools/editor/icons/rumble.svg"
+dest_files=["res://.godot/imported/rumble.svg-104961f6551a931675972887ab17d2bc.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/godot-xr-tools/player/poke/poke.gd

@@ -15,6 +15,12 @@ extends Node3D
 ## Signal emitted when this object pokes another object
 signal pointing_event(event)
 
+## Signal emitted when this object presses another object
+signal pressed(body)
+
+## Signal emitted when this object releases the press on another object
+signal released(body)
+
 
 # Default layer of 18:player-hands
 const DEFAULT_LAYER := 0b0000_0000_0000_0010_0000_0000_0000_0000
@@ -204,6 +210,7 @@ func _on_PokeBody_body_contact_start(body):
 	# Report body pressed
 	target = body
 	last_collided_at = $PokeBody.global_transform.origin
+	pressed.emit(body)
 	XRToolsPointerEvent.entered(self, body, last_collided_at)
 	XRToolsPointerEvent.pressed(self, body, last_collided_at)
 
@@ -219,4 +226,5 @@ func _on_PokeBody_body_contact_end(body):
 	# Report release
 	XRToolsPointerEvent.released(self, target, last_collided_at)
 	XRToolsPointerEvent.exited(self, target, last_collided_at)
+	released.emit(target)
 	target = null

addons/godot-xr-tools/player/poke/poke.tscn

@@ -1,7 +1,9 @@
-[gd_scene load_steps=6 format=3 uid="uid://bjcxf427un2wp"]
+[gd_scene load_steps=8 format=3 uid="uid://bjcxf427un2wp"]
 
 [ext_resource type="Script" path="res://addons/godot-xr-tools/player/poke/poke.gd" id="1"]
 [ext_resource type="Script" path="res://addons/godot-xr-tools/player/poke/poke_body.gd" id="2"]
+[ext_resource type="Script" path="res://addons/godot-xr-tools/rumble/rumbler.gd" id="3_41fwo"]
+[ext_resource type="Resource" uid="uid://brci6umrcd157" path="res://addons/godot-xr-tools/rumble/tap_rumble.tres" id="4_mskmk"]
 
 [sub_resource type="SphereShape3D" id="1"]
 resource_local_to_scene = true
@@ -14,7 +16,7 @@ height = 0.01
 radial_segments = 32
 rings = 16
 
-[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_g1b1h"]
+[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_sbw2a"]
 transparency = 1
 shading_mode = 0
 albedo_color = Color(0.8, 0.8, 1, 0.5)
@@ -34,7 +36,12 @@ shape = SubResource("1")
 
 [node name="MeshInstance" type="MeshInstance3D" parent="PokeBody"]
 mesh = SubResource("2")
-surface_material_override/0 = SubResource("StandardMaterial3D_g1b1h")
+surface_material_override/0 = SubResource("StandardMaterial3D_sbw2a")
 
+[node name="Rumbler" type="Node" parent="."]
+script = ExtResource("3_41fwo")
+event = ExtResource("4_mskmk")
+
+[connection signal="pressed" from="." to="Rumbler" method="rumble_hand"]
 [connection signal="body_contact_end" from="PokeBody" to="." method="_on_PokeBody_body_contact_end"]
 [connection signal="body_contact_start" from="PokeBody" to="." method="_on_PokeBody_body_contact_start"]

addons/godot-xr-tools/plugin.gd

@@ -89,6 +89,14 @@ func _enter_tree():
 			"0.2,0.8,0.05",
 			0.7)
 
+	# Add input haptics_scale to the project settings
+	_define_project_setting(
+			"godot_xr_tools/input/haptics_scale",
+			TYPE_FLOAT,
+			PROPERTY_HINT_RANGE,
+			"0.0,1.0,0.1",
+			1.0)
+
 	# Add input y_axis_dead_zone to the project settings
 	_define_project_setting(
 			"godot_xr_tools/input/y_axis_dead_zone",

addons/godot-xr-tools/rumble/rumble_event.gd

@@ -0,0 +1,19 @@
+@icon("res://addons/godot-xr-tools/editor/icons/rumble.svg")
+class_name XRToolsRumbleEvent
+extends Resource
+
+## XR Tools Rumble Event Resource
+
+## Strength of the rumbling
+@export_range(0, 1, 0.10) var magnitude: float = 0.5
+
+## Whether the rumble can be active during a tree pause
+@export var active_during_pause: bool = false
+
+@export_category("Timing")
+
+## Whether the rumble continues until cleared
+@export var indefinite: bool = false
+
+## Time to rumble (unless indefinite)
+@export_range(10, 4000, 10) var duration_ms: int = 300

addons/godot-xr-tools/rumble/rumble_manager.gd

@@ -0,0 +1,196 @@
+@icon("res://addons/godot-xr-tools/editor/icons/rumble.svg")
+class_name XRToolsRumbleManager
+extends Node
+
+
+## XR Tools Rumble (Controllers) Manager Script
+##
+## This script uses the controller's existing rumble intensity variable,
+## and allows you to rumble the controller for a certain amount
+## of time 'beats'.
+##
+## Example: something hits you while you're mowing the lawn,
+## i.e. a short intense rumble happens during long low rumble.
+
+
+## Name in the OpenXR Action Map for haptics
+const HAPTIC_ACTION = "haptic"
+
+
+## Initial "Wake-Up" Rumble Magnitude
+@export var wakeup_rumble : XRToolsRumbleEvent
+
+# A Queue Per Haptic device (Dictionary<StringName, XRToolsRumbleManagerQueue>)
+var _queues: Dictionary = {}
+
+
+# Keep track of singular instance
+static var _instance: XRToolsRumbleManager
+
+
+## Add support for is_xr_class
+func is_xr_class(name: String) -> bool:
+	return name == "XRToolsRumbleManager"
+
+
+## Get the default Haptics Scale value
+static func get_default_haptics_scale() -> float:
+	var default = 1.0
+
+	# Check if the project has overridden the addon's default
+	if ProjectSettings.has_setting("godot_xr_tools/input/haptics_scale"):
+		default = ProjectSettings.get_setting("godot_xr_tools/input/haptics_scale")
+
+	if default < 0.0 or default > 1.0:
+		# out of bounds? reset to default
+		default = 1.0
+
+	return default
+
+
+## Used to convert gamepad magnitudes to equivalent XR haptic magnitude
+static func combine_magnitudes(weak: float, strong: float) -> float:
+	if strong >= 0.01:
+		return 0.5 + clamp(strong / 2, 0.0, 0.5)
+	return clamp(weak / 2, 0.0, 0.5)
+
+
+# Enforce singleton
+func _enter_tree():
+	if not is_instance_valid(_instance):
+		_instance = self
+	else:
+		self.queue_free()
+
+
+# Clear instance if this is the singleton
+func _exit_tree():
+	if is_instance_valid(_instance) and _instance == self:
+		_instance = null
+
+
+# On Ready
+func _ready():
+	if Engine.is_editor_hint():
+		return
+
+	# Some rumble events are active during pause
+	process_mode = PROCESS_MODE_ALWAYS
+
+	# Create a queues for standard controllers
+	_queues[&"left_hand"] = XRToolsRumbleManagerQueue.new()
+	_queues[&"right_hand"] = XRToolsRumbleManagerQueue.new()
+
+	if wakeup_rumble:
+		_add("wakeup", wakeup_rumble, _queues.keys())
+
+
+# Determine how much to - and perform the - rumbles each tick
+func _process(delta: float) -> void:
+	if Engine.is_editor_hint():
+		return
+
+	# We'll be subtracting this from the event remaining ms
+	var delta_ms = int(delta * 1000)
+
+	for tracker_name in _queues:
+		var haptic_queue : XRToolsRumbleManagerQueue = _queues[tracker_name]
+
+		# default to noXRToolsRumbleManagerQueuensure it's a float, or it rounds to all or nothing!)
+		var magnitude: float = 0.0
+
+		# Iterate over the events
+		for key in haptic_queue.events.keys():
+			var event : XRToolsRumbleEvent = haptic_queue.events[key]
+
+			# if we're paused and it's not supposed to be active, skip
+			if get_tree().paused and not event.active_during_pause:
+				continue
+
+			# If we've passed the threshold from positive to negative, the event is done
+			if !event.indefinite and haptic_queue.time_remaining[key] < 0:
+				_remove(key)
+				continue
+
+			# Reduce the time remaining
+			haptic_queue.time_remaining[key] -= delta_ms
+
+			# If it's of greater magnitude, update left magnitude to be set
+			if event.magnitude > magnitude:
+				magnitude = event.magnitude
+
+		# scale the final magnitude
+		magnitude *= XRToolsUserSettings.haptics_scale
+
+		# Make that tracker rumble
+		if magnitude > 0:
+			XRServer.primary_interface.trigger_haptic_pulse(
+				HAPTIC_ACTION,
+				tracker_name, # if the tracker name isn't valid, it will error but continue
+				0,
+				magnitude * XRToolsUserSettings.haptics_scale,
+				0.1,
+				0)
+
+
+# actually set an event
+func _add(event_key: Variant, event: XRToolsRumbleEvent,
+					targets: Array = [&"left_hand", &"right_hand"]) -> void:
+	if not event_key:
+		push_error("Event key is invalid! ")
+		return
+
+	if not event:
+		_remove(event_key)
+		return
+
+	for target in targets:
+		if target is XRNode3D:
+			target = target.tracker
+
+		# Create queue first time a target is suggested
+		if not _queues.has(target):
+			_queues[target] = XRToolsRumbleManagerQueue.new()
+
+		_queues[target].events[event_key] = event
+		_queues[target].time_remaining[event_key] = event.duration_ms
+
+
+## Adds the event to the list of currently-active rumbles
+static func add(event_key: Variant, event: XRToolsRumbleEvent,
+								targets: Array = [&"left_hand", &"right_hand"]):
+	if is_instance_valid(_instance):
+		#gdlint:ignore = private-method-call
+		_instance._add(event_key, event, targets)
+
+
+# Actually remove an event
+func _remove(event_key: Variant,
+			targets: Array = [&"left_hand", &"right_hand"]) -> void:
+	if event_key == null:
+		return
+
+	for target in targets:
+		if target is XRNode3D:
+			target = target.tracker
+		_queues[target].events.erase(event_key)
+		_queues[target].time_remaining.erase(event_key)
+
+
+# Actually remove an event from all queues
+func _remove_all(event_key: Variant) -> void:
+	_remove(event_key, _instance._queues.keys())
+
+
+## Removes the event from the list of currently-active rumbles
+static func clear(event_key: Variant, targets: Array = [&"left_hand", &"right_hand"]):
+	if is_instance_valid(_instance):
+		#gdlint:ignore = private-method-call
+		_instance._remove(event_key, targets)
+
+
+## Removes the event from the list of currently-active rumbles
+static func clear_all(event_key: Variant):
+	if is_instance_valid(_instance):
+		#gdlint:ignore = private-method-call
+		_instance._remove_all(event_key)

addons/godot-xr-tools/rumble/rumble_manager_queue.gd

@@ -0,0 +1,12 @@
+class_name XRToolsRumbleManagerQueue
+extends Resource
+
+# All currently-active events (Dictionary<Variant, XRToolsRumbleEvent>)
+var events: Dictionary
+
+# All currently-active events' time remaining (Dictionary<Variant, int>)
+var time_remaining: Dictionary
+
+func _init():
+	events = {}
+	time_remaining = {}