Add joypad motion sensors tutorial

[Nintorch]

Partially addresses #11466
Follow-up to godotengine/godot#111679

The gyroscope calibration explanation was borrowed from https://github.com/JibbSmart/GamepadMotionHelpers?tab=readme-ov-file#gyro-calibration

TODO:

• Accelerometer Z axis

[Nintorch]

Thank you for your review, AThousandShips! I will be able to fix the text in the PR soon!

[skyace65]

Might be a bit before this gets merged since it's for 4.7

[Calinou]

Suggested change

	That's because modern gyroscopes often need calibration. This is like how a weighing scale can need calibration to tell it what 'zero' is.
	Like a weighing scale, a correctly calibrated gyroscope will give an accurate reading.
	That's because modern gyroscopes often need calibration. This is like how a weighing scale can need calibration to tell it what "zero" is.
	Like a weighing scale, only a correctly calibrated gyroscope will give an accurate reading.

[Calinou]

Suggested change

	**Accelerometer** is a type of sensor that detects a device's acceleration in m/s²,
	which, in simpler terms, means it can detect if the device (in our case, a controller) has been physically moved quickly.
	For example, it can detect if the player quickly raises their controller, quickly moves it to the side,
	or if the player is shaking the controller.
	Note that, unfortunately, it does not **not** mean that the device will be able to detect precise movements that,
	for example, can be used to replicate a VR controller's movement.
	**Accelerometer** is a type of sensor that detects a device's acceleration in m/s².
	In simpler terms, this means it can detect if the device (in our case, a controller) has been physically moved quickly.
	For example, it can detect if the player quickly raises their controller, quickly moves it to the side,
	or if the player is shaking the controller.
	Note that, unfortunately, it does not **not** mean that the device will be able to detect precise movements that can be used to replicate a VR controller's movement (for example).

[Calinou]

Suggested change

	The following example prints the controller movement when it's being quickly moved by using its accelerometer:
	(If you feel like this code is too sensitive or not sensitive enough for your controller's physical movement,
	you can also tweak the values used here however you feel like!)
	The following example prints the controller movement when it's being quickly moved by using its accelerometer.
	If you feel like this code is too sensitive or not sensitive enough for your controller's physical movement,
	you can also tweak the values used here however you feel like.

[Calinou]

Use spaces for indentation in docs:

Suggested change

	var detect_accelerometer = true
	func _ready():
	# In this example we only use the first connected joypad (id 0).
	if 0 not in Input.get_connected_joypads():
	return
	if not Input.has_joy_motion_sensors(0):
	return
	# We must enable the motion sensors before using them.
	Input.set_joy_motion_sensors_enabled(0, true)
	func _process(delta):
	if Input.has_joy_motion_sensors(0):
	accelerometer_example()
	func accelerometer_example():
	if not detect_accelerometer:
	return
	var acceleration = Input.get_joy_accelerometer(0) - Input.get_joy_gravity(0)
	if acceleration.length() > 10:
	if acceleration.x > 10:
	print("Moved left")
	elif acceleration.x < -10:
	print("Moved right")
	if acceleration.y < -10:
	print("Moved up")
	elif acceleration.y > 10:
	print("Moved down")
	# After detecting movement in one direction, the accelerometer sensor
	# will briefly report movement in the opposite direction, even though the controller only moved once.
	# So we need to ignore these reported values for a short amount of time.
	detect_accelerometer = false
	await get_tree().create_timer(0.5, false).timeout
	detect_accelerometer = true
	var detect_accelerometer = true
	func _ready():
	# In this example we only use the first connected joypad (id 0).
	if 0 not in Input.get_connected_joypads():
	return
	if not Input.has_joy_motion_sensors(0):
	return
	# We must enable the motion sensors before using them.
	Input.set_joy_motion_sensors_enabled(0, true)
	func _process(delta):
	if Input.has_joy_motion_sensors(0):
	accelerometer_example()
	func accelerometer_example():
	if not detect_accelerometer:
	return
	var acceleration = Input.get_joy_accelerometer(0) - Input.get_joy_gravity(0)
	if acceleration.length() > 10:
	if acceleration.x > 10:
	print("Moved left")
	elif acceleration.x < -10:
	print("Moved right")
	if acceleration.y < -10:
	print("Moved up")
	elif acceleration.y > 10:
	print("Moved down")
	# After detecting movement in one direction, the accelerometer sensor
	# will briefly report movement in the opposite direction, even though the controller only moved once.
	# So we need to ignore these reported values for a short amount of time.
	detect_accelerometer = false
	await get_tree().create_timer(0.5, false).timeout
	detect_accelerometer = true