File size: 4,027 Bytes
18a519f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | using System;
////WIP
//how is it achieved that this applies on a per-device level rather than for all devices of a given type?
//do we do this at the event-level?
//where to do perform the input modification? pre-source or post-source?
//pre-source:
// + can be persisted such that the outcome is agnostic to user profile settings
// - no longer possible to have input routed to multiple users from same device
//
//post-source:
// + no need to modify device
////REVIEW: add ability to have per-device (or device layout?) settings?
namespace UnityEngine.InputSystem.Users
{
/// <summary>
/// A user profile may alter select aspects of input behavior at runtime.
/// </summary>
/// <remarks>
/// This class implements several user adjustable input behaviors commonly found in games, such
/// as mouse sensitivity and axis inversion.
///
/// Note that the behaviors only work in combination with actions, that is, for users that have
/// actions associated with them via <see cref="InputUser.AssociateActionsWithUser(IInputActionCollection)"/>.
/// The behaviors do not alter the input as present directly on the devices. Meaning that, for example,
/// <see cref="invertMouseX"/> will not impact <see cref="Vector2.x"/> of <see cref="Mouse.delta"/> but will
/// rather impact the value read out with <see cref="InputAction.CallbackContext.ReadValue"/> from an action
/// bound to mouse deltas.
///
/// In other words, all the input behaviors operate at the binding level and modify <see cref="InputBinding"/>s.
/// ////REVIEW: does this really make sense?
/// </remarks>
[Serializable]
internal class InputUserSettings
{
/// <summary>
/// Customized bindings for the user.
/// </summary>
/// <remarks>
/// This will only contain customizations explicitly applied to the user's bindings
/// and will not contain default bindings. It is thus not a complete set of bindings
/// but rather just a set of customizations.
/// </remarks>
public string customBindings { get; set; }
////REVIEW: for this to impact position, too, we need to know the screen dimensions
/// <summary>
/// Invert X on <see cref="Mouse.position"/> and <see cref="Mouse.delta"/>.
/// </summary>
public bool invertMouseX { get; set; }
/// <summary>
/// Invert Y on <see cref="Mouse.position"/> and <see cref="Mouse.delta"/>.
/// </summary>
public bool invertMouseY { get; set; }
/// <summary>
/// Smooth mouse motion on both X and Y ...
/// </summary>
public float? mouseSmoothing { get; set; }
public float? mouseSensitivity { get; set; }
/// <summary>
/// Invert X axis on <see cref="Gamepad.leftStick"/> and <see cref="Gamepad.rightStick"/>.
/// </summary>
public bool invertStickX { get; set; }
/// <summary>
/// Invert Y axis on <see cref="Gamepad.leftStick"/> and <see cref="Gamepad.rightStick"/>.
/// </summary>
public bool invertStickY { get; set; }
/// <summary>
/// If true, swap sides
/// </summary>
public bool swapSticks { get; set; }
/// <summary>
/// Swap <see cref="Gamepad.leftShoulder"/> and <see cref="Gamepad.rightShoulder"/> on gamepads.
/// </summary>
public bool swapBumpers { get; set; }
/// <summary>
/// Swap <see cref="Gamepad.leftTrigger"/> and <see cref="Gamepad.rightTrigger"/> on gamepads.
/// </summary>
public bool swapTriggers { get; set; }
public bool swapDpadAndLeftStick { get; set; }
public float vibrationStrength { get; set; }
public virtual void Apply(IInputActionCollection actions)
{
//set overrideProcessors and redirectPaths on respective bindings
}
[SerializeField] private string m_CustomBindings;
}
}
|