Firstborn/Library/PackageCache/com.unity.inputsystem@1.4.4/InputSystem/Plugins/Users/InputUserSettings.cs
Schaken-Mods b486678290 Library -Artifacts
Library -Artifacts
2023-03-28 12:24:16 -05:00

106 lines
3.9 KiB
C#

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;
}
}