enhancement: description comments for Inspector exports

.gitignore

@@ -1,3 +1,4 @@
 # Godot 4+ specific ignores
 .godot/
 /android/
+.vscode/

README.md

@@ -1,2 +1,4 @@
 # tween-scroll-test
+Simple test of how to create a scrollable/draggable menu similar to Arknights' IS map and many other draggable menus within the game (Operators, Moments, etc.)
 
+Godot 4.5

src/empty_space_thing.gd

@@ -1,70 +1,116 @@
 extends Control
+# INFO name can be anything, doesn't need to be "SpaceNode"
 class_name SpaceNode
 
-var initial_pos: Vector2
-var offset: Vector2
+# adapted from pc_tile code (project-elysium-main)
 var draggable: bool = false
 var velocity: float = 0
 
+# variables for velocity calculation
 var mouse_first_location: Vector2
+var mouse_last_location: Vector2
 var mouse_release_location: Vector2
+var mouse_n_minus_one_location: Vector2
 var time_since_first_location: float = -1
 
-@export var velocity_coeffecient: int = 500
-@export var max_x: int = 1000
+# Export variables, for ease of setting without going into the code
+## adjusts how much velocity you want to have on a slide, a higher number = less velocity
+@export var velocity_coeffecient: int = 500 
+## the maximum displacement of the item, to the right
+@export var max_x: int = 1000 
+## the minimum displacement, can be adjusted to accomodate margins
 @export var min_x: int = 0
-@export var ease_out_time: float = 0.5
+## ease out time for the velocity curve
+@export var ease_out_time: float = 0.5 
+## whether you want the UI to bounce
+@export var bounce: bool = false 
 
 func _ready() -> void:
 	draggable = true
 	return
 	
 func _process(delta: float) -> void:
+	# Every frame, update the position based upon the velocity
+	# setting
 	global_position.x += velocity
 	
+	# if the current item is being dragged
 	if draggable:
+		# when the item is first clicked
 		if (Input.is_action_just_pressed("click")):
 			mouse_first_location = get_global_mouse_position()
-			time_since_first_location = 0
 		
+		# basically a "while" the click is held
 		if Input.is_action_pressed("click"):
-			time_since_first_location += delta
+			# update the mouse location
+			mouse_first_location = get_global_mouse_position()
+			# then update global position, for mouse tracking
+			# this is based upon the last location the mouse was, subtracked by the current
+			# location
+			global_position.x += -(mouse_last_location.x - mouse_first_location.x)
 		
+		# when the click is released
 		elif Input.is_action_just_released("click"):
-			time_since_first_location += delta
+			# make note of where the mouse was released
+			# since we're using a sample of N, N-1 frames, rather than an 
+			# average over N frames, we use the in-built
+			# `delta` parameter
 			mouse_release_location = get_global_mouse_position()
+			
+			# simple if/else to compare which direction to go
 			if mouse_release_location.x < mouse_first_location.x:
+				# displacement calc
 				var distance = mouse_release_location.x - mouse_first_location.x
 				velocity = (distance / 
-					(velocity_coeffecient * time_since_first_location))
+					# velocity coefficient to adjust sensitivity
+					(velocity_coeffecient * delta))
+				# update to not draggable, to let tween resolve
 				draggable = false
-				
+			
+			# other side of the if/else
 			elif mouse_release_location.x > mouse_first_location.x:
 				var distance = abs(mouse_first_location.x 
 					- mouse_release_location.x)
 				velocity = (distance / 
-					(velocity_coeffecient * time_since_first_location))
+					(velocity_coeffecient * delta))
 				draggable = false
-				
-	elif not draggable:
-		var tween = get_tree().create_tween()
-		tween.tween_property(self, "velocity", 0, ease_out_time).set_ease(Tween.EASE_OUT)
-		mouse_first_location = Vector2(0,0)
-		mouse_release_location = Vector2(0,0)
-		draggable = true
-		
-	if global_position.x > max_x:
-		push_warning("too far to the pos_x")
-		velocity = 0
-		global_position.x = 999
+			
+			# when the drag is complete, create a tween to ease out towards zero
+			var tween = get_tree().create_tween()
+			
+			# ease out the velocity value to zero.
+			tween.tween_property(self, "velocity", 
+			0, ease_out_time).set_ease(Tween.EASE_OUT)
+			
+			# reset location values
+			mouse_first_location = Vector2(0,0)
+			mouse_release_location = Vector2(0,0)
+			
+			# able to be dragged again
+			draggable = true
+	
+	# if/else to handle reaching the "end" of the canvas
+	# as notated by max_x and min_x (see export vars)
+	if global_position.x >= max_x && velocity > 0:
+		if bounce:
+			# if bounce is enable, half the velocity and negate it
+			velocity = -(velocity)/2
+			print("velocity negated, bouncing")
+		# set the position to be within the right bounds
+		global_position.x = max_x - 1
 		time_since_first_location = -1
+		# draggable again, possibly redundant
 		draggable = true
 		return
 		
-	elif global_position.x < min_x:
-		push_warning("too far to the neg_y")
-		velocity = 0
-		global_position.x = 1
+	elif global_position.x < min_x && velocity < 0:
+		if bounce:
+			velocity = -(velocity)/2
+			print("velocity negated, bouncing")
+		global_position.x = min_x + 1
 		time_since_first_location = -1
 		draggable = true
 		return
+	
+	# finally, update the last known position of the mouse
+	mouse_last_location = get_global_mouse_position()

src/scroll_root.tscn

@@ -23,4 +23,4 @@ offset_top = 299.0
 offset_right = 455.0
 offset_bottom = 299.0
 script = ExtResource("2_mej84")
-velocity_coeffecient = 735
+velocity_coeffecient = 110