You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
CrowdControl/Assets/Feel/MMTools/Tools/MMControls/MMTouchJoystick.cs

412 lines
13 KiB
C#

using UnityEngine;
using UnityEngine.EventSystems;
using UnityEngine.Events;
using System;
using Unity.Collections;
using UnityEngine.UI;
#if UNITY_EDITOR
using UnityEditor;
#endif
namespace MoreMountains.Tools
{
[System.Serializable]
public class JoystickEvent : UnityEvent<Vector2> {}
[System.Serializable]
public class JoystickFloatEvent : UnityEvent<float> {}
/// <summary>
/// Joystick input class.
/// In charge of the behaviour of the joystick mobile touch input.
/// Bind its actions from the inspector
/// Handles mouse and multi touch
/// </summary>
[RequireComponent(typeof(Rect))]
[RequireComponent(typeof(CanvasGroup))]
[AddComponentMenu("More Mountains/Tools/Controls/MMTouchJoystick")]
public class MMTouchJoystick : MMMonoBehaviour, IDragHandler, IEndDragHandler, IPointerDownHandler, IPointerUpHandler
{
public enum MaxRangeModes { Distance, DistanceToTransform }
[MMInspectorGroup("Camera", true, 16)]
/// The camera to use as the reference for any ScreenToWorldPoint computations
[Tooltip("The camera to use as the reference for any ScreenToWorldPoint computations")]
public Camera TargetCamera;
[MMInspectorGroup("Joystick Behaviour", true, 18)]
[Tooltip("Determines whether the horizontal axis of this stick should be enabled. If not, the stick will only move vertically.")]
/// Is horizontal axis allowed
public bool HorizontalAxisEnabled = true;
/// Is vertical axis allowed
[Tooltip("Determines whether the vertical axis of this stick should be enabled. If not, the stick will only move horizontally.")]
public bool VerticalAxisEnabled = true;
/// the mode in which to compute the range. Distance will be a flat value, DistanceToTransform will be a distance to a transform you can move around and potentially resize as you wish for various resolutions
[Tooltip("the mode in which to compute the range. Distance will be a flat value, DistanceToTransform will be a distance to a transform you can move around and potentially resize as you wish for various resolutions")]
public MaxRangeModes MaxRangeMode = MaxRangeModes.Distance;
/// The MaxRange is the maximum distance from its initial center position you can drag the joystick to
[Tooltip("The MaxRange is the maximum distance from its initial center position you can drag the joystick to.")]
[MMEnumCondition("MaxRangeMode", (int)MaxRangeModes.Distance)]
public float MaxRange = 1.5f;
/// in DistanceToTransform mode, the object whose distance to the center will be used to compute the max range. Note that this is computed once, at init. Call RefreshMaxRangeDistance() to recompute it.
[Tooltip("in DistanceToTransform mode, the object whose distance to the center will be used to compute the max range. Note that this is computed once, at init. Call RefreshMaxRangeDistance() to recompute it.")]
[MMEnumCondition("MaxRangeMode", (int)MaxRangeModes.DistanceToTransform)]
public Transform MaxRangeTransform;
public float ComputedMaxRange
{
get
{
if (Application.isPlaying)
{
return MaxRangeMode == MaxRangeModes.Distance ? MaxRange : _maxRangeTransformDistance;
}
else
{
if (MaxRangeMode == MaxRangeModes.Distance)
{
return MaxRange;
}
else
{
if (MaxRangeTransform == null)
{
return -1f;
}
RefreshMaxRangeDistance();
return _maxRangeTransformDistance;
}
}
}
}
[MMInspectorGroup("Value Events", true, 19)]
/// An event to use the raw value of the joystick
[Tooltip("An event to use the raw value of the joystick")]
public JoystickEvent JoystickValue;
/// An event to use the normalized value of the joystick
[Tooltip("An event to use the normalized value of the joystick")]
public JoystickEvent JoystickNormalizedValue;
// An event to use the joystick's amplitude (the magnitude of its Vector2 output)
[Tooltip("An event to use the joystick's amplitude (the magnitude of its Vector2 output)")]
public JoystickFloatEvent JoystickMagnitudeValue;
[MMInspectorGroup("Touch Events", true, 8)]
/// An event triggered when tapping the joystick for the first time
[Tooltip("An event triggered when tapping the joystick for the first time")]
public UnityEvent OnPointerDownEvent;
/// An event triggered when dragging the stick
[Tooltip("An event triggered when dragging the stick")]
public UnityEvent OnDragEvent;
/// An event triggered when releasing the stick
[Tooltip("An event triggered when releasing the stick")]
public UnityEvent OnPointerUpEvent;
[MMInspectorGroup("Rotating Direction Indicator", true, 20)]
/// an object you can rotate to show the direction of the joystick. Will only be visible if the movement is above a threshold
[Tooltip("an object you can rotate to show the direction of the joystick. Will only be visible if the movement is above a threshold")]
public Transform RotatingIndicator;
/// the threshold above which the rotating indicator will appear
[Tooltip("the threshold above which the rotating indicator will appear")]
public float RotatingIndicatorThreshold = 0.1f;
[MMInspectorGroup("Knob Opacity", true, 17)]
/// the new opacity to apply to the canvas group when the button is pressed
[Tooltip("the new opacity to apply to the canvas group when the button is pressed")]
public float PressedOpacity = 0.5f;
/// whether or not to interpolate opacity changes on the knob's canvas group
[Tooltip("whether or not to interpolate opacity changes on the knob's canvas group")]
public bool InterpolateOpacity = true;
/// the speed at which to interpolate opacity
[Tooltip("the speed at which to interpolate opacity")]
[MMCondition("InterpolateOpacity", true)]
public float InterpolateOpacitySpeed = 1f;
[MMInspectorGroup("Debug Output", true, 5)]
/// the raw value of the joystick, from 0 to 1 on each axis
[Tooltip("the raw value of the joystick, from 0 to 1 on each axis")]
[MMReadOnly]
public Vector2 RawValue;
/// the normalized value of the joystick
[Tooltip("the normalized value of the joystick")]
[MMReadOnly]
public Vector2 NormalizedValue;
/// the magnitude of the stick's vector
[Tooltip("the magnitude of the stick's vector")]
[MMReadOnly]
public float Magnitude;
/// whether or not to draw gizmos associated to this stick
[Tooltip("whether or not to draw gizmos associated to this stick")]
public bool DrawGizmos = true;
/// the render mode of the parent canvas this stick is on
public RenderMode ParentCanvasRenderMode { get; protected set; }
protected Vector2 _neutralPosition;
protected Vector2 _newTargetPosition;
protected Vector3 _newJoystickPosition;
protected float _initialZPosition;
protected float _targetOpacity;
protected CanvasGroup _canvasGroup;
protected float _initialOpacity;
protected Transform _knobTransform;
protected bool _rotatingIndicatorIsNotNull = false;
protected float _maxRangeTransformDistance;
/// <summary>
/// On Start we initialize our stick
/// </summary>
protected virtual void Start()
{
Initialize();
}
/// <summary>
/// Initializes the various parts of the stick
/// </summary>
/// <exception cref="Exception"></exception>
public virtual void Initialize()
{
if ((ParentCanvasRenderMode == RenderMode.ScreenSpaceCamera) && (TargetCamera == null))
{
throw new Exception("MMTouchJoystick : you have to set a target camera");
}
_canvasGroup = GetComponent<CanvasGroup>();
_rotatingIndicatorIsNotNull = (RotatingIndicator != null);
RefreshMaxRangeDistance();
SetKnobTransform(this.transform);
SetNeutralPosition();
ParentCanvasRenderMode = GetComponentInParent<Canvas>().renderMode;
_initialZPosition = _knobTransform.position.z;
_initialOpacity = _canvasGroup.alpha;
}
/// <summary>
/// This method is used to compute the max range distance when in DistanceToTransform mode
/// </summary>
public virtual void RefreshMaxRangeDistance()
{
if (MaxRangeMode == MaxRangeModes.DistanceToTransform)
{
_maxRangeTransformDistance = Vector2.Distance(this.transform.position, MaxRangeTransform.position);
}
}
/// <summary>
/// Assigns a new transform as the joystick knob
/// </summary>
/// <param name="newTransform"></param>
public virtual void SetKnobTransform(Transform newTransform)
{
_knobTransform = newTransform;
}
/// <summary>
/// On Update we check for an orientation change if needed, and send our input values.
/// </summary>
protected virtual void Update()
{
NormalizedValue = RawValue.normalized;
Magnitude = RawValue.magnitude;
if (HorizontalAxisEnabled || VerticalAxisEnabled)
{
JoystickValue.Invoke(RawValue);
JoystickNormalizedValue.Invoke(NormalizedValue);
JoystickMagnitudeValue.Invoke(Magnitude);
}
RotateIndicator();
HandleOpacity();
}
/// <summary>
/// Changes or interpolates the opacity of the knob
/// </summary>
protected virtual void HandleOpacity()
{
if (InterpolateOpacity)
{
_canvasGroup.alpha = MMMaths.Lerp(_canvasGroup.alpha, _targetOpacity, InterpolateOpacitySpeed, Time.unscaledDeltaTime);
}
else
{
_canvasGroup.alpha = _targetOpacity;
}
}
/// <summary>
/// Rotates an indicator to match the rotation of the stick
/// </summary>
protected virtual void RotateIndicator()
{
if (!_rotatingIndicatorIsNotNull)
{
return;
}
RotatingIndicator.gameObject.SetActive(RawValue.magnitude > RotatingIndicatorThreshold);
float angle = Mathf.Atan2(RawValue.y, RawValue.x) * Mathf.Rad2Deg;
RotatingIndicator.localRotation = Quaternion.AngleAxis(angle, Vector3.forward);
}
/// <summary>
/// Sets the neutral position of the joystick
/// </summary>
public virtual void SetNeutralPosition()
{
_neutralPosition = _knobTransform.position;
}
public virtual void SetNeutralPosition(Vector3 newPosition)
{
_neutralPosition = newPosition;
}
/// <summary>
/// Handles dragging of the joystick
/// </summary>
public virtual void OnDrag(PointerEventData eventData)
{
OnDragEvent.Invoke();
_newTargetPosition = ConvertToWorld(eventData.position);
// We clamp the stick's position to let it move only inside its defined max range
ClampToBounds();
// If we haven't authorized certain axis, we force them to zero
if (!HorizontalAxisEnabled)
{
_newTargetPosition.x = 0;
}
if (!VerticalAxisEnabled)
{
_newTargetPosition.y = 0;
}
// For each axis, we evaluate its lerped value (-1...1)
RawValue.x = EvaluateInputValue(_newTargetPosition.x);
RawValue.y = EvaluateInputValue(_newTargetPosition.y);
_newJoystickPosition = _neutralPosition + _newTargetPosition;
_newJoystickPosition.z = _initialZPosition;
// We move the joystick to its dragged position
_knobTransform.position = _newJoystickPosition;
}
/// <summary>
/// Clamps the stick to the specified range
/// </summary>
protected virtual void ClampToBounds()
{
_newTargetPosition = Vector2.ClampMagnitude(_newTargetPosition - _neutralPosition, ComputedMaxRange);
}
/// <summary>
/// Converts a position to world position
/// </summary>
/// <param name="position"></param>
/// <returns></returns>
protected virtual Vector3 ConvertToWorld(Vector3 position)
{
if (ParentCanvasRenderMode == RenderMode.ScreenSpaceCamera)
{
return TargetCamera.ScreenToWorldPoint(position);
}
else
{
return position;
}
}
/// <summary>
/// Resets the stick's position and values
/// </summary>
public virtual void ResetJoystick()
{
// we reset the stick's position
_newJoystickPosition = _neutralPosition;
_newJoystickPosition.z = _initialZPosition;
_knobTransform.position = _newJoystickPosition;
RawValue.x = 0f;
RawValue.y = 0f;
// we set its opacity back
_targetOpacity = _initialOpacity;
}
/// <summary>
/// We compute the axis value from the interval between neutral position, current stick position (vectorPosition) and max range
/// </summary>
/// <returns>The axis value, a float between -1 and 1</returns>
/// <param name="vectorPosition">stick position.</param>
protected virtual float EvaluateInputValue(float vectorPosition)
{
return Mathf.InverseLerp(0, ComputedMaxRange, Mathf.Abs(vectorPosition)) * Mathf.Sign(vectorPosition);
}
/// <summary>
/// What happens when the stick stops being dragged
/// </summary>
public virtual void OnEndDrag(PointerEventData eventData)
{
}
/// <summary>
/// What happens when the stick is released (even if no drag happened)
/// </summary>
/// <param name="data"></param>
public virtual void OnPointerUp(PointerEventData data)
{
ResetJoystick();
OnPointerUpEvent.Invoke();
}
/// <summary>
/// What happens when the stick is pressed for the first time
/// </summary>
/// <param name="data"></param>
public virtual void OnPointerDown(PointerEventData data)
{
_targetOpacity = PressedOpacity;
OnPointerDownEvent.Invoke();
}
/// <summary>
/// On enable, we initialize our stick
/// </summary>
protected virtual void OnEnable()
{
Initialize();
_targetOpacity = _initialOpacity;
}
#if UNITY_EDITOR
/// <summary>
/// Draws gizmos if needed
/// </summary>
protected virtual void OnDrawGizmos()
{
if (!DrawGizmos)
{
return;
}
Handles.color = MMColors.Orange;
if (!Application.isPlaying)
{
Handles.DrawWireDisc(this.transform.position, Vector3.forward, ComputedMaxRange);
}
else
{
Handles.DrawWireDisc(_neutralPosition, Vector3.forward, ComputedMaxRange);
}
}
#endif
}
}